ptxNSC.h

Go to the documentation of this file.

 
#ifndef COMPS_NSC_PTXNSC_C_
#define COMPS_NSC_PTXNSC_C_
 
/*
 * ####################################################################################################################
 * INCLUDES
 * ####################################################################################################################
 */
#include "ptxStatus.h"
#include "ptxNSC_Event.h"
#include "ptxNSC_RfConfigVal.h"
#include "ptxNSC_Hal.h"
#include <stddef.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#ifdef RF_CONFIG_SDK_DEFAULT_SETTINGS
    #pragma message("Attention - Default SDK RF-Config settings used - please adapt values for target application platform!")
#endif
 
/*
 * ####################################################################################################################
 * DEFINES / TYPES
 * ####################################################################################################################
 */
 
struct ptxNSC_System;
struct ptxNSC;
 
#define PTX_NSC_TYPE_FRAME_MASK                         (0xC0)                 
#define PTX_NSC_TYPE_FRAME_CMD                          (0x00)                 
#define PTX_NSC_TYPE_FRAME_RSP                          (0x01)                 
#define PTX_NSC_TYPE_FRAME_NTF                          (0x02)                 
#define PTX_NSC_TYPE_FRAME_TRANSP                       (0x03)                 
#define PTX_NSC_MAX_MTU_SIZE                            (253u)                 
#define PTX_NSC_TRANSFER_TO                             (500u)                 
#define PTX_NSC_MAX_RSP_LEN                             (256u)                 
#define PTX_NSC_STANDBY_CMD_OPCODE                      (0x05u)                
#define PTX_NSC_STANDBY_RSP_OPCODE                      (0x45u)                
#define PTX_NSC_STANDBY_RESP_LEN                        (0x02u)                
#define PTX_NSC_STANDBY_PARAMETERS_LEN                  (0x00u)                
#define PTX_NSC_WAKEUP_CMD_OPCODE                       (0x06u)                
#define PTX_NSC_WAKEUP_RSP_OPCODE                       (0x46u)                
#define PTX_NSC_WAKEUP_RESP_LEN                         (0x02u)                
#define PTX_NSC_WAKEUP_PARAMETERS_LEN                   (0x00u)                
#define PTX_NSC_DATA_MSG_MAX_PAYLOAD_LEN                PTX_NSC_MAX_MTU_SIZE   
#define PTX_NSC_DATA_MSG_OPCODE_INDEX                   (0x00u)                
#define PTX_NSC_DATA_MSG_OPCODE                         (0xC2u)                
#define PTX_NSC_DATA_MSG_OPCODE_CHAINING                (0xE2u)                
#define PTX_NSC_DATA_MSG_OPCODE_LENGTH                  (0x01u)                
#define PTX_NSC_DATA_MSG_CON_MSG_LEN_INDEX              (0x01u)                
#define PTX_NSC_DATA_MSG_CON_MSG_LENGTH                 (0x01u)                
#define PTX_NSC_DATA_MSG_CON_MSG_LENGTH_VALUE_ACK       (0x00u)                
#define PTX_NSC_DATA_MSG_CON_MSG_INDEX                  (0x02u)                
#define PTX_NSC_RFD_CTRL_OPCODE                         (0xD2u)                
#define PTX_NSC_RFD_CTRL_ACK                            (0x00u)                
#define PTX_NSC_RFD_CTRL_NACK                           (0x01u)                
#define PTX_NSC_RFD_CTRL_EOF                            (0x02u)                
#define PTX_NSC_RFD_CTRL_ATTENTION                      (0x03u)                
#define PTX_NSC_RFD_CTRL_NR                             (0x04u)                
#define PTX_NSC_FWDOWN_FORCED                           (1u)                   
#define PTX_NSC_FWDOWN_NOT_FORCED                       (0u)                   
#define PTX_NSC_INIT_CMD_OPCODE                         (0x02u)                
#define PTX_NSC_INIT_RSP_OPCODE                         (0x42u)                
#define PTX_NSC_INIT_RESP_LEN                           (0x02u)                
#define PTX_NSC_INIT_CON_HOST_LENGTH                    (4U)                   
#define PTX_NSC_INIT_CON_HOST_CE_LENGTH                 (4U)                   
#define PTX_NSC_INIT_CON_UART_CONFIG                    (2U)                   
#define PTX_NSC_INIT_CON_PRNG_SEED                      (4U)                   
#define PTX_NSC_INIT_CON_N_ALM_MAX                      (4U)                   
#define PTX_NSC_INIT_CON_N_ALM_MIN                      (4U)                   
#define PTX_NSC_RFCONF_CMD_OPCODE                       (0x11u)                
#define PTX_NSC_RFCONF_RSP_OPCODE                       (0x51u)                
#define PTX_NSC_RFCONF_RESP_LEN                         (0x02u)                
#define PTX_NSC_RFCONF_TX_POWER_MODE                    (0x02u)                
#define PTX_NSC_RFCONF_WAVEBANK_0                       (0x00u)                
#define PTX_NSC_RFCONF_WAVEBANK_1                       (0x01u)                
#define PTX_NSC_RFCONF_WAVEBANK_2                       (0x02u)                
#define PTX_NSC_RFCONF_WAVEBANK_3                       (0x03u)                
#define PTX_NSC_RFCONF_WAVEBANK_4                       (0x04u)                
#define PTX_NSC_RFCONF_WAVEBANK_5                       (0x05u)                
#define PTX_NSC_RFCONF_WAVEBANK_6                       (0x06u)                
#define PTX_NSC_RFCONF_WAVEBANK_7                       (0x07u)                
#define PTX_NSC_RFCONF_WAVEBANK_8                       (0x08u)                
#define PTX_NSC_RFCONF_WAVEBANK_9                       (0x09u)                
#define PTX_NSC_RFCONF_WAVEBANK_10                      (0x0Au)                
#define PTX_NSC_RFCONF_WAVEBANK_11                      (0x0Bu)                
#define PTX_NSC_RFCONF_WAVEBANK_12                      (0x0Cu)                
#define PTX_NSC_RFCONF_WAVEBANK_13                      (0x0Du)                
#define PTX_NSC_RFCONF_WAVEBANK_14                      (0x0Eu)                
#define PTX_NSC_RFCONF_WAVEBANK_15                      (0x0Fu)                
#define PTX_NSC_RFCONF_WAVEBANK_16                      (0x10u)                
#define PTX_NSC_RFCONF_WAVEBANK_17                      (0x11u)                
#define PTX_NSC_RFCONF_WAVEBANK_18                      (0x12u)                
#define PTX_NSC_RFCONF_WAVEBANK_19                      (0x13u)                
#define PTX_NSC_RFCONF_MISC                             (0x04u)                
#define PTX_NSC_RFCONF_POLL_A_106                       (0x11u)                
#define PTX_NSC_RFCONF_POLL_A_212                       (0x12u)                
#define PTX_NSC_RFCONF_POLL_A_424                       (0x13u)                
#define PTX_NSC_RFCONF_POLL_A_848                       (0x14u)                
#define PTX_NSC_RFCONF_POLL_B_106                       (0x15u)                
#define PTX_NSC_RFCONF_POLL_B_212                       (0x16u)                
#define PTX_NSC_RFCONF_POLL_B_424                       (0x17u)                
#define PTX_NSC_RFCONF_POLL_B_848                       (0x18u)                
#define PTX_NSC_RFCONF_POLL_F_212                       (0x19u)                
#define PTX_NSC_RFCONF_POLL_F_424                       (0x1Au)                
#define PTX_NSC_RFCONF_POLL_V                           (0x1Eu)                
#define PTX_NSC_RFCONF_LISTEN                           (0x20u)                
#define PTX_NSC_RFCONF_LAST_PARAM                       (0x00u)                
#define PTX_NSC_DISC_CMD_OPCODE                         (0x12u)                
#define PTX_NSC_DISC_RESP_LEN                           (0x02u)                
#define PTX_NSC_DISC_OPCODE                             (0x52u)                
#define PTX_NSC_DISC_CON_POLLB_CMD_LEN                  (3u)                   
#define PTX_NSC_DISC_CON_POLLF_CMD_LEN                  (6u)                   
#define PTX_NSC_DISC_CON_POLLV_CMD_LEN                  (11u)                  
#define PTX_NSC_DISC_CON_POLLB_ATTRIB_INF_LEN           (15u)                  
#define PTX_NSC_DISC_CON_POLL_NFCDEP_ATR_REQ_G_LEN      (20u)                  
#define PTX_NSC_DISC_CON_LIS_SENSRESP_LEN               (2u)                   
#define PTX_NSC_DISC_CON_LISA_NFCID1_LEN                (15u)                  
#define PTX_NSC_DISC_CON_LISB_SENSBRESP_LEN             (13u)                  
#define PTX_NSC_DISC_CON_LISF_SENSFRESP_LEN             (19u)                  
#define PTX_NSC_DISC_CON_LISV_INVRESP_LEN               (10u)                  
#define PTX_NSC_DISC_CON_LIS_ISODEP_ATS_LEN             (21u)                  
#define PTX_NSC_DISC_CON_LIS_ISODEP_ATTRIB_RES_LEN      (16u)                  
#define PTX_NSC_DISC_CON_LIS_NFCDEP_ATR_RES_G_LEN       (20u)                  
#define PTX_NSC_DISC_CON_IDLE_TIME_LEN                  (3u)                   
#define PTX_NSC_TYPES_RFU_1_LEN                         (23U)                  
#define PTX_NSC_SET_PARAMS_DISC_CMD_OPCODE              (0x16u)                
#define PTX_NSC_SET_PARAMS_DISC_RSP_OPCODE              (0x56u)                
#define PTX_NSC_SET_PARAMS_DISC_RSP_LEN                 (0x02u)                
#define PTX_NSC_SET_PARAM_CMD_EOC                       (0x00u)                
#define PTX_NSC_DEACT_CMD_OPCODE                        (0x14u)                
#define PTX_NSC_DEACT_RESP_LEN                          (0x03u)                
#define PTX_NSC_DEACT_RSP_OPCODE                        (0x54u)                
#define PTX_NSC_RF_ACTIVATE_CMD_OPCODE_INDEX            (0x00u)                
#define PTX_NSC_RF_ACTIVATE_CMD_OPCODE                  (0x13u)                
#define PTX_NSC_RF_ACTIVATE_CMD_OPCODE_LENGTH           (0x01u)                
#define PTX_NSC_RF_ACTIVATE_CMD_PARAMS_MAXLENGTH        (0x18u)                
#define PTX_NSC_RF_ACTIVATE_RSP_LENGTH                  (0x02u)                
#define PTX_NSC_RF_ACTIVATE_RSP_OPCODE                  (0x53u)                
#define PTX_NSC_RF_SET_ROUTING_TABLE_CMD_OPCODE         (0x15u)                
#define PTX_NSC_RF_SET_ROUTING_TABLE_CMD_LENGTH         (0x0Cu)                
#define PTX_NSC_RF_SET_ROUTING_TABLE_RSP_LENGTH         (0x02u)                
#define PTX_NSC_RF_SET_ROUTING_TABLE_RSP_OPCODE         (0x55u)                
#define PTX_NSC_RESET_RSP_LENGTH                        (0x02u)                
#define PTX_NSC_RESET_RSP_OPCODE                        (0x41u)                
#define PTX_NSC_OPCODE_RFFIELDNTF                       (0x91u)                
#define PTX_NSC_OPCODE_RFDISCNTF                        (0x92u)                
#define PTX_NSC_OPCODE_RFACTNTF                         (0x93u)                
#define PTX_NSC_OPCODE_RFDEACTNTF                       (0x94u)                
#define PTX_NSC_OPCODE_RFERRORNTF                       (0x95u)                
#define PTX_NSC_OPCODE_LPCDNTF                          (0x97u)                
#define PTX_NSC_RFERRORNTF_LENGTH                       (0x02u)                
#define PTX_NSC_FRAMETYPE                               (0xC0u)                
#define PTX_NSC_FRAMETYPE_CMD                           (0x00u)                
#define PTX_NSC_FRAMETYPE_RSP                           (0x40u)                
#define PTX_NSC_FRAMETYPE_NTF                           (0x80u)                
#define PTX_NSC_FRAMETYPE_TRANSPARENT                   (0xC0u)                
#define PTX_NSC_FRAMETYPE_TRANSP_HCP                    (0xC1u)                
#define PTX_NSC_TYPES_LISBSENSRES_LEN                   (13U)                  
#define PTX_NSC_MAXIMUM_NFCID1_LEN                      (10u)                  
#define PTX_NSC_NFCID0_LEN                              (4u)                   
#define PTX_NSC_NFCID2_LEN                              (8u)                   
#define PTX_NSC_TYPEV_UID_LEN                           (8u)                   
#define PTX_NSC_TYPES_TECH_A                            (0x00u)                
#define PTX_NSC_TYPES_TECH_B                            (0x01u)                
#define PTX_NSC_TYPES_TECH_F                            (0x02u)                
#define PTX_NSC_TYPES_TECH_V                            (0x06u)                
#define PTX_NSC_TYPES_TECH_POLL_A                       (0x00u)                
#define PTX_NSC_TYPES_TECH_POLL_B                       (0x01u)                
#define PTX_NSC_TYPES_TECH_POLL_F                       (0x02u)                
#define PTX_NSC_TYPES_TECH_POLL_ACT                     (0x03u)                
#define PTX_NSC_TYPES_TECH_POLL_V                       (0x06u)                
#define PTX_NSC_TYPES_TECH_LISTEN_A                     (0x80u)                
#define PTX_NSC_RF_ERROR_NTF_CODE_OK                    (0x00u)                
#define PTX_NSC_RF_ERROR_NTF_CODE_ERR_THERMAL           (0x06u)                
#define PTX_NSC_RF_ERROR_NTF_CODE_ERR_OVERCURRENT       (0x07u)                
#define PTX_NSC_RF_ERROR_NTF_CODE_ERR_CURRENT_LIMIT     (0x09u)                
#define PTX_NSC_RF_ERROR_NTF_CODE_ERR_EXT_CURRENT_SENSOR (0x0Au)               
#define PTX_NSC_RF_ERROR_NTF_CODE_ERR_EMV_COLL          (0x11u)                
#define PTX_NSC_RF_ERROR_NTF_CODE_ERR_TIMEOUT           (0x12u)                
#define PTX_NSC_RF_ERROR_NTF_CODE_ERR_TRANSMISSION      (0x13u)                
#define PTX_NSC_RF_ERROR_NTF_CODE_ERR_PROTOCOL          (0x14u)                
#define PTX_NSC_RF_SET_PARAMS_MAX                       (11u)                   
#define PTX_NSC_TYPES_RD_OP_MAX                         (3u)                   
#define PTX_NSC_READ_CMD_HD_LENGTH                      (0x03u)                
#define PTX_NSC_READ_CMD_OPCODE                         (0x03u)                
#define PTX_NSC_READ_RSP_HD_LENGTH                      (0x03u)                
#define PTX_NSC_READ_RSP_OPCODE                         (0x43u)                
#define PTX_NSC_TYPES_WR_OP_MAX                          (70u)                 
#define PTX_NSC_WRITE_CMD_HD_LENGTH                      (0x03u)               
#define PTX_NSC_WRITE_CMD_OPCODE                         (0x04u)               
#define PTX_NSC_WRITE_RSP_LENGTH                         (0x02u)               
#define PTX_NSC_WRITE_RSP_OPCODE                         (0x44u)               
#define PTX_NSC_MISC_RF_CONFIG_BUFFER_SIZE              (uint8_t)37            
#define PTX_NSC_MISC_RF_CONFIG_FLAGS_SET                (uint8_t)0x01          
#define PTX_NSC_MISC_RF_CONFIG_FLAGS_LOADED             (uint8_t)0x02          
#define PTX_NSC_RF_RUN_TEST_CMD_OPCODE                  (0x17u)                 
#define PTX_NSC_RF_RUN_TEST_CMD_RSP_OPCODE              (0x57u)                 
#define PTX_NSC_RF_RUN_TEST_CMD_RSP_LENGTH              (0x02u)                 
#define PTX_NSC_RF_STOP_TEST_CMD_OPCODE                 (0x18u)                 
#define PTX_NSC_RF_STOP_TEST_CMD_RSP_OPCODE             (0x58u)                 
#define PTX_NSC_RF_STOP_TEST_CMD_RSP_LENGTH             (0x02u)                 
#define PTX_NSC_INIT_EXT_PROTECTION_EN_MASK             (0x03u)                 
#define PTX_NSC_MAX_EXTENSIONS                          (uint8_t)(1u)            
/*
 * ####################################################################################################################
 * INTERNALS / SYSTEM PARAMETERS EXPOSED ON API OF NSC COMPONENT
 * ####################################################################################################################
 */
 
typedef void (*pptxNSC_WfeCallBack_t) (void *ctx, ptxNSC_Event_t *event);
 
 typedef void (*pptxNSC_Process_Ext_NTF_t) (void *ctx, uint8_t *pld, size_t pldLen);
 
 
 typedef void (*pptxNSC_ExtCallBack_t) (void *ctx, void *events, uint8_t *pld, size_t pldLen);
 
/*
 * ####################################################################################################################
 * INTERNAL TYPES
 * ####################################################################################################################
 */
 
typedef enum ptxNSC_Rsp_ErrorCodes
{
    ptxNscRsp_Sucessful             = (0x00u),                  
    ptxNscRsp_UnknownError          = (0x01u),                  
    ptxNscRsp_NotAllowedCmd         = (0x02u),                  
    ptxNscRsp_UnknownErrorCmd       = (0x03u),                  
    ptxNscRsp_InvalidParameter      = (0x04u),                  
    ptxNscRsp_RouteNotFound         = (0x05u),                  
    ptxNscRsp_PAThermalProtError    = (0x06u),                  
    ptxNscRsp_PAOvercurProtError    = (0x07u),                  
    ptxNscRsp_DeviceInStandby       = (0x08u),                  
    ptxNscRsp_RfCollisionError      = (0x11u),                  
    ptxNscRsp_RfTimeoutError        = (0x12u),                  
    ptxNscRsp_RfTransmissionError   = (0x13u),                  
    ptxNscRsp_RfProtocolError       = (0x14u),                  
    ptxNscRsp_RfPollModNotSupported = (0x15u),                  
    ptxNscRsp_RfListModNotSupported = (0x16u),                  
    ptxNscRsp_SwpUiccNotPresent     = (0x21u),                  
    ptxNscRsp_SwpInterfaceError     = (0x22u),                  
    ptxNscRsp_SwpIdentityCheckFail  = (0x23u),                  
    ptxNscRsp_SwpModeNotSupported   = (0x24u),                  
} ptxNSC_Rsp_ErrorCodes_t;
 
typedef enum ptxNSC_RfConfig_ParamList
{
    RfCfgParam_Undefined,
 
    RfCfgParam_Wavebank_0,
    RfCfgParam_Wavebank_1,
    RfCfgParam_Wavebank_2,
    RfCfgParam_Wavebank_3,
    RfCfgParam_Wavebank_4,
    RfCfgParam_Wavebank_5,
    RfCfgParam_Wavebank_6,
    RfCfgParam_Wavebank_7,
    RfCfgParam_Wavebank_8,
    RfCfgParam_Wavebank_9,
    RfCfgParam_Wavebank_10,
    RfCfgParam_Wavebank_11,
    RfCfgParam_Wavebank_12,
    RfCfgParam_Wavebank_13,
    RfCfgParam_Wavebank_14,
    RfCfgParam_Wavebank_15,
    RfCfgParam_Wavebank_16,
    RfCfgParam_Wavebank_17,
    RfCfgParam_Wavebank_18,
    RfCfgParam_Wavebank_19,
    RfCfgParam_RegsPollA106,
    RfCfgParam_RegsPollA212,
    RfCfgParam_RegsPollA424,
    RfCfgParam_RegsPollA848,
    RfCfgParam_RegsPollB106,
    RfCfgParam_RegsPollB212,
    RfCfgParam_RegsPollB424,
    RfCfgParam_RegsPollB848,
    RfCfgParam_RegsPollF212,
    RfCfgParam_RegsPollF424,
    RfCfgParam_RegsPollV,
    RfCfgParam_Listen,
    RfCfgParam_RegsMisc,
 
    RfCfgParam_MaxNum
} ptxNSC_RfConfig_ParamList_t;
 
typedef struct ptxNSC_RfConfigTlv
{
    ptxNSC_RfConfig_ParamList_t     ID;                         
    uint8_t                         *Value;                     
    uint8_t                         Len;                        
} ptxNSC_RfConfigTlv_t;
 
typedef struct ptxNSC_InitPars
{
        uint8_t Con_Clk_Src;                                    
        uint8_t Con_Var_Lbs;                                    
        uint8_t Con_NHost[PTX_NSC_INIT_CON_HOST_LENGTH];        
        uint8_t Con_NHost_Ce[PTX_NSC_INIT_CON_HOST_CE_LENGTH];  
        uint8_t Con_Uart_Config[PTX_NSC_INIT_CON_UART_CONFIG];  
        uint8_t Con_Prng_Seed[PTX_NSC_INIT_CON_PRNG_SEED];      
        uint8_t Con_N_Alm_Max[PTX_NSC_INIT_CON_N_ALM_MAX];      
        uint8_t Con_N_Alm_Min[PTX_NSC_INIT_CON_N_ALM_MIN];      
        uint8_t Con_Paocp_Th;                                   
        uint8_t Con_Patp_Th;                                    
        uint8_t Con_Xcp_Ctrl;                                   
        uint8_t Con_Xcp_Th_Gt;                                  
} ptxNSC_InitPars_t;
 
typedef struct ptxNSC_RfDiscPars
{
        uint8_t Con_Poll;                                       
        uint8_t Con_Poll_Gt;                                    
        uint8_t Con_Poll_Disc_Mode;                             
        uint8_t Con_Poll_A;                                     
        uint8_t Con_Poll_A_Cmd;                                 
        uint8_t Con_Poll_A_Freq;                                
        uint8_t Con_Poll_A_Dev_Limit;                           
        uint8_t Con_Poll_B;                                     
        uint8_t Con_Poll_B_Cmd[PTX_NSC_DISC_CON_POLLB_CMD_LEN]; 
        uint8_t Con_Poll_B_Freq;                                
        uint8_t Con_Poll_B_Dev_Limit;                           
        uint8_t Con_Poll_F;                                     
        uint8_t Con_Poll_F_Cmd[PTX_NSC_DISC_CON_POLLF_CMD_LEN]; 
        uint8_t Con_Poll_F_Freq;                                
        uint8_t Con_Poll_F_Dev_Limit;                           
        uint8_t Con_Poll_V;                                     
        uint8_t Con_Poll_V_Cmd[PTX_NSC_DISC_CON_POLLV_CMD_LEN]; 
        uint8_t Con_Poll_V_Freq;                                
        uint8_t Con_Poll_V_Dev_Limit;                           
        uint8_t Con_Poll_Iso_Dep;                               
        uint8_t Con_Poll_Iso_Dep_Rats_Param;                    
        uint8_t Con_Poll_Iso_Dep_Attrib_Param1;                 
        uint8_t Con_Poll_Iso_Dep_Attrib_Param2_Fsdi;            
        uint8_t Con_Poll_Iso_Dep_Attrib_Param3;                 
        uint8_t Con_Poll_Iso_Dep_Attrib_Param4;                 
        uint8_t Con_Poll_Iso_Dep_Attrib_Inf_Len;                
        uint8_t Con_Poll_B_Attrib_Inf[PTX_NSC_DISC_CON_POLLB_ATTRIB_INF_LEN];           
        uint8_t Con_Poll_Nfc_Dep;                               
        uint8_t Con_Poll_Nfc_Dep_Atr_Req_Pp;                    
        uint8_t Con_Poll_Nfc_Dep_Atr_Req_G_Len;                 
        uint8_t Con_Poll_Nfc_Dep_Atr_Req_G[PTX_NSC_DISC_CON_POLL_NFCDEP_ATR_REQ_G_LEN];    
        uint8_t Con_Listen;                                     
        uint8_t Con_Listen_A;                                   
        uint8_t Con_Listen_A_Sens_Res[PTX_NSC_DISC_CON_LIS_SENSRESP_LEN];   
        uint8_t Con_Listen_A_Sel_Res;                           
        uint8_t Con_Listen_A_Nfcid1[PTX_NSC_DISC_CON_LISA_NFCID1_LEN];         
        uint8_t Con_Listen_B;                                   
        uint8_t Con_Listen_B_Afi;                               
        uint8_t Con_Listen_B_Sensb_Res[PTX_NSC_DISC_CON_LISB_SENSBRESP_LEN];    
        uint8_t Con_Listen_F;                                   
        uint8_t Con_Listen_F_Sensf_Res[PTX_NSC_DISC_CON_LISF_SENSFRESP_LEN];   
        uint8_t Con_Listen_V;                                   
        uint8_t Con_Listen_V_Inv_Res[PTX_NSC_DISC_CON_LISV_INVRESP_LEN];   
        uint8_t Con_Listen_Iso_Dep;                             
        uint8_t Con_Listen_Iso_Dep_Ats[PTX_NSC_DISC_CON_LIS_ISODEP_ATS_LEN];   
        uint8_t Con_Listen_Iso_Dep_Attrib_Res_Len;              
        uint8_t Con_Listen_Iso_Dep_Attrib_Res[PTX_NSC_DISC_CON_LIS_ISODEP_ATTRIB_RES_LEN];   
        uint8_t Con_Listen_Nfc_Dep;                             
        uint8_t Con_Listen_Nfc_Dep_Atr_Res_To;                  
        uint8_t Con_Listen_Nfc_Dep_Atr_Res_Pp;                  
        uint8_t Con_Listen_Nfc_Dep_Atr_Res_G_Len;               
        uint8_t Con_Listen_Nfc_Dep_Atr_Res_G[PTX_NSC_DISC_CON_LIS_NFCDEP_ATR_RES_G_LEN];    
        uint8_t Con_Idle;                                       
        uint8_t Con_Idle_Time[PTX_NSC_DISC_CON_IDLE_TIME_LEN];  
} ptxNSC_RfDiscPars_t;
 
typedef enum ptxNSC_PollType
{
    PollModeDisabled,                                           
    ConstantField,                                              
    NfcForumMode,                                               
    EmvPollMode,                                                
    EmvPollMode_TransacA,                                       
    EmvPollMode_TransacB,                                       
    IsoPollMode,                                                
} ptxNSC_PollType_t;
 
typedef enum ptxNSC_InitTechPoll
{
    Init_Poll_ACM,                                              
    Init_Poll_A,                                                
    Init_Poll_B,                                                
    Init_Poll_F,                                                
    Init_Poll_V                                                 
} ptxNSC_InitTechPoll_t;
 
typedef enum ptxNSC_RfDiscovery_Mode
{
    DiscoveryMode_Regular           = 0x00u,                    
    DiscoveryMode_Lpcd              = 0x01u,                    
    DiscoveryMode_Hybrid_Start      = 0x02u,                    
    DiscoveryMode_Hybrid_End        = 0xFFu
} ptxNSC_RfDiscovery_Mode_t;
 
typedef enum ptxNSC_RfParameter_Id
{
    RfParameter_EoC,                                            
    RfParameter_Rf_Tech,                                        
    RfParameter_Fwt,                                            
    RfParameter_Tx_Bit_Rate,                                    
    RfParameter_Rx_Bit_Rate,                                    
    RfParameter_Tx_PAR,                                         
    RfParameter_Rx_PAR,                                         
    RfParameter_Tx_CRC,                                         
    RfParameter_Rx_CRC,                                         
    RfParameter_Res_Limit,                                      
    RfParameter_Tx_Residual_Bits,                               
    RfParameter_Rf_Field,                                       
} ptxNSC_RfParameter_Id_t;
 
typedef struct ptxNSC_RfPar_RfTech
{
    uint8_t     RfTech;                                         
} ptxNSC_RfPar_RfTech_t;
 
 
typedef struct ptxNSC_RfPar_Fwt
{
    uint8_t     Fwt[3u];                                        
} ptxNSC_RfPar_Fwt_t;
 
 
typedef struct ptxNSC_RfPar_TxBitRate
{
    uint8_t     TxBitRate;                                      
} ptxNSC_RfPar_TxBitRate_t;
 
 
typedef struct ptxNSC_RfPar_RxBitRate
{
    uint8_t     RxBitRate;                                      
} ptxNSC_RfPar_RxBitRate_t;
 
typedef struct ptxNSC_RfPar_TxParity
{
    uint8_t     TxParity;                                       
} ptxNSC_RfPar_TxParity_t;
 
typedef struct ptxNSC_RfPar_RxParity
{
    uint8_t     RxParity;                                       
} ptxNSC_RfPar_RxParity_t;
 
 
typedef struct ptxNSC_RfPar_TxCRC
{
    uint8_t     TxCRC;                                          
} ptxNSC_RfPar_TxCRC_t;
 
 
typedef struct ptxNSC_RfPar_RxCRC
{
    uint8_t     RxCRC;                                          
} ptxNSC_RfPar_RxCRC_t;
 
typedef struct ptxNsc_RfPar_ResLimit
{
    uint8_t     ResLimit;                                       
} ptxNsc_RfPar_ResLimit_t;
 
typedef struct ptxNsc_RfPar_TxResidualBits
{
    uint8_t     TxResidualBits;                                 
} ptxNsc_RfPar_TxResidualBits_t;
 
typedef struct ptxNsc_RfPar_RfField
{
    uint8_t     RfField;                                        
} ptxNsc_RfPar_RfField_t;
 
typedef union ptxNSC_RfPar_Params
{
    ptxNSC_RfPar_RfTech_t               RfTech;                 
    ptxNSC_RfPar_Fwt_t                  Fwt;                    
    ptxNSC_RfPar_TxBitRate_t            TxBitRate;              
    ptxNSC_RfPar_RxBitRate_t            RxBitRate;              
    ptxNSC_RfPar_TxParity_t             TxParity;               
    ptxNSC_RfPar_RxParity_t             RxParity;               
    ptxNSC_RfPar_TxCRC_t                TxCRC;                  
    ptxNSC_RfPar_RxCRC_t                RxCRC;                  
    ptxNsc_RfPar_ResLimit_t             ResLimit;               
    ptxNsc_RfPar_TxResidualBits_t       TxResidualBits;         
    ptxNsc_RfPar_RfField_t              RfField;                
} ptxNSC_RfPar_Params_t;
 
typedef struct ptxNSC_RfPar
{
    ptxNSC_RfParameter_Id_t             ParmId;                 
    ptxNSC_RfPar_Params_t               Parm;                   
} ptxNSC_RfPar_t;
 
typedef struct ptxNSC_RfSetParams_Par
{
    ptxNSC_RfPar_t              RfParams[PTX_NSC_RF_SET_PARAMS_MAX];                
    size_t                      NumOfParams;                                        
} ptxNSC_RfSetParams_Par_t;
 
 
typedef struct ptxNSC_RfActTech_A_Param
{
    uint8_t                     NfcId1[PTX_NSC_MAXIMUM_NFCID1_LEN];                 
    size_t                      NfcId1_len;                                         
    uint8_t                     DeviceRfState;                                      
} ptxNSC_RfActTech_A_Param_t;
 
typedef struct ptxNSC_RfActTech_B_Param
{
    uint8_t                     SensBRes[PTX_NSC_TYPES_LISBSENSRES_LEN];            
    uint8_t                     DeviceRfState;                                      
} ptxNSC_RfActTech_B_Param_t;
 
typedef struct ptxNSC_RfActTech_F_Param
{
    uint8_t                     NfcId2[PTX_NSC_NFCID2_LEN];                         
    uint8_t                     DeviceRfState;                                      
} ptxNSC_RfActTech_F_Param_t;
 
typedef struct ptxNSC_RfActTech_V_Param
{
    uint8_t                     Uid[PTX_NSC_TYPEV_UID_LEN];                         
    uint8_t                     DeviceRfState;                                      
} ptxNSC_RfActTech_V_Param_t;
 
typedef union ptxNSC_RfActTech_Param
{
    ptxNSC_RfActTech_A_Param_t      RfAct_A_Params;                                 
    ptxNSC_RfActTech_B_Param_t      RfAct_B_Params;                                 
    ptxNSC_RfActTech_F_Param_t      RfAct_F_Params;                                 
    ptxNSC_RfActTech_V_Param_t      RfAct_V_Params;                                 
} ptxNSC_RfActTech_Param_t;
 
typedef union ptxNSC_RfActProt_ISODEP_Param
{
    uint8_t         IsPpsRequired;                                      
    uint8_t         Did;                                                
    uint8_t         Fsdi;                                               
    uint8_t         Pps1;                                               
} ptxNSC_RfActProt_ISODEP_Param_t;
 
typedef union ptxNSC_RfActProt_Param_t
{
    ptxNSC_RfActProt_ISODEP_Param_t IsoDepParams;                       
} ptxNSC_RfActProt_Param_t;
 
typedef struct ptxNSC_RfActiv_Param
{
    uint8_t                     RfTech;                                 
    ptxNSC_RfActTech_Param_t    RfTechActParams;                        
    uint8_t                     RfProt;                                 
    uint8_t                     UseShortActivation;                     
} ptxNSC_RfActiv_Param_t;
 
 
typedef enum ptxNSC_RfDeact_Type
{
    DeactType_Generic               = 0x01u,                            
    DeactType_Protocol_Specific     = 0x02u,                            
} ptxNSC_RfDeact_Type_t;
 
typedef enum ptxNSC_RfDeact_State
{
    RfIdle                = 0x01u,                                      
    RfDiscovery           = 0x02u,                                      
    RfPollSleep           = 0x03u,                                      
    RfDiscoverNoFieldOff  = 0x05u,                                      
} ptxNSC_RfDeact_State_t;
 
typedef struct ptxNSC_RfDeactPars
{
    ptxNSC_RfDeact_State_t      Rf_State;                               
    ptxNSC_RfDeact_Type_t       Rf_Deactivate_Type;                     
} ptxNSC_RfDeactPars_t;
 
typedef enum ptxNSC_ReadCmd_Type
{
    ReadRandomAdd = 1u,                
} ptxNSC_ReadCmd_Type_t;
 
typedef struct ptxNSC_ReadCmd_Par
{
    ptxNSC_ReadCmd_Type_t       Type;                                           
    size_t                      NumOfRead;                                      
    uint16_t                    Addresses[PTX_NSC_TYPES_RD_OP_MAX];           
} ptxNSC_ReadCmd_Par_t;
 
 
typedef enum ptxNSC_WriteCmd_Type
{
    WriteRandomAdd = 1u,                
} ptxNSC_WriteCmd_Type_t;
 
typedef struct ptxNSC_WriteCmd_Par
{
    ptxNSC_WriteCmd_Type_t      Type;                                           
    size_t                      NumOfWrite;                                     
    uint16_t                    Addresses[PTX_NSC_TYPES_WR_OP_MAX];             
    uint8_t                     Values[PTX_NSC_TYPES_WR_OP_MAX];                
} ptxNSC_WriteCmd_Par_t;
 
typedef enum ptxNSC_RevisionType
{
    ptxNSC_Info_C_Stack,
    ptxNSC_Info_Local_Changes,
    ptxNSC_Info_DFY_Code,
    ptxNSC_Info_DFY_Toolchain,
    ptxNSC_Info_ChipID,
    ptxNSC_Info_ProductID,
} ptxNSC_RevisionType_t;
 
typedef enum ptxNSC_Power_Mode
{
    PowerMode_Active           = 0x00u,                     
    PowerMode_StandBy          = 0x01u,                     
} ptxNSC_Power_Mode_t;
 
typedef enum ptxNSC_System_State
{
    SystemState_OK,
    SystemState_ERR_Overcurrent,
    SystemState_ERR_Temperature,
    SystemState_ERR_CurrentLimit
} ptxNSC_System_State_t;
 
typedef enum ptxNSC_Mode
{
    NscMode_HW,                                             
    NscMode_SYS                                             
} ptxNSC_Mode_t;
 
typedef enum ptxNSC_RfTest_ID
{
    RfTest_TRANSAC_A = 1,                                       
    RfTest_TRANSAC_B = 2,                                       
    RfTest_Carrier   = 3,                                       
    RfTest_PRBS_9    = 4,                                       
    RfTest_PRBS_15   = 5,                                       
} ptxNSC_RfTest_ID_t;
 
typedef struct ptxNSC_Rsp
{
    uint8_t         NewRspReceived;                         
    uint8_t         RspBuff[PTX_NSC_MAX_RSP_LEN];           
    size_t          RspLen;                                 
} ptxNSC_Rsp_t;
 
typedef struct ptxNSC_RfConfig_Regs
{
    uint8_t    *RegsPolla106;           
    size_t      RegsPolla106_Len;       
    uint8_t    *RegsPolla212;           
    size_t      RegsPolla212_Len;       
    uint8_t    *RegsPolla424;           
    size_t      RegsPolla424_Len;       
    uint8_t    *RegsPolla848;           
    size_t      RegsPolla848_Len;       
    uint8_t    *RegsPollb106;           
    size_t      RegsPollb106_Len;       
    uint8_t    *RegsPollb212;           
    size_t      RegsPollb212_Len;       
    uint8_t    *RegsPollb424;           
    size_t      RegsPollb424_Len;       
    uint8_t    *RegsPollb848;           
    size_t      RegsPollb848_Len;       
    uint8_t    *RegsPollf212;           
    size_t      RegsPollf212_Len;       
    uint8_t    *RegsPollf424;           
    size_t      RegsPollf424_Len;       
    uint8_t    *RegsPollV;              
    size_t      RegsPollV_Len;          
    uint8_t    *RegsListen;             
    size_t      RegsListen_Len;         
} ptxNSC_RfConfig_Regs_t;
 
typedef struct ptxNSC_RfConfig_Param
{
    uint8_t                 VersionNvm;                         
    uint8_t                 *conTxPollModeHighPowerMod100;      
    size_t                  conTxPollModeHighPowerMod100Len;    
    uint8_t                 *conTxPollModeLowPowerMod100;       
    size_t                  conTxPollModeLowPowerMod100Len;     
    uint8_t                 *conTxPollModeHighPowerMod10;       
    size_t                  conTxPollModeHighPowerMod10Len;     
    uint8_t                 *conTxPollModeLowPowerMod10;        
    size_t                  conTxPollModeLowPowerMod10Len;      
    uint8_t                 *conTxListenModeHighPower;          
    size_t                  conTxListenModeHighPowerLen;        
    uint8_t                 *conTxListenModeLowPower;           
    size_t                  conTxListenModeLowPowerLen;         
    uint8_t                 *MiscSettings;                      
    size_t                  MiscSettings_Len;                   
    ptxNSC_RfConfig_Regs_t  Regs;                               
} ptxNSC_RfConfig_Param_t;
 
typedef struct ptxNSC_RFMiscConfig_Param
{
    uint8_t                 MiscSettings[PTX_NSC_MISC_RF_CONFIG_BUFFER_SIZE];   
    uint8_t                 MiscSettings_Len;                                   
    uint8_t                 MiscSettingsFlags;                                  
} ptxNSC_RFMiscConfig_Param_t;
 
typedef struct ptxNSC_ConfigPars
{
    void                        *Plat;                      
    pptxNSC_WfeCallBack_t        WfeCb;                     
    void                        *Ctx;                       
} ptxNSC_ConfigPars_t;
 
typedef ptxStatus_t (*pExtNSCDiscoverCmd_t)(void *extCtx, uint8_t *cmdBuffer);
 
typedef ptxStatus_t (*pExtNSCDiscoverNtf_t)(void *extCtx, struct ptxNSC *nscCtx, uint8_t *payload, size_t lengthOfPayload, ptxNSC_Event_t *event);
 
typedef ptxStatus_t (*pExtNSCActivateNtf_t)(void *extCtx, struct ptxNSC *nscCtx, uint8_t *payload, size_t lengthOfPayload, ptxNSC_Event_t *event);
 
typedef struct ptxNSC_Custom_Extension
{
    uint8_t                     ExtensionID;            
    pExtNSCDiscoverCmd_t        CBFnExtDiscoverCmd;     
    pExtNSCDiscoverNtf_t        CBFnExtDiscoverNtf;     
    pExtNSCActivateNtf_t        CBFnExtActivateNtf;     
    void                        *ExtensionCtx;          
} ptxNSC_Custom_Extension_t;
 
typedef struct ptxNSC
{
    ptxStatus_Comps_t           CompId;                                 
    void                        *Plat;                                  
    pptxNSC_WfeCallBack_t       WfeCb;                                  
    void                        *Ctx;                                   
    uint32_t                    MaxTransferUnit;                        
    uint8_t                     RxCltMode;                              
    ptxNSC_Rsp_t                NscRsp;                                 
    struct ptxNSC_System        *SysParams;                             
    ptxNSC_System_State_t       SysState;                               
    uint8_t                     DeactivationNTFPending;                 
    uint32_t                    DeactiveTimeoutMS;                      
    ptxNSC_Mode_t               NscMode;                                
    pptxNSC_ExtCallBack_t       ExtensionCb;                            
    void                        *ExtensionCtx;                          
    pptxNSC_Process_Ext_NTF_t   ExtensionNtfProcess;                    
    ptxNSC_RFMiscConfig_Param_t RFConfigMiscParams;                     
    uint8_t                     ProductID;                              
    uint8_t                     TypeATransparentModeActive;             
    uint8_t                     TransparentModeNrResidualTxBits;        
    uint8_t                     NrCustomExtensions;                     
    ptxNSC_Custom_Extension_t   CustomExtension[PTX_NSC_MAX_EXTENSIONS];
} ptxNSC_t;
 
 
/*
 * ####################################################################################################################
 * API FUNCTIONS
 * ####################################################################################################################
 */
 
 
ptxStatus_t ptxNSC_Init(ptxNSC_t **nscCtx, ptxNSC_ConfigPars_t *configPars);
 
 
ptxStatus_t ptxNSC_Deinit(ptxNSC_t *nscCtx);
 
ptxStatus_t ptxNSC_SoftReset(ptxNSC_t *nscCtx);
 
 
ptxStatus_t ptxNSC_HardReset(ptxNSC_t *nscCtx);
 
 
ptxStatus_t ptxNSC_Reset(ptxNSC_t *nscCtx);
 
 
ptxStatus_t ptxNSC_FwDownloader(ptxNSC_t *nscCtx);
 
 
ptxStatus_t ptxNSC_DFY_Activation(ptxNSC_t *nscCtx);
 
 
ptxStatus_t ptxNSC_InitCmd(ptxNSC_t *nscCtx, ptxNSC_InitPars_t *nscInitPars);
 
 
ptxStatus_t ptxNSC_StandbyCmd(ptxNSC_t *nscCtx);
 
 
ptxStatus_t ptxNSC_WakeupCmd(ptxNSC_t *nscCtx);
 
 
ptxStatus_t ptxNSC_RfConfig(ptxNSC_t *nscCtx, ptxNSC_RfConfigTlv_t *nscRfCfgParams, uint8_t rfConfigTlvCount);
 
 
ptxStatus_t ptxNSC_RfDiscovery(ptxNSC_t *nscCtx, ptxNSC_RfDiscPars_t *nscRfDiscPars);
 
 
ptxStatus_t ptxNSC_RfSetParams(ptxNSC_t *nscCtx, ptxNSC_RfPar_t *nscRfParams, size_t nscRfParamsLen);
 
 
ptxStatus_t ptxNSC_RfActivate(ptxNSC_t *nscCtx, ptxNSC_RfActiv_Param_t *nscRfActPars, uint8_t *activationData, size_t *activationDataLen);
 
 
ptxStatus_t ptxNSC_RfDeactivate(ptxNSC_t *nscCtx, ptxNSC_RfDeactPars_t *nscRfDeactPars);
 
 
ptxStatus_t ptxNSC_RfDataMsgTx(ptxNSC_t *nscCtx, uint8_t *msgData, size_t msgDataLen, uint8_t isChained);
 
 
ptxStatus_t ptxNSC_Get_Mtu(ptxNSC_t *nscCtx, uint32_t *maxTransferUnit);
 
 
ptxStatus_t ptxNSC_GetRevisionInfo(ptxNSC_t *nscCtx, ptxNSC_RevisionType_t revisionType, uint32_t *revisionInfo);
 
 
ptxStatus_t ptxNSC_CheckSystemState(ptxNSC_t *nscCtx, ptxStatus_t currentStatus);
 
 
ptxStatus_t ptxNSC_ReadTempSensor(ptxNSC_t *nscCtx, uint8_t *sensVal);
 
 
ptxStatus_t ptxNSC_GetInitConfigParams(ptxNSC_t *nscCtx, uint32_t baudRate, uint8_t *uartConfig);
 
ptxStatus_t ptxNSC_GetMiscRFConfig(ptxNSC_t *nscCtx, uint8_t *configBuffer, uint8_t *configBufferLen);
 
ptxStatus_t ptxNSC_Read(ptxNSC_t *nscCtx, uint16_t address, uint8_t *value);
 
ptxStatus_t ptxNSC_Write(ptxNSC_t *nscCtx, uint16_t address, uint8_t value);
 
ptxStatus_t ptxNSC_WriteN(ptxNSC_t *nscCtx, uint16_t * addresses, uint8_t *values, size_t nrWrites);
 
ptxStatus_t ptxNSC_RfTestRun(ptxNSC_t *nscCtx, ptxNSC_RfTest_ID_t rfTestId, uint8_t *rfTestParams, size_t rfTestParamsLen);
 
ptxStatus_t ptxNSC_RfTestStop(ptxNSC_t *nscCtx);
 
ptxStatus_t ptxNSC_GetDeactivateTimeout(ptxNSC_t *nscCtx, uint32_t *currentTimeout);
 
ptxStatus_t ptxNSC_SetDeactivateTimeout(ptxNSC_t *nscCtx, uint32_t *currentTimeout);
 
ptxStatus_t ptxNSC_SetNrResidualTxBits(ptxNSC_t *nscCtx, uint8_t transparentModeEnabled, uint8_t nrTxBits);
 
ptxStatus_t ptxNSC_RegisterExtension(ptxNSC_t *nscCtx, ptxNSC_Custom_Extension_t *extension);
 
ptxStatus_t ptxNSC_DeRegisterExtension(ptxNSC_t *nscCtx, uint8_t extensionID);
 
/*
 * ####################################################################################################################
 * COMMON FUNCTIONS
 * ####################################################################################################################
 */
ptxStatus_t ptxNSC_ProcessRspErrorCode (ptxNSC_Rsp_ErrorCodes_t NscRspErrorCode);
 
 
ptxStatus_t ptxNSC_Send(ptxNSC_t *nscCtx, ptxNscHal_BufferId_t bufferId, uint8_t *txBuf[], size_t txLen[], size_t numBuffers);
 
 
ptxStatus_t ptxNSC_ReceiveRsp(ptxNSC_t *nscCtx, uint8_t **rsp, size_t *rspLen, uint32_t timeOut);
 
 
ptxStatus_t ptxNSC_Process (ptxNSC_t *nscCtx, uint8_t *buff, size_t buffLen);
 
 
ptxStatus_t ptxNSC_SetMode (ptxNSC_t *nscCtx, ptxNSC_Mode_t newMode);
 
ptxStatus_t ptxNSC_GetMode (ptxNSC_t *nscCtx, ptxNSC_Mode_t *currentMode);
 
ptxStatus_t ptxNSC_Stop_WaitForRx(ptxNSC_t *nscCtx);
 
 
ptxStatus_t ptxNSC_Start_WaitForRx(ptxNSC_t *nscCtx);
 
#ifdef __cplusplus
}
#endif
 
#endif /* Guard */