Initial libnfc checkin

Source: Trusted_NFC_Device_Host_AA03.01e02_google.zip code drop (23-Sep-2010)

Change-Id: Ie47f18423f949a8d3e0815d13f55c814312add24
Signed-off-by: Nick Pelly <npelly@google.com>

1 files changed, 373 insertions, 0 deletions

diff --git a/src/phHciNfc_RFReaderA.h b/src/phHciNfc_RFReaderA.h
new file mode 100644
index 0000000..7743186
--- /dev/null
+++ b/src/phHciNfc_RFReaderA.h
@@ -0,0 +1,373 @@
+/*
+ * Copyright (C) 2010 NXP Semiconductors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*!
+* =========================================================================== *
+*                                                                             *
+*                                                                             *
+* \file  phHciNfc_RFReaderA.h                                                 *
+* \brief HCI Reader A Management Routines.                                    *
+*                                                                             *
+*                                                                             *
+* Project: NFC-FRI-1.1                                                        *
+*                                                                             *
+* $Date: Fri Aug 14 17:01:27 2009 $                                           *
+* $Author: ing04880 $                                                         *
+* $Revision: 1.17 $                                                           *
+* $Aliases: NFC_FRI1.1_WK934_R31_1,NFC_FRI1.1_WK941_PREP1,NFC_FRI1.1_WK941_PREP2,NFC_FRI1.1_WK941_1,NFC_FRI1.1_WK943_R32_1,NFC_FRI1.1_WK949_PREP1,NFC_FRI1.1_WK943_R32_10,NFC_FRI1.1_WK943_R32_13,NFC_FRI1.1_WK943_R32_14,NFC_FRI1.1_WK1007_R33_1,NFC_FRI1.1_WK1007_R33_4,NFC_FRI1.1_WK1017_PREP1,NFC_FRI1.1_WK1017_R34_1,NFC_FRI1.1_WK1017_R34_2,NFC_FRI1.1_WK1023_R35_1 $                                          *
+*                                                                             *
+* =========================================================================== *
+*/
+
+
+#ifndef PHHCINFC_RFREADERA_H
+#define PHHCINFC_RFREADERA_H
+
+/*@}*/
+
+
+/**
+ *  \name HCI
+ *
+ * File: \ref phHciNfc_ReaderA.h
+ *
+ */
+/*@{*/
+#define PHHCINFC_RFREADERA_FILEREVISION "$Revision: 1.17 $" /**< \ingroup grp_file_attributes */
+#define PHHCINFC_RFREADERA_FILEALIASES  "$Aliases: NFC_FRI1.1_WK934_R31_1,NFC_FRI1.1_WK941_PREP1,NFC_FRI1.1_WK941_PREP2,NFC_FRI1.1_WK941_1,NFC_FRI1.1_WK943_R32_1,NFC_FRI1.1_WK949_PREP1,NFC_FRI1.1_WK943_R32_10,NFC_FRI1.1_WK943_R32_13,NFC_FRI1.1_WK943_R32_14,NFC_FRI1.1_WK1007_R33_1,NFC_FRI1.1_WK1007_R33_4,NFC_FRI1.1_WK1017_PREP1,NFC_FRI1.1_WK1017_R34_1,NFC_FRI1.1_WK1017_R34_2,NFC_FRI1.1_WK1023_R35_1 $"   /**< \ingroup grp_file_attributes */
+/*@}*/
+
+/*
+***************************** Header File Inclusion ****************************
+*/
+
+#include <phHciNfc_Generic.h>
+
+/*
+****************************** Macro Definitions *******************************
+*/
+
+/* Commands exposed to the upper layer */
+#define NXP_WRA_CONTINUE_ACTIVATION         0x12U
+#define NXP_MIFARE_RAW                      0x20U
+#define NXP_MIFARE_CMD                      0x21U
+#define DATA_RATE_MAX_DEFAULT_VALUE         0x00U
+
+/* Enable the reader A */
+#define HCI_READER_A_ENABLE                 0x01U
+#define HCI_READER_A_INFO_SEQ               0x02U
+
+#define RDR_A_TIMEOUT_MIN                   0x00U
+#define RDR_A_TIMEOUT_MAX                   0x15U
+/*
+******************** Enumeration and Structure Definition **********************
+*/
+typedef enum phHciNfc_ReaderA_Seq{
+    RDR_A_DATA_RATE_MAX,
+    RDR_A_UID,
+    RDR_A_SAK,
+    RDR_A_ATQA,
+    RDR_A_APP_DATA,
+    RDR_A_FWI_SFGT,
+    RDR_A_END_SEQUENCE, 
+    RDR_A_INVALID_SEQ
+} phHciNfc_ReaderA_Seq_t;
+
+/* Information structure for the polling loop Gate */
+typedef struct phHciNfc_ReaderA_Info{
+    /* Current running Sequence of the reader A Management */
+    phHciNfc_ReaderA_Seq_t          current_seq;
+    /* Next running Sequence of the reader A Management */
+    phHciNfc_ReaderA_Seq_t          next_seq;
+    /* Pointer to the reader A pipe information */
+    phHciNfc_Pipe_Info_t            *p_pipe_info;
+    uint8_t                         pipe_id;
+    /* Flag to say about the multiple targets */
+    uint8_t                         multiple_tgts_found;
+    /* Reader A information */
+    phHal_sRemoteDevInformation_t   reader_a_info;
+    /* Enable or disable reader gate */
+    uint8_t                         enable_rdr_a_gate;
+    /* UICC re-activation status */
+    uint8_t                         uicc_activation;
+} phHciNfc_ReaderA_Info_t;
+
+/*
+*********************** Function Prototype Declaration *************************
+*/
+
+/*!
+ * \brief Allocates the resources of reader A management gate.
+ *
+ * This function Allocates the resources of the reader A management
+ * gate Information Structure.
+ * 
+ */
+extern
+NFCSTATUS
+phHciNfc_ReaderA_Init_Resources(
+                                phHciNfc_sContext_t     *psHciContext
+                         );
+
+/**
+* \ingroup grp_hci_nfc
+*
+*   The phHciNfc_ReaderA_Get_PipeID function gives the pipe id of the reader A 
+*   gate
+*
+*   \param[in]  psHciContext            psHciContext is the pointer to HCI Layer
+*                                       context Structure.
+*   \param[in]  pHwRef                  pHwRef is the Information of
+*                                       the Device Interface Link
+*
+*   \retval NFCSTATUS_SUCCESS           Function execution is successful.
+*   \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+*                                       could not be interpreted properly.
+*
+*/
+extern
+NFCSTATUS
+phHciNfc_ReaderA_Get_PipeID(
+                            phHciNfc_sContext_t     *psHciContext,
+                            uint8_t                 *ppipe_id
+                            );
+                 
+/**
+* \ingroup grp_hci_nfc
+*
+*   The phHciNfc_ReaderA_Sequence function executes the sequence of operations, to
+*   get the UID, SAK, ATQA  etc.
+*
+*   \param[in]  psHciContext            psHciContext is the pointer to HCI Layer
+*                                       context Structure.
+*   \param[in]  pHwRef                  pHwRef is the Information of
+*                                       the Device Interface Link
+*
+*   \retval NFCSTATUS_SUCCESS           Function execution is successful.
+*   \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+*                                       could not be interpreted properly.
+*
+*/
+extern
+NFCSTATUS
+phHciNfc_ReaderA_Info_Sequence (
+                       void             *psHciHandle,
+                       void             *pHwRef
+                       );
+
+
+/**
+* \ingroup grp_hci_nfc
+*
+*   The phHciNfc_ReaderA_App_Data function is to get the application data information.
+*
+*   \param[in]  psHciContext            psHciContext is the pointer to HCI Layer
+*                                       context Structure.
+*   \param[in]  pHwRef                  pHwRef is the Information of
+*                                       the Device Interface Link
+*
+*   \retval NFCSTATUS_SUCCESS           Function execution is successful.
+*   \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+*                                       could not be interpreted properly.
+*
+*/
+extern
+NFCSTATUS
+phHciNfc_ReaderA_App_Data (
+                           void             *psHciHandle,
+                           void             *pHwRef
+                           );
+
+/**
+* \ingroup grp_hci_nfc
+*
+*   The phHciNfc_ReaderA_Fwi_Sfgt function is to get the frame waiting time
+*   information.
+*
+*   \param[in]  psHciContext            psHciContext is the pointer to HCI Layer
+*                                       context Structure.
+*   \param[in]  pHwRef                  pHwRef is the Information of
+*                                       the Device Interface Link
+*
+*   \retval NFCSTATUS_SUCCESS           Function execution is successful.
+*   \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+*                                       could not be interpreted properly.
+*
+*/
+extern
+NFCSTATUS
+phHciNfc_ReaderA_Fwi_Sfgt (
+                           void             *psHciHandle,
+                           void             *pHwRef
+                           );
+
+/**
+* \ingroup grp_hci_nfc
+*
+*  The phHciNfc_ReaderA_Update_PipeInfo function updates the pipe_id of the reader A
+*  gate management Structure.
+*
+*  \param[in]  psHciContext            psHciContext is the pointer to HCI Layer
+*                                      context Structure.
+*  \param[in]  pipeID                  pipeID of the reader A gate
+*  \param[in]  pPipeInfo               Update the pipe Information of the reader 
+*                                      A gate
+*
+*  \retval NFCSTATUS_SUCCESS           Function execution is successful.
+*  \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+*                                      could not be interpreted properly.
+*
+*/
+
+extern
+NFCSTATUS
+phHciNfc_ReaderA_Update_PipeInfo(
+                                  phHciNfc_sContext_t     *psHciContext,
+                                  uint8_t                 pipeID,
+                                  phHciNfc_Pipe_Info_t    *pPipeInfo
+                                  );
+
+/**
+* \ingroup grp_hci_nfc
+*
+*   The phHciNfc_Send_ReaderA_Command function executes the command sent by the 
+*   upper layer, depending on the commands defined.
+*
+*   \param[in]  psContext        psContext is the pointer to HCI Layer
+*                                context Structure.
+*   \param[in]  pHwRef           pHwRef is the Information of
+*                                the Device Interface Link
+*   \param[in]  pipe_id          pipeID of the reader A gate 
+*   \param[in]  cmd              command that needs to be sent to the device
+*   \param[in]  length           information length sent by the caller
+*   \param[in]  params           information related to the command
+*
+*   \retval NFCSTATUS_SUCCESS           Function execution is successful.
+*   \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+*                                       could not be interpreted properly.
+*
+*/
+extern
+NFCSTATUS
+phHciNfc_Send_ReaderA_Command(
+                              phHciNfc_sContext_t   *psContext,
+                              void                  *pHwRef,
+                              uint8_t               pipe_id,
+                              uint8_t               cmd
+                              );
+
+/**
+* \ingroup grp_hci_nfc
+*
+*   The phHciNfc_ReaderA_Auto_Activate function updates auto activate register
+*
+*   \param[in]  psContext        psContext is the pointer to HCI Layer
+*                                context Structure.
+*   \param[in]  pHwRef           pHwRef is the Information of
+*                                the Device Interface Link
+*   \param[in] activate_enable   to enable or disable auto activation
+*
+*   \retval NFCSTATUS_SUCCESS           Function execution is successful.
+*   \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+*                                       could not be interpreted properly.
+*
+*/
+extern
+NFCSTATUS
+phHciNfc_ReaderA_Auto_Activate(
+                               void         *psContext,
+                               void         *pHwRef,
+                               uint8_t      activate_enable
+                               );
+
+/**
+* \ingroup grp_hci_nfc
+*
+*   The phHciNfc_Send_ReaderA_Command function executes the command sent by the 
+*   upper layer, depending on the commands defined.
+*
+*   \param[in]  psHciContext     psHciContext is the pointer to HCI Layer
+*                                context Structure.
+*   \param[in]  infotype         To enable the reader A gate
+*   \param[in]  rdr_a_info       reader A gate info
+*
+*   \retval NFCSTATUS_SUCCESS           Function execution is successful.
+*   \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+*                                       could not be interpreted properly.
+*
+*/
+extern
+NFCSTATUS
+phHciNfc_ReaderA_Update_Info(
+                             phHciNfc_sContext_t        *psHciContext,
+                             uint8_t                    infotype,
+                             void                       *rdr_a_info
+                             );
+
+/**
+* \ingroup grp_hci_nfc
+*
+*   The phHciNfc_ReaderA_Cont_Active function executes NXP_WRA_CONTINUE_ACTIVATION
+*   command to inform the CLF Controller after having received the event
+*   EVT_TARGET_DISCOVERED to continue activation in case activation has 
+*   been stopped after successful SAK response. The response to this command, sent 
+*   as soon as the activation is finished, indicates the result of the 
+*   activation procedure
+*
+*   \param[in]  psHciContext     psHciContext is the pointer to HCI Layer
+*                                context Structure.
+*   \param[in]  pHwRef           pHwRef is the Information of
+*                                the Device Interface Link
+*   \param[in]  pipeID           pipeID of the reader A gate
+*
+*   \retval NFCSTATUS_SUCCESS           Function execution is successful.
+*   \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+*                                       could not be interpreted properly.
+*
+*/
+extern
+NFCSTATUS
+phHciNfc_ReaderA_Cont_Activate (
+                              phHciNfc_sContext_t       *psHciContext,
+                              void                      *pHwRef
+                              );
+
+/**
+* \ingroup grp_hci_nfc
+*
+*  The phHciNfc_ReaderA_Set_DataRateMax function updates the data rate max value 
+*
+*  \param[in]  psHciContext            psHciContext is the pointer to HCI Layer
+*                                      context Structure.
+*  \param[in]  pipeID                  pipeID of the reader A gate
+*  \param[in]  pPipeInfo               Update the pipe Information of the reader 
+*                                      A gate
+*
+*  \retval NFCSTATUS_SUCCESS           Function execution is successful.
+*  \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+*                                      could not be interpreted properly.
+*
+*/
+extern
+NFCSTATUS
+phHciNfc_ReaderA_Set_DataRateMax(
+                                 void         *psContext,
+                                 void         *pHwRef,
+                                 uint8_t      data_rate_value
+                                 );
+
+#endif /* #ifndef PHHCINFC_RFREADERA_H */
+