sclib.h

Go to the documentation of this file.

/**************************************************************************/
#ifndef __SCLIB_H__
#define __SCLIB_H__
 
#include "M4521.h"
 
#ifndef   __WEAK
  #define __WEAK                                 __attribute__((weak))
#endif
 
#ifdef __cplusplus
extern "C"
{
#endif
 
#define SCLIB_MAX_ATR_LEN       32  
#define SCLIB_MIN_ATR_LEN        2  
 
// Protocol
#define SCLIB_PROTOCOL_UNDEFINED                0x00000000  
#define SCLIB_PROTOCOL_T0                       0x00000001  
#define SCLIB_PROTOCOL_T1                       0x00000002  
 
#define SCLIB_SUCCESS                           0x00000000  
// error code generate by interrupt handler
#define SCLIB_ERR_CARD_REMOVED                  0x00000001  
#define SCLIB_ERR_OVER_RUN                      0x00000002  
#define SCLIB_ERR_PARITY_ERROR                  0x00000003  
#define SCLIB_ERR_NO_STOP                       0x00000004  
#define SCLIB_ERR_SILENT_BYTE                   0x00000005  
#define SCLIB_ERR_CMD                           0x00000006
#define SCLIB_ERR_UNSUPPORTEDCARD               0x00000007
#define SCLIB_ERR_READ                          0x00000008
#define SCLIB_ERR_WRITE                         0x00000009
#define SCLIB_ERR_TIME0OUT                      0x0000000A  
#define SCLIB_ERR_TIME1OUT                      0x0000000B  
#define SCLIB_ERR_TIME2OUT                      0x0000000C  
#define SCLIB_ERR_AUTOCONVENTION                0x0000000D  
#define SCLIB_ERR_CLOCK                         0x0000000E  
#define SCLIB_ERR_BGTIMEOUT                     0x0000000E
// error code generate while parsing ATR and process PPS
#define SCLIB_ERR_ATR_UNRECOGNIZED              0x00001001  
#define SCLIB_ERR_ATR_INVALID_PARAM             0x00001002  
#define SCLIB_ERR_ATR_INVALID_TCK               0x00001003  
#define SCLIB_ERR_PPS                           0x00001004
// error code for T=1 protocol
#define SCLIB_ERR_T1_PARITY                     0x00002001            
#define SCLIB_ERR_T1_ICC                        0x00002002           
#define SCLIB_ERR_T1_PROTOCOL                   0x00002003  
#define SCLIB_ERR_T1_ABORT_RECEIVED             0x00002004  
#define SCLIB_ERR_T1_RESYNCH_RECEIVED           0x00002005  
#define SCLIB_ERR_T1_VPP_ERROR_RECEIVED         0x00002006  
#define SCLIB_ERR_T1_WTXRES_RECEIVED            0x00002007  
#define SCLIB_ERR_T1_IFSRES_RECEIVED            0x00002008  
#define SCLIB_ERR_T1_ABORTRES_RECEIVED          0x00002009  
#define SCLIB_ERR_T1_CHECKSUM                   0x0000200A  
 
// error code for T=0 protocol
#define SCLIB_ERR_T0_PROTOCOL                   0x00003003      
 
// error code indicates application control flow error
#define SCLIB_ERR_DEACTIVE                      0x0000F001      
#define SCLIB_ERR_CARDBUSY                      0x0000F002      
 /* end of group NUC451_SCLIB_EXPORTED_CONSTANTS */
 
typedef struct
{
    uint32_t T;                         
    uint32_t ATR_Len;                   
    uint8_t ATR_Buf[SCLIB_MAX_ATR_LEN]; 
} SCLIB_CARD_INFO_T;
 
typedef struct
{
    uint8_t Fi;        
    uint8_t Di;        
    uint8_t conv;      
    uint8_t chksum;    
    uint8_t GT;        
    uint8_t WI;        
    uint8_t BWI;       
    uint8_t CWI;       
    uint8_t clkStop;   
    uint8_t IFSC;      
    uint8_t NAD;       
} SCLIB_CARD_ATTRIB_T;
 
 /* end of group NUC451_SCLIB_EXPORTED_STRUCTS */
 
int32_t SCLIB_Activate(uint32_t num, uint32_t u32EMVCheck);
 
int32_t SCLIB_ActivateDelay(uint32_t num, uint32_t u32EMVCheck, uint32_t u32Delay);
 
int32_t SCLIB_ColdReset(uint32_t num);
 
int32_t SCLIB_WarmReset(uint32_t num);
 
void SCLIB_Deactivate(uint32_t num);
 
int32_t SCLIB_GetCardInfo(uint32_t num, SCLIB_CARD_INFO_T *s_info);
 
 
int32_t SCLIB_GetCardAttrib(uint32_t num, SCLIB_CARD_ATTRIB_T *s_attrib);
 
int32_t SCLIB_StartTransmission(uint32_t num, uint8_t *cmdBuf, uint32_t cmdLen, uint8_t *rspBuf, uint32_t *rspLen);
 
int32_t SCLIB_SetIFSD(uint32_t num, uint8_t size);
 
 
#if defined (__GNUC__) && !defined (__ARMCC_VERSION)
void SCLIB_RequestTimeExtension () __attribute__ ((weak));
void SCLIB_RequestTimeExtension(uint32_t u32Protocol);
#else
__WEAK void SCLIB_RequestTimeExtension(uint32_t u32Protocol);
#endif
 
uint32_t SCLIB_CheckCDEvent(uint32_t num);
 
uint32_t SCLIB_CheckTimeOutEvent(uint32_t num);
 
uint32_t SCLIB_CheckTxRxEvent(uint32_t num);
 
uint32_t SCLIB_CheckErrorEvent(uint32_t num);
 
 
#ifdef __cplusplus
}
#endif
 
#endif //__SCLIB_H__
 /* end of group SCLIB_EXPORTED_FUNCTIONS */
 /* end of group SC_Library */
 /* end of group Component Library */