歡迎再次來(lái)到“碼靈半導(dǎo)體CFW32C7UL系列產(chǎn)品應(yīng)用介紹”連載專題。通過(guò)前幾期對(duì)CFW32C7UL系列的國(guó)密算法介紹，相信大家對(duì)碼靈半導(dǎo)體CFW32C7UL系列的國(guó)密硬件模塊有了充分的了解。

由于發(fā)展歷程原因，目前市場(chǎng)上商用密碼使用仍然以國(guó)際標(biāo)準(zhǔn)加解密算法為主，不過(guò)隨國(guó)家對(duì)國(guó)密算法的推進(jìn)，未來(lái)國(guó)密算法的應(yīng)用也會(huì)越來(lái)越廣泛。碼靈半導(dǎo)體CFW32C7UL系列的加解密模塊除了之前介紹的國(guó)密密碼算法以外，還支持國(guó)際標(biāo)準(zhǔn)算法的AES加解密算法和SHA-1、SHA-256哈希算法。本專題聚焦于CFW32C7UL系列所支持的國(guó)際標(biāo)準(zhǔn)加解密算法硬件模塊：AES分組加解密算法和SHA哈希算法。以下我們具體介紹下CFW32C7UL系列AES和SHA模塊的使用以及加解密的速度等。
一、AES分組加解密算法
AES是Advanced Encryption Standard的縮寫(xiě)，即高級(jí)加密標(biāo)準(zhǔn)，在密碼學(xué)中又稱Rijndael加密法，是美國(guó)聯(lián)邦政府采用的一種區(qū)塊加密標(biāo)準(zhǔn)。高級(jí)加密標(biāo)準(zhǔn)是由美國(guó)國(guó)家標(biāo)準(zhǔn)與技術(shù)研究院（NIST）于2001年11月26日發(fā)布于FIPS PUB 197，并在2002年5月26日成為有效的標(biāo)準(zhǔn)。這個(gè)標(biāo)準(zhǔn)用來(lái)替代原先的DES，已經(jīng)被多方分析且廣為全世界所使用，至2006年，高級(jí)加密標(biāo)準(zhǔn)已然成為對(duì)稱密鑰加密中最流行的算法之一。
1、CFW32C7UL AES分組算法的實(shí)現(xiàn)
CFW32C7UL 系列的AES模塊可完成標(biāo)準(zhǔn)AES加解密運(yùn)算和AES-CM、AES-F8加密運(yùn)算。標(biāo)準(zhǔn)AES算法即AES標(biāo)準(zhǔn)（FIPS-197）中規(guī)定的算法。AES-CM和AES-F8算法在The Secure Real-time Transport Protocol（SRTP）中有詳細(xì)說(shuō)明，這兩種算法均以標(biāo)準(zhǔn)AES算法為基礎(chǔ)，并對(duì)標(biāo)準(zhǔn)AES算法進(jìn)行迭代運(yùn)用。
AES模塊中的標(biāo)準(zhǔn)AES算法除了支持CPU輸入輸出外，還支持DMA輸入和DMA輸出，而AES-CM、AES-F8只支持DMA輸出。
2、CFW32C7UL AES分組算法的使用
開(kāi)發(fā)模式一：裸機(jī)SDK
目前CFW32C7UL系列裸機(jī)SDK支持AES-CM, AES-F8，以及標(biāo)準(zhǔn)的AES加解密方式。其中AES-CM和AES-F8只支持加密，不支持解密。標(biāo)準(zhǔn)的AES方式支持加密和解密。
在CFW32C7UL系列 AES的SDK中有個(gè)關(guān)鍵的CIPHER_AES_Init_TypeDef結(jié)構(gòu)體：
typedef struct {
uint32_t mode;
uint32_t encrypt;
uint32_t type;
uint32_t key_len;
uint32_t blk_num;
uint32_t key[8];
uint32_t key_f8_mask[8];
uint32_t *input_data;
uint32_t *output_data;
}CIPHER_AES_Init_TypeDef;
在使用AES算法之前需要初始化CIPHER_AES_Init_TypeDef結(jié)構(gòu)體，初始化范例：
cipher_aes_init.encrypt = CIPHER_AES_CTRL_ENCRYPT;
cipher_aes_init.input_data = (uint32_t *)aes_in_data;
cipher_aes_init.output_data = (uint32_t *)aes_out_data;
cipher_aes_init.blk_num = 1; 加解密輪數(shù)
cipher_aes_init.key_len = CIPHER_AES_KEY_LEN_128BIT;
cipher_aes_init.key[0] = 0x21212121; 設(shè)置AES 密鑰，可自定義
cipher_aes_init.key[1] = 0x43434343;
cipher_aes_init.key[2] = 0x65656565;
cipher_aes_init.key[3] = 0x87878787;
配置cipher_aes_init結(jié)構(gòu)體的初始化參數(shù)后，便可以進(jìn)行相對(duì)應(yīng)的AES加密運(yùn)算。
AES CM加密算法：
cipher_aes_init.mode = CIPHER_AES_MODE_AES_CM;
HAL_CIPHER_CM_AES(&cipher_aes_init);
AES F8加密算法：
cipher_aes_init.mode = CIPHER_AES_MODE_AES_F8;
HAL_CIPHER_F8_AES(&cipher_aes_init);
標(biāo)準(zhǔn)AES 加解密方式:
加密范例：
cipher_aes_init.encrypt = CIPHER_AES_CTRL_ENCRYPT;
cipher_aes_init.mode = CIPHER_AES_MODE_AES_STD;
HAL_CIPHER_StdAES(&cipher_aes_init);
解密范例：
cipher_aes_init.encrypt = CIPHER_AES_CTRL_DECRYPT;
cipher_aes_init.mode = CIPHER_AES_MODE_AES_STD;
HAL_CIPHER_StdAES(&cipher_aes_init);
開(kāi)發(fā)模式二：Linux SDK
通過(guò)操作linux系統(tǒng)中/dev/wokoo_aes ，就可以進(jìn)行標(biāo)準(zhǔn)AES分組加密算法的運(yùn)算。
AES算法底層接口
open：打開(kāi)設(shè)備節(jié)點(diǎn)
read：讀取加密/解密后的數(shù)據(jù)
write：寫(xiě)入加密前/解密前的數(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ù)長(zhǎng)度
返回值 成功0，其它失敗
write:
函數(shù)原型 static ssize_t uac_write(struct file *file, const char __user *buf, size_t count, loff_t *ppos)
參數(shù) file:文件名，buf：寫(xiě)入數(shù)據(jù)緩存,count:寫(xiě)入數(shù)據(jù)長(zhǎng)度
返回值 成功0，其它失敗
使用示例：
fd = open("/dev/wokoo_aes", O_RDWR); 打開(kāi)aes節(jié)點(diǎn)
write(fd, &wokoo_aes, sizeof(struct wokoo_aes_t)); 寫(xiě)入明文/密文，密鑰等配置
read(fd, wokoo_aes.output_data, sizeof(wokoo_aes.output_data)); 讀出密文/明文
注：這里的write寫(xiě)入的wokoo_aes結(jié)構(gòu)體，如同在裸機(jī)中使用一樣，會(huì)在調(diào)用前初始化一些參數(shù)，通過(guò)write把密鑰和模式配置寫(xiě)入。
3、CFW32C7UL AES算法的效率：
目前碼靈半導(dǎo)體CFW32C7UL系的可以實(shí)現(xiàn)標(biāo)準(zhǔn)AES加密速率是85KB/s。
二、SHA哈希算法模塊
1、CFW32C7UL SHA哈希算法的實(shí)現(xiàn)
CFW32C7UL系列的SHA哈希算法支持SHA-1以及SHA-256。SHA1是SHA的較舊版本，可生成160位哈希值，而SHA256是SHA2的一種類型，可生成256位哈希值。
CFW32C7UL系列的SHA模塊支持DMA輸入和CPU輸入，輸出僅支持CPU輸出。

2、CFW32C7UL SHA算法的使用
開(kāi)發(fā)模式一：裸機(jī)SDK
目前裸機(jī)開(kāi)發(fā)支持SHA-1以及SHA-256兩種哈希算法SDK，兩種算法分別有CPU輸入和DMA輸入的方式。
在CFW32C7UL系列 SHA的SDK中有個(gè)關(guān)鍵的CIPHER_SHA_Init_TypeDef結(jié)構(gòu)體，結(jié)構(gòu)體定義如下：
typedef struct {
uint32_t mod;
uint32_t line_num;
uint32_t *input_data;
uint32_t *output_data;
}CIPHER_SHA_Init_TypeDef;
使用SHA SDK之前，需初始化這個(gè)結(jié)構(gòu)體。包括設(shè)置數(shù)據(jù)量和設(shè)置數(shù)據(jù)的輸入輸出流。
cipher_sha_init.line_num = 0x01; 設(shè)置SHA的數(shù)據(jù)輸入輪數(shù)為1
cipher_sha_init.input_data = (uint32_t *)sha_in_data; 設(shè)置SHA 輸入流
cipher_sha_init.output_data = (uint32_t *)sha_out_data; 設(shè)置SHA輸出流
配置完cipher_sha_init結(jié)構(gòu)體的初始化參數(shù)后，便可以進(jìn)行相對(duì)應(yīng)的SHA哈希運(yùn)算。
調(diào)用HAL_CIPHER_SHA_DMA()進(jìn)行DMA輸入方式SHA哈希運(yùn)算。
cipher_sha_init.mod = CIPHER_SHA_MOD_SHA1; 配置SHA-1算法
HAL_CIPHER_SHA_DMA(&cipher_sha_init); 啟動(dòng)SHA-1算法 (DMA Input)
cipher_sha_init.mod = CIPHER_SHA_MOD_SHA256; 配置SHA-256算法
HAL_CIPHER_SHA_DMA(&cipher_sha_init); 啟動(dòng)SHA-256算法 (DMA Input)
調(diào)用HAL_CIPHER_SHA_CPU ()進(jìn)行 CPU輸入方式SHA哈希運(yùn)算。
cipher_sha_init.mod = CIPHER_SHA_MOD_SHA1; 配置SHA-1算法
HAL_CIPHER_SHA_CPU (&cipher_sha_init); 啟動(dòng)SHA-1算法（CPU Input）
cipher_sha_init.mod = CIPHER_SHA_MOD_SHA256; 配置SHA-256算法
HAL_CIPHER_SHA_CPU (&cipher_sha_init); 啟動(dòng)SHA-256算法（CPU Input）
開(kāi)發(fā)模式二：Linux SDK
通過(guò)操作linux系統(tǒng)中/dev/wokoo_sha ，便可以進(jìn)行SHA算法的運(yùn)算。
SHA算法底層接口
open：打開(kāi)設(shè)備節(jié)點(diǎn)
read：讀取哈希后的數(shù)據(jù)
write：寫(xiě)入哈希的數(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ù)長(zhǎng)度
返回值 成功0，其它失敗
write:
函數(shù)原型 static ssize_t uac_write(struct file *file, const char __user *buf, size_t count, loff_t *ppos)
參數(shù) file:文件名，buf：寫(xiě)入數(shù)據(jù)緩存,count:寫(xiě)入數(shù)據(jù)長(zhǎng)度
返回值 成功0，其它失敗
使用范例：
fd = open("/dev/wokoo_sha", O_RDWR); 打開(kāi)sha節(jié)點(diǎn)
write(fd, &wokoo_sha, sizeof(struct wokoo_sha_t)); 寫(xiě)入需要哈希的數(shù)據(jù)
read(fd, wokoo_sha.output_data, sizeof(wokoo_sha.output_data)); 讀出哈希后的數(shù)據(jù)
類似地，LINUX在初始化wokoo_sha結(jié)構(gòu)體時(shí)會(huì)根據(jù)給定參數(shù)選擇不同的算法，輸入數(shù)據(jù)輪數(shù)和輸入方式，根據(jù)不同的參數(shù)計(jì)算不同的結(jié)果。如下示例：
wokoo_sha.bit_mod = CIPHER_SHA_MOD_SHA256; 選擇SHA-256方式
wokoo_sha.data_mod = CIPHER_SHA_TYPE_DMA; 選擇DMA輸入方式
wokoo_sha.line_num = 1; 設(shè)置數(shù)據(jù)輸入輪數(shù)為1

3、CFW32C7UL SHA算法的效率
目前碼靈半導(dǎo)體CFW32C7UL系列SHA-1以及SHA-256的加密速率可以實(shí)現(xiàn)87KB/s。
通過(guò)這幾期對(duì)碼靈半導(dǎo)體CFW32C7UL系列的國(guó)密及國(guó)際標(biāo)準(zhǔn)加解密算法的介紹，相信大家對(duì)CFW32C7UL系列的加解密模塊有一個(gè)相對(duì)全面的了解。國(guó)密算法與國(guó)際標(biāo)準(zhǔn)加解密算法的對(duì)標(biāo)關(guān)系是：國(guó)密算法的SM4和國(guó)際標(biāo)準(zhǔn)加解密算法AES對(duì)標(biāo)，國(guó)密算法的SM3算法與國(guó)際標(biāo)準(zhǔn)加解密算法MD5、SHA-256等哈希算法對(duì)標(biāo)，國(guó)密算法的SM2算法與國(guó)際標(biāo)準(zhǔn)加解密算法RSA、ECC算法對(duì)標(biāo)。其實(shí)CFW32C7UL系列在芯片安全機(jī)制方面，除了加解密模塊外還有其它的安全特性和功能配置，那它們具體都是什么呢？又有什么特點(diǎn)呢？讓我們帶著這些問(wèn)題，在下期中繼續(xù)探尋吧。