简介GD LINK Programmer是一款专为国产GD32系列微控制器打造的烧录编程工具面向嵌入式开发与硬件调试人员解决GD32芯片固件下载、擦除与验证环节的效率问题。GD32基于ARM Cortex-M内核广泛用于工业控制、消费电子与汽车电子因而该工具对相关项目研发尤为实用。资源以7z压缩包形式发布体积仅3.19MB轻量易用适合快速部署到开发环境。目前已有818人学习下载配套说明较为完整涵盖GD32全系列芯片兼容性、USB 2.0高速编程、在线固件更新、ISP/IAP编程模式及SWD/JTAG调试等核心特性并梳理了从驱动安装、设备连接到程序加载与烧录验证的完整流程同时还涉及错误检测与保护机制避免编程时损坏芯片。掌握该工具后开发者能显著减少烧录过程中的试错成本更顺畅地推进基于GD32的工业控制、物联网设备及消费电子项目开发。1. 打开GD LINK Programmer之前先搞懂整个烧录链路做GD32开发的人手里一定得有趁手的烧录工具。GD LINK Programmer是兆易创新官方提供的烧录软件配合GD-Link调试器那个几十块钱的小盒子使用负责把编译好的固件写进GD32芯片里。很多人第一次用它是在淘宝买开发板的时候商家送了个GD-Link然后甩过来一个软件压缩包里面就是这玩意儿。我最早接触GD32的时候也困惑过明明STM32用ST-Link用得好好的换到GD32为什么非得再装一个软件后来想明白了芯片厂商提供的官方烧录器一定是和自家芯片配合得最紧密的。GD32的Flash加密、OTP区写入、选项字节配置这些操作第三方工具要么不支持要么支持得不完整。你用J-Link搭配Keil也能调试GD32但到了量产阶段、要批量烧录的时候官方工具往往才是那个最稳的选择。这套链路实际是这样的PC上跑着GD LINK Programmer软件USB线连到GD-Link调试器调试器通过SWD接口四根线SWDIO、SWCLK、GND、3V3连到目标板上的GD32芯片。软件把hex或bin文件解析后通过SWD协议把数据写进芯片的Flash里。整个过程看起来简单但里面有不少坑比如连接不上、烧录一半报错、芯片锁死等等这篇文章把我这些年用GD LINK Programmer踩过的坑和沉淀下来的经验一次性写清楚。GD LINK Programmer适合谁看如果你正在用GD32做开发需要烧录调试或者你负责产线要给几百片板子批量烧固件又或者你刚拿到一块GD32开发板想搞清楚怎么把程序烧进去——这篇文章都能帮到你。2. 三个核心选项背后的逻辑烧录地址、芯片型号、下载方式2.1 芯片型号选择与Flash起始地址的关系GD LINK Programmer打开后第一件事是选择芯片型号。这个不能随便选选错了轻则烧录失败重则把Flash配置搞乱。GD32家族有很多系列GD32F103、GD32F303、GD32F407每个系列的内部Flash大小、页大小、扇区结构都不一样。比如GD32F103系列小容量型号Flash只有16KB大容量可以到128KB你选的型号如果和实际芯片不匹配软件可能按照错误的地址范围去擦写。关于烧录地址默认是0x08000000这是GD32内部Flash的起始地址和STM32完全一致。绝大多数应用代码都从这儿开始跑所以不需要改。但有一种情况要特别注意做Bootloader方案时App程序的烧录地址往往不是0x08000000而是往后偏移比如0x08008000。这时候在软件里需要手动修改烧录起始地址并且关闭“擦除整个芯片”的选项只擦除App所在的扇区否则会把Bootloader一并擦掉。2.2 hex和bin选哪个文件格式更省心编译完成之后你会得到两种常见的固件格式hex和bin。GD LINK Programmer两种都支持但我个人强烈建议优先用hex文件。hex文件是Intel十六进制格式每一行记录里除了数据本身还包含这条数据的起始地址信息。也就是说你在Keil或者Embedded Builder里设置好了烧录地址生成hex的时候地址已经写进去了烧录软件按着hex里的地址往Flash里写就行不用担心地址填错。bin文件则纯粹是原始二进制数据不包含地址信息烧录时全靠软件里填的那个起始地址来定位。如果你软件里地址填错了程序就写到错误的地方去了大概率跑不起来。所以我的建议是能用hex就用hex。尤其在Keil里勾选“Create HEX File”选项后再编译生成的hex文件自带完整的地址信息烧录的时候几乎不会出问题。2.3 连接方式SWD和JTAG怎么选GD LINK Programmer支持SWD和JTAG两种连接方式但实际使用中SWD的出场率几乎是100%。原因很简单SWD只需要四根线SWDIO、SWCLK、GND、3V3占用的引脚少而JTAG需要五六根线在一些小板子上引脚根本安排不过来。还有一点是速度。SWD接口在合适速率下烧录速度足够了GD32F103这种级别的芯片128KB的固件十来秒就能写完完全够用。软件的连接速度设置里我一般选自动或较高速率只有在连接不稳定时才手动降速。注意SWD的SWDIO和SWCLK这两个引脚在GD32上是可以被复用为普通GPIO的。如果你的程序里把这些引脚配置成普通IO口烧录器再想连接就困难了。遇到这种情况需要把芯片的BOOT0引脚拉高让芯片进入ISP模式后再尝试连接否则就得用“连接前按住复位键”的土办法。3. 实操GD32烧录从连接到校验的完整流程3.1 驱动安装与硬件连接很多人在GD LINK Programmer这里卡住其实不是软件问题是驱动问题。GD-Link调试器插上电脑后如果设备管理器里显示黄色的感叹号说明驱动没装好。去兆易官网下载GD32 MCU的DAP驱动包或者有些开发板厂商会提供专门的驱动安装程序装完后设备管理器里应该能看到一个“GD-Link”或“CMSIS-DAP”设备。硬件连接顺序上我有个习惯先把GD-Link和目标板用杜邦线连好再插USB。避免先插USB再连目标板时因为瞬间电平不确定导致芯片异常复位。接线还有个容易忽视的点3V3这个引脚要不要接很多人说只用三根线SWDIO、SWCLK、GND就能烧录这个说法对ST-Link适用因为ST-Link有内部供电能力。GD-Link部分版本也可以通过3V3引脚给目标板供电但电流有限如果你的板子上还有其他外设最好还是各自独立供电只接GND保证共地。不共地会导致SWD信号参考电平不对烧录失败的概率很高。3.2 烧录界面配置与参数选择连接好硬件打开GD LINK Programmer界面左侧会有配置项。关键的几项是Target Device选对芯片型号Connection TypeSWDTarget Connection Speed默认即可不稳再降速Download File选择hex文件Target Power如果GD-Link给板子供电勾上独立供电则不勾配置完成后点“Connect”按钮。正常情况下状态栏会显示连接成功同时读出芯片的ID。如果读出来的是全FF或者全是0说明连接有问题先检查接线。连接成功后点“Download”软件会依次执行擦除、写入、校验的操作。整个过程进度条会走动完成后提示烧录成功。GD LINK Programmer默认烧录完成后会做一次校验确保写入的数据和文件完全一致这个功能不要关量产的时候特别重要。3.3 烧录完成后的确认动作烧录成功不代表大功告成。我每次烧完都会做三件事看代码能不能跑给板上电观察程序运行现象如果程序没跑检查复位电路和BOOT引脚重新Read Flash读出内容和hex文件比对大小确认确实烧进去了有时候烧录显示成功但程序不跑多半是Boot0引脚配置的问题。GD32的BOOT0拉低是从主Flash启动如果BOOT0是高电平芯片会进Bootloader而不是跑你的程序表现就是烧录成功但没反应。4. 量产烧录与固件升级的实用经验4.1 用命令行实现一键烧录如果你只是开发阶段用GD LINK Programmer图形界面完全够用。但到了产线一条产线一天要烧几十上百片板子每片都打开软件点几下效率太低还容易误操作。GD LINK Programmer软件本身支持命令行模式安装目录下有一个CLI相关的可执行文件可以带参数执行烧录操作。比如GD32_Programmer_CLI.exe --device GD32F103C8T6 --connect_mode swd --download_file app.hex --verify参数的含义依次是指定芯片型号、连接方式、下载文件、烧录后校验。这样只要写一个批处理脚本产线工人双击一下就能自动完成烧录和校验每分钟能多烧好几片板子。我当年在产线调试的时候把命令行封装成了一个bat文件还加了错误提示音烧录成功播放一个“滴”声失败播放另一个声音。这样工人不用盯着屏幕听声音就知道结果。4.2 量产时的芯片保护配置量产烧录时还有一个关键操作是设置Flash读保护。如果不设置读保护别人拿到你的板子用烧录器直接Read Flash就能把程序读出来逆向成本极低。GD32支持设置读保护级别一般在GD LINK Programmer的Security或Option Bytes页面里配置。打开读保护后芯片只能被擦除不能被读取。要注意的是一旦设置读保护后面再想用调试器调试就得先解除保护而解除保护的过程会擦除整个Flash代码会丢。所以量产顺序应该是先烧录程序再设置读保护之后不再做调试。4.3 现场固件升级时的注意事项和量产场景不同现场固件升级面对的是已经装在设备上的板子芯片里已经有程序在跑可能还保存了设备参数。这时候用GD LINK Programmer烧录一定要小心“擦除整个芯片”这个选项。我的建议是升级固件时只擦除程序占用的扇区保留其他扇区比如用来存参数的扇区。操作方法是在软件的擦除设置里选择按扇区擦除而不是全片擦除。如果你的App程序放在0x08000000开始的地方长度假设是64KB那只需要擦除前几个扇区就够了。这个细节我踩过大坑有一次升级程序没注意擦除选项把客户设备里存了半年多的校准参数全擦了设备装回去全部需要重新校准那场面现在想起来还肉疼。5. 常见连接失败问题的排查实录5.1 连接失败的第一排查顺序GD LINK Programmer连接不上目标板是大家问得最多的问题。我这里整理了一个排查顺序按这个顺序查90%的问题能解决先检查线有没有接对SWDIO对应SWDIOSWCLK对应SWCLKGND必须接3V3视情况确认目标板有电量一下芯片电源引脚有没有3.3V拔掉目标板上其他占用SWD引脚的模块在软件里降低连接速度比如从5MHz降到1MHz检查芯片是否已经被设置了读保护还有一个经常被忽略的原因杜邦线太长或接触不良。SWD信号频率高的时候对线材质量敏感如果用了那种劣质杜邦线或者线长超过20cm就可能出现时而能连上时而不行。我的做法是调试时用最短的线量产时用焊接的牛角座再加排线不要用杜邦线堆长度。5.2 No target connected但明明硬件看起来没问题有一次我遇到一个迷惑性很强的问题GD LINK Programmer提示“No target connected”但万用表量了电压正常SWD两根线也没接错。排查了半天最后发现是芯片已经死了——程序里把时钟配置错了导致芯片进入异常状态SWD接口无法响应。解决办法是按住目标板的复位键不松手在GD LINK Programmer里点连接连接命令发出后立刻松开复位键。这个“Connect while reset”的操作可以绕过程序跑飞的状态让调试器在芯片刚从复位状态醒来的极短时间内建立连接。如果这个方法也不行就得检查BOOT0引脚了。把BOOT0拉高让芯片上电后进ISP Bootloader这时候Flash里的代码不执行SWD接口自然能连上。连上后先擦除整个芯片再恢复正常BOOT0状态重新烧录。5.3 芯片被读保护锁住怎么办如果你之前烧录时不小心开了读保护后面想再烧程序却发现连不上不要慌这不是芯片坏了。GD32的读保护解除操作是在软件的特殊功能菜单里选择“Unlock”或者“Remove Protection”执行后软件会执行一次全片擦除然后读保护就解除了。代价是芯片里的程序也没了需要重新烧录。但芯片本身是好的还能继续用。注意一点不同型号的GD32解除读保护的方式可能略有区别有的型号需要先擦除再解除顺序乱了可能失败。实操前先看一眼对应型号的用户手册或者直接在软件里按照提示一步步来。6. 配套开发环境与工具链衔接6.1 GD32 Pack包怎么装到Keil和IAR里GD32开发中一个常见问题是Keil或IAR里找不到GD32的设备支持。这需要安装GD32的Pack包。在Keil里安装非常简单打开Pack Installer在搜索框里输入“GD32”系统会自动从Keil的在线仓库里拉取兆易创新的Pack包列表。选中你使用的芯片系列比如GD32F30x点Install即可。如果在线搜索不到可以去兆易官网下载对应的Pack包文件.pack格式然后在Keil里用“File - Import”或者直接双击pack文件安装。IAR的安装方式稍有不同需要下载IAR的GD32支持插件或配置文件放在IAR安装目录的对应文件夹下。装完之后在IAR的Device选项里就能看到GD32系列了。我用的经验是Keil对GD32的支持比IAR更成熟一些如果项目没有特别要求优先选Keil能省不少折腾。6.2 免费的Embedded Builder和命令行编译除了Keil、IAR这种商业IDE兆易还提供了免费的Embedded Builder基于Eclipse开发。这个工具对于预算有限的团队和学生党特别友好不用破解官方免费编译GD32工程完全够用。Embedded Builder使用起来和STM32CubeIDE风格类似可以导入官方的例程工程也可以用GUI配置引脚。我试用过一段时间编译速度和大工程的处理都不错。唯一缺点是界面是英文的不过大家对IDE的英文界面应该早就习惯了。在Ubuntu环境下的开发很多人也用Eclipse或者直接命令行编译GD32工程。编译生成hex之后配合前面说的GD32_Programmer_CLI命令行工具就能在Linux环境下完成从编译到烧录的全流程。对于做CI/CD自动构建的团队来说这个链路很有价值。6.3 其他常用烧录方式的补充除了烧录器GD32还支持ISP串口烧录和DFU烧录。GD32的ISP烧录是通过串口USART0加载一段引导程序然后通过这段引导程序把用户代码写进Flash。这种方式适合产品已经装进外壳、不方便接调试线但留有串口接口的场景。官方提供了ISP例程和对应的上位机软件。使用方法是把BOOT0拉高上电后芯片进入Bootloader通过串口连接上位机选择hex文件即可烧录。另外关于J-Link能不能烧GD32答案是可以。J-Link的软件支持列表里本质上没有GD32但可以手动添加设备描述文件比如用Open Flash Loader或者添加HC32/HDSC类似的第三方芯片支持来实现烧录。不过我用下来的感受是J-Link不是为GD32专门优化的烧录GD32时速度和控制不如原生的GD-Link调试功能有时也有兼容性问题。如果只是临时应急用一下没毛病长期开发还是建议用官方工具。7. 几个实际项目中的经验沉淀最后聊聊我在实际项目里总结的几个心得算是比较个人的经验。关于文件格式我遇到过有些人为了“省事”只用bin文件结果地址填错导致整个板子不跑。我个人的习惯是开发阶段全部用hex只有在量产且需要把文件加密打包时才转换为bin并且每次都要单独确认起始地址。关于GD-Link和GD32芯片的兼容性早期市面上有很多GD-Link的仿制版本固件版本比较老对新型号GD32的支持不完整。如果出现连接不稳定、擦除失败、校验失败这类问题优先怀疑GD-Link固件版本太老。解决办法是升级GD-Link固件或者换个新款的调试器。我自己就遇到过GD32F470怎么都连不上换了新版GD-Link之后一次成功的情况。关于GD32和PY32这种国产M0/M3芯片的选择问题我个人的看法是GD32生态最成熟无论是文档、例程、工具链还是可以买到的开发板种类都是最多的。如果项目不着急、追求稳妥优先选GD32踩坑的概率小很多。PY32价格确实低但生态还在成长中有些工具链上的小问题需要自己摸索。如果你刚开始接触GD32我建议第一步不是急着写代码而是先把“编译-烧录-调试”这条路走通。用官方例程建一个最简单的流水灯工程编译生成hex用GD LINK Programmer烧进去。跑通了这一条路后面再复杂的项目至少烧录环节你心里是有底的。本文还有配套的精品资源点击获取
GD LINK Programmer 完整使用指南：从连接失败到量产烧录全解析
简介GD LINK Programmer是一款专为国产GD32系列微控制器打造的烧录编程工具面向嵌入式开发与硬件调试人员解决GD32芯片固件下载、擦除与验证环节的效率问题。GD32基于ARM Cortex-M内核广泛用于工业控制、消费电子与汽车电子因而该工具对相关项目研发尤为实用。资源以7z压缩包形式发布体积仅3.19MB轻量易用适合快速部署到开发环境。目前已有818人学习下载配套说明较为完整涵盖GD32全系列芯片兼容性、USB 2.0高速编程、在线固件更新、ISP/IAP编程模式及SWD/JTAG调试等核心特性并梳理了从驱动安装、设备连接到程序加载与烧录验证的完整流程同时还涉及错误检测与保护机制避免编程时损坏芯片。掌握该工具后开发者能显著减少烧录过程中的试错成本更顺畅地推进基于GD32的工业控制、物联网设备及消费电子项目开发。1. 打开GD LINK Programmer之前先搞懂整个烧录链路做GD32开发的人手里一定得有趁手的烧录工具。GD LINK Programmer是兆易创新官方提供的烧录软件配合GD-Link调试器那个几十块钱的小盒子使用负责把编译好的固件写进GD32芯片里。很多人第一次用它是在淘宝买开发板的时候商家送了个GD-Link然后甩过来一个软件压缩包里面就是这玩意儿。我最早接触GD32的时候也困惑过明明STM32用ST-Link用得好好的换到GD32为什么非得再装一个软件后来想明白了芯片厂商提供的官方烧录器一定是和自家芯片配合得最紧密的。GD32的Flash加密、OTP区写入、选项字节配置这些操作第三方工具要么不支持要么支持得不完整。你用J-Link搭配Keil也能调试GD32但到了量产阶段、要批量烧录的时候官方工具往往才是那个最稳的选择。这套链路实际是这样的PC上跑着GD LINK Programmer软件USB线连到GD-Link调试器调试器通过SWD接口四根线SWDIO、SWCLK、GND、3V3连到目标板上的GD32芯片。软件把hex或bin文件解析后通过SWD协议把数据写进芯片的Flash里。整个过程看起来简单但里面有不少坑比如连接不上、烧录一半报错、芯片锁死等等这篇文章把我这些年用GD LINK Programmer踩过的坑和沉淀下来的经验一次性写清楚。GD LINK Programmer适合谁看如果你正在用GD32做开发需要烧录调试或者你负责产线要给几百片板子批量烧固件又或者你刚拿到一块GD32开发板想搞清楚怎么把程序烧进去——这篇文章都能帮到你。2. 三个核心选项背后的逻辑烧录地址、芯片型号、下载方式2.1 芯片型号选择与Flash起始地址的关系GD LINK Programmer打开后第一件事是选择芯片型号。这个不能随便选选错了轻则烧录失败重则把Flash配置搞乱。GD32家族有很多系列GD32F103、GD32F303、GD32F407每个系列的内部Flash大小、页大小、扇区结构都不一样。比如GD32F103系列小容量型号Flash只有16KB大容量可以到128KB你选的型号如果和实际芯片不匹配软件可能按照错误的地址范围去擦写。关于烧录地址默认是0x08000000这是GD32内部Flash的起始地址和STM32完全一致。绝大多数应用代码都从这儿开始跑所以不需要改。但有一种情况要特别注意做Bootloader方案时App程序的烧录地址往往不是0x08000000而是往后偏移比如0x08008000。这时候在软件里需要手动修改烧录起始地址并且关闭“擦除整个芯片”的选项只擦除App所在的扇区否则会把Bootloader一并擦掉。2.2 hex和bin选哪个文件格式更省心编译完成之后你会得到两种常见的固件格式hex和bin。GD LINK Programmer两种都支持但我个人强烈建议优先用hex文件。hex文件是Intel十六进制格式每一行记录里除了数据本身还包含这条数据的起始地址信息。也就是说你在Keil或者Embedded Builder里设置好了烧录地址生成hex的时候地址已经写进去了烧录软件按着hex里的地址往Flash里写就行不用担心地址填错。bin文件则纯粹是原始二进制数据不包含地址信息烧录时全靠软件里填的那个起始地址来定位。如果你软件里地址填错了程序就写到错误的地方去了大概率跑不起来。所以我的建议是能用hex就用hex。尤其在Keil里勾选“Create HEX File”选项后再编译生成的hex文件自带完整的地址信息烧录的时候几乎不会出问题。2.3 连接方式SWD和JTAG怎么选GD LINK Programmer支持SWD和JTAG两种连接方式但实际使用中SWD的出场率几乎是100%。原因很简单SWD只需要四根线SWDIO、SWCLK、GND、3V3占用的引脚少而JTAG需要五六根线在一些小板子上引脚根本安排不过来。还有一点是速度。SWD接口在合适速率下烧录速度足够了GD32F103这种级别的芯片128KB的固件十来秒就能写完完全够用。软件的连接速度设置里我一般选自动或较高速率只有在连接不稳定时才手动降速。注意SWD的SWDIO和SWCLK这两个引脚在GD32上是可以被复用为普通GPIO的。如果你的程序里把这些引脚配置成普通IO口烧录器再想连接就困难了。遇到这种情况需要把芯片的BOOT0引脚拉高让芯片进入ISP模式后再尝试连接否则就得用“连接前按住复位键”的土办法。3. 实操GD32烧录从连接到校验的完整流程3.1 驱动安装与硬件连接很多人在GD LINK Programmer这里卡住其实不是软件问题是驱动问题。GD-Link调试器插上电脑后如果设备管理器里显示黄色的感叹号说明驱动没装好。去兆易官网下载GD32 MCU的DAP驱动包或者有些开发板厂商会提供专门的驱动安装程序装完后设备管理器里应该能看到一个“GD-Link”或“CMSIS-DAP”设备。硬件连接顺序上我有个习惯先把GD-Link和目标板用杜邦线连好再插USB。避免先插USB再连目标板时因为瞬间电平不确定导致芯片异常复位。接线还有个容易忽视的点3V3这个引脚要不要接很多人说只用三根线SWDIO、SWCLK、GND就能烧录这个说法对ST-Link适用因为ST-Link有内部供电能力。GD-Link部分版本也可以通过3V3引脚给目标板供电但电流有限如果你的板子上还有其他外设最好还是各自独立供电只接GND保证共地。不共地会导致SWD信号参考电平不对烧录失败的概率很高。3.2 烧录界面配置与参数选择连接好硬件打开GD LINK Programmer界面左侧会有配置项。关键的几项是Target Device选对芯片型号Connection TypeSWDTarget Connection Speed默认即可不稳再降速Download File选择hex文件Target Power如果GD-Link给板子供电勾上独立供电则不勾配置完成后点“Connect”按钮。正常情况下状态栏会显示连接成功同时读出芯片的ID。如果读出来的是全FF或者全是0说明连接有问题先检查接线。连接成功后点“Download”软件会依次执行擦除、写入、校验的操作。整个过程进度条会走动完成后提示烧录成功。GD LINK Programmer默认烧录完成后会做一次校验确保写入的数据和文件完全一致这个功能不要关量产的时候特别重要。3.3 烧录完成后的确认动作烧录成功不代表大功告成。我每次烧完都会做三件事看代码能不能跑给板上电观察程序运行现象如果程序没跑检查复位电路和BOOT引脚重新Read Flash读出内容和hex文件比对大小确认确实烧进去了有时候烧录显示成功但程序不跑多半是Boot0引脚配置的问题。GD32的BOOT0拉低是从主Flash启动如果BOOT0是高电平芯片会进Bootloader而不是跑你的程序表现就是烧录成功但没反应。4. 量产烧录与固件升级的实用经验4.1 用命令行实现一键烧录如果你只是开发阶段用GD LINK Programmer图形界面完全够用。但到了产线一条产线一天要烧几十上百片板子每片都打开软件点几下效率太低还容易误操作。GD LINK Programmer软件本身支持命令行模式安装目录下有一个CLI相关的可执行文件可以带参数执行烧录操作。比如GD32_Programmer_CLI.exe --device GD32F103C8T6 --connect_mode swd --download_file app.hex --verify参数的含义依次是指定芯片型号、连接方式、下载文件、烧录后校验。这样只要写一个批处理脚本产线工人双击一下就能自动完成烧录和校验每分钟能多烧好几片板子。我当年在产线调试的时候把命令行封装成了一个bat文件还加了错误提示音烧录成功播放一个“滴”声失败播放另一个声音。这样工人不用盯着屏幕听声音就知道结果。4.2 量产时的芯片保护配置量产烧录时还有一个关键操作是设置Flash读保护。如果不设置读保护别人拿到你的板子用烧录器直接Read Flash就能把程序读出来逆向成本极低。GD32支持设置读保护级别一般在GD LINK Programmer的Security或Option Bytes页面里配置。打开读保护后芯片只能被擦除不能被读取。要注意的是一旦设置读保护后面再想用调试器调试就得先解除保护而解除保护的过程会擦除整个Flash代码会丢。所以量产顺序应该是先烧录程序再设置读保护之后不再做调试。4.3 现场固件升级时的注意事项和量产场景不同现场固件升级面对的是已经装在设备上的板子芯片里已经有程序在跑可能还保存了设备参数。这时候用GD LINK Programmer烧录一定要小心“擦除整个芯片”这个选项。我的建议是升级固件时只擦除程序占用的扇区保留其他扇区比如用来存参数的扇区。操作方法是在软件的擦除设置里选择按扇区擦除而不是全片擦除。如果你的App程序放在0x08000000开始的地方长度假设是64KB那只需要擦除前几个扇区就够了。这个细节我踩过大坑有一次升级程序没注意擦除选项把客户设备里存了半年多的校准参数全擦了设备装回去全部需要重新校准那场面现在想起来还肉疼。5. 常见连接失败问题的排查实录5.1 连接失败的第一排查顺序GD LINK Programmer连接不上目标板是大家问得最多的问题。我这里整理了一个排查顺序按这个顺序查90%的问题能解决先检查线有没有接对SWDIO对应SWDIOSWCLK对应SWCLKGND必须接3V3视情况确认目标板有电量一下芯片电源引脚有没有3.3V拔掉目标板上其他占用SWD引脚的模块在软件里降低连接速度比如从5MHz降到1MHz检查芯片是否已经被设置了读保护还有一个经常被忽略的原因杜邦线太长或接触不良。SWD信号频率高的时候对线材质量敏感如果用了那种劣质杜邦线或者线长超过20cm就可能出现时而能连上时而不行。我的做法是调试时用最短的线量产时用焊接的牛角座再加排线不要用杜邦线堆长度。5.2 No target connected但明明硬件看起来没问题有一次我遇到一个迷惑性很强的问题GD LINK Programmer提示“No target connected”但万用表量了电压正常SWD两根线也没接错。排查了半天最后发现是芯片已经死了——程序里把时钟配置错了导致芯片进入异常状态SWD接口无法响应。解决办法是按住目标板的复位键不松手在GD LINK Programmer里点连接连接命令发出后立刻松开复位键。这个“Connect while reset”的操作可以绕过程序跑飞的状态让调试器在芯片刚从复位状态醒来的极短时间内建立连接。如果这个方法也不行就得检查BOOT0引脚了。把BOOT0拉高让芯片上电后进ISP Bootloader这时候Flash里的代码不执行SWD接口自然能连上。连上后先擦除整个芯片再恢复正常BOOT0状态重新烧录。5.3 芯片被读保护锁住怎么办如果你之前烧录时不小心开了读保护后面想再烧程序却发现连不上不要慌这不是芯片坏了。GD32的读保护解除操作是在软件的特殊功能菜单里选择“Unlock”或者“Remove Protection”执行后软件会执行一次全片擦除然后读保护就解除了。代价是芯片里的程序也没了需要重新烧录。但芯片本身是好的还能继续用。注意一点不同型号的GD32解除读保护的方式可能略有区别有的型号需要先擦除再解除顺序乱了可能失败。实操前先看一眼对应型号的用户手册或者直接在软件里按照提示一步步来。6. 配套开发环境与工具链衔接6.1 GD32 Pack包怎么装到Keil和IAR里GD32开发中一个常见问题是Keil或IAR里找不到GD32的设备支持。这需要安装GD32的Pack包。在Keil里安装非常简单打开Pack Installer在搜索框里输入“GD32”系统会自动从Keil的在线仓库里拉取兆易创新的Pack包列表。选中你使用的芯片系列比如GD32F30x点Install即可。如果在线搜索不到可以去兆易官网下载对应的Pack包文件.pack格式然后在Keil里用“File - Import”或者直接双击pack文件安装。IAR的安装方式稍有不同需要下载IAR的GD32支持插件或配置文件放在IAR安装目录的对应文件夹下。装完之后在IAR的Device选项里就能看到GD32系列了。我用的经验是Keil对GD32的支持比IAR更成熟一些如果项目没有特别要求优先选Keil能省不少折腾。6.2 免费的Embedded Builder和命令行编译除了Keil、IAR这种商业IDE兆易还提供了免费的Embedded Builder基于Eclipse开发。这个工具对于预算有限的团队和学生党特别友好不用破解官方免费编译GD32工程完全够用。Embedded Builder使用起来和STM32CubeIDE风格类似可以导入官方的例程工程也可以用GUI配置引脚。我试用过一段时间编译速度和大工程的处理都不错。唯一缺点是界面是英文的不过大家对IDE的英文界面应该早就习惯了。在Ubuntu环境下的开发很多人也用Eclipse或者直接命令行编译GD32工程。编译生成hex之后配合前面说的GD32_Programmer_CLI命令行工具就能在Linux环境下完成从编译到烧录的全流程。对于做CI/CD自动构建的团队来说这个链路很有价值。6.3 其他常用烧录方式的补充除了烧录器GD32还支持ISP串口烧录和DFU烧录。GD32的ISP烧录是通过串口USART0加载一段引导程序然后通过这段引导程序把用户代码写进Flash。这种方式适合产品已经装进外壳、不方便接调试线但留有串口接口的场景。官方提供了ISP例程和对应的上位机软件。使用方法是把BOOT0拉高上电后芯片进入Bootloader通过串口连接上位机选择hex文件即可烧录。另外关于J-Link能不能烧GD32答案是可以。J-Link的软件支持列表里本质上没有GD32但可以手动添加设备描述文件比如用Open Flash Loader或者添加HC32/HDSC类似的第三方芯片支持来实现烧录。不过我用下来的感受是J-Link不是为GD32专门优化的烧录GD32时速度和控制不如原生的GD-Link调试功能有时也有兼容性问题。如果只是临时应急用一下没毛病长期开发还是建议用官方工具。7. 几个实际项目中的经验沉淀最后聊聊我在实际项目里总结的几个心得算是比较个人的经验。关于文件格式我遇到过有些人为了“省事”只用bin文件结果地址填错导致整个板子不跑。我个人的习惯是开发阶段全部用hex只有在量产且需要把文件加密打包时才转换为bin并且每次都要单独确认起始地址。关于GD-Link和GD32芯片的兼容性早期市面上有很多GD-Link的仿制版本固件版本比较老对新型号GD32的支持不完整。如果出现连接不稳定、擦除失败、校验失败这类问题优先怀疑GD-Link固件版本太老。解决办法是升级GD-Link固件或者换个新款的调试器。我自己就遇到过GD32F470怎么都连不上换了新版GD-Link之后一次成功的情况。关于GD32和PY32这种国产M0/M3芯片的选择问题我个人的看法是GD32生态最成熟无论是文档、例程、工具链还是可以买到的开发板种类都是最多的。如果项目不着急、追求稳妥优先选GD32踩坑的概率小很多。PY32价格确实低但生态还在成长中有些工具链上的小问题需要自己摸索。如果你刚开始接触GD32我建议第一步不是急着写代码而是先把“编译-烧录-调试”这条路走通。用官方例程建一个最简单的流水灯工程编译生成hex用GD LINK Programmer烧进去。跑通了这一条路后面再复杂的项目至少烧录环节你心里是有底的。本文还有配套的精品资源点击获取
多肽：结构差异、信号机制与骨代谢药物研发价值解析)
