本例程采用了"stm32cubemx + vscode + ozone"的软件工具流, 工具链采用了CMakeLists生成ELF文件(CMake + Ninja) + ELF转HEX(arm-none-eabi-objcopy) + jlink下载(JFlash)的方法
我将会从一台电脑装好windows开始——
- 下载steam++，搜索watt，到官方网站上下载（注意一定要下载windows版本），下载完成后打开steam++，不用登陆，找到网络加速界面，勾选github加速选项，点击开始加速。
- 下载主要软件
- 搜索vscode(https://code.visualstudio.com/Download) 并下载windows版本。
- 搜索st中文官网，进入后搜索stm32cubemx下方设计资源中找到按类型筛选中找到固件和软件项下PC端软件，可以找到stm32cubemx下载链接 (https://www.stmcu.com.cn/Designresource/detail/software/711298) ，点击进入后点击下载会要求你登录st账号，中文官网允许使用微信登陆或者手机号登陆，不需要输入密码，之后肯定会有人忘密码的，st账号会经常用到，密码最好记住，不要设置太复杂。
- 搜索jlink，找到SEGGER官网，进入下载jflash的64bit，windows版本(https://www.segger.com/downloads/jlink/) ，建议下载7.96版本以上的，jflash下载需要你同意一份协议，这个不用管，无脑同意就行。
- 搜索ozone，最好搜索segger ozone，还是在SEGGER官网里下载ozone的64位windows版本(https://www.segger.com/products/development-tools/ozone-j-link-debugger/) ，这个直接下载。
- 搜索git，还是git官网下载git安装程序(https://git-scm.com/downloads) 。
- 搜索msys2(https://www.msys2.org/) ，进入下载。
- 搜索cmake，在他们官网里或者直接上github上找到cmake的64位windows安装程序(https://github.com/Kitware/CMake/releases/download/v4.0.0/cmake-4.0.0-windows-x86_64.msi) ，注意这里需要你开着加速器，不然很难下载的了。
- 搜索ninja-build，在官网最下有一行 download the Ninja binary ，点击进入ninja的github网页，找到ninja-win的zip文件(https://github.com/ninja-build/ninja/releases) ，点击下载。
- 安装主要程序，基本上就是无脑一直点就可以，无非是换换盘之类的，除了git可能有些复杂，就不再这里赘述了。
- 安装完软件后，首先是打开msys2.exe，输入命令，之后就是enter，enter，y，enter了。
pacman -S mingw-w64-x86_64-toolchain mingw-w64-x86_64-arm-none-eabi-toolchain mingw-w64-x86_64-ccache mingw-w64-x86_64-openocd- 环境变量的添加：
- jflash.exe所在的目录
- mingw64的bin目录
- cmake的bin目录
- ninja-build.exe所在的目录(不加也可以)
- vscode的setting.json文件
"terminal.integrated.defaultProfile.windows": "mysys2-mingw64", // 若希望为默认终端可以加入这一句
"terminal.integrated.profiles.windows": {
"mysys2-mingw64": {
"path": "cmd.exe", // 意思是使用cmd作为父进程启动终端
"args": ["/c","D:\\msys64\\msys2_shell.cmd -defterm -mingw64 -no-start -here"]
// msys2_shell.cmd在msys的安装目录下，这里要改为你自己的目录
}
},
"makefile.makePath": "mysys2-mingw64",- 配置git，如果你已经有了github账号，那么打开git bash，输入：
git config --global user.name "君の名は" #记得改成你自己的用户名和邮箱
git config --global user.email 君のemail
git config --global http.sslVerify false #如果发现推送时或者拉取时有问题可以试试这行代码- 在vscode上登陆github这个没难度。
- 到这里准备工作就基本完成了。(为什么这个markdown报错这么多！！！)
- 接下来就是一个小测验了
- 打开stm32cubemx并点击右上角st徽标登陆st账号，登陆后在打开时主页面先找到check for updata，点击检查版本更新情况(可选)，之后点击下面的install package & xxx(这个我忘了叫什么了)，找到stm32f1，stm32f4，stm32h7系列的开发支持包并下载。 · 这一步可能会有登陆失败，链接不上服务器的情况，如果你使用的是从正点原子或者csdn上找到的古老的安装包，这种情况极有可能是因为你电脑的java环境不对，正确的java环境应该是java8u351(建议)，这里推一篇csdn的文章(https://blog.csdn.net/qq_63922192/article/details/127892120) ，但是我还是建议你直接去官网上下载最新的stm32cubemx来解决这个问题，因为旧版本的cubemx没有把java环境集成到安装包中，但是最新的版本是集成的，如果你想之后再学习一下java，那么我其实不建议你为了cubemx再配置一个电脑的java环境，现在网络流行的java教学我记得是java18u的版本
- 点击左边第一个选项创建一个工程，等待他自动弹出问答框，选择本工程需要的mcu，本例程采用的是嵌入式的白月光stm32f103c8t6，选择后进入配置环节，注意配置sys里的debug和rcc，配置好时钟树和文件选项-文件名-工程所在位置-使用CMake开发-然后反正就是各种配置，注意选择CMake开发，就是在之前选择MDK地方换成CMake就可以了，最后点击创建工程
- 在vscode中打开你刚创建的文件夹，注意打开后一级目录可以看到CMakeLists.txt不然你就是打开了工程文件夹的父级目录，这里建议你先在资源管理器里打开文件夹到可以看见CMakeLists.txt之后直接空白处右键在终端打开然后输入我最会的视觉代码。
code .- 打开下方终端右边有一个选择终端的选项打开powershell然后开始操作
mkdir build #创建一个文件夹build用来存放编译生成的目标文件
cd build #进入该文件夹cmake .. -G 'Ninja' #使用Ninja作为编译器
ninja -v #编！会生成elf文件最后如果终端没报错并且打开build文件夹可以找到 “工程名”.elf 的文件那么就是成功了。
打开终端powershell，和Ninja流一样先创建build，之后在build文件夹里用powershell执行以下命令
cmake .. -G 'MinGW Makefiles'之后打开bash终端运行下面代码
mingw32-make -j24 #这下看懂了过程无报错且最后在build文件夹中生成目标elf文件即可
这种情况一般是mx生成的ld链接文件有问题，就如去年下半年mx的更新我记得应该是12.04版本，这个版本的mx生成的ld文件都没有补全RAM需要自己在文件中添加，不过好在这并不是很难
想要下载还是有一定难度的，相对于点击即可的MDK下载方式，makefile和cmake开发都需要你写点什么。
cmake的编译最后并没有生成可以烧录进芯片的hex文件，这部分需要我们自己来做
SET(ELFFILE ${CMAKE_PROJECT_NAME}.elf) #设置目标elf文件
SET(HEXFILE ${CMAKE_PROJECT_NAME}.hex) #设置目标hex文件
SET(OBJCOPY arm-none-eabi-objcopy) #设置工具
ADD_CUSTOM_COMMAND(
TARGET ${CMAKE_PROJECT_NAME} #指令目标
POST_BUILD #在每次编译后
COMMAND ${OBJCOPY} -O ihex ${ELFFILE} ${HEXFILE} #执行命令使用OBJCOPY工具将目标elf文件转换成hex文件
)
到这一步就可以获得下载用的hex文件了下面这一步其实不配置也没啥——jlink下载命令
SET(JFLASH JFlash)
ADD_CUSTOM_COMMAND(
TARGET ${CMAKE_PROJECT_NAME} #指令目标
POST_BUILD #在每次编译后
COMMAND ${OBJCOPY} -O ihex ${ELFFILE} ${HEXFILE} #执行命令使用OBJCOPY工具将目标elf文件转换成hex文件
COMMAND ${JFLASH} -openprj ${CMAKE_SOURCE_DIR}/stm32.jflash -open ${HEXFILE}, -6000000 -auto -startapp -exit
)
到此CMake流创建工程-编译工程-下载烧录一条龙服务齐全了 另外上次讲到cmake下载烧录有一个很曹丹的地方就是每次下载都得编译一次, 如果没有更改就不编译不烧录
makefile相对简单一些不需要你自己配置复杂的编译流程，但是还是需要配置JFLASH下载 在makefile文件中
download_jlink: #为你的下载命令取个名字
JFlash -openprj ${CMAKE_SOURCE_DIR}/stm32.jflash -open ${CMAKE_PROJECT_NAME}.hex, 0x6000000 -auto -startapp -exit
# 这里不多解释这串命令的意思，也没必要特别去了解 ${CMAKE_SOURCE_DIR}就是源文件目录(CMakeLists在的地方) ，stm32.jflash是jflash
# 下载的工程文件，后面-open打开目标的hex文件，待会就会下载这份文件到芯片上，下到哪？就得看stm32.jflash里的flash项下的baseaddr是
# 多少了，我这里这份是0x6000000，然后是自动，开始，关闭jflash之后只用每次想下载的时候就跑到powershell里运行
mingw32-make download_jlink就可以了
这边建议删除build, 然后
mkdir build
cd build
cmake .. -G 'Ninja'
ninja -v就好了, 这个问题是因为cmakelists.txt编译有一个cache加速的txt文件会记录上次编译的数据拿来帮助这次编译，但是第一次拉取相当于换电脑了，所以上次编译的条件不再适用，因此报错，删掉build文件夹重新编译就可以解决问题了，其次还有CMakeLists的报错比较不明显, 例如:
D:/git_code/test02/Kernel/Module/Algorithm/Controller/controller.c:2: error: expected '=', ',', ';', 'asm' or '__attribute__' at end of input- ozone查看变量，并且实时修改变量的值
- ozone跟踪变量，可以查看变量的波形图，并且可以导出变量的csv文件，这个文件可以导入进matlab做分析处理
- ozone制作断点
前期已经在配置环境的时候把GitHub登陆到了vscode上，现在让我们把刚刚创建的新工程提交到你的GitHub上 全屏后左侧图标从上往下数第三个是vscode的git拓展，进入该界面，对于新创建的工程文件夹还没有初始化仓库，点击初始化仓库，随后点击更改，发现更改一栏右侧有+号，点击+号，更改进入暂存区，编辑消息，消息内容要求清楚描述这次更改的地方和目的，点击提交，随后提交选项会变成发布到branch，点击后会让你选择新建pubilc还是private的仓库，选择pubilc，发布。
最近把小电脑配置成了完全的Ubuntu环境，突然想起来好像有同学的电脑是纯Ubuntu系统，在开发stm32芯片时遇到过一些问题，因此研究了一下linux版本下的stm32芯片开发
- 首先要解决网络问题，我们依旧下载steam++(watt) (https://steampp.net/) ，链接放这里了，同时为还是建议大家学习一下科学上网，推荐使用clash-verge (https://clashverge.net/clash-verge/) ，链接放这里，机场自己选，我用的百变小樱的机场，多说无益，下一项吧。
- 接下来是安装vscode和stmcubemx，依旧是之前的网址 (https://code.visualstudio.com/Download) ，(https://www.stmcu.com.cn/Designresource/detail/software/711298) ，只不过这次我们选择使用linux版本，下载下来dem或者rpm包后运行，MX安装是图形化界面，解压linux的zip就能看见那个程序，点击运行安装即可。
sudo dpkg -i pkgname.deb #此处pkgname替换成目标包名，应该都会- 然后安装jlink (https://www.segger.com/downloads/jlink/) ，cmake和ninja，运行如下指令
sudo apt update
sudo apt install cmake
sudo apt install ninja-build在下载好jlink的deb文件的文件夹中打开终端，运行
sudo dpkg -i JLink_Linux_V842_x86_64.deb然后打开vscode，打开配置文件setting.json，添加
"cmake.configureOnOpen": true,
"cmake.sourceDirectory": "${workspaceFolder}",
"cmake.buildDirectory": "${workspaceFolder}/build",
"cmake.generator": "Ninja",
"cmake.cmakePath": "/usr/bin/cmake", // 或者你的 CMake 路径
"cmake.ninjaPath": "/usr/bin/ninja" // 或者你的 Ninja 路径对了，建议在vscode上安装cmake拓展，这样就可以做到一键编译下载了。有了在windows上操作的经验，想必这种事情应该也是轻车熟路了。
如果说你按我说的方法没配置好，可以问问deepseek怎么看，致敬传奇代码手deepseek。为还让deepseek根据这篇markdown写了一篇说明文档，但是感觉写的不是很好，虽然他确实很会写md罢了。还有就是虽然我写了怎么自己改CMakeLists.txt但是为还是建议直接复制我这个工程下CMakeLists.txt中对应的部分，在你理解了配置的方法之后，实际上就算我的CMakeLists.txt移植过程有问题也可以自己解决。
破案了，我的大电脑(WIN)原先的GCC11版本被顶了，刚才编译的时候使用的是更古老的链接器，在STM#@F!)#XX_FLASH.ld文件的105行开始，是一段无关紧要的配置，但是只支持GCC11版本往上的，例如：
.init_array (READONLY) : /* The "READONLY" keyword is only supported in GCC11 and later, remove it if using GCC10 or earlier. */
{
. = ALIGN(4);
PROVIDE_HIDDEN (__init_array_start = .);
KEEP (*(SORT(.init_array.*)))
KEEP (*(.init_array*))
PROVIDE_HIDDEN (__init_array_end = .);
. = ALIGN(4);
} >FLASH仔细看第一行的注释
.init_array (READONLY) : /* The "READONLY" keyword is only supported in GCC11 and later, remove it if using GCC10 or earlier. */真相了，删除掉READONLY后，大电脑正常编译下载了，只用删除READONLY，不过我尝试了把带有该类标记的内容全部删除，也没问题（暂时）。
更新了一键烧录和一键ozone的功能，都用vscode了，怎么也得玩玩json了
这部分是我下载的cortex-degub插件自动生成的，实用性欠佳，可以不用管。
{
// 使用 IntelliSense 了解相关属性。
// 悬停以查看现有属性的描述。
// 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"cwd": "${workspaceFolder}",
"executable": "./bin/executable.elf",
"name": "Debug with JLink",
"request": "launch",
"type": "cortex-debug",
"device": "",
"runToEntryPoint": "main",
"showDevDebugOutput": "none",
"servertype": "jlink"
},
{
"cwd": "${workspaceFolder}",
"executable": "./bin/executable.elf",
"name": "Debug with JLink",
"request": "launch",
"type": "cortex-debug",
"device": "",
"runToEntryPoint": "main",
"showDevDebugOutput": "none",
"servertype": "jlink"
},
{
"name": "Cortex Debug",
"cwd": "${workspaceFolder}",
"executable": "./bin/executable.elf",
"request": "launch",
"type": "cortex-debug",
"runToEntryPoint": "main",
"servertype": "jlink"
}
]
}这部分内容比较重量级，也是比较重要的，json的格式其实很简单，咱们搞嵌入式的会用就行了，
{
"version": "2.0.0", //版本
"tasks": [ //任务
{
"label": "CMake: Build Project",//标签（任务名，启动时喊出任务名）
"type": "shell", //属于的脚本类型
"command": "cmake", //命令（实际上执行的程序）
"args": [ //命令的参数
"-S", "${workspaceFolder}", //前边是命令后跟的进一步操作，后边是操作的对象
"-B", "${workspaceFolder}/build",
"-G", "Ninja"
],
"group": "build", //类别
"problemMatcher": [], //无所谓的东西
"detail": "Configure CMake project"//运行提示
},//每个任务用“{}”括住，任务之间有“,”隔开。
{
"label": "CMake: Generate HEX",
"type": "shell",
"command": "ninja",
"args": [
"-C", "${workspaceFolder}/build"
],
"group": "build",
"dependsOn": ["CMake: Build Project"],
"problemMatcher": [],
"detail": "Build project and generate HEX file"
},
{
"label": "JFlash: Program Device",
"type": "shell",
"command": "JFlash",
"args": [
"-openprj", "${workspaceFolder}/stm32.jflash",
"-open", "${workspaceFolder}/build/${input:hexFileName}",
"-auto",
"-startapp",
"-exit"
],
"dependsOn": ["CMake: Generate HEX"],
"problemMatcher": [],
"detail": "Program HEX file to target via J-Flash"
},
{
"label": "Full Build & Flash",
"dependsOrder": "sequence",
"dependsOn": [
"CMake: Build Project",
"CMake: Generate HEX",
"JFlash: Program Device"
],
"problemMatcher": [],
"group": {
"kind": "build",
"isDefault": true
},
"detail": "Complete build and flash workflow"
},
{
"label": "Generate Ozone Project",
"type": "shell",
"command": "python3",
"args": [
"${workspaceFolder}/.vscode/generate_jdebug.py",
"${workspaceFolderBasename}",
"${workspaceFolder}/build/${workspaceFolderBasename}.elf",
"STM32F103C8" // 修改为你的芯片型号
],
"problemMatcher": [],
"dependsOn": ["CMake: Build Project"]
},
{
"label": "Start Ozone Debug",
"type": "process",
"command": "/usr/bin/ozone",
"args": [
"${workspaceFolder}/debug/${workspaceFolderBasename}.jdebug"
],
"problemMatcher": [],
"dependsOn": ["Generate Ozone Project"],
"presentation": {
"focus": true,
"panel": "dedicated"
}
},
{
"label": "Full Build & Debug",
"dependsOrder": "sequence",
"dependsOn": [
"CMake: Configure",
"CMake: Build Project",
"Generate Ozone Project",
"Start Ozone Debug"
],
"group": "test"
},
{
"label": "Clean Build",
"type": "shell",
"command": "rm -rf ${workspaceFolder}/build/*",
"options": {
"cwd": "${workspaceFolder}"
}
}
],
"inputs": [
{
"id": "hexFileName",
"type": "promptString",
"description": "Enter the HEX filename (e.g. project.hex)",
"default": "${workspaceFolderBasename}.hex"
}
]
}一个生成仿照ozone生成的jdebug文件的脚本，好使，直接抄。