CH347 USB转SWD/JTAG调试STM32全攻略

1. 项目概述

CH347/339W是一款国产多功能接口芯片，它集成了SPI、I2C、JTAG、SWD、UART和GPIO等多种接口功能。这个开源项目旨在充分发挥该芯片的潜力，为嵌入式开发者提供一套完整的硬件调试和程序下载解决方案。在前三篇文章中，我们已经介绍了该芯片的基本功能、温湿度监测应用以及Xilinx FPGA的下载调试功能。本文将重点讲解如何利用CH347的USB转SWD/JTAG功能，结合OpenOCD工具实现常见MCU（如STM32系列）的程序下载。

对于嵌入式开发者来说，一个可靠、高效的调试和下载工具至关重要。传统方案往往需要购买昂贵的专用调试器，而CH347提供了一种高性价比的替代方案。它不仅能实现基本的程序下载功能，还能通过开源工具链进行深度定制，满足不同开发场景的需求。

2. 硬件准备与连接

2.1 所需硬件清单

要完成本项目的搭建，你需要准备以下硬件设备：

• CH347/339W开发板（市面上有多种兼容型号，建议选择带完整接口引出的版本）
• 目标MCU开发板（如STM32F103C8T6最小系统板）
• USB Type-C数据线（用于连接CH347和电脑）
• 杜邦线若干（建议使用不同颜色区分信号线）
• 可选：逻辑分析仪（用于调试信号时序问题）

2.2 接口连接示意图

CH347与目标MCU的连接方式取决于你使用的调试接口类型（SWD或JTAG）。以下是两种常见连接方式：

SWD模式连接（推荐）：

code复制CH347       STM32
SWDIO  -->  SWDIO
SWCLK  -->  SWCLK
GND    -->  GND
3.3V   -->  VCC (可选，可为目标板供电)

JTAG模式连接：

code复制CH347       STM32
TMS    -->  JTMS
TCK    -->  JTCK
TDI    -->  JTDI
TDO    -->  JTDO
GND    -->  GND
3.3V   -->  VCC (可选)

重要提示：由于CH347的引脚复用特性，SWD/JTAG功能不能与FPGA调试功能同时使用。在实际操作前，请确保硬件跳线或软件配置正确。

3. 软件环境配置

3.1 驱动安装与验证

首先需要安装CH347的USB驱动程序：

1. 从厂商官网下载最新版CH347驱动（Windows系统通常提供.inf安装包）
2. 连接CH347开发板到电脑，等待系统识别新硬件
3. 在设备管理器中确认"USB2.0转接桥"设备已正确安装

验证驱动是否正常工作：

bash复制# Linux系统下可以使用lsusb命令检查
lsusb | grep "1a86:55db"
# 应该能看到类似输出：Bus 001 Device 003: ID 1a86:55db QinHeng Electronics CH347

3.2 OpenOCD安装与配置

OpenOCD是开源的片上调试工具，我们需要对其进行定制以支持CH347：

Windows平台安装：

1. 下载预编译的OpenOCD二进制包（推荐使用xPack版本）
2. 解压到不含中文和空格的路径（如C:\tools\xpack-openocd）
3. 将bin目录添加到系统PATH环境变量

Linux平台安装（以Ubuntu为例）：

bash复制sudo apt install openocd
# 或者从源码编译最新版
git clone git://git.code.sf.net/p/openocd/code openocd
cd openocd
./bootstrap
./configure --enable-ch347
make
sudo make install

3.3 配置文件准备

创建CH347专用的OpenOCD配置文件（ch347.cfg）：

tcl复制# CH347接口配置
interface ch347
ch347_vid_pid 0x1a86 0x55db
ch347_jtag_clock 1000

# 目标MCU配置（以STM32F1x为例）
source [find target/stm32f1x.cfg]

# 调试选项
reset_config srst_only
adapter speed 1000

4. 图形化界面使用详解

4.1 界面功能区域解析

项目提供的图形化界面主要包含以下几个功能区域：

1. 连接设置区：选择接口类型(SWD/JTAG)、设置通信速率
2. 目标MCU选择区：下拉菜单选择MCU型号
3. 文件配置区：指定烧录文件(HEX/BIN/ELF)和起始地址
4. 操作按钮区：连接/断开、烧录、擦除等操作按钮
5. 日志输出区：显示操作过程和调试信息

4.2 完整烧录流程演示

1. 硬件连接检查

   • 确认CH347与目标板连接正确
   • 确保目标板供电正常（可通过CH347的3.3V输出或外部电源）

2. 软件配置步骤

   • 选择正确的接口类型（SWD或JTAG）
   • 从下拉菜单中选择目标MCU型号（如STM32F103C8）
   • 设置适当的通信速率（初次使用建议选择较低速率如100kHz）

3. 文件选择注意事项

   • HEX文件：包含地址信息，无需指定起始地址
   • BIN文件：必须手动输入正确的起始地址（如STM32F1系列通常为0x08000000）
   • ELF文件：包含调试信息，适合开发阶段使用

4. 执行烧录操作

   • 点击"连接"按钮建立调试会话
   • 点击"擦除"按钮清除芯片原有内容（可选）
   • 点击"烧录"按钮开始编程过程
   • 等待进度条完成，确认日志区无错误信息

实测技巧：如果遇到连接失败，尝试以下步骤：

1. 降低通信速率
2. 检查硬件连接，特别是GND线
3. 重启OpenOCD服务
4. 确认目标MCU没有处于低功耗模式

5. 高级配置与问题排查

5.1 速度优化技巧

默认配置下，CH347的SWD/JTAG接口工作在相对保守的速率。通过以下方法可以优化传输速度：

1. 修改OpenOCD配置中的时钟设置：

tcl复制# 在ch347.cfg中增加
adapter speed 4000  # 单位kHz，根据实际情况调整

2. 启用快速编程模式（仅适用于全片擦除后编程）：

tcl复制program filename.bin fast verify

3. 禁用不必要的校验步骤（开发阶段可用）：

tcl复制program filename.bin verify off

5.2 常见错误与解决方案

问题1：无法建立连接

• 现象：OpenOCD报告"Error: unable to open CMSIS-DAP device"
• 可能原因：
  • 驱动未正确安装
  • 其他程序占用了USB设备
  • 硬件连接问题
• 解决方案：
  • 检查设备管理器中的驱动状态
  • 重启OpenOCD服务
  • 尝试更换USB端口

问题2：烧录验证失败

• 现象：编程过程完成但校验失败
• 可能原因：
  • 目标板供电不足
  • 时钟速率过高
  • Flash保护位未解除
• 解决方案：
  • 确保目标板有稳定电源（建议额外供电）
  • 降低通信速率重试
  • 执行全片擦除操作

问题3：芯片无法识别

• 现象：OpenOCD无法识别目标MCU IDCODE
• 可能原因：
  • 接口类型选择错误（如该MCU仅支持SWD但选择了JTAG）
  • 复位电路异常
  • 芯片处于低功耗模式
• 解决方案：
  • 确认MCU支持的调试接口类型
  • 尝试手动复位目标板
  • 检查BOOT引脚配置

5.3 自定义目标MCU支持

如果项目中使用的MCU不在默认支持列表中，可以通过以下步骤添加支持：

1. 查找MCU的OpenOCD配置文件（通常位于/openocd/scripts/target/）
2. 如果没有现成配置，参考类似型号的配置文件创建新文件
3. 主要需要配置的参数包括：
   • Flash存储布局
   • 调试接口类型
   • 复位方式
   • 芯片IDCODE

示例（为STM32L4系列添加支持）：

tcl复制# stm32l4x.cfg
source [find target/stm32l4x.cfg]

# 覆盖默认配置
set WORKAREASIZE 0x4000
set FLASH_SIZE 0x100000

6. 性能测试与对比

6.1 传输速率实测数据

我们对CH347在不同模式下的编程速度进行了测试（以STM32F103C8T6为测试目标，编程128KB数据）：

从测试数据可以看出：

1. SWD模式略快于JTAG模式
2. 提高时钟速率能显著减少编程时间
3. 擦除时间基本不受接口速率影响

6.2 与专业调试器对比

我们将CH347方案与常见的ST-Link和J-Link进行了对比：

CH347方案的优势在于高性价比和多功能性，特别适合预算有限或需要灵活接口的开发者。而专业调试器在稳定性和极限性能上仍有优势。

7. 实际应用案例

7.1 批量生产编程方案

在小型批量生产中，可以使用CH347配合自动化脚本实现无人值守编程：

1. 准备Python控制脚本：

python复制import subprocess
import time

def program_device(hex_file):
    cmd = f"openocd -f ch347.cfg -c 'program {hex_file} verify reset exit'"
    try:
        subprocess.run(cmd, shell=True, check=True)
        return True
    except subprocess.CalledProcessError:
        return False

# 主循环
while True:
    if new_file_available():
        hex_file = get_latest_hex()
        if program_device(hex_file):
            move_to_done_folder(hex_file)

2. 硬件连接方案：
   • 使用USB Hub连接多个CH347适配器
   • 设计夹具确保目标板接触可靠
   • 添加状态指示灯显示编程结果

7.2 教育实验平台集成

CH347非常适合用于嵌入式教学实验平台：

1. 实验设计思路：

   • 基础实验：LED控制、按键输入
   • 进阶实验：外设驱动开发
   • 高级实验：RTOS移植与应用

2. 教学优势：

   • 低成本替代专业调试器
   • 开源工具链培养学生底层认知
   • 多功能接口支持多种实验场景

3. 典型实验流程：

   mermaid复制graph TD
   A[编写实验代码] --> B[编译生成HEX文件]
   B --> C[通过CH347烧录]
   C --> D[观察实验现象]
   D --> E[调试修改代码]
   E --> A
   

8. 项目扩展与进阶应用

8.1 多设备并行调试

通过USB Hub连接多个CH347适配器，可以实现多设备并行调试：

1. 硬件配置：

   • 每个CH347分配独立的USB端口
   • 为每个目标板提供独立电源

2. OpenOCD配置示例：

tcl复制# 设备1配置
interface ch347
ch347_vid_pid 0x1a86 0x55db
ch347_serial "A1001"
source [find target/stm32f1x.cfg]

# 设备2配置
interface ch347
ch347_vid_pid 0x1a86 0x55db
ch347_serial "B2002"
source [find target/stm32f4x.cfg]

3. 启动命令：

bash复制openocd -f device1.cfg -c "telnet_port 4444" &
openocd -f device2.cfg -c "telnet_port 4445" &

8.2 自定义调试命令

通过OpenOCD的TCL脚本扩展，可以添加自定义调试命令：

1. 创建命令脚本（custom_commands.tcl）：

tcl复制proc read_reg {reg} {
    set value [mrw $reg]
    echo [format "Register 0x%08x: 0x%08x" $reg $value]
    return $value
}

proc write_reg {reg value} {
    mww $reg $value
    echo [format "Write 0x%08x to 0x%08x" $value $reg]
}

2. 在配置文件中加载：

tcl复制source [find custom_commands.tcl]

3. 使用示例：

bash复制telnet localhost 4444
> read_reg 0x40021000
Register 0x40021000: 0x00000000
> write_reg 0x40021000 0x00000001
Write 0x00000001 to 0x40021000

8.3 性能监控与优化

通过扩展界面功能，可以添加实时性能监控：

1. 添加传输速率显示：

   • 计算单位时间内传输的字节数
   • 显示实时速率和平均速率

2. 添加时序分析功能：

   • 使用逻辑分析仪捕获信号波形
   • 分析信号完整性和时序余量

3. 优化建议生成：

   • 根据当前配置和性能数据
   • 提供参数调整建议

9. 项目资源与社区支持

9.1 获取项目资源

本项目所有资源均开源提供：

• 硬件设计文件（GitHub仓库）
• 固件源代码（Gitee镜像）
• 文档与教程（项目Wiki）

最新版本获取方式：

bash复制git clone https://github.com/your-repo/ch347-openocd.git
cd ch347-openocd
git submodule update --init

9.2 参与社区贡献

欢迎开发者参与项目改进：

1. 代码贡献流程：

   • Fork项目仓库
   • 创建特性分支
   • 提交Pull Request

2. 文档改进建议：

   • 通过Issue报告问题
   • 直接提交文档修改

3. 测试反馈渠道：

   • 提供不同硬件平台的测试结果
   • 分享使用经验和技巧

9.3 常见问题知识库

项目维护了常见问题知识库，涵盖：

• 硬件连接问题
• 驱动安装问题
• 编译环境配置
• 特殊MCU支持

知识库访问方式：

code复制/docs/FAQ.md

10. 未来发展方向

10.1 功能扩展路线图

1. 短期计划（v1.1）：

   • 增加更多MCU型号支持
   • 优化图形界面用户体验
   • 完善文档和示例代码

2. 中期计划（v2.0）：

   • 添加网络远程调试功能
   • 支持脚本自动化测试
   • 开发移动端配套应用

3. 长期愿景：

   • 构建完整的开源工具链
   • 支持RISC-V等更多架构
   • 形成生态系统

10.2 硬件改进建议

基于用户反馈，下一代硬件可能改进：

1. 增加隔离保护电路
2. 优化电源设计
3. 添加状态指示灯
4. 缩小封装尺寸

10.3 软件优化方向

软件方面的持续优化包括：

1. 提升传输稳定性
2. 减少资源占用
3. 增强错误处理
4. 改进跨平台支持

在实际使用CH347进行MCU开发的过程中，我发现合理配置OpenOCD参数对稳定性影响很大。特别是在高速传输时，适当增加延时参数往往能解决看似复杂的连接问题。另一个实用技巧是在批处理脚本中添加自动重试逻辑，可以显著提高生产环境下的编程成功率。