# JTAGulator 片上调试接口识别工具

> Joe Grand 开发的开源硬件工具及其 Parallax Propeller 固件，用于在陌生电路板的测试点、过孔、元件焊盘或连接器中找出片上调试接口。它通过串口终端操作，用 24 路电平转换通道逐一尝试引脚排列：以 IDCODE 或 BYPASS 扫描识别 JTAG 引脚，以 IDCODE 识别 SWD 引脚，并识别 UART 引脚及其波特率。已知 JTAG 引脚后，固件还能读取器件 ID、探测指令寄存器和数据寄存器，并用 EXTEST 把芯片引脚对应到边界扫描寄存器中的位置；其他模式可透传 UART 数据、充当兼容 SUMP 的逻辑分析仪，或模拟 Bus Pirate，让 OpenOCD 把它当作 JTAG 适配器使用。

- 类型：工具
- 目标：固件
- 类别：固件工具
- 关联：基础工具
- 来源复核于：2026-10-27
- 收录于：2026-11-03
- 原始资源：<https://github.com/grandideastudio/jtagulator>
- 一手来源：<https://github.com/grandideastudio/jtagulator/blob/6a764cd87315e7823937811a5e6f11051c51be1a/README.markdown>
- 目录页面：<https://awesomerea.org/zh/resources/jtagulator/>
- 记录 JSON：<https://awesomerea.org/resources/jtagulator/record.json>
- 英文版：[English](https://awesomerea.org/resources/jtagulator/index.md)

## 使用条件与局限

- 最新固件版本为 1.12，于 2023-06-05 打标签；仓库只发布标签，没有 GitHub 发行版，README 称 master 是开发分支，其间的提交可能不稳定。此后直到所审阅的 2026-09-02 提交，改动包括更新链接和许可说明，以及加入 Rev. C 硬件设计文件；README 称自 2025 年 7 月起由 EXPLIoT 负责维护和支持。
- 需要 JTAGulator 硬件（仓库提交了 Rev. C 的设计文件，包括 Altium 工程、Gerber 文件、原理图、物料清单、装配图和测试流程）、主机上的串口终端，以及与目标候选引脚的实际接线。扫描前必须设置目标 I/O 电压（1.4–3.3 V），固件提示使用时可能影响目标系统的行为；固件还提示其前端电路与许多基于 SWD 的目标不兼容，并指向 wiki 中介绍的硬件改装方法。
- 固件是面向 Propeller P8X32A 的 Spin 代码：README 推荐使用 Windows 版 Propeller Tool 1.3.2，称其他开发环境未经测试且不受支持，同时也给出了用 OpenSpin 编译、用 PropLoader 加载到 RAM 或写入 EEPROM 的命令。仓库提交了已编译的固件映像 JTAGulator.eeprom（32 KB），最后一次更新对应 1.12 版。OpenOCD 模式和逻辑分析仪模式分别需要 OpenOCD 的 Bus Pirate 驱动或 Openbench Logic Sniffer 客户端软件，这两种模式在复位和固件更新后仍会保持，只能由用户手动退出。
- README 称该设计以 CC BY-SA 4.0 许可发布，JTAGulator 名称和标志是 Grand Idea Studio 的注册商标，未经许可不得用于衍生作品；而 Spin 源码文件头仍写着 CC BY 3.0 United States，GitHub 也未识别出许可证。

## 一手来源

1. <https://github.com/grandideastudio/jtagulator/blob/6a764cd87315e7823937811a5e6f11051c51be1a/README.markdown>
2. <https://github.com/grandideastudio/jtagulator/blob/6a764cd87315e7823937811a5e6f11051c51be1a/CHANGES.markdown>
3. <https://github.com/grandideastudio/jtagulator/blob/6a764cd87315e7823937811a5e6f11051c51be1a/JTAGulator.spin#L2796-L2869>
4. <https://github.com/grandideastudio/jtagulator/blob/6a764cd87315e7823937811a5e6f11051c51be1a/JTAGulatorCon.spin>
5. <https://github.com/grandideastudio/jtagulator/blob/6a764cd87315e7823937811a5e6f11051c51be1a/PropOCD.spin>
6. <https://github.com/grandideastudio/jtagulator/blob/6a764cd87315e7823937811a5e6f11051c51be1a/PropSUMP.spin>
7. <https://github.com/grandideastudio/jtagulator/tree/6a764cd87315e7823937811a5e6f11051c51be1a/Hardware/Rev.%20C>
8. <https://github.com/grandideastudio/jtagulator/tags>
9. <https://expliot.io/jtagulator/>

## 同分区更多条目：固件与硬件

- [BIOSUtilities 厂商 BIOS/UEFI 更新包提取工具集](https://awesomerea.org/zh/resources/biosutilities/index.md) · 工具
- [allyourbase 固件基址估算脚本](https://awesomerea.org/zh/resources/allyourbase/index.md) · 工具
- [ghidra_kernelcache Apple 内核缓存分析框架](https://awesomerea.org/zh/resources/ghidra-kernelcache/index.md) · 工具
- [esp32_image_parser ESP32 固件镜像解析工具](https://awesomerea.org/zh/resources/esp32-image-parser/index.md) · 工具
- [Tigard 多协议硬件接口板](https://awesomerea.org/zh/resources/tigard/index.md) · 工具
- [UBI Reader UBI/UBIFS 镜像读取工具](https://awesomerea.org/zh/resources/ubi-reader/index.md) · 工具

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。
