secure-element.h

Go to the documentation of this file.

 
#ifndef __SECURE_ELEMENT_H__
#define __SECURE_ELEMENT_H__
 
#ifdef __cplusplus
extern "C"
{
#endif
 
#include <stdint.h>
#include "LoRaMacCrypto.h"
 
#define SE_KEY_SIZE             16
 
#define SE_EUI_SIZE             8
 
#define SE_PIN_SIZE             4
 
typedef enum eSecureElementStatus
{
    SECURE_ELEMENT_SUCCESS = 0,
    SECURE_ELEMENT_FAIL_CMAC,
    SECURE_ELEMENT_ERROR_NPE,
    SECURE_ELEMENT_ERROR_INVALID_KEY_ID,
    SECURE_ELEMENT_ERROR_INVALID_LORAWAM_SPEC_VERSION,
    SECURE_ELEMENT_ERROR_BUF_SIZE,
    SECURE_ELEMENT_ERROR,
    SECURE_ELEMENT_FAIL_ENCRYPT,
}SecureElementStatus_t;
 
typedef void ( *SecureElementNvmEvent )( void );
 
SecureElementStatus_t SecureElementInit( SecureElementNvmEvent seNvmCtxChanged );
 
SecureElementStatus_t SecureElementRestoreNvmCtx( void* seNvmCtx );
 
void* SecureElementGetNvmCtx( size_t* seNvmCtxSize );
 
SecureElementStatus_t SecureElementSetKey( KeyIdentifier_t keyID, uint8_t* key );
 
SecureElementStatus_t SecureElementComputeAesCmac( uint8_t* micBxBuffer, uint8_t* buffer, uint16_t size, KeyIdentifier_t keyID, uint32_t* cmac );
 
SecureElementStatus_t SecureElementVerifyAesCmac( uint8_t* buffer, uint16_t size, uint32_t expectedCmac, KeyIdentifier_t keyID );
 
SecureElementStatus_t SecureElementAesEncrypt( uint8_t* buffer, uint16_t size, KeyIdentifier_t keyID, uint8_t* encBuffer );
 
SecureElementStatus_t SecureElementDeriveAndStoreKey( uint8_t* input, KeyIdentifier_t rootKeyID, KeyIdentifier_t targetKeyID );
 
SecureElementStatus_t SecureElementProcessJoinAccept( JoinReqIdentifier_t joinReqType, uint8_t* joinEui,
                                                      uint16_t devNonce, uint8_t* encJoinAccept,
                                                      uint8_t encJoinAcceptSize, uint8_t* decJoinAccept,
                                                      uint8_t* versionMinor );
 
SecureElementStatus_t SecureElementRandomNumber( uint32_t* randomNum );
 
SecureElementStatus_t SecureElementSetDevEui( uint8_t* devEui );
 
uint8_t* SecureElementGetDevEui( void );
 
SecureElementStatus_t SecureElementSetJoinEui( uint8_t* joinEui );
 
uint8_t* SecureElementGetJoinEui( void );
 
SecureElementStatus_t SecureElementSetPin( uint8_t* pin );
 
uint8_t* SecureElementGetPin( void );
 
#ifdef __cplusplus
}
#endif
 
#endif //  __SECURE_ELEMENT_H__