VS Code 搭建stm32开发环境
# MCU免费开发环境
一般芯片厂家会提供各种开发IDE方案，通常其中就包括其自家的集成IDE，如：
意法半导体 STM32CubeIDE
NXP Codewarrior
TI CCS
另外也可以用eclipse、VS studio、VS code等搭建开发环境
VS Code 搭建stm32开发环境
1.搭建准备
程序安装
1.下载并安装 vs code
2.下载并安装 STM32CubeMX
支持最新的HAL库，工程代码配置与生成工具，支持生成IAR、Keil、STM32CubeIDE、Makefile等工程，这里使用其生成的Makefile工程。
3.下载并安装 Git for Windows
该工具集成有精简版的mingw，这里我们使用其bash终端和版本管理均非常有用。
4.下载并安装 arm-none-eabi-gcc
编译器，GUN的arm的通用交叉编译链工具，基本上常用的arm处理器均支持；
安装时勾选设置全局环境变量以便于配置；
使用离线免安装包时，解压到合适的位置，在系统环境变量添加\bin目录，运行CMD或者Windows PowerShell，测试一下是否可用。命令：arm-none-eabi-gcc -v
5.下载并安装 mingw
MinGW 的全称是：Minimalist GNU on Windows 。它实际上是将经典的开源 C语言 编译器 GCC 移植到了 Windows 平台下，并且包含了 Win32API 和 MSYS，因此可以将源代码编译生成 Windows 下的可执行程序，又能如同在 Linux 平台下时，使用一些 Windows 不具备的开发工具。
一句话来概括：MinGW 就是 GCC 的 Windows 版本 。
其安装一般为在线安装，按网上步骤即可。
这里我们主要需要使用其 mingw32-make 功能.
- 离线安装
如果由于环境不能在线安装，可安装其离线安装包
MinGW-W64 GCC-8.1.0 x86_64-win32-seh
下载压缩文件并解压到合适的位置，在系统环境变量添加\bin目录,运行CMD或者Windows PowerShell，测试一下是否可用。命令：gcc -v
同时为方便使用，复制 mingw32-make.exe 一份为 make.exe，这样后面编译程序使用 make 即可。
6.安装mysy2
shell 命令行开发环境，可用于替代 git-bash、cmd、power shell，功能相对更完善。
安装之后，在vscode中配置 settings.json--"terminal.integrated.shell.windows": "C:\msys64\msys2_shell.cmd", 详见下节。
7.下载并安装（可选） OpenOCD for Windows
8.Jlink、ST-Link驱动
9.STM32CubeProg 用于stm32下载程序
VS Code插件搭建所需
安装开发所需基础插件(插件在 vs code 拓展栏搜索名称即可)
-
C/C++（必要）
增加了对C / C ++的语言支持,语法智能感知、加亮及调试功能
-
GBKtoUTF8
-
cortex-debug
2.工程示例
2.1 使用Cube-MX 生成Makefile工程
1.芯片选型、HAL版本、引脚配置、时钟树配置等，可参照下面博客
https://www.cnblogs.com/silencehuan/p/10904048.html
2.工程管理中，选择生成makefile工程，然后点击 generate code即可
2.2 vs code配置
默认情况下，工程下是不含.vscode的文件夹的，修改编辑用户或工程settings.json文件时会自动创建；
user--settings.json文件参考修改如下（包含配置终端和一些格式等设置）：
{
"C_Cpp.updateChannel": "Insiders",
"http.proxySupport": "off",
"workbench.iconTheme": "vscode-icons", //取消左侧自动聚焦
"explorer.autoReveal": false,
"[c]": {
"editor.defaultFormatter": "ms-vscode.cpptools" //默认格式化工具
},
"[h]": {
"editor.defaultFormatter": "ms-vscode.cpptools" //默认格式化工具
},
"editor.formatOnSave": true, //文件保存时自动格式化
"editor.formatOnPaste": true, //代码粘贴时自动格式化
"editor.formatOnType": true, //自动格式化键入行
// "terminal.integrated.shell.windows": "D:\\Program Files\\Git\\git-bash.exe",
"terminal.integrated.shell.windows": "C:\\msys64\\msys2_shell.cmd",
"terminal.integrated.shellArgs.windows": [
"-defterm",
"-mingw64",
"-no-start",
"-here",
"-use-full-path" //使用系统环境变量
],
"terminal.external.windowsExec": "D:\\Program Files\\Git\\git-bash.exe"
}
或者在菜单中设置 File--Preferences--Settings--Features--Terminal
2.3 工程makefile
1.实际开发需要熟悉 makefile
工程后面添加的文件程序需要由makefile来组织编译；
打开工程makefile，编译工具指定，默认 PREFIX = arm-none-eabi- ，如果已设置环境变量则无需修改，否则需添加（实际绝对路径路径） GCC_PATH = D:\gcc-arm-none-eabi-5_4-2016q3-20160926-win32\bin
PREFIX = arm-none-eabi-
# The gcc compiler bin path can be either defined in make command via GCC_PATH variable (> make GCC_PATH=xxx)
# either it can be added to the PATH environment variable.
ifdef GCC_PATH
CC = $(GCC_PATH)/$(PREFIX)gcc
AS = $(GCC_PATH)/$(PREFIX)gcc -x assembler-with-cpp
CP = $(GCC_PATH)/$(PREFIX)objcopy
SZ = $(GCC_PATH)/$(PREFIX)size
else
CC = $(PREFIX)gcc
AS = $(PREFIX)gcc -x assembler-with-cpp
CP = $(PREFIX)objcopy
SZ = $(PREFIX)size
endif
HEX = $(CP) -O ihex
BIN = $(CP) -O binary -S
2.4 工程 .vscode json配置(4个)
1.c_cpp_properties.json
主要有添加include路径，编译器路径，宏定义等，设置好后索引、编译就跟keil一样方便；
打开工程 .vscode 下面的 c_cpp_properties.json 配置脚本，这个json不允许有注释,如果你自己编写了头文件又不在workspaceFolder下，路径也要加到includePath和browse里。设置如下：
{
"configurations": [
{
"name": "Win32",
"includePath": [
"${workspaceFolder}/**",
"${workspaceFolder}Drivers/STM32F4xx_HAL_Driver/Inc",
"${workspaceFolder}Drivers/STM32F4xx_HAL_Driver/Inc/Legacy",
"${workspaceFolder}Drivers/CMSIS/Device/ST/STM32F4xx/Include",
"${workspaceFolder}Drivers/CMSIS/Include",
"${workspaceFolder}Drivers/CMSIS/Include",
"D:/gcc-arm-none-eabi-5_4-2016q3-20160926-win32/arm-none-eabi/include"
],
"defines": [
"_DEBUG",
"UNICODE",
"_UNICODE",
"USE_HAL_DRIVER",
"STM32F407xx"
],
"compilerPath": "D:\\gcc-arm-none-eabi-5_4-2016q3-20160926-win32\\bin\\arm-none-eabi-gcc.exe",
"cStandard": "c11",
"cppStandard": "c++17",
"intelliSenseMode": "gcc-x86"
}
],
"version": 4
}
2.launch.json
所需要调试的文件的路径、调试时的CWD(工作路径)、调试器的路径及一些调试参数(程序启动参数等)；
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"cwd": "${workspaceRoot}",
"executable": "./bin/HAL_Test.elf",
"name": "stm32 Debug",
"request": "launch",
"type": "cortex-debug",
"servertype": "stutil",
"device": "STM32F407ZG",
"preLaunchTask": "编译并下载",
"postDebugTask": "复位设备"
}
]
}
3.tasks.json
{
// See https://go.microsoft.com/fwlink/?LinkId=733558
// for the documentation about the tasks.json format
"version": "2.0.0",
"tasks": [
{
"label": "编译",
"type": "shell",
"command": "make -j6",
"problemMatcher": [],
"group": {
"kind": "build",
"isDefault": true
}
},
{
"label": "编译并下载",
"type": "shell",
"command": "make -j6 && make update",
"problemMatcher": []
},
{
"label": "重新编译",
"type": "shell",
"command": "make clean && make -j6",
"problemMatcher": []
},
{
"label": "复位设备",
"type": "shell",
"command": "STM32_Programmer_CLI -c port=SWD -hardRst",
"problemMatcher": []
}
]
}
4.工程下打开终端，输入 make
工程编程会生成 .bin 文件，这个就是我们要烧录的目标文件。
5.使用 Jlink 的 Jflash 工具烧录
6.使用 JLink GDB server 调试，调试方法如同Linux下面的GDB，主要使用命令行
3. vs code 配置
1.取消文件自动定位到侧边栏
当我在右侧点击某个文件时，左侧会自动定位到该文件所在位置，这点特别烦，尤其在项目目录很长的时候。
在用户 settings.json 中修改
"explorer.autoReveal": false
2.设置默认终端
File--Preferences--Settings-- 中打开用户 setting.json文件，修改如下：
"terminal.integrated.shell.windows": "D:\\Program Files\\Git\\bin\\bash.exe",
"terminal.external.windowsExec": "D:\\Program Files\\Git\\bin\\bash.exe",
2.使用插件推荐（根据需求选择）
| 插件 | 功能 |
|---|---|
| C/C++ | C / C ++的语言支持,语法智能感知、加亮及调试功能，当然需要系统安装arm-none-eabi-gcc编译器 |
| Include Autocomplete | 头文件自动匹配 |
| Code Runner | 代码一键运行 |
| Cortex Debug | 提供jlink、stlink等调试接口功能 |
| filesize | 显示文件大小 |
| Python | Python的语言支持,语法智能感知、加亮及调试功能，需要系统安装python |
| Git History | 查看版本历史及比较 |
| GitLens | 代码中显示提交信息、日志查看方便，同时提供操作图标 |
| GBKtoUTF8 | |
| ARM | arm汇编语言支持 |
| Bracket Pair Colorizer | 彩虹花括号，程序逻辑范围查看方便 |
| DeviceTree | 设备树语法支持 |
| vscode-icons | 文件图标，可快速查看文件类型 |
| PlatformIO IDE |
