SAM AV3 HAL Initialization for Pegoda 2 (RD710) Reader in S (NonX) Mode

Example code to configure HAL and BAL for Pegoda 2 (RD710) reader with SAM AV3 in S (NonX) mode. More...

Collaboration diagram for SAM AV3 HAL Initialization for Pegoda 2 (RD710) Reader in S (NonX) Mode:

Modules
	RD710 Initialization
	Example code to configure PAL 3A, 4A, 4, MIFARE and SLI15693 to work in RD710 mode. This is valid for RD710 / CM1 reader only.
	Software Initialization
	Example code to configure PAL 3A, 4A, 4, MIFARE and SLI15693 to work in software mode.

Detailed Description

Example code to configure HAL and BAL for Pegoda 2 (RD710) reader with SAM AV3 in S (NonX) mode.

#define CHECK_SUCCESS(x)                                                                             \
     if ( (x) != PH_ERR_SUCCESS )                                                                    \
     {                                                                                               \
             printf ( "\n\n" );                                                                      \
             printf ( "An error occurred: (0x%04X)\n", (x) );                                        \
             printf ( "Pressing any key will exit the demo.\n" );                                    \
             _getch ();                                                                              \
             return 0;                                                                               \
     }
 
/* Variables */
phStatus_t wStatus = 0;
 
phCryptoSym_Sw_DataParams_t stCryptoSym_Enc;
phCryptoSym_Sw_DataParams_t stCryptoSym_MAC;
phCryptoSym_Sw_DataParams_t stCryptoSym_Enc_PLUpload;
phCryptoSym_Sw_DataParams_t stCryptoSym_Mac_PLUpload;
phCryptoSym_Sw_DataParams_t stCryptoSym_Rnd;
phCryptoRng_Sw_DataParams_t stCryptoRng_Rnd;
 
phKeyStore_Sw_DataParams_t stKeyStore;
phKeyStore_SamAV3_DataParams_t stKeyStoreSAM;
 
phbalReg_PcscWin_DataParams_t stBal_Rd710;
phbalReg_Sam_DataParams_t stBal_Sam;
phhalHw_Rd710_DataParams_t stHal_Rd710;
phhalHw_SamAV3_DataParams_t stHal_SamAv3;
 
phKeyStore_Sw_KeyEntry_t aKeyEntry[0xFF];
phKeyStore_Sw_KeyVersionPair_t aKeyVersionPair[0xFF];
phKeyStore_Sw_KUCEntry_t aKeyUsageCounter[0xFF];
 
uint8_t aAtr_ContactLess[256];
uint8_t aAtr_Contact[256];
uint8_t aTx_BalBuffer[512];
uint8_t aRx_BalBuffer[512];
uint8_t aTx_HalBuffer[512];
uint8_t aRx_HalBuffer[512];
uint8_t aTx_SamBuffer[512];
uint8_t aRx_SamBuffer[512];
uint8_t aPLUploadBuffer[512];
uint8_t aSeed[8];
uint8_t aHostAuthKey[] = { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 };
 
void* pBal_Generic = NULL;
void* pHal_Generic = NULL;
 
/* Initialize software KeyStore component. */
wStatus = phKeyStore_Sw_Init ( &stKeyStore, sizeof ( phKeyStore_Sw_DataParams_t ), aKeyEntry, 0xFF, aKeyVersionPair, 0x03,
     aKeyUsageCounter, 0xFF );
CHECK_SUCCESS ( wStatus );
 
/* Initialize software Crypto component. */
wStatus = phCryptoSym_Sw_Init ( &stCryptoSym_Enc, sizeof ( phCryptoSym_Sw_DataParams_t ), &stKeyStore )
CHECK_SUCCESS ( wStatus );
 
wStatus = phCryptoSym_Sw_Init ( &stCryptoSym_Mac, sizeof ( phCryptoSym_Sw_DataParams_t ), &stKeyStore )
CHECK_SUCCESS ( wStatus );
 
wStatus = phCryptoSym_Sw_Init ( &stCryptoSym_Enc_PLUpload, sizeof ( phCryptoSym_Sw_DataParams_t ), &stKeyStore )
CHECK_SUCCESS ( wStatus );
 
wStatus = phCryptoSym_Sw_Init ( &stCryptoSym_Mac_PLUpload, sizeof ( phCryptoSym_Sw_DataParams_t ), &stKeyStore )
CHECK_SUCCESS ( wStatus );
 
wStatus = phCryptoSym_Sw_Init ( &stCryptoSym_Rnd, sizeof ( phCryptoSym_Sw_DataParams_t ), &stKeyStore )
CHECK_SUCCESS ( wStatus );
 
wStatus = phCryptoRng_Sw_Init ( &stCryptoRng_Rnd, sizeof ( phCryptoRng_Sw_DataParams_t ), &stKeyStore )
CHECK_SUCCESS ( wStatus );
 
/* Seed the random number generator with the given seed. */
 memset ( aSeed, 0x00, 0x08 );
wStatus = phCryptoRng_Seed ( &stCryptoRng_Rnd, aSeed, sizeof ( aSeed ) );
 
 
 
 
 
/* Initialization for Contactless reader ------------------------------------------------------------------------------------------------------ */
/* Initialize the reader BAL component */
wStatus = phbalReg_PcscWin_Init ( &stBal_Rd710, sizeof ( phbalReg_PcscWin_DataParams_t ), aAtr_ContactLess, 256 );
CHECK_SUCCESS ( wStatus );
 
/* Set the BAL Communication Configuration values */
wStatus = phbalReg_SetConfig ( &stBal_Rd710, PHBAL_REG_PCSCWIN_CONFIG_PROTOCOL, PHBAL_REG_PCSCWIN_VALUE_PROTOCOL_UNDEFINED );
CHECK_SUCCESS ( wStatus );
 
wStatus = phbalReg_SetConfig ( &stBal_Rd710, PHBAL_REG_PCSCWIN_CONFIG_SHARE, PHBAL_REG_PCSCWIN_VALUE_SHARE_DIRECT );
CHECK_SUCCESS ( wStatus );
 
/* Connect to the first reader out of the list. */
wStatus = phbalReg_SetPort ( &stBal_Rd710,  ( uint8_t * ) "NXP Pegoda S CL 0 0" );
CHECK_SUCCESS ( wStatus );
 
/* Open the reader port. */
wStatus = phbalReg_OpenPort ( &stBal_Rd710 );
CHECK_SUCCESS ( wStatus );
 
/* Initialize the reader HAL component. */
wStatus = phhalHw_Rd710_Init ( &stHal_Rd710, sizeof ( phhalHw_Rd710_DataParams_t ), &stBal_Rd710, 0, aTx_HalBuffer,
     sizeof ( aTx_HalBuffer ), aRx_HalBuffer, sizeof ( aRx_HalBuffer ) );
CHECK_SUCCESS ( wStatus );
 
/* Standard Rd710 Cmd Init. */
wStatus = ( phStatus_t ) phhalHw_Rd710_Cmd_InitReader ( &stHal_Rd710 );
CHECK_SUCCESS ( wStatus );
 
 
 
 
 
/* Initialization for Contact reader ---------------------------------------------------------------------------------------------------------- */
/* Initialize the reader BAL component */
wStatus = phbalReg_Sam_Init ( &stBal_Sam, sizeof ( phbalReg_Sam_DataParams_t ), &stBal_Rd710, aAtr_Contact, 256, aTx_BalBuffer,
     sizeof ( aTx_BalBuffer ), aRx_BalBuffer, sizeof ( aRx_BalBuffer ) ) );
CHECK_SUCCESS ( wStatus );
 
/* Open the reader port. */
wStatus = phbalReg_OpenPort ( &stBal_Sam );
CHECK_SUCCESS ( wStatus );
 
/* Initialize the reader HAL component */
wStatus = phhalHw_SamAV3_Init ( &stHal_SamAv3, sizeof ( phhalHw_SamAV3_DataParams_t ), &stBal_Sam, &stHal_Rd710, &stKeyStore,
     &stCryptoSym_Enc, &stCryptoSym_MAC, &stCryptoRng_Rng, &stCryptoSym_Enc_PLUpload, &stCryptoSym_Mac_PLUpload,
     PHHAL_HW_SAMAV3_OPMODE_NON_X, 0x00, aTx_SamBuffer, sizeof ( aTx_SamBuffer ), aRx_SamBuffer,
     sizeof ( aRx_SamBuffer ), aPLUploadBuffer );
CHECK_SUCCESS ( wStatus );
 
/* Update the generic components. */
pBal_Generic = &stBal_Sam;
pHal_Generic = &stHal_SamAv3;
 
/* Initialize SAM Keystore component. */
wStatus = phKeyStore_SamAV3_Init ( &stKeyStoreSAM, sizeof ( phKeyStore_SamAV3_DataParams_t ), &stHal_SamAv3 );
CHECK_SUCCESS ( wStatus );
 
 
 
 
 
/* Detect SAM settings. This will update the Host version internally. MUST to be CALLED. */
wStatus = phhalHw_SamAV3_DetectMode ( &stHal_SamAv3 );
CHECK_SUCCESS ( wStatus );
 
/* Load a the key to software keystore for SAM HOST Authentication. */
wStatus = phKeyStore_FormatKeyEntry ( &stKeyStore, 0x00, PH_KEYSTORE_KEY_TYPE_AES128 );
CHECK_SUCCESS ( wStatus );
 
wStatus = phKeyStore_SetKeyAtPos ( &stKeyStore, 0x00, 0x00, PH_KEYSTORE_KEY_TYPE_AES128, aHostAuthKey, 0x00 );
CHECK_SUCCESS ( wStatus );
 
/* Perform HOST AUTHENTICATION in PLAIN mode. */
wStatus = phhalHw_SamAV3_Cmd_SAM_AuthenticateHost ( &stHal_SamAv3, PHHAL_HW_SAMAV3_CMD_SAM_AUTHENTICATE_HOST_MODE_PLAIN, 0x00,
     0x00, 0x00, 0x00 );
CHECK_SUCCESS ( wStatus );