工程端 · ATH
设备与连接
设备栏是工程端与真实硬件之间的入口。理解它的几列信息，能省掉大半排错时间。
设备是怎么被认出来的
每台设备由三个字段共同确定：厂商号（VID）、产品号（PID）和序列号。有序列号时，同型号的两台设备 是两台不同的设备；没有序列号时只能按型号归组。
| 信息 | 用在哪 |
|---|---|
| 产品名 | 人读的名字，方便在设备栏里找到它。 |
| VID : PID | 产品身份。项目里的设备说明与工位都按它挑选设备。 |
| 序列号 | 区分同型号的不同个体；连接记录、最近使用顺序都按它记。 |
| 接口 / 用法页 | 同一台设备可能有多个 HID 接口，选错接口就读不到输入。 |
选中、连接与「记住上次」
- 选中一台设备不等于连接成功：设备栏会分别显示当前选择与连接状态。
- ATH 会记住你最近一次明确选择的设备，下次打开或切换项目后仍然选中它；记忆里保存的是 VID、PID 与序列号。
- 可用设备按最近一次成功连接的顺序排列。仅仅选中过、或者连接失败过，都不会让设备提前。
- 记住的选择不会自动连接，需要时再连一次；原来的设备不在时，选择会保留，等它回来或由你手动改选。
看不到或连不上
设备栏里根本没有这台设备
先在命令行确认系统是否枚举到它：
ath device list # 系统里全部 HID 接口，不做筛选
ath dd interfaces # 接口背后的物理设备、位置与关联诊断如果这里也看不到，问题在系统层：检查 USB 连接与线材、换一个接口，并确认设备没有被虚拟机接管 （被接管时宿主系统看不到它）。
列表里有，但连不上
- 确认选的是正确的接口：同一台设备可能有多个 HID 接口。
- 确认设备的连接模式：厂商模式与标准模式在系统里可能是两个不同的条目。
- 看具体报错：ATH 会给出中文说明和下一步建议，并把细节写进日志，见 日志与诊断。
- 用 describe 读描述符，判断是不是设备没有按预期上报：
ath device describe --vendor 11ff --product b772
ath device watch # 原始报文，逐字节看设备到底发了什么
ath device trace # 按项目 DD 解码后的输入变化