# RETracker Polyend Tracker 逆向工程框架

> 面向 Polyend Tracker 音乐设备的 Python 逆向工程框架：为厂商原版固件打补丁，用自己的命令处理程序替换一个未使用的 USB RAWHID 处理程序。刷入打过补丁的固件后，主机命令行工具即可按 ARM 或 Thumb 模式读取、十六进制转储和反汇编设备内存，还能写入内存、在指定地址执行代码，汇编并运行称为“Polyp”的位置无关模块（如在打击垫上显示滚动文字和屏幕淡入淡出），以及通过 USB 向 SD 卡复制文件。其 fwtool.py 还可解包和重新打包 Intel HEX 格式的 .ptf 固件镜像，便于载入反汇编器。

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

## 使用条件与局限

- 仅支持 Polyend Tracker 1.5.0 固件；README 称已有一个未公开的 1.6.0 移植版本，因 Polyend 移除了补丁所依赖的代码而没有发布。所审阅的 main 分支提交（2024-06-19）只是发布讨论区公告，最后一次代码改动在 2022 年，项目没有发布版本或标签。
- 打补丁需要用户自备原版 PolyendTracker_1.5.0.ptf 固件镜像，仓库不提供该文件；打过补丁的镜像通过设备正常的固件更新菜单刷入。README 提醒刷入补丁镜像时更新界面的表现会有所不同，建议事先备份 SD 卡，并指出可通过 Tracker 的紧急更新流程恢复。
- 需要 Python 3 及 capstone、keystone-engine、pyusb、intelhex 和 simple-hexdump；主机通过 USB 厂商 ID 和产品 ID 查找设备。README 的逆向笔记认为该硬件是与 Teensy 3.6 同类的 MK66FX 微控制器，给出了固件加载地址和用于运行 Polyp 的 RAM 地址，并称 IDA Pro（可能还有 Ghidra 或 Binary Ninja）可直接载入 Intel HEX 镜像。
- 项目没有测试或 CI。其行为由 README 示例和链接的演示视频记录。
- 仓库中没有许可证文件，GitHub 也未检测到许可证，因此复用条款未予说明。Polyend 固件仍归其权利人所有，README 的免责声明指出设备损坏风险由用户自行承担。

## 一手来源

1. <https://github.com/patois/RETracker/blob/f6698f602fe41fededfd9f19fbe1b74bf68a85f0/README.md>
2. <https://github.com/patois/RETracker/blob/f6698f602fe41fededfd9f19fbe1b74bf68a85f0/DEPENDENCIES.md>
3. <https://github.com/patois/RETracker/blob/f6698f602fe41fededfd9f19fbe1b74bf68a85f0/fwtool.py>
4. <https://github.com/patois/RETracker/blob/f6698f602fe41fededfd9f19fbe1b74bf68a85f0/retracker.py>
5. <https://github.com/patois/RETracker/blob/f6698f602fe41fededfd9f19fbe1b74bf68a85f0/tracker/firmware.py>
6. <https://github.com/patois/RETracker/blob/f6698f602fe41fededfd9f19fbe1b74bf68a85f0/tracker/tracker.py>
7. <https://github.com/patois/RETracker/tree/f6698f602fe41fededfd9f19fbe1b74bf68a85f0/polyp>

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

- [Quarkslab Titan M 安全芯片研究工具](https://awesomerea.org/zh/resources/quarkslab-titanm-tools/index.md) · 工具
- [uefi_retool UEFI 固件逆向工具](https://awesomerea.org/zh/resources/uefi-retool/index.md) · 工具
- [Shannon 基带镜像 IDA Pro 加载器](https://awesomerea.org/zh/resources/shannon-modem-loader/index.md) · 工具
- [IMSProg EEPROM／闪存芯片编程器](https://awesomerea.org/zh/resources/imsprog/index.md) · 工具
- [rbasefind 固件基址搜索工具](https://awesomerea.org/zh/resources/rbasefind/index.md) · 工具
- [Aptio V UEFI 设置编辑器](https://awesomerea.org/zh/resources/aptio-v-uefi-editor/index.md) · 工具

## 关于此条目

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