紫外探头协议逆向 2333hutao/dsh-ls125-uv-probe

dsh-ls125-uv-probe

一个 DeepSeek Harness 技能插件，面向 林上 LinShang LS125 紫外辐照计及其 UVALED-X3 紫外探头：把表与探头之间的私有 UART 协议完整逆向出来，并附带抓取/解码工具链，以及一份已验证的探头主机固件 —— 可以完全脱离原装表读取探头。

装上之后，你的 agent 就多了一个 ls125-uv-probe 技能：协议速查表、命令字节、工具链用法，以及那些"让一套完全正常的设备看起来像坏了"的坑。

English: README.md

它能回答什么

| 问题 | 答案 |
| 能不能不用原装表、用我自己的单片机读这个探头？ | 能 —— 已在 STM32F103 上验证：21/21 帧、零 CRC 错、零超时 |
| 协议是什么？ | 9600 8N1，每 500 ms 轮询一次，探头回 28 字节帧，带 CRC-16/MODBUS |
| 有没有隐藏的握手、挑战应答或 ID 校验？ | 没有 —— 轮询命令就是一条恒定不变的 8 字节串 |
| 能清掉探头里的记录吗？ | 能 —— 有第二条命令，会同时清零能量、最小值和时间计数 |
| 必须发原装表那套开机配置命令吗？ | 不用 —— 只发轮询就够了（已验证） |

安装

dsh plugin --profile web add dsh-ls125-uv-probe

或者直接从仓库安装：

dsh plugin --profile web add github:2333hutao/dsh-ls125-uv-probe

协议速查

主机 → 探头 轮询（每 500 ms） AB 20 60 00 14 00 89 07 清零 AB 21 20 00 02 00 01 00 3D 8A

探头 → 主机 28 字节定长帧，帧头 AB 20 60 00 14 00 偏移 6–9 float LE 实时辐照度 µW/cm²（表显 mW/cm² = ÷1000）偏移 10–13 float LE 累积能量 µJ/cm² 偏移 14–15 uint16 LE 距上次清零的时间 ×0.1 s 偏移 16–17 2 字节 恒 0（含义未定，已排除单位/量程）偏移 18–21 float LE 最小值 µW/cm² 偏移 22–25 float LE 平均辐照度 µW/cm² 偏移 26–27 uint16 LE CRC-16/MODBUS（over 0–25；poly 0xA001 / init 0xFFFF / LSB-first）

帧内数值永远是 µW/cm² 与 µJ/cm²，与表上的单位档无关，所以主机不需要关心那个设置。
最大值不在帧里 —— 表是自己统计的，你也应该自己统计。

包里装了什么

skill/SKILL.md 技能正文（协议速查、命令、工具链用法、硬规则） skill/PROTOCOL.md 完整规格、命令族规律、可直接移植的 C 参考实现 skill/LESSONS.md 可迁移的方法论 + 13 条实测踩坑及其判据 skill/AGENTS.md 给"降落到这个工作区的 agent"的接手说明 skill/tools/ fx2cap.cjs（自研抓取，官方 libusb + fx2lafw 协议）与四个解码分析脚本 skill/firmware/ f103_probe（已验证的主机固件）、f103_rgb（可控光源） skill/captures/ 一份样本抓取，没有硬件也能把工具链跑通

工具链绕开了一个长期存在的 sigrok 问题：所有 Windows 版 sigrok 都静态链接同一个 2016 年的 libusb，它的后端派发在某些系统上必然失败，于是 fx2lafw 报 LIBUSB_ERROR_NOT_SUPPORTED，而 --scan 却还能列出设备。
重装驱动没用。 fx2cap.cjs 改用官方 libusb 直接与设备通信，并补上 sigrok 没有的两个能力： 没有抓取时长上限、以及软触发。

每一条都是量出来的，不是断言的

仓库里保留着全部测量过程：三轮"帧内值 ↔ 表显读数"对照逐位吻合到小数点后四位；穷举 65536 个多项式找出校验和；用暂停主机的方式证明探头不被轮询就绝不说话；以及四组独立实验把 D4 从"复位线"的候选里彻底排除掉。

这份代码是 AI 写的 —— 署名声明

本仓库的全部代码、固件、工具链与文档均由 AI agent（DeepSeek Harness）编写，依据的是在真实硬件上进行的测量。

这里的协议知识不是从数据手册、厂商文档或第三方实现里抄来的 —— 它是从信号线上抓出来、与该表自己的显示屏逐位对照，并且每一条结论背后都有一次记录在案的实验。
skill/ 里没有任何一句是没有测量支撑的断言，少数未定项也都明确标注为未定。

人类操作者做了 AI 做不到的部分：接线、供电、探头、按表上的键，以及报告屏上显示的数字。

请按对待任何机器编写代码的方式来审查它。 所有测量证据都在仓库里，结论可以复核，不必凭信任接受。

许可

MIT