经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置：技术经验 » 其他 » 计算机硬件 » 查看文章
STM32开发环境配置记录——关于PlatformIO + VSCode + CubeMX的集成环境配置
来源：cnblogs　　作者：charliechen114514　　时间：2024/7/29 9:30:46　　对本文有异议

前言

? 为什么配置这样的一个环境呢？鄙人受够了Keil5那个简陋的工作环境了，实在是用不下去，调试上很容易跟CubeMX的代码产生不协调导致调试——发布代码不一致造成的一系列问题。CubeIDE虽说不错，但是它的代码辅助功能和构建系统实在不敢恭维，经常出现Makefile未同步导致符号定义冲突，亦或者是埋下了潜在的程序bug。

? 也有人尝试使用Keil Assistance + VSCode + Keil分工写代码与烧录，这听起来不错，但是调试并不方便，常常要来回奔波，实在是有些麻烦。这里我们尝试新兴的PlatformIO来辅助我们进行嵌入式的开发。

介绍

PlatformIO

Your Gateway to Embedded Software Development Excellence — PlatformIO latest documentation

? Platform是基于VScode文本编辑器，使用了vscode强大的扩展extension功能，使得开发者可以在vscode中直接调用gcc、jlink、gdb等进行开发、调试。PlatformIO只是一个集成开发环境，其本身几乎不包括任何实质性功能，但是其集成了很多了例如编译器、调试器等，主要包括以下：

  • vscode
  • gcc编译器，版本：arm-none-eabi-gcc （针对arm内核嵌入式设备的专属c语言编译器）
  • arm-none-eabi-gdb调试器
  • jlink 驱动
  • Scons构建工具、

? 也就是说，PlatformIO就是一个类似于Keil, STMCudeIDE那样的工作环境，它本身不负责进行编译，上传，调试测试等，但是它封装了我们常见的arm-noeabi-系列工具，省去我们学习纷繁复杂的配置语法，统一成PlatformIO的配置语言，这样我们就可以通过写PlatformIO的配置语言来辅助构建我们的嵌入式程序。

STM32CubeMX

STM32CubeMX - STM32Cube initialization code generator - STMicroelectronics

? STM32CubeMX 是用于 32 位 ARM Cortex STM32 微控制器的图形工具。它允许对 STM32 微控制器和微处理器进行非常简单的配置，生成初始化 C 代码，还可以通过一步一步的操作为 Arm Cortex-M 内核或 Arm Cortex-A core 生成部分 Linux 设备树。它是 STMCube 生态系统的一部分，且可以作为独立应用程序或作为 Eclipse 插件集成在开发环境（STM32CubeIDE）中。
? 它能做到的事情很简单了：那就是将我们配置嵌入式设备的流程从代码配置走向GUI配置，点点摁扭，就可以生成一系列初始化的代码辅助我们完成繁琐的初始化任务

Visual Studio Code

Visual Studio Code - Code Editing. Redefined

Visual Studio Code 是一个轻量级功能强大的源代码编辑器，支持语法高亮、代码自动补全（又称 IntelliSense）、代码重构、查看定义功能，并且内置了命令行工具和 Git 版本控制系统。适用于 Windows、macOS 和 Linux。它内置了对 JavaScript、TypeScript 和 Node.js 的支持，并为其他语言和运行时（如 C++、C#、Java、Python、PHP、Go、.NET）提供了丰富的扩展生态系统。为了不影响读者的沉浸式阅读学习，如需使用目录请在左侧使用即可。

正文

? 我们下面来以STM32F103ZET6为目标单片机，实现一个简单的点灯任务！来看看我们如何进行工程配置。

使用STM32CubeMX生成PlatformIO可以支持的Makefile文件

? 我们的初始化代码是由STM32CubeMX生成的，这里我们完成这些配置：

关于如何下载安装STM32CubeMX不是本文的重点，请看官另行百度

点击画圈的地方选择目标嵌入式设备

锁定目标板子（↓）

这里我收藏了常用的板子，所以可以很快找到，没有的看官搜索板子的型号就好

点击目标板子的栏目，就看到我们熟悉的界面了。

1. 选择目标引脚并配置

? 我们需要选择目标引脚然后完成相关的配置，笔者这里选择了我这块开发板上的PE5引脚来驱动连接上的单片机，引脚的配置需要结合硬件电路进行选择

? 在这里，本人设置了：上拉输出，高速模式

2. 配置时钟树

? 我选择了使用外部晶振时钟，配置为72MHz

3. [关键！调试则需要：]选择调试器类型

? Serial Wire是笔者选择的，我的手头只有STLink可以使用，如果看官有的是JLink调试器，请根据

STM32-HAL库CubeMX中的SYS配置选项_cubmx不配置sys debug-CSDN博客

? 做出相关的选择！这一步相当关键！

4. 选择对应的目标IDE配置代码与文件

? 看官自行设置好项目名称和项目存储的文件夹，两者将会在后面的PIO配置中使用到！请高度关注！

TIPS: 如果看官不想拷贝所有的库文件，可以在Code Generator那一栏中选择相应的配置：

下面我们生成代码


? 可以看到所有的必要底层库文件都得到了拷贝，下面我们转战VSCode + PIO

使用PlatformIO搭建我们的STM32开发环境

? 打开VSCode，PlatformIO在Plugin Market里下载。

? 看官先点击下载之，泡上一杯咖啡吧，下载很慢的！（笔者这里下载过了）安装结束之后，你的左侧工具栏会出现这个

? 点击一下：

? 这就是PlatformIO!我们下面可以将我们的STM32生成的代码跟PIO对接。点击新建工程：

里面需要填写的项目我一个个说：

  1. 工程名称：跟CubeMx你填写的项目名称要完全一致
  2. 目标板子：跟CubeMx型号一致
  3. 框架：这个是说的是如何进行读取行为，我们使用的是CubeMX的生成代码，所以目标框架我们采用的是STM32Cube
  4. 位置Location:先把Default Location给删掉，我们需要选择在刚刚在CubeMx下选择的文件夹，可以看到我们在刚刚笔者选择在了D:\MDK5 Project\CubeMx Trainingg\demo_下，所有的代码都继续生成在了D:\MDK5 Project\CubeMx Trainingg\demo_\${ProjectName}\下方，我们在PIO下的目录就选择到D:\MDK5 Project\CubeMx Trainingg\demo_这个位置，这是因为他也会生成${ProjectName}\...文件夹，我们这样做是为了让PIO生成的文件和CubeMx的文件生成在用以项目根目录下，方便我们的书写和文件读取

? 点击Finish到这里之后，第一次下载的朋友将会下载相关的工具链，笔者当时下载了长达小半个小时，请各位看官稍有耐心，可以出去散散步！之后等到工具链配置结束之后，生成工程就是一刹那的事情。

? 现在生成结束了！

? 我们下面来看看platformio.ini文件。

  1. ; PlatformIO Project Configuration File
  2. ;
  3. ;   Build options: build flags, source filter
  4. ;   Upload options: custom upload port, speed and extra flags
  5. ;   Library options: dependencies, extra library storages
  6. ;   Advanced options: extra scripting
  7. ;
  8. ; Please visit documentation for the other options and examples
  9. ; https://docs.platformio.org/page/projectconf.html
  12. [env:genericSTM32F103ZE]
  13. platform = ststm32
  14. board = genericSTM32F103ZE
  15. framework = stm32cube

? 这是PlatformIO为我们默认生成好的模板，但是仅靠这个完全没有办法编译我们的项目，我们需要自行修改。

? 经过笔者的简单探索，笔者整合出了如下的配置：

使用笔者的配置

  1. ; PlatformIO Project Configuration File
  2. ;
  3. ;   Build options: build flags, source filter
  4. ;   Upload options: custom upload port, speed and extra flags
  5. ;   Library options: dependencies, extra library storages
  6. ;   Advanced options: extra scripting
  7. ;
  8. ; Please visit documentation for the other options and examples
  9. ; https://docs.platformio.org/page/projectconf.html
  12. ; src_dir就是告知我们的项目的大源文件地址在何处，它隶属于platformio模块的匹配
  13. ; https://docs.platformio.org/en/latest/projectconf/sections/platformio/options/directory/src_dir.html
  14. [platformio]
  15. src_dir = ./Core/
  17. ;目标板子: STM32F103ZE
  18. [env:genericSTM32F103ZE]
  19. platform = ststm32
  20. board = genericSTM32F103ZE
  21. framework = stm32cube
  23. ; -Idir是include文件目录, 这里随了GCC的语法
  24. ; build_flag本质上就是给arm-noeabi-gcc加上了编译参数，直接添加的，所以直接随的是GCC的语法
  25. build_flags =     
  26.     -ICore/Inc    
  28. ;选择链接文件，我们的STM32上电后要执行一段启动脚本
  29. board_build.ldscript = ./STM32F103ZETx_FLASH.ld
  31. ; 下面是上传工具的配置
  32. ; PlatformIO默认使用的上传协议就是stlink,默认的调试协议还是stlink, 这是笔者并没有写出的原因
  33. ; 如果看官手头有的调试器是JLink的话，则需要显示的指定: [看官自行注释]
  34. ; upload_protocol=jlink
  35. ; debug_tool=jlink
  37. ; 手头只有USB < - > TTL的话, 则是
  38. ; upload_protocol=serial
  40. ; 值得注意的是: 一些板子是不支持某一些协议的，这跟PlatformIO使用到的开源库有关系，请前往
  41. ; https://docs.platformio.org/en/latest/boards/index.html#boards
  42. ; 搜索自己使用的板子查看支持的上传，调试协议

? 还有另一份是广为传播的一种配置：

  1. ; PlatformIO Project Configuration File
  2. ;
  3. ;   Build options: build flags, source filter
  4. ;   Upload options: custom upload port, speed and extra flags
  5. ;   Library options: dependencies, extra library storages
  6. ;   Advanced options: extra scripting
  7. ;
  8. ; Please visit documentation for the other options and examples
  9. ; https://docs.platformio.org/page/projectconf.html
  11. ; 在配置文件中分号开头为注释
  12. [platformio]
  13. ; 将源代码的编译目录移到项目目录下，否则默认src下
  14. src_dir = ./
  16. [env:genericSTM32F103ZE]
  17. platform = ststm32
  18. board = genericSTM32F103ZE
  19. ; framework = stm32cube（不用framework了）
  20. ; 编译配置-D是宏定义，-Idir是include文件目录,读者可按自己项目结构更改
  21. ; 这里笔者锐评一下: 这种方式就是会十分繁琐！必须依次指定所有的包含目录!
  22. ; 在已经存在支持的框架下，请优先使用platformIO已经支持的框架！
  23. build_flags =         
  24.   -D STM32F103xE	; 预定义宏, 看官可以理解为在一切源文件的开头加上了#define STM32F103xE
  25.   -ICore/Inc		; 包含了源文件的路径
  26.   -IDrivers/CMSIS/Include
  27.   -IDrivers/CMSIS/Device/ST/STM32F1xx/Include
  28.   -IDrivers/STM32F1xx_HAL_Driver/Inc
  29.   -IDrivers/STM32F1xx_HAL_Driver/Inc/Legacy
  31. ;选择编译文件的所在路径，这里包含了源文件路径，启动文件，驱动库和rtos路径。如果+<*>便是路径下的所以文件，-<.git/>便是忽略.git路径下的文件
  32. build_src_filter = +<Core/Src> +<startup_stm32f103xe.s> +<Drivers/> +<Middlewares/>
  33. ;选择链接文件
  34. board_build.ldscript = ./STM32F103ZETx_FLASH.ld

? 下面我们直接点灯就好，在Core/Src/main.c下：

  1.   // 笔者选择的是上拉模式,亮灯要拉低GPIO电平
  2.   HAL_GPIO_WritePin(LED1_GPIO_Port, LED1_Pin, GPIO_PIN_RESET);
  3.   HAL_GPIO_WritePin(LED0_GPIO_Port, LED0_Pin, GPIO_PIN_RESET);

? 我们下面编译运行，您既可以Ctrl + Shift + P输入PlatformIO:Build开始构建，也可以的点击VSCode下方工具栏上的：

从小房子的图标开始，依次是：

  • PlatformIO主页面
  • 构建
  • 上传
  • 清理
  • 测试（单元测试）
  • 串口监视器
  • 终端
  • 项目
  • 上传的端口设置（默认不动就好）

? 余下的是笔者写其他语言的插件，请不予理会。

? 笔者下面演示的是构建工程，点击√号

  1. Processing genericSTM32F103ZE (platform: ststm32; board: genericSTM32F103ZE; framework: stm32cube)
  2. ----------------------------------------------------------------------------------------------------------------------------------------------------------------
  3. Verbose mode can be enabled via `-v, --verbose` option
  4. CONFIGURATION: https://docs.platformio.org/page/boards/ststm32/genericSTM32F103ZE.html
  5. PLATFORM: ST STM32 (17.4.0) > STM32F103ZE (64k RAM. 512k Flash)
  6. HARDWARE: STM32F103ZET6 72MHz, 64KB RAM, 512KB Flash
  7. DEBUG: Current (blackmagic) External (blackmagic, cmsis-dap, jlink, stlink)
  8. PACKAGES:
  9.  - framework-stm32cubef1 @ 1.8.4
  10.  - tool-ldscripts-ststm32 @ 0.2.0
  11.  - toolchain-gccarmnoneeabi @ 1.70201.0 (7.2.1)
  12. LDF: Library Dependency Finder -> https://bit.ly/configure-pio-ldf
  13. LDF Modes: Finder ~ chain, Compatibility ~ soft
  14. Found 29 compatible libraries
  15. Scanning dependencies...
  16. No dependencies
  17. Building in release mode
  18. Compiling .pio\build\genericSTM32F103ZE\FrameworkHALDriver\Src\stm32f1xx_hal.o
  19. ... 
  20. Compiling .pio\build\genericSTM32F103ZE\FrameworkCMSISDevice\gcc\startup_stm32f103xe.o
  21. Compiling .pio\build\genericSTM32F103ZE\FrameworkCMSISDevice\system_stm32f1xx.o
  22. Archiving .pio\build\genericSTM32F103ZE\libFrameworkCMSISDevice.a
  23. Indexing .pio\build\genericSTM32F103ZE\libFrameworkCMSISDevice.a
  24. Linking .pio\build\genericSTM32F103ZE\firmware.elf
  25. Checking size .pio\build\genericSTM32F103ZE\firmware.elf
  26. Advanced Memory Usage is available via "PlatformIO Home > Project Inspect"
  27. RAM:   [          ]   0.1% (used 44 bytes from 65536 bytes)
  28. Flash: [          ]   0.5% (used 2724 bytes from 524288 bytes)
  29. Building .pio\build\genericSTM32F103ZE\firmware.bin
  30. ================================================================= [SUCCESS] Took 4.93 seconds =================================================================

? 出现[SUCCESS] 字样，说明我们的项目构建顺利，否则，请依次查看自己的项目配置问题。常见的是重定义，请保证自己不要重复包含源文件导致符号重定义！

? 下面我们点击->上传项目到板子上！

? 请在上传之前，确保您已经连接好调试器（我的是STLink），同时板子已经上好电了！

  1. Processing genericSTM32F103ZE (platform: ststm32; board: genericSTM32F103ZE; framework: stm32cube)
  2. ----------------------------------------------------------------------------------------------------------------------------------------------------------------
  3. Verbose mode can be enabled via `-v, --verbose` option
  4. CONFIGURATION: https://docs.platformio.org/page/boards/ststm32/genericSTM32F103ZE.html
  5. PLATFORM: ST STM32 (17.4.0) > STM32F103ZE (64k RAM. 512k Flash)
  6. HARDWARE: STM32F103ZET6 72MHz, 64KB RAM, 512KB Flash
  7. DEBUG: Current (blackmagic) External (blackmagic, cmsis-dap, jlink, stlink)
  8. PACKAGES:
  9.  - framework-stm32cubef1 @ 1.8.4
  10.  - tool-dfuutil @ 1.11.0
  11.  - tool-dfuutil-arduino @ 1.11.0
  12.  - tool-ldscripts-ststm32 @ 0.2.0
  13.  - tool-openocd @ 3.1200.0 (12.0)
  14.  - tool-stm32duino @ 1.0.2
  15.  - toolchain-gccarmnoneeabi @ 1.70201.0 (7.2.1)
  16. LDF: Library Dependency Finder -> https://bit.ly/configure-pio-ldf
  17. LDF Modes: Finder ~ chain, Compatibility ~ soft
  18. Found 29 compatible libraries
  19. Scanning dependencies...
  20. No dependencies
  21. Building in release mode
  22. Checking size .pio\build\genericSTM32F103ZE\firmware.elf
  23. Advanced Memory Usage is available via "PlatformIO Home > Project Inspect"
  24. RAM:   [          ]   0.1% (used 44 bytes from 65536 bytes)
  25. Flash: [          ]   0.5% (used 2724 bytes from 524288 bytes)
  26. Configuring upload protocol...
  27. AVAILABLE: blackmagic, cmsis-dap, dfu, jlink, serial, stlink
  28. CURRENT: upload_protocol = stlink
  29. Uploading .pio\build\genericSTM32F103ZE\firmware.elf
  30. xPack Open On-Chip Debugger 0.12.0-01004-g9ea7f3d64-dirty (2023-01-30-15:04)
  31. Licensed under GNU GPL v2
  32. For bug reports, read
  33.         http://openocd.org/doc/doxygen/bugs.html
  34. debug_level: 1
  36. hla_swd
  37. [stm32f1x.cpu] halted due to debug-request, current mode: Thread 
  38. xPSR: 0x01000000 pc: 0x08000bf8 msp: 0x20010000
  39. ** Programming Started **
  40. Warn : Adding extra erase range, 0x08000c90 .. 0x08000fff
  41. ** Programming Finished **
  42. ** Verify Started **
  43. ** Verified OK **
  44. ** Resetting Target **
  45. shutdown command invoked
  46. ================================================================= [SUCCESS] Took 2.75 seconds =================================================================

? 如愿，小灯亮起，到这里，我们的教程结束！

一些在上传中可能出现的问题

  1. 板子没上电↓

  1. STLink没插好！或者STLink异常，导致OpenOCD无法初始化，请检查端口

  1. 使用USB转TTL接口上传程序出现的问题

? 感谢SourceForge大佬的解答，我随后马上意识到自己犯了一件很蠢的事情，我忘记改板子为bootloader烧录模式了，导致板子根本不接受usb烧录。

stm32flash / Tickets / #134 STM32L462 "Failed to init device" problem (sourceforge.net)

? 请各位看官参考自己的手册关于BOOT引脚的配置！

? 所以，我需要改BOOT0引脚接到3.3V上去，上载好程序后，恢复BOOT引脚全部接地运行程序，果然：

  1. Processing genericSTM32F103ZE (platform: ststm32; board: genericSTM32F103ZE; framework: stm32cube)
  2. ----------------------------------------------------------------------------------------------------------------------------------------------------------------
  3. Verbose mode can be enabled via `-v, --verbose` option
  4. CONFIGURATION: https://docs.platformio.org/page/boards/ststm32/genericSTM32F103ZE.html
  5. PLATFORM: ST STM32 (17.4.0) > STM32F103ZE (64k RAM. 512k Flash)
  6. HARDWARE: STM32F103ZET6 72MHz, 64KB RAM, 512KB Flash
  7. DEBUG: Current (blackmagic) External (blackmagic, cmsis-dap, jlink, stlink)
  8. PACKAGES:
  9.  - framework-stm32cubef1 @ 1.8.4
  10.  - tool-dfuutil @ 1.11.0
  11.  - tool-dfuutil-arduino @ 1.11.0
  12.  - tool-ldscripts-ststm32 @ 0.2.0
  13.  - tool-openocd @ 3.1200.0 (12.0)
  14.  - tool-stm32duino @ 1.0.2
  15.  - toolchain-gccarmnoneeabi @ 1.70201.0 (7.2.1)
  16. LDF: Library Dependency Finder -> https://bit.ly/configure-pio-ldf
  17. LDF Modes: Finder ~ chain, Compatibility ~ soft
  18. Found 29 compatible libraries
  19. Scanning dependencies...
  20. No dependencies
  21. Building in release mode
  22. Checking size .pio\build\genericSTM32F103ZE\firmware.elf
  23. Advanced Memory Usage is available via "PlatformIO Home > Project Inspect"
  24. RAM:   [          ]   0.1% (used 44 bytes from 65536 bytes)
  25. Flash: [          ]   0.5% (used 2716 bytes from 524288 bytes)
  26. Configuring upload protocol...
  27. AVAILABLE: blackmagic, cmsis-dap, dfu, jlink, serial, stlink
  28. CURRENT: upload_protocol = serial
  29. Looking for upload port...
  30. Auto-detected: COM8
  31. Uploading .pio\build\genericSTM32F103ZE\firmware.bin
  32. stm32flash 0.4
  34. http://stm32flash.googlecode.com/
  36. Using Parser : Raw BINARY
  37. Interface serial_w32: 115200 8E1
  38. Version      : 0x22
  39. Option 1     : 0x00
  40. Option 2     : 0x00
  41. Device ID    : 0x0414 (High-density)
  42. - RAM        : 64KiB  (512b reserved by bootloader)
  43. - Flash      : 512KiB (sector size: 2x2048)
  44. - Option RAM : 16b
  45. - System RAM : 2KiB
  46. Write to memory
  47. Erasing memory
  49. Wrote address 0x08000100 (7.98%) 
  50. Wrote address 0x08000200 (15.96%) 
  51. ...
  52. Wrote address 0x08000b00 (87.78%) 
  53. Wrote address 0x08000c00 (95.76%) 
  54. Wrote address 0x08000c88 (100.00%) Done.
  56. Starting execution at address 0x08000000... done.

调试

? 这里请只有串口烧录的朋友止步了。

? 调试极其容易，我们只需要按照经典的点击：

? 确保自己的板子和调试器都上好电之后，就可以愉快调试了！

原文链接：https://www.cnblogs.com/charliechen114514-blogs/p/18326615

 友情链接：直通硅谷 　点职佳 　北美留学生论坛

计算机硬件热门文章

  • 【路由器】电信光猫中兴 F7010C 折腾记录
  • 老牌阅读器nook2刷机整理
  • GeForce Experience关闭自动更新
  • Dell BOSS 卡是什么
  • 得力D991CN Plus评测（全程对比卡西欧fx-991CN X）
  • 四川九联代工M301H hi3798 mv300 mt7668魔百和 强刷和TTL线刷（救砖）经验分享
  • 用Micro:bit做浇灌系统
  • STM32使用4*4矩阵键盘
  • 数控AGC实现（转）
  • 用Micro:bit控制遥控车

    • 计算机硬件推荐文章

  • STM32开发环境配置记录——关于PlatformIO + VSCode + CubeMX的集成环境配置
  • STM32F103 SPI详解及示例代码
  • 比赛获奖的武林秘籍：07 一文速通电子设计大赛，电子人必看的获奖秘籍
  • FPGA对EEPROM驱动控制（I2C协议）
  • ch58x/ch59xADC差分采样NTC电阻获取当前温度
  • 01-【HAL库】STM32实现串口打印（printf方式)
  • 速存，详细罗列香橙派AIpro外设接口样例大全（附源码）
  • 【路由器】电信光猫中兴 F7010C 折腾记录
  • 详解蓝牙模块的分类
  • 我把 CPU 三级缓存的秘密，藏在这 8 张图里

    • 本站QQ群：前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

    W3xue 的所有内容仅供测试，对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
    关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接（目前9元/月）请联系QQ：27243702 沸活量
    皖ICP备17017327号-2　皖公网安备34020702000426号