1nfc-relay-picc(1)                NFC Utilities               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       -s
44           Swap roles of found devices
45           Usually the first found device is used as target (emulator) and the
46       second
47           as initiator (reader). Using this option these roles are inversed.
48
49       -n N
50           Adds a waiting time of N seconds (integer) in the loop
51
52

EXAMPLES

54       Basic usage:
55
56         nfc-relay-picc
57
58       Remote relay over TCP/IP:
59
60         socat
61           TCP-LISTEN:port,reuseaddr
62           "EXEC:nfc-relay-picc -i,fdin=3,fdout=4"
63         socat
64           TCP:remotehost:port
65           "EXEC:nfc-relay-picc -t,fdin=3,fdout=4"
66
67

NOTES

69       There are some differences with nfc-relay:
70
71       This  example  only  works with PN532 because it relies on its internal
72       handling of ISO14443-4 specificities.
73
74       Thanks to this internal handling & injection of WTX frames, this  exam‐
75       ple works on readers very strict on timing.
76
77

BUGS

79       Please report any bugs on the libnfc issue tracker at:
80       https://github.com/nfc-tools/libnfc/issues
81

LICENCE

83       libnfc  is licensed under the GNU Lesser General Public License (LGPL),
84       version 3.
85       libnfc-utils and libnfc-examples are covered by the  the  BSD  2-Clause
86       license.
87
88       This  manual page is licensed under the terms of the GNU GPL (version 2
89       or later).
90
91
92
93libnfc                         October 12, 2010              nfc-relay-picc(1)
Impressum