STM32H563 系统 Bootloader 修改选项字节实操（避坑 + 步骤详解）

在 STM32 嵌入式开发中，选项字节配置直接关系到芯片启动模式、存储保护、外设功能等核心参数，通过系统 Bootloader远程修改选项字节是量产调试、批量配置的常用方案。但不少工程师在 STM32H563 项目中操作时，频繁遇到修改无响应、配置不生效、芯片无反馈等问题，踩坑率极高。本文基于 ST 官方 LAT1639 技术文档，结合一线实操经验，拆解 STM32H563 通过系统 Bootloader 修改选项字节的底层逻辑、核心避坑点和完整实操流程，帮你彻底解决配置失败难题。

资料获取：经验分享 | LAT1639 基于STM32H563系统Bootloader修改选项字节

1. 基础认知：先搞懂 3 个核心概念

在正式操作前，理清基础概念是避坑的关键，避免因理解偏差导致操作失误。

1.1 STM32 系统 Bootloader

STM32H563 的系统 Bootloader是芯片出厂时 ST 固化在系统存储区（Boot ROM）的程序，用户无法修改。它支持通过 USART、I2C、SPI 等串行外设与上位机通信，提供读内存、写内存、擦除 Flash、修改选项字节等标准命令，是远程配置芯片的核心工具。

1.2 选项字节的两类寄存器

STM32H563 的选项字节配置通过 Flash 寄存器组实现，核心分为两类，功能完全不同，切勿混淆：

_CUR 后缀寄存器：只读寄存器，存储当前生效的选项字节配置，上电复位、配置更新后自动从非易失性存储加载，不可写入。
_PRG 后缀寄存器：可读写寄存器，存储待编程的选项字节配置，修改该寄存器的值，即可更新对应选项字节功能。

1.3 H563 选项字节寄存器起始地址

STM32H563 所有用户选项字节相关寄存器，统一从地址 0x40022050（FLASH_OPTSR_CUR）开始排布，后续依次为 FLASH_OPTSR_PRG、保留地址、NSEPOCHR、SECEPOCHR、OPTSR2 等寄存器，这是后续操作的核心基准地址。

2. 核心避坑点：90% 失败都栽在这一步

很多工程师照搬 STM32H7 系列的操作经验，直接向目标选项字节寄存器地址发送写命令，结果全部失败。这里必须明确STM32H5 系列与 H7 系列的关键差异：

✅ STM32H7 系列：支持直接写入目标选项字节寄存器地址，无需从起始地址操作，流程简单。
❌ STM32H563（H5 系列通用）：强制要求从选项字节寄存器起始地址 0x40022050 开始，连续读写到目标寄存器。Bootloader 仅识别从起始地址发起的完整读写操作，直接写目标地址会被判定为无效指令，直接忽略。

简单说：H563 改选项字节，必须 “从头读写”，不能 “定点修改”，这是绝大多数操作失败的根本原因。

3. 标准流程：读 - 改 - 写三步搞定配置

STM32H563 通过系统 Bootloader 修改选项字节，必须遵循 “读取完整寄存器组→修改目标_PRG 寄存器→写回完整数据”的标准流程，缺一不可。下面以修改SRAM3_ECC 选项字节（关闭 SRAM3 ECC 校验）为例，结合 STM32CubeProgrammer 实操，拆解每一步细节。

第一步：读取选项字节寄存器完整数据

操作核心：从起始地址 0x40022050 开始，读取到目标寄存器所在地址，获取当前所有选项字节寄存器的原始数据，避免修改时覆盖其他配置。

实操命令（STM32CubeProgrammer）

# 串口连接COM58，读取0x40022050开始0x28字节数据，输出详细日志 STM32_Programmer_CLI.exe -c port=COM58 -r32 0x40022050 0x28 -vb 3

读取结果解析

执行命令后，可获取原始寄存器数据，关键信息如下：

0x40022050 : 2D30EDF8 2D30EDF8 00002020 00000000
0x40022060 : 00000007 00000000 00000007 00000000
0x40022070 : C3000170 C3000170

其中，FLASH_OPTSR2_PRG寄存器值为0xC3000170，bit5 位对应 SRAM3_ECC，当前值为 1（开启校验），正是我们需要修改的目标位。

第二步：修改目标_PRG 寄存器值

操作核心：仅修改目标选项字节对应的_PRG 寄存器特定位，其余寄存器数据保持不变，避免影响其他功能配置。

目标位修改

SRAM3_ECC 对应FLASH_OPTSR2_PRG的 bit5：

原始值：0xC3000170（二进制11000011 00000000 00000001 01110000，bit5=1）
修改后：0xC3000150（二进制11000011 00000000 00000001 01010000，bit5=0，关闭校验）

第三步：从起始地址写回完整数据

操作核心：必须从起始地址 0x40022050 开始，将修改后的完整寄存器数据一次性写回，Bootloader 才能识别并生效配置。

实操命令（STM32CubeProgrammer）

# 从0x40022050开始，写入修改后的完整32位数据
STM32_Programmer_CLI.exe -c port=COM58 -w32 0x40022050 0x2D30EDF8 0x2D30EDF8 0x00002020 0x00000000 0x00000007 0x00000000 0x00000007 0x00000000 0xC3000170 0xC3000150 -vb 3

第四步：验证配置是否生效

写回完成后，执行查看命令，确认 SRAM3_ECC 配置已更新：

# 查看当前选项字节配置
STM32_Programmer_CLI.exe -c port=COM58 -ob displ

输出结果中，SRAM3_ECC=0x0，说明修改成功，配置已生效。

4. 通用适配：其他选项字节修改直接套用

除了 SRAM3_ECC，修改 SWAP_BANK、读保护、写保护等其他选项字节，流程完全一致，仅需调整读取 / 写入的地址范围和目标位：

确认目标选项字节对应的_PRG 寄存器地址；
从 0x40022050 开始，读取到目标_PRG 寄存器地址；
修改目标_PRG 寄存器对应位，其余数据不变；
从 0x40022050 开始，写回完整数据；
验证配置生效。

5. 实操总结与避坑清单

5.1 核心总结

STM32H563 通过系统 Bootloader 修改选项字节，唯一核心规则：从起始地址 0x40022050 发起完整读写，严格遵循 “读完整数据→改目标位→写回完整数据” 流程，即可 100% 成功。

5.2 避坑清单

❌ 禁止直接写目标寄存器地址，必须从 0x40022050 开始；
❌ 禁止修改_CUR 只读寄存器，仅修改_PRG 可写寄存器；
❌ 禁止遗漏其他寄存器数据，写回时需保持原始数据不变；
✅ 建议用 - vb 3 参数查看详细日志，快速定位通信或配置错误；
✅ 区分 H5 与 H7 差异，不要照搬 H7 的定点修改经验。

本文基于 ST 官方 LAT1639 文档和实操验证，覆盖 STM32H563 选项字节修改的核心逻辑与全流程，可直接套用至项目开发。后续遇到类似配置问题，只需牢记 “从头读写、完整数据、仅改 PRG” 三大原则，即可高效解决。