拓冰网站定制 
GD32的读写保护这个事说起来简单但真到产线上批量烧录的时候因为选项字节配置不当导致整批芯片锁死的情况我见过不止一次。尤其是用GD_Link_Programmer这个官方工具的时候界面上就那么几个勾选框点错一个芯片就直接拒绝连接连读都读不出来。这篇内容就把GD32读写保护的完整链路讲清楚——从为什么要配、怎么配、配完怎么验证到万一锁死了怎么救回来全部基于实际操作的流程来写不绕弯子。1. 先搞清楚GD32的读写保护到底在保护什么1.1 选项字节不是普通Flash别拿它当代码区操作很多人第一次接触GD32的读写保护会下意识觉得这就是给Flash加个密码。实际上GD32的读写保护是通过**选项字节Option Bytes**来实现的它位于Flash的一个独立区域和用户程序区是分开的。选项字节里包含了读保护RDP、写保护WRP、以及一些用户配置位比如看门狗模式、复位模式等。关键点在于选项字节的修改不是普通的写Flash操作它需要先解锁Flash控制寄存器然后执行特定的擦除和编程序列。你没法像写数组一样直接往选项字节地址写值必须走专门的流程。这也是为什么很多人用GD_Link_Programmer勾选了读保护之后发现芯片再也连不上的原因——工具帮你把RDP等级改了但你没意识到这个操作是不可逆的至少不是随便就能撤销的。从实际项目经验来看选项字节的配置通常发生在两个阶段一是产线批量烧录时统一加保护防止固件被读取二是研发阶段调试完成后给最终出货版本加保护。研发阶段我强烈建议不要在调试用的芯片上开读保护否则每次改代码都要先解锁效率极低。1.2 读保护和写保护是两回事别混为一谈GD32的读保护RDP和写保护WRP作用完全不同但经常被混着说。读保护控制的是调试接口能不能读取Flash内容写保护控制的是Flash的某些页能不能被擦除或写入。读保护有三个等级以GD32F103系列为例保护等级调试接口读取Flash写入解除方式Level 0允许允许无需解除Level 1禁止允许执行全片擦除后回到Level 0Level 2禁止禁止不可逆芯片永久锁定Level 2基本等于把芯片变成一次性用品除非你确定这批货永远不需要再改固件否则不要碰。我见过一个团队因为误操作把Level 2勾上了整批200片样片全部报废损失虽然不大但项目进度直接拖了两周。写保护则是按页Page来设置的GD32F103每页1KB或2KB取决于具体型号你可以选择保护前N页或者特定页。写保护的作用是防止程序运行时意外擦写Flash比如你的代码里有Flash操作逻辑万一指针跑飞了写到了代码区写保护能兜住。但写保护不影响调试器读取所以它和读保护是互补关系不是替代关系。1.3 为什么产线烧录必须考虑保护配置产线烧录和研发调试最大的区别是产线追求的是一次通过率和不可逆的一致性。研发阶段你可以随便试锁了大不了换芯片产线上一旦有一片因为保护配置错误导致烧录失败整条线的节拍就乱了。我参与过的一个项目产线用GD_Link_Programmer配合离线烧录器批量烧录GD32F303。最开始没加读保护结果发现有些代工厂会偷偷读取固件后来决定加RDP Level 1。但第一次配置的时候操作员在GD_Link_Programmer里勾选了读保护之后没有勾选“同时擦除全片”的选项导致烧录到一半的芯片直接锁死既不能继续烧也不能读出来。后来复盘发现GD_Link_Programmer在执行读保护操作时如果目标芯片已经有部分数据必须先执行全片擦除才能正确设置RDP等级否则会出现状态不一致。所以产线配置保护的正确顺序应该是先擦除全片再烧录固件最后设置读保护。这个顺序不能乱乱了就会出问题。2. GD_Link_Programmer里那些容易点错的选项2.1 工具界面上的保护选项到底对应什么寄存器GD_Link_Programmer的界面看起来很简单但每个勾选框背后对应的都是具体的选项字节位。以GD32F103为例读保护对应的是选项字节的RDP位写保护对应的是WRP0到WRP3这几个位不同型号数量不同。在GD_Link_Programmer的“Option Bytes”设置页面里你会看到类似这样的选项Read Protection下拉选择Level 0或Level 1有些版本有Level 2Write Protection按页选择通常是一个列表让你勾选要保护的页User Options包括复位模式、看门狗模式等这里有个坑GD_Link_Programmer的某些版本在设置读保护时不会自动提示你需要先擦除全片。你勾了Level 1然后点“Apply”工具会直接去写选项字节但如果此时Flash里还有数据写进去的RDP值可能不生效或者芯片进入一个奇怪的状态——调试器能连上但读不了Flash也擦不了。我的做法是在GD_Link_Programmer里操作选项字节之前先手动执行一次“Erase Chip”全片擦除确认擦除成功后再去设置保护。虽然多了一步但能避免90%以上的锁死问题。2.2 写保护的页选择逻辑和实际Flash布局的对应关系写保护的页选择在GD_Link_Programmer里通常是一个复选框列表但列表里的“Page 0”“Page 1”到底对应Flash的哪个地址很多人是不清楚的。GD32F103的Flash起始地址是0x08000000Page 0对应0x08000000到0x080003FF1KB页Page 1对应0x08000400到0x080007FF以此类推。如果你只想保护存放Bootloader的前几页那就勾选Page 0到Page N。但要注意写保护的最小单位是页你不能只保护一页里的前512字节。所以如果你的Bootloader跨了3页那就得保护3页。另外写保护一旦设置解除也需要先擦除全片。这意味着如果你在研发阶段给某个芯片设了写保护后面想改Bootloader就必须先全片擦除连应用程序一起擦掉。所以研发阶段我一般只在最终测试时临时开写保护测完就关掉。2.3 操作截图里看不到的隐藏状态工具连接时的握手信息GD_Link_Programmer在连接目标芯片时底部状态栏会显示一些握手信息比如“Connected to GD32F103C8T6”之类的。但如果你仔细看有时候会显示“Connected (RDP Level 1)”这样的字样。这个信息很关键它告诉你当前芯片的读保护状态。很多人不看这个状态栏直接去点操作按钮结果在RDP Level 1的芯片上执行读操作工具报错“Read protected”然后就开始怀疑是硬件问题。其实只要看一眼状态栏就知道是保护没解除。还有一个隐藏状态是当芯片处于RDP Level 1时GD_Link_Programmer的“Erase Chip”按钮可能仍然是可点击的但点击后会弹出一个警告框提示“Erasing chip will disable read protection”。这个警告框很多人直接点“Yes”就过了没注意看内容。实际上这个操作就是解除读保护的唯一途径——通过全片擦除把RDP降回Level 0。3. 配置读写保护的完整操作链路3.1 从零开始一片全新芯片的保护配置流程假设你拿到一片全新的GD32F103C8T6需要烧录固件并加上读保护。完整流程如下第一步连接芯片并确认状态打开GD_Link_Programmer选择正确的芯片型号GD32F103C8点击“Connect”。连接成功后先看状态栏确认RDP等级是Level 0。如果是Level 1说明这片芯片不是全新的需要先解除保护。第二步全片擦除点击“Erase Chip”等待擦除完成。这一步的目的是确保Flash是空的后面写选项字节时不会因为残留数据导致状态异常。第三步加载固件并烧录点击“Open”选择你的hex或bin文件然后点击“Download”烧录。烧录完成后可以通过“Verify”校验一下确保数据写入正确。第四步设置读保护切换到“Option Bytes”页面在“Read Protection”下拉框里选择“Level 1”。然后点击“Apply”或“Write Option Bytes”。此时工具会提示你确认操作确认后等待完成。第五步验证保护是否生效断开连接重新连接。此时状态栏应该显示“Connected (RDP Level 1)”。尝试点击“Read”或“Verify”如果工具报错说读保护已启用说明配置成功。这个流程看起来简单但每一步都有细节。比如第三步烧录完成后有些人会直接去设保护忘了先断开再重连验证。结果设完保护后工具还保持着之前的连接状态显示一切正常但实际上保护可能没生效。所以设完保护一定要断开重连验证这是铁律。3.2 写保护的配置时机为什么建议在烧录前设置写保护的配置时机和读保护不同。读保护通常是在烧录完成后设置因为你需要先写入固件再保护。但写保护建议在烧录前设置尤其是当你需要保护Bootloader区域时。原因在于写保护的作用是防止Flash被擦写。如果你先烧录了Bootloader再设置写保护那在设置写保护的过程中工具可能会尝试擦除选项字节所在的页而这个操作如果影响到Bootloader区域就可能把刚烧好的代码擦掉。虽然理论上选项字节和用户Flash是分开的但实际操作中因为工具的实现差异先烧后保护有时会出问题。我的做法是先设置写保护保护Bootloader所在的页然后再烧录应用程序到未保护的页。这样Bootloader区域从一开始就是写保护的烧录应用程序时不会影响到它。但这里有个矛盾如果你要烧录Bootloader本身那就不能先设写保护因为设了写保护就写不进去了。所以正确的顺序是全片擦除烧录Bootloader设置写保护保护Bootloader页烧录应用程序到其他页设置读保护这个顺序适用于需要同时使用读写保护的项目。如果只用一个那就按对应的流程走。3.3 用GD_Link_Programmer命令行版本做批量配置GD_Link_Programmer有GUI版本也有命令行版本GD_Link_CLI。产线上批量操作的时候命令行版本更可靠因为可以脚本化避免人工点错。命令行版本的基本用法是这样的GD_Link_CLI.exe -c GD32F103C8 -e # 全片擦除 GD_Link_CLI.exe -c GD32F103C8 -d firmware.hex # 烧录固件 GD_Link_CLI.exe -c GD32F103C8 -ob RDP1 # 设置读保护Level 1但要注意命令行版本的选项字节操作参数在不同版本里可能不一样。有些版本用-ob有些用-option。建议先用GD_Link_CLI.exe -h看一下帮助信息确认参数格式。另外命令行版本在执行读保护设置后不会像GUI那样弹确认框所以脚本里要加错误检测。比如设置完保护后再执行一次连接命令检查返回的状态码。如果返回的是“RDP Level 1”说明设置成功如果返回错误就要报警。我在产线上用的脚本大概是这样的逻辑# 擦除 GD_Link_CLI.exe -c GD32F103C8 -e if [ $? -ne 0 ]; then echo Erase failed; exit 1; fi # 烧录 GD_Link_CLI.exe -c GD32F103C8 -d firmware.hex if [ $? -ne 0 ]; then echo Download failed; exit 1; fi # 设置读保护 GD_Link_CLI.exe -c GD32F103C8 -ob RDP1 if [ $? -ne 0 ]; then echo RDP set failed; exit 1; fi # 验证 GD_Link_CLI.exe -c GD32F103C8 -i | grep RDP Level 1 if [ $? -ne 0 ]; then echo RDP verify failed; exit 1; fi这个脚本跑下来基本能保证每片芯片的保护配置是一致的。但前提是命令行工具本身的版本要固定不能今天用这个版本明天用那个版本否则参数格式变了脚本就挂了。4. 芯片被锁死之后的排查和解除过程4.1 锁死的典型表现连不上、读不出、擦不了GD32被锁死之后表现通常有三种第一种是完全连不上。GD_Link_Programmer点“Connect”之后一直转圈最后报“Cannot connect to target”。这种情况通常是RDP Level 2或者选项字节被写成了非法值。第二种是能连上但读不了。状态栏显示“Connected (RDP Level 1)”但点“Read”或“Verify”就报错。这是正常的Level 1保护状态不算锁死只是需要解除保护。第三种是能连上但擦不了。点“Erase Chip”之后报错“Erase failed”或“Flash protected”。这种情况可能是写保护没解除或者选项字节的WRP位设置有问题。区分这三种情况很重要因为解除方法不同。第一种基本没救Level 2不可逆第二种和第三种都有对应的解除流程。4.2 解除读保护全片擦除是唯一路径如果你确认芯片是RDP Level 1解除方法就是执行全片擦除。在GD_Link_Programmer里直接点“Erase Chip”工具会提示“Erasing chip will disable read protection”确认后等待完成。擦除完成后RDP等级会自动降回Level 0。但这里有个坑有些版本的GD_Link_Programmer在执行全片擦除时如果芯片处于Level 1会先尝试读取选项字节然后根据读到的值决定擦除策略。如果选项字节本身损坏了比如之前写保护配置过程中断电工具可能读不到正确的RDP值然后擦除失败。这种情况下需要手动强制擦除。GD_Link_Programmer有一个“Unlock”或“Force Erase”的选项不同版本叫法不同勾选后再点擦除。这个操作会忽略选项字节的当前值直接执行全片擦除。但要注意强制擦除会连选项字节一起擦掉所以擦完之后所有保护都归零需要重新配置。4.3 写保护导致的擦除失败先解写保护再擦除写保护导致的擦除失败比较少见但一旦遇到就很麻烦。因为写保护是按页设置的如果你要擦除的页正好在写保护范围内擦除操作就会被拒绝。解除写保护的方法和解除读保护类似也需要全片擦除。但问题是如果写保护阻止了擦除那你怎么执行全片擦除这就成了一个死循环。实际上GD32的设计是全片擦除操作会忽略写保护直接擦掉所有页。但前提是你能发起全片擦除命令。在GD_Link_Programmer里如果写保护导致普通擦除失败可以尝试勾选“Chip Erase”而不是“Page Erase”。Chip Erase会擦除整个Flash包括被写保护的页。如果Chip Erase也失败那就可能是选项字节本身出了问题。这时候需要用GD_Link_Programmer的“Option Bytes”页面先把写保护全部取消取消勾选所有页然后点“Apply”再执行擦除。我遇到过一次极端情况一片GD32F303在设置写保护时断电导致选项字节处于半写状态既不能读也不能擦。最后是用GD_Link_Programmer的“Connect under Reset”模式配合手动复位时序才连上然后强制擦除。这个模式在工具的连接设置里可以选原理是让芯片在复位期间进入调试模式绕过一些保护逻辑。4.4 预防胜于治疗产线配置的检查清单与其等锁死了再救不如在配置的时候就做好检查。以下是我在产线上用的检查清单检查项操作预期结果芯片型号确认在工具里选择正确的型号连接后状态栏显示正确型号初始RDP状态连接后看状态栏显示Level 0全片擦除点Erase Chip提示擦除成功固件烧录加载hex并Download提示下载成功校验点Verify提示校验通过设置读保护Option Bytes里选Level 1提示写入成功断开重连断开后再连接状态栏显示RDP Level 1读操作测试点Read报错“Read protected”这个清单走一遍基本能保证保护配置正确。产线上可以把这个清单打印出来贴在工位上操作员每完成一步打个勾避免遗漏。5. 几个实际项目中踩过的坑和对应的解法5.1 烧录器固件版本和芯片型号不匹配导致的假锁死有一次产线反馈说一批GD32F103C8T6烧录后全部连不上怀疑是芯片被锁了。我过去排查发现烧录器用的是旧版固件不支持GD32F103C8T6的最新批次。旧版固件在设置读保护时写入的选项字节值和芯片实际期望的值不一致导致芯片进入了一个未定义状态——调试器能识别到芯片存在但无法进行任何操作。解法很简单升级GD_Link_Programmer到最新版本同时升级烧录器的固件。升级后重新擦除芯片就恢复正常了。这个坑的教训是烧录工具和芯片批次要匹配尤其是GD32这种国产芯片不同批次的选项字节定义可能有细微差异旧版工具不一定兼容。5.2 选项字节写入过程中断电导致的半写状态前面提到过这个情况这里详细说一下排查过程。一片GD32F303在设置写保护时产线突然断电恢复供电后芯片就连不上了。用GD_Link_Programmer连接报“Cannot connect”。换了几种连接模式都不行。后来用示波器看复位引脚和SWDIO引脚的时序发现芯片在上电后没有正常进入调试模式。怀疑是选项字节的半写状态导致芯片的启动逻辑异常。尝试用“Connect under Reset”模式同时手动短接复位引脚到地然后点击连接在释放复位的瞬间工具成功连上了。连上之后立刻执行强制全片擦除芯片恢复正常。这个案例说明选项字节的写入操作一定要保证供电稳定。产线上最好配UPS或者至少在烧录工位加一个稳压电源。另外如果条件允许设置保护的操作可以放在烧录的最后一步并且烧录完成后立刻断电减少中途断电的风险。5.3 读保护解除后固件丢失的预期管理很多人第一次解除读保护的时候发现固件没了以为是操作失误。其实这是正常现象——解除读保护的唯一方法就是全片擦除而全片擦除会把用户Flash一起擦掉。所以解除读保护等于固件丢失这是设计如此不是bug。如果你需要在解除保护后保留固件唯一的办法是在解除之前先把固件读出来备份。但问题是芯片处于读保护状态时你根本读不出来。所以这就成了一个悖论——能读的时候不需要备份需要备份的时候读不了。实际项目中的做法是在设置读保护之前先在本地保存一份固件副本。产线上每批芯片烧录的固件版本都有记录万一需要解除保护直接用本地副本重新烧录。不要指望从芯片里读出来。5.4 用GD32 Embedded Builder配置保护时的差异有些项目用GD32 Embedded Builder来开发这个工具也提供了选项字节配置功能。但它的操作逻辑和GD_Link_Programmer不太一样。Embedded Builder通常是在项目配置里设置保护选项然后通过调试器下载时一并写入。用Embedded Builder配置保护的好处是集成度高不用切换工具。但坑在于Embedded Builder的选项字节配置界面可能隐藏得比较深而且不同版本的默认值不一样。我有一次用Embedded Builder下载程序没注意保护选项被默认勾选了Level 1结果下载完成后芯片直接锁了。后来在项目配置的“Debug”或“Flash”设置里找到了选项字节配置取消勾选后才恢复正常。所以如果你用Embedded Builder下载前一定要检查一下保护相关的配置项确认默认值是你想要的。不要假设默认就是无保护。6. 读写保护配置的参数计算和验证方法6.1 写保护页范围的计算从地址反推页号假设你的Bootloader占用Flash地址0x08000000到0x08001FFF总共8KB。GD32F103C8的页大小是1KB那么Bootloader占用了Page 0到Page 7共8页。在GD_Link_Programmer的写保护列表里你需要勾选Page 0到Page 7。如果页大小是2KB比如GD32F303的某些型号那8KB就是4页勾选Page 0到Page 3。计算方法是页号 (地址 - 0x08000000) / 页大小。比如地址0x08001FFF减去0x08000000得到0x1FFF即8191除以1024得到7.99取整为7所以是Page 7。这个计算看起来简单但实际配置时容易搞错页大小。GD32不同系列的页大小不一样F103通常是1KBF303是2KBF4系列可能是4KB或更大。配置前一定要查对应型号的参考手册确认页大小。6.2 验证读保护是否生效的三种方法配置完读保护后怎么确认真的生效了我通常用三种方法交叉验证方法一工具状态栏。重新连接后GD_Link_Programmer的状态栏会显示“RDP Level 1”。这是最直接的证据。方法二尝试读操作。点击“Read”或“Verify”如果工具报错“Read protected”或类似信息说明读保护生效。方法三用代码验证。如果你能通过其他方式比如串口与芯片通信可以在代码里读取Flash地址的内容看是否能正常读出。如果读出来全是0xFF或0x00说明读保护生效了调试接口读不了但CPU自己可以读。这三种方法中方法一和方法二最常用方法三需要芯片里已经有可运行的代码。产线上通常用方法一和方法二就够了。6.3 写保护生效的验证尝试擦除被保护的页写保护的验证方法是尝试擦除被保护的页如果擦除失败说明写保护生效。在GD_Link_Programmer里可以选择“Page Erase”模式然后选择被保护的页号点击擦除。如果工具报错“Page protected”或类似信息说明写保护起作用了。但要注意这个验证操作本身有风险——如果写保护没生效擦除操作会直接把那一页擦掉Bootloader就没了。所以验证写保护之前一定要确保你有Bootloader的备份。或者更安全的方法是在写保护设置完成后直接烧录应用程序到未保护的页然后运行程序看Bootloader是否还能正常工作。如果Bootloader功能正常说明写保护没有误伤它。7. 不同GD32系列的读写保护差异7.1 GD32F103和GD32F303的选项字节区别GD32F103和GD32F303虽然都是Cortex-M3/M4内核但选项字节的定义有差异。F103的读保护只有Level 0和Level 1两个等级部分型号有Level 2F303则多了一些用户配置位比如BOR欠压复位等级、复位模式等。在GD_Link_Programmer里选择不同型号后Option Bytes页面显示的选项是不一样的。F103的页面比较简单就RDP和WRPF303的页面会多出几个下拉框。配置的时候要看清楚每个选项的含义不要想当然地按F103的经验去配F303。另外F303的写保护页大小是2KBF103是1KB。如果你从F103项目迁移到F303写保护的页号计算要重新做不能直接套用。7.2 GD32E系列和GD32F系列的读保护等级差异GD32E系列比如E230是Cortex-M33内核它的读保护机制和F系列有所不同。E系列的读保护等级可能更多而且解除方式也不一样。有些E系列型号支持通过特定的密钥序列来临时解除保护而不需要全片擦除。但GD_Link_Programmer对E系列的支持可能不如F系列完善。如果你用E系列建议先查一下官方文档确认工具版本是否支持。我遇到过用旧版GD_Link_Programmer连接E230时Option Bytes页面显示不全的情况后来升级工具才解决。7.3 国产替代型号的兼容性注意事项GD32作为STMicroelectronics产品的替代方案很多项目是从STM32迁移过来的。但读写保护这块GD32和STM32的选项字节定义不完全一样。比如STM32F103的读保护解除后Flash会被自动擦除GD32F103也是类似逻辑但具体的选项字节地址和位定义可能有差异。如果你用GD_Link_Programmer去操作一片从STM32项目迁移过来的GD32芯片不要假设保护配置和STM32完全一致。最稳妥的做法是先用工具读一下当前的选项字节值确认芯片的实际状态然后再做配置。另外有些GD32型号的选项字节写入次数是有限制的比如1000次频繁修改保护配置可能会缩短芯片寿命。虽然实际项目中很少达到这个上限但产线上如果反复调试保护配置还是要注意一下。8. 把保护配置纳入产线测试工装的思路8.1 工装脚本里如何集成保护配置和验证产线测试工装通常是自动化脚本控制烧录器、电源、测试仪器等。把保护配置集成进去的时候关键是要把配置和验证分开配置完必须验证验证不通过就报警。工装脚本的基本流程可以是控制电源给芯片上电调用GD_Link_CLI连接芯片检查初始RDP状态应该是Level 0全片擦除烧录固件校验固件设置读保护断开重连验证RDP状态应该是Level 1尝试读操作应该失败记录结果并断电每一步都要检查返回值任何一步失败就停止并报警。不要跳过验证步骤因为配置操作本身可能因为通信干扰等原因失败不验证就不知道。8.2 保护配置失败的常见原因和产线应对策略产线上保护配置失败的原因通常有几类通信干扰烧录工位的电磁环境复杂SWD通信可能受干扰。应对策略是缩短烧录线长度加屏蔽或者在脚本里加重试机制。芯片个体差异不同批次的芯片选项字节的写入时序可能略有差异。应对策略是先用几片样品试跑确认脚本稳定后再批量。工具版本问题前面提到过工具版本和芯片批次不匹配会导致配置失败。应对策略是固定工具版本并且定期检查官方更新。操作员误操作如果是半自动工装操作员可能放错芯片或者没放稳。应对策略是加传感器检测芯片是否到位或者用全自动工装。8.3 保护配置记录的可追溯性设计产线上每片芯片的保护配置都应该有记录包括配置时间、操作员、工具版本、配置结果等。这样万一后面发现某片芯片的保护有问题可以追溯到具体的配置批次。记录的方式可以很简单在工装脚本里把每次配置的结果写到一个日志文件里包含时间戳和芯片序列号如果芯片有唯一ID的话。GD32的芯片通常有一个96位的唯一ID可以通过工具读出来。把这个ID和配置结果关联起来就能实现单片追溯。如果产线有MES系统可以把这些记录上传到MES和工单关联。这样客户反馈问题的时候能快速定位到是哪一批、哪个工位、哪个操作员配置的。9. 一些零散但重要的实操细节9.1 连接线长度对保护配置成功率的影响SWD连接线的长度对保护配置的成功率有直接影响。线太长超过20cm会导致信号衰减配置选项字节时可能写入失败或者写入错误的值。我实测过用10cm的排线配置保护成功率接近100%用30cm的排线成功率降到80%左右而且失败的时候往往是把选项字节写成了非法值导致芯片锁死。所以产线工装的SWD线尽量短最好控制在15cm以内。如果芯片在工装上的位置比较远可以考虑用屏蔽线或者加缓冲器。9.2 芯片供电电压对选项字节写入的影响GD32的选项字节写入需要稳定的供电电压。如果电压偏低比如低于2.7V写入操作可能失败或者写入不完整。产线上如果用的是USB供电要注意USB口的电压波动。我的做法是在烧录工位用独立的稳压电源给芯片供电电压设在3.3V电流限制设在100mA。这样即使芯片内部有短路也不会烧毁电源或芯片。同时稳压电源的电压稳定性比USB口好得多能提高选项字节写入的成功率。9.3 用JLink烧录GD32时的保护配置差异有些项目用JLink而不是GD_Link来烧录GD32。JLink的J-Flash工具也支持选项字节配置但操作界面和GD_Link_Programmer不同。J-Flash里是在“Target”菜单下的“Option Bytes”里配置而且不同版本的J-Flash对GD32的支持程度不一样。用JLink配置GD32保护的时候要注意J-Flash的芯片描述文件.jflash是否包含了正确的选项字节定义。如果描述文件不对配置的保护可能不生效或者写入错误的值。建议用JLink官方提供的最新版J-Flash并且确认芯片型号在支持列表里。另外JLink的“Unlock”功能对GD32的支持有限。有些GD32型号被锁后JLink无法直接解锁还是得用GD_Link_Programmer或者GD32官方的工具来处理。9.4 保护配置后的功耗变化这个细节很少有人提到设置读保护后芯片的功耗可能会有微小变化。因为读保护会禁用调试接口的部分电路理论上功耗会降低一点点。但实际测量中这个变化通常在微安级别对大多数应用没有影响。不过如果你的项目对功耗极其敏感比如电池供电的传感器节点可以在设置保护前后各测一次功耗确认没有异常增加。我测过GD32F103在RDP Level 0和Level 1下的运行功耗差异在10微安以内基本可以忽略。9.5 从旧项目迁移时的保护配置继承问题如果你从一个已有的GD32项目迁移代码到新项目保护配置不会自动继承。新项目的芯片默认是Level 0需要重新配置。但如果你用的是同一个烧录脚本脚本里的保护配置命令会照常执行所以实际影响不大。需要注意的是如果旧项目的芯片已经设了读保护你从旧芯片里读不出固件来迁移。这时候只能从代码仓库里拿源码重新编译或者从本地备份里拿hex文件。不要指望从锁了的芯片里读出固件。10. 个人经验总结GD32的读写保护配置核心就三件事顺序要对、验证要做、备份要有。顺序对了90%的锁死问题可以避免验证做了剩下的10%也能及时发现备份有了万一锁死也能快速恢复。GD_Link_Programmer这个工具虽然界面简单但每个选项背后都有具体的硬件行为。不要凭感觉点点之前想清楚这个操作会对芯片产生什么影响。尤其是读保护一旦设成Level 2就不可逆点之前一定要确认三遍。产线批量配置的时候能用命令行就用命令行能自动化就自动化。人工操作永远会有失误脚本虽然前期投入大一点但长期来看省心得多。最后说一个我自己的习惯每次给芯片设保护之前先在本机保存一份固件副本并且在副本文件名里标注日期和版本号。这样即使芯片锁了也能用副本重新烧录。这个习惯帮我省过好几次事推荐你也这么做。 GD32读写保护配置全指南：从选项字节到产线批量烧录避坑
GD32的读写保护这个事说起来简单但真到产线上批量烧录的时候因为选项字节配置不当导致整批芯片锁死的情况我见过不止一次。尤其是用GD_Link_Programmer这个官方工具的时候界面上就那么几个勾选框点错一个芯片就直接拒绝连接连读都读不出来。这篇内容就把GD32读写保护的完整链路讲清楚——从为什么要配、怎么配、配完怎么验证到万一锁死了怎么救回来全部基于实际操作的流程来写不绕弯子。1. 先搞清楚GD32的读写保护到底在保护什么1.1 选项字节不是普通Flash别拿它当代码区操作很多人第一次接触GD32的读写保护会下意识觉得这就是给Flash加个密码。实际上GD32的读写保护是通过**选项字节Option Bytes**来实现的它位于Flash的一个独立区域和用户程序区是分开的。选项字节里包含了读保护RDP、写保护WRP、以及一些用户配置位比如看门狗模式、复位模式等。关键点在于选项字节的修改不是普通的写Flash操作它需要先解锁Flash控制寄存器然后执行特定的擦除和编程序列。你没法像写数组一样直接往选项字节地址写值必须走专门的流程。这也是为什么很多人用GD_Link_Programmer勾选了读保护之后发现芯片再也连不上的原因——工具帮你把RDP等级改了但你没意识到这个操作是不可逆的至少不是随便就能撤销的。从实际项目经验来看选项字节的配置通常发生在两个阶段一是产线批量烧录时统一加保护防止固件被读取二是研发阶段调试完成后给最终出货版本加保护。研发阶段我强烈建议不要在调试用的芯片上开读保护否则每次改代码都要先解锁效率极低。1.2 读保护和写保护是两回事别混为一谈GD32的读保护RDP和写保护WRP作用完全不同但经常被混着说。读保护控制的是调试接口能不能读取Flash内容写保护控制的是Flash的某些页能不能被擦除或写入。读保护有三个等级以GD32F103系列为例保护等级调试接口读取Flash写入解除方式Level 0允许允许无需解除Level 1禁止允许执行全片擦除后回到Level 0Level 2禁止禁止不可逆芯片永久锁定Level 2基本等于把芯片变成一次性用品除非你确定这批货永远不需要再改固件否则不要碰。我见过一个团队因为误操作把Level 2勾上了整批200片样片全部报废损失虽然不大但项目进度直接拖了两周。写保护则是按页Page来设置的GD32F103每页1KB或2KB取决于具体型号你可以选择保护前N页或者特定页。写保护的作用是防止程序运行时意外擦写Flash比如你的代码里有Flash操作逻辑万一指针跑飞了写到了代码区写保护能兜住。但写保护不影响调试器读取所以它和读保护是互补关系不是替代关系。1.3 为什么产线烧录必须考虑保护配置产线烧录和研发调试最大的区别是产线追求的是一次通过率和不可逆的一致性。研发阶段你可以随便试锁了大不了换芯片产线上一旦有一片因为保护配置错误导致烧录失败整条线的节拍就乱了。我参与过的一个项目产线用GD_Link_Programmer配合离线烧录器批量烧录GD32F303。最开始没加读保护结果发现有些代工厂会偷偷读取固件后来决定加RDP Level 1。但第一次配置的时候操作员在GD_Link_Programmer里勾选了读保护之后没有勾选“同时擦除全片”的选项导致烧录到一半的芯片直接锁死既不能继续烧也不能读出来。后来复盘发现GD_Link_Programmer在执行读保护操作时如果目标芯片已经有部分数据必须先执行全片擦除才能正确设置RDP等级否则会出现状态不一致。所以产线配置保护的正确顺序应该是先擦除全片再烧录固件最后设置读保护。这个顺序不能乱乱了就会出问题。2. GD_Link_Programmer里那些容易点错的选项2.1 工具界面上的保护选项到底对应什么寄存器GD_Link_Programmer的界面看起来很简单但每个勾选框背后对应的都是具体的选项字节位。以GD32F103为例读保护对应的是选项字节的RDP位写保护对应的是WRP0到WRP3这几个位不同型号数量不同。在GD_Link_Programmer的“Option Bytes”设置页面里你会看到类似这样的选项Read Protection下拉选择Level 0或Level 1有些版本有Level 2Write Protection按页选择通常是一个列表让你勾选要保护的页User Options包括复位模式、看门狗模式等这里有个坑GD_Link_Programmer的某些版本在设置读保护时不会自动提示你需要先擦除全片。你勾了Level 1然后点“Apply”工具会直接去写选项字节但如果此时Flash里还有数据写进去的RDP值可能不生效或者芯片进入一个奇怪的状态——调试器能连上但读不了Flash也擦不了。我的做法是在GD_Link_Programmer里操作选项字节之前先手动执行一次“Erase Chip”全片擦除确认擦除成功后再去设置保护。虽然多了一步但能避免90%以上的锁死问题。2.2 写保护的页选择逻辑和实际Flash布局的对应关系写保护的页选择在GD_Link_Programmer里通常是一个复选框列表但列表里的“Page 0”“Page 1”到底对应Flash的哪个地址很多人是不清楚的。GD32F103的Flash起始地址是0x08000000Page 0对应0x08000000到0x080003FF1KB页Page 1对应0x08000400到0x080007FF以此类推。如果你只想保护存放Bootloader的前几页那就勾选Page 0到Page N。但要注意写保护的最小单位是页你不能只保护一页里的前512字节。所以如果你的Bootloader跨了3页那就得保护3页。另外写保护一旦设置解除也需要先擦除全片。这意味着如果你在研发阶段给某个芯片设了写保护后面想改Bootloader就必须先全片擦除连应用程序一起擦掉。所以研发阶段我一般只在最终测试时临时开写保护测完就关掉。2.3 操作截图里看不到的隐藏状态工具连接时的握手信息GD_Link_Programmer在连接目标芯片时底部状态栏会显示一些握手信息比如“Connected to GD32F103C8T6”之类的。但如果你仔细看有时候会显示“Connected (RDP Level 1)”这样的字样。这个信息很关键它告诉你当前芯片的读保护状态。很多人不看这个状态栏直接去点操作按钮结果在RDP Level 1的芯片上执行读操作工具报错“Read protected”然后就开始怀疑是硬件问题。其实只要看一眼状态栏就知道是保护没解除。还有一个隐藏状态是当芯片处于RDP Level 1时GD_Link_Programmer的“Erase Chip”按钮可能仍然是可点击的但点击后会弹出一个警告框提示“Erasing chip will disable read protection”。这个警告框很多人直接点“Yes”就过了没注意看内容。实际上这个操作就是解除读保护的唯一途径——通过全片擦除把RDP降回Level 0。3. 配置读写保护的完整操作链路3.1 从零开始一片全新芯片的保护配置流程假设你拿到一片全新的GD32F103C8T6需要烧录固件并加上读保护。完整流程如下第一步连接芯片并确认状态打开GD_Link_Programmer选择正确的芯片型号GD32F103C8点击“Connect”。连接成功后先看状态栏确认RDP等级是Level 0。如果是Level 1说明这片芯片不是全新的需要先解除保护。第二步全片擦除点击“Erase Chip”等待擦除完成。这一步的目的是确保Flash是空的后面写选项字节时不会因为残留数据导致状态异常。第三步加载固件并烧录点击“Open”选择你的hex或bin文件然后点击“Download”烧录。烧录完成后可以通过“Verify”校验一下确保数据写入正确。第四步设置读保护切换到“Option Bytes”页面在“Read Protection”下拉框里选择“Level 1”。然后点击“Apply”或“Write Option Bytes”。此时工具会提示你确认操作确认后等待完成。第五步验证保护是否生效断开连接重新连接。此时状态栏应该显示“Connected (RDP Level 1)”。尝试点击“Read”或“Verify”如果工具报错说读保护已启用说明配置成功。这个流程看起来简单但每一步都有细节。比如第三步烧录完成后有些人会直接去设保护忘了先断开再重连验证。结果设完保护后工具还保持着之前的连接状态显示一切正常但实际上保护可能没生效。所以设完保护一定要断开重连验证这是铁律。3.2 写保护的配置时机为什么建议在烧录前设置写保护的配置时机和读保护不同。读保护通常是在烧录完成后设置因为你需要先写入固件再保护。但写保护建议在烧录前设置尤其是当你需要保护Bootloader区域时。原因在于写保护的作用是防止Flash被擦写。如果你先烧录了Bootloader再设置写保护那在设置写保护的过程中工具可能会尝试擦除选项字节所在的页而这个操作如果影响到Bootloader区域就可能把刚烧好的代码擦掉。虽然理论上选项字节和用户Flash是分开的但实际操作中因为工具的实现差异先烧后保护有时会出问题。我的做法是先设置写保护保护Bootloader所在的页然后再烧录应用程序到未保护的页。这样Bootloader区域从一开始就是写保护的烧录应用程序时不会影响到它。但这里有个矛盾如果你要烧录Bootloader本身那就不能先设写保护因为设了写保护就写不进去了。所以正确的顺序是全片擦除烧录Bootloader设置写保护保护Bootloader页烧录应用程序到其他页设置读保护这个顺序适用于需要同时使用读写保护的项目。如果只用一个那就按对应的流程走。3.3 用GD_Link_Programmer命令行版本做批量配置GD_Link_Programmer有GUI版本也有命令行版本GD_Link_CLI。产线上批量操作的时候命令行版本更可靠因为可以脚本化避免人工点错。命令行版本的基本用法是这样的GD_Link_CLI.exe -c GD32F103C8 -e # 全片擦除 GD_Link_CLI.exe -c GD32F103C8 -d firmware.hex # 烧录固件 GD_Link_CLI.exe -c GD32F103C8 -ob RDP1 # 设置读保护Level 1但要注意命令行版本的选项字节操作参数在不同版本里可能不一样。有些版本用-ob有些用-option。建议先用GD_Link_CLI.exe -h看一下帮助信息确认参数格式。另外命令行版本在执行读保护设置后不会像GUI那样弹确认框所以脚本里要加错误检测。比如设置完保护后再执行一次连接命令检查返回的状态码。如果返回的是“RDP Level 1”说明设置成功如果返回错误就要报警。我在产线上用的脚本大概是这样的逻辑# 擦除 GD_Link_CLI.exe -c GD32F103C8 -e if [ $? -ne 0 ]; then echo Erase failed; exit 1; fi # 烧录 GD_Link_CLI.exe -c GD32F103C8 -d firmware.hex if [ $? -ne 0 ]; then echo Download failed; exit 1; fi # 设置读保护 GD_Link_CLI.exe -c GD32F103C8 -ob RDP1 if [ $? -ne 0 ]; then echo RDP set failed; exit 1; fi # 验证 GD_Link_CLI.exe -c GD32F103C8 -i | grep RDP Level 1 if [ $? -ne 0 ]; then echo RDP verify failed; exit 1; fi这个脚本跑下来基本能保证每片芯片的保护配置是一致的。但前提是命令行工具本身的版本要固定不能今天用这个版本明天用那个版本否则参数格式变了脚本就挂了。4. 芯片被锁死之后的排查和解除过程4.1 锁死的典型表现连不上、读不出、擦不了GD32被锁死之后表现通常有三种第一种是完全连不上。GD_Link_Programmer点“Connect”之后一直转圈最后报“Cannot connect to target”。这种情况通常是RDP Level 2或者选项字节被写成了非法值。第二种是能连上但读不了。状态栏显示“Connected (RDP Level 1)”但点“Read”或“Verify”就报错。这是正常的Level 1保护状态不算锁死只是需要解除保护。第三种是能连上但擦不了。点“Erase Chip”之后报错“Erase failed”或“Flash protected”。这种情况可能是写保护没解除或者选项字节的WRP位设置有问题。区分这三种情况很重要因为解除方法不同。第一种基本没救Level 2不可逆第二种和第三种都有对应的解除流程。4.2 解除读保护全片擦除是唯一路径如果你确认芯片是RDP Level 1解除方法就是执行全片擦除。在GD_Link_Programmer里直接点“Erase Chip”工具会提示“Erasing chip will disable read protection”确认后等待完成。擦除完成后RDP等级会自动降回Level 0。但这里有个坑有些版本的GD_Link_Programmer在执行全片擦除时如果芯片处于Level 1会先尝试读取选项字节然后根据读到的值决定擦除策略。如果选项字节本身损坏了比如之前写保护配置过程中断电工具可能读不到正确的RDP值然后擦除失败。这种情况下需要手动强制擦除。GD_Link_Programmer有一个“Unlock”或“Force Erase”的选项不同版本叫法不同勾选后再点擦除。这个操作会忽略选项字节的当前值直接执行全片擦除。但要注意强制擦除会连选项字节一起擦掉所以擦完之后所有保护都归零需要重新配置。4.3 写保护导致的擦除失败先解写保护再擦除写保护导致的擦除失败比较少见但一旦遇到就很麻烦。因为写保护是按页设置的如果你要擦除的页正好在写保护范围内擦除操作就会被拒绝。解除写保护的方法和解除读保护类似也需要全片擦除。但问题是如果写保护阻止了擦除那你怎么执行全片擦除这就成了一个死循环。实际上GD32的设计是全片擦除操作会忽略写保护直接擦掉所有页。但前提是你能发起全片擦除命令。在GD_Link_Programmer里如果写保护导致普通擦除失败可以尝试勾选“Chip Erase”而不是“Page Erase”。Chip Erase会擦除整个Flash包括被写保护的页。如果Chip Erase也失败那就可能是选项字节本身出了问题。这时候需要用GD_Link_Programmer的“Option Bytes”页面先把写保护全部取消取消勾选所有页然后点“Apply”再执行擦除。我遇到过一次极端情况一片GD32F303在设置写保护时断电导致选项字节处于半写状态既不能读也不能擦。最后是用GD_Link_Programmer的“Connect under Reset”模式配合手动复位时序才连上然后强制擦除。这个模式在工具的连接设置里可以选原理是让芯片在复位期间进入调试模式绕过一些保护逻辑。4.4 预防胜于治疗产线配置的检查清单与其等锁死了再救不如在配置的时候就做好检查。以下是我在产线上用的检查清单检查项操作预期结果芯片型号确认在工具里选择正确的型号连接后状态栏显示正确型号初始RDP状态连接后看状态栏显示Level 0全片擦除点Erase Chip提示擦除成功固件烧录加载hex并Download提示下载成功校验点Verify提示校验通过设置读保护Option Bytes里选Level 1提示写入成功断开重连断开后再连接状态栏显示RDP Level 1读操作测试点Read报错“Read protected”这个清单走一遍基本能保证保护配置正确。产线上可以把这个清单打印出来贴在工位上操作员每完成一步打个勾避免遗漏。5. 几个实际项目中踩过的坑和对应的解法5.1 烧录器固件版本和芯片型号不匹配导致的假锁死有一次产线反馈说一批GD32F103C8T6烧录后全部连不上怀疑是芯片被锁了。我过去排查发现烧录器用的是旧版固件不支持GD32F103C8T6的最新批次。旧版固件在设置读保护时写入的选项字节值和芯片实际期望的值不一致导致芯片进入了一个未定义状态——调试器能识别到芯片存在但无法进行任何操作。解法很简单升级GD_Link_Programmer到最新版本同时升级烧录器的固件。升级后重新擦除芯片就恢复正常了。这个坑的教训是烧录工具和芯片批次要匹配尤其是GD32这种国产芯片不同批次的选项字节定义可能有细微差异旧版工具不一定兼容。5.2 选项字节写入过程中断电导致的半写状态前面提到过这个情况这里详细说一下排查过程。一片GD32F303在设置写保护时产线突然断电恢复供电后芯片就连不上了。用GD_Link_Programmer连接报“Cannot connect”。换了几种连接模式都不行。后来用示波器看复位引脚和SWDIO引脚的时序发现芯片在上电后没有正常进入调试模式。怀疑是选项字节的半写状态导致芯片的启动逻辑异常。尝试用“Connect under Reset”模式同时手动短接复位引脚到地然后点击连接在释放复位的瞬间工具成功连上了。连上之后立刻执行强制全片擦除芯片恢复正常。这个案例说明选项字节的写入操作一定要保证供电稳定。产线上最好配UPS或者至少在烧录工位加一个稳压电源。另外如果条件允许设置保护的操作可以放在烧录的最后一步并且烧录完成后立刻断电减少中途断电的风险。5.3 读保护解除后固件丢失的预期管理很多人第一次解除读保护的时候发现固件没了以为是操作失误。其实这是正常现象——解除读保护的唯一方法就是全片擦除而全片擦除会把用户Flash一起擦掉。所以解除读保护等于固件丢失这是设计如此不是bug。如果你需要在解除保护后保留固件唯一的办法是在解除之前先把固件读出来备份。但问题是芯片处于读保护状态时你根本读不出来。所以这就成了一个悖论——能读的时候不需要备份需要备份的时候读不了。实际项目中的做法是在设置读保护之前先在本地保存一份固件副本。产线上每批芯片烧录的固件版本都有记录万一需要解除保护直接用本地副本重新烧录。不要指望从芯片里读出来。5.4 用GD32 Embedded Builder配置保护时的差异有些项目用GD32 Embedded Builder来开发这个工具也提供了选项字节配置功能。但它的操作逻辑和GD_Link_Programmer不太一样。Embedded Builder通常是在项目配置里设置保护选项然后通过调试器下载时一并写入。用Embedded Builder配置保护的好处是集成度高不用切换工具。但坑在于Embedded Builder的选项字节配置界面可能隐藏得比较深而且不同版本的默认值不一样。我有一次用Embedded Builder下载程序没注意保护选项被默认勾选了Level 1结果下载完成后芯片直接锁了。后来在项目配置的“Debug”或“Flash”设置里找到了选项字节配置取消勾选后才恢复正常。所以如果你用Embedded Builder下载前一定要检查一下保护相关的配置项确认默认值是你想要的。不要假设默认就是无保护。6. 读写保护配置的参数计算和验证方法6.1 写保护页范围的计算从地址反推页号假设你的Bootloader占用Flash地址0x08000000到0x08001FFF总共8KB。GD32F103C8的页大小是1KB那么Bootloader占用了Page 0到Page 7共8页。在GD_Link_Programmer的写保护列表里你需要勾选Page 0到Page 7。如果页大小是2KB比如GD32F303的某些型号那8KB就是4页勾选Page 0到Page 3。计算方法是页号 (地址 - 0x08000000) / 页大小。比如地址0x08001FFF减去0x08000000得到0x1FFF即8191除以1024得到7.99取整为7所以是Page 7。这个计算看起来简单但实际配置时容易搞错页大小。GD32不同系列的页大小不一样F103通常是1KBF303是2KBF4系列可能是4KB或更大。配置前一定要查对应型号的参考手册确认页大小。6.2 验证读保护是否生效的三种方法配置完读保护后怎么确认真的生效了我通常用三种方法交叉验证方法一工具状态栏。重新连接后GD_Link_Programmer的状态栏会显示“RDP Level 1”。这是最直接的证据。方法二尝试读操作。点击“Read”或“Verify”如果工具报错“Read protected”或类似信息说明读保护生效。方法三用代码验证。如果你能通过其他方式比如串口与芯片通信可以在代码里读取Flash地址的内容看是否能正常读出。如果读出来全是0xFF或0x00说明读保护生效了调试接口读不了但CPU自己可以读。这三种方法中方法一和方法二最常用方法三需要芯片里已经有可运行的代码。产线上通常用方法一和方法二就够了。6.3 写保护生效的验证尝试擦除被保护的页写保护的验证方法是尝试擦除被保护的页如果擦除失败说明写保护生效。在GD_Link_Programmer里可以选择“Page Erase”模式然后选择被保护的页号点击擦除。如果工具报错“Page protected”或类似信息说明写保护起作用了。但要注意这个验证操作本身有风险——如果写保护没生效擦除操作会直接把那一页擦掉Bootloader就没了。所以验证写保护之前一定要确保你有Bootloader的备份。或者更安全的方法是在写保护设置完成后直接烧录应用程序到未保护的页然后运行程序看Bootloader是否还能正常工作。如果Bootloader功能正常说明写保护没有误伤它。7. 不同GD32系列的读写保护差异7.1 GD32F103和GD32F303的选项字节区别GD32F103和GD32F303虽然都是Cortex-M3/M4内核但选项字节的定义有差异。F103的读保护只有Level 0和Level 1两个等级部分型号有Level 2F303则多了一些用户配置位比如BOR欠压复位等级、复位模式等。在GD_Link_Programmer里选择不同型号后Option Bytes页面显示的选项是不一样的。F103的页面比较简单就RDP和WRPF303的页面会多出几个下拉框。配置的时候要看清楚每个选项的含义不要想当然地按F103的经验去配F303。另外F303的写保护页大小是2KBF103是1KB。如果你从F103项目迁移到F303写保护的页号计算要重新做不能直接套用。7.2 GD32E系列和GD32F系列的读保护等级差异GD32E系列比如E230是Cortex-M33内核它的读保护机制和F系列有所不同。E系列的读保护等级可能更多而且解除方式也不一样。有些E系列型号支持通过特定的密钥序列来临时解除保护而不需要全片擦除。但GD_Link_Programmer对E系列的支持可能不如F系列完善。如果你用E系列建议先查一下官方文档确认工具版本是否支持。我遇到过用旧版GD_Link_Programmer连接E230时Option Bytes页面显示不全的情况后来升级工具才解决。7.3 国产替代型号的兼容性注意事项GD32作为STMicroelectronics产品的替代方案很多项目是从STM32迁移过来的。但读写保护这块GD32和STM32的选项字节定义不完全一样。比如STM32F103的读保护解除后Flash会被自动擦除GD32F103也是类似逻辑但具体的选项字节地址和位定义可能有差异。如果你用GD_Link_Programmer去操作一片从STM32项目迁移过来的GD32芯片不要假设保护配置和STM32完全一致。最稳妥的做法是先用工具读一下当前的选项字节值确认芯片的实际状态然后再做配置。另外有些GD32型号的选项字节写入次数是有限制的比如1000次频繁修改保护配置可能会缩短芯片寿命。虽然实际项目中很少达到这个上限但产线上如果反复调试保护配置还是要注意一下。8. 把保护配置纳入产线测试工装的思路8.1 工装脚本里如何集成保护配置和验证产线测试工装通常是自动化脚本控制烧录器、电源、测试仪器等。把保护配置集成进去的时候关键是要把配置和验证分开配置完必须验证验证不通过就报警。工装脚本的基本流程可以是控制电源给芯片上电调用GD_Link_CLI连接芯片检查初始RDP状态应该是Level 0全片擦除烧录固件校验固件设置读保护断开重连验证RDP状态应该是Level 1尝试读操作应该失败记录结果并断电每一步都要检查返回值任何一步失败就停止并报警。不要跳过验证步骤因为配置操作本身可能因为通信干扰等原因失败不验证就不知道。8.2 保护配置失败的常见原因和产线应对策略产线上保护配置失败的原因通常有几类通信干扰烧录工位的电磁环境复杂SWD通信可能受干扰。应对策略是缩短烧录线长度加屏蔽或者在脚本里加重试机制。芯片个体差异不同批次的芯片选项字节的写入时序可能略有差异。应对策略是先用几片样品试跑确认脚本稳定后再批量。工具版本问题前面提到过工具版本和芯片批次不匹配会导致配置失败。应对策略是固定工具版本并且定期检查官方更新。操作员误操作如果是半自动工装操作员可能放错芯片或者没放稳。应对策略是加传感器检测芯片是否到位或者用全自动工装。8.3 保护配置记录的可追溯性设计产线上每片芯片的保护配置都应该有记录包括配置时间、操作员、工具版本、配置结果等。这样万一后面发现某片芯片的保护有问题可以追溯到具体的配置批次。记录的方式可以很简单在工装脚本里把每次配置的结果写到一个日志文件里包含时间戳和芯片序列号如果芯片有唯一ID的话。GD32的芯片通常有一个96位的唯一ID可以通过工具读出来。把这个ID和配置结果关联起来就能实现单片追溯。如果产线有MES系统可以把这些记录上传到MES和工单关联。这样客户反馈问题的时候能快速定位到是哪一批、哪个工位、哪个操作员配置的。9. 一些零散但重要的实操细节9.1 连接线长度对保护配置成功率的影响SWD连接线的长度对保护配置的成功率有直接影响。线太长超过20cm会导致信号衰减配置选项字节时可能写入失败或者写入错误的值。我实测过用10cm的排线配置保护成功率接近100%用30cm的排线成功率降到80%左右而且失败的时候往往是把选项字节写成了非法值导致芯片锁死。所以产线工装的SWD线尽量短最好控制在15cm以内。如果芯片在工装上的位置比较远可以考虑用屏蔽线或者加缓冲器。9.2 芯片供电电压对选项字节写入的影响GD32的选项字节写入需要稳定的供电电压。如果电压偏低比如低于2.7V写入操作可能失败或者写入不完整。产线上如果用的是USB供电要注意USB口的电压波动。我的做法是在烧录工位用独立的稳压电源给芯片供电电压设在3.3V电流限制设在100mA。这样即使芯片内部有短路也不会烧毁电源或芯片。同时稳压电源的电压稳定性比USB口好得多能提高选项字节写入的成功率。9.3 用JLink烧录GD32时的保护配置差异有些项目用JLink而不是GD_Link来烧录GD32。JLink的J-Flash工具也支持选项字节配置但操作界面和GD_Link_Programmer不同。J-Flash里是在“Target”菜单下的“Option Bytes”里配置而且不同版本的J-Flash对GD32的支持程度不一样。用JLink配置GD32保护的时候要注意J-Flash的芯片描述文件.jflash是否包含了正确的选项字节定义。如果描述文件不对配置的保护可能不生效或者写入错误的值。建议用JLink官方提供的最新版J-Flash并且确认芯片型号在支持列表里。另外JLink的“Unlock”功能对GD32的支持有限。有些GD32型号被锁后JLink无法直接解锁还是得用GD_Link_Programmer或者GD32官方的工具来处理。9.4 保护配置后的功耗变化这个细节很少有人提到设置读保护后芯片的功耗可能会有微小变化。因为读保护会禁用调试接口的部分电路理论上功耗会降低一点点。但实际测量中这个变化通常在微安级别对大多数应用没有影响。不过如果你的项目对功耗极其敏感比如电池供电的传感器节点可以在设置保护前后各测一次功耗确认没有异常增加。我测过GD32F103在RDP Level 0和Level 1下的运行功耗差异在10微安以内基本可以忽略。9.5 从旧项目迁移时的保护配置继承问题如果你从一个已有的GD32项目迁移代码到新项目保护配置不会自动继承。新项目的芯片默认是Level 0需要重新配置。但如果你用的是同一个烧录脚本脚本里的保护配置命令会照常执行所以实际影响不大。需要注意的是如果旧项目的芯片已经设了读保护你从旧芯片里读不出固件来迁移。这时候只能从代码仓库里拿源码重新编译或者从本地备份里拿hex文件。不要指望从锁了的芯片里读出固件。10. 个人经验总结GD32的读写保护配置核心就三件事顺序要对、验证要做、备份要有。顺序对了90%的锁死问题可以避免验证做了剩下的10%也能及时发现备份有了万一锁死也能快速恢复。GD_Link_Programmer这个工具虽然界面简单但每个选项背后都有具体的硬件行为。不要凭感觉点点之前想清楚这个操作会对芯片产生什么影响。尤其是读保护一旦设成Level 2就不可逆点之前一定要确认三遍。产线批量配置的时候能用命令行就用命令行能自动化就自动化。人工操作永远会有失误脚本虽然前期投入大一点但长期来看省心得多。最后说一个我自己的习惯每次给芯片设保护之前先在本机保存一份固件副本并且在副本文件名里标注日期和版本号。这样即使芯片锁了也能用副本重新烧录。这个习惯帮我省过好几次事推荐你也这么做。