支持的设备

设备列表

型号	连接方式	亮度	蜂鸣器	说明
mlight-single	USB CDC	支持	—	单灯珠 RGB 状态灯
mlight-3led	USB CDC	支持	—	三灯珠 RGB 状态灯
yh50-rgy-j	USB 串口 / libusb	—	支持	三色 LED + 蜂鸣器
mock	虚拟设备	—	—	开发与无硬件验证

自动发现与绑定

设备插入后会自动发现。控制台会按设备展示实际支持的能力，并允许为设备绑定型号或覆盖默认行为。

无硬件测试

选择 mock 设备后，仍然可以走完整的「agent 上报 → 状态聚合 → 设备命令」链路；适合在没有实体状态灯时开发或演示。

协议

设备串口协议、验收清单和硬件细节在仓库的 docs/ 目录中维护。协议变更会先更新仓库文档，再同步到控制台。