/*
* 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 */