refactor: I2C Tx/Rx functions

dev/test_nci2_pn7160_send_receive/Nfc.h

@@ -0,0 +1,364 @@
+/*
+*         Copyright (c), NXP Semiconductors Caen / France
+*
+*                     (C)NXP Semiconductors
+*       All rights are reserved. Reproduction in whole or in part is
+*      prohibited without the written consent of the copyright owner.
+*  NXP reserves the right to make changes without notice at any time.
+* NXP makes no warranty, expressed, implied or statutory, including but
+* not limited to any implied warranty of merchantability or fitness for any
+*particular purpose, or that the use will not infringe any third party patent,
+* copyright or trademark. NXP must not be liable for any loss or damage
+*                          arising from its use.
+*/
+
+/***** NFC dedicated interface ****************************************/
+
+/*
+ * Status code definition used as API returned values
+ */
+#define NFC_SUCCESS          0
+#define NFC_ERROR            1
+
+/*
+ * Flag definition used as Interface values
+ */
+#define INTF_UNDETERMINED    0x0
+#define INTF_FRAME           0x1
+#define INTF_ISODEP          0x2
+#define INTF_NFCDEP          0x3
+#define INTF_TAGCMD          0x80
+
+/*
+ * Flag definition used as Protocol values
+ */
+#define PROT_UNDETERMINED    0x0
+#define PROT_T1T             0x1
+#define PROT_T2T             0x2
+#define PROT_T3T             0x3
+#define PROT_ISODEP          0x4
+#define PROT_NFCDEP          0x5
+#define PROT_T5T             0x6
+#define PROT_MIFARE          0x80
+
+/*
+ * Flag definition used as Mode values
+ */
+#define MODE_POLL            0x00
+#define MODE_LISTEN          0x80
+#define MODE_MASK            0xF0
+
+/*
+ * Flag definition used as Technologies values
+ */
+#define TECH_PASSIVE_NFCA    0
+#define TECH_PASSIVE_NFCB    1
+#define TECH_PASSIVE_NFCF    2
+#define TECH_ACTIVE_NFC      3
+#define TECH_PASSIVE_15693   6
+
+/*
+ * Flag definition used for NFC library configuration
+ */
+#define NXPNCI_MODE_CARDEMU    (1<<0)
+#define NXPNCI_MODE_P2P        (1<<1)
+#define NXPNCI_MODE_RW         (1<<2)
+
+/*
+ * Definition of operations handled when processing Reader mode
+ */
+typedef enum
+{
+#ifndef REMOVE_NDEF_SUPPORT
+    READ_NDEF=0,
+    WRITE_NDEF=1,
+#endif //#ifndef REMOVE_NDEF_SUPPORT
+    PRESENCE_CHECK=2
+} NxpNci_RW_Operation_t;
+
+/*
+ * Definition of discovered remote device properties information
+ */
+/* POLL passive type A */
+typedef struct
+{
+    unsigned char SensRes[2];
+    unsigned char NfcIdLen;
+    unsigned char NfcId[10];
+    unsigned char SelResLen;
+    unsigned char SelRes[1];
+    unsigned char RatsLen;
+    unsigned char Rats[20];
+} NxpNci_RfIntf_info_APP_t;
+
+/* POLL passive type B */
+typedef struct
+{
+    unsigned char SensResLen;
+    unsigned char SensRes[12];
+    unsigned char AttribResLen;
+    unsigned char AttribRes[17];
+} NxpNci_RfIntf_info_BPP_t;
+
+/* POLL passive type F */
+typedef struct
+{
+    unsigned char BitRate;
+    unsigned char SensResLen;
+    unsigned char SensRes[18];
+} NxpNci_RfIntf_info_FPP_t;
+
+/* POLL passive type ISO15693 */
+typedef struct
+{
+    unsigned char AFI;
+    unsigned char DSFID;
+    unsigned char ID[8];
+} NxpNci_RfIntf_info_VPP_t;
+
+typedef union
+{
+    NxpNci_RfIntf_info_APP_t NFC_APP;
+    NxpNci_RfIntf_info_BPP_t NFC_BPP;
+    NxpNci_RfIntf_info_FPP_t NFC_FPP;
+    NxpNci_RfIntf_info_VPP_t NFC_VPP;
+} NxpNci_RfIntf_Info_t;
+
+/*
+ * Definition of discovered remote device properties
+ */
+typedef struct
+{
+    unsigned char Interface;
+    unsigned char Protocol;
+    unsigned char ModeTech;
+    bool MoreTags;
+    NxpNci_RfIntf_Info_t Info;
+} NxpNci_RfIntf_t;
+
+/**********************************************************************/
+
+/***** NFC dedicated API **********************************************/
+
+/*
+ * Open connection to the NXP-NCI device
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_Connect(void);
+
+/*
+ * Close connection to the NXP-NCI device
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_Disconnect(void);
+
+/*
+ * Return NXP-NCI device FW version (3 bytes)
+ */
+void NxpNci_GetFwVersion(unsigned char fw[3]);
+
+/*
+ * Configure NXP-NCI device settings
+ * Related settings are defined in Nfc_settings.h header file
+ * To be called after NxpNci_Connect() and prior to NxpNci_ConfigureMode() APIs
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_ConfigureSettings(void);
+
+/*
+ * Configure NXP-NCI device mode
+ * - mode: specifies which modes to be configured (see NXPNCI_MODE_xxx flags)
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_ConfigureMode(unsigned char mode);
+
+/*
+ * Configure NXP-NCI device parameters
+ * - pCmd: NCI CORE_SET_CONFIG_CMD frame
+ * - CmdSize: NCI CORE_SET_CONFIG_CMD frame size
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_ConfigureParams(unsigned char *pCmd, unsigned short CmdSize);
+
+/*
+ * Start NFC Discovery loop for remote NFC device detection
+ * - pTechTab: list of NFC technologies to look for (see TECH_xxx_xxx flags)
+ * - TechTabSize: number of items in the list
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_StartDiscovery(unsigned char *pTechTab, unsigned char TechTabSize);
+
+/*
+ * Stop NFC Discovery loop
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_StopDiscovery(void);
+
+/*
+ * Wait until remote NFC device is discovered
+ * - pRfIntf: filled with discovered NFC remote device properties
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_WaitForDiscoveryNotification(NxpNci_RfIntf_t *pRfIntf);
+
+/**********************************************************************/
+
+/***** Reader/writer dedicated APIs ***********************************/
+#ifndef REMOVE_RW_SUPPORT
+#ifndef REMOVE_NDEF_SUPPORT
+/*
+ * Register NDEF message to be written to remote NFC Tag
+ * - pMessage: pointer to the NDEF message
+ * - Message_size: NDEF message size
+ * - pCb: pointer to function to be called back when tag has been written
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool RW_NDEF_SetMessage(unsigned char *pMessage, unsigned short Message_size, void *pCb);
+
+/*
+ * Register function called when NDEF message is read from remote NFC Tag
+ * - pCb: pointer to function to be called back when NDEF message has been read
+ */
+void RW_NDEF_RegisterPullCallback(void *pCb);
+#endif //#ifndef REMOVE_NDEF_SUPPORT
+
+/*
+ * Process the operation identified as parameter with discovered remote NFC tag (function is blocking until the end of the operation)
+ * - RfIntf: discovered NFC device properties
+ * - Operation: select operation to be done with the remote NFC tag
+ *  o READ_NDEF: extract NDEF message from the tag, previously registered callback function will be called whenever complete NDEF message is found.
+ *  o WRITE_NDEF: write previously registered NDEF message to the tag
+ *  o PRESENCE_CHECK: perform presence check until tag has been removed (function is blocking until card is removed)
+  */
+void NxpNci_ProcessReaderMode(NxpNci_RfIntf_t RfIntf, NxpNci_RW_Operation_t Operation);
+
+/*
+ * Perform RAW transceive operation (send then receive) with the remote tag
+ * - pCommand: pointer to the command to send
+ * - CommandSize: command size
+ * - pAnswer: pointer to buffer for getting the response
+ * - pAnswerSize: response size
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_ReaderTagCmd (unsigned char *pCommand, unsigned char CommandSize, unsigned char *pAnswer, unsigned char *pAnswerSize);
+
+/*
+ * Perform activation of the next tag (in case of multiple tag detection or multi-protocol tag)
+ * - pRfIntf: filled with discovered NFC remote device properties
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_ReaderActivateNext(NxpNci_RfIntf_t *pRfIntf);
+
+/*
+ * Perform deactivation then reactivation of the current tag
+ * - pRfIntf: filled with discovered NFC remote device properties
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_ReaderReActivate(NxpNci_RfIntf_t *pRfIntf);
+#endif //#ifndef REMOVE_RW_SUPPORT
+/**********************************************************************/
+
+/***** Card Emulation dedicated APIs **********************************/
+#ifndef REMOVE_CARDEMU_SUPPORT
+#ifndef REMOVE_NDEF_SUPPORT
+/*
+ * Register NDEF message to be exposed to remote NFC reader Device
+ * - pMessage: pointer to the NDEF message
+ * - Message_size: NDEF message size
+ * - pCb: pointer to function to be called back when tag has been written
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool T4T_NDEF_EMU_SetMessage(unsigned char *pMessage, unsigned short Message_size, void *pCb);
+#endif //#ifndef REMOVE_NDEF_SUPPORT
+
+/*
+ * Expose the previously registered NDEF message to discovered remote NFC reader (function is blocking until the remote reader is lost):
+ * - RfIntf: discovered NFC device properties
+  */
+void NxpNci_ProcessCardMode(NxpNci_RfIntf_t RfIntf);
+
+/*
+ * Perform RAW reception of data from the remote reader
+ * - pData: pointer to buffer for getting the data
+ * - pDataSize: received data size
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_CardModeReceive (unsigned char *pData, unsigned char *pDataSize);
+
+/*
+ * Perform RAW transmission of data from the remote reader
+ * - pData: pointer to data to transmit
+ * - DataSize: size of data to transmit
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_CardModeSend (unsigned char *pData, unsigned char DataSize);
+#endif //#ifndef REMOVE_CARDEMU_SUPPORT
+
+/**********************************************************************/
+
+/***** P2P dedicated APIs *********************************************/
+#ifndef REMOVE_P2P_SUPPORT
+/*
+ * Register NDEF message to be sent to remote NFC Peer to peer Device
+ * - pMessage: pointer to the NDEF message
+ * - Message_size: NDEF message size
+ * - pCb: pointer to function to be called back when tag has been sent
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool P2P_NDEF_SetMessage(unsigned char *pMessage, unsigned short Message_size, void *pCb);
+
+/*
+ * Register function called when NDEF message is received from remote NFC Peer to peer Device
+ * - pCb: pointer to function to be called back when NDEF message has been received
+ */
+void P2P_NDEF_RegisterPullCallback(void *pCb);
+
+/* Process P2P operation (function is blocking until the remote peer is lost):
+ *  ¤ SNEP server to allow receiving NDEF message from remote NFC P2P device
+ *  ¤ SNEP client to send previously registered NDEF message
+ * - RfIntf: discovered NFC device properties
+ */
+void NxpNci_ProcessP2pMode(NxpNci_RfIntf_t RfIntf);
+#endif //#ifndef REMOVE_P2P_SUPPORT
+
+/**********************************************************************/
+
+/***** Factory Test dedicated APIs *********************************************/
+#ifndef REMOVE_FACTORYTEST_SUPPORT
+/*
+ * Definition of technology types
+ */
+typedef enum
+{
+    NFC_A,
+    NFC_B,
+    NFC_F
+} NxpNci_TechType_t;
+
+/*
+ * Definition of bitrate
+ */
+typedef enum
+{
+    BR_106,
+	BR_212,
+	BR_424,
+	BR_848
+} NxpNci_Bitrate_t;
+
+/*
+ * Set the NFC Controller in continuous modulated field mode
+ * - type: modulation type
+ * - bitrate: modulation bitrate
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_FactoryTest_Prbs(NxpNci_TechType_t type, NxpNci_Bitrate_t bitrate);
+
+/*
+ * Set the NFC Controller in continuous unmodulated field mode
+ * return NFC_SUCCESS or NFC_ERROR
+ */
+bool NxpNci_FactoryTest_RfOn(void);
+
+#endif //#ifndef REMOVE_FACTORYTEST_SUPPORT
+/********************************************************************************/