# H; j$ C3 J# a/ m( K- |01引言
% T. y1 r5 U- a' _- Z2 k使用 STM32 进行项目开发时，在原理图和 PCB 设计中都需要使用相应的元件封装 库。STM32 元件封装库的准确性是保证设计成功的前提。
在最新版本的 STM32CubeMX 中内置了 STM32 元件封装的下载工具，下载的封装库 文件经 EDA 工具转换后可以在原理图和 PCB 设计中调用。
本文将对如何下载和转换做简单的示例说明。
# Z. ]' N4 |: g( \  U
01在 STM32CubeMX 中下载 STM32 封装文件

, `0 k8 Q! }/ a: S
下面我们以 STM32H503CBT 为例简单介绍下如何在 STM32CubeMX 中下载 STM32 MCU 的封装库文件。
打开 STM32CubeMX（本例中使用 Version 6.9.0）后，选中所使用的 STM32 型号 后进入配置页面。
根据电路的需求，分配相应的功能给 STM32 的管脚。（如果不需要在原理图 STM32 封装库中显示管脚所分配的功能，这一步可以忽略。）
2 B7 U$ @* n% _. W9 z& P5 @这时，我们将见到如下图所示的元件示意图：

& Q2 q9 l! @8 o4 j8 |6 n' j

▲ 图1. CubeMX 中的 STM32H503CVTx
点击上图右上角的 Tools 菜单栏。进入 Tools 界面后点击左边的 CAD 菜单，进入 CAD 元件封装库配置和下载页面。

  e0 h8 O' l" ]/ A

' R9 V' W  @3 ?+ i3 F" y# ^) A% B' w

▲ 图2. CAD 元件库界面
- }: e0 w" P8 K5 x) M6 X

2 z4 S& T/ f" ?6 U6 V然后根据硬件设计中使用的 EDA 工具在下图选项框中选择 CAD 文件格式：

- [# i5 X$ M; g' `- o5 S

▲ 图3. CAD 格式选择
可以选择的 STM32 元件库封装格式支持主流的 EDA 设计工具，包括 PADS, Altium Designer, Cadence 等等。这里以 Altium Designer (AD) 和 Pads 为例，可以看到将要 下载的工具格式被列出在下载格内，且支持一次性多格式下载：

▲ 图4. 选择不同格式工具下载

0 a- j, F& T% [$ M' h
从 CubeMX 下载得到的 STM32 CAD 文件是基于 Ultra Librarian 工具在云端生成 的，这里我们需要勾选同意 Ultra Librarian 的条款和条件，不需要再下载安装 Ultra Librarian 工具。

▲ 图5

: ]; F: u9 D' |9 F3 K) w9 N+ M2 p
在页面的右上角有个选择按钮可以用来选择管脚名的显示方式：

' _% @# X3 s* d' W7 [2 }

. x) t! Q8 n' A( e  m( d! D3 `5 s/ w0 ]4 @; g

▲ 图6
" a* n* t5 `* W当选择 Pin name 时，原理图封装库中管脚名按封装名显示：

" W# G+ {6 P* i* L. Q2 e+ R2 s

▲ 图7. Pin name
如果选择了 Project naming, 管脚名按分配的功能名称显示：

3 _# c( f* }5 x* _+ Q

▲ 图8. Project Name
0 \2 m7 r' H7 }$ U, w8 E4 \+ G; m

选择 Dual 则管脚名和功能名都显示：

7 Y+ Q7 Z1 Z8 R4 U! U

▲ 图9. Dual
更改上述的管脚名显示等选项后，点击 Refresh symbol previews 按钮可以刷新显示。

+ r. o7 Z+ v% @5 h# [9 t6 ]$ q

' L& m* ~/ {) ]6 W* g

▲ 图10. 下载和刷新菜单
: m+ R7 W' q$ d& n9 {

在 PCB 封装库的 Footprint 显示下面有 Basic 和 Detailed 两种显示，Detailed 显示 比 Basic 显示多了一些尺寸标注：

% `1 o$ l* \; w/ A

& s2 T3 q0 u$ D

▲ 图11. Basic 和 Detail 显示

  m4 [- j# N* y
最后我们点击图 10 所示的下载菜单下载库文件。
% p: r! A9 `  t( j/ [如果选择了管脚名的功能定义显示， 可能会先弹出一个警告信息：因为工具不支持一 些特殊的字符，这些字符会被替换：

: I! _% B; n  k9 x% J

▲ 图12. 特殊字符替换警告
$ P( F1 g2 j& a3 s  x0 o1 v+ L" L忽略这些信息，点击 Download anyway。等待，此时 Refresh symbol previews 下 的状态条会抖动， 过一会将显示：

▲ 图13. 选择目标目录下载
选择将文件保存到电脑目标地址即可。
( \: R/ i* C3 d  f- E$ M5 F
03在 EDA 工具中导入封装文件生成封装库
& h( M- P1 s7 i% H# t
) Y3 O7 R0 J" e+ d( T8 Q6 l" T0 z+ @
下载下来的 UL 生成文件并不是 EDA 工具可以直接使用的封装库文件，而是一些中间 文件， 必须在 EDA 工具中导入转换后才可以被 EDA 工具使用。下面我们以最常用的 Altium Designer 和 PADS 为例来说明这一过程。
! s, X- N% y7 g

3.1. 在 Altium Designer 中生成封装库
: j* c9 v& V2 O, m# j5 U
, g; r% @" \4 x. n  G- E3 J) A
8 s; a" I6 Y9 g% t( t" z. t我们使用 Altium Designer 22.9 来演示如何从 CubeMX 下载的文件生成库文件，不同版本的 AD 工具导入过程可能略有差异。
解压刚才从 CubeMX 下载的压缩文件，在 AltiumDesigner 目录下我们可以看到共有 6 个文件：

& Z% k2 ?) P9 S2 V

▲ 图14


打开 AD 软件，在菜单栏打开 File --> Open 后找到解压文件中的.prjscr 工程文件打开

▲ 图15. AD 打开工程文件
工程打开后如下图：

▲ 图16. 打开后的工程
3 N$ j; e, o# @+ q, Z接着运行脚本，File --> Run Script…

0 ~( X% D/ E* _6 v

▲ 图17. 运行脚本
3 O0 J) A6 k) D: P. V在弹框中选择 UL_Form.pas 后点击 OK 运行。

9 n# f) p% j. I; H9 ^

▲ 图18. 选择文件运行脚本
紧接着会生成另一个弹窗，选择导入刚才解压的 UL 生成的 TXT 文件，点击开始导入：

图19. 选择 TXT 文件后导入
等待一会可以看到库文件已经生成：

图20. 生成的 LibPkg 文件 生成的.pcblib 库文件需要关闭 AD 再重新打开后才能正常检视/使用。图21. 生成的库文件 3.2. 在 PADS 中生成封装库 打开下载的 PADS 封装导入文件，可以看到压缩包内有三个文件：图22. PADS 的库导入相对简单，打开 PADS Layout, 点击菜单栏 File --> Library, 弹出元 件库管理框 Library Manger：图23. 元件库管理器
* ^  f/ |7 d& U  p# h在元件库管理器框中依次选择: Decals --> Import 导入 pads.d 文件 如图 24 Parts --> Import 导入 Pads.p 文件，如图 25 Logic --> Import Pads.c 文件， 如图 26 导入后点击 Open 即可生成对应的库文件。
* S0 t7 K# ~9 Y9 F/ ]' ^+ b% e图24. 导入 Decals 封装
图25. 导入 Parts 库
# B9 z4 V( |. ?- p% j3 s图26. 导入 Logic 库 图27. 生成的原理图封装库
  f0 \' V3 e) m8 y. r% \图28. 生成的 PCB 电气封装库

2 s8 _' Z* F; F$ P7 j04小结
. F* U) p  m+ `使用 STM32CubeMX 下载得到的元件封装可以让工程师从繁琐的元件封装库设计中解放出来，特别是当管脚数目较多时。很多用户对原理图封装库的外形，尺寸，管脚排列/命名，功能排列等方面，以及对 PCB 封装的焊盘大小，阻焊设计，字符标注等方面有特别的要求，下载的文件效果可能不 能全部满足要求。这些客户可以在下载的文件上做适当的修改。这样可以避免全新设计封 装库过程中可能发生的各种错误，特别是常发生的 PCB 封装尺寸中的错误。

: Q* G0 w" {- J" @8 O+ X5 A

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

这个好，越来越方便了

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