Documentation/networking/nfc.rst

2 Linux NFC subsystem
5 The Near Field Communication (NFC) subsystem is required to standardize the
14 The NFC subsystem is responsible for:
15       - NFC adapters management;
16       - Polling for targets;
17       - Low-level data exchange;
19 The subsystem is divided in some parts. The 'core' is responsible for
21 responsible for providing an interface to control operations and low-level
26 The low-level data exchange interface is provided by the new socket family
29 .. code-block:: none
31         +--------------------------------------+
33         +--------------------------------------+
35             | low-level             | control
39             |                  +-----------+
41             | socket           +-----------+
45         +---------+            +-----------+
46         | rawsock | <--------> |   core    |
47         +---------+            +-----------+
51                                +-----------+
53                                +-----------+
58 When registering on the NFC subsystem, the device driver must inform the core
62 * start_poll - setup the device to poll for targets
63 * stop_poll - stop on progress polling operation
64 * activate_target - select and initialize one of the targets found
65 * deactivate_target - deselect and deinitialize the selected target
66 * data_exchange - send data and receive the response (transceive operation)
71 The userspace interface is divided in control operations and low-level data
79 * NFC_CMD_GET_DEVICE - get specific device info or dump the device list
80 * NFC_CMD_START_POLL - setup a specific device to polling for targets
81 * NFC_CMD_STOP_POLL - stop the polling operation in a specific device
82 * NFC_CMD_GET_TARGET - dump the list of targets found by a specific device
84 * NFC_EVENT_DEVICE_ADDED - reports an NFC device addition
85 * NFC_EVENT_DEVICE_REMOVED - reports an NFC device removal
86 * NFC_EVENT_TARGETS_FOUND - reports START_POLL results when 1 or more targets
103 LOW-LEVEL DATA EXCHANGE: