串口协议 · 完整命令表
手搓一套
字节协议
12 字节一帧、四种命令、96 条编排好的字节。没有现成标准可抄——当年就是一个字节一个字节试出来的:哪个位置放类型、哪个位置放键码、按住时间怎么塞进一个字节。
9600 8N112 字节 / 帧键盘 · 鼠标 · 蜂鸣器固件只读前 10 字节
一帧是怎么排的
整帧 12 字节:FF + 10 字节有效数据 + FE。下面用"帧内位置 / 有效数据下标"两种编号对照。
| 帧内 | 下标 | 键盘 0x01 | 鼠标 0x02 | 其它 |
|---|---|---|---|---|
0 | — | 帧头 FF | ||
1 | [0] | 类型:0x00 空操作 · 0x01 键盘 · 0x02 鼠标 · 0x03 蜂鸣器 | ||
2 | [1] | 修饰键位图 | 按键位图(左/右/中) | 忽略 |
3 | [2] | 按住时长 × 10 ms(0 = 按住不抬) | X 位移(有符号) | 忽略 |
4 | [3] | 键码 1 | Y 位移(有符号) | 忽略 |
5 | [4] | 键码 2 | 滚轮(有符号) | 忽略 |
6–9 | [5]–[8] | 键码 3–6 | 保留,填 0 | 忽略 |
10 | [9] | 重复次数(固件不读,由上位机展开) | 同 | |
11 | — | 帧尾 FE | ||
为什么是 6 个键槽
HID 键盘报告的固定结构就是"8 位修饰键 + 1 字节保留 + 6 个键码"。协议直接照抄这个布局,固件收到后几乎不用转换。
按住时长塞进 1 字节
以 10 ms 为单位,0–255 覆盖 0–2.55 s;0 表示"按住不放",留给组合键和长按。
重复次数放最后
第 10 字节固件根本不读——它只是给上位机的提示:同一帧连发几次。协议不用改,就能表达"连按 5 次"。
为什么要 FF / FE
串口没有包边界。帧头帧尾 + 状态机(等 FF → 收 10 字节 → 等 FE)让收包自带同步,错帧直接丢弃。
为什么有 0x00
空操作不是废物:它能当占位符、也能给流程文件加"等待",让人读起来是分段的。
12 字节的取舍
1 类型 + 1 修饰 + 1 时长 + 6 键 + 1 重复 = 10,加头尾正好 12。9600 波特率下一帧约 12.5 ms。
拆三条给你看
同一个 10 字节,换个类型字节,含义就完全不同。
⌘ + H(键盘)
FF 01 08 0A 0B 00 00 00 00 00 00 FE
│ │ │ │ └─ 键码 0x0B = h
│ │ │ └─ 按住 0x0A × 10 ms = 100 ms
│ │ └─ 修饰键 0x08 = 左 GUI(⌘)
│ └─ 类型 0x01 = 键盘
└─ 帧头
左键单击(鼠标)
FF 02 01 00 00 00 00 00 00 00 00 FE ← 按下
FF 02 00 00 00 00 00 00 00 00 00 FE ← 松开
│ │ │ └─ X / Y / 滚轮 全 0
│ │ └─ 按键位图 0x01 = 左键
│ └─ 类型 0x02 = 鼠标
滚轮向下 1 格(鼠标)
FF 02 00 00 00 FF 00 00 00 00 00 FE
│ │ │ │ │ └─ 滚轮 0xFF = −1(向下)
│ │ │ │ └─ 保留
│ │ └─ 无按键、无位移
│ └─ 类型 0x02
完整字典
96 条,按类别排。原始文档里有重复示例,这里按帧去重;预设按钮取自原始预设表。
预设按钮 7
网页助手底部的快捷按钮(来自原始文档的预设表)。注意最后一字节是重复次数。
| 键 / 动作 | 帧(12 字节) | 说明 |
|---|---|---|
| 空操作 | FF 00 00 00 00 00 00 00 00 00 01 FE | 重复 1 |
| 返回主页(⌘+H) | FF 01 08 0A 0B 00 00 00 00 00 01 FE | 修饰键 0x08 · 按住 100 ms |
| 截屏(⌘+Shift+3) | FF 01 0A 0A 20 00 00 00 00 00 01 FE | 修饰键 0x0A · 键码 0x20 |
| 向右移动 50 | FF 02 00 0A 00 00 00 00 00 00 05 FE | X +10 · 重复 5 |
| 向左移动 50 | FF 02 00 F6 00 00 00 00 00 00 05 FE | X −10 · 重复 5 |
| 向上移动 50 | FF 02 00 00 F6 00 00 00 00 00 05 FE | Y −10 · 重复 5 |
| 向下移动 50 | FF 02 00 00 0A 00 00 00 00 00 05 FE | Y +10 · 重复 5 |
键盘 · 字母 26
键码 0x04–0x1D,按住 100 ms 后自动抬起。
| 键 / 动作 | 帧(12 字节) | 说明 |
|---|---|---|
| A | FF 01 00 0A 04 00 00 00 00 00 00 FE | 键码 0x04 |
| B | FF 01 00 0A 05 00 00 00 00 00 00 FE | 键码 0x05 |
| C | FF 01 00 0A 06 00 00 00 00 00 00 FE | 键码 0x06 |
| D | FF 01 00 0A 07 00 00 00 00 00 00 FE | 键码 0x07 |
| E | FF 01 00 0A 08 00 00 00 00 00 00 FE | 键码 0x08 |
| F | FF 01 00 0A 09 00 00 00 00 00 00 FE | 键码 0x09 |
| G | FF 01 00 0A 0A 00 00 00 00 00 00 FE | 键码 0x0a |
| H | FF 01 00 0A 0B 00 00 00 00 00 00 FE | 键码 0x0b |
| I | FF 01 00 0A 0C 00 00 00 00 00 00 FE | 键码 0x0c |
| J | FF 01 00 0A 0D 00 00 00 00 00 00 FE | 键码 0x0d |
| K | FF 01 00 0A 0E 00 00 00 00 00 00 FE | 键码 0x0e |
| L | FF 01 00 0A 0F 00 00 00 00 00 00 FE | 键码 0x0f |
| M | FF 01 00 0A 10 00 00 00 00 00 00 FE | 键码 0x10 |
| N | FF 01 00 0A 11 00 00 00 00 00 00 FE | 键码 0x11 |
| O | FF 01 00 0A 12 00 00 00 00 00 00 FE | 键码 0x12 |
| P | FF 01 00 0A 13 00 00 00 00 00 00 FE | 键码 0x13 |
| Q | FF 01 00 0A 14 00 00 00 00 00 00 FE | 键码 0x14 |
| R | FF 01 00 0A 15 00 00 00 00 00 00 FE | 键码 0x15 |
| S | FF 01 00 0A 16 00 00 00 00 00 00 FE | 键码 0x16 |
| T | FF 01 00 0A 17 00 00 00 00 00 00 FE | 键码 0x17 |
| U | FF 01 00 0A 18 00 00 00 00 00 00 FE | 键码 0x18 |
| V | FF 01 00 0A 19 00 00 00 00 00 00 FE | 键码 0x19 |
| W | FF 01 00 0A 1A 00 00 00 00 00 00 FE | 键码 0x1a |
| X | FF 01 00 0A 1B 00 00 00 00 00 00 FE | 键码 0x1b |
| Y | FF 01 00 0A 1C 00 00 00 00 00 00 FE | 键码 0x1c |
| Z | FF 01 00 0A 1D 00 00 00 00 00 00 FE | 键码 0x1d |
键盘 · 数字 10
键码 0x1E–0x27。
| 键 / 动作 | 帧(12 字节) | 说明 |
|---|---|---|
| 1 | FF 01 00 0A 1E 00 00 00 00 00 00 FE | 键码 0x1e |
| 2 | FF 01 00 0A 1F 00 00 00 00 00 00 FE | 键码 0x1f |
| 3 | FF 01 00 0A 20 00 00 00 00 00 00 FE | 键码 0x20 |
| 4 | FF 01 00 0A 21 00 00 00 00 00 00 FE | 键码 0x21 |
| 5 | FF 01 00 0A 22 00 00 00 00 00 00 FE | 键码 0x22 |
| 6 | FF 01 00 0A 23 00 00 00 00 00 00 FE | 键码 0x23 |
| 7 | FF 01 00 0A 24 00 00 00 00 00 00 FE | 键码 0x24 |
| 8 | FF 01 00 0A 25 00 00 00 00 00 00 FE | 键码 0x25 |
| 9 | FF 01 00 0A 26 00 00 00 00 00 00 FE | 键码 0x26 |
| 0 | FF 01 00 0A 27 00 00 00 00 00 00 FE | 键码 0x27 |
键盘 · 符号与编辑键 22
空格、标点、Enter、Esc、Tab、方向与翻页键等。
| 键 / 动作 | 帧(12 字节) | 说明 |
|---|---|---|
| 抬起所有键 | FF 01 00 00 00 00 00 00 00 00 00 FE | 按住时长 0 → 不自动抬;用于清空按键状态 |
| Enter | FF 01 00 0A 28 00 00 00 00 00 00 FE | 键码 0x28 |
| Esc | FF 01 00 0A 29 00 00 00 00 00 00 FE | 键码 0x29 |
| 0x2B | FF 01 00 0A 2B 00 00 00 00 00 00 FE | 键码 0x2b |
| 0x2C | FF 01 00 0A 2C 00 00 00 00 00 00 FE | 键码 0x2c |
| 0x2D | FF 01 00 0A 2D 00 00 00 00 00 00 FE | 键码 0x2d |
| 0x2E | FF 01 00 0A 2E 00 00 00 00 00 00 FE | 键码 0x2e |
| 0x2F | FF 01 00 0A 2F 00 00 00 00 00 00 FE | 键码 0x2f |
| ] | FF 01 00 0A 30 00 00 00 00 00 00 FE | 键码 0x30 |
| \\ | FF 01 00 0A 31 00 00 00 00 00 00 FE | 键码 0x31 |
| ; | FF 01 00 0A 33 00 00 00 00 00 00 FE | 键码 0x33 |
| ' | FF 01 00 0A 34 00 00 00 00 00 00 FE | 键码 0x34 |
| ` | FF 01 00 0A 35 00 00 00 00 00 00 FE | 键码 0x35 |
| , | FF 01 00 0A 36 00 00 00 00 00 00 FE | 键码 0x36 |
| . | FF 01 00 0A 37 00 00 00 00 00 00 FE | 键码 0x37 |
| / | FF 01 00 0A 38 00 00 00 00 00 00 FE | 键码 0x38 |
| Caps Lock | FF 01 00 0A 39 00 00 00 00 00 00 FE | 键码 0x39 |
| 0x4A | FF 01 00 0A 4A 00 00 00 00 00 00 FE | 键码 0x4a |
| 0x4B | FF 01 00 0A 4B 00 00 00 00 00 00 FE | 键码 0x4b |
| 0x4D | FF 01 00 0A 4D 00 00 00 00 00 00 FE | 键码 0x4d |
| 0x4E | FF 01 00 0A 4E 00 00 00 00 00 00 FE | 键码 0x4e |
| Num Lock | FF 01 00 0A 53 00 00 00 00 00 00 FE | 键码 0x53 |
键盘 · 组合键 10
修饰键位图 + 一个普通键码;按住时长可调。
| 键 / 动作 | 帧(12 字节) | 说明 |
|---|---|---|
| Command + h 返回主页 | FF 01 08 0A 0B 00 00 00 00 00 00 FE | 修饰键 0x08 · 按住 100 ms |
| 长按 Command 一秒 显示快捷键 | FF 01 08 64 00 00 00 00 00 00 00 FE | 修饰键 0x08 · 按住 1000 ms |
| 截屏 | FF 01 0A 0A 20 00 00 00 00 00 00 FE | 修饰键 0x0A · 按住 100 ms |
| 按下'Ctrl'和'C'组合键并保持100毫秒 | FF 01 01 0A 06 00 00 00 00 00 00 FE | 修饰键 0x01 · 按住 100 ms |
| 按下'Shift'和'1'组合键并保持100毫秒 | FF 01 02 0A 1E 00 00 00 00 00 00 FE | 修饰键 0x02 · 按住 100 ms |
| 按下'Alt'和'Tab'组合键并保持100毫秒 | FF 01 04 0A 2B 00 00 00 00 00 00 FE | 修饰键 0x04 · 按住 100 ms |
| 按下'GUI'和'R'组合键并保持100毫秒 | FF 01 08 0A 15 00 00 00 00 00 00 FE | 修饰键 0x08 · 按住 100 ms |
| 按下'Ctrl'、'Shift'和'Esc'组合键并保持100毫秒 | FF 01 03 0A 29 00 00 00 00 00 00 FE | 修饰键 0x03 · 按住 100 ms |
| 按下'Ctrl'、'Alt'和'Del'组合键并保持100毫秒 | FF 01 05 0A 4C 00 00 00 00 00 00 FE | 修饰键 0x05 · 按住 100 ms |
| 按下'Ctrl'、'Shift'、'Alt'和'F4'组合键并保持100毫秒 | FF 01 07 14 3D 00 00 00 00 00 00 FE | 修饰键 0x07 · 按住 200 ms |
鼠标 20
按键位图 + 相对位移 + 滚轮。每帧只发一次 HID 报告。
| 键 / 动作 | 帧(12 字节) | 说明 |
|---|---|---|
| 左键按下 | FF 02 01 00 00 00 00 00 00 00 00 FE | 按键 0x01 · X +0 · Y +0 · 滚轮 +0 |
| 松开所有键 | FF 02 00 00 00 00 00 00 00 00 00 FE | 按键 0x00 · X +0 · Y +0 · 滚轮 +0 |
| 右键按下 | FF 02 02 00 00 00 00 00 00 00 00 FE | 按键 0x02 · X +0 · Y +0 · 滚轮 +0 |
| 中键按下 | FF 02 04 00 00 00 00 00 00 00 00 FE | 按键 0x04 · X +0 · Y +0 · 滚轮 +0 |
| 向右移动 16 | FF 02 00 10 00 00 00 00 00 00 00 FE | 按键 0x00 · X +16 · Y +0 · 滚轮 +0 |
| 向左移动 16 | FF 02 00 F0 00 00 00 00 00 00 00 FE | 按键 0x00 · X -16 · Y +0 · 滚轮 +0 |
| 向上移动 17 | FF 02 00 00 EF 00 00 00 00 00 00 FE | 按键 0x00 · X +0 · Y -17 · 滚轮 +0 |
| 向下移动 16 | FF 02 00 00 10 00 00 00 00 00 00 FE | 按键 0x00 · X +0 · Y +16 · 滚轮 +0 |
| 滚轮向上 1 | FF 02 00 00 00 01 00 00 00 00 00 FE | 按键 0x00 · X +0 · Y +0 · 滚轮 +1 |
| 滚轮向下 1 | FF 02 00 00 00 FF 00 00 00 00 00 FE | 按键 0x00 · X +0 · Y +0 · 滚轮 -1 |
| 移到右上角并按下左键 | FF 02 01 10 EF 00 00 00 00 00 00 FE | 按键 0x01 · X +16 · Y -17 · 滚轮 +0 |
| 按住左键向右下拖拽 | FF 02 01 10 10 00 00 00 00 00 00 FE | 按键 0x01 · X +16 · Y +16 · 滚轮 +0 |
| 移到左下角并按下右键 | FF 02 02 F0 10 00 00 00 00 00 00 FE | 按键 0x02 · X -16 · Y +16 · 滚轮 +0 |
| 向左移动并按住中键 | FF 02 04 F8 00 00 00 00 00 00 00 FE | 按键 0x04 · X -8 · Y +0 · 滚轮 +0 |
| 快速右移 + 滚轮向下 | FF 02 00 30 00 FF 00 00 00 00 00 FE | 按键 0x00 · X +48 · Y +0 · 滚轮 -1 |
| 移到右下角 + 滚轮向上 | FF 02 00 20 20 01 00 00 00 00 00 FE | 按键 0x00 · X +32 · Y +32 · 滚轮 +1 |
| 按住右键右移(多帧拖拽) | FF 02 02 10 00 00 00 00 00 00 00 FE | 按键 0x02 · X +16 · Y +0 · 滚轮 +0 |
| 按住右键右移 32 | FF 02 02 20 00 00 00 00 00 00 00 FE | 按键 0x02 · X +32 · Y +0 · 滚轮 +0 |
| 按住右键右移 48 | FF 02 02 30 00 00 00 00 00 00 00 FE | 按键 0x02 · X +48 · Y +0 · 滚轮 +0 |
| 按住左键 + 滚轮向下 | FF 02 01 00 00 FF 00 00 00 00 00 FE | 按键 0x01 · X +0 · Y +0 · 滚轮 -1 |
蜂鸣器 1
| 键 / 动作 | 帧(12 字节) | 说明 |
|---|---|---|
| 蜂鸣器 | FF 03 00 00 00 00 00 00 00 00 00 FE | 响 30 ms,并翻转一次 LED |