1NFC-RELAY-PICC(1)           General Commands Manual          NFC-RELAY-PICC(1)
2
3
4

NAME

6       nfc-relay-picc - Relay demonstration tool for ISO14443-4
7

SYNOPSIS

9       nfc-relay-picc
10

DESCRIPTION

12       nfc-relay-picc
13
14       This  tool  requires two NFC devices. One device (configured as target)
15       will emulate an ISO/IEC 14443-4 type A tag,  while  the  second  device
16       (configured  as initiator) will act as a reader. The genuine tag can be
17       placed on the second device (initiator) and the tag  emulator  (target)
18       can  be  placed  close to the original reader. All communication is now
19       relayed and shown in the screen on real-time.
20
21       tag <---> initiator (relay) <---> target (relay) <---> original reader
22
23

OPTIONS

25       -h
26           Help
27           List options
28
29       -q
30           Quiet mode
31           Suppress printing of relayed data (improves timing)
32
33       -t
34           Target mode only (to be used on reader side)
35           Commands are sent to file descriptor 4
36           Responses are read from file descriptor 3
37
38       -i
39           Initiator mode only (to be used on tag side)
40           Commands are read from file descriptor 3
41           Responses are sent to file descriptor 4
42
43       -n N
44           Adds a waiting time of N seconds (integer) in the loop
45
46

EXAMPLES

48       Basic usage:
49
50         nfc-relay-picc
51
52       Remote relay over TCP/IP:
53
54         socat
55           TCP-LISTEN:port,reuseaddr
56           "EXEC:nfc-relay-picc -i,fdin=3,fdout=4"
57         socat
58           TCP:remotehost:port
59           "EXEC:nfc-relay-picc -t,fdin=3,fdout=4"
60
61

NOTES

63       There are some differences with nfc-relay:
64
65       This example only works with PN532 because it relies  on  its  internal
66       handling of ISO14443-4 specificities.
67
68       Thanks  to this internal handling & injection of WTX frames, this exam‐
69       ple works on readers very strict on timing.
70
71

BUGS

73       Please  report  any  bugs  on  the  libnfc  forum  at   http://www.lib‐
74       nfc.org/community/.
75

LICENCE

77       libnfc and libnfc-examples are covered by the GNU Lesser General Public
78       License (LGPL), version 3.
79
80       This manual page is licensed under the terms of the GNU GPL (version  2
81       or later).
82
83
84
85                               October 12, 2010              NFC-RELAY-PICC(1)
Impressum