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, 333 insertions, 0 deletions

diff --git a/src/phHciNfc_DevMgmt.h b/src/phHciNfc_DevMgmt.h
new file mode 100644
index 0000000..571fac2
--- /dev/null
+++ b/src/phHciNfc_DevMgmt.h
@@ -0,0 +1,333 @@
+/*
+ * 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_DevMgmt.h                                                   *
+* \brief HCI Header for the PN544 Device Management Gate.                     *
+*                                                                             *
+*                                                                             *
+* Project: NFC-FRI-1.1                                                        *
+*                                                                             *
+* $Date: Tue Jun  8 09:30:49 2010 $                                           *
+* $Author: ing04880 $                                                         *
+* $Revision: 1.15 $                                                            *
+* $Aliases: NFC_FRI1.1_WK1023_R35_1 $  
+*                                                                             *
+* =========================================================================== *
+*/
+
+
+#ifndef PHHCINFC_DEVMGMT_H
+#define PHHCINFC_DEVMGMT_H
+
+/*@}*/
+
+
+/**
+ *  \name HCI
+ *
+ * File: \ref phHciNfc_DevMgmt.h
+ *
+ */
+/*@{*/
+#define PHHCINFC_DEVICE_MGMT_FILEREVISION "$Revision: 1.15 $" /**< \ingroup grp_file_attributes */
+#define PHHCINFC_DEVICE_MGMT_FILEALIASES  "$Aliases: NFC_FRI1.1_WK1023_R35_1 $"     /**< \ingroup grp_file_attributes */
+/*@}*/
+
+/*
+***************************** Header File Inclusion ****************************
+*/
+
+#include <phHciNfc_Generic.h>
+
+/*
+****************************** Macro Definitions *******************************
+*/
+
+#define DEVICE_PWR_STATUS_INDEX         0x01U
+#define DEVICE_INFO_EVT_INDEX           0x02U
+#define DEVICE_INFO_EEPROM_INDEX        0x03U
+
+#define  NXP_DOWNLOAD_GPIO              0x04U
+
+/* GPIO PIN Mask Macro */
+#define NXP_NFC_GPIO_MASK(n)  ((uint8_t)(1U << (n)))
+
+/* Address Definitions for GPIO Register Configuration */
+#define NFC_ADDRESS_GPIO_PDIR           0xF821U
+#define NFC_ADDRESS_GPIO_PEN            0xF829U
+
+
+/* Address Definitions for SWP Configuration */
+#define NFC_ADDRESS_SWP_BITRATE         0x9C01U
+#define NFC_ADDRESS_SWP_PWR_REQ         0x9EB4U
+
+/* Address Definitions for UICC Host Configuration */
+#define NFC_ADDRESS_UICC_RD_A_ACCESS    0x9ED9U
+#define NFC_ADDRESS_UICC_RD_B_ACCESS    0x9EDAU
+#define NFC_ADDRESS_UICC_CE_A_ACCESS    0x9EDBU
+#define NFC_ADDRESS_UICC_CE_B_ACCESS    0x9EDCU
+#define NFC_ADDRESS_UICC_CE_BP_ACCESS   0x9EDDU
+#define NFC_ADDRESS_UICC_CE_F_ACCESS    0x9EDEU
+
+/* Address Definitions for SE Configuration */
+
+/* Address Definitions for HW Configuration */
+#define NFC_ADDRESS_CLK_REQ             0x9E71U
+#define NFC_ADDRESS_CLK_INPUT           0x9809U
+#define NFC_ADDRESS_HW_CONF             0x9810U
+#define NFC_ADDRESS_PWR_STATUS          0x9EAAU
+
+/* Address Definitions for RF Configuration */
+
+
+/* Address Definitions for Interframe Character Timeout Configuration */
+#define NFC_ADDRESS_IFC_TO_RX_H          0x9C0CU
+#define NFC_ADDRESS_IFC_TO_RX_L          0x9C0DU
+#define NFC_ADDRESS_IFC_TO_TX_H          0x9C12U
+#define NFC_ADDRESS_IFC_TO_TX_L          0x9C13U
+
+
+/* Address Definitions for LLC Configuration */
+#define NFC_ADDRESS_LLC_ACK_TO_H          0x9C27U
+#define NFC_ADDRESS_LLC_ACK_TO_L          0x9C28U
+#define NFC_ADDRESS_LLC_GRD_TO_H          0x9C31U
+#define NFC_ADDRESS_LLC_GRD_TO_L          0x9C32U
+
+#define NFC_ADDRESS_ACT_GRD_TO          0x9916U
+
+/* The Address Definition for the TYPE B Tuning */
+
+#ifdef SW_TYPE_RF_TUNING_BF
+#define NFC_ADDRESS_ANAIRQ_CONF         0x9801U
+#define NFC_ADDRESS_PMOS_MOD            0x997AU
+#endif
+
+
+/* The Address Definition for the Enabling the EVT_HOT_PLUG */
+#define NFC_ADDRESS_HOTPLUG_EVT         0x9FF0U
+
+
+/*
+******************** Enumeration and Structure Definition **********************
+*/
+
+
+
+/*
+*********************** Function Prototype Declaration *************************
+*/
+
+/************************ Function Prototype Declaration *************************/
+
+/*!
+ * \brief Allocates the resources required for  PN544 Device management gate.
+ *
+ * This function Allocates necessary resources as requiered by PN544 Device
+ * gate management
+ *
+ * \param[in]  psHciContext            psHciContext is the pointer to HCI Layer
+ *
+ * \retval NFCSTATUS_SUCCESS           Function execution is successful
+ *
+ * \retval NFCSTATUS_INVALID_PARAMETER One or more of the given inputs are not valid
+ */
+
+extern
+NFCSTATUS
+phHciNfc_DevMgmt_Init_Resources(phHciNfc_sContext_t   *psHciContext);
+
+
+/**
+* \ingroup grp_hci_nfc
+*
+*   The phHciNfc_DevMgmt_Get_PipeID function gives the pipe id of the PN544 Device
+*   management 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
+*   \param[in]  ppipe_id                ppipe_id of the Device management 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_DevMgmt_Get_PipeID(
+                            phHciNfc_sContext_t     *psHciContext,
+                            uint8_t                 *ppipe_id
+                            );
+
+/**
+ * \ingroup grp_hci_nfc
+ *
+ *  The phHciNfc_DevMgmt_Initialise function creates and the opens the pipe 
+ *  PN544 Device Management Gate in the NFC Device
+ *
+ *  \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_PENDING           Device Mgmt Gate Initialisation is pending.
+ *  \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+ *                                      could not be interpreted properly.
+ *  \retval Other errors                Errors related to the other layers
+ *
+ */
+
+extern
+NFCSTATUS
+phHciNfc_DevMgmt_Initialise(
+                                phHciNfc_sContext_t     *psHciContext,
+                                void                    *pHwRef
+                         );
+
+/**
+ * \ingroup grp_hci_nfc
+ *
+ *  The phHciNfc_DevMgmt_Test function performs the System Management Tests 
+ * provided by the NFC Peripheral device.
+ *
+ *  \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]  test_type               test_type is the type of the Self Test
+ *                                      that needs to be performed on the device.
+ *  \param[in]  test_param              test_param is the parameter for the Self Test
+ *                                      that needs to be performed on the device.
+ *
+ *
+ *  \retval NFCSTATUS_PENDING           Self Test on the Device Management gate 
+ *                                      is pending.
+ *  \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+ *                                      could not be interpreted properly.
+ *  \retval Other errors                Errors related to the other layers
+ *
+ */
+
+extern
+NFCSTATUS
+phHciNfc_DevMgmt_Test(
+                    void                            *psContext,
+                    void                            *pHwRef,
+                    uint8_t                         test_type,
+                    phNfc_sData_t                   *test_param
+                 );
+
+extern
+NFCSTATUS
+phHciNfc_DevMgmt_Get_Info (
+                            phHciNfc_sContext_t *psHciContext,
+                            void                *pHwRef,
+                            uint16_t            address,
+                            uint8_t             *p_val
+                );
+
+extern
+NFCSTATUS
+phHciNfc_DevMgmt_Configure (
+                            phHciNfc_sContext_t *psHciContext,
+                            void                *pHwRef,
+                            uint16_t            address,
+                            uint8_t             value
+                );
+
+extern
+NFCSTATUS
+phHciNfc_DevMgmt_Get_Test_Result(
+                            phHciNfc_sContext_t        *psHciContext,
+                            phNfc_sData_t              *test_result
+                            );
+
+
+/**
+* \ingroup grp_hci_nfc
+*
+* \brief Allocates the resources required for  PN544 Device 
+* management gate 
+* This function Allocates necessary resources as requiered by PN544 
+* Device management gate 
+*
+* \param[in]  psHciContext          psHciContext is the pointer to HCI Layer
+* \param[in]  pipeID                pipeID of the Device management Gate
+* \param[in]  pPipeInfo             Update the pipe Information of the Device
+*                                   Management Gate.
+*
+* \retval NFCSTATUS_SUCCESS           Function execution is successful
+*
+* \retval NFCSTATUS_INVALID_PARAMETER One or more of the given inputs are not valid
+*/
+extern
+NFCSTATUS
+phHciNfc_DevMgmt_Update_PipeInfo(
+                                  phHciNfc_sContext_t     *psHciContext,
+                                  uint8_t                 pipeID,
+                                  phHciNfc_Pipe_Info_t    *pPipeInfo
+                                  );
+
+/**
+ * \ingroup grp_hci_nfc
+ *
+ *  The phHciNfc_DevMgmt_Release function closes the opened pipes between 
+ *  the Device Management Gate in the Host Controller Device 
+ *  and the NFC Device.
+ *
+ *  \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_PENDING           Release of the Device Management gate 
+ *                                      resources are pending.
+ *  \retval NFCSTATUS_INVALID_PARAMETER One or more of the supplied parameters
+ *                                      could not be interpreted properly.
+ *  \retval Other errors                Errors related to the other layers
+ *
+ */
+extern
+NFCSTATUS
+phHciNfc_DevMgmt_Release(
+                                phHciNfc_sContext_t     *psHciContext,
+                                void                    *pHwRef
+                     );
+
+extern
+NFCSTATUS
+phHciNfc_DevMgmt_Update_Sequence(
+                                phHciNfc_sContext_t     *psHciContext,
+                                phHciNfc_eSeqType_t     DevMgmt_seq
+                             );
+
+extern
+NFCSTATUS
+phHciNfc_DevMgmt_Set_Test_Result(
+                                phHciNfc_sContext_t        *psHciContext,
+                                uint8_t                    test_status
+                            )
+;
+
+#endif
+