1. GD32F103程序下载方式概览
作为GD32F103系列开发者的第一课，掌握程序下载方法是必经之路。这颗国产Cortex-M3芯片支持三种主流下载方式：SWD、JTAG和串口ISP。每种方式各有优劣，就像选择交通工具一样——SWD如同地铁快速高效，JTAG像公交车线路全面，而串口ISP则是随时可用的共享单车。
实际项目中我最常用的是SWD接口，它只需要4根线（VCC、GND、SWDIO、SWCLK）就能完成调试和下载，特别适合空间受限的PCB设计。JTAG接口虽然多出3根线，但在复杂调试场景下更占优势。至于串口ISP，则是没有调试器时的救命稻草，通过BootLoader实现最基础的固件更新。
这里有个容易忽略的细节：GD32F103的SWD接口默认是开启的，但某些情况下可能会被误关闭。去年我就遇到过客户自己写的程序禁用了SWD功能，导致无法再次下载的尴尬情况。这时候就需要通过串口ISP先恢复默认设置，这个坑后面会详细说明。
2. SWD下载实战详解
2.1 硬件连接要点
SWD下载的硬件连接看似简单，但魔鬼藏在细节里。首先需要准备一个ST-Link V2调试器（兼容GD32），连接时要注意：
- 目标板供电最好保持在3.3V（GD32F103的工作电压）
- SWDIO对应PA13，SWCLK对应PA14
- 如果目标板自带调试接口，建议优先使用其提供的SWD插座
我遇到过最奇葩的问题是客户用杜邦线连接时接触不良，导致下载时好时坏。后来改用弹簧针连接器就再没出现过问题。这里分享一个检测连接的小技巧：用万用表测量SWCLK对地电阻，正常应在几百欧姆范围，如果显示开路就要检查连接了。
2.2 Keil环境配置
在Keil MDK中配置SWD下载需要三步：
- 进入Options for Target -> Debug选项卡
- 选择ST-Link Debugger并点击Settings
- Port选择SW，Max Clock建议设为1MHz（过高可能导致不稳定）
// 调试时常遇到的错误代码及解决方法： // Error: Flash Download failed - Target DLL has been cancelled // 解决方法：检查复位电路，尝试按住复位键下载 // Error: No ULINK Device found // 解决方法：重新插拔ST-Link，更新驱动有个实用技巧是勾选"Reset and Run"选项，这样下载后会自动运行程序，不用手动复位。对于需要频繁下载调试的场景，这个功能能节省大量时间。
2.3 STM32 ST-LINK Utility使用
当没有源代码只有hex/bin文件时，这个工具就派上用场了。操作流程：
- 连接硬件后点击Connect
- 选择Target->Program...
- 加载文件时注意：
- hex文件自动包含地址信息
- bin文件需手动指定起始地址（0x80000000）
我帮客户排查过一个典型问题：他们下载bin文件时忘记填地址，结果程序跑到异常区域。这里要特别注意GD32的Flash起始地址与STM32相同，都是0x80000000，但某些国产芯片可能会有所不同。
3. JTAG下载操作指南
3.1 接口定义对比
JTAG相比SWD多了TMS、TDO、TDI三根线，20针标准接口定义如下：
| 引脚 | 信号 | GD32对应引脚 |
|---|---|---|
| 1 | VREF | 3.3V |
| 2 | VCC | VDD |
| 3 | TRST | NC |
| 4 | GND | GND |
| 5 | TDI | PA15 |
| 6 | GND | GND |
| 7 | TMS | PA13 |
| 8 | GND | GND |
| 9 | TCK | PA14 |
| 10 | GND | GND |
| 11 | TDO | PB3 |
| 13 | RST | NRST |
实际项目中我通常建议只保留必要引脚，特别是空间紧张时。JTAG的优势在于支持更复杂的调试场景，比如同时观察多个内核寄存器。
3.2 调试器配置差异
在Keil中使用JTAG需要特别注意：
- Debug设置中选择"JTAG"而不是"SW"
- 时钟频率建议初始设为500kHz
- 勾选"Enable"选项下的所有调试功能
遇到过的一个坑是：某些国产调试器的JTAG时序不够稳定，在高速时钟下容易出现通信错误。这时候降低时钟频率往往能解决问题。
4. 串口ISP下载全流程
4.1 Boot模式配置
串口下载需要先将芯片置于ISP模式：
- 将BOOT0引脚拉高（接3.3V）
- 将BOOT1引脚拉低（接地）
- 复位芯片（或重新上电）
这里有个实用技巧：可以在板子上设计一个跳线帽来切换BOOT0电平，方便随时进入ISP模式。我见过有客户用按键控制，结果发现按键抖动导致模式切换不可靠，最后还是改回了跳线帽方案。
4.2 常用工具对比
推荐三款串口下载工具：
- GD官方ISP工具（稳定但界面老旧）
- Flash Loader Demonstrator（ST官方工具兼容GD）
- 自研Python脚本（适合批量生产）
以Flash Loader为例的操作步骤：
- 选择正确的COM口和波特率（建议115200）
- 点击Next进入模式选择
- 选择"Download to device"
- 指定hex/bin文件和起始地址
- 勾选"Verify after download"校验
# 简易Python串口ISP脚本示例 import serial import time ser = serial.Serial('COM3', 115200, timeout=1) ser.write(b"\x7F") # 同步字符 time.sleep(0.1) # 发送更多指令...4.3 常见故障处理
串口下载最常见的问题是连接失败，排查步骤：
- 检查BOOT引脚电平（必须BOOT0=1，BOOT1=0）
- 测量串口TX/RX是否接反（GD32的USART1_TX应接转换器RX）
- 尝试降低波特率（有些USB转串口芯片不稳定）
去年遇到一个典型案例：客户使用CH340转换器始终无法连接，换成FT232就正常了。后来发现是CH340的驱动版本太旧导致时序问题。
5. 高级技巧与疑难解答
5.1 下载失败排查手册
根据多年经验总结的排查流程图：
- 检查电源（3.3V是否稳定）
- 检查复位电路（NRST引脚应有正确波形）
- 确认时钟源（HSI/HSE是否正常工作）
- 验证接口连接（SWD/JTAG信号线通断）
- 查看选项字节（是否误关闭了调试接口）
特别提醒：GD32的Flash编程电压要求2.7-3.6V，电压不足会导致编程失败。曾有用锂电池供电的客户，电量低时频繁出现下载失败，就是这个原因。
5.2 安全与加密设置
GD32提供了多种保护机制：
- 读保护（防止代码被读取）
- 写保护（防止Flash被意外修改）
- 芯片唯一ID（用于加密验证）
设置方法（以Keil为例）：
- 进入Options for Target -> Utilities
- 点击Settings进入Flash Download配置
- 在"Protection"选项卡设置相应选项
解除保护时需要特别注意：如果启用了最高级别的读保护，只能通过全片擦除解除，这会导致所有代码丢失。建议开发阶段先不要启用，等量产时再设置。
5.3 批量生产方案
对于量产烧录，推荐几种方案：
- 脱机编程器（如J-Link EDU配合量产底座）
- SWD多路复用器（同时烧录多片）
- 串口自动化工装（配合机械臂使用）
成本最低的方案是使用Python脚本控制USB转SWD工具，配合简单的治具实现半自动烧录。我曾经帮客户实现过每小时300片的烧录速度，良品率99.9%以上。
