简介这份资源是面向嵌入式开发者与硬件调试爱好者的CMSIS-DAP裸板实现方案基于ARM的CMSIS-DAP标准帮助使用者在无专用调试器的情况下通过USB接口对目标芯片进行JTAG或SWD调试。资源由“技小新”整理的第三版经过精简与稳定性优化适合希望自建调试工具或深入理解底层调试机制的工程师。压缩包共164个文件约6.38MB以c与h源码、Keil工程文件、编译中间产物及Gerber生产文件为主另含原理图、说明文档与烧录固件覆盖从软件到硬件的完整链路。其中代码_V1.4可直接烧录至STM32F103等微控制器原理图与PCB文件便于自行打板验证。目前已有831人学习下载读者可借此掌握USB通信、DAP协议实现与调试接口硬件设计快速搭建属于自己的调试环境。1. 从一块裸板说起CMSIS-DAP 调试器固件到底能解决什么手头有一块空白的 Cortex-M 开发板板载一颗常见的 STM32F103 或同级别 MCU没有板载调试器手边也没有独立仿真器。这时候最省事的做法是把这块板子刷成 CMSIS-DAP 固件让它变成一台能被 Keil、IAR、OpenOCD、pyOCD 识别的调试探针再去调试另一块目标板。CMSIS_DAP_裸板.zip 就是干这件事的资源包——它面向的是“裸板”场景也就是你手上只有一颗光板 MCU没有现成的调试器固件需要自己把 DAP 固件烧进去。CMSIS-DAP 是 ARM 定义的一套调试接口协议主机端通过 USB HID 或 WinUSB 与探针通信探针再通过 SWD/JTAG 驱动目标芯片。它的价值在于免驱、跨平台、协议开放Linux 下不用装厂商私有驱动macOS 上也能直接跑 OpenOCD。适合谁适合手里有闲置开发板、想低成本搭一套调试环境的嵌入式从业者也适合需要批量产线烧录、想用脚本控制多路 DAP 的场景。技小新这类关键词背后其实是很多人在找“怎么把一块普通板子变成 DAP 探针”的可落地路径这个包就是那条路径的起点。2. 拆包看结构固件、配置与烧录入口怎么对应2.1 包内典型文件构成与作用拿到 CMSIS_DAP_裸板.zip 之后先别急着烧。解压后一般能看到几类东西编译好的固件二进制.bin/.hex/.elf、对应不同目标芯片的工程源码或配置头文件、以及一份说明烧录方式的文档。固件二进制是直接可烧的成品源码工程则是给你改引脚、改 VID/PID、改时钟用的。裸板场景下最关键的是确认固件对应的 MCU 型号和封装因为引脚映射一旦对不上SWD 信号就出不来。常见做法是先用unzip -l看一眼包内清单再决定走“直接烧成品”还是“改源码重编译”两条路。如果只是想让板子尽快变成探针直接烧成品最快如果要改 USB 描述符或引脚就得进源码。# 查看压缩包内容不急着解压 unzip -l CMSIS_DAP_裸板.zip # 解压到独立目录避免污染当前工作区 unzip CMSIS_DAP_裸板.zip -d cmsis_dap_bare逻辑说明第一条命令只列清单帮你判断包里是成品固件还是源码工程第二条解压到独立目录方便后续用 git 管理改动。参数上-d指定输出目录避免文件散落一地。2.2 固件与目标 MCU 的匹配判断裸板能不能用第一步是确认固件里的时钟配置和引脚定义跟你手上板子一致。CMSIS-DAP 固件通常会把 SWCLK、SWDIO、以及可选的 SWO、nRESET 映射到特定 GPIO。如果固件是按某款最小系统板编的而你的板子 LED 或按键占用了这些脚就会出现“USB 认到了但连不上目标”的玄学现象。判断方法打开源码里的DAP_config.h或类似头文件找SWCLK_PIN、SWDIO_PIN这类宏对照你板子的原理图。对不上就改宏重新编译。改完记得同步改DAP_config.h里的端口时钟使能否则引脚配了也不工作。配置项常见取值说明SWCLK 引脚PA14 / PB13 等必须与原理图一致SWDIO 引脚PA13 / PB12 等双向注意上下拉USB DP/DMPA12/PA11固定复用不可随意改时钟源内部 HSI / 外部 HSE影响 USB 枚举稳定性提示改引脚后如果 USB 枚举失败先查时钟配置再查 USB 中断优先级最后才怀疑硬件。3. 从零烧录把裸板变成可识别的 DAP 探针3.1 用现有工具完成首次烧录裸板第一次烧录是鸡生蛋问题你还没有 DAP怎么烧 DAP 固件常见做法有三种——用另一台现成调试器通过 SWD 烧、用串口 ISP 烧、用 DFU 模式烧。STM32 系列最省事的是串口 ISPBOOT0 拉高、BOOT1 拉低上电进系统存储器然后用stm32flash或官方工具写入。# 串口 ISP 方式烧录/dev/ttyUSB0 换成实际串口 stm32flash -w cmsis_dap_bare/firmware.bin -v -g 0x0 /dev/ttyUSB0逻辑说明-w指定要写入的固件-v校验写入结果-g 0x0表示写完从 0x0 地址开始执行。参数里串口设备名要按实际改Linux 下常见是/dev/ttyUSB0或/dev/ttyACM0。烧完把 BOOT0 拉回低电平重新上电板子就应该以 DAP 探针身份枚举。3.2 验证枚举与驱动状态烧录完成后插上 USB先看系统有没有认到设备。Linux 下用lsusbWindows 下看设备管理器。CMSIS-DAP 通常枚举为 HID 设备VID/PID 可能是0x0D28:0x0204这类。如果认到了但 OpenOCD 连不上多半是权限或驱动匹配问题。# 查看 USB 设备确认 DAP 是否枚举 lsusb | grep -i dap # 用 pyOCD 列出可用探针验证协议层是否通 pyocd list逻辑说明lsusb只证明 USB 层通了pyocd list才证明 CMSIS-DAP 协议层被正确解析。如果前者有、后者无问题在固件描述符或驱动绑定如果两者都有但连目标失败问题在 SWD 接线或目标供电。3.3 接线与目标板连接要点DAP 探针和目标板之间至少需要 SWCLK、SWDIO、GND 三根线目标板自供电时不要再接 VCC否则可能倒灌。SWDIO 建议加上拉SWCLK 下拉长线时降速。OpenOCD 配置文件里adapter speed先设 100kHz通了再往上加。# openocd.cfg 片段适配 CMSIS-DAP 探针 adapter driver cmsis-dap adapter speed 100 transport select swd source [find target/stm32f1x.cfg]逻辑说明adapter driver指定用 CMSIS-DAPadapter speed单位 kHz初次调试用低速提高容错transport select swd选 SWD 而非 JTAG最后加载目标芯片配置。速度参数是排错时最常调的线长或干扰大就往下压。4. 避坑与排查裸板 DAP 最常见的五类翻车4.1 现象USB 认到但 pyOCD 报 “no probe found”原因固件里的 USB 描述符不完整或者 HID 接口报告描述符长度不对。裸板固件如果是从别的板子移植过来VID/PID 和接口数量可能没同步改。解决对照 CMSIS-DAP 规范检查USBD_CUSTOM_HID_REPORT_DESC_SIZE和接口配置必要时用 USB 抓包工具看枚举过程。4.2 现象能连目标但一读寄存器就断原因SWD 速率过高或接线过长信号完整性差。血泪经验是杜邦线超过 15cm 就容易出问题。解决把adapter speed降到 50 或 100kHz缩短接线SWDIO 加上拉电阻GND 多接一根。4.3 现象烧录固件后板子完全不枚举原因时钟配置错误导致 USB 无法工作或者 BOOT 引脚没复位。解决确认 HSE 起振检查SystemClock_Config里 USB 时钟是否为 48MHzBOOT0 是否已拉低。必要时用 ISP 重新擦除再烧。4.4 现象Windows 下设备带黄色感叹号原因驱动未正确绑定系统把它当未知 HID。解决手动指定 WinUSB 或 HID 驱动或用 Zadig 绑定。注意不要绑错接口CMSIS-DAP 可能有多个接口。4.5 现象多路 DAP 同时接入时序列号冲突原因固件里序列号写死或为空主机无法区分。解决改源码里的序列号字符串用芯片唯一 ID 生成重新编译烧录。产线场景尤其要注意这一点。5. 进阶用法改固件参数与脚本化批量验证5.1 改 VID/PID 与序列号有些主机工具只认特定 VID/PID这时候需要改源码里的USBD_VID、USBD_PID和序列号字符串。改完重新编译用 ISP 或现有 DAP 烧进去。序列号建议用 MCU 的 96 位唯一 ID 拼接保证每块板子不重复。// 用芯片唯一 ID 生成序列号字符串的常见写法 uint32_t uid0 HAL_GetUIDw0(); uint32_t uid1 HAL_GetUIDw1(); snprintf(serial_str, sizeof(serial_str), DAP%08X%08X, uid0, uid1);逻辑说明HAL_GetUIDw0/1读取芯片唯一 ID拼成字符串后填入 USB 描述符。参数上注意缓冲区长度别溢出。这样每块板子序列号唯一多路场景不会打架。5.2 用脚本批量验证探针可用性产线或实验室多块板子时手动一块块测太慢。常见做法是写个 shell 脚本循环调用pyocd list并解析输出判断每块板子是否被识别。#!/bin/bash # 批量检查 DAP 探针是否被识别 for i in $(seq 1 10); do echo 第 $i 次检查 pyocd list --probes 2/dev/null | grep -i dap || echo 未发现探针 sleep 2 done逻辑说明循环调用pyocd list--probes只列探针grep过滤 DAP 关键字。参数上sleep 2给 USB 枚举留时间实际产线可以改成插拔触发。这个脚本只能验证识别要验证连通性还得加pyocd commander连目标读 ID。5.3 验证方法与参数边界判断一块裸板 DAP 是否合格我一般走三步lsusb确认枚举、pyocd list确认协议、pyocd commander -t target连目标读0xE0042000读 ID。三步都过才算可用。速度参数从 100kHz 起步稳定后逐步加到 1MHz 或更高但超过 2MHz 对杜邦线就是玄学别硬上。验证步骤命令通过标准USB 枚举lsusb出现 DAP 设备协议识别pyocd list列出探针目标连通pyocd commander读到目标 ID从那以后我每次拿到新的裸板固件包都强制先走一遍lsusb → pyocd list → 连目标读 ID这三步不跳步。跳步的代价就是后面花几倍时间排查一个本可以早发现的问题。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/20 21:47:13 · 阅读 1.2k CMSIS-DAP裸板固件烧录与调试探针制作指南
简介这份资源是面向嵌入式开发者与硬件调试爱好者的CMSIS-DAP裸板实现方案基于ARM的CMSIS-DAP标准帮助使用者在无专用调试器的情况下通过USB接口对目标芯片进行JTAG或SWD调试。资源由“技小新”整理的第三版经过精简与稳定性优化适合希望自建调试工具或深入理解底层调试机制的工程师。压缩包共164个文件约6.38MB以c与h源码、Keil工程文件、编译中间产物及Gerber生产文件为主另含原理图、说明文档与烧录固件覆盖从软件到硬件的完整链路。其中代码_V1.4可直接烧录至STM32F103等微控制器原理图与PCB文件便于自行打板验证。目前已有831人学习下载读者可借此掌握USB通信、DAP协议实现与调试接口硬件设计快速搭建属于自己的调试环境。1. 从一块裸板说起CMSIS-DAP 调试器固件到底能解决什么手头有一块空白的 Cortex-M 开发板板载一颗常见的 STM32F103 或同级别 MCU没有板载调试器手边也没有独立仿真器。这时候最省事的做法是把这块板子刷成 CMSIS-DAP 固件让它变成一台能被 Keil、IAR、OpenOCD、pyOCD 识别的调试探针再去调试另一块目标板。CMSIS_DAP_裸板.zip 就是干这件事的资源包——它面向的是“裸板”场景也就是你手上只有一颗光板 MCU没有现成的调试器固件需要自己把 DAP 固件烧进去。CMSIS-DAP 是 ARM 定义的一套调试接口协议主机端通过 USB HID 或 WinUSB 与探针通信探针再通过 SWD/JTAG 驱动目标芯片。它的价值在于免驱、跨平台、协议开放Linux 下不用装厂商私有驱动macOS 上也能直接跑 OpenOCD。适合谁适合手里有闲置开发板、想低成本搭一套调试环境的嵌入式从业者也适合需要批量产线烧录、想用脚本控制多路 DAP 的场景。技小新这类关键词背后其实是很多人在找“怎么把一块普通板子变成 DAP 探针”的可落地路径这个包就是那条路径的起点。2. 拆包看结构固件、配置与烧录入口怎么对应2.1 包内典型文件构成与作用拿到 CMSIS_DAP_裸板.zip 之后先别急着烧。解压后一般能看到几类东西编译好的固件二进制.bin/.hex/.elf、对应不同目标芯片的工程源码或配置头文件、以及一份说明烧录方式的文档。固件二进制是直接可烧的成品源码工程则是给你改引脚、改 VID/PID、改时钟用的。裸板场景下最关键的是确认固件对应的 MCU 型号和封装因为引脚映射一旦对不上SWD 信号就出不来。常见做法是先用unzip -l看一眼包内清单再决定走“直接烧成品”还是“改源码重编译”两条路。如果只是想让板子尽快变成探针直接烧成品最快如果要改 USB 描述符或引脚就得进源码。# 查看压缩包内容不急着解压 unzip -l CMSIS_DAP_裸板.zip # 解压到独立目录避免污染当前工作区 unzip CMSIS_DAP_裸板.zip -d cmsis_dap_bare逻辑说明第一条命令只列清单帮你判断包里是成品固件还是源码工程第二条解压到独立目录方便后续用 git 管理改动。参数上-d指定输出目录避免文件散落一地。2.2 固件与目标 MCU 的匹配判断裸板能不能用第一步是确认固件里的时钟配置和引脚定义跟你手上板子一致。CMSIS-DAP 固件通常会把 SWCLK、SWDIO、以及可选的 SWO、nRESET 映射到特定 GPIO。如果固件是按某款最小系统板编的而你的板子 LED 或按键占用了这些脚就会出现“USB 认到了但连不上目标”的玄学现象。判断方法打开源码里的DAP_config.h或类似头文件找SWCLK_PIN、SWDIO_PIN这类宏对照你板子的原理图。对不上就改宏重新编译。改完记得同步改DAP_config.h里的端口时钟使能否则引脚配了也不工作。配置项常见取值说明SWCLK 引脚PA14 / PB13 等必须与原理图一致SWDIO 引脚PA13 / PB12 等双向注意上下拉USB DP/DMPA12/PA11固定复用不可随意改时钟源内部 HSI / 外部 HSE影响 USB 枚举稳定性提示改引脚后如果 USB 枚举失败先查时钟配置再查 USB 中断优先级最后才怀疑硬件。3. 从零烧录把裸板变成可识别的 DAP 探针3.1 用现有工具完成首次烧录裸板第一次烧录是鸡生蛋问题你还没有 DAP怎么烧 DAP 固件常见做法有三种——用另一台现成调试器通过 SWD 烧、用串口 ISP 烧、用 DFU 模式烧。STM32 系列最省事的是串口 ISPBOOT0 拉高、BOOT1 拉低上电进系统存储器然后用stm32flash或官方工具写入。# 串口 ISP 方式烧录/dev/ttyUSB0 换成实际串口 stm32flash -w cmsis_dap_bare/firmware.bin -v -g 0x0 /dev/ttyUSB0逻辑说明-w指定要写入的固件-v校验写入结果-g 0x0表示写完从 0x0 地址开始执行。参数里串口设备名要按实际改Linux 下常见是/dev/ttyUSB0或/dev/ttyACM0。烧完把 BOOT0 拉回低电平重新上电板子就应该以 DAP 探针身份枚举。3.2 验证枚举与驱动状态烧录完成后插上 USB先看系统有没有认到设备。Linux 下用lsusbWindows 下看设备管理器。CMSIS-DAP 通常枚举为 HID 设备VID/PID 可能是0x0D28:0x0204这类。如果认到了但 OpenOCD 连不上多半是权限或驱动匹配问题。# 查看 USB 设备确认 DAP 是否枚举 lsusb | grep -i dap # 用 pyOCD 列出可用探针验证协议层是否通 pyocd list逻辑说明lsusb只证明 USB 层通了pyocd list才证明 CMSIS-DAP 协议层被正确解析。如果前者有、后者无问题在固件描述符或驱动绑定如果两者都有但连目标失败问题在 SWD 接线或目标供电。3.3 接线与目标板连接要点DAP 探针和目标板之间至少需要 SWCLK、SWDIO、GND 三根线目标板自供电时不要再接 VCC否则可能倒灌。SWDIO 建议加上拉SWCLK 下拉长线时降速。OpenOCD 配置文件里adapter speed先设 100kHz通了再往上加。# openocd.cfg 片段适配 CMSIS-DAP 探针 adapter driver cmsis-dap adapter speed 100 transport select swd source [find target/stm32f1x.cfg]逻辑说明adapter driver指定用 CMSIS-DAPadapter speed单位 kHz初次调试用低速提高容错transport select swd选 SWD 而非 JTAG最后加载目标芯片配置。速度参数是排错时最常调的线长或干扰大就往下压。4. 避坑与排查裸板 DAP 最常见的五类翻车4.1 现象USB 认到但 pyOCD 报 “no probe found”原因固件里的 USB 描述符不完整或者 HID 接口报告描述符长度不对。裸板固件如果是从别的板子移植过来VID/PID 和接口数量可能没同步改。解决对照 CMSIS-DAP 规范检查USBD_CUSTOM_HID_REPORT_DESC_SIZE和接口配置必要时用 USB 抓包工具看枚举过程。4.2 现象能连目标但一读寄存器就断原因SWD 速率过高或接线过长信号完整性差。血泪经验是杜邦线超过 15cm 就容易出问题。解决把adapter speed降到 50 或 100kHz缩短接线SWDIO 加上拉电阻GND 多接一根。4.3 现象烧录固件后板子完全不枚举原因时钟配置错误导致 USB 无法工作或者 BOOT 引脚没复位。解决确认 HSE 起振检查SystemClock_Config里 USB 时钟是否为 48MHzBOOT0 是否已拉低。必要时用 ISP 重新擦除再烧。4.4 现象Windows 下设备带黄色感叹号原因驱动未正确绑定系统把它当未知 HID。解决手动指定 WinUSB 或 HID 驱动或用 Zadig 绑定。注意不要绑错接口CMSIS-DAP 可能有多个接口。4.5 现象多路 DAP 同时接入时序列号冲突原因固件里序列号写死或为空主机无法区分。解决改源码里的序列号字符串用芯片唯一 ID 生成重新编译烧录。产线场景尤其要注意这一点。5. 进阶用法改固件参数与脚本化批量验证5.1 改 VID/PID 与序列号有些主机工具只认特定 VID/PID这时候需要改源码里的USBD_VID、USBD_PID和序列号字符串。改完重新编译用 ISP 或现有 DAP 烧进去。序列号建议用 MCU 的 96 位唯一 ID 拼接保证每块板子不重复。// 用芯片唯一 ID 生成序列号字符串的常见写法 uint32_t uid0 HAL_GetUIDw0(); uint32_t uid1 HAL_GetUIDw1(); snprintf(serial_str, sizeof(serial_str), DAP%08X%08X, uid0, uid1);逻辑说明HAL_GetUIDw0/1读取芯片唯一 ID拼成字符串后填入 USB 描述符。参数上注意缓冲区长度别溢出。这样每块板子序列号唯一多路场景不会打架。5.2 用脚本批量验证探针可用性产线或实验室多块板子时手动一块块测太慢。常见做法是写个 shell 脚本循环调用pyocd list并解析输出判断每块板子是否被识别。#!/bin/bash # 批量检查 DAP 探针是否被识别 for i in $(seq 1 10); do echo 第 $i 次检查 pyocd list --probes 2/dev/null | grep -i dap || echo 未发现探针 sleep 2 done逻辑说明循环调用pyocd list--probes只列探针grep过滤 DAP 关键字。参数上sleep 2给 USB 枚举留时间实际产线可以改成插拔触发。这个脚本只能验证识别要验证连通性还得加pyocd commander连目标读 ID。5.3 验证方法与参数边界判断一块裸板 DAP 是否合格我一般走三步lsusb确认枚举、pyocd list确认协议、pyocd commander -t target连目标读0xE0042000读 ID。三步都过才算可用。速度参数从 100kHz 起步稳定后逐步加到 1MHz 或更高但超过 2MHz 对杜邦线就是玄学别硬上。验证步骤命令通过标准USB 枚举lsusb出现 DAP 设备协议识别pyocd list列出探针目标连通pyocd commander读到目标 ID从那以后我每次拿到新的裸板固件包都强制先走一遍lsusb → pyocd list → 连目标读 ID这三步不跳步。跳步的代价就是后面花几倍时间排查一个本可以早发现的问题。希望帮到你。本文还有配套的精品资源点击获取