NAME

       nfctool - a NFC toolbox

SYNOPSIS

       nfctool [OPTIONS...]

DESCRIPTION

       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

OPTIONS

       -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/

SEE ALSO

       neard (8)

       neard.conf (5)

       Linux NFC project page at https://01.org/linux-nfc/

                                                  February 2013                                       NFCTOOL(1)