i12bp8/TagTinker

# TagTinker

红外电子价签协议研究工具包（适用于 Flipper Zero）
_{协议研究 • 信号分析 • 在授权测试硬件上的受控显示实验}

_{所有者授权实验室显示实验}

## 概述 TagTinker 是一个 Flipper Zero 应用程序，用于**红外电子价签协议**及相关显示行为的教育研究，仅在授权测试硬件上运行。 它专注于： - 协议观察与回放分析 - 受控显示实验 - 单色图像准备流程 - 本地研究与互操作性测试工具 本 README 有意避免发布导向的说明，并排除与实时商业系统交互的指导。 ## 功能 - 文本、图像与测试图案显示实验 - 基于本地 Web 的图像准备工具（`tools/tagtinker.html`） - 针对授权测试台硬件的信号与响应测试 - 体积小、模块化，适合进一步研究 - 以研究为先的项目结构，边界清晰 ## 常见问题 **.fap 发布包在哪里？** Flipper 应用以源码优先。请使用 `ufbt` 自行从本仓库构建 `.fap`，以匹配你的固件和本地工具链。 **如果崩溃或行为异常怎么办？** 维护者主要在 Momentum 固件（禁用资源包）环境下使用 TagTinker，并未遇到问题。若你使用其他固件分支、自定义资源包或高度修改的设备设置，请从干净基线开始测试。 **如果取出标签电池会怎样？** 许多红外电子价签将固件、地址和显示数据存储在易失性 RAM（而非闪存）中以节省成本与能耗。 若移除电池或完全放电，标签将丢失所有编程并变得**无响应（“死机”）**。通常无法恢复，除非使用原始基站。 **我发现漏洞或想贡献——如何联系？** 你可以通过以下方式联系我： - Discord：**@i12bp8** - Telegram：**@i12bp8** 我目前正在旅途中，因此响应可能较慢。欢迎通过问题或拉取请求进行贡献（错误修复、优化、文档等）——你的贡献将有助于项目在我缺席期间保持活跃。 ## 工作原理 TagTinker 围绕**红外电子价签通信**展开研究，用于固定发射端标签系统。 在较高层次上： - 标签接收调制红外传输，而非普通消费红外命令 - 通信基于带命令、参数与完整性字段的寻址协议帧 - 显示更新以适用于支持的单色图形格式的准备负载形式传输 - 本地工具帮助研究者准备资产并在授权硬件上执行受控实验 本项目旨在帮助研究者理解： - 信号结构 - 帧与负载行为 - 显示数据准备约束 - 安全、授权的测试台工作流程 如需了解底层逆向工程背景与更深入的协议研究，请参见： - **Furrtek 的 ESL 研究：** [https://www.furrtek.org/?a=esl](https://www.furrtek.org/?a=esl) - **PrecIR 参考实现：** [https://github.com/furrtek/PrecIR](https://github.com/furrtek/PrecIR) ## 项目范围 TagTinker 仅限于**家庭实验室与授权研究使用**，包括： - 红外协议研究 - 信号时序与帧分析 - 在自有或授权硬件上的受控实验 - 单色资产测试准备 - 教育诊断与互操作性研究 它**不是**零售工具、运营工具或现场实用程序。 ## 负责任使用 你必须独自确保本软件的任何使用均合法、授权且适合你的环境。 维护者不授权、批准、认可或对任何未经授权的使用负责，并拒绝承担因误用、损坏、中断、法律违规或由此产生的任何后果的责任。 如果你不拥有该硬件，或未获得明确的书面许可，**不得在其上使用本项目**。 任何未经授权的使用均超出本仓库预期范围，完全由用户自行承担风险。 ## 无关联声明 这是一个**独立研究项目**。 它未与任何电子价签供应商、零售商、基础设施提供商或系统运营商关联、认可、授权或赞助。 对外部研究、公开文档或逆向工程工作的引用仅出于教育与研究背景。 ## 致谢 本项目是对 **[furrtek / PrecIR](https://github.com/furrtek/PrecIR)** 及其他社区研究的优秀逆向工程工作的移植与适配。 ## 许可证 根据 **GNU General Public License v3.0**（GPL-3.0）授权。 详见 [`LICENSE`](LICENSE) 文件。 ## 免责声明 本软件按“原样”提供，不附带任何形式的明示或暗示担保。 在任何情况下，作者或版权持有者不对因使用本软件而产生的任何索赔、损害或其他责任负责。 ## 维护者声明 本仓库维护为一个**范围狭窄的教育研究项目**。 维护者**不**授权、鼓励、认可或接受对第三方设备、已部署的商业系统、零售基础设施或任何用户未获明确许可的环境的使用。 **请负责任地进行研究。**

标签：ESL, Flipper Zero, GPL-3.0, 互操作性测试, 信号分析, 协议观察, 单色图像处理, 受控显示, 图像准备, 多模态安全, 实验平台, 客户端加密, 嵌入式研究, 开源硬件, 技术研究, 教育研究, 数据可视化, 无线协议, 显示实验, 本地工具, 标签工具, 测试图案, 电子货架标签, 研究工具, 研究项目, 硬件测试, 红外, 红外信号, 红外通信