本页目录
设备
Hardware SDK 1.2.0 在同一套公开 API 上支持两个协议族。这里只看机型约束，方法名不用换。
| 设备 | Code | 协议 | USB | BLE | Air-Gap（二维码） |
|---|---|---|---|---|---|
| OneKey Classic | classic | V1 | 是 | 是 | 否 |
| OneKey Classic 1s | classic1s | V1 | 是 | 是 | 否 |
| OneKey Classic 1s Pure | classicpure | V1 | 是 | 是 | 否 |
| OneKey Mini | mini | V1 | 是 | 否 | 否 |
| OneKey Touch | touch | V1 | 是 | 是 | 否 |
| OneKey Pro | pro | V1 | 是 | 是 | 是 |
| OneKey Pro 2 | pro2 | V2 | 是 | 是 | 是 |
| OneKey Neo | neo | V2 | 是 | 是 | 否（无摄像头） |
SDK 会把当前连接确认后的协议写在设备对象的 connectProtocol（'V1' 或 'V2'）上。这是实时探测结果，不是按型号查表。
型号应该用在哪
- 用型号做能力和 UX：Mini 没有 BLE，Neo 没有二维码 Air-Gap，Pro / Pro 2 可以 Air-Gap。
- 不要用型号判断 Protocol V1 / V2，应读取当前连接确认的协议。
- 固件升级 API 跟协议族走：Pro 用
firmwareUpdateV3；Pro 2 / Neo 用firmwareUpdateV4。
接入检查清单
- 按传输分别缓存
connectId。同一台设备的 USB 和 BLE ID 不同。 - 擦除 / 恢复助记词后要刷新
deviceId。见 标识符。 - 同一设备上的调用必须串行。让输入与签名流程按顺序执行，保证每次提示和结果都对应原操作。
- 传输出错后，不要自动重放固件升级、擦除或其他有副作用的调用。
另见：链支持 · Protocol V1 与 V2 · 钱包会话
最后更新于