1NFCTOOL(1) General Commands Manual NFCTOOL(1)
2
6 nfctool - a NFC toolbox
7
10 nfctool [OPTIONS...]
11
14 The nfctool application performs various operations on NFC devices,
15 such as:
16 · list connected devices
18 · put device in polling mode
20 · get and set parameters for the local LLC
22 · send service name lookup request to the remote LLC.
24 · dump LLCP link traffic
26
29 -h, --help
30 Print nfctool's available options and exit.
31 -v, --version
34 Print nfctool's version and exit.
35 -l, --list
38 List attached NFC devices. It also prints information such as
39 remote tags or devices, supported protocols, RF mode, and LLC link
40 parameters.
41 -d, --device=NFCDEV
44 Specify a nfc device (i.e. nfc0). This is mandatory for all opera‐
45 tions except -l.
46 -p, --poll[=MODE]
49 Start poll on the device specified with -d. MODE must be one of
50 Initiator, Target, or Both and it defaults to Initiator when
51 unspecified. Passing MODE as i, t, or b for respectively Initiator,
52 Target, or Both is also accepted.
53 -s, --set-param=PARAM=VAL[,PARAM=VAL[,...]]
56 Set LLC link parameters. PARAM must be at least one of:
57 lto=0..255 - Link TimeOut
59 Specify the maximum time interval between the last received LLC
60 PDU from the remote to the local LLC and the first subsequent
61 LLC PDU transmission from the local to the remote LLC. The
62 value is expressed in multiples of 10 milliseconds and is
63 encoded as a 8-bit unsigned integer.
64 The LTO parameter must be set before the LLC Link is estab‐
66 lished.
67 rw=0..15 - Receive Window size
70 Specify the maximum number of I PDUs the local LLC will accept
71 before acknowledging them. A RW size of zero indicates that the
72 local LLC will not accept I PDUs on that data link connection.
73 A RW size of one indicates that the local LLC will acknowledge
74 every I PDU before accepting additional I PDUs. It is encoded
75 as a 4-bit unsigned integer.
76 The RW parameter can be set after the LLC Link is established.
78 The new value will apply for subsequent connections.
79 miux=0..2047 - Maximum Information Unit Extension
81 Specify the number of octets by which a LLC PDU information
82 field may exceed the default maximum size of 128 octets. In
83 other words, MIU = MIUX + 128. It is encoded as an 11-bit
84 unsigned integer.
85 The MIUX parameter can be set after the LLC Link is estab‐
87 lished. The new value will apply for subsequent connections.
88 -k, --snl=URN
91 Send a Service Name Lookup request for URN (i.e. urn:nfc:sn:snep)
92 to the remote LLC. Obviously, the LLC link must be up before the
93 request is sent.
94 The remote should reply by returning the service access point (SAP)
96 number or zero if it doesn't support the requested service.
97 Note: If used with -p, nfctool will wait for the LLC link to be up
99 before sending the SNL request.
100 -n, --sniff
103 Start LLCP sniffing on the device specified with -d option.
104 SNIFFER SPECIFIC OPTIONS
107 The folowing options only apply with -n.
108 -a, --snapshot-len=SNAPLEN
111 Capture SNAPLEN bytes from each packet. Default snapshot
112 length is 1024 bytes.
113 -y, --dump-symm
116 Dump SYMM packets to stdout. this will generate a LOT of
117 output.
118 Note: The -y option concerns console output only. SYMM
120 packets are always dumped to the pcap file when specified
121 by -f (See below).
122 -t, --show-timestamp[=MODE]
125 Show packet timestamps. Setting MODE as delta means the
126 time since the first captured frame. absolute means elapsed
127 time since the Epoch, 1970-01-01 00:00:00 +0000 (UTC). MODE
128 defaults to delta when unspecified.
129 -f, --pcap-file=FILENAME
132 Specify a filename to save dumped traffic in pcap format.
133 The generated file can be opened with Wireshark
134 (http://www.wireshark.org/) using the wireshark-nfc plug-in
135 available at http://code.google.com/p/wireshark-nfc/
136
140 neard (8)
141 neard.conf (5)
143 Linux NFC project page at https://01.org/linux-nfc/
145 February 2013 NFCTOOL(1)