WebHID控制USB-Relay-2教程详解

本文揭秘了如何利用现代 WebHID API 精准、可靠地独立控制 USB-Relay-2 双路继电器模块的单个通道（而非笼统的全开/全关），彻底解决长期困扰开发者的协议兼容性难题——通过实测逆向得出仅需3字节的精简指令格式（如 [0xFF, 0x01, 0x01] 开启 Relay 1），并附上开箱即用的完整 JavaScript 示例、关键权限与安全注意事项、固件兼容性调试技巧及生产级健壮性建议，让你轻松将物理继电器无缝集成进网页应用，真正实现浏览器直连工业级硬件的自动化控制。

本文详解如何使用 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 字节数组，结构如下：

因此，标准控制指令为：

// 控制 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 测试台，还是自动化灌溉控制器，都已具备底层通信能力。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。