目录
参考：
前言：
安装 JAVA 环境
安装STM32CUBEMX
获取gcc-arm工具链
编译STM32代码
安装openocd
安装GDB调试工具
参考：
JAVA环境下载：Java SE Runtime Environment
STM32CUBEMX下载：STM32CUBEMX
gcc-arm工具链下载1：gcc-arm-none-eabi
gcc-arm工具链下载2：gcc-arm-none-eabi
openOCD下载：openOCD
openOCD官方文档
GDB源码包--安装教程
前言：
本文最终目的是在 ubuntu 16.04 系统下开发STM32。
用到了 STM32CUBEMX 去生成带有 Makefile 的STM32基础工程，然后使用 gcc-arm-none-eabi-gcc 工具链对程序进行编译。再通过 openocd 加 CMSIS-DAP的方式连接到目标板（这里是一块STM32F103C8T6）加下载程序。最终使用 GDB 工具进行调试程序。
安装 JAVA 环境
实验安装旧版本的STM32CUBEMX是需要另外安装JAVA环境的，而新版本的STM32CUBEMX包不需要，猜测是自带了JAVA的环境。如果是安装较新版本的STM32CUBEMX，可以先尝试跳过这一步。
JAVA安装包的地址详见文首“参考”项。下载 linux 版本的压缩包。将其放到 linux 系统下进行解压，注意你文件放的路径。
1：使用下面命令打开 profile
sudo vi /etc/profile
2：在 profile 文件最后添加如下代码，其中 JAVA_HOME 后面的路径写你解压包放的地方。
export JAVA_HOME=/home/XXX/jdk1.8.0_301export PATH=$PATH:$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$PATHexport CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/jre/lib\
3：重启 linux 系统
4：输入 java -version ，若上述在 profile 中添加环境变量无误，就会出现相应的版本信息
安装STM32CUBEMX
下载地址详见文首“参考”项，下载 linux 版本的包。注意上一步安装的 java 版本，不要将 CUBEMX 的安装包的版本选的太高，否则在安装过程中可能会出现java环境版本太低导致安装失败的情况。但如果是安装较新版本的自带java环境的STM32CUBEMX，则不需要考虑java版本匹配的问题。在这里我用的是 5.5 的版本。将其放到 linux 系统下进行解压。
在解压包中找到 SetupSTM32CubeMX-5.5.0.linux，注意不同版本名称不同。执行下面命令，给与最高的权限
sudo chmod 777 SetupSTM32CubeMX-5.5.0.linux然后再运行 SetupSTM32CubeMX-5.5.0.linux
./SetupSTM32CubeMX-5.5.0.linux接下来的操作就和 windows 里面一样了。正常安装即可。安装完成之后在你的安装目录下就有一个名为 STM32CUBEMX 的 可执行的文件，正常运行就可以使用STM32CUBEMX了。
获取gcc-arm工具链
下载地址详见文首“参考”项，我是在第一个地址下载，第二个地址上已经停止发布新版工具链了。后续版本仅在第一个地址上发布。
将下载好的 gcc 包放到 linux 下解压。记下文件路径。执行以下命令打开 /etc/profile
sudo vi /etc/profile
在文件最后添加如下代码，将工具链的路径置于系统的环境变量之下，注意不同版本的把路径中版本名替换掉。
export PATH=$PATH:/home/***/gcc-arm-none-eabi-10.3-2021.07/bin重启系统 linux 系统
输入 arm-none-eabi-gcc -v，正确安装就会显示出版本信息
若遇到其它情况，可能是有些依赖没有安装，可以尝试下面两条指令安装。
sudo apt-get install lsb-core
sudo apt-get install lsb-core lib32stdc++6编译STM32代码
做好上述准备步骤之后，打开 STM32CUBEMX，选择芯片，配置参数生成代码，注意生成类型选择为 Makefile 类型。
生成完后在工程目录中打开终端，输入make 即可对其进行编译。编译成功后就会生成 build 文件夹，里面就会有 .bin .elf .hex文件
至于代码的编写，可以使用vim，也可以使用 vscode。网上有很多关于 vscode 的使用。
安装openocd
openocd 可以在 linux 上运行并且支持几乎所有的 arm 调试器。下载地址详见文首“参考”项。解压之后进入目录输入如下命令进行配置
sudo apt-get install libhidapi-dev
/*因为 linux 上默认是没有 HID 设备驱动的，所以需先安装一个 HID 库*/./configure --enable-cmsis-dap
/*因为我是用的 DAP 进行调试，所以要使能 DAP。可以不用输入 enable 相关内容，
这样就只会配置一些常见的调试器*/sudo apt-get install libusb++-dev
/*若在 configure 时提示错误，找不到 usb.h,原因是没有安装 libusb 库，执行此语句安装*/等待配置完成后，就会弹出如下提示
可以看到 CMSIS-DAP 这行是 yes 。
然后再输入如下指令编译并安装
sudo make
sudo make install在安装完成之后将 contrib 目录中的 60-openocd.rules 文件复制到 /etc/udev/rules.d目录下
cp contrib/60-openocd.rules /etc/udev/rules.d/因为这个文件中包含了所有支持调试器的 USB 接口描述，还需要删除以前复制进入这个文件内的规则文件，比如 49-stlinkv1.rules 49-stlinkv2.rules 49-stlinkv2-1.rules 99-jlink.rules 等 ，没有就不用理会。
重启系统来加载规则
若安装成功则在 /usr/local/share/ 路径下会出现 openocd 的文件夹。其中在 scripts 文件夹下就会有 interface 和 target 这两个文件。分别是调试器的配置文件和目标芯片的配置文件。其中内容会在配置连接时用到。
使用 DAP 连接上目标板使用如下指令
openocd -f interface/cmsis-dap.cfg -f target/stm32f1x.cfg
上述是简写路径，openocd 会自动在其 script 路径下搜索脚本 ，连接成功后，会出现以下界面
然后另外启一个终端，输入 telnet localhost 4444 用来连接 openocd,这个在上图中就有提示。
然后输入如下指令，即可下载程序
halt
/*挂起STM32,相关于关机，不执行halt,无法把程序写入到 STM32 的 FLASH*/flash write_image erase /**/**/download.elf
/*写入镜像并预先擦除。写入支持的类型可以详见文首“参考”项的openOCD 文档*/reset
/*复位STM32*/下载程序过程有些麻烦，但一般是用 GDB 调试程序，需要时才下载程序。
安装GDB调试工具
GDB调试工具作为 GNU 编译器下标准的调试工具，在编写调试过程中会频繁被使用到。我实验过两种方式安装 GDB, 一种是下载单独的 GDB 源码包进行编译安装，详见文首“参考”项。第二种简单一些，在 gcc-arm 工具链中有 arm-none-eabi-gdb 的存在。我这里使用第二种方法。
启动 GDB 进行调试之前，需要使用前面提到的 openOCD 连接到目标开发板。可以在上图倒数第二行看见提供了 3333 端口给 GDB。输入如下命令，即可将 GDB 与调试器连接上，同时 openOCD 端也会收到连接信息。
arm-none-eabi-gdb xxx.elf
/*加载调试文件并打开 GDB 程序*/target remote localhost:3333
/*输入连接指令，连接到本地的 3333 端口*/接下来还需要输入如下代码来完成所有的初始化操作
monitor reset
/*monitor 意为向连接的外部软件发送指令，此处为向 openOCD 发送指令*/monitor halt
/*挂起MCU*/load
/*加载上述 xx.elf 文件，即下载到 MCU 的 flash*/
接下来就可以正常的使用 GDB 进行调试了，具体的命令不做阐述。
上述使用 GDB 调试的步骤还是有点麻烦，但我们可以写一个 “.gdbinit” 的文件来简化每次连接输入的代码量。如下图，是我在 ".gdbinit" 文件中写入的内容。以后连接就只需要输入 arm-none-eabi-gdb xxx.elf 就好。GDB 会自动去执行 “.gdbinit” 中的文件。
target remote localhost:3333
monitor reset
monitor halt
load
但在当前工程目录下写 “.gdbinit” ，在打开 GDB 程序时会出现以下问题
warning: File "/home/xyy/debug_test/base/.gdbinit" auto-loading has been declined by your `auto-load safe-path' set to "/usr/share/gdb/auto-load:/usr/lib/debug:/usr/bin/mono-gdb.py".观察 GDB 输出信息，发现是“安全路径保护”会禁止当前目录下的 “.gdbinit” 执行。有多种解决办法，这里说一种最方便的。在/home/xxx 目录下新建一个 “.gdbinit” 文件，在其中输入如下代码
set auto-load safe-path /home/xxx/你的工程目录中 .gdbinit 所在的路径这样就允许了你工程目录中 .gdbinit 的执行。
还可以进一步减少连接 GDB 调试时的执行代码量，对于 arm-none-eabi-gdb xxx.elf 这条指令
，我们可以在工程的 Makefile 文件中以添加目标的方式来简化，如下
debug:$(PREFIX)gdb build/xxx.elf
其中 PREFIX 环境变量就是 “arm-none-eabi-”，后面的 build 是 STM32CUBEMX 生成 .elf 文件所在的目录。
然后在终端输入 make debug 就可以加载调试文件并打开 GDB 程序，若前面关于 “.gdbinit” 的操作无误的话，就会自动执行连接到本地 3333 端口，然后 reset,halt,load程序。一步搞定。至于GDB的使用，网上有许多教程，这里就不赘述了。
