NFC: Define secure element connectivity and transaction events
authorSamuel Ortiz <sameo@linux.intel.com>
Tue, 25 Jun 2013 14:22:08 +0000 (16:22 +0200)
committerSamuel Ortiz <sameo@linux.intel.com>
Tue, 13 Aug 2013 22:35:17 +0000 (00:35 +0200)
The SE_CONNECTIVITY event is for an SE to request connection to e.g. a
modem. The SE_TRANSACTION one is sent when an application running on a
specific SE wants to notify the host CPU about the end of a transaction.
Those events respectively map to the EVT_CONNECTIVITY and the
EVT_TRANSACTION HCI events.

Signed-off-by: Samuel Ortiz <sameo@linux.intel.com>
include/uapi/linux/nfc.h

index 40ada984cb7889be59c7a93a473c5ce1028b5f68..539d60494c041eff867a36b2b0ba6998e5fd0cac 100644 (file)
  *     an embedded SE or an UICC one connected to it through SWP.
  * @NFC_EVENT_SE_REMOVED: Event emitted when a secure element is removed from
  *     the system, as a consequence of e.g. an NFC controller being unplugged.
+ * @NFC_EVENT_SE_CONNECTIVITY: This event is emitted whenever a secure element
+ *     is requesting connectivity access. For example a UICC SE may need to
+ *     talk with a sleeping modem and will notify this need by sending this
+ *     event. It is then up to userspace to decide if it will wake the modem
+ *     up or not.
+ * @NFC_EVENT_SE_TRANSACTION: This event is sent when an application running on
+ *     a specific SE notifies us about the end of a transaction. The parameter
+ *     for this event is the application ID (AID).
  */
 enum nfc_commands {
        NFC_CMD_UNSPEC,
@@ -102,6 +110,8 @@ enum nfc_commands {
        NFC_CMD_FW_DOWNLOAD,
        NFC_EVENT_SE_ADDED,
        NFC_EVENT_SE_REMOVED,
+       NFC_EVENT_SE_CONNECTIVITY,
+       NFC_EVENT_SE_TRANSACTION,
 /* private: internal use only */
        __NFC_CMD_AFTER_LAST
 };
@@ -159,6 +169,7 @@ enum nfc_attrs {
        NFC_ATTR_FIRMWARE_NAME,
        NFC_ATTR_SE_INDEX,
        NFC_ATTR_SE_TYPE,
+       NFC_ATTR_SE_AID,
 /* private: internal use only */
        __NFC_ATTR_AFTER_LAST
 };