你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

【NUCLEO-U083RC评测】③AES加解密测试

[复制链接]
小萝卜啦啦啦 发布时间:2024-5-10 22:52
STM32U08是带硬件AES加解密模块的,硬件加解密的最大优势就是快。
9 K+ {; p) q$ e, x6 w2 R
一、cube配置
首先需要在cube中开启AES模块(工程就是上一篇中创建的模板工程)

& ]/ j/ ]2 B: Z3 l2 }
参数这一块主要关注的是加密模式(Data encryption type)、秘钥长度(KeySize)、秘钥(Encryption/Decryption key),其他参数保持默认就可以
1.png
其中加密模式支持如下
2.png
秘钥长度支持128位、256位
秘钥的值可以在cube中配置,也可以这里保持默认值,回头在代码中重新配置(当然上述的这些参数都可以通过代码再次配置,这个待会实战部分会有介绍)

( j" t0 [% C1 i2 O6 E$ d
最后点击右上角生成代码
3.png

9 A7 J* Q+ @5 j( `
二、实战
2.1 AES时钟初始化及函数介绍
先来看一下CUBE自动生成的代码
首先是变量
  1. CRYP_HandleTypeDef hcryp;
    - Q7 Q  I9 v' d4 C: U7 `
  2. uint32_t pKeyAES[4] = {0x00000000,0x00000000,0x00000000,0x00000000};
复制代码
6.png
这边的pKeyAES就是秘钥,和之前cube中设置的一致(下面的测试中我会尝试更换秘钥)
然后就是AES模块的初始化函数
  1. MX_AES_Init();
复制代码
7.png
# c' \; b9 f1 i0 L; h: T
8.png
+ A8 ]! t3 e! B& `2 E, r  r
在初始化函数中可以看到,配置了各个参数,和cube中的一致。然后就是调用了初始化,秘钥、加密模式等就是在init时配置进去的,如果需要更换,那就要调用HAL_CRYP_DeInit(),修改配置参数,然后再调用HAL_CRYP_Init()(这个待会儿我也会尝试一下)
' V. X6 A1 v$ M3 S' J/ I" h
在使用加密前,需要在main函数的最一开始就开启AES的时钟
  1. __HAL_RCC_AES_CLK_ENABLE();
复制代码
4.png

7 L. M0 l' A& q& T& l9 t. ?
加解密函数只提供了HAL库,对应的有三种方式:阻塞加解密、异步加解密、DMA传输的加解密
具体函数如下
  1. HAL_StatusTypeDef HAL_CRYP_Encrypt(CRYP_HandleTypeDef *hcryp, uint32_t *Input, uint16_t Size, uint32_t *Output,
    . D/ A4 H( m+ f( m/ [9 k
  2.                                    uint32_t Timeout);6 d8 |5 Z2 ^# `! ~
  3. HAL_StatusTypeDef HAL_CRYP_Decrypt(CRYP_HandleTypeDef *hcryp, uint32_t *Input, uint16_t Size, uint32_t *Output,
    - V+ b/ H8 b/ P0 \" {3 v9 S
  4.                                    uint32_t Timeout);# q5 |0 d( n7 i8 t+ X2 y8 R
  5. HAL_StatusTypeDef HAL_CRYP_Encrypt_IT(CRYP_HandleTypeDef *hcryp, uint32_t *Input, uint16_t Size, uint32_t *Output);
    - _6 [% U. `6 C4 }
  6. HAL_StatusTypeDef HAL_CRYP_Decrypt_IT(CRYP_HandleTypeDef *hcryp, uint32_t *Input, uint16_t Size, uint32_t *Output);6 `$ i( n$ w  l. D: S
  7. HAL_StatusTypeDef HAL_CRYP_Encrypt_DMA(CRYP_HandleTypeDef *hcryp, uint32_t *Input, uint16_t Size, uint32_t *Output);; S2 z+ E  p4 R# |( |
  8. HAL_StatusTypeDef HAL_CRYP_Decrypt_DMA(CRYP_HandleTypeDef *hcryp, uint32_t *Input, uint16_t Size, uint32_t *Output);
复制代码
5.png

8 @1 F- f* v9 _1 A* x; K
这里我再插一嘴,AES是需要加解密数据为16字节的倍数才可以运行,如果你的不是16字节的倍数,那么就需要做一下填充,加解密接口是不提供填充的,需要自己实现

4 l& [* E* _, ?) Q' S( N
今天我们的测试的是最基础的阻塞加解密函数
4 \3 U1 b  W+ L* P3 k
2.2 AES ECB 128bit加解密测试
我们刚才在cube中默认配置的就是AES ECB,那就可以直接进行加解密的测试
先准备一下明文和对应加密后的秘文,以及存储加解密后结果的数组。待会儿我还有尝试更改秘钥,那么这里就把自定义秘钥相关的也写上
  1. /* 计算得到的秘文 */3 {$ F) B  A$ h
  2. uint32_t Computed_Ciphertext[AES_DATA_SIZE];6 G+ F3 B4 _# n9 h. X4 @$ S, V
  3. /* 计算得到的明文 */' f) k" N/ S) f: G& y
  4. uint32_t Computed_plainText[AES_DATA_SIZE];" D7 j/ S1 D" E2 L( r
  5. , T: }* m2 ?& y* v7 w" r" W
  6. /* 用户自定义128bit秘钥 */
    , P7 {+ o3 e" b- I6 W$ G
  7. uint32_t user_defined_AesKey_128bit[AES_KEY_SIZE] =, F9 J# O! J. ?( s+ H# e- J7 m3 u
  8. {' g2 B1 [& t- T
  9.   0x00112233, 0x44556677, 0x8899aabb, 0xccddeeff
    - `: R3 t: ?, ^7 x$ A
  10. };  X5 w' d8 s2 N2 X! Z
  11. /* 加密前的明文 */2 Q5 T/ s) g% Q# M1 z; k# F
  12. uint32_t AES_plainText[AES_DATA_SIZE] =* J$ _, n+ [% F
  13. {
    . z; J0 v* s8 b1 t( P) Q  I2 m0 e% U
  14.   0x00010203, 0x04050607, 0x08090a0b, 0x0c0d0e0f3 H2 X7 Z4 k" Y" `
  15. };2 F0 U# Y9 k* j4 F

  16. 1 [' g, Y0 l# G
  17. /* AES ECB使用用户自定义128bit秘钥加密后的秘文 */! X( m& e% a% S! C; u3 o# G
  18. uint32_t AES_ECB_Ciphertext_user_defined_128bitKey[AES_DATA_SIZE] =: D: T# D: o0 Y. A# }0 @
  19. {
    ) S" {: C0 k+ T. e; P7 t
  20.   0x279FB74A, 0x7572135E, 0x8F9B8EF6, 0xD1EEE003
    % D- `7 I, N( N: m% D
  21. };
    ' |4 t' W! g( R
  22. /* AES ECB使用cube默认128bit秘钥加密后的秘文 */
    2 K! }$ Y( _0 Q- Z+ F. C$ Y2 z
  23. uint32_t AES_ECB_Ciphertext_cubeDefault_128bitKey[AES_DATA_SIZE] =
    / k9 f# h+ _4 a  v  m& U' I
  24. {4 I' A7 z. J; [1 ^) C8 u9 p% M
  25.   0x7ACA0FD9, 0xBCD6EC7C, 0x9F974666, 0x16E6A282
      C2 K9 o" K% s, [
  26. };
复制代码
9.png
这里创建数组时要注意,一定要是uint32_t类型的,不然和加解密接口的入参类型不一致,不要尝试使用uint8_t再忽略编译警告,别问我是咋知道的

  G/ P# R  S, G' l- R, d: O
然后在加一下宏定义
  1. /* AES加解密阻塞式函数超时时间 */
    : E" z  V# g. @# J* _. c$ \2 B
  2. #define AES_TIMEOUT_VALUE 0xFF  //0xFF按以往经验应该是永不超时,但是没测试过。也不清楚小于ff的值与时间的关系。就先这么设置着再说
    7 `4 L7 U+ n+ C- M4 I  t$ h
  3. /* AES加解密数据的长度(byte) */4 n9 R( f: L, ]8 O
  4. #define AES_DATA_SIZE_BYTE 16
    + _. Z5 i, c+ t) U. s- g) C/ c
  5. /* AES加解密数据的长度(uint32_t) */' J# D3 J1 t0 X# @  X/ O1 k
  6. #define AES_DATA_SIZE (AES_DATA_SIZE_BYTE / 4)
    * r  m, Z# Y  b3 f9 t- }1 l4 ?$ A
  7. /* AES加解密秘钥的长度(bit) */0 M& P0 \# C/ e% W# ?
  8. #define AES_KEY_SIZE_BIT 128
    ( a+ c) H" B6 o9 [" m1 w% r- Y
  9. /* AES加解密数据的长度(uint32_t) */
    / s1 L; @- S! C2 k2 i. K' ~. y
  10. #define AES_KEY_SIZE (AES_KEY_SIZE_BIT / 4)
复制代码
10.png
然后写一下AES ECB 128bit秘钥的加解密测试函数以及dump函数
  1. void dump_data(uint32_t *pData, uint8_t Size)
    5 w- B* n6 |% r( d# N# i
  2. {
    8 H6 [4 i3 o" k7 _) l, Y
  3.   for (uint8_t i = 0; i < Size; i++)+ k/ D1 K+ ]. o& z
  4.   {
    7 y- R. h) S& b2 ?6 D
  5.     printf("%02X ", ((*pData & 0xFF000000) >> 24));$ }( t* H$ R9 U3 W4 s. o
  6.     printf("%02X ", ((*pData & 0x00FF0000) >> 16));3 T/ R0 m2 e/ z  H# U5 k
  7.     printf("%02X ", ((*pData & 0x0000FF00) >> 8));' r8 g- d! _) b; Q0 _, c3 P
  8.     printf("%02X ", ((*pData & 0x000000FF)));
    % ~6 }. }5 U" K" R
  9.     pData++;8 j( S1 D- n* ~% `$ A/ v# E
  10.   }5 l* }8 Q& v& M/ J  R! B
  11.   printf("\r\n");; ^9 e$ G8 a9 M. D4 K
  12. }/ t* s* W0 v' L$ D, t: E8 g% x

  13. * Z# \8 B* J1 z  z% t
  14. void AES_encrypt_test(uint32_t *plainText)8 g& H+ c6 F9 Z; i& m3 L
  15. {. Z/ |/ t$ u  B5 \" C* B
  16.   printf("plainText = ");
    3 Y, _8 T; a7 L( C' ?# ^
  17.   dump_data(plainText, AES_DATA_SIZE);
    6 [8 q/ B& H; F) X" p

  18.   z! [% T; z' r; n0 D! A
  19.   if (HAL_CRYP_Encrypt(&hcryp, plainText, AES_DATA_SIZE, Computed_Ciphertext, AES_TIMEOUT_VALUE) == HAL_OK)' u: e5 q" l' E3 x+ X$ f# _
  20.   {( \8 T, q6 P2 |& F$ a* h
  21.     printf("AES encrypt success\r\n");
    2 y& j2 o7 v% x' G9 U% Z
  22.     printf("Computed_Ciphertext = ");8 {/ f( C2 Z% o
  23.     dump_data(Computed_Ciphertext, AES_DATA_SIZE);4 `$ c. `; a2 O
  24.   }
    3 {: F2 m. W7 p  F
  25.   else
    % D, [" Q1 {7 D7 K9 {0 R
  26.   {
    1 A7 R* g) v3 g( v) Y
  27.     printf("AES encrypt error\r\n");
    8 ?+ h# d2 g) ?* f* S% ]
  28.     Error_Handler();
    : V, L9 E9 I5 j4 Z' f2 S. o
  29.   }+ b+ ~* b) }0 F) \& [! F
  30.   printf("\r\n");
    ( x0 A& ?$ I4 c( }- R- t" U, r
  31. }
    ( T; M! |0 c( B0 ]

  32. : M1 L* ^( f8 @# s6 B/ N% _5 P
  33. void AES_dencrypt_test(uint32_t *cipherText)
    6 G1 ]9 k" I- W6 [) h; Q* B4 O
  34. {' t7 b2 e+ S2 E1 p5 r. O
  35.   printf("cipherText = ");) R' W. [: c+ C" f& v* S
  36.   dump_data(cipherText, AES_DATA_SIZE);1 t6 v! P0 s* U) @% ~
  37. + m8 R/ ?. j6 W* K. d  g
  38.   if (HAL_CRYP_Decrypt(&hcryp, cipherText, AES_DATA_SIZE, Computed_plainText, AES_TIMEOUT_VALUE) == HAL_OK)% O7 |; t1 [8 H, O
  39.   {( H6 |. V( z/ G! o" w, L% V  t
  40.     printf("AES dencrypt success\r\n");
    + c" ?+ K" n3 K+ R
  41.     printf("Computed_plainText = ");
    , W2 o2 Y/ p& {9 \! c
  42.     dump_data(Computed_plainText, AES_DATA_SIZE);) t, ]9 u$ ^$ J+ q2 D  Z) _# I- v" }/ c
  43.   }2 T2 X7 Y' R3 G1 F
  44.   else
    & i: G6 z5 }1 m& p1 `& O
  45.   {
    4 e6 @( a8 P5 l6 O
  46.     printf("AES dencrypt error\r\n");3 r* N3 i' I( d3 d5 o
  47.     Error_Handler();
    7 Y7 i+ t, a  Z8 E; z
  48.   }
    ) j% T# N" @+ W
  49.   printf("\r\n");
    + e+ d, `) f, S: P0 N
  50. }
复制代码
11.png
8 L# T, O! \0 d+ ^; N  k
3 W) X* B) t% T( L. K7 o
然后在main中调用
  1.   printf("AES ECB use cubeDefault key 128Bit encrypt test\r\n");
    # h% @) C( n% C( j! ?
  2.   AES_encrypt_test(&AES_plainText[0]);
    7 Q# k0 ]& e3 M- b2 s
  3.   printf("AES ECB use cubeDefault key 128Bit dencrypt test\r\n");2 f/ |# G0 Y) ?" ]
  4.   AES_dencrypt_test(&AES_ECB_Ciphertext_cubeDefault_128bitKey[0]);
复制代码
12.png
编译运行一下,结果如下
13.png
和在线工具对比一下,结果一致
14.png
" i+ w' _4 G0 p+ t) ^; v' Q
接下来尝试更换一下秘钥,再运行加解密
更换秘钥有2种方案,第一是直接对MX_AES_Init中的内容修改,但是因为这里是cube自动生成的,后续cube再生成一次就又变回去了。所以我选择方案二:去初始化,修改参数,再初始化。

6 c$ Q4 v7 |) M& l; u
改变秘钥函数
  1. void change_key_to_user_defined_AesKey_128bit()
    3 k$ y( R2 S" v/ `7 c
  2. {
    9 V- o7 t0 E, x' Q  D
  3.   printf("change AES KEY to user_defined_AesKey_128bit\r\n");& w' I9 N  x1 B1 {  F6 ]
  4.   /* 先去初始化 */( n" c* C( s- @/ H- V& V* b
  5.   if (HAL_CRYP_DeInit(&hcryp) != HAL_OK)/ c  Y0 n9 U. D  ~1 W$ Z( ~, P0 |
  6.   {
    . |0 B0 t, |5 G3 C5 C7 P3 _7 A
  7.     printf("HAL_CRYP_DeInit error\r\n");
    0 X3 V% p% l5 ?) Y: T8 _& N8 z
  8.     Error_Handler();
    . b$ X* R1 P1 f) ]' D
  9.   }
    ' ]5 W- O0 G! B
  10. 1 Y- t! \9 F6 y* q0 d( ^
  11.   /* 修改使用的秘钥 */
    5 d4 U+ g# v5 f( j; r
  12.   hcryp.Init.pKey = (uint32_t *)user_defined_AesKey_128bit;. C. D7 o* H2 I; l2 z
  13. 4 f# @% `* C7 @% `& e! c8 K
  14.   /* 再次初始化 */
    9 \  d4 q- e7 T+ T& a
  15.   if (HAL_CRYP_Init(&hcryp) != HAL_OK)
    ) f0 X! R/ g+ [2 o1 s0 ^
  16.   {8 G1 r$ a+ @, T: t& u
  17.     printf("HAL_CRYP_Init error\r\n");
    3 S9 l0 Q1 a* Z" d4 j" [
  18.     Error_Handler();
    - [4 t: b  L) R: _. ^8 V  \
  19.   }
    4 }# q+ [5 P. b
  20.   printf("\r\n");
    : I& l  r) J! N* l$ a) S; ^0 {; o% N
  21. }
复制代码
15.png

0 ?' Y: x# b0 e/ U& p1 f  s3 a; V0 u1 k! |
然后在main中调用切换函数,并且再次进行加解密,测试一下更换秘钥是否成功
  1.   change_key_to_user_defined_AesKey_128bit();
    6 f$ ^" ^4 Y% ?

  2. : B0 |+ w/ d5 }2 ~2 W
  3.   printf("AES ECB use user defined key 128Bit encrypt test\r\n");* T" Z9 _7 e! Z
  4.   AES_encrypt_test(&AES_plainText[0]);- |3 Y* ^# U0 w" q
  5.   printf("AES ECB use user defined key 128Bit dencrypt test\r\n");
    0 X5 g5 \, v$ R1 S
  6.   AES_dencrypt_test(&AES_ECB_Ciphertext_user_defined_128bitKey[0]);
复制代码
16.png
编译下载运行效果如下
17.png
和在线工具对比一下,结果一致
18.png

$ v, `2 l+ y8 j
2.2 AES CBC 128bit加解密测试
然后我们把AES模式切换至CBC模式,来进行测试
CBC相比ECB多了一个IV参数,所以我们先把IV的数组准备一下
  1. /* AES CBC使用的IV */
复制代码
然后准备一下CBC加密后的结果的数组,回头给解密时使用
  1. /* AES CBC使用用户自定义128bit秘钥加密后的秘文 */
    6 ?( l8 \5 ?: P' r  q7 P
  2. uint32_t AES_CBC_Ciphertext_user_defined_128bitKey[AES_DATA_SIZE] =/ o  H7 J: T" Z6 ^
  3. {% i9 S/ S  l4 O; T0 ^# Z5 e
  4.   0xFCDBC004, 0xEB4CA8BB, 0x60F4C4A8, 0xC2B9E783
    . R; ?# N" g) u5 }! k& n: T
  5. };
复制代码
19.png
写一下切换至CBC模式的函数
  1. void change_to_aes_cbc_mode()
    ( `; _' ^; S- ~2 O
  2. {0 G, g" z% U$ g# I
  3.   printf("change to AES CBC mode\r\n");- e  @! Z: J; M/ p8 P
  4.   /* 先去初始化 */3 c# N2 Q! d  Q8 D9 q
  5.   if (HAL_CRYP_DeInit(&hcryp) != HAL_OK); \1 E  l2 \( V5 R& Y
  6.   {
    9 g5 W' c0 S! q6 U  u, M) ?* N# X
  7.     printf("HAL_CRYP_DeInit error\r\n");( E! Z4 B; d8 N, Z2 W5 i
  8.     Error_Handler();) n$ @: Z5 u* _4 K. o
  9.   }! {5 t& d6 j, e  L

  10. 7 f+ r/ n; V! o
  11.   /* 修改为CBC模式 */
    # C( Z/ D+ v9 O
  12.   hcryp.Init.Algorithm = CRYP_AES_CBC;8 B5 z" {- X; u- E/ a
  13.   /* 设置IV *// a, C% R5 n" B# J4 t8 D) N
  14.   hcryp.Init.pInitVect  = AES_CBC_IV;
    6 ^' G/ V! G, B# a- g" @5 L& J

  15. - i, t, d7 @0 `/ Y( j! T" M1 u
  16.   /* 再次初始化 */
    , G& e& X7 T, ~( F
  17.   if (HAL_CRYP_Init(&hcryp) != HAL_OK)7 y+ P  y. e6 N, N5 j8 G% R: J
  18.   {
    ; }: r/ }8 ]) A3 l  V8 J8 Q/ q
  19.     printf("HAL_CRYP_Init error\r\n");2 O3 t1 h, `" r3 F4 O/ Y; g" d" s
  20.     Error_Handler();
    8 ?2 G* l! o' v# A5 O; j( H6 g
  21.   }3 w* }" H2 T! ^* k9 I+ P* Y6 `( B
  22.   printf("\r\n");* ?  X# w4 V' V# @5 S
  23. }
复制代码
20.png
在main中调用切换函数,然后进行CBC加解密测试
  1.   change_to_aes_cbc_mode();
    ' d( p& m* h* s; U% q' n

  2. 2 N! D$ P$ o1 ~4 [! H
  3.   printf("AES CBC use user defined key 128Bit encrypt test\r\n");$ J6 D4 O( q8 U. c
  4.   AES_encrypt_test(&AES_plainText[0]);
    1 t5 i" F7 J0 \/ u$ B2 @$ f8 K
  5.   printf("AES CBC use user defined key 128Bit dencrypt test\r\n");
    " z5 I) J" h0 p# h8 u" ~
  6.   AES_dencrypt_test(&AES_CBC_Ciphertext_user_defined_128bitKey[0]);
复制代码
21.png
编译下载,结果如下
22.png
和在线工具对比一下,结果一致
23.png
三、总结
今天的测试非常成功,都与在线工具结果一致。AES其实还有很多东西,例如使用256bit秘钥、CTR、GCM_GMAC、CCM加解密方式等,由于时间关系我就不一一进行测试了,基本上与就今天的改变秘钥、改变加密方式大同小异,大家可以自行研究。
5 z; h" x) A! e4 o
本次工程代码: STM32U0_AES_test.rar (5.21 MB, 下载次数: 5)
赞 1 收藏 评论2 发布时间:2024-5-10 22:52

举报

2个回答
STMCU-管管 回答时间:2024-5-11 09:03:52
赞,用心了& l8 W7 o' i/ X
Yude 回答时间:2024-5-22 16:55:14

好详细啊👍

所属标签

相似技术帖

官网相关资源

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版