• v1.0.0 6c5e647c8a

    jiangchen released this 2026-09-23 00:41:30 +08:00 | 1 commits to main since this release

    首个公开版本。

    核心能力

    • 安卓 Chrome 用 WebUSB 直连 CH340,零驱动(CH340 是 vendor-specific 类,安卓内核不绑定)
    • 桌面 Chrome/Edge 走 Web Serial,行为与原生一致
    • ch340-serial-shim.js 在安卓上补出 navigator.serial,已有 Web Serial 业务代码零改动即可用

    芯片支持

    • CH340/CH341(1a86:7523 / 1a86:5523,兼容 5512/7522 克隆)
    • CDC-ACM:CH343 / CH9102 / CH347
    • CP210x、FTDI(含 modem 状态字节剥离)、PL2303(HXN/HX/01/T)
    • 五种芯片均实现 setSignals()(DTR/RTS)

    实现

    • 控制传输序列对齐 Linux ch341.c;波特率分频 calcCh34xBaud()
    • 32 深度预排队读 + ReadableStream;4096 分片写 + WritableStream

    质量

    • node test/driver.test.mjs → 16 项离线断言全部通过(mock USBDevice,无需硬件)
    • 真实硬件冒烟:CH340 (1a86:7523 rev 0264) 在 Windows COM11 上 115200/460800 收发正常

    文件

    • ch340-webusb.js / ch340-serial-shim.js / ch340-test.html / index.d.ts / examples/minimal.html
    • docs/ch34x-registers.md(寄存器与控制传输逆向说明)

    MIT

    Downloads