一文看懂碼靈半導(dǎo)體CFW32C7UL系列產(chǎn)品應(yīng)用（二）：國密算法●中篇

作者：碼靈半導(dǎo)體時間：2020-07-19 來源：EEPW

加入技術(shù)交流群
- 掃碼加入
  和技術(shù)大咖面對面交流
  海量資料庫查詢

歡迎再次來到“碼靈半導(dǎo)體CFW32C7UL系列產(chǎn)品應(yīng)用介紹”連載專題。通過上期對CFW32C7UL系列支持的國密算法種類的介紹，相信您對CFW327UL系列的國密硬件模塊有了初步了解，那么這些國密模塊如何使用？應(yīng)用是否便捷？加解密的速度如何？帶著這些疑問，我們今天從真隨機數(shù)發(fā)生器TRNG和SM3算法模塊的調(diào)用開始談起。

本文引用地址：http://www.butianyuan.cn/article/202007/415807.htm

圖片.png

一、真隨機數(shù)發(fā)生器TRNG模塊

說到隨機，有兩個必須要搞清楚的概念即“真隨機數(shù)生成器”（TRNG）和偽隨機數(shù)生成器（PRNG）。大部分計算機程序和語言中的隨機函數(shù)，都是偽隨機數(shù)生成器，它們都是由確定的算法，通過一個“種子”（如“時間”）來產(chǎn)生“看起來隨機”的結(jié)果值。毫無疑問，只要知道算法和種子，或者是之前已經(jīng)產(chǎn)生了的隨機數(shù)，那么就有可能獲得接下來隨機數(shù)序列的信息，因此它們帶有可預(yù)測性。這種可預(yù)測性在密碼學(xué)上并不安全，所以我們稱其為“偽隨機”。

與“偽隨機”相對應(yīng)的是“真隨機”，真正的隨機數(shù)僅存在于量子力學(xué)中，而我們需要的是一種不可預(yù)測的、統(tǒng)計意義上的、高安全性的隨機數(shù)。在碼靈半導(dǎo)體CFW32C7UL系列產(chǎn)品中我們提供了四組這種真隨機數(shù)源，用以產(chǎn)生真隨機數(shù)，同時該功能模塊是采用硬件方式實現(xiàn)的，并且通過了NIST統(tǒng)計檢測程序的隨機性測試。

下面我們具體介紹下CFW32C7UL系列產(chǎn)品的真隨機數(shù)發(fā)生器TRNG模塊是如何通過碼靈半導(dǎo)體官方提供的SDK函數(shù)來進行調(diào)用的。目前碼靈半導(dǎo)體官方提供了兩種SDK，即裸機SDK和Linux SDK。

開發(fā)模式一：裸機SDK

裸機SDK與提供的freeRTOS和uCOS SDK中相同。

① 產(chǎn)生一個真隨機數(shù)

調(diào)用HAL_TRNG_GetValue()

uint32_t HAL_TRNG_GetValue() 函數(shù)返回值為一個真隨機數(shù)

② 使用范例

uint32_t random = HAL_TRNG_GetValue();

單個函數(shù)看不出硬件實現(xiàn)和軟件實現(xiàn)有什么不同，那下面展現(xiàn)一下函數(shù)源碼：

uint32_t HAL_HRNG_GetValue()

{

uint32_t ret;

HRNG->CMPRES = 0x02;

while((HRNG->STATUS& HRNG_STATUS_FIFO_NOT_EMPTY) ==0);

ret= HRNG->LFSR;

return ret;

}

上面所述的就是對寄存器HRNG->CMPRE、HRNG->CTRL進行一個配置后，等待HRNG->STATUS，之后HRNG->LFSR寄存器中取出隨機數(shù)。

開發(fā)模式二：Linux SDK

通過操作linux系統(tǒng)中/dev/wokoo_trng，就可以進行產(chǎn)生真隨機數(shù)。

① TRNG算法底層接口

? open：打開設(shè)備節(jié)點

? read：讀取隨機數(shù)的數(shù)據(jù)

② 接口描述

? open

函數(shù)原型：static int uac_open(struct inode *inode, struct file * file)

參數(shù)：file:文件名

返回值：成功0，其它失敗

? read

函數(shù)原型：static ssize_t uac_read(struct file * file, char __user *buffer, size_t size , loff_t *p)

參數(shù)：file:文件名，buffer：讀出數(shù)據(jù)緩存,size:讀出數(shù)據(jù)長度

返回值：成功0，其它失敗

③ 使用示例

trng_fd = open("/dev/wokoo_trng", O_RDWR); //打開trng的節(jié)點

read(trng_fd, (unsigned char *)&trng_data, 1); //讀取真隨機數(shù)

CFW32C7UL系列的TRNG效率

目前碼靈半導(dǎo)體CFW32C7UL系列產(chǎn)品產(chǎn)生隨機數(shù)的速率是75kb/s，即每秒可以產(chǎn)生75kb的真隨機數(shù)。

二、SM3雜湊硬件算法模塊

SM3算法為國密雜湊算法，數(shù)據(jù)分組長度為512bit，雜湊值長度為256bit?；具\算流程為：對輸入數(shù)據(jù)流做填充，構(gòu)成整數(shù)個512bit長度的數(shù)據(jù)流；再對數(shù)據(jù)做分組；然后對每個分組做擴展和替換壓縮操作，得到中間的臨時雜湊值，反復(fù)進行直到所有分組處理完畢，最后一個計算得到的雜湊值作為整個數(shù)據(jù)流的最終雜湊值輸出。

開發(fā)模式一：裸機SDK

調(diào)用SM3_Hash產(chǎn)生SM3最終Hash值。

void SM3_Hash(uint32_t *pDataIn,uint32_t DataLen,uint32_t *pDigest)

① 函數(shù)參數(shù)說明

pDataIn: 輸入的數(shù)據(jù)指針( big endian)

DataLen: 數(shù)據(jù)的bit 長度

pDigest: 輸出的最終hash值

② 使用范例

SM3_Hash (message,32,tempbuf);

//message 是原始數(shù)據(jù)，數(shù)據(jù)長度為32，tempbuf是產(chǎn)生的256位Hash值

開發(fā)模式二：Linux SDK

通過操作linux系統(tǒng)中/dev/wokoo_sm3，就可以進行SM3雜湊算法的運算。