STMCU小助手
发布时间:2024-2-29 16:53
|
一、前言 STM32H5 是 ST 2023 年新推出的产品系列,与以往 MCU 不同的是, STM32H5 推出新的 product state 功能特性以替代以往的 RDP 功能。+ b- d9 H; r: W" H9 W6 j4 l5 C& L% f + J7 z& h* S8 F) L2 n$ g; ^. s
2 Z! }2 |2 J m3 F' q% e2 z- E 如上图所示,product state 有如下状态 : 6 l3 Y: d( I, M9 d/ `6 h Open(0xED) : 完全 open 状态,相当于以前的 RDP0。- x2 E( O5 L! K% Q. R& k; O' r 6 a2 W* x1 |4 _+ V5 H Provisioning(0x17) : 此状态是专门用来做预配置的。 9 x2 _. ]% w: E, Y5 y + J0 Y+ V; |$ m) X4 [2 I' x2 q iROT-Provisioned(0x2E) : 用于 STiROT 或 OEMiROT。 & y2 q$ s( a, ~) e/ k TZ-Closed(0xC6): Secure 区域关闭, 相当于 RDP0.5(仅在 TZEN=0xB4 时有效)。 3 B. B, A1 x4 s& K3 F Closed(0x72): S 和 NS 区域均受到保护,这点有些类似于 RDP1,此时调试口没法对其直接访问,但可通 过 DA 打开调试口或回退,这一点有点类似于 STM32U5 上的可带密码回退的 RDP2。 5 d# g4 s, }% V& j' I9 b/ i- u Locked(0x5C): 完全关闭芯片的外部访问,相当于以往 STM32 芯片的 RDP2 保护等级。 : M$ f, p. C/ U) u 整体如下图所示:
7 @: Z$ L# ]) p 其状态切换如下图所示 :! g* U: S. `$ ~1 o & X! K' d; t; P b; x
. j$ d. H( [0 ` 如上图所示,product state 从 open->provisioning->iROT-Provisioned->TZ-Closed->Closed 如此从左到右是可切换的,但是,要从右到左如此回退,则必须要经过 DA[Debug Authentication]过程。如上图所示,经过 DA 后,要么完全回退到 Open 状态,要么部分回退到 TZ-Closed 状态。- Y9 r5 z# B# W$ ?& U3 T% |' r/ m( e * k" X6 j, P# z1 {+ h, z9 |- b 所谓的 DA,就是通过向芯片提供证书(STM32H503 是提供密码),通过芯片的身份认证后,允许向 芯片发起 product state 状态回退,或者重新打开调试口请求(仅当 TZEN=0xB4 时)。$ R, q$ T% G, e 由于新的 product state 和 DA 的引入,所有 STM32H5 开发者都必须掌握 DA 的用法。因此,本 文档针对 STM32H5 初学者,演示当 TZEN=0xB4 时, 使用证书来完成 DA 过程。# S6 m2 J8 `% C 二、准备工作+ |6 e! a5 D/ P; S$ F1 J( X V! U9 t9 P 开发板 : NUCLEO-H563ZI . A5 P" ~- y! u& l% J* J/ A
+ u9 l. R$ D1 S$ N3 v 软件包 : STM32Cube_FW_H5_V1.1.0 " ~& T, }1 B) m; y$ t6 p7 V 工具: STM32CubeProgrammer v2.14.0+ ^/ L! G+ o d& h; v Tera Term 串口终端显示( \; @* s6 }. n6 j* } Trust Package Creator(安装 STM32CubeProgrammer 时一并安装, 注意勾选)' m0 N1 D# l; L5 W% V% R IDE: STM32CubeIDE v1.13.0/ W1 X/ E( M- G: ?9 W STM32CubeH5 包我们需要将其放到一个没有空格没有中文的路径下,在本动手实验中,我们 默认将其放在路径 C:\workspace\目录下。3 p- a/ N$ J0 t L% `, |# G - ]% c0 v0 G+ x9 k8 r) j 三、生成 OBK 并测试 在 STM32CubeH5 包下的路径 STM32Cube_FW_H5_V1.1.0\Projects\NUCLEOH563ZI\ROT_Provisioning\DA,在此目录下,已经包含了自带的默认 obk,密钥以及证书。其实 我们可以直接使用这些 obk 以及对应的证书和密钥,这里我们将重新生成一套,并测试它是否 OK。; [( y- G9 q6 g( Q0 i: e8 T% @ 3.1. 重新生成密钥对打开 TPC(TrustedPackageCreator)工具 . \- U7 X6 |% m& a. W' _1 n 0 T: w- W. \7 a: s3 V
5 h9 T4 b; u& G+ L 在 xml file 处,导入 DA_Config.xml 文件 :- V8 o- h g2 J( L2 X' ~ C:/workspace/STM32Cube_FW_H5_V1.1.0/Projects/NUCLEO-H563ZI/ROT_Provisioning/DA/Config/DA_Config.xml% U3 {- Z$ r, C3 } b 如上图,在导入 DA_Config.xml 文件后,点击 Regenerate 按键后,将在 Keys 目录下重新生成公钥私钥对 :% q j1 h, Z& T; |; m( y
i' ^/ ?( p3 M) U' Z 这组密钥对就是接下来需要使用到的密钥对了。0 ]4 f) v5 F" n* y2 |# ] 其中 :& ~. a( W6 X, \2 [+ F! Y Key_1_root.pem 为私钥" Q. {! T: O# I, w) k: j; |9 @ Key_1_root_pub.pem 为公钥% P) U7 Y$ N; E- ]0 b f" c, M9 Q, a 1 @2 H: u; q. m5 j, x 3.2. 生成 DA OBK 文件7 [! f( G: Y/ ^! v1 S" e6 F 接下我们将创建 DA 的 obk 文件 :# w. _ h; [5 q- s9 n' P/ p( ? # C! D( h! B# R- k' g! L
如上图所示,继续在 TPC 工具中,在 Permission Mask 下,激活允许的操作许可,被激活的就是 DA 认证通过后,允许的操作. 然后在 Output File 处选择输出文件。我们使用默认即可。然后点击 Generate OBKey 按键,则在 Binary 目录下生成 DA_Config.obk 文件 : / f( G9 x7 c+ `% ~ C5 M
8 t3 s! R3 @$ U5 V 这个 obk 文件就是我们后续将来做 DA 预配置(provisioning)的 obk 文件了。. U8 [/ j4 A* w0 A1 S+ Z+ S# M 3.3. 生成证书 接下来我们继续用 TPC 工具生成证书。4 @& M' z( @' j : X; d. s- ?4 m5 O
! f4 N6 n/ D( R6 e7 k& ^ 如上图所示,在 Microcontroller 处选择 STM32H5-2M,在 Root Private Key 处我们选择之前生成的私钥文件 : C:/workspace/STM32Cube_FW_H5_V1.1.0/Projects/NUCLEO-H563ZI/ROT_Provisioning/DA/Keys/key_1_root.pem' h; W' n" p& [; u' C: x - P( V2 U* h& B% e, y9 u+ C 而在Root Public Key处则选择之前生成的公钥文件:C:/workspace/STM32Cube_FW_H5 _V1.1.0/Projects/NUCLEO-H563ZI/ROT_Provisioning/DA/Keys/key_1_root_pub.pem 然后在 Permission Mask 处选择此证书所允许的操作许可。我们将 Full 回退 to TZ,以及Secure/Non Secure 下的 Level 1~3 的 Debug 权限许可全部打开。 , P* N) L0 k# b" Q- X' Z' U 在 Certificate file 处选择输出文件,我们选择C:/workspace/STM32Cube_FW_H5_V1.1.0/Projects/NUCLEOH563ZI/ROT_Provisioning/DA/Certificates/cert_root.b64 即在 Certificates 目录下生成 cert_root.b64 文件,最后再点击右下角的 Generate Certificate 按键,最终在 Certificates 生成了 cert_root.b64 文件。0 ^+ D; u) Y* h* } o% E7 c6 d
0 B! ~7 B0 ]0 W6 T$ U& T; j2 P( [6 k" q 如上图所示,在 Certificates 目录下将同时生成两个文件 : cert_root.b64, cert_root.cert。5 f9 B$ W4 z/ H$ n2 S: \ 其中 cert_root.b64 就是我们需要的证书文件了,它就是根证书。它将在后续步骤中进行 DA 时将会用到。而另一个生成的文件 cert_root.cert,我们并未用到它。 3.4. DA 预配置 (provisioning), K1 S. T9 x% U 接下来我们将做 DA 预配置,在此之前我们确保使能 Trust Zone 功能,即 TZEN=0xB4。
) Q) K/ B, B6 Q! t$ N u 如上图所示,使用 STM32CubeProgrammer 连接芯片,并将 TrustZone 打开。2 { p- H$ t$ p& Y2 F/ U$ P3 r S. [/ l 然后将 Product State 切换到 Provisioning 状态 :( g. I' D7 X" ^4 F+ p6 y' M & }: y2 X4 a! D+ [/ n
/ A$ X; Y* S$ v8 N1 h; x) H 接下来正式做 DA 预配置…5 \# S {! _7 _$ d& t' H . B8 n- K4 Z, A5 R' f& J" d' ?5 p
6 A) O7 `0 y6 M2 s 如上图所示,在 STM32CubeProgrammer 左边选择盾牌图标,然后在上方选项卡处选择PROV,接着在 OBKey file path 处选择之前生成的 DA_Config.obk 文件 :6 U' j' l8 R9 j( V1 j: j, Z: j 2 t ?$ `" j) y, T0 w1 A C:\workspace\STM32Cube_FW_H5_V1.1.0\Projects\NUCLEO-H563ZI\ROT_Provisioning\DA\Binary\ DA_Config.obk 5 v1 v. ]! c0 H& m6 D( c , Z3 x* t' i P! f 最后点击 Start Provisioning 按键…
成功时,将弹出消息提示成功。此时表示,DA obk 文件已经预配置到芯片内部并且已经成功了。然后断开 STM32CubeProgrammer 的连接…6 B" K& U8 \$ X; _4 `1 k# R5 b ( J2 D4 e! k# e
) G6 u1 f- I* c& A6 H4 A# G 如上图所示,点击 Disconnect 按键,确保 STM32CubeProgrammer 已经断开连接。接下来我们将尝试用证书做 DA 回退… : N* P0 {* Z; o) h) ? 3.5. DA 回退 $ F V+ w. H5 T1 Z8 J
* o9 M5 A) n/ \+ f( D& i 如上图所示,在确保 STM32CubeProgrammer 断开连接的情况下,左边还是选择盾牌图标,上方选项卡处选择 DA,然后在界面中点击 Discover 按键… 1 a1 l. A% k' L0 }6 T1 z' Q# Z
如上图所示,在接下来的界面中,在 Key File Path 处选择之前生成的私钥文件 key_1_root.pem:C:\workspace\STM32Cube_FW_H5_V1.1.0\Projects\NUCLEO-H563ZI\ROT_Provisioning\DA\Keys\key_1_root.pe# X4 y& d$ d; g, O8 h 如上图所示,在接下来的界面中,在 Key File Path 处选择之前生成的私钥文件 key_1_root.pem:C:\workspace\STM32Cube_FW_H5_V1.1.0\Projects\NUCLEO-H563ZI\ROT_Provisioning\DA\Keys\key_1_root.pe 4 N( l; `2 J( j- w1 K3 D+ W 在 Certificate File Path 处选择之前生成的证书 cert_root.b64:C:\workspace\STM32Cube_FW_H5_V1.1.0\Projects\NUCLEO-H563ZI\ROT_Provisioning\DA\Certificates\cert_root.b6& ?! s: ]' ~& }( s 然后点击右边的 Continue 按键… 9 _6 C2 o8 T7 y
如上图所示,在下方新显示出来的界面内容中,在左边选择 Full Regression, 即你想要的操作,然后点击右边的 Execte 按键… + y% S. P( g) d& c" |1 N6 o: C8 Z
2 ^5 O& ?) I' v) { 如上图所示,弹出界面显示 DA 成功。; t) z: q h. O) u ) }8 o7 N: f3 r; J. G& m2 ^ 这也就表示,之前生成的私钥文件 key_1_root.pem + 证书文件 cert_root.b64 正是匹配之前生成的 obk 文件 DA_Config.obk 的。 % [! o4 Y2 X! y2 o" c 其中 DA_Config.obk 文件和固件 hex 文件是要给工厂烧录芯片用的。而私钥文件 key_1_root.pem + 证书文件 cert_root.b64 则是需要保留,将来工程师需要它们来做 DA 回退和 DA 调试用的。 这里需要注意地是,如果上述 DA 回退未成功,则表示证书+私钥与之前预配置的 DA obk 不匹配,需要重新执行 3.1~3.5 节。直到 DA 回退成功为止,否则切记不要进入到下一步骤,不然很可能会由于证书不对无法回退导致芯片废掉(除非用户代码可以执行回退)。* N; c! I- i( y8 {3 s E % A3 d' Y e7 m8 f+ e8 U 四、运行一个程序并 DA 调试 ~, K6 X. M$ T6 P 4.1. 在 Open 状态下运行一个示例程序 使用 STM32CubeProgrammer,确保 product state =Open, TZEN=0xB4:
/ w, R% Y3 k0 y7 f0 Y& G; [ 并确保:SECWM1_PSTRT=0x0 SECWM1_PEND=0x7F, SECWM2_PSTRT=0x7F SECWM2_PEND=0x0:
7 n/ k/ x; Y( J8 h 然后使用 STM32CubeIDE 编译 STM32CubeH5 包下的示例工程:STM32Cube_FW_H5_V1.1.0\Projects\NUCLEO-H563ZI\Examples\GPIO\GPIO_IOToggle_TrustZone\STM32CubeIDE 分别先后编译 S 和 NS 工程并烧录对应程序,并复位运行。正常情况下,可以看到板子上 LD5(橙色), LD6(绿色)两盏灯在来回闪动。即表示测试程序运行 OK。' j. z) A: t) ]9 Q: P8 h% e * j) R# U6 R$ t( [% l6 c 4.2. DA 预配置0 ]- W- `/ x0 X# g& f 接下来我们参照之前的 3.4 节,将 product state 切换到 provisioning 状态, 然后进行 DA 预配置。 ( N% l- ^. p! w) }- X9 [
如上图,切换到 provisioning 状态。 6 H0 {1 d0 \5 G
如上图所示,导入之前生成的 DA_Config.obk 文件,然后点击 Start Provisioning 按键,进行预配置。' O7 K; v; G( i# @. h6 T' {
) R% ]. R- D3 k2 ?5 `, O9 } 弹出上面显示模式,则表示预配置已经成功。 & H5 I( g- |3 b3 c6 b' q* n 4.3. 修改状态到 Closed 状态 ' O! j) U' B! y: i6 U3 r
* p2 V" r3 b2 d1 T8 [4 q3 g 如上图所示,接下来将 product state 修改为 Closed 状态。此时 ST-Link 连接会自动断开,表示芯片内部调试口已经自己关闭了。 此时查看板子,LD5、LD6 两灯依旧来回闪烁,说明程序在 Closed 状态下运行正常。只不过此时调试口是连接不上了。0 Z: ] ?* P. ~5 S! p0 V4 B 4.4. DA 调试 ) ? P: L5 ?# g3 n* R 4.4.1. 使用 STM32CubeIDE 调试 NS 工程 在 STM32H563 处于 Closed 状态下时,SWD 口默认是关闭的,此时是无法调试代码的,若想调试代码,必须得通过 DA 认证重新打开调试端口,好在这一功能已经集成在 STM32CubeIDE 中了。接下来我们将使用 STM32CubeIDE 调试 NS 工程,在 NS 工程的 Debug Configuration 中, 在 Debugger 选项卡下 : 0 _ `- }! O; f3 z9 f8 C
. k A5 k5 i% w9 p2 x, g% e 如上图所示,在 Reset behaviour 的 Type 下,选择 software system reset, 然后在 Debug Authentication 下勾上 Enable,在 Key path 后面选择之前生成的私钥文件 : C:\workspace\STM32Cube_FW_H5_V1.1.0\Projects\NUCLEO-H563ZI\ROT_Provisioning\DA\Keys\key_1_root.pem,在 Certification path 后面选择之前生成的证书 : C:\workspace\STM32Cube_FW_H5_V1.1.0\Projects\NUCLEO-H563ZI\ROT_Provisioning\DA\Certificates\cert_root.b64, 然后 Permission 后边选择 Debug Non Secure L1,然后点击 Debug 按键… 4 {* p2 o: ^ _% j
如上所示,程序在运行在 NS 工程的 main 函数开始处则停下来了,接下来你可以选择单步调试...7 ?1 p8 _, `5 ^, x & T6 B/ b6 p4 A; c- b 4.4.2. 使用 STM32CubeIDE 调试 S 工程+ z& L% \5 A( V8 D2 M: m S 工程的调试配置有些许差异。
3 Y- ]( E3 B+ ^7 P; x8 M 如上,Reset behaviour Type 为 None,同样在 Debug Authentication 下设置之前生成的私钥和证书,Permission 变为 Debug Secure L1。
然后拖下来将 Verify flash download 之前的勾去掉(如上图所示)。/ d- q' D T. D( x' S ; V+ `! s" p( j) c% {
如上图所示,在 Startup 选项卡下,在 Load Image and Symbols 列表中选择当前工程的 Image,然后点击右边的 Edit…按键,然后在弹出的对话框中将 Download 前的勾去掉。点击 OK、Apply、并 Closed、关闭当前窗口。接下来在 S 工程中的源文件中的 xxx_it.c 源文件中的 systick 中断入口处设置一个断点, 如下图所示: v+ `7 C2 `# X" g
4 F8 e1 f+ w2 L! K; j7 N
$ F! ~% U' r7 K& K+ `* k
如上图所示,程序运行在断点处停下来了,接下来你可以单步调试 Secure 工程了。这是一种完全没有破坏现场的调试方法,适合当出现问题后,直接去查看出现问题的代码行。当然在调试 Non Secure 工程时,你也可以按此方法来配置。也可以达到不破坏现场的效果。 4.4.3. 在其它 IDE 中进行 DA 调试8 \+ |# I+ C; a 由于其它 IDE 当前最新版本还并未将 DA 过程集成到 IDE 中,因此,需要利用 STM32CubeProgrammer 进行 DA 认证通过之后,才可以用 IDE 进行调试。* R" C5 u( c# z$ n \3 @ * t- ?: }1 P7 ?# A* }+ } 接下来我们将使用 STM32CubeProgrammer 通过 DA 来重新打开调试口。
在断开连接的情况下,在 STM32CubeProgrammer 中,选择 DA 选项卡,然后点击 Discover… . u! u' c9 K/ `5 H. v3 H. ]
$ K$ o: z9 l4 w% O. b 与 3.5 节类似,在上图中,选择之前生成好的私钥文件 C:\workspace\STM32Cube_FW_H5_V1.1.0\Projects\NUCLEO-H563ZI\ROT_Provisioning\DA\Keys\key_1_root.pem,以及证书文件 C:\workspace\STM32Cube_FW_H5_V1.1.0\Projects\NUCLEO-H563ZI\ROT_Provisioning\DA\Certificates\cert_root.b64,然后点击 Continue 按键… - L/ H( |; a Z: I: k6 ~; C+ P 5 F: v, M1 B" g0 r2 I
如上图所示,在下面新显示的内容中选择 Non-Secure Intrusive Debug(Level 1),然后点击 Execte 按键… - @8 h4 q; X, o s: N; B" O$ ? ' d7 V+ s0 j, X& m$ G7 S$ U. {
如上图所示,表示 DA 已经成功,调试口已经重新打开。然后断开 STM32CubeProgrammer 的连接。 7 R' }1 n4 d) d( ]/ W0 c 接下来就可以选择你所使用的 IDE(如 Keil、IAR)调试 NS 工程了,如下图使用 IAR 调试 :
# p" Z% L l* J2 \( M4 p7 C5 [+ @ 如上图所示,选择 Attach to Running Target 可直接 attach 上去查看当前运行的代码行。当然在之前 DA 步骤中,你也可以选择调试 S 工程 … 8 p+ E( D# J- Q$ Q% e X/ \
8 I9 g' t8 R/ v 如上图所示, 在下面新显示的内容中选择 Secure Intrusive Debug(Level 1), 然后点击 Execte 按键… % \) I4 }& ]# x0 b- s0 L2 z5 i
/ z& ^0 o3 Y& l1 L: Z! x+ D( u6 ] 如上图所示,表示 DA 已经成功,调试口已经重新打开。然后断开 STM32CubeProgrammer 的连接,接下来就可以选择你所使用的 IDE(如 Keil、 IAR)调试 NS 工程了。 五、还原* f1 r2 X8 d- V. U 还原的过程参考 3.5 节,步骤完全一致。最终还原成功后,全片 Flash 内容已经擦除。最后,将 TZEN 直接修改为 0xC3。 2 D) J( i+ f0 S+ V) L
* R' i' Q7 b$ c, A2 [ K 至此,芯片完全恢复成原始状态。另外,DA 回退过后,之前预配置的内容也自动清空了, 因此,后续还需要重新进行预配置 (provisioning)。 * s9 f5 y+ D3 `% t% W8 v( G; N& u ; q% ?3 [' I5 e- [7 x6 ~/ a 转载自: STM321 ^9 d: x% M7 e1 a: m# d) _! ~ 如有侵权请联系删除 |
【STM32H5 评测】5、Flash和RAM读写速度测试
【NUCLEO-H5E5ZJ评测】NetXDuo 以太网测评:从 CubeMX 到网络 shell
【NUCLEO-H5E5ZJ评测】ThreadX 移植实录:从 CubeMX 到双线程
【NUCLEO-H5E5ZJ评测】HASH硬件加速实测
【STM32H5 评测】Part4 STM32H5E5 存储测试
【NUCLEO-H5E5ZJ评测】M.2存储扩展实测
【STM32H5 评测】+ 多外设同时开启稳定性简要评测
【NUCLEO-H5E5ZJ评测】CoreMark 移植实录:从 CubeMX 到 700.89 分
【STM32H5 评测】+ 增加ETH外设和NetX协议栈实验
【STM32H5 评测】+ H5E5专用OLED点亮实验
微信公众号
手机版
值得收藏
按照操作指南操作,disconver后卡死无法disconver使用DA回退,这可能是什么原因导致的