保姆级教程：在STM32F407ZGT6上从零编译MicroPython 1.17固件（含CentOS7避坑指南）

当你想在STM32F407开发板上运行Python脚本时，MicroPython无疑是最佳选择。本文将带你从零开始，在CentOS7环境下完成MicroPython 1.17固件的完整编译过程，特别针对这个老版本Linux发行版中可能遇到的交叉编译环境搭建难题提供详细解决方案。

1. 环境准备与工具链搭建

1.1 系统基础环境配置

在开始之前，建议为你的CentOS7虚拟机创建一个快照。这个简单的预防措施可以让你在后续步骤出错时快速回滚到初始状态。

首先更新系统基础软件包：

sudo yum update -y
sudo yum install -y wget tar xz git make

检查gcc和make是否已安装：

gcc --version
make --version

如果未安装，使用以下命令安装：

sudo yum install -y gcc make

1.2 交叉编译工具链安装（CentOS7特供方案）

CentOS7的软件仓库中不包含arm-none-eabi-gcc，这是编译STM32固件必需的工具链。我们将手动安装5.4版本，这是经过验证与MicroPython 1.17兼容的稳定版本。

# 安装32位兼容库
sudo yum install -y glibc.i686 ncurses-libs.i686

# 下载并解压工具链
wget https://developer.arm.com/-/media/Files/downloads/gnu-rm/5_4-2016q3/gcc-arm-none-eabi-5_4-2016q3-20160926-linux.tar.bz2
tar -xjf gcc-arm-none-eabi-5_4-2016q3-20160926-linux.tar.bz2
sudo mv gcc-arm-none-eabi-5_4-2016q3 /usr/local/gcc-arm-none-eabi

配置环境变量：

echo 'export PATH=$PATH:/usr/local/gcc-arm-none-eabi/bin' | sudo tee -a /etc/profile
source /etc/profile

验证安装：

arm-none-eabi-gcc --version

成功安装后，你应该能看到类似以下的输出：

arm-none-eabi-gcc (GNU Tools for ARM Embedded Processors) 5.4.1 20160919

2. 获取与准备MicroPython源码

2.1 下载源码包

直接从MicroPython官网下载1.17版本源码，避免使用git submodule更新依赖时的网络问题：

wget https://micropython.org/resources/source/micropython-1.17.tar.xz --no-check-certificate
xz -d micropython-1.17.tar.xz
tar -xvf micropython-1.17.tar
cd micropython-1.17

2.2 编译mpy-cross工具

mpy-cross是将Python脚本预编译为字节码的工具，需要先编译：

make -C mpy-cross

编译完成后，你可以在mpy-cross目录下找到mpy-cross可执行文件。将其添加到PATH或记住它的位置，后续可能需要使用。

3. 板级配置适配

3.1 选择合适的参考板

进入STM32端口目录查看可用板型：

cd ports/stm32/boards/
ls

对于STM32F407ZGT6开发板，我们可以基于VCC_GND_F407ZG或BLACK_F407ZG进行修改。这里以创建自定义配置为例：

cp -r VCC_GND_F407ZG my_board
cd my_board

3.2 关键配置文件修改

需要修改的主要有三个文件：

1. mpconfigboard.h - 板级功能配置
2. stm32f4xx_hal_conf.h - 硬件抽象层配置
3. pins.csv - 引脚定义

时钟配置调整

编辑stm32f4xx_hal_conf.h，修改HSE_VALUE匹配你的开发板外部晶振频率（常见8MHz或25MHz）：

#define HSE_VALUE    ((uint32_t)8000000)  // 修改为你的晶振频率

启动位置设置

在mpconfigboard.h中，修改程序启动位置：

#define MICROPY_HW_BOARD_NAME "My Custom F407 Board"
#define MICROPY_HW_FLASH_LAYOUT 1  // 0=外部Flash, 1=内部Flash

引脚定义添加

编辑pins.csv添加你的外设引脚，例如LED：

PF9,LED1

4. 编译与生成固件

4.1 执行编译命令

返回stm32端口目录执行编译：

cd ../..
make BOARD=my_board

编译过程可能需要5-10分钟，取决于你的虚拟机配置。如果遇到错误，常见问题包括：

• 缺少依赖库：根据错误提示安装相应软件包
• 权限问题：尝试使用sudo或检查目录权限
• 工具链路径错误：确认arm-none-eabi-gcc在PATH中

4.2 生成固件文件

成功编译后，你会在build-my_board目录下找到多个格式的固件文件：

firmware.hex   - 用于ST-Link等烧录工具
firmware.dfu   - 用于DFU模式烧录
firmware.bin   - 二进制格式，通用性强

使用ls命令查看生成的文件：

ls build-my_board/firmware.*

5. 烧录与测试

5.1 烧录固件到开发板

将生成的固件传输到Windows主机（如果虚拟机环境需要）：

sz build-my_board/firmware.hex

使用你熟悉的烧录工具（如ST-Link Utility、DAPLink或OpenOCD）将固件烧录到开发板。确保：

• 开发板正确连接编程器
• 选择了正确的芯片型号（STM32F407ZGT6）
• 擦除方式设置为"Full Chip Erase"

5.2 连接与测试

烧录完成后，通过USB连接开发板到电脑。MicroPython会将USB接口模拟为：

1. 虚拟串口 - 用于REPL交互
2. 虚拟磁盘 - 包含boot.py和main.py

使用Putty、TeraTerm等串口工具连接出现的COM端口（Windows）或/dev/ttyACM0（Linux），配置参数：

波特率: 115200
数据位: 8
停止位: 1
无校验

连接成功后，你会看到MicroPython的REPL提示符 >>> ，可以立即开始输入Python命令。例如测试LED：

import pyb
led = pyb.LED(1)
led.on()
led.off()

5.3 文件系统操作

开发板挂载的虚拟磁盘中，你可以：

• 编辑main.py实现上电自动运行的脚本
• 添加其他.py模块扩展功能
• 使用boot.py进行初始化配置

重要提示 ：不要直接在虚拟磁盘中编辑文件，建议在本地编辑好后复制过去，避免文件损坏。