nfctool - Man Page
a NFC toolbox
The nfctool application performs various operations on NFC devices, such as:
- list connected devices
- put device in polling mode
- get and set parameters for the local LLC
- send service name lookup request to the remote LLC.
- dump LLCP link traffic
- -h, --help
Print nfctool's available options and exit.
- -v, --version
Print nfctool's version and exit.
- -l, --list
List attached NFC devices. It also prints information such as remote tags or devices, supported protocols, RF mode, and LLC link parameters.
- -d, --device=NFCDEV
Specify a nfc device (i.e. nfc0). This is mandatory for all operations except -l.
- -p, --poll[=MODE]
Start poll on the device specified with -d. MODE must be one of Initiator, Target, or Both and it defaults to Initiator when unspecified. Passing MODE as i, t, or b for respectively Initiator, Target, or Both is also accepted.
- -s, --set-param=PARAM=VAL[,PARAM=VAL[,...]]
Set LLC link parameters. PARAM must be at least one of:
lto=0..255 - Link TimeOut
Specify the maximum time interval between the last received LLC PDU from the remote to the local LLC and the first subsequent LLC PDU transmission from the local to the remote LLC. The value is expressed in multiples of 10 milliseconds and is encoded as a 8-bit unsigned integer.
The LTO parameter must be set before the LLC Link is established.
rw=0..15 - Receive Window size
Specify the maximum number of I PDUs the local LLC will accept before acknowledging them. A RW size of zero indicates that the local LLC will not accept I PDUs on that data link connection. A RW size of one indicates that the local LLC will acknowledge every I PDU before accepting additional I PDUs. It is encoded as a 4-bit unsigned integer.
The RW parameter can be set after the LLC Link is established. The new value will apply for subsequent connections.
miux=0..2047 - Maximum Information Unit Extension
Specify the number of octets by which a LLC PDU information field may exceed the default maximum size of 128 octets. In other words, MIU = MIUX + 128. It is encoded as an 11-bit unsigned integer.
The MIUX parameter can be set after the LLC Link is established. The new value will apply for subsequent connections.
- -k, --snl=URN
Send a Service Name Lookup request for URN (i.e. urn:nfc:sn:snep) to the remote LLC. Obviously, the LLC link must be up before the request is sent.
The remote should reply by returning the service access point (SAP) number or zero if it doesn't support the requested service.
Note: If used with -p, nfctool will wait for the LLC link to be up before sending the SNL request.
- -n, --sniff
Start LLCP sniffing on the device specified with -d option.
- SNIFFER SPECIFIC OPTIONS
The folowing options only apply with -n.
- -a, --snapshot-len=SNAPLEN
Capture SNAPLEN bytes from each packet. Default snapshot length is 1024 bytes.
- -y, --dump-symm
Dump SYMM packets to stdout. this will generate a LOT of output.
Note: The -y option concerns console output only. SYMM packets are always dumped to the pcap file when specified by -f (See below).
- -t, --show-timestamp[=MODE]
Show packet timestamps. Setting MODE as delta means the time since the first captured frame. absolute means elapsed time since the Epoch, 1970-01-01 00:00:00 +0000 (UTC). MODE defaults to delta when unspecified.
- -f, --pcap-file=FILENAME
Specify a filename to save dumped traffic in pcap format. The generated file can be opened with Wireshark (http://www.wireshark.org/) using the wireshark-nfc plug-in available at http://code.google.com/p/wireshark-nfc/
Linux NFC project page at https://01.org/linux-nfc/