本文详解如何使用 webhid api 精确控制 usb-relay-2 双路继电器板的单个继电器（而非全开/全关），提供可直接运行的 javascript 示例、协议解析与关键注意事项。
本文详解如何使用 webhid api 精确控制 usb-relay-2 双路继电器板的单个继电器（而非全开/全关），提供可直接运行的 javascript 示例、协议解析与关键注意事项。
USB-Relay-2 是一款常见于工业控制与 DIY 自动化场景的低成本双路 USB 继电器模块（Vendor ID: 0x16C0 / 5824，Product ID: 0x05DF / 1503）。虽然其全通道开关（如 [0xFE, ...] / [0xFC, ...]）在 WebHID 下易于实现，但独立控制 Relay 1 或 Relay 2 长期困扰开发者——根本原因在于该设备实际采用精简的 3 字节 HID Feature Report 协议，而非表面看似需填充 8 字节的冗余格式。
✅ 正确的单继电器控制指令格式
根据实测与协议逆向验证，USB-Relay-2 的单路控制仅需 3 字节数组，结构如下：
| 字节位置 | 含义 | 取值说明 |
|---|---|---|
| byte[0] | 操作命令 | 0xFF（开）、0xFD（关） |
| byte[1] | 继电器编号 | 0x01（Relay 1）、0x02（Relay 2） |
| byte[2] | 校验/重复编号 | 必须与 byte[1] 相同（如 0x01 或 0x02） |
因此，标准控制指令为：
// 控制 Relay 1 const relay1On = [0xFF, 0x01, 0x01]; const relay1Off = [0xFD, 0x01, 0x01]; // 控制 Relay 2 const relay2On = [0xFF, 0x02, 0x02]; const relay2Off = [0xFD, 0x02, 0x02]; // 全开/全关（兼容旧逻辑，但非最优） const allOn = [0xFE]; // 实际只需 1 字节，8 字节是冗余填充 const allOff = [0xFC];
⚠️ 注意：[0xFE, ...] 和 [0xFC, ...] 能工作，是因为设备固件对长报文做了容错处理（忽略后续字节），但不符合 HID 协议规范，且易受未来固件更新影响。生产环境务必使用 3 字节精简指令。
? 完整可运行示例代码
以下整合了设备连接、权限请求、错误处理与单继电器控制逻辑：
async function handleConnectClick() {
try {
const device = await openDevice();
if (!device) throw new Error("未找到 USB-Relay-2 设备");
// 示例：单独打开 Relay 1
await setRelay(device, [0xFF, 0x01, 0x01]);
console.log("Relay 1 已开启");
// 延迟后关闭 Relay 1，开启 Relay 2
await new Promise(r => setTimeout(r, 1000));
await setRelay(device, [0xFD, 0x01, 0x01]);
await setRelay(device, [0xFF, 0x02, 0x02]);
console.log("Relay 1 关闭，Relay 2 开启");
} catch (err) {
console.error("操作失败:", err);
alert(`错误: ${err.message}`);
}
}
async function openDevice() {
const vendorId = 5824; // 0x16C0
const productId = 1503; // 0x05DF
// 尝试复用已授权设备
let devices = await navigator.hid.getDevices();
let device = devices.find(d => d.vendorId === vendorId && d.productId === productId);
if (!device) {
// 请求用户授权
devices = await navigator.hid.requestDevice({
filters: [{ vendorId, productId }]
});
device = devices[0];
}
if (device && !device.opened) {
await device.open();
console.log("设备已连接:", device.productName);
}
return device;
}
async function setRelay(device, data) {
if (!device) throw new Error("设备未连接");
const reportId = 0; // USB-Relay-2 使用 report ID 0
const payload = new Uint8Array(data);
try {
await device.sendFeatureReport(reportId, payload);
} catch (err) {
throw new Error(`发送指令失败: ${err.message}`);
}
}? 关键注意事项与调试建议
- 权限与安全上下文：WebHID 需在 HTTPS 环境或 localhost 下运行；用户首次调用 requestDevice() 时必须有用户手势触发（如按钮点击），不可自动执行。
- 报告类型辨析：USB-Relay-2 使用 sendFeatureReport()（非 sendReport()），因其控制逻辑通过 Feature Report 实现，而非 Output Report。
- 固件兼容性：不同批次的 USB-Relay-2 固件可能存在微小差异。若 3 字节指令无效，请用 HID Explorer 抓包验证实际接收的报文格式。
- 并发安全：避免高频连续调用 sendFeatureReport()（建议间隔 ≥ 50ms），防止 HID 接口缓冲区溢出导致指令丢失。
- 错误恢复：若设备意外断开，device.opened 会变为 false；建议在关键操作前校验连接状态，必要时重新 open()。
掌握这组简洁而精准的 3 字节指令，你就能在 Web 应用中实现可靠的双路继电器独立调度——无论是构建远程实验室电源开关、IoT 测试台，还是自动化灌溉控制器，都已具备底层通信能力。
