air wish Blog

STM32CubeIDE 的一些使用技巧

探索 STM32CubeIDE 的功能。记录了些基础功能还有方法和技巧等等。

Tech
Published on

来到 RM 之后平台稳定的换到了 STM32。很多 IDE 都支持 STM32 的开发,比较常用的是 MDK 的 Keil,也有用 IAR 来开发的。后来在 ST 官网发现了 STM32CubeIDE,这个 IDE 相当于是 TrueSTUDIO 的上位替代。毕竟是官方出品也整合了 CubeMX 的功能,尝试着使用了一段时间感觉还蛮不错的,就决定一直用下去了。

ST 的 STM32CubeIDE 是基于 Eclipse 开发的。英飞凌的 AURIX Studio 和沁恒的 MounRiver Studio 也都是 Eclipse 修改来的,界面风格比较相似直接上手也不会有很割裂的感觉。Eclipse 方案的优势相对而言是开源免费,并且跨平台方便。劣势是 JAVA 类软件的通病,资源需求比较大。

像 Embedded Studio 这样的新型 IDE 还没来得及去尝试。网页版的 Keil Studio 颜值上来了但还没有离线版如果作为长期使用的 IDE 现阶段多少有些不放心。另外微软官方也下场制作了 Visual Studio 2022 和 VS Code 的方案。相信之后选择会越来越多样的。

22.03.13 好家伙 MDK 推出了个人免费使用版本,只要不是用于商用随便用。登录领 license。 https://www.keil.arm.com/mdk-community/

另外发现 MDK 和 Keil Studio 现在也支持相互导入了。

快捷键

Window > Preferences > General > Keys可以修改快捷键设置。

Help > Show Active Keybindings...可以查看当前可用快捷键。

只列出了常用的几个。另外最好按习惯换一下两个搜索功能的默认快捷键。

快捷键说明
Ctrl+Z撤销
Ctrl+Y重做 (撤回)
Ctrl+Shift+Z重做 (撤回)
Alt+/代码补全
Ctrl+Shift+/批量注释 /* */
Ctrl+F当前文件内搜索(Find and Replace)
Ctrl+H项目内搜索(Open Search Dialog)
F3跳转到声明处
F11启动调试

更好的 SWV 调试支持

SW 调试又称 SWD,还有一种不太常见但是功能更丰富的 SWV 调试。功能上来说 SWV 是 SWD 的扩展,最基本的操作和 SWD 是一样的,只需要额外的 SWO 引脚。

再 CubeMX 中SYS > Debug 选择Trace Asynchronous Sw即可启用。另外需要注意下 SWO 引脚是否会与已配置的引脚冲突。

CubeIDE 对 SWV 仿真的支持比 Keil 要好些。

SWV 支持的扩展功能有很多。向控制台输出信息;变量追踪和绘制;函数耗时占比统计;异常与中断追踪;SWV 追踪日志;RTOS 实时状态查看

这篇文章还蛮不错的 博客配图不方便我就不再写了(逃 https://blog.csdn.net/Naisu_kun/article/details/97393547

另外说一下,正版的 ST-LINK V2 是不支持给开发板供电的。T_VCC 是官方 ST-LINK 特有的引脚,需要将 MCU 电源连接至该引脚,而没有供电功能。反而是长得像 U 盘一样的盗版下载器可以直接供电。

两种编译配置:Release 和 Debug

CubeIDE 在编译是会有两个可选项,Release 和 Debug,这两个其实就是是默认的两种不同的编译配置。这个功能在理解了官方的用意之后会发现其实是非常好用的。

比如我想在测试的时候使用-O0 优化,而在正式发布程序的时候希望以-O3 优化来运行。这样可以在调试时有较好的体验,而正式发布时也有些许的速度提速。

或者是我要在调试的时候多收集信息和数据,而在正式发布时想要精简体积。这样只需要给这两个配置不同的全局宏定义。比如配置宏定义 Test_Mode 在 Debug 配置下为 0 在 Release 下为 1,并使用预编译#if Test_Mode的方式即可完成这个场景。

全局宏定义&添加引用新文件

  • 全局宏定义:右键项目选择 Prorerties ,在弹出窗口的 C/C++ General > Paths and Symbols > Symbols 中即可以添加全局宏定义

  • 添加引用自己的文件:右键项目选择 Prorerties ,弹出窗口 C/C++ General > Paths and Symbols 中的 IncludesSource Location 分页分别为.h 和.c 文件的对应路径。直接添加即可。

    工程名称可以使用${ProjName}代替

  • 注意有两种编译配置,依情况可能都需要修改

启用 assert_param 函数

assert_param 函数用来检查用户输入参数是否正确。HAL 库中的函数大多内部都有 assert_param 函数。默认时 assert_param 没有启用。

开启的方式可以通过修改 CubeMX 设置(不推荐):勾选Project Manager > Code Generator > HAL Settings > Enable Full Assert

更好的方式是只在 Debug 编译配置时启用。assert_param 功能对性能和固件体积影响比较大,所以在正式发布版的程序中建议关闭该功能。

方法就是在项目 Debug 编译配置中的全局宏定义,添加 USE_FULL_ASSERT= 1U

字体相关

  • 显示简体中文:右键项目选择Prorerties ,然后在弹出的窗口选择Resource,修改Text file encodingOther:GBK。GBK 不在下拉列表的选项中的话直接打字上去也是可以的。
  • 更换字体:Window > Preferences > General > Apperance > Colors and Fonts选择Bsaic > Text Fonts再点击右侧 Edit…即可更换。我在使用的字体是更纱黑体 Sarasa Mono HC 12
  • 修复中文字体大小异常:再上面更换字体的窗口,将脚注选择为“中欧字符”即可

自动补全

CubeIDE 本身不带有自动补全功能,需要 Alt+/ 的快捷键才能显示代码补全框。但毕竟基于 Eclipse 也是有插件能解决的。自动补全也是我体感 CubeIDE 优于 Keil 的地方。具体的方法直接在搜索引擎搜索”STM32CubeIDE 自动补全“就能找到解决教程。注意不同的 IDE 版本可能有些许差别。

杂项

不太好归类但是也想要说一下。

  • 编译生成 bin / hex 文件

    默认情况 CubeIDE 编译生成的是 elf 格式的固件。在 IDE 左侧项目资源管理器(Project Explorer)中选择项目,然后右键项目选择Prorerties ,在弹出窗口的 C/C++ Build > Settings > Tool Settings > MCU Postbuild outputs 中即可选中生成 bin 和 hex 文件。

    推荐在上方Configuration中选择 Release。即只在选择 Release 编译配置时才生成 hex,在选择 Debug 编译配置时不生成,以此提高编译速度

  • CubeIDE 不允许同一个工作空间中出现同名项目

  • 编译优化等级设置

    右键项目选择 Prorerties ,在弹出窗口的 C/C++ Build > Settings > Tool Settings > MCU xxx Compiler > Optimization下即可修改优化等级

  • 修改 ROM 起始地址

    修改STM32F407IGHX_FLASH.ldFLASH (rx) : ORIGIN = 0x8000000

  • 开启串口重定向 printf 的浮点数支持

    默认下 printf 只能输出整形。右键项目选择Prorerties ,在弹出窗口的 C/C++ Build > Settings > Tool Settings > MCU Settings ,勾选Use float with printf from newlib-nano (-u_printf float)

  • 另外可以看下稚晖军写的配置 CLion 用于 STM32 开发 https://zhuanlan.zhihu.com/p/145801160


参考链接:

使用 ST-LINK 调试程序

STM32CubeMonitor 介绍(二)例程二:实时波形检测