1. 为什么读写保护值得单独拿出来讲GD32 系列单片机在国产替代的大背景下用得越来越广从入门级的 GD32F103 到高性能的 GD32F450、GD32E5 系列很多项目已经从 STM32 平移过来。但平移过程中有一个环节经常被忽略就是选项字节Option Bytes里的读写保护配置。平时开发阶段大家都不在意等到量产烧录、固件交付、或者板子要返修的时候突然发现芯片读不出来也写不进去这时候才慌了。我自己就踩过这个坑。早期做一款基于 GD32F103 的采集板出厂前为了防止固件被抄顺手在 GD_Link_Programmer 里勾了读保护结果后面要升级固件时发现整片擦除都做不了折腾了大半天才搞明白解除流程。所以这篇内容我打算把 GD32 读写保护这件事从头到尾讲清楚它到底是什么、怎么配置、配置之后芯片处于什么状态、怎么解除、解除过程中有哪些坑。这篇文章适合几类人看一是刚接触 GD32、还在用 Keil 或者 EIDE 插件烧录的入门开发者二是负责量产烧录、需要批量配置保护状态的工程人员三是遇到“芯片锁死”问题、正在找解锁方法的人。内容会涉及 GD_Link_Programmer 的具体操作、选项字节的含义、以及一些实测下来的经验尽量做到看完就能上手。需要先说明一点读写保护本身是芯片提供的一项正常安全功能目的是防止未授权的读取和篡改合理使用是合规的。本文讨论的是在自有开发板、自有固件的前提下如何正确配置和解除不涉及任何绕过他人保护机制的内容。2. 读写保护的核心概念与选项字节解析2.1 读保护和写保护到底保护了什么很多人把读保护和写保护混为一谈其实两者作用的对象和触发条件完全不同。读保护Read Protection简称 RDP保护的是 Flash 里的内容不被外部调试器读出来。一旦开启通过 SWD/JTAG 接口去读 Flash 数据会被拒绝调试器会报错或者读到全 0。它的核心目的是防止固件被提取。GD32 的读保护通常分等级比如 Level 0无保护、Level 1读保护开启、Level 2不可逆的深度保护。Level 2 一旦设置连解除都不允许芯片基本就变成一次性烧录的状态量产时极少使用。写保护Write Protection简称 WRP保护的是 Flash 的某些页不被擦除和写入。它按页Page或者按扇区Sector来划分你可以只保护存放 bootloader 的那几页让应用区还能正常升级。写保护不影响读取只影响擦写。两者可以单独使用也可以组合使用。实际项目里最常见的组合是开启读保护防止固件被读同时对 bootloader 区域加写保护防止被误擦。2.2 选项字节在 GD32 里的存储结构选项字节是芯片内部一块独立于主 Flash 的配置区域GD32 的选项字节一般位于信息块区域通过专门的寄存器或者编程接口访问。它里面存放的内容包括RDP 字节读保护等级WRP0/WRP1 等寄存器写保护页的位图USER 字节复位行为、看门狗硬件使能等配置DATA 字节用户自定义数据区以 GD32F103 为例选项字节的读保护字节地址在0x1FFFF800附近写保护寄存器在0x1FFFF80C和0x1FFFF80E。不同型号地址会有差异GD32F4 系列、GD32E 系列又不一样所以操作前一定要查对应型号的用户手册不能照搬。这里有个关键点选项字节的写入不是普通 Flash 写入它需要先解锁、再擦除、再编程而且每次修改都会触发一次选项字节重载。如果中途断电或者操作不当可能导致选项字节处于不一致状态芯片行为异常。2.3 保护状态对烧录和调试的影响配置了读保护之后芯片在调试器眼里会变成什么状态我用 GD_Link_Programmer 实测过几种情况保护状态能否连接能否读 Flash能否擦除能否重新烧录无保护可以可以可以可以仅读保护可以连接但受限不可以需要先解除需要先解除仅写保护可以可以受保护页不可擦未保护页可烧读写保护受限不可以需先解除读保护需先解除从表里能看出来读保护是“总开关”级别的它不解除后面擦除和烧录都做不了。写保护相对温和只影响特定页。注意读保护开启后调试器连接时可能仍然显示“已连接”但任何读操作都会失败。不要被“连接成功”的提示误导要看具体操作是否报错。3. GD_Link_Programmer 配置读写保护的完整实操3.1 工具准备与连接确认先把手上的东西理清楚。你需要一块 GD32 开发板或者目标板GD_Link 调试器或者兼容的 DAPLink、JLink但本文以 GD_Link_Programmer 为准安装了 GD_Link_Programmer 的电脑版本建议用较新的老版本对 GD32 新系列支持不好目标板的供电注意 GD_Link 是否给板子供电要确认清楚连接步骤很直接GD_Link 的 SWDIO、SWCLK、GND、VCC 对应接到板子上然后打开 GD_Link_Programmer。软件启动后先点“Connect”或者选择目标芯片型号。如果连接成功左下角会显示芯片 ID 和 Flash 大小。这里有个细节如果芯片已经处于读保护状态连接时软件可能提示“Read protection is enabled”之类的信息这是正常的说明它检测到了保护状态不是连接失败。3.2 选项字节界面的进入与参数含义GD_Link_Programmer 里配置选项字节的入口一般在菜单栏的“Target”或者工具栏的“Option Bytes”按钮。点进去之后会看到一个对话框里面分几个区域Read Protection下拉选择 Level 0 / Level 1 / Level 2Write Protection一列复选框对应各个 Flash 页User Options复位、看门狗等配置Data用户数据字节我截过一张典型的界面图这里用文字描述读保护区域默认是“Disabled”写保护区域所有页都是未勾选状态。你要做的就是按需勾选。参数选择建议如果只是防止固件被读选 Level 1 就够了Level 2 不要碰写保护只勾选 bootloader 所在的页比如 GD32F103 中容量型号每页 1KBbootloader 占前 8KB就勾选 Page 0 到 Page 7User Options 里的复位配置保持默认除非你有特殊需求3.3 写入选项字节并验证勾选完之后点“Apply”或者“Program”软件会执行选项字节的擦除和写入。这个过程很快但要注意写入前确认供电稳定选项字节写入过程中断电可能导致芯片配置异常写入后软件会提示需要复位或者重新上电按提示操作重新连接后验证状态再次打开选项字节界面看读保护是否显示为 Level 1写保护页是否勾选我实测下来GD_Link_Programmer 写入选项字节后有时候需要手动断电再上电才能生效尤其是读保护。软件提示“Power cycle the device”的时候不要偷懒老老实实拔了重插。提示写入读保护后第一次重新连接可能会失败一两次多试几次或者降低 SWD 速度比如从 4MHz 降到 1MHz通常能连上。3.4 配置过程中的常见报错与应对配置阶段最容易遇到两个报错报错一“Option byte programming failed”。这个多半是供电不稳或者 SWD 线太长。解决办法是缩短杜邦线、给板子单独供电、降低 SWD 时钟。报错二“Device is protected”。这个出现在你已经开了读保护、又想再次修改选项字节的时候。这时候需要先解除读保护才能改其他配置。解除方法下一章讲。还有一个隐蔽的坑有些 GD32 型号的选项字节写入需要先擦除整个选项字节区域如果软件没有自动做这一步你可能需要手动点“Erase Option Bytes”再写入。GD_Link_Programmer 一般会自动处理但老版本可能不会遇到写入不生效可以试试手动擦。4. 解除读写保护的完整流程与踩坑记录4.1 解除读保护的正确姿势解除读保护的核心操作是把 RDP 字节从 Level 1 改回 Level 0。但这个过程会触发一个副作用——整片 Flash 会被自动擦除。这是芯片的设计逻辑不是软件 bug。因为读保护的目的就是防止固件被读如果允许你解除保护还保留固件那保护就形同虚设了。所以解除之前务必确认你手上还有原始固件或者 hex 文件否则解除完芯片就空了。操作步骤用 GD_Link_Programmer 连接芯片读保护状态下连接可能要多试几次打开选项字节界面把 Read Protection 从 Level 1 改回 Level 0点 Apply软件会提示“This will erase the whole chip, continue?”确认后等待擦除和选项字节写入完成断电重新上电重新连接验证读保护已关闭Flash 已空我实测过 GD32F103 和 GD32F407 两块板子解除流程基本一致但 F407 的擦除时间明显更长因为 Flash 容量大。等待的时候不要以为卡死了就拔线耐心等提示完成。4.2 解除写保护的差异点写保护的解除就温和多了不会触发整片擦除。你只需要在选项字节界面把对应页的勾选去掉点 Apply 即可。写保护解除后那些页就可以正常擦写了。但这里有个容易忽略的点写保护和读保护如果同时开启必须先解除读保护才能修改写保护配置。因为读保护状态下选项字节的修改权限是受限的。所以顺序是先解读保护会全擦再解写保护。4.3 芯片“锁死”后的排查思路有时候会遇到更极端的情况芯片连都连不上GD_Link_Programmer 一直报“Cannot connect to target”。这时候按下面的顺序排查第一步确认硬件连接。SWDIO 和 SWCLK 有没有接反GND 是否共地目标板是否供电。这些基础问题占故障的一半以上。第二步尝试降低 SWD 速度。在读保护或者芯片状态异常时高速 SWD 容易握手失败。把速度降到 500kHz 甚至 100kHz 再试。第三步使用“Connect under Reset”模式。GD_Link_Programmer 里一般有这个选项勾选后软件会先拉住复位引脚再尝试连接。这个方法对读保护状态下的连接特别有效。第四步检查 BOOT 引脚。有些情况下 BOOT0 拉高进入系统存储器启动模式可以绕过用户 Flash 的异常状态。GD32 的 BOOT 配置和 STM32 类似具体看型号手册。第五步考虑芯片是否真的损坏。如果以上都试过还是连不上可能是 Flash 或者选项字节区域物理损坏这种就只能换芯片了。我遇到过一次“锁死”最后发现是 SWD 线太长导致信号质量差换了根 10cm 的短线立刻就连上了。所以排查的时候先从最简单的物理层入手不要一上来就怀疑芯片坏了。4.4 常见问题速查表现象可能原因解决办法连接失败报 Cannot connect线序错误、供电不足、SWD 速度过高检查接线、单独供电、降速连接成功但读 Flash 报错读保护已开启解除读保护会全擦擦除时报错写保护页被保护先解除写保护选项字节写入不生效未擦除旧选项字节、供电不稳手动擦除选项字节、稳定供电解除读保护后芯片空了正常现象读保护解除必全擦重新烧录固件反复连接失败SWD 线过长、干扰大缩短线长、加屏蔽、降速5. 量产场景下的保护策略与经验建议5.1 什么阶段该开保护我的建议是分阶段处理开发调试阶段完全不开保护。这个阶段你频繁烧录、调试、读寄存器开了保护纯属给自己找麻烦。小批量试产阶段可以开写保护保护 bootloader读保护先不开。因为试产阶段可能还要改固件、分析问题读保护一开就要全擦效率太低。正式量产阶段读保护 Level 1 写保护 bootloader 区域。这是最稳妥的组合。读保护防止固件被提取写保护防止 bootloader 被误擦导致变砖。售后返修阶段如果返修需要读固件分析那就得先解除读保护但固件会丢。所以量产时一定要保留好每一版的 hex 和源码别指望从芯片里读回来。5.2 批量烧录时如何统一配置量产烧录一般用脱机烧录器或者产线工具。GD_Link_Programmer 支持保存配置你可以把选项字节的配置和固件一起打包成一个工程文件产线直接调用。这样能保证每片芯片的保护状态一致。需要注意的是脱机烧录器对选项字节的支持参差不齐有些便宜的工具只能烧主 Flash不能配选项字节。选型的时候要确认这一点否则产线还得手动配保护效率极低还容易出错。另外批量烧录时建议先烧固件再开保护顺序反了的话开了读保护就烧不进去了。有些工具支持“烧录保护”一键完成用这种最省事。5.3 几个实测下来的避坑心得心得一解除读保护前先备份。这个我说三遍都不为过。我见过太多人解除完发现固件没了然后到处找 hex。心得二不要在生产环境用 Level 2。Level 2 是不可逆的一旦设置芯片就永远不能读也不能再改选项字节。除非你做的是那种一次性、绝不允许被逆向的产品否则别碰。心得三选项字节操作后一定要断电重启。软件提示的 power cycle 不是可选项是必须项。不断电的话芯片可能还运行在旧的配置下导致你误判操作结果。心得四保留一份“无保护”的工程配置。产线有时候需要返工如果只有带保护的配置返工时要手动改容易出错。准备两套配置一套带保护用于正式出货一套无保护用于返工和调试。心得五SWD 接口在量产板上的处理。如果量产板保留了 SWD 接口读保护开启后别人依然可以通过接口尝试连接虽然读不到东西。如果产品对安全要求高可以考虑在量产版上不引出 SWD或者用其他方式限制物理访问。当然这是产品设计层面的考量不是芯片本身的限制。5.4 和其他工具链的配合现在很多人用 VSCode EIDE 插件开发 GD32烧录可能走 OpenOCD 或者 pyOCD。这些工具对选项字节的支持不如 GD_Link_Programmer 直观。我的做法是日常开发用 EIDE 烧录涉及选项字节操作时切回 GD_Link_Programmer。因为选项字节这种东西图形界面点一下比敲命令可靠得多尤其是解除读保护这种高风险操作有明确的确认提示更安全。如果你坚持用命令行OpenOCD 里也有gd32f1x options_read和gd32f1x options_write之类的命令但参数格式要查文档写错了可能把芯片配成奇怪的状态。新手不建议这么玩。6. 一些容易被忽略的细节选项字节的修改次数是有限的。虽然 GD32 官方手册里没有明确给出选项字节的擦写寿命但参考 Flash 的 10 万次量级选项字节一般也在同一数量级甚至更低。所以不要频繁地开保护关保护每次操作都是有代价的。还有一个细节不同批次的 GD32 芯片选项字节的默认值可能不同。我遇到过一批 F103 默认读保护就是关闭的另一批默认 USER 字节配置不一样。所以量产前一定要拿实际批次的芯片验证一遍配置流程不要假设默认值一致。另外GD32 的 DFU 驱动和读写保护是两回事。DFU 是通过 USB 升级固件的方式它有自己的保护机制和选项字节的读写保护不冲突但也不互相替代。如果你用 DFU 升级读保护开启后 DFU 可能也无法工作因为 DFU 需要访问 Flash。这一点在选升级方案的时候要考虑进去。最后说一个我自己的习惯每次对芯片做选项字节操作之前先拍一张当前配置的截图。这样万一操作后状态不对还能对照着看改了什么。这个习惯帮我省过好几次事尤其是同时处理多块板子的时候很容易记混。