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

经验分享 | STM32CubeMX 生成时钟获取函数的分析

[复制链接]
STMCU小助手 发布时间:2025-7-30 16:49
. G" D, ~/ @  G( ]3 t* d+ L

& ^) C/ M' o. M! b8 c1. 问题
: G* h: A0 C! P9 m( U& ^STM32CubeMX 升级到了 V6.13.0 ,与此同时 STM32Cube_FW_H7 也升级到了 V1.12.0 ,在时钟获取数组的定义中出现了问题,造成的问题现象是串口输出内容乱码,经过和 V6.12.1+ STM32Cube_FW_H7_V1.11.2 生成的代码对比,发现是时钟获取函数的数组出现的问题,修改之后即可正常。% c5 `; [' k# X2 R6 F- S
8 d; n$ y9 W, G8 M( U4 Q

  |* ^. G1 P" a% e2. 如何复现
, Z$ r& g5 \  l) e- L) o在 ST 官网上下载 STM32CubeMX 6.13.0 链接:Here,选择器件型号为 STM32H743ZIT6,使能 USART3 这个外设,选择使用 STM32Cube_FW_H7_V1.12.0 库来生成代码之后,串口打印出来的内容就是乱码。6 R. K$ l+ f! b% G2 F5 g, f

- x1 ?, W  s8 ?8 \2 d4 U2 S" O
6 D3 o) E6 N8 ~1 [
时钟配置如下图 1 所示。6 o; I) V# Q0 J2 c& t" }% @
14.png
图1. 默认时钟配置

; [$ C& @* _; Q+ j  M
2.1. 代码分析" x' ~6 E) d9 \/ y
首先,让我们看一下,不同的版本在生成代码中的主要区别,主要是 D1CorePrescTable 这个数组的内容有变化。
! ]8 P# _( t, q5 u
15.png
图2. 生成代码对比

2 z. H  h9 V; Z6 |

1 {9 [- P. c3 j; H0 X由上图可见,数组 D1CorePrescTable 的【4 : 7】内容由原来的{1,2,3,4}变成了 {0,0,0,0},那么这个数组是做什么用的,又为什么会对串口有影响呢?让我们来分析一下代码。
( _1 N7 k: {0 Z! q9 t: j& C4 n/ g6 b" ]3 }# n
$ w1 {) E$ E& N( d" ~9 I
在串口初始化中有如下调用关系:5 O8 R. t7 ?! X' H. b

( X- S4 ?! d- {+ g7 Z: [

' X/ I( g$ l% X4 k$ d5 S0 ^MX_USART3_UART_Init()àHAL_UART_Init()àUART_SetConfig()àHAL_RCC_GetPCLK1Freq()
) I1 J3 y  p9 G5 Z9 J: f; w" K
16.png
图3. 代码内容

8 Y3 r2 U- r* \# {1 g% g

1 {! q( h2 k# ]由图 3 中的代码,我们可以看到,这里引用了 D1CorePrescTable 的内容,这里是如何引用的呢?其实是比较巧妙的。4 [9 Z" {0 P6 G  N" z; T+ ]1 x

" P5 h' R6 }* V3 `- v& M" K

: d3 x8 p; \9 D# [0 `我们首先看寄存器中是如何配置的。
6 N; I) w) i9 a+ ^/ G; A
17.png
图4. 寄存器描述
2 s6 j  X; T2 D1 A, I( |

/ k- c" S, a1 S& d* z5 _* O' P寄存器中的 D2PPRE1[2:0]是配置 D2 域中 APB1 的分频系数,默认是 0xx,表示不分频;100 是 1/2 分频;101 是 1/4 分频 ; 以此类推。0 R# w) L) Q8 h# T% e  {

+ X' ^) W, W! p
2 O5 y8 G8 ~5 x7 M7 g/ V2 j
在整个时钟树中的位置如图 5 所示4 Q; {' G7 E* N0 ~+ E
18.png
图5. 寄存器在时钟树中位置
! J  R8 I6 c' R& t. G' K

. Y& K( Z0 @, p+ H! Z( y. C回到代码,我们单独截取其中一句话。3 F+ h3 }1 _: b
19.png
图6. 代码详细内容
1 |9 _: R) R: c8 R; c, P9 F
" D* I/ I% t/ h
其中的数值定义如图 7 所示
. }9 p7 @( q1 K4 U& g
20.png
图7. 代码定义内容

) G$ g- B' i$ r& \& b/ |1 g* f8 ~
  _/ G; Z9 S  O
这个地方通过读取寄存器(RCC->D2CFGR 中的 D2PPRE1)的配置,就能得到 APB1总线上的时钟分频参数,其先通过函数 HAL_RCC_GetHCLKFreq()得到系统时钟的频率,再将其进行右移操作(右移 1 位代表除以 2)。具体右移多少位就是通过查找 D1CorePrescTable 这个表来决定的。$ a1 a; \$ J! E7 N8 {

& X  v- [9 N2 v/ [" _( Q+ Y
$ [% W, M. S6 f- N( N
比如,这里如果是 1/2 分频,那么 RCC->D2CFGR & RCC_D2CFGR_D2PPRE1) >> RCC_D2CFGR_D2PPRE1_Pos 得到的结果就是 0b100,再和 0x1FU 进行“与操作”得到也是 0b100,即十进制的 4。通过正确的 D1CorePrescTable 表格,即可得到 D1CorePrescTable【4】=1,(注意数组是从 0 开始的)那么就是系统时钟进行右移 1 位的操作,得到除以 2 的效果。$ t9 H) ~$ R0 w8 V0 |/ M

. ~4 a; c2 M2 l" y" R' o
: d; s- \7 h; |* A4 N
正确数组:const uint8_t D1CorePrescTable[16] = {0, 0, 0, 0, 1, 2, 3, 4, 1, 2, 3, 4, 6, 7, 8, 9};+ R: G3 p6 ?; f! M2 j
- O5 D# B9 s) X% ?" M' `

1 Y9 D% U" E# @5 Z  e  T' D错误数组:const uint8_t D1CorePrescTable[16] = {0, 0, 0, 0, 0, 0, 0, 0, 1, 2, 3, 4, 6, 7, 8, 9};
. c6 M/ `! B( u, k! [5 n
# H# V5 J6 t# ]8 w" Q( L0 ^# n% b0 |

3 s9 i3 _; b  Y* ^+ g& G9 T2 F但是如果是错误的数组,查到的就是 D1CorePrescTable【4】=0,这是不需要右移的,就是没有经过 1/2 分频,显然是不对正确的。0 L3 U# N: K8 e1 h6 z. P

! u9 d6 V: _, o; y% H

+ s7 h: c; i. [& u: z7 ~5 Q' {这里还有个小问题:如果在 APB1 的时钟是没有经过分频的,那么 RCC->D2CFGR & RCC_D2CFGR_D2PPRE1) >> RCC_D2CFGR_D2PPRE1_Pos 得到的结果就总是小于 4 的(即 0xx,具体参见图 4),查表得到的结果就都是 0,也是没有问题的。但是1/2,1/4,1/8,1/16 这些分频系数都会出现计算错误,所以正确的方式就是手动修改这个参数即可解决问题。  h6 a2 A2 M: s* T4 V1 _! @, `
/ I; w: _4 i- E
0 ?( Q7 N% g9 I; l/ H2 t* g% Y
3. 解决问题& r  N! L/ n( `% \! _4 W, `. H
手动修改 system_stm32h7xx.c 中的数组 D1CorePrescTable 中的【4 :7】中数据即可。9 o9 r9 i5 Q. I- Z- Z: Q, X

0 k) K7 \1 o1 D4 c2 w7 A

& R2 w. v2 ]) L! j正确:const uint8_t D1CorePrescTable[16] = {0, 0, 0, 0, 1, 2, 3, 4, 1, 2, 3, 4, 6, 7, 8, 9};2 p) u4 Y, _* }4 {5 r

4 ~3 q% i! {1 R2 e) L- K$ g  m6 @

" W. v7 l/ |1 {$ J9 G7 Y# S/ y同时,提交 bugzilla :197431 (此号码为 ST 内部使用,外部用户无法访问)。
4 S' s. b# A+ D. N/ e" l7 ^; e6 n( _3 q5 u$ k- K0 Z5 B+ t0 G2 `$ A% T
/ I# H7 Z% j, Q; e! z4 |7 f
4. 小结& i0 X, @" S7 b) U1 E( H
这个问题,主要是来自时钟计算所需要的表格出错,造成串口波特率计算出来的结果错误。本文简要分析了数组在查表的方式进行的对应运算关系,并对错误范围做出了解释,未来遇到类似的问题都可以使用此方式进行分析。
3 [: @: Y! w" }' a0 l! Q; S————————————————) K- F$ d: h! R+ w4 a5 [

- b  A5 q0 b! c4 h7 T

0 \2 o! x1 O) J/ o                            ' p  G# V6 b% C5 J0 ^+ ~) ?* Z+ y  t0 ~
; B& |# ~9 ]. U' [; M5 b- v
赞 收藏 评论0 发布时间:2025-7-30 16:49

举报

0个回答

所属标签

相似技术帖

官网相关资源

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