疑問

前面碰到了一個問題，RT-Thread 支持 MD5，可是 M2354 卻不支持，那怎么知道 RT-Thread 的 CRYPTO 設備對 M2354 支持怎樣呢？

我看了下文檔，沒找到，通過查看源碼，做了如下表格：

總的來說看就是 RT-thread 支持隨機數、哈希、對稱加密，

PS：該表格根據文件 rt-threadbspnuvotonlibrariesm2354rtt_portdrv_crypto.c 里面的 static rt_err_t nu_hwcrypto_create(struct rt_hwcrypto_ctx *ctx)) 函數得來

接下來首先使用下 HASH 算法

hash 算法

hash 算法是什么？ 我在網上找到這個解釋：

哈希算法（Hash）又稱摘要算法（Digest），它的作用是：對任意一組輸入數據進行計算，得到一個固定長度的輸出摘要。
哈希算法最重要的特點就是：
相同的輸入一定得到相同的輸出；
不同的輸入大概率得到不同的輸出。

根據這個我的理解是，對于任何（任何長度）數據，不管什么時候計算，通過 hash 算法計算，都一定能得到相同的輸出。

常用的 hash 算法有：

目前，在 M2354 跑 RT-Thread 使用 CRYPTO 設備 的話，可以用到的 hash 算法有：

sha1 ：使用該算法獲得的哈希值為 160 bit
sha2
SHA224：使用該算法獲得的哈希值為 224 bit
SHA256：使用該算法獲得的哈希值為 256 bit
SHA384：使用該算法獲得的哈希值為 384 bit
SHA512：使用該算法獲得的哈希值為 512 bit
CRYPTO 設備的 HASH 算法 API

RT-Thread 使用 CRYPTO 設備 對應的 hash 算法 API 有：

根據文檔，使用方法為：

使用 rt_hwcrypto_hash_create 創建 hash 上下文
使用 rt_hwcrypto_hash_update 對數據進行 hash 運算
使用 rt_hwcrypto_hash_finish 獲得運算結果
最后使用 rt_hwcrypto_hash_destroy 刪除上下文，釋放資源
通過前面運行文檔 CRYPTO 設備 給出的例程，我的實踐結果是如果按照該流程，在 NuMaker-M2354 上是無法正常運行的，需要在創建了上下文后調用函數 rt_hwcrypto_hash_reset 才能夠正常運行。

如何測試

該文檔中 CRYPTO 設備 給出的 hash 例程比較簡單，我有沒實際使用場景，該如何測試 hash 呢？

我看了下 M2354 官方給出的 BSP （M2354_Series_BSP_CMSIS_V3.00.002）有個 sha1 的例程（目錄：M2354_Series_BSP_CMSIS_V3.00.002SampleCodeStdDriverCRYPTO_SHA），這個例程里面有 64 組數據及對應的 hash 值，正好可以拿來測試，我把這個例程移植到 RT-Thread 中的 NuMaker-M2354 BSP 中，

移植好后，編譯運行：

程序一開始是跑下來了，計算出來的哈希值也是對的，可是運行到最后一組數據的時候，程序卡死了，通過調試發現也是卡死在 rt-threadbspnuvotonlibrariesm2354rtt_portdrv_crypto.c 里面的 SHABlockUpdate 函數，也是停在了該函數的最后一句 while (!s_SHA_done) {};，一直等待在完成。

通過單步調試查看寄存器，發了了卡住的原因，如下圖：

在執行開始計算的時候，CRYPTO_HMAC_DMACNT 寄存器為 0。

M2354 的參考手冊中，關于 Hash 的使用中有說道開始計算之前，需要先設置寄存器 CRYPTO_HMAC_DMACNT ：

摘自：M2354 Series Technical Reference Manual

然后再單步調試、查看代碼，發現可疑點：

把上圖中的 >= 改為 > 后，程序可以跑完了：

M2354 Sha1 的性能怎樣

怎么測試 Hash 算法的性能呢？ 我不知道，我也只是剛接觸 CRYPTO，不過，我想起了之前見過的一張 PPT：

這是某個 MCU 的 HASH 算法的統計數據，給出了 SHA2、SHA3 計算每 16KB 所需的時間，最下面 2 行是什么，還不知道，根據這個，做個簡化版的，畢竟 MCU 資源有限，我就做個計算 1K Byte 數據所需的時間。

做法是，根據 M2354 官方給出的 BSP （M2354_Series_BSP_CMSIS_V3.00.002）里面的 sha1 例程，我做 10 組 大小 1024 字節的數據，算出計算每組數據所需時間求和再除 10，統計出計算 1024 字節 HASH 所需的時間。

那這數據怎么來呢？

我用 python 做了個簡單的小程序，生成 10 組大小為 1024 字節的隨機數的數組，并計算 hash 值，保存到一個文件中，代碼很簡單，才 20 多行，如下：

import numpy as np
import hashlib
def create_item():
first = np.random.randint(20,high = 0xff, size=1024)
str = ""
for item in first:
str += hex(item).replace("0x","")
source = []
for by in first:
source.append(by)
bye = bytes(source)
n = hashlib.sha1()
n.update(bye)
return str,n.hexdigest()
dat = "[L = 20]nn"
for i in range(10):
msg,has = create_item()
dat += "Len = 8192nMsg = " + msg + "nMD = " + has + "nn"
print(has)
print(dat)
file = open("sha_test_vector","w")
file.write(dat)
file.close()

運行結果如下：

在 MCU 部分，我需要個可以統計計算 hash 所需時間的方法，一開始使用系統節拍（使用函數 rt_tick_get() 獲取系統節拍）來統計，發現計算出來的時間是 0，精度不夠，后來試了下 HWTIMER，可以出時間，應該是可以滿足需求的。

我分別做了 SHA1、SHA224、SHA256、SHA384、SHA512 的得出如下數據：

總結

RT-Thread 的 HASH 算法用起來還是挺簡單的，文檔也是很詳細。我在使用過程中碰到 2 個問題：

使用 HASH 算法的時候，在創建 HASH 上下文后需要調用函數 rt_hwcrypto_hash_reset 才能夠正常運行，可是這個跟文檔有出入，不知道是 M2364 的 BSP 的問題還是 文檔的問題

M2354 BSP 中的 rt-threadbspnuvotonlibrariesm2354rtt_portdrv_crypto.c里面的函數 nu_sha_hash_run 這句:
while ((psSHACtx->u32SHATempBufLen + u32DataLen) >= psSHACtx->u32BlockSize)

需要改為：

while ((psSHACtx->u32SHATempBufLen + u32DataLen) > psSHACtx->u32BlockSize)

這個是不是 bug ？