使用STM32CubeMX和STM32CubeIDE的常见问题和注意事项

STM32CubeMX和STM32CubeIDE是ST公司的STM32Cube生态系统中最重要和最常用的2个软件,使用这2个免费软件可以高效地进行STM32系统的开发。

CubeMX用于对一个STM32器件进行可视化的配置,然后生成CubeIDE或其他IDE项目的初始化代码。CubeIDE可以在CubeMX初始生成的代码基础上进一步添加用户功能代码,实现具体的功能。

新手在使用CubeMX和CubeIDE的过程中,容易范一些错误,或遇到一些问题不知如何解决。本文将这些常见问题整理如下。

(1)安装了错误版本的Java Runtime Environment(JRE),导致生成的CubeIDE项目无法编译

在安装CubeMX和CubeIDE的时候,如果电脑上没有安装JRE,会提示要求安装JRE。现在的Win7或Win10一般是64位的系统,但有的同学在安装JRE时却误装了32位的JRE。安装了32位的JRE后,可以继续安装CubeMX和CubeIDE,但是CubeMX生成的CubeIDE项目在CubeIDE里打开后不能编译,因为生成的项目不完整。

所以,64位的Win7或Win10上,一定要安装64位的JRE。

(2)CubeMX的Repository文件夹使用了默认的路径,导致生成的CubeIDE项目无法编译

有的同学在安装CubeMX后,就立刻安装固件库,而没有打开Update Settings对话框,修改Repository Folder(固件库文件夹),使用了默认的固件库目录。CubeMX安装后,默认的Repository Folder是C盘用户目录下的一个文件夹(与登录Windows的用户名称有关),即“C:User*****”。

CubeMX对中文的支持不是很好,在Windows系统上,Repository文件夹不能有任何汉字、空格等符号。而CubeMX安装后默认的Repository文件夹就是有汉字的,即使登录Windows的用户名称是纯英文。如果使用了默认的Repository路径,CubeMX生成的CubeIDE项目不完整,无法正常编译。

所以,在安装固件库之前,要先打开Update Settings对话框,修改Repository文件夹,如下图,设置一个单独的文件夹,且整个路径上不能有汉字、空格等特殊符号。

如果已经使用默认的Repository目录安装了固件库,那么Repository目录不能再修改,只能卸载掉固件库,卸载CubeMX后重新安装和设置。

(3)CubeMX文件名称需要与最后一级文件夹名称同名,且路径上不能有汉字或空格,否则生成代码不完整,CubeIDE项目无法编译

一个CubeMX项目只有一个.ioc文件,这个文件名必须与最后一级文件夹的名称相同。例如CubeMX项目保存到下面的目录下

D:CubeDemoPart2_PeripheralsChap08TFTLCDDemo8_1TFTLCD

则CubeMX的文件名称必须是 Demo8_1TFTLCD.ioc。在CubeMX里首次保存项目时,就是选择路径,会自动以最后一级文件夹名称命名ioc文件。

注意,保存CubeMX项目文件的整个路径名称上不能有汉字、空格等特殊字符,只能使用英文、数字、下划线等基本字符。否则生成的CubeIDE项目无法正常编译。

(4)CubeMX里先生成了EWARM项目的代码,发现错了,再选择生成CubeIDE项目代码,生成的CubeIDE项目无法编译

在CubeMX里如果没有设置IDE类型,就直接生产代码,这样生成的是EWARM项目,因为默认的IDE选项是EWARM(如下图)。如果发现错了,重新选择STM32CubeIDE再生成一次代码,这样的项目在CubeIDE里打开后是无法编译的。

这种情况下的解决办法是,删除项目目录下除了ioc文件之外的所有其他文件和文件夹,然后在CubeMX里重新生成CubeIDE类型的项目代码即可。

(5)未升级ST-LINK仿真器的固件,导致CubeIDE项目编译后无法下载到开发板

初次使用CubeIDE编译项目,并使用ST-LINK仿真器下载到开发板时,可能会出现提示对话框,说仿真器固件版本低,需要升级固件。有同学不注意看提示信息,不知道升级固件。

出现这种情况时,点击CubeIDE的主菜单项 Help 下面的ST-LINK upgrade,打开如下的对话框。先点击Open in update mode,如果ST-LINK仿真器连接正常,会出现两个箭头所指的版本号。蓝色箭头所指是ST-LINK仿真器的固件版本,红色箭头所指是需要升级到的版本号,如果ST-LINK仿真器的固件版本号低,就需要升级。点击Upgrade按钮就可以升级。

(6)CubeIDE项目编译没错误,ST-LINK仿真器以前是可以用的,但是现在无法下载

出现这种情况时,可能是ST-LINK仿真器与电脑的连接出了问题。点击CubeIDE的主菜单项 Help 下面的ST-LINK upgrade,打开如下的对话框。点击Open in upgrade mode按钮,如果出现最下面的提示信息 ST-Link is not in the DFU mode. Please restart it. 就说明ST-LINK仿真器与电脑的连接出了问题。这种情况下,需要拔除ST-LINK与电脑连接的USB线,然后重新插上就可以了。

(7)在程序文件里写了汉语注释,在CubeMX重新生成代码后,汉语注释出现部分乱码

例如,我们在下面的一个沙箱段内写了代码,并且写了汉语注释。

在CubeMX里做了些修改,重新生成代码,那么,代码中的汉语注释可能出现部分乱码,如下图

在使用独立的CubeMX和CubeIDE时,这个问题目前暂时无法解决。有人说需要将CubeIDE 的文件编码设置为GBK,如下图。但是使用独立的CubeMX导出的文件编码就是UTTF-8,且CubeMX里无法修改编码设置。实际测试中发现,即使将CubeIDE里的文件编码设置为GBK,在CubeMX里重新生成后,还是出现部分汉字注释乱码,且下图对话框中的编码自动更改为UTF-8。

(8)CubeIDE的固件库路径设置

CubeIDE里内置了CubeMX,如果使用内置的CubeMX,也需要设置STM32固件库路径。注意,切换一个新的Workspace后,其固件库路径自动恢复为默认值,如下图。使用这样默认的固件库路径也是有问题的,应该修改。可以设置为独立的CubeMX里的固件库路径,与其共用固件库。

经验分享 程序员 微信小程序 职场和发展