VivoKey/vsmartcard
7
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

updated docs about ACardEmulator+pcsc-relay

Browse Source
This commit is contained in:
Frank Morgner
2017-01-05 00:12:24 +01:00
parent 818d5a0254
commit df2bb0312b
1 changed files with 17 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
pcsc-relay/doc/README.txt.in
View File

@@ -211,28 +211,28 @@ Hints on Android Smart Card Emulator
The Android Smart Card Emulator is build around the host card emulation mode of The Android Smart Card Emulator is build around the host card emulation mode of
Android 4.4 and later. This mode activates the app if the terminal issues a Android 4.4 and later. This mode activates the app if the terminal issues a
SELECT command with one of the app's application identifiers. The app registers SELECT command with one of the app's application identifiers. By default, the
for the following AIDs (:file:`ACardEmulator/app/src/main/res/xml/aid_list.xml`): app only registers for the AIDs for which it has a built-in emulator (see
:file:`ACardEmulator/app/src/main/res/xml/aid_list.xml`).
.. literalinclude:: ../../ACardEmulator/app/src/main/res/xml/aid_list.xml If used together with @PACKAGE_NAME@, you need to change add AIDs to match the
:language: xml applications on the relayed card. Otherwise the app will not be activated when
:emphasize-lines: 8,12,16,20 it should relay command APDUs to @PACKAGE_NAME@.
If used together with @PACKAGE_NAME@ you need to change these application Modify the Smart Card Emulator settings to use ``Remote Virtual Smart Card`` as
identifiers to match the emulated card. Otherwise the app will not be activated :guilabel:`Smart Card Emulator`. Now start :command:`pcsc-relay` by specifying
when it should relay command APDUs to @PACKAGE_NAME@. usage of the vpcd emulator::
And while you are already modifying the Android Smart Card Emulator you may also pcsc-relay --emulator vpcd
want to activate `useVPCD` and change `hostname` and `port` to configure the
connection to @PACKAGE_NAME@
(:file:`ACardEmulator/app/src/main/java/com/vsmartcard/acardemulator/SimulatorService.java`):
.. literalinclude:: ../../ACardEmulator/app/src/main/java/com/vsmartcard/acardemulator/SimulatorService.java In the app, change the :guilabel:`VICC Hostname` and :guilabel:`VICC Port` to
:language: java match the location where :command:`pcsc-relay` is waiting for an incoming
:lines: 47-52 connection. When the app receives a SELECT command to one of the configured
:emphasize-lines: 3,5-6 AIDs, it will connect to :command:`pcsc-relay`, which will then relay the
command for processing.
Compiling and installing Android Smart Card Emulator is covered in its :ref:`acardemulator_install` section. Compiling and installing Android Smart Card Emulator is covered in its
:ref:`acardemulator_install` section.
========================= =========================