• Home
Name Date Size #Lines LOC

..--

Android.bpD03-May-20241.6 KiB6156

README.mdD03-May-20241.9 KiB5741

ese_relay.cD03-May-20245.9 KiB213173

ese_relay_fake.cD03-May-2024900 287

ese_relay_pn80t_nq_nci.cD03-May-20241.2 KiB3512

ese_relay_pn80t_spidev.cD03-May-20241.2 KiB3613

README.md

1# What?
2
3ese-relay connects libese's functionality to a local abstract socket on
4an Android device.  The primary purpose is to ease development and provision
5with test hardware without bringing up all the development tools needed.
6
7ese-relay uses the same wire protocol as the
8[Virtual Smart Card](http://frankmorgner.github.io/vsmartcard/) project by acting
9as the "viccd" service.  This enables use of any tool that supports
10[pcsc-lite](https://pcsclite.alioth.debian.org/) without any additional
11development.
12
13# Wire protocol
14
15The format is always
16    Ln d0..dn
17Ln is a network byte order 16-bit unsigned integer length of the data.
18d0..dn are uint8_t bytes to tunneled directly to/from the card.
19
20If Ln == 1, it indicates an out of band control message. Supported messages
21are 1:0 - 1:4:
22  * 0: Power off (ignored)
23  * 1: Power on (implemented with a reset)
24  * 3: Reset
25  * 4: ATR - returns a fake ATR
26
27# Prerequisites
28
29  * pcscd is installed on your system.
30  * Build and install https://frankmorgner.github.io/vsmartcard/virtualsmartcard
31  * Configure /etc/reader.d/vpcd as below.
32  * Build ese-relay configured for the hardware in use.
33
34## /etc/reader.conf.d/vpcd:
35
36    FRIENDLYNAME "Virtual PCD"
37    DEVICENAME   localhost:0x1000
38    LIBPATH      /usr/lib/pcsc/drivers/serial/libifdvpcd.so
39    CHANNELID    0x1000
40
41This will cause pcscd to connect to localhost port 4096 on start as per the vsmartcard
42documentation.
43
44# Usage
45## In one terminal, run the service and forward the abstract UNIX socket to a local TCP socket:
46  $ adb shell ese-relay-<hw>
47  $ adb forward tcp:4096 localabstract:ese-relay
48
49## In another terminal, restart pcscd configured with an appropriate reader:
50  $ /etc/init.d/pcscd restart # (Or whatever your init system requires.)
51
52## In yet another terminal, use your preferred* pcsc client:
53
54  $ java -jar gp.jar -info
55
56* https://github.com/martinpaljak/GlobalPlatformPro is used here.
57