目录前言一、STM32CubeMX是什么二、安装包下载2.1 获取安装包2.2 打开安装包三、STM32CubeMX 首次启动3.1 可能遇到的网络和更新问题3.2 注册账号问题3.2.1 如何注册3.2.2 填写信息3.3 固件包安装与路径配置3.3.1 什么是固件库3.3.2 修改存储路径3.3.3 更新固件库3.3.4 验证安装成功五、使用过程中可能出现的问题总结5.1 v6.18出现的数据更新问题结语 云泽Q个人主页 专栏传送入口: 《C语言》《数据结构》《C》《Linux》《蓝桥杯系列》《笔试算法》《AI赋能》《STM32》⛺️遇见安然遇见你不负代码不负卿~前言大家好啊我是云泽Q欢迎阅读我的文章一名热爱计算机技术的在校大学生喜欢在课余时间做一些计算机技术的总结性文章希望我的文章能为你解答困惑~温馨提示~全文开始之前如果你安装的时候发现安装不了可以尝试使用科学上网开全局模式由于这些都是国外的软件下来需要访问国外的服务器不使用科学上网就有可能出问题一、STM32CubeMX是什么STM32CubeMX一句话总结就是一个帮你自动化生成代码的图形化工具它不是普通的工具它能自动生成项目的“骨架”代码框架我们后续的开发就直接在这个基础上进行二次开发就行不用再从头开始搭架子而且现在做STM32嵌入式开发如果你用HAL库的话CubeMX就是主流中的主流了二、安装包下载接下来说重点——怎么安装这个工具步骤很简单但细节要注意2.1 获取安装包首先得找到官方下载地址https://www.st.com/en/development-tools/stm32cubemx.html点击获取软件就会自动跳转到下面这个地方下载最新版即可且CubeMX支持Windows、macOS、Linux三大主流系统通吃这里如果你是英文也没事也可以参考我的位置下载前两个随便填邮箱填一个有效的邮箱然后按照指示进行操作即可点击之后就会跳转开始下载这是第一次下载的全过程后续如果再下载可能有些步骤会有些变动但影响不大查一查翻译跟着步骤走就行了当然如果实在解决不了也可以加主播V我可以提供安装包2.2 打开安装包好安装包下好了接下来就是安装了跟着我一步步来双击安装包找到你下载的CubeMX安装包比如SetupSTM32CubeMX-6.17.exe双击它启动安装程序然后一直有勾选同意就勾选一直Next创建安装文件夹我的建议是自己创建一个文件夹来放这个软件默认即可等它安装完成即可安装完成检查安装好后桌面会出现一个CubeMX的图标双击打开试试能打开就说明成功也可以去你的安装目录比如D:\STM32CubeMX看看里面就是CubeMX的所有文件三、STM32CubeMX 首次启动3.1 可能遇到的网络和更新问题首次启动可能会出现这样无法退出的问题这其实是CubeMX在首次启动后启动了一个检查更新的任务检查当前软件内部的一些数据以及一些配置信息是否需要更新若是需要会在线进行更新该软件在设定上就是更新期间禁止关闭这时候就需要等一两分钟再关闭如果还是不可以的话可以点击右边的蓝色按钮CHECK FOR UPDATES,此时应该还会报错但是没事再等一两分钟这样反复点击等待退出一般该蓝色按钮CHECK FOR UPDATES变灰色了就可以退出了如果上述方法尝试后你一直无法退出还有方法的更新是必定会连接后台意法半导体的相关服务的可以点击Help确认一下如果外面页面的蓝色按钮CHECK FOR UPDATES一直为绿色就可以检查红框中的Check Connection如果你的Check Connection是一个红色的×点击它让它检查一下和后端服务的连接情况如果由红色的x变为绿色的√那就可以了。如果还是不行就多点击几次直到变为绿色若是一直不对那就上面红框标选的三个选项与服务器的连接方式轮流选一下然后再点击Check Connection直到变为绿色的√为止我们最终要达到的效果就是要Check Connection变为绿色√外面主页面的CHECK FOR UPDATES变为灰色只有第一次可能会有这种情况往后大概率就没有了3.2 注册账号问题这是意法半导体ST的官网https://www.st.com.cn/content/st_com/zh.html为什么要讲这个呢因为现在使用 STM32CubeMX如果你要进行后续安装固件的操作必须得有一个意法半导体的官方账号。当然现在不自己下载固件库也可以你以后使用的时候在STM32CubeMX软件内有时候点击一些东西比如创建一个项目或选择一个MUC的时候也会提醒你下载固件库但是这里还是建议学习主动下载一下整个软件的逻辑你才清楚这里我得稍微吐槽一下 ST 的这个软件策略变化。以前用 CubeMX 下载固件库是不用登录的直接就能装。后来改过一次变成必须注册登录才能访问。到了现在呢不仅得登录还得做一步邮件确认。虽然你不做邮件确认稍微等一会儿可能也能登录操作但为了让大家“知其然知其所以然”咱们还是把路走完整把这个流程跑通。3.2.1 如何注册进入官网后之前为了方便安装CubeMX是采用游客的方式去安装没有注册相关账号现在就绕不开了点击右上角的那个“人头”图标。如果你是老用户直接 登录如果是新用户点击右侧蓝色的“创建账户”创建账号。3.2.2 填写信息点进去之后你会发现要填的信息看起来挺多但这里面有一部分信息其实是可以“灵活”填写的称谓、名、姓这个你自己随便写写个简称或者拼音都行不影响使用。电子邮件重要这个必须填真的一定要填你能收到的邮箱比如 163 或者 QQ 邮箱都可以。因为后面我们需要用它来接收验证邮件。其他信息职位、公司/大学等如果没有特定的也可以适当简化填写只要能把号注册下来就行。点击注册之后成功了就会显示该页面去邮件激活一下即可密码设置好之后提交即可然后会跳出一个窗口点击后就可以去意法半导体官网登陆了该账号注册好后该账号就可以登陆意法半导体的中文或全球官网包括之前文章看MCU的官网3.3 固件包安装与路径配置账号注册好之后我们正式进入 CubeMX 的软件设置环节。这一步非常重要因为它决定了你以后建工程顺不顺利。3.3.1 什么是固件库在动手下载之前我得先给大家解释一下我们费劲巴拉下载的這個“固件包”到底是个啥大家可以把固件库想象成我们写 C 语言程序时的“标准库”或者“工具包”。包含内容它里面包含了 STM32 芯片所有的外设驱动代码比如 GPIO、UART、SPI 怎么控制也就是我们常说的HAL 库源代码。作用当你在 CubeMX 里勾选了一个功能比如点亮一个 LED软件会自动去这个固件库里找对应的代码复制到你的工程里。结论如果没有这个库CubeMX 就是个空壳生成不了代码。所以我们必须把它下载到本地电脑上。3.3.2 修改存储路径默认情况下CubeMX 会把固件库下载到 C 盘的用户目录下。这里有个大坑如果你的电脑用户名是中文或者路径里包含中文字符CubeMX 很有可能会闪退或者报错我们未来下载的固件库默认在该路径下每一个人路径不同但是相似强烈建议不要放 C 盘把它放到非系统盘比如 D 盘。纯英文路径文件夹名字一定要用英文不要有空格或中文。独立存放最好单独建个文件夹别和软件安装目录混在一起。可以STM32CubeMX默认是把固件库和软件本体分开装的我们也建议和官方一样虽然改固件库的位置但是不要和软件装在一起新建一个文件来装这样改好点击OK即可大家就可以参考一下我安装软件的命名这样就非常规范不会出错而且自己也可以轻松找到固件库3.3.3 更新固件库路径设好后我们就可以开始下载了。这里有两种更新固件库的做法方法一方法二不光方法一还是方法二都会到达该界面找到你使用的芯片系列比如我们是 F1 系列就展开STM32F1。你会看到很多版本1.8.5, 1.8.6, 1.8.7…。原则是选最新的勾选最新版本前面的复选框。点击右下角的Install。这时候会跳出页面让你登陆账号就是刚刚在意法半导体注册的账号把注册意法半导体用的邮箱填进去即可其他随便填写即可然后就会给你发一个验证邮件也有可能不会发我这里是没有发的点击close或者处理了验证邮件之后就会开始下载至此我们固件库的安装就彻底完成了可以看到固件库安装完成后这里的图标也变为了绿色如果想删除该固件库点击绿色图标右小角Remove就会高亮点击即可删除该固件库未来我们就可以点击这里来新建项目期间会弹出一些更新服务弹出这个界面就说明我们所有的操作都结束了3.3.4 验证安装成功下载完成后你可以去刚才设置的 D 盘文件夹里看一眼。你会看到类似STM32Cube_fw_F1_V1.8.7这样的文件夹。这就说明我们的准备工作彻底完成了,以后新建项目CubeMX 就会自动调用这里的代码。该路径下就包含着HAL库中的源代码D:\STM32CubeMX_Repository\STM32Cube_FW_F1_V1.8.7\Drivers\STM32F1xx_HAL_Driver\Src好了到这里环境搭建最繁琐的一步我们就搞定了。后面就不会这么麻烦了五、使用过程中可能出现的问题总结5.1 v6.18出现的数据更新问题在数据更新过程中STM32CubeMX 会显示下载错误提示框。这也是我今天使用发现的我记得在v6.17是没有出现过这样的问题的看到一些用户说现在回退到v6.17也会有这样的问题我没有做尝试在查阅了大量官方资料之后基本可以证实该问题应该是软件这次更新后出现的下图是官网相关人员的讨论想要完全解决这个问题是需要官方他们自己修复的但是也是有一个初步解决办法虽然但是该问题并不会妨碍 STM32CubeMX 的正常使用弹出第一张图的错误提示窗口后点击两次窗口继续正常使用即可如果这个弹窗影响了你的工作流程需要禁用“自动刷新”功能在“help”→“Connection and Updates”选项中选择“No Auto- Refresh at Application start”请注意如果禁用了“自动刷新”功能STM32CubeMX 将使用本地的cube-finder-db.zip文件而不会自动获取更新。如有需要后续可手动更新数据官方已经搁置了这个问题半个多月了我估计该问题会在下版本解决这是解决方法出处来自意法半导体官网想要打开需要科学上网https://community.st.com/stm32cubemx-mcus-29/workaround-for-file-download-error-crdb-zip-problem-during-download-166762结语