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

2. 搭建FOC开发环境

任务目标

在STM32F407开发板上搭建FOC控制工程所需的完整开发环境：安装ARM交叉编译工具链、配置OpenOCD调试器，并通过VS Code + CMake实现一键编译与烧录调试，为后续FOC算法移植提供可复现的构建验证基础。

环境依赖

主机系统：Ubuntu 22.04 LTS（x86_64）
目标芯片：STM32F407VGT6（Cortex-M4F）
工具链：gcc-arm-none-eabi-10.3-2021.10
调试器：OpenOCD 0.12.0（含STM32F4x接口配置）
构建系统：CMake ≥ 3.20，ninja
烧录接口：ST-Link V2

安装与配置步骤

以下命令在终端逐条执行，完成工具链安装与路径配置：

# 1. 安装ARM交叉编译工具链
wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/10.3-2021.10/gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2
tar xjf gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2
sudo mv gcc-arm-none-eabi-10.3-2021.10 /opt/
echo 'export PATH=/opt/gcc-arm-none-eabi-10.3-2021.10/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 2. 安装OpenOCD与构建工具
sudo apt update
sudo apt install -y openocd cmake ninja-build

# 3. 验证安装
arm-none-eabi-gcc --version
openocd --version

验证输出中应分别显示arm-none-eabi-gcc (GNU Arm Embedded Toolchain 10.3-2021.10)和OpenOCD 0.12.0版本信息。

最小工程验证

创建以下两个文件，验证工具链能完成编译、链接和调试器连接：

# CMakeLists.txt
cmake_minimum_required(VERSION 3.20)
project(foc_env_test C ASM)
set(CMAKE_SYSTEM_NAME Generic)
set(CMAKE_SYSTEM_PROCESSOR arm)
set(CMAKE_C_COMPILER arm-none-eabi-gcc)
set(CMAKE_ASM_COMPILER arm-none-eabi-gcc)
set(CMAKE_EXE_LINKER_FLAGS "-T stm32f407vgt6.ld -nostdlib -Wl,--gc-sections")
add_executable(test main.c)
target_compile_options(test PRIVATE -mcpu=cortex-m4 -mthumb -mfloat-abi=hard -mfpu=fpv4-sp-d16 -O2 -Wall)

// main.c
void Reset_Handler(void) {
    while(1) { __asm volatile("nop"); }
}
void Default_Handler(void) {}
void *__stack = (void*)0x20020000;
void *__isr_vector[128] __attribute__((section(".isr_vector"))) = {
    [0] = __stack,
    [1] = Reset_Handler,
};

链接脚本stm32f407vgt6.ld需定义FLASH起始0x08000000长度1M，RAM起始0x20000000长度128K，并将.isr_vector段放在FLASH起始位置。

编译与调试验证

# 编译
cmake -B build -G Ninja
ninja -C build
# 预期输出：生成test.elf，无错误无警告

# 调试连接（另开终端）
openocd -f interface/stlink.cfg -f target/stm32f4x.cfg
# 预期输出：Info : stm32f4x.cpu: hardware has 6 breakpoints, 4 watchpoints

# 烧录与运行（再开终端）
arm-none-eabi-gdb build/test.elf \
  -ex "target remote localhost:3333" \
  -ex "load" \
  -ex "monitor reset halt" \
  -ex "continue"

GDB执行load后显示Loading section .isr_vector, size 0x200 lma 0x8000000即表示烧录成功。continue后程序应在Reset_Handler的while循环中运行，可通过Ctrl+C中断后执行info registers pc确认PC值位于0x08000000+偏移范围内。

通过判定标准

编译阶段：ninja构建无错误，生成test.elf文件
调试阶段：OpenOCD输出目标芯片连接成功信息，无Error字段
烧录阶段：GDB的load命令成功写入Flash，无超时或校验错误
运行阶段：GDB中断后PC指针指向0x08000000～0x08000010区间（Reset_Handler所在区域）

以上四步全部通过，即证明交叉编译工具链、OpenOCD调试器和烧录链路均配置正确，可在此环境上继续搭建FOC工程。