📚 课程目录第3章开发环境搭建

3. 开发环境搭建：STM32CubeIDE安装配置、ARM GCC工具链、OpenOCD调试器、工程模板创建

说实话，很多初学者在神经网络部署上栽跟头，不是因为算法难，而是环境没搭好。我见过有人花了一周时间，结果发现是编译器版本不对，导致浮点运算指令全跑偏了。

这一章，咱们就把地基打牢。我会带你一步步装好 STM32CubeIDE、配好 ARM GCC 工具链、搞定 OpenOCD 调试器，最后创建一个干净的工程模板。以后每节课，你都能直接拿这个模板开干。

  本章核心目标： 从零搭建一个可编译、可下载、可调试的 STM32 神经网络开发环境。

3.1 整体环境架构

先看一张图，搞清楚这几个工具之间的关系。你想想看，写代码、编译、烧录、调试，每一步都有专门的工具在干活。

这张图你看懂了吗？STM32CubeIDE 是咱们的“大本营”，负责写代码和调用工具。ARM GCC 负责把 C 代码编译成机器码。OpenOCD 负责把机器码烧进芯片，还能帮你单步调试。

3.2 安装 STM32CubeIDE

STM32CubeIDE 是 ST 官方基于 Eclipse 打造的免费 IDE。我个人习惯用最新稳定版，但别追太新——有些插件还没适配。

3.2.1 下载与安装

去 ST 官网下载：搜索 "STM32CubeIDE"，找到对应你操作系统的安装包。
安装过程：一路默认选项就行。Windows 用户注意，安装路径不要有中文和空格。
首次启动：会提示你选择工作空间（Workspace）。我建议单独建一个文件夹，比如 D:\STM32_Workspace。

我的习惯： 工作空间路径我一般用英文 + 下划线，比如 stm32_nn_workspace。以前有个项目路径带了中文，结果编译脚本死活找不到头文件，折腾了我半天。

3.2.2 配置 ARM GCC 工具链路径

STM32CubeIDE 自带了一个 GCC 编译器，但版本可能比较旧。我建议你单独装一个，然后让 IDE 指向它。

打开 IDE，点击菜单 Window → Preferences。
找到 MCU → Global ARM Toolchains Paths。
在 ARM Toolchain Path 里，填上你 GCC 的安装路径（比如 C:\ARM_GCC\bin）。

注意： 路径要精确到 bin 目录，不是根目录。IDE 会在里面找 arm-none-eabi-gcc.exe。

3.3 安装 ARM GCC 工具链

ARM GCC 是开源的交叉编译器。咱们的代码在 PC 上写，但目标芯片是 ARM Cortex-M，所以需要“交叉编译”。

3.3.1 下载与安装

操作系统	推荐版本	下载地址
Windows	gcc-arm-none-eabi-10.3-2021.10	ARM 官方 GitHub Releases
Linux (Ubuntu)	gcc-arm-none-eabi-10.3-2021.10	`sudo apt install gcc-arm-none-eabi`
macOS	gcc-arm-none-eabi-10.3-2021.10	brew install arm-none-eabi-gcc

安装完后，打开命令行，输入 arm-none-eabi-gcc --version。如果能看到版本号，说明装好了。

  避坑指南： 我曾经在 Windows 上装完 GCC 后，发现命令行找不到命令。原因是没把 bin 目录加到系统环境变量 PATH 里。记得手动加一下。

3.4 安装 OpenOCD 调试器

OpenOCD（Open On-Chip Debugger）是开源的调试和烧录工具。它通过 ST-Link、J-Link 等调试器与目标芯片通信。

3.4.1 下载与安装

下载：去 OpenOCD 官网或 GitHub Releases 下载对应系统的版本。
解压：放到一个固定目录，比如 C:\OpenOCD。
配置环境变量：把 C:\OpenOCD\bin 加到 PATH 里。

3.4.2 验证连接

把 STM32 开发板通过 USB 连到电脑，打开命令行输入：

openocd -f interface/stlink.cfg -f target/stm32f4x.cfg

如果看到 Info : Listening on port 3333 for gdb connections，说明 OpenOCD 已经成功识别了你的开发板。

小技巧： 不同型号的 STM32，target 配置文件不一样。比如 STM32F4 用 stm32f4x.cfg，STM32H7 用 stm32h7x.cfg。不确定的话，去 OpenOCD 的 scripts/target 目录下翻一翻。

3.5 创建工程模板

每次新建项目都从头配置？太累了。我习惯做一个“万能模板”，包含基础的时钟配置、GPIO、UART 打印和调试接口。以后每节课都基于这个模板改。

3.5.1 用 CubeMX 生成初始代码

打开 STM32CubeIDE，点击 File → New → STM32 Project。
选择你的芯片型号（比如 STM32F407VGT6）。
在 Pinout & Configuration 里，配置好以下内容：

外设	配置	用途
RCC	HSE + PLL，主频 168MHz	让芯片跑满速
USART1	波特率 115200，PA9/PA10	打印调试信息
SYS	Debug: Serial Wire	SWD 调试接口
GPIO	PB0 推挽输出	板载 LED 测试

3.5.2 添加神经网络部署的“骨架”

生成代码后，在 Core/Src 下新建一个 nn_inference.c 文件，再建一个 nn_inference.h。里面先放个空函数：

// nn_inference.h
#ifndef NN_INFERENCE_H
#define NN_INFERENCE_H

#include "main.h"

void nn_init(void);
float nn_predict(float *input, uint32_t len);

#endif

// nn_inference.c
#include "nn_inference.h"

void nn_init(void) {
    // 以后在这里加载模型权重
    // 初始化神经网络硬件加速器（如果有）
}

float nn_predict(float *input, uint32_t len) {
    // 以后在这里实现前向推理
    // 目前返回一个假值，用于测试编译
    return 0.0f;
}

3.5.3 配置编译与调试

右键项目 → Properties → C/C++ Build → Settings，确认以下设置：

Toolchains：选择你安装的 ARM GCC 路径。
Optimization：调试阶段用 -Og，发布阶段用 -O2 或 -O3。
Float ABI：如果你的芯片支持硬件浮点（比如 STM32F4），选 -mfloat-abi=hard -mfpu=fpv4-sp-d16。

重要： 浮点 ABI 选错了，神经网络跑起来会慢好几倍，甚至直接 HardFault。我踩过这个坑——当时模型在 PC 上跑得好好的，下到板子上就死机，查了两天才发现是软浮点和硬浮点不匹配。

3.6 验证模板：点灯 + 打印

在 main() 函数里写一段测试代码：

int main(void) {
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_USART1_UART_Init();

    nn_init();

    printf("Neural Network Template Ready!\r\n");

    float test_input[4] = {1.0f, 2.0f, 3.0f, 4.0f};
    float result = nn_predict(test_input, 4);
    printf("Test inference result: %f\r\n", result);

    while (1) {
        HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_0);
        HAL_Delay(500);
    }
}

编译下载后，打开串口助手（波特率 115200），你应该能看到打印信息。同时板载 LED 以 0.5 秒间隔闪烁。

  模板验证清单：
  ✅ 编译无错误、无警告
✅ 下载成功，程序运行
✅ 串口打印正常
✅ LED 闪烁
✅ OpenOCD 调试可连接、可单步

嗯，到这里，你的开发环境就彻底搭好了。这个模板我会在后续每一章里反复使用。你保存好，以后新建项目直接复制一份，改改名字就能开工。