€•ö½      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ*/translations/zh_CN/driver-api/nfc/nfc-hci”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/zh_TW/driver-api/nfc/nfc-hci”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/it_IT/driver-api/nfc/nfc-hci”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/ja_JP/driver-api/nfc/nfc-hci”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/ko_KR/driver-api/nfc/nfc-hci”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/sp_SP/driver-api/nfc/nfc-hci”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒHCI backend for NFC Core”h]”hŒHCI backend for NFC Core”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒD/var/lib/git/docbuild/linux/Documentation/driver-api/nfc/nfc-hci.rst”h KubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ#Author: Eric Lapuyade, Samuel Ortiz”h]”hŒ	paragraph”“”)”}”(hhÀh]”hŒ#Author: Eric Lapuyade, Samuel Ortiz”…””}”(hhÄhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Khh¾ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hh¹hžhhŸh¶h Nubh½)”}”(hŒ9Contact: eric.lapuyade@intel.com, samuel.ortiz@intel.com
”h]”hÃ)”}”(hŒ8Contact: eric.lapuyade@intel.com, samuel.ortiz@intel.com”h]”(hŒ	Contact: ”…””}”(hhÛhžhhŸNh NubhŒ	reference”“”)”}”(hŒeric.lapuyade@intel.com”h]”hŒeric.lapuyade@intel.com”…””}”(hhåhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:eric.lapuyade@intel.com”uh1hãhhÛubhŒ, ”…””}”(hhÛhžhhŸNh Nubhä)”}”(hŒsamuel.ortiz@intel.com”h]”hŒsamuel.ortiz@intel.com”…””}”(hhùhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:samuel.ortiz@intel.com”uh1hãhhÛubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Khh×ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hh¹hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1h·hŸh¶h Khh£hžhubh¢)”}”(hhh]”(h§)”}”(hŒGeneral”h]”hŒGeneral”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h K	ubhÃ)”}”(hX  The HCI layer implements much of the ETSI TS 102 622 V10.2.0 specification. It
enables easy writing of HCI-based NFC drivers. The HCI layer runs as an NFC Core
backend, implementing an abstract nfc device and translating NFC Core API
to HCI commands and events.”h]”hX  The HCI layer implements much of the ETSI TS 102 622 V10.2.0 specification. It
enables easy writing of HCI-based NFC drivers. The HCI layer runs as an NFC Core
backend, implementing an abstract nfc device and translating NFC Core API
to HCI commands and events.”…””}”(hj.  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Khj  hžhubeh}”(h]”Œgeneral”ah ]”h"]”Œgeneral”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K	ubh¢)”}”(hhh]”(h§)”}”(hŒHCI”h]”hŒHCI”…””}”(hjG  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjD  hžhhŸh¶h KubhÃ)”}”(hX«  HCI registers as an nfc device with NFC Core. Requests coming from userspace are
routed through netlink sockets to NFC Core and then to HCI. From this point,
they are translated in a sequence of HCI commands sent to the HCI layer in the
host controller (the chip). Commands can be executed synchronously (the sending
context blocks waiting for response) or asynchronously (the response is returned
from HCI Rx context).
HCI events can also be received from the host controller. They will be handled
and a translation will be forwarded to NFC Core as needed. There are hooks to
let the HCI driver handle proprietary events or override standard behavior.
HCI uses 2 execution contexts:”h]”hX«  HCI registers as an nfc device with NFC Core. Requests coming from userspace are
routed through netlink sockets to NFC Core and then to HCI. From this point,
they are translated in a sequence of HCI commands sent to the HCI layer in the
host controller (the chip). Commands can be executed synchronously (the sending
context blocks waiting for response) or asynchronously (the response is returned
from HCI Rx context).
HCI events can also be received from the host controller. They will be handled
and a translation will be forwarded to NFC Core as needed. There are hooks to
let the HCI driver handle proprietary events or override standard behavior.
HCI uses 2 execution contexts:”…””}”(hjU  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KhjD  hžhubh¸)”}”(hhh]”(h½)”}”(hŒjone for executing commands : nfc_hci_msg_tx_work(). Only one command
can be executing at any given moment.”h]”hÃ)”}”(hŒjone for executing commands : nfc_hci_msg_tx_work(). Only one command
can be executing at any given moment.”h]”hŒjone for executing commands : nfc_hci_msg_tx_work(). Only one command
can be executing at any given moment.”…””}”(hjj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Khjf  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjc  hžhhŸh¶h Nubh½)”}”(hŒJone for dispatching received events and commands : nfc_hci_msg_rx_work().
”h]”hÃ)”}”(hŒIone for dispatching received events and commands : nfc_hci_msg_rx_work().”h]”hŒIone for dispatching received events and commands : nfc_hci_msg_rx_work().”…””}”(hj‚  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K hj~  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjc  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”j  j  uh1h·hŸh¶h KhjD  hžhubeh}”(h]”Œhci”ah ]”h"]”Œhci”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒHCI Session initialization”h]”hŒHCI Session initialization”…””}”(hj§  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj¤  hžhhŸh¶h K#ubhÃ)”}”(hX•  The Session initialization is an HCI standard which must unfortunately
support proprietary gates. This is the reason why the driver will pass a list
of proprietary gates that must be part of the session. HCI will ensure all
those gates have pipes connected when the hci device is set up.
In case the chip supports pre-opened gates and pseudo-static pipes, the driver
can pass that information to HCI core.”h]”hX•  The Session initialization is an HCI standard which must unfortunately
support proprietary gates. This is the reason why the driver will pass a list
of proprietary gates that must be part of the session. HCI will ensure all
those gates have pipes connected when the hci device is set up.
In case the chip supports pre-opened gates and pseudo-static pipes, the driver
can pass that information to HCI core.”…””}”(hjµ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K%hj¤  hžhubeh}”(h]”Œhci-session-initialization”ah ]”h"]”Œhci session initialization”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K#ubh¢)”}”(hhh]”(h§)”}”(hŒHCI Gates and Pipes”h]”hŒHCI Gates and Pipes”…””}”(hjÎ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjË  hžhhŸh¶h K-ubhÃ)”}”(hXT  A gate defines the 'port' where some service can be found. In order to access
a service, one must create a pipe to that gate and open it. In this
implementation, pipes are totally hidden. The public API only knows gates.
This is consistent with the driver need to send commands to proprietary gates
without knowing the pipe connected to it.”h]”hXX  A gate defines the â€˜portâ€™ where some service can be found. In order to access
a service, one must create a pipe to that gate and open it. In this
implementation, pipes are totally hidden. The public API only knows gates.
This is consistent with the driver need to send commands to proprietary gates
without knowing the pipe connected to it.”…””}”(hjÜ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K/hjË  hžhubeh}”(h]”Œhci-gates-and-pipes”ah ]”h"]”Œhci gates and pipes”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K-ubh¢)”}”(hhh]”(h§)”}”(hŒDriver interface”h]”hŒDriver interface”…””}”(hjõ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjò  hžhhŸh¶h K6ubhÃ)”}”(hŒÎA driver is generally written in two parts : the physical link management and
the HCI management. This makes it easier to maintain a driver for a chip that
can be connected using various phy (i2c, spi, ...)”h]”hŒÎA driver is generally written in two parts : the physical link management and
the HCI management. This makes it easier to maintain a driver for a chip that
can be connected using various phy (i2c, spi, ...)”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K8hjò  hžhubeh}”(h]”Œdriver-interface”ah ]”h"]”Œdriver interface”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K6ubh¢)”}”(hhh]”(h§)”}”(hŒHCI Management”h]”hŒHCI Management”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h K=ubhÃ)”}”(hŒYA driver would normally register itself with HCI and provide the following
entry points::”h]”hŒXA driver would normally register itself with HCI and provide the following
entry points:”…””}”(hj*  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K?hj  hžhubhŒliteral_block”“”)”}”(hX!  struct nfc_hci_ops {
      int (*open)(struct nfc_hci_dev *hdev);
      void (*close)(struct nfc_hci_dev *hdev);
      int (*hci_ready) (struct nfc_hci_dev *hdev);
      int (*xmit) (struct nfc_hci_dev *hdev, struct sk_buff *skb);
      int (*start_poll) (struct nfc_hci_dev *hdev,
                         u32 im_protocols, u32 tm_protocols);
      int (*dep_link_up)(struct nfc_hci_dev *hdev, struct nfc_target *target,
                         u8 comm_mode, u8 *gb, size_t gb_len);
      int (*dep_link_down)(struct nfc_hci_dev *hdev);
      int (*target_from_gate) (struct nfc_hci_dev *hdev, u8 gate,
                               struct nfc_target *target);
      int (*complete_target_discovered) (struct nfc_hci_dev *hdev, u8 gate,
                                         struct nfc_target *target);
      int (*im_transceive) (struct nfc_hci_dev *hdev,
                            struct nfc_target *target, struct sk_buff *skb,
                            data_exchange_cb_t cb, void *cb_context);
      int (*tm_send)(struct nfc_hci_dev *hdev, struct sk_buff *skb);
      int (*check_presence)(struct nfc_hci_dev *hdev,
                            struct nfc_target *target);
      int (*event_received)(struct nfc_hci_dev *hdev, u8 gate, u8 event,
                            struct sk_buff *skb);
};”h]”hX!  struct nfc_hci_ops {
      int (*open)(struct nfc_hci_dev *hdev);
      void (*close)(struct nfc_hci_dev *hdev);
      int (*hci_ready) (struct nfc_hci_dev *hdev);
      int (*xmit) (struct nfc_hci_dev *hdev, struct sk_buff *skb);
      int (*start_poll) (struct nfc_hci_dev *hdev,
                         u32 im_protocols, u32 tm_protocols);
      int (*dep_link_up)(struct nfc_hci_dev *hdev, struct nfc_target *target,
                         u8 comm_mode, u8 *gb, size_t gb_len);
      int (*dep_link_down)(struct nfc_hci_dev *hdev);
      int (*target_from_gate) (struct nfc_hci_dev *hdev, u8 gate,
                               struct nfc_target *target);
      int (*complete_target_discovered) (struct nfc_hci_dev *hdev, u8 gate,
                                         struct nfc_target *target);
      int (*im_transceive) (struct nfc_hci_dev *hdev,
                            struct nfc_target *target, struct sk_buff *skb,
                            data_exchange_cb_t cb, void *cb_context);
      int (*tm_send)(struct nfc_hci_dev *hdev, struct sk_buff *skb);
      int (*check_presence)(struct nfc_hci_dev *hdev,
                            struct nfc_target *target);
      int (*event_received)(struct nfc_hci_dev *hdev, u8 gate, u8 event,
                            struct sk_buff *skb);
};”…””}”hj:  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1j8  hŸh¶h KBhj  hžhubh¸)”}”(hhh]”(h½)”}”(hŒ6open() and close() shall turn the hardware on and off.”h]”hÃ)”}”(hjO  h]”hŒ6open() and close() shall turn the hardware on and off.”…””}”(hjQ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KZhjM  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjJ  hžhhŸh¶h Nubh½)”}”(hŒÃhci_ready() is an optional entry point that is called right after the hci
session has been set up. The driver can use it to do additional initialization
that must be performed using HCI commands.”h]”hÃ)”}”(hŒÃhci_ready() is an optional entry point that is called right after the hci
session has been set up. The driver can use it to do additional initialization
that must be performed using HCI commands.”h]”hŒÃhci_ready() is an optional entry point that is called right after the hci
session has been set up. The driver can use it to do additional initialization
that must be performed using HCI commands.”…””}”(hjh  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K[hjd  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjJ  hžhhŸh¶h Nubh½)”}”(hŒ7xmit() shall simply write a frame to the physical link.”h]”hÃ)”}”(hj~  h]”hŒ7xmit() shall simply write a frame to the physical link.”…””}”(hj€  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K^hj|  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjJ  hžhhŸh¶h Nubh½)”}”(hŒÑstart_poll() is an optional entrypoint that shall set the hardware in polling
mode. This must be implemented only if the hardware uses proprietary gates or a
mechanism slightly different from the HCI standard.”h]”hÃ)”}”(hŒÑstart_poll() is an optional entrypoint that shall set the hardware in polling
mode. This must be implemented only if the hardware uses proprietary gates or a
mechanism slightly different from the HCI standard.”h]”hŒÑstart_poll() is an optional entrypoint that shall set the hardware in polling
mode. This must be implemented only if the hardware uses proprietary gates or a
mechanism slightly different from the HCI standard.”…””}”(hj—  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K_hj“  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjJ  hžhhŸh¶h Nubh½)”}”(hŒ¢dep_link_up() is called after a p2p target has been detected, to finish
the p2p connection setup with hardware parameters that need to be passed back
to nfc core.”h]”hÃ)”}”(hŒ¢dep_link_up() is called after a p2p target has been detected, to finish
the p2p connection setup with hardware parameters that need to be passed back
to nfc core.”h]”hŒ¢dep_link_up() is called after a p2p target has been detected, to finish
the p2p connection setup with hardware parameters that need to be passed back
to nfc core.”…””}”(hj¯  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Kbhj«  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjJ  hžhhŸh¶h Nubh½)”}”(hŒ5dep_link_down() is called to bring the p2p link down.”h]”hÃ)”}”(hjÅ  h]”hŒ5dep_link_down() is called to bring the p2p link down.”…””}”(hjÇ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KehjÃ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjJ  hžhhŸh¶h Nubh½)”}”(hŒmtarget_from_gate() is an optional entrypoint to return the nfc protocols
corresponding to a proprietary gate.”h]”hÃ)”}”(hŒmtarget_from_gate() is an optional entrypoint to return the nfc protocols
corresponding to a proprietary gate.”h]”hŒmtarget_from_gate() is an optional entrypoint to return the nfc protocols
corresponding to a proprietary gate.”…””}”(hjÞ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KfhjÚ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjJ  hžhhŸh¶h Nubh½)”}”(hŒ¥complete_target_discovered() is an optional entry point to let the driver
perform additional proprietary processing necessary to auto activate the
discovered target.”h]”hÃ)”}”(hŒ¥complete_target_discovered() is an optional entry point to let the driver
perform additional proprietary processing necessary to auto activate the
discovered target.”h]”hŒ¥complete_target_discovered() is an optional entry point to let the driver
perform additional proprietary processing necessary to auto activate the
discovered target.”…””}”(hjö  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Khhjò  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjJ  hžhhŸh¶h Nubh½)”}”(hXŒ  im_transceive() must be implemented by the driver if proprietary HCI commands
are required to send data to the tag. Some tag types will require custom
commands, others can be written to using the standard HCI commands. The driver
can check the tag type and either do proprietary processing, or return 1 to ask
for standard processing. The data exchange command itself must be sent
asynchronously.”h]”hÃ)”}”(hXŒ  im_transceive() must be implemented by the driver if proprietary HCI commands
are required to send data to the tag. Some tag types will require custom
commands, others can be written to using the standard HCI commands. The driver
can check the tag type and either do proprietary processing, or return 1 to ask
for standard processing. The data exchange command itself must be sent
asynchronously.”h]”hXŒ  im_transceive() must be implemented by the driver if proprietary HCI commands
are required to send data to the tag. Some tag types will require custom
commands, others can be written to using the standard HCI commands. The driver
can check the tag type and either do proprietary processing, or return 1 to ask
for standard processing. The data exchange command itself must be sent
asynchronously.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Kkhj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjJ  hžhhŸh¶h Nubh½)”}”(hŒ@tm_send() is called to send data in the case of a p2p connection”h]”hÃ)”}”(hj$  h]”hŒ@tm_send() is called to send data in the case of a p2p connection”…””}”(hj&  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Kqhj"  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjJ  hžhhŸh¶h Nubh½)”}”(hŒëcheck_presence() is an optional entry point that will be called regularly
by the core to check that an activated tag is still in the field. If this is
not implemented, the core will not be able to push tag_lost events to the user
space”h]”hÃ)”}”(hŒëcheck_presence() is an optional entry point that will be called regularly
by the core to check that an activated tag is still in the field. If this is
not implemented, the core will not be able to push tag_lost events to the user
space”h]”hŒëcheck_presence() is an optional entry point that will be called regularly
by the core to check that an activated tag is still in the field. If this is
not implemented, the core will not be able to push tag_lost events to the user
space”…””}”(hj=  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Krhj9  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjJ  hžhhŸh¶h Nubh½)”}”(hŒ”event_received() is called to handle an event coming from the chip. Driver
can handle the event or return 1 to let HCI attempt standard processing.
”h]”hÃ)”}”(hŒ“event_received() is called to handle an event coming from the chip. Driver
can handle the event or return 1 to let HCI attempt standard processing.”h]”hŒ“event_received() is called to handle an event coming from the chip. Driver
can handle the event or return 1 to let HCI attempt standard processing.”…””}”(hjU  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KvhjQ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjJ  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”j  j  uh1h·hŸh¶h KZhj  hžhubhÃ)”}”(hŒËOn the rx path, the driver is responsible to push incoming HCP frames to HCI
using nfc_hci_recv_frame(). HCI will take care of re-aggregation and handling
This must be done from a context that can sleep.”h]”hŒËOn the rx path, the driver is responsible to push incoming HCP frames to HCI
using nfc_hci_recv_frame(). HCI will take care of re-aggregation and handling
This must be done from a context that can sleep.”…””}”(hjo  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Kyhj  hžhubeh}”(h]”Œhci-management”ah ]”h"]”Œhci management”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K=ubh¢)”}”(hhh]”(h§)”}”(hŒPHY Management”h]”hŒPHY Management”…””}”(hjˆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj…  hžhhŸh¶h K~ubhÃ)”}”(hŒOThe physical link (i2c, ...) management is defined by the following structure::”h]”hŒNThe physical link (i2c, ...) management is defined by the following structure:”…””}”(hj–  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K€hj…  hžhubj9  )”}”(hŒ–struct nfc_phy_ops {
      int (*write)(void *dev_id, struct sk_buff *skb);
      int (*enable)(void *dev_id);
      void (*disable)(void *dev_id);
};”h]”hŒ–struct nfc_phy_ops {
      int (*write)(void *dev_id, struct sk_buff *skb);
      int (*enable)(void *dev_id);
      void (*disable)(void *dev_id);
};”…””}”hj¤  sbah}”(h]”h ]”h"]”h$]”h&]”jH  jI  uh1j8  hŸh¶h K‚hj…  hžhubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒDenable():
turn the phy on (power on), make it ready to transfer data”h]”(hŒterm”“”)”}”(hŒ	enable():”h]”hŒ	enable():”…””}”(hj¿  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hŸh¶h Kˆhj¹  ubhŒ
definition”“”)”}”(hhh]”hÃ)”}”(hŒ:turn the phy on (power on), make it ready to transfer data”h]”hŒ:turn the phy on (power on), make it ready to transfer data”…””}”(hjÒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K‰hjÏ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍ  hj¹  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j·  hŸh¶h Kˆhj´  ubj¸  )”}”(hŒdisable():
turn the phy off”h]”(j¾  )”}”(hŒ
disable():”h]”hŒ
disable():”…””}”(hjð  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hŸh¶h KŠhjì  ubjÎ  )”}”(hhh]”hÃ)”}”(hŒturn the phy off”h]”hŒturn the phy off”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K‹hjþ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍ  hjì  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j·  hŸh¶h KŠhj´  hžhubj¸  )”}”(hŒûwrite():
Send a data frame to the chip. Note that to enable higher
layers such as an llc to store the frame for re-emission, this
function must not alter the skb. It must also not return a positive
result (return 0 for success, negative for failure).
”h]”(j¾  )”}”(hŒwrite():”h]”hŒwrite():”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hŸh¶h Khj  ubjÎ  )”}”(hhh]”hÃ)”}”(hŒñSend a data frame to the chip. Note that to enable higher
layers such as an llc to store the frame for re-emission, this
function must not alter the skb. It must also not return a positive
result (return 0 for success, negative for failure).”h]”hŒñSend a data frame to the chip. Note that to enable higher
layers such as an llc to store the frame for re-emission, this
function must not alter the skb. It must also not return a positive
result (return 0 for success, negative for failure).”…””}”(hj0  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Khj-  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍ  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j·  hŸh¶h Khj´  hžhubeh}”(h]”h ]”h"]”h$]”h&]”uh1j²  hj…  hžhhŸh¶h NubhÃ)”}”(hŒIData coming from the chip shall be sent directly to nfc_hci_recv_frame().”h]”hŒIData coming from the chip shall be sent directly to nfc_hci_recv_frame().”…””}”(hjP  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K’hj…  hžhubeh}”(h]”Œphy-management”ah ]”h"]”Œphy management”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K~ubh¢)”}”(hhh]”(h§)”}”(hŒLLC”h]”hŒLLC”…””}”(hji  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjf  hžhhŸh¶h K•ubhÃ)”}”(hŒþCommunication between the CPU and the chip often requires some link layer
protocol. Those are isolated as modules managed by the HCI layer. There are
currently two modules : nop (raw transfer) and shdlc.
A new llc must implement the following functions::”h]”hŒýCommunication between the CPU and the chip often requires some link layer
protocol. Those are isolated as modules managed by the HCI layer. There are
currently two modules : nop (raw transfer) and shdlc.
A new llc must implement the following functions:”…””}”(hjw  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K—hjf  hžhubj9  )”}”(hX(  struct nfc_llc_ops {
      void *(*init) (struct nfc_hci_dev *hdev, xmit_to_drv_t xmit_to_drv,
                     rcv_to_hci_t rcv_to_hci, int tx_headroom,
                     int tx_tailroom, int *rx_headroom, int *rx_tailroom,
                     llc_failure_t llc_failure);
      void (*deinit) (struct nfc_llc *llc);
      int (*start) (struct nfc_llc *llc);
      int (*stop) (struct nfc_llc *llc);
      void (*rcv_from_drv) (struct nfc_llc *llc, struct sk_buff *skb);
      int (*xmit_from_hci) (struct nfc_llc *llc, struct sk_buff *skb);
};”h]”hX(  struct nfc_llc_ops {
      void *(*init) (struct nfc_hci_dev *hdev, xmit_to_drv_t xmit_to_drv,
                     rcv_to_hci_t rcv_to_hci, int tx_headroom,
                     int tx_tailroom, int *rx_headroom, int *rx_tailroom,
                     llc_failure_t llc_failure);
      void (*deinit) (struct nfc_llc *llc);
      int (*start) (struct nfc_llc *llc);
      int (*stop) (struct nfc_llc *llc);
      void (*rcv_from_drv) (struct nfc_llc *llc, struct sk_buff *skb);
      int (*xmit_from_hci) (struct nfc_llc *llc, struct sk_buff *skb);
};”…””}”hj…  sbah}”(h]”h ]”h"]”h$]”h&]”jH  jI  uh1j8  hŸh¶h Kœhjf  hžhubj³  )”}”(hhh]”(j¸  )”}”(hŒ.init():
allocate and init your private storage”h]”(j¾  )”}”(hŒinit():”h]”hŒinit():”…””}”(hjš  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hŸh¶h K¨hj–  ubjÎ  )”}”(hhh]”hÃ)”}”(hŒ&allocate and init your private storage”h]”hŒ&allocate and init your private storage”…””}”(hj«  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K©hj¨  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍ  hj–  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j·  hŸh¶h K¨hj“  ubj¸  )”}”(hŒdeinit():
cleanup”h]”(j¾  )”}”(hŒ	deinit():”h]”hŒ	deinit():”…””}”(hjÉ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hŸh¶h KªhjÅ  ubjÎ  )”}”(hhh]”hÃ)”}”(hŒcleanup”h]”hŒcleanup”…””}”(hjÚ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K«hj×  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍ  hjÅ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j·  hŸh¶h Kªhj“  hžhubj¸  )”}”(hŒ)start():
establish the logical connection”h]”(j¾  )”}”(hŒstart():”h]”hŒstart():”…””}”(hjø  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hŸh¶h K¬hjô  ubjÎ  )”}”(hhh]”hÃ)”}”(hŒ establish the logical connection”h]”hŒ establish the logical connection”…””}”(hj	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K­hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍ  hjô  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j·  hŸh¶h K¬hj“  hžhubj¸  )”}”(hŒ)stop ():
terminate the logical connection”h]”(j¾  )”}”(hŒstop ():”h]”hŒstop ():”…””}”(hj'  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hŸh¶h K®hj#  ubjÎ  )”}”(hhh]”hÃ)”}”(hŒ terminate the logical connection”h]”hŒ terminate the logical connection”…””}”(hj8  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K¯hj5  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍ  hj#  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j·  hŸh¶h K®hj“  hžhubj¸  )”}”(hŒ>rcv_from_drv():
handle data coming from the chip, going to HCI”h]”(j¾  )”}”(hŒrcv_from_drv():”h]”hŒrcv_from_drv():”…””}”(hjV  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hŸh¶h K°hjR  ubjÎ  )”}”(hhh]”hÃ)”}”(hŒ.handle data coming from the chip, going to HCI”h]”hŒ.handle data coming from the chip, going to HCI”…””}”(hjg  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K±hjd  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍ  hjR  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j·  hŸh¶h K°hj“  hžhubj¸  )”}”(hŒ<xmit_from_hci():
handle data sent by HCI, going to the chip
”h]”(j¾  )”}”(hŒxmit_from_hci():”h]”hŒxmit_from_hci():”…””}”(hj…  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j½  hŸh¶h K³hj  ubjÎ  )”}”(hhh]”hÃ)”}”(hŒ*handle data sent by HCI, going to the chip”h]”hŒ*handle data sent by HCI, going to the chip”…””}”(hj–  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K³hj“  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÍ  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j·  hŸh¶h K³hj“  hžhubeh}”(h]”h ]”h"]”h$]”h&]”uh1j²  hjf  hžhhŸh¶h NubhÃ)”}”(hŒOThe llc must be registered with nfc before it can be used. Do that by
calling::”h]”hŒNThe llc must be registered with nfc before it can be used. Do that by
calling:”…””}”(hj¶  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Kµhjf  hžhubj9  )”}”(hŒBnfc_llc_register(const char *name, const struct nfc_llc_ops *ops);”h]”hŒBnfc_llc_register(const char *name, const struct nfc_llc_ops *ops);”…””}”hjÄ  sbah}”(h]”h ]”h"]”h$]”h&]”jH  jI  uh1j8  hŸh¶h K¸hjf  hžhubhÃ)”}”(hŒAgain, note that the llc does not handle the physical link. It is thus very
easy to mix any physical link with any llc for a given chip driver.”h]”hŒAgain, note that the llc does not handle the physical link. It is thus very
easy to mix any physical link with any llc for a given chip driver.”…””}”(hjÒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Kºhjf  hžhubeh}”(h]”Œllc”ah ]”h"]”Œllc”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K•ubh¢)”}”(hhh]”(h§)”}”(hŒIncluded Drivers”h]”hŒIncluded Drivers”…””}”(hjë  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjè  hžhhŸh¶h K¾ubhÃ)”}”(hŒ]An HCI based driver for an NXP PN544, connected through I2C bus, and using
shdlc is included.”h]”hŒ]An HCI based driver for an NXP PN544, connected through I2C bus, and using
shdlc is included.”…””}”(hjù  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KÀhjè  hžhubeh}”(h]”Œincluded-drivers”ah ]”h"]”Œincluded drivers”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K¾ubh¢)”}”(hhh]”(h§)”}”(hŒExecution Contexts”h]”hŒExecution Contexts”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h KÄubhÃ)”}”(hŒÓThe execution contexts are the following:
- IRQ handler (IRQH):
fast, cannot sleep. sends incoming frames to HCI where they are passed to
the current llc. In case of shdlc, the frame is queued in shdlc rx queue.”h]”hŒÓThe execution contexts are the following:
- IRQ handler (IRQH):
fast, cannot sleep. sends incoming frames to HCI where they are passed to
the current llc. In case of shdlc, the frame is queued in shdlc rx queue.”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KÆhj  hžhubh¸)”}”(hhh]”(h½)”}”(hŒ|SHDLC State Machine worker (SMW)

Only when llc_shdlc is used: handles shdlc rx & tx queues.

Dispatches HCI cmd responses.
”h]”(hÃ)”}”(hŒ SHDLC State Machine worker (SMW)”h]”hŒ SHDLC State Machine worker (SMW)”…””}”(hj5  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KËhj1  ubhÃ)”}”(hŒ:Only when llc_shdlc is used: handles shdlc rx & tx queues.”h]”hŒ:Only when llc_shdlc is used: handles shdlc rx & tx queues.”…””}”(hjC  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KÍhj1  ubhÃ)”}”(hŒDispatches HCI cmd responses.”h]”hŒDispatches HCI cmd responses.”…””}”(hjQ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KÏhj1  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h¼hj.  hžhhŸh¶h Nubh½)”}”(hŒuHCI Tx Cmd worker (MSGTXWQ)

Serializes execution of HCI commands.

Completes execution in case of response timeout.
”h]”(hÃ)”}”(hŒHCI Tx Cmd worker (MSGTXWQ)”h]”hŒHCI Tx Cmd worker (MSGTXWQ)”…””}”(hji  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KÑhje  ubhÃ)”}”(hŒ%Serializes execution of HCI commands.”h]”hŒ%Serializes execution of HCI commands.”…””}”(hjw  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KÓhje  ubhÃ)”}”(hŒ0Completes execution in case of response timeout.”h]”hŒ0Completes execution in case of response timeout.”…””}”(hj…  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KÕhje  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h¼hj.  hžhhŸh¶h Nubh½)”}”(hŒEHCI Rx worker (MSGRXWQ)

Dispatches incoming HCI commands or events.
”h]”(hÃ)”}”(hŒHCI Rx worker (MSGRXWQ)”h]”hŒHCI Rx worker (MSGRXWQ)”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h K×hj™  ubhÃ)”}”(hŒ+Dispatches incoming HCI commands or events.”h]”hŒ+Dispatches incoming HCI commands or events.”…””}”(hj«  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KÙhj™  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h¼hj.  hžhhŸh¶h Nubh½)”}”(hŒ\Syscall context from a userspace call (SYSCALL)

Any entrypoint in HCI called from NFC Core
”h]”(hÃ)”}”(hŒ/Syscall context from a userspace call (SYSCALL)”h]”hŒ/Syscall context from a userspace call (SYSCALL)”…””}”(hjÃ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KÛhj¿  ubhÃ)”}”(hŒ*Any entrypoint in HCI called from NFC Core”h]”hŒ*Any entrypoint in HCI called from NFC Core”…””}”(hjÑ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h KÝhj¿  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h¼hj.  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”j  j  uh1h·hŸh¶h KËhj  hžhubeh}”(h]”Œexecution-contexts”ah ]”h"]”Œexecution contexts”ah$]”h&]”uh1h¡hh£hžhhŸh¶h KÄubh¢)”}”(hhh]”(h§)”}”(hŒ/Workflow executing an HCI command (using shdlc)”h]”hŒ/Workflow executing an HCI command (using shdlc)”…””}”(hjö  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjó  hžhhŸh¶h KàubhÃ)”}”(hŒXExecuting an HCI command can easily be performed synchronously using the
following API::”h]”hŒWExecuting an HCI command can easily be performed synchronously using the
following API:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Kâhjó  hžhubj9  )”}”(hŒint nfc_hci_send_cmd (struct nfc_hci_dev *hdev, u8 gate, u8 cmd,
                      const u8 *param, size_t param_len, struct sk_buff **skb)”h]”hŒint nfc_hci_send_cmd (struct nfc_hci_dev *hdev, u8 gate, u8 cmd,
                      const u8 *param, size_t param_len, struct sk_buff **skb)”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”jH  jI  uh1j8  hŸh¶h Kåhjó  hžhubhÃ)”}”(hŒ¨The API must be invoked from a context that can sleep. Most of the time, this
will be the syscall context. skb will return the result that was received in
the response.”h]”hŒ¨The API must be invoked from a context that can sleep. Most of the time, this
will be the syscall context. skb will return the result that was received in
the response.”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Kèhjó  hžhubhÃ)”}”(hX  Internally, execution is asynchronous. So all this API does is to enqueue the
HCI command, setup a local wait queue on stack, and wait_event() for completion.
The wait is not interruptible because it is guaranteed that the command will
complete after some short timeout anyway.”h]”hX  Internally, execution is asynchronous. So all this API does is to enqueue the
HCI command, setup a local wait queue on stack, and wait_event() for completion.
The wait is not interruptible because it is guaranteed that the command will
complete after some short timeout anyway.”…””}”(hj.  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Kìhjó  hžhubhÃ)”}”(hX/  MSGTXWQ context will then be scheduled and invoke nfc_hci_msg_tx_work().
This function will dequeue the next pending command and send its HCP fragments
to the lower layer which happens to be shdlc. It will then start a timer to be
able to complete the command with a timeout error if no response arrive.”h]”hX/  MSGTXWQ context will then be scheduled and invoke nfc_hci_msg_tx_work().
This function will dequeue the next pending command and send its HCP fragments
to the lower layer which happens to be shdlc. It will then start a timer to be
able to complete the command with a timeout error if no response arrive.”…””}”(hj<  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Kñhjó  hžhubhÃ)”}”(hXv  SMW context gets scheduled and invokes nfc_shdlc_sm_work(). This function
handles shdlc framing in and out. It uses the driver xmit to send frames and
receives incoming frames in an skb queue filled from the driver IRQ handler.
SHDLC I(nformation) frames payload are HCP fragments. They are aggregated to
form complete HCI frames, which can be a response, command, or event.”h]”hXv  SMW context gets scheduled and invokes nfc_shdlc_sm_work(). This function
handles shdlc framing in and out. It uses the driver xmit to send frames and
receives incoming frames in an skb queue filled from the driver IRQ handler.
SHDLC I(nformation) frames payload are HCP fragments. They are aggregated to
form complete HCI frames, which can be a response, command, or event.”…””}”(hjJ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Köhjó  hžhubhÃ)”}”(hX  HCI Responses are dispatched immediately from this context to unblock
waiting command execution. Response processing involves invoking the completion
callback that was provided by nfc_hci_msg_tx_work() when it sent the command.
The completion callback will then wake the syscall context.”h]”hX  HCI Responses are dispatched immediately from this context to unblock
waiting command execution. Response processing involves invoking the completion
callback that was provided by nfc_hci_msg_tx_work() when it sent the command.
The completion callback will then wake the syscall context.”…””}”(hjX  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Kühjó  hžhubhÃ)”}”(hŒJIt is also possible to execute the command asynchronously using this API::”h]”hŒIIt is also possible to execute the command asynchronously using this API:”…””}”(hjf  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Mhjó  hžhubj9  )”}”(hŒåstatic int nfc_hci_execute_cmd_async(struct nfc_hci_dev *hdev, u8 pipe, u8 cmd,
                                     const u8 *param, size_t param_len,
                                     data_exchange_cb_t cb, void *cb_context)”h]”hŒåstatic int nfc_hci_execute_cmd_async(struct nfc_hci_dev *hdev, u8 pipe, u8 cmd,
                                     const u8 *param, size_t param_len,
                                     data_exchange_cb_t cb, void *cb_context)”…””}”hjt  sbah}”(h]”h ]”h"]”h$]”h&]”jH  jI  uh1j8  hŸh¶h Mhjó  hžhubhÃ)”}”(hŒThe workflow is the same, except that the API call returns immediately, and
the callback will be called with the result from the SMW context.”h]”hŒThe workflow is the same, except that the API call returns immediately, and
the callback will be called with the result from the SMW context.”…””}”(hj‚  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Mhjó  hžhubeh}”(h]”Œ-workflow-executing-an-hci-command-using-shdlc”ah ]”h"]”Œ/workflow executing an hci command (using shdlc)”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kàubh¢)”}”(hhh]”(h§)”}”(hŒ*Workflow receiving an HCI event or command”h]”hŒ*Workflow receiving an HCI event or command”…””}”(hj›  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj˜  hžhhŸh¶h MubhÃ)”}”(hX³  HCI commands or events are not dispatched from SMW context. Instead, they are
queued to HCI rx_queue and will be dispatched from HCI rx worker
context (MSGRXWQ). This is done this way to allow a cmd or event handler
to also execute other commands (for example, handling the
NFC_HCI_EVT_TARGET_DISCOVERED event from PN544 requires to issue an
ANY_GET_PARAMETER to the reader A gate to get information on the target
that was discovered).”h]”hX³  HCI commands or events are not dispatched from SMW context. Instead, they are
queued to HCI rx_queue and will be dispatched from HCI rx worker
context (MSGRXWQ). This is done this way to allow a cmd or event handler
to also execute other commands (for example, handling the
NFC_HCI_EVT_TARGET_DISCOVERED event from PN544 requires to issue an
ANY_GET_PARAMETER to the reader A gate to get information on the target
that was discovered).”…””}”(hj©  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Mhj˜  hžhubhÃ)”}”(hŒMTypically, such an event will be propagated to NFC Core from MSGRXWQ context.”h]”hŒMTypically, such an event will be propagated to NFC Core from MSGRXWQ context.”…””}”(hj·  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h Mhj˜  hžhubeh}”(h]”Œ*workflow-receiving-an-hci-event-or-command”ah ]”h"]”Œ*workflow receiving an hci event or command”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Mubh¢)”}”(hhh]”(h§)”}”(hŒError management”h]”hŒError management”…””}”(hjÐ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjÍ  hžhhŸh¶h MubhÃ)”}”(hŒ•Errors that occur synchronously with the execution of an NFC Core request are
simply returned as the execution result of the request. These are easy.”h]”hŒ•Errors that occur synchronously with the execution of an NFC Core request are
simply returned as the execution result of the request. These are easy.”…””}”(hjÞ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h MhjÍ  hžhubhÃ)”}”(hX  Errors that occur asynchronously (e.g. in a background protocol handling thread)
must be reported such that upper layers don't stay ignorant that something
went wrong below and know that expected events will probably never happen.
Handling of these errors is done as follows:”h]”hX  Errors that occur asynchronously (e.g. in a background protocol handling thread)
must be reported such that upper layers donâ€™t stay ignorant that something
went wrong below and know that expected events will probably never happen.
Handling of these errors is done as follows:”…””}”(hjì  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h MhjÍ  hžhubh¸)”}”(hhh]”(h½)”}”(hXJ  driver (pn544) fails to deliver an incoming frame: it stores the error such
that any subsequent call to the driver will result in this error. Then it
calls the standard nfc_shdlc_recv_frame() with a NULL argument to report the
problem above. shdlc stores a EREMOTEIO sticky status, which will trigger
SMW to report above in turn.
”h]”hÃ)”}”(hXI  driver (pn544) fails to deliver an incoming frame: it stores the error such
that any subsequent call to the driver will result in this error. Then it
calls the standard nfc_shdlc_recv_frame() with a NULL argument to report the
problem above. shdlc stores a EREMOTEIO sticky status, which will trigger
SMW to report above in turn.”h]”hXI  driver (pn544) fails to deliver an incoming frame: it stores the error such
that any subsequent call to the driver will result in this error. Then it
calls the standard nfc_shdlc_recv_frame() with a NULL argument to report the
problem above. shdlc stores a EREMOTEIO sticky status, which will trigger
SMW to report above in turn.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h M"hjý  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjú  hžhhŸh¶h Nubh½)”}”(hXu  SMW is basically a background thread to handle incoming and outgoing shdlc
frames. This thread will also check the shdlc sticky status and report to HCI
when it discovers it is not able to run anymore because of an unrecoverable
error that happened within shdlc or below. If the problem occurs during shdlc
connection, the error is reported through the connect completion.
”h]”hÃ)”}”(hXt  SMW is basically a background thread to handle incoming and outgoing shdlc
frames. This thread will also check the shdlc sticky status and report to HCI
when it discovers it is not able to run anymore because of an unrecoverable
error that happened within shdlc or below. If the problem occurs during shdlc
connection, the error is reported through the connect completion.”h]”hXt  SMW is basically a background thread to handle incoming and outgoing shdlc
frames. This thread will also check the shdlc sticky status and report to HCI
when it discovers it is not able to run anymore because of an unrecoverable
error that happened within shdlc or below. If the problem occurs during shdlc
connection, the error is reported through the connect completion.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h M(hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjú  hžhhŸh¶h Nubh½)”}”(hŒéHCI: if an internal HCI error happens (frame is lost), or HCI is reported an
error from a lower layer, HCI will either complete the currently executing
command with that error, or notify NFC Core directly if no command is
executing.
”h]”hÃ)”}”(hŒèHCI: if an internal HCI error happens (frame is lost), or HCI is reported an
error from a lower layer, HCI will either complete the currently executing
command with that error, or notify NFC Core directly if no command is
executing.”h]”hŒèHCI: if an internal HCI error happens (frame is lost), or HCI is reported an
error from a lower layer, HCI will either complete the currently executing
command with that error, or notify NFC Core directly if no command is
executing.”…””}”(hj1  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h M.hj-  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjú  hžhhŸh¶h Nubh½)”}”(hXL  NFC Core: when NFC Core is notified of an error from below and polling is
active, it will send a tag discovered event with an empty tag list to the user
space to let it know that the poll operation will never be able to detect a
tag. If polling is not active and the error was sticky, lower levels will
return it at next invocation.”h]”hÃ)”}”(hXL  NFC Core: when NFC Core is notified of an error from below and polling is
active, it will send a tag discovered event with an empty tag list to the user
space to let it know that the poll operation will never be able to detect a
tag. If polling is not active and the error was sticky, lower levels will
return it at next invocation.”h]”hXL  NFC Core: when NFC Core is notified of an error from below and polling is
active, it will send a tag discovered event with an empty tag list to the user
space to let it know that the poll operation will never be able to detect a
tag. If polling is not active and the error was sticky, lower levels will
return it at next invocation.”…””}”(hjI  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÂhŸh¶h M3hjE  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h¼hjú  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”j  j  uh1h·hŸh¶h M"hjÍ  hžhubeh}”(h]”Œerror-management”ah ]”h"]”Œerror management”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Mubeh}”(h]”Œhci-backend-for-nfc-core”ah ]”h"]”Œhci backend for nfc core”ah$]”h&]”uh1h¡hhhžhhŸh¶h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h¶uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¦NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j–  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h¶Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jp  jm  jA  j>  j¡  jž  jÈ  jÅ  jï  jì  j  j  j‚  j  jc  j`  jå  jâ  j  j	  jð  jí  j•  j’  jÊ  jÇ  jh  je  uŒ	nametypes”}”(jp  ‰jA  ‰j¡  ‰jÈ  ‰jï  ‰j  ‰j‚  ‰jc  ‰jå  ‰j  ‰jð  ‰j•  ‰jÊ  ‰jh  ‰uh}”(jm  h£j>  j  jž  jD  jÅ  j¤  jì  jË  j  jò  j  j  j`  j…  jâ  jf  j	  jè  jí  j  j’  jó  jÇ  j˜  je  jÍ  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.