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

st-img
chrome st-img
firefox st-img
safari st-img
ie8及以上

实战经验 | 从CubeMX下载生成STM32元件封装库

[复制链接]
STMCU-管管 发布时间：2024-10-24 08:22
* k# j% q) `( x# g: S' G+ }* N
/ I! I7 [4 L* u7 i" J4 n* X

. S. m6 k% D5 R+ L( I01引言 % Q- B& j/ _/ H! V! G' J
使用 STM32 进行项目开发时，在原理图和 PCB 设计中都需要使用相应的元件封装 库。STM32 元件封装库的准确性是保证设计成功的前提。9 }( Q4 l. ?, G" j
在最新版本的 STM32CubeMX 中内置了 STM32 元件封装的下载工具，下载的封装库 文件经 EDA 工具转换后可以在原理图和 PCB 设计中调用。" C/ ~: b! Q  e. S% p
本文将对如何下载和转换做简单的示例说明。
7 t& C% y- j8 E! _  D9 l$ _. k3 A$ v# \2 X1 D$ n: o$ @& l
01在 STM32CubeMX 中下载 STM32 封装文件 8 U! G: o# j6 q7 d9 T* ?* D
5 H5 H& y$ G# M& A

0 {4 _* C& D% E1 F  F下面我们以 STM32H503CBT 为例简单介绍下如何在 STM32CubeMX 中下载 STM32 MCU 的封装库文件。
4 Y" A0 o4 }( Z7 \8 F. N打开 STM32CubeMX（本例中使用 Version 6.9.0）后，选中所使用的 STM32 型号 后进入配置页面。4 j! ?" j9 G9 m' K' _
根据电路的需求，分配相应的功能给 STM32 的管脚。（如果不需要在原理图 STM32 封装库中显示管脚所分配的功能，这一步可以忽略。）& V( }; T8 t, Y7 F4 r
这时，我们将见到如下图所示的元件示意图：
0 X) V" ?$ Y+ Z1 I0 j' D7 k3 H( Q
12.png

( z- X- ^0 s: @! i. ~' v4 `: A
▲ 图1. CubeMX 中的 STM32H503CVTx5 I# Y8 N% C7 `; _7 w3 m
点击上图右上角的 Tools 菜单栏。进入 Tools 界面后点击左边的 CAD 菜单，进入 CAD 元件封装库配置和下载页面。

7 N1 c1 A, K& ?$ ~, s
13.png

% k! X6 T' x4 k/ ], @
▲ 图2. CAD 元件库界面0 V  _% y1 d6 |2 r5 J) ^5 ^8 k* Y
8 G# b6 E# |  {' B" [

+ G" ?% w5 b" x* d5 z2 g' N  d4 @然后根据硬件设计中使用的 EDA 工具在下图选项框中选择 CAD 文件格式：
- c4 G, y7 X& J! {) ]% _) ]  `+ s! H; u; T3 ]% }% o

$ r5 g0 d0 @8 N/ u  H- [
14.png

* _! g( H6 V6 t
▲ 图3. CAD 格式选择8 B1 c: a9 J4 h* z+ @, B: P
可以选择的 STM32 元件库封装格式支持主流的 EDA 设计工具，包括 PADS, Altium Designer, Cadence 等等。这里以 Altium Designer (AD) 和 Pads 为例，可以看到将要 下载的工具格式被列出在下载格内，且支持一次性多格式下载：

# ?/ K0 p9 W  G
15.png

6 m+ B4 c8 n3 U
▲ 图4. 选择不同格式工具下载 - ]. y. y; [) I3 o8 b$ b
  U8 J/ v* O& a
& K- A' S4 ]. ^, C6 e+ N# H9 b
从 CubeMX 下载得到的 STM32 CAD 文件是基于 Ultra Librarian 工具在云端生成 的，这里我们需要勾选同意 Ultra Librarian 的条款和条件，不需要再下载安装 Ultra Librarian 工具。

5 h6 ^1 J, V; d/ x4 f
16.png

6 @2 N( I% `" T! e$ y
▲ 图50 n+ w% ]$ l8 U8 g. N9 f
7 u9 ~% [/ B* T+ }) N1 a1 v
6 M: b  ]8 V# z1 i3 ^
在页面的右上角有个选择按钮可以用来选择管脚名的显示方式：
! I  t6 u- \$ U2 W% F) K) C
17.png

* a1 R" V% r3 ^& {3 N- J$ @
▲ 图68 H! M5 f+ K0 |0 ]. f
当选择 Pin name 时，原理图封装库中管脚名按封装名显示：
# y3 z9 D9 p6 [
18.png
- h( l* @2 j) o4 T! w$ B
▲ 图7. Pin name7 {0 Q' X  Q9 L  l6 h* Q
如果选择了 Project naming, 管脚名按分配的功能名称显示：

# o! L  a! s# {1 O' `1 h
19.png

* T4 y1 G  k; |
▲ 图8. Project Name
# W7 K0 h$ w6 G- q& L! }/ r
& m0 }/ ?+ L% x* v: P6 Z% ]9 N; R
选择 Dual 则管脚名和功能名都显示：
, a! w6 U! `2 {  ^" `' t$ G% j
20.png
& D: |/ V3 l) t, y3 @- S' K
▲ 图9. Dual6 M) [9 N$ o+ `, U! J2 f
更改上述的管脚名显示等选项后，点击 Refresh symbol previews 按钮可以刷新显示。

8 [7 _; h+ m( f  q3 v% H' m6 G' w
21.png

- H" Q! i! p, g: B1 W
▲ 图10. 下载和刷新菜单 9 C# v* V8 R% s7 Q1 M
% n9 D& Z7 w% w- [8 l3 V/ n
, p3 h% e. C8 I; ]- [  b5 s- r/ ^
在 PCB 封装库的 Footprint 显示下面有 Basic 和 Detailed 两种显示，Detailed 显示 比 Basic 显示多了一些尺寸标注：

4 t0 p. g6 y: R* a4 _
22.png
1 O' B* m5 h" j3 H
▲ 图11. Basic 和 Detail 显示
! U9 C9 E; k4 V0 H% Z* q' J% g: m" s$ o* b/ p* d+ b
" \: \) t4 N9 f+ R) `& W
最后我们点击图 10 所示的下载菜单下载库文件。
; V7 q7 Z4 A, M, y  G" j% a: k# @如果选择了管脚名的功能定义显示， 可能会先弹出一个警告信息：因为工具不支持一 些特殊的字符，这些字符会被替换：

! }' o3 q: l* w; F( \
23.png

. s! ]8 X: S  I: z
▲ 图12. 特殊字符替换警告 ' w  O! }; a' x$ A( P6 u6 J$ _0 S5 L5 h
忽略这些信息，点击 Download anyway。等待，此时 Refresh symbol previews 下 的状态条会抖动， 过一会将显示：

! }7 h7 N- x; R* c1 u
24.png

% t- R& V' V8 F4 |
▲ 图13. 选择目标目录下载 6 N0 A0 b3 n8 Y+ M. F) {
选择将文件保存到电脑目标地址即可。
/ r, Q. c2 N8 z$ F- W: {" m$ c4 B
- m2 r6 c& ^% ~03在 EDA 工具中导入封装文件生成封装库 + P( B- O) J& y. K& L% _# u
2 ^8 ^' E. L2 Q

0 V" u$ [$ ~$ ^2 M% z下载下来的 UL 生成文件并不是 EDA 工具可以直接使用的封装库文件，而是一些中间 文件， 必须在 EDA 工具中导入转换后才可以被 EDA 工具使用。下面我们以最常用的 Altium Designer 和 PADS 为例来说明这一过程。
% d$ B. ?! Q& b# x6 p/ [; O
4 ?( R% W$ o0 o* F  b4 ?+ p# K/ p& U5 Q
3.1. 在 Altium Designer 中生成封装库 # U6 h4 m3 p/ P$ q3 [. y) d

9 f' M! V3 _8 X, G
4 ?+ T0 s2 J) H  e! y4 n: n/ d我们使用 Altium Designer 22.9 来演示如何从 CubeMX 下载的文件生成库文件，不同版本的 AD 工具导入过程可能略有差异。6 A2 g& w/ A8 z/ x$ S* G& ]9 t, d
解压刚才从 CubeMX 下载的压缩文件，在 AltiumDesigner 目录下我们可以看到共有 6 个文件：

' M( n9 F, b- C6 |$ {
25.png
; d2 k$ Z7 e- G/ }8 n0 I# f
▲ 图14
6 S5 e9 z5 e% S9 q4 z* s4 S! J+ L& S, r: W: ^& c
1 l* t/ i+ f7 \$ X$ F4 e; j* @' q
打开 AD 软件，在菜单栏打开 File --> Open 后找到解压文件中的.prjscr 工程文件打开

2 x6 [1 h' p8 \; H8 u( N
26.png

8 L# V# R; [% z
▲ 图15. AD 打开工程文件; {4 S0 o* B/ K
工程打开后如下图：
! L  G% u; @- O" l& P1 i
27.png

0 s+ S% \; J0 x. I# A# K
▲ 图16. 打开后的工程
+ {# Z9 Z4 R; R  i接着运行脚本，File --> Run Script…
3 V5 c. D% j: j; Q( j
28.png
2 C$ |! B0 p6 \+ S
▲ 图17. 运行脚本
2 H5 b9 `# Y$ B2 ~- _! h( F1 i1 G在弹框中选择 UL_Form.pas 后点击 OK 运行。

. E4 G) Y" j2 B" J" q
29.png

; t# U2 q5 y" P: a* L* r
▲ 图18. 选择文件运行脚本
0 w6 @+ d9 O3 _: [7 C0 o6 H紧接着会生成另一个弹窗，选择导入刚才解压的 UL 生成的 TXT 文件，点击开始导入：
0 |9 _+ c1 L. ?- L4 Y# t$ e; Z
30.png
; s# |7 ^4 z6 k$ ~7 o/ u2 N
图19. 选择 TXT 文件后导入
- h6 t  j6 c; M3 n. K. _等待一会可以看到库文件已经生成：

5 D7 S, g9 ?2 B2 b! A7 {: C# _4 b
31.png ( I/ N6 {, {" @
图20. 生成的 LibPkg 文件 生成的.pcblib 库文件需要关闭 AD 再重新打开后才能正常检视/使用。图21. 生成的库文件 3.2. 在 PADS 中生成封装库 打开下载的 PADS 封装导入文件，可以看到压缩包内有三个文件：图22. PADS 的库导入相对简单，打开 PADS Layout, 点击菜单栏 File --> Library, 弹出元 件库管理框 Library Manger：图23. 元件库管理器* R5 Z0 K2 X" u- u
在元件库管理器框中依次选择: Decals --> Import 导入 pads.d 文件 如图 24 Parts --> Import 导入 Pads.p 文件，如图 25 Logic --> Import Pads.c 文件， 如图 26 导入后点击 Open 即可生成对应的库文件。
5 y# R8 s; D0 S1 y5 E& y; g' ~2 s图24. 导入 Decals 封装 , S/ s6 L7 Q+ e+ C0 ^% z
图25. 导入 Parts 库
4 K; E" Y! E, A, Z% R9 v图26. 导入 Logic 库 图27. 生成的原理图封装库  {! i  Z) a1 Y2 y' }
图28. 生成的 PCB 电气封装库 ( M" |4 S% R: X

- y  \2 ]' d7 E3 e% l# q- }& C1 S04小结
% a) e% I* V" X: ~7 r: Y使用 STM32CubeMX 下载得到的元件封装可以让工程师从繁琐的元件封装库设计中解放出来，特别是当管脚数目较多时。很多用户对原理图封装库的外形，尺寸，管脚排列/命名，功能排列等方面，以及对 PCB 封装的焊盘大小，阻焊设计，字符标注等方面有特别的要求，下载的文件效果可能不 能全部满足要求。这些客户可以在下载的文件上做适当的修改。这样可以避免全新设计封 装库过程中可能发生的各种错误，特别是常发生的 PCB 封装尺寸中的错误。

" F( L0 V+ R. i0 H1 m
赞 收藏 评论3 发布时间：2024-10-24 08:22

举报

3个回答
LTLT 回答时间：2024-10-24 09:44:57

可以可以，其实文档啥的都能在 CubeMX下载

赞 评论
STMWoodData 回答时间：2024-10-24 09:46:51

这个好，越来越方便了

赞 评论
科 回答时间：2026-1-15 19:15:05

stm32cubeMX 2.0 可以直接生成AD元件和封装了

赞 评论

所属标签

STM32团队

STM32团队

意法半导体微控制器和微处理器拥有广泛的产品线，包含低成本的8位单片机和基于ARM® Cortex®-M0、M0+、M3、M4、M33、M7及A7内核并具备丰富外设选择的32位微控制器及微处理器。关注该话题即可发布文章！

最新内容

相似技术帖

官网相关资源

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