【简介】
我们之前介绍过S32K的HSE固件，该部分固件运行在S32K3芯片的M0上，固件中提供了多种服务，我们可以通过MU来和HSE core 来通讯调用对应的服务。HSE 内置了很多的服务，我们本次试验使用HSE 的随机数的服务来获取随机数。
HSE 的服务的使用可以参照S32K3xx_HSE_Service_API_Reference_Manual 文档，本次试验使用的TRNG 的sevice API接口如下：
对于接口的说明上面提到需要依赖 HSE_STATUS_RNG_INIT_OK 状态为1，该状态可以通过读取MU0 的FSR状态寄存器来获取，本地安装HSE 固件后状态为OK状态，意味着此时HSE 的随机数服务是可以正常使用的.
本地添加如下的代码来调用 HSE 的随机数服务：
/**
* @file hse_rng_test.c
*
* @brief This file is used to verify Random number operations
* @details
*
* @addtogroup [SECURITY_FIRMWARE_UNITTEST]
* @{
*/
/*==================================================================================================
* Project : HSE 16FFC
* Platform : Arm Architecture
* Peripheral : CortexM7
* Dependencies : none
*
*
*
* (c) Copyright 2018 NXP.
*
* This software is owned or controlled by NXP and may only be used strictly in accordance with
* the applicable license terms. By expressly accepting such terms or by downloading, installing,
* activating and/or otherwise using the software, you are agreeing that you have read, and that
* you agree to comply with and are bound by, such license terms. If you do not agree to
* be bound by the applicable license terms, then you may not retain, install, activate or
* otherwise use the software.
==================================================================================================*/
/*==================================================================================================
==================================================================================================*/
#ifdef __cplusplus
extern "C"
{
#endif
/*==================================================================================================
* INCLUDE FILES
==================================================================================================*/
#include "Mcal.h"
#include "hse_defs.h"
#include "Hse_Ip.h"
#include "hse_interface.h"
#include "string.h"
/*==================================================================================================
* LOCAL TYPEDEFS (STRUCTURES, UNIONS, ENUMS)
==================================================================================================*/
/*==================================================================================================
* LOCAL MACROS
==================================================================================================*/
/*==================================================================================================
* LOCAL CONSTANTS
==================================================================================================*/
/*==================================================================================================
* LOCAL VARIABLES
==================================================================================================*/
static uint8_t muIf = 0U;
static uint8_t muChannelIdx = 1U;
/*==================================================================================================
* GLOBAL CONSTANTS
==================================================================================================*/
extern hseSrvDescriptor_t hseSrvDescriptor __attribute__((__section__(".mcal_bss_no_cacheable")));
/*==================================================================================================
* GLOBAL VARIABLES
==================================================================================================*/
/*==================================================================================================
* LOCAL FUNCTION PROTOTYPES
==================================================================================================*/
/*==================================================================================================
* LOCAL FUNCTIONS
==================================================================================================*/
/*******************************************************************************
* Function: GetRngNum
*
* Description: This function is used to get random number.
*
* Returns:
* HSE_SRV_RSP_OK HSE service successfully executed with no error
* HSE_SRV_RSP_INVALID_PARAM The HSE request parameters are invalid (e.g
* misaligned, invalid range)
* HSE_SRV_RSP_SMALL_BUFFER The provided buffer is too small
* HSE_SRV_RSP_NOT_ENOUGH_SPACE There is no enough space to perform operation
* (e.g. load a key)
* HSE_SRV_RSP_READ_FAILURE The service request failed because read access
* was denied
* HSE_SRV_RSP_WRITE_FAILURE The service request failed because write access
* was denied
* HSE_SRV_RSP_STREAMING_MODE_FAILURE The service request that uses streaming mode
* failed (e.g. UPDATES and FINISH steps do not use
* the same HSE interface ID and channel ID as START step)
* HSE_SRV_RSP_VERIFY_FAILED HSE signals that a verification request fails (e.g.
* MAC and Signature verification)
* HSE_SRV_RSP_KEY_NOT_AVAILABLE This error code is returned if a key is locked due
* to failed boot measurement or an active debugger
* HSE_SRV_RSP_KEY_INVALID Specified key slot is either not valid or not available
* due to a key usage flags restrictions
* HSE_SRV_RSP_KEY_EMPTY Specified key slot is empty
* HSE_SRV_RSP_BUSY HSE request issued when the HSE is in busy state (on
* that HSE channel)
* HSE_SRV_RSP_MEMORY_FAILURE Detect physical errors, flipped bits etc., during
* memory read or write operations
* HSE_SRV_RSP_GENERAL_ERROR This error code is returned if an error not covered by
* the error codes above is detected inside HSE
******************************************************************************/
hseSrvResponse_t GetRngNum(uint8_t *rngNum, uint32_t rngNumSize, hseRngClass_t rngClass)
{
Hse_Ip_ReqType HseIp_Request;
hseSrvResponse_t hseStatus = HSE_SRV_RSP_GENERAL_ERROR;
hseSrvDescriptor_t* pHseSrvDesc = &hseSrvDescriptor;
hseGetRandomNumSrv_t* pGetRndSrv;
memset(pHseSrvDesc, 0, sizeof(hseSrvDescriptor_t));
pHseSrvDesc->srvId = HSE_SRV_ID_GET_RANDOM_NUM;
pGetRndSrv = &(pHseSrvDesc->hseSrv.getRandomNumReq);
pGetRndSrv->rngClass = rngClass;
pGetRndSrv->pRandomNum = (HOST_ADDR)rngNum;
pGetRndSrv->randomNumLength = rngNumSize;
HseIp_Request.eReqType = HSE_IP_REQTYPE_SYNC;
HseIp_Request.u32Timeout = 0xFFFFFFFFUL;
HseIp_Request.pCallbackParam = NULL;
HseIp_Request.pfCallback = NULL;
hseStatus = Hse_Ip_ServiceRequest(0, 1 , &HseIp_Request, pHseSrvDesc);
return hseStatus;
}
/*==================================================================================================
* GLOBAL FUNCTIONS
==================================================================================================*/
/*******************************************************************************
* Function: GetRngDRG3Num
*
* Description: This function is used to get random number of class DRG3.
*
* Returns:
* HSE_SRV_RSP_OK HSE service successfully executed with no error
* HSE_SRV_RSP_INVALID_PARAM The HSE request parameters are invalid (e.g
* misaligned, invalid range)
* HSE_SRV_RSP_SMALL_BUFFER The provided buffer is too small
* HSE_SRV_RSP_NOT_ENOUGH_SPACE There is no enough space to perform operation
* (e.g. load a key)
* HSE_SRV_RSP_READ_FAILURE The service request failed because read access
* was denied
* HSE_SRV_RSP_WRITE_FAILURE The service request failed because write access
* was denied
* HSE_SRV_RSP_STREAMING_MODE_FAILURE The service request that uses streaming mode
* failed (e.g. UPDATES and FINISH steps do not use
* the same HSE interface ID and channel ID as START step)
* HSE_SRV_RSP_VERIFY_FAILED HSE signals that a verification request fails (e.g.
* MAC and Signature verification)
* HSE_SRV_RSP_KEY_NOT_AVAILABLE This error code is returned if a key is locked due
* to failed boot measurement or an active debugger
* HSE_SRV_RSP_KEY_INVALID Specified key slot is either not valid or not available
* due to a key usage flags restrictions
* HSE_SRV_RSP_KEY_EMPTY Specified key slot is empty
* HSE_SRV_RSP_BUSY HSE request issued when the HSE is in busy state (on
* that HSE channel)
* HSE_SRV_RSP_MEMORY_FAILURE Detect physical errors, flipped bits etc., during
* memory read or write operations
* HSE_SRV_RSP_GENERAL_ERROR This error code is returned if an error not covered by
* the error codes above is detected inside HSE
*
******************************************************************************/
hseSrvResponse_t GetRngDRG3Num(uint8_t *rngNum, uint32_t rngNumSize)
{
return GetRngNum(rngNum, rngNumSize, HSE_RNG_CLASS_DRG3);
}
/*******************************************************************************
* Function: GetRngDRG4Num
*
* Description: This function is used to get random number of class DRG4.
*
* Returns:
* HSE_SRV_RSP_OK HSE service successfully executed with no error
* HSE_SRV_RSP_INVALID_PARAM The HSE request parameters are invalid (e.g
* misaligned, invalid range)
* HSE_SRV_RSP_SMALL_BUFFER The provided buffer is too small
* HSE_SRV_RSP_NOT_ENOUGH_SPACE There is no enough space to perform operation
* (e.g. load a key)
* HSE_SRV_RSP_READ_FAILURE The service request failed because read access
* was denied
* HSE_SRV_RSP_WRITE_FAILURE The service request failed because write access
* was denied
* HSE_SRV_RSP_STREAMING_MODE_FAILURE The service request that uses streaming mode
* failed (e.g. UPDATES and FINISH steps do not use
* the same HSE interface ID and channel ID as START step)
* HSE_SRV_RSP_VERIFY_FAILED HSE signals that a verification request fails (e.g.
* MAC and Signature verification)
* HSE_SRV_RSP_KEY_NOT_AVAILABLE This error code is returned if a key is locked due
* to failed boot measurement or an active debugger
* HSE_SRV_RSP_KEY_INVALID Specified key slot is either not valid or not available
* due to a key usage flags restrictions
* HSE_SRV_RSP_KEY_EMPTY Specified key slot is empty
* HSE_SRV_RSP_BUSY HSE request issued when the HSE is in busy state (on
* that HSE channel)
* HSE_SRV_RSP_MEMORY_FAILURE Detect physical errors, flipped bits etc., during
* memory read or write operations
* HSE_SRV_RSP_GENERAL_ERROR This error code is returned if an error not covered by
* the error codes above is detected inside HSE
*
******************************************************************************/
hseSrvResponse_t GetRngDRG4Num(uint8_t *rngNum, uint32_t rngNumSize)
{
return GetRngNum(rngNum, rngNumSize, HSE_RNG_CLASS_DRG4);
}
/*******************************************************************************
* Function: GetRngPTG3Num
*
* Description: This function is used to get random number of class DRG3.
*
* Returns:
* HSE_SRV_RSP_OK HSE service successfully executed with no error
* HSE_SRV_RSP_INVALID_PARAM The HSE request parameters are invalid (e.g
* misaligned, invalid range)
* HSE_SRV_RSP_SMALL_BUFFER The provided buffer is too small
* HSE_SRV_RSP_NOT_ENOUGH_SPACE There is no enough space to perform operation
* (e.g. load a key)
* HSE_SRV_RSP_READ_FAILURE The service request failed because read access
* was denied
* HSE_SRV_RSP_WRITE_FAILURE The service request failed because write access
* was denied
* HSE_SRV_RSP_STREAMING_MODE_FAILURE The service request that uses streaming mode
* failed (e.g. UPDATES and FINISH steps do not use
* the same HSE interface ID and channel ID as START step)
* HSE_SRV_RSP_VERIFY_FAILED HSE signals that a verification request fails (e.g.
* MAC and Signature verification)
* HSE_SRV_RSP_KEY_NOT_AVAILABLE This error code is returned if a key is locked due
* to failed boot measurement or an active debugger
* HSE_SRV_RSP_KEY_INVALID Specified key slot is either not valid or not available
* due to a key usage flags restrictions
* HSE_SRV_RSP_KEY_EMPTY Specified key slot is empty
* HSE_SRV_RSP_BUSY HSE request issued when the HSE is in busy state (on
* that HSE channel)
* HSE_SRV_RSP_MEMORY_FAILURE Detect physical errors, flipped bits etc., during
* memory read or write operations
* HSE_SRV_RSP_GENERAL_ERROR This error code is returned if an error not covered by
* the error codes above is detected inside HSE
*
******************************************************************************/
hseSrvResponse_t GetRngPTG3Num(uint8_t *rngNum, uint32_t rngNumSize)
{
return GetRngNum(rngNum, rngNumSize, HSE_RNG_CLASS_PTG3);
}
#ifdef __cplusplus
}
#endif
/** @} */本地添加如下的测试代码调用，上述的hse 接口获取随机数:
for(int i = 0;i < 100;i++)
{
hseSrvResponse_t hseSrvResponse = HSE_SRV_RSP_GENERAL_ERROR;
hseSrvResponse = GetRngPTG3Num((uint8_t*)gTrng,8);
if(hseSrvResponse != HSE_SRV_RSP_OK)
{
printf("HSE GetRngPTG3Num failed %x .\r\n",(unsigned int)hseSrvResponse);
}
else
{
printf("HSE TRNG : 0x%08x 0x%08x\r\n",(unsigned int)gTrng[0],(unsigned int)gTrng[1]);
}
}测试代码运行后已经按照预期的获取到了随机数。
我要赚赏金
STM32
MCU
通讯及无线技术
物联网技术
电子DIY
板卡试用
基础知识
软件与操作系统
我爱生活
小e食堂
