串口协议 · 完整命令表

手搓一套
字节协议

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]键码 1Y 位移(有符号)忽略
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
向右移动 50FF 02 00 0A 00 00 00 00 00 00 05 FEX +10 · 重复 5
向左移动 50FF 02 00 F6 00 00 00 00 00 00 05 FEX −10 · 重复 5
向上移动 50FF 02 00 00 F6 00 00 00 00 00 05 FEY −10 · 重复 5
向下移动 50FF 02 00 00 0A 00 00 00 00 00 05 FEY +10 · 重复 5

键盘 · 字母 26

键码 0x04–0x1D,按住 100 ms 后自动抬起。

键 / 动作帧(12 字节)说明
AFF 01 00 0A 04 00 00 00 00 00 00 FE键码 0x04
BFF 01 00 0A 05 00 00 00 00 00 00 FE键码 0x05
CFF 01 00 0A 06 00 00 00 00 00 00 FE键码 0x06
DFF 01 00 0A 07 00 00 00 00 00 00 FE键码 0x07
EFF 01 00 0A 08 00 00 00 00 00 00 FE键码 0x08
FFF 01 00 0A 09 00 00 00 00 00 00 FE键码 0x09
GFF 01 00 0A 0A 00 00 00 00 00 00 FE键码 0x0a
HFF 01 00 0A 0B 00 00 00 00 00 00 FE键码 0x0b
IFF 01 00 0A 0C 00 00 00 00 00 00 FE键码 0x0c
JFF 01 00 0A 0D 00 00 00 00 00 00 FE键码 0x0d
KFF 01 00 0A 0E 00 00 00 00 00 00 FE键码 0x0e
LFF 01 00 0A 0F 00 00 00 00 00 00 FE键码 0x0f
MFF 01 00 0A 10 00 00 00 00 00 00 FE键码 0x10
NFF 01 00 0A 11 00 00 00 00 00 00 FE键码 0x11
OFF 01 00 0A 12 00 00 00 00 00 00 FE键码 0x12
PFF 01 00 0A 13 00 00 00 00 00 00 FE键码 0x13
QFF 01 00 0A 14 00 00 00 00 00 00 FE键码 0x14
RFF 01 00 0A 15 00 00 00 00 00 00 FE键码 0x15
SFF 01 00 0A 16 00 00 00 00 00 00 FE键码 0x16
TFF 01 00 0A 17 00 00 00 00 00 00 FE键码 0x17
UFF 01 00 0A 18 00 00 00 00 00 00 FE键码 0x18
VFF 01 00 0A 19 00 00 00 00 00 00 FE键码 0x19
WFF 01 00 0A 1A 00 00 00 00 00 00 FE键码 0x1a
XFF 01 00 0A 1B 00 00 00 00 00 00 FE键码 0x1b
YFF 01 00 0A 1C 00 00 00 00 00 00 FE键码 0x1c
ZFF 01 00 0A 1D 00 00 00 00 00 00 FE键码 0x1d

键盘 · 数字 10

键码 0x1E–0x27。

键 / 动作帧(12 字节)说明
1FF 01 00 0A 1E 00 00 00 00 00 00 FE键码 0x1e
2FF 01 00 0A 1F 00 00 00 00 00 00 FE键码 0x1f
3FF 01 00 0A 20 00 00 00 00 00 00 FE键码 0x20
4FF 01 00 0A 21 00 00 00 00 00 00 FE键码 0x21
5FF 01 00 0A 22 00 00 00 00 00 00 FE键码 0x22
6FF 01 00 0A 23 00 00 00 00 00 00 FE键码 0x23
7FF 01 00 0A 24 00 00 00 00 00 00 FE键码 0x24
8FF 01 00 0A 25 00 00 00 00 00 00 FE键码 0x25
9FF 01 00 0A 26 00 00 00 00 00 00 FE键码 0x26
0FF 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 → 不自动抬;用于清空按键状态
EnterFF 01 00 0A 28 00 00 00 00 00 00 FE键码 0x28
EscFF 01 00 0A 29 00 00 00 00 00 00 FE键码 0x29
0x2BFF 01 00 0A 2B 00 00 00 00 00 00 FE键码 0x2b
0x2CFF 01 00 0A 2C 00 00 00 00 00 00 FE键码 0x2c
0x2DFF 01 00 0A 2D 00 00 00 00 00 00 FE键码 0x2d
0x2EFF 01 00 0A 2E 00 00 00 00 00 00 FE键码 0x2e
0x2FFF 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 LockFF 01 00 0A 39 00 00 00 00 00 00 FE键码 0x39
0x4AFF 01 00 0A 4A 00 00 00 00 00 00 FE键码 0x4a
0x4BFF 01 00 0A 4B 00 00 00 00 00 00 FE键码 0x4b
0x4DFF 01 00 0A 4D 00 00 00 00 00 00 FE键码 0x4d
0x4EFF 01 00 0A 4E 00 00 00 00 00 00 FE键码 0x4e
Num LockFF 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
向右移动 16FF 02 00 10 00 00 00 00 00 00 00 FE按键 0x00 · X +16 · Y +0 · 滚轮 +0
向左移动 16FF 02 00 F0 00 00 00 00 00 00 00 FE按键 0x00 · X -16 · Y +0 · 滚轮 +0
向上移动 17FF 02 00 00 EF 00 00 00 00 00 00 FE按键 0x00 · X +0 · Y -17 · 滚轮 +0
向下移动 16FF 02 00 00 10 00 00 00 00 00 00 FE按键 0x00 · X +0 · Y +16 · 滚轮 +0
滚轮向上 1FF 02 00 00 00 01 00 00 00 00 00 FE按键 0x00 · X +0 · Y +0 · 滚轮 +1
滚轮向下 1FF 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
按住右键右移 32FF 02 02 20 00 00 00 00 00 00 00 FE按键 0x02 · X +32 · Y +0 · 滚轮 +0
按住右键右移 48FF 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