From 5d9927ba30ba449badb9f6df0fbeb4d6aedc6e2a Mon Sep 17 00:00:00 2001 From: Nick Pelly Date: Thu, 23 Sep 2010 12:47:58 -0700 Subject: 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 --- src/phHciNfc_RFReaderA.h | 373 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 373 insertions(+) create mode 100644 src/phHciNfc_RFReaderA.h (limited to 'src/phHciNfc_RFReaderA.h') 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 + +/* +****************************** 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 */ + -- cgit v1.1