/******************************************************************************
*
* Copyright (C) 2009-2014 Broadcom Corporation
*
* 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.
*
******************************************************************************/
/******************************************************************************
*
* this file contains the NCI transport internal definitions and functions.
*
******************************************************************************/
#ifndef NFC_HAL_INT_H
#define NFC_HAL_INT_H
#include "gki.h"
#include "nci_defs.h"
#include "nfc_brcm_defs.h"
#include "nfc_hal_api.h"
#include "nfc_hal_int_api.h"
#include "nfc_hal_target.h"
using android::base::StringPrintf;
/* NFC HAL Task Timer events */
#ifndef NFC_HAL_QUICK_TIMER_EVT_MASK
#define NFC_HAL_QUICK_TIMER_EVT_MASK (TIMER_0_EVT_MASK)
#endif
#ifndef NFC_HAL_QUICK_TIMER_ID
#define NFC_HAL_QUICK_TIMER_ID (TIMER_0)
#endif
typedef uint8_t tNFC_HAL_WAIT_RSP;
#if (NFC_HAL_HCI_INCLUDED == TRUE)
#endif
/* NFC HAL transport configuration */
typedef struct {
bool shared_transport; /* TRUE if using shared HCI/NCI transport */
uint8_t userial_baud;
uint8_t userial_fc;
} tNFC_HAL_TRANS_CFG;
#ifdef TESTER
/* For Insight, ncit_cfg is runtime-configurable */
#define NFC_HAL_TRANS_CFG_QUALIFIER
#else
/* For all other platforms, ncit_cfg is constant */
#define NFC_HAL_TRANS_CFG_QUALIFIER const
#endif
extern NFC_HAL_TRANS_CFG_QUALIFIER tNFC_HAL_TRANS_CFG nfc_hal_trans_cfg;
/****************************************************************************
** Internal constants and definitions
****************************************************************************/
typedef uint8_t tNFC_HAL_NCI_RAS;
typedef uint8_t tNFC_HAL_POWER_MODE;
#define NFC_HAL_SAVED_HDR_SIZE (2)
#define NFC_HAL_SAVED_CMD_SIZE (2)
#ifndef NFC_HAL_DEBUG
#define NFC_HAL_DEBUG TRUE
#endif
#if (NFC_HAL_DEBUG == TRUE)
extern bool nfc_debug_enabled;
extern const char* const nfc_hal_init_state_str[];
#define NFC_HAL_SET_INIT_STATE(state) \
DLOG_IF(INFO, nfc_debug_enabled) << StringPrintf( \
"init state: %d->%d(%s)", nfc_hal_cb.dev_cb.initializing_state, state, \
nfc_hal_init_state_str[state]); \
nfc_hal_cb.dev_cb.initializing_state = state;
#else
#define NFC_HAL_SET_INIT_STATE(state) \
nfc_hal_cb.dev_cb.initializing_state = state;
#endif
typedef uint8_t tNFC_HAL_INIT_STATE;
typedef uint8_t tNFC_HAL_DM_CONFIG;
/* callback function prototype */
typedef struct {
uint16_t opcode;
uint16_t param_len;
uint8_t* p_param_buf;
} tNFC_HAL_BTVSC_CPLT;
#if (NFC_HAL_HCI_INCLUDED == TRUE)
/* data type for NFC_HAL_HCI_RSP_NV_READ_EVT */
typedef struct {
NFC_HDR hdr;
uint8_t block;
uint16_t size;
tHAL_NFC_STATUS status;
} tNFC_HAL_HCI_RSP_NV_READ_EVT;
/* data type for NFC_HAL_HCI_RSP_NV_WRITE_EVT */
typedef struct {
NFC_HDR hdr;
tHAL_NFC_STATUS status;
} tNFC_HAL_HCI_RSP_NV_WRITE_EVT;
/* union of all event data types */
typedef union {
NFC_HDR hdr;
/* Internal events */
tNFC_HAL_HCI_RSP_NV_READ_EVT nv_read;
tNFC_HAL_HCI_RSP_NV_WRITE_EVT nv_write;
} tNFC_HAL_HCI_EVENT_DATA;
#endif
/*****************************************************************************
** Control block for NFC HAL
*****************************************************************************/
/* Information about current patch in NVM */
typedef struct {
uint16_t project_id; /* Current project_id of patch in nvm */
uint16_t ver_major; /* Current major version of patch in nvm */
uint16_t ver_minor; /* Current minor version of patch in nvm */
uint16_t fpm_size; /* Current size of FPM patch in nvm */
uint16_t lpm_size; /* Current size of LPM patch in nvm */
uint8_t flags; /* See NFC_HAL_NVM_FLAGS_* flag definitions */
uint8_t nvm_type; /* Current NVM Type - UICC/EEPROM */
uint8_t chip_ver[NFC_HAL_PRM_MAX_CHIP_VER_LEN]; /* patch chip version */
} tNFC_HAL_NVM;
/* Patch for I2C fix */
typedef struct {
uint8_t* p_patch; /* patch for i2c fix */
uint32_t prei2c_delay; /* the dealy after preI2C patch */
uint16_t len; /* i2c patch length */
} tNFC_HAL_PRM_I2C_FIX_CB;
/* Control block for NCI transport */
typedef struct {
uint8_t nci_ctrl_size; /* Max size for NCI messages */
uint8_t rcv_state; /* current rx state */
uint16_t rcv_len; /* bytes remaining to be received in current rx state */
NFC_HDR* p_rcv_msg; /* buffer to receive NCI message */
NFC_HDR* p_frag_msg; /* fragmented NCI message; waiting for last fragment */
NFC_HDR*
p_pend_cmd; /* pending NCI message; waiting for NFCC state to be free */
tNFC_HAL_NCI_RAS nci_ras; /* nci reassembly error status */
TIMER_LIST_ENT
nci_wait_rsp_timer; /* Timer for waiting for nci command response */
tNFC_HAL_WAIT_RSP nci_wait_rsp; /* nci wait response flag */
uint8_t
last_hdr[NFC_HAL_SAVED_HDR_SIZE]; /* part of last NCI command header */
uint8_t
last_cmd[NFC_HAL_SAVED_CMD_SIZE]; /* part of last NCI command payload */
void* p_vsc_cback; /* the callback function for last VSC command */
} tNFC_HAL_NCIT_CB;
/* Control block for device initialization */
typedef struct {
tNFC_HAL_INIT_STATE initializing_state; /* state of initializing NFCC */
uint32_t brcm_hw_id; /* BRCM NFCC HW ID */
tNFC_HAL_DM_CONFIG next_dm_config; /* next config in post initialization */
uint8_t next_startup_vsc; /* next start-up VSC offset in post init */
tNFC_HAL_POWER_MODE power_mode; /* NFCC power mode */
uint8_t snooze_mode; /* current snooze mode */
uint8_t new_snooze_mode; /* next snooze mode after receiving cmpl */
uint8_t nfc_wake_active_mode; /* NFC_HAL_LP_ACTIVE_LOW/HIGH */
TIMER_LIST_ENT lp_timer; /* timer for low power mode */
tHAL_NFC_STATUS_CBACK*
p_prop_cback; /* callback to notify complete of proprietary update */
} tNFC_HAL_DEV_CB;
#if (NFC_HAL_HCI_INCLUDED == TRUE)
/* data members for NFC_HAL-HCI */
typedef struct {
TIMER_LIST_ENT
hci_timer; /* Timer to avoid indefinitely waiting for response */
uint8_t*
p_hci_netwk_info_buf; /* Buffer for reading HCI Network information */
uint8_t* p_hci_netwk_dh_info_buf; /* Buffer for reading HCI Network DH
information */
uint8_t hci_netwk_config_block; /* Rsp awaiting for hci network configuration
block */
bool b_wait_hcp_conn_create_rsp; /* Waiting for hcp connection create response
*/
bool clear_all_pipes_to_uicc1; /* UICC1 was restarted for patch download */
bool update_session_id; /* Next response from NFCC is to Get Session id cmd */
bool hci_fw_workaround; /* HAL HCI Workaround need */
bool hci_fw_validate_netwk_cmd; /* Flag to indicate if hci network ntf to
validate */
uint8_t hcp_conn_id; /* NCI Connection id for HCP */
uint8_t dh_session_id[1]; /* Byte 0 of DH Session ID */
} tNFC_HAL_HCI_CB;
#endif
typedef uint8_t tNFC_HAL_FLAGS;
typedef struct {
tHAL_NFC_CBACK* p_stack_cback; /* Callback for HAL event notification */
tHAL_NFC_DATA_CBACK* p_data_cback; /* Callback for data event notification */
TIMER_LIST_Q quick_timer_queue; /* timer list queue */
TIMER_LIST_ENT timer; /* timer for NCI transport task */
tNFC_HAL_NCIT_CB ncit_cb; /* NCI transport */
tNFC_HAL_DEV_CB dev_cb; /* device initialization */
tNFC_HAL_NVM nvm_cb; /* Information about current patch in NVM */
/* Patchram control block */
tNFC_HAL_PRM_CB prm;
tNFC_HAL_PRM_I2C_FIX_CB prm_i2c;
#if (NFC_HAL_HCI_INCLUDED == TRUE)
/* data members for NFC_HAL-HCI */
tNFC_HAL_HCI_CB hci_cb;
#endif
uint8_t pre_discover_done; /* TRUE, when the prediscover config is complete */
tNFC_HAL_FLAGS hal_flags;
uint8_t pre_set_mem_idx;
uint8_t max_rf_credits; /* NFC Max RF data credits */
uint8_t max_ee; /* NFC Max number of NFCEE supported by NFCC */
} tNFC_HAL_CB;
/* Global NCI data */
extern tNFC_HAL_CB nfc_hal_cb;
extern uint8_t* p_nfc_hal_pre_discover_cfg;
/****************************************************************************
** Internal nfc functions
****************************************************************************/
#if (NFC_HAL_HCI_INCLUDED == TRUE)
/* nfc_hal_hci.c */
void nfc_hal_hci_enable(void);
void nfc_hal_hci_evt_hdlr(tNFC_HAL_HCI_EVENT_DATA* p_evt_data);
void nfc_hal_hci_handle_build_info(uint8_t chipverlen, uint8_t* p_chipverstr);
#else
#define nfc_hal_hci_enable() NFC_HAL_SET_INIT_STATE(NFC_HAL_INIT_STATE_IDLE);
#define nfc_hal_hci_handle_build_info(p, a)
#define nfc_hal_hci_evt_hdlr(p) ;
#endif
/* Define default NCI protocol trace function (if protocol tracing is enabled)
*/
#if (NFC_HAL_TRACE_PROTOCOL == TRUE)
#if !defined(DISP_NCI)
#define DISP_NCI (DispNci)
void DispNci(uint8_t* p, uint16_t len, bool is_recv);
#endif /* DISP_NCI */
#endif /* NFC_HAL_TRACE_PROTOCOL */
#endif /* NFC_HAL_INT_H */