KM2S键鼠模块串口通信协议-V1.0

目录

1.概述

2.通信说明

3. 帧格式说明

3.1 普通键盘/0x01

8字节键盘数据：

3.2 多媒体键盘/0x11

3.2.1 ACPI键

3.2.2 其他多媒体键

 3.3 相对坐标鼠标/0x02

3.4 绝对坐标鼠标/0x12

3.5 VID及PID

3.5.1 修改VID及PID/0x20

3.5.2 读取VID及PID/0x21

 3.6 地址码

3.6.1 设置地址码/0x22

3.6.2 读取地址码/0x23

 3.7 查询芯片ID/0X24

 3.8 复位/0x0F

---

版本号	变更范围	变更内容	修改人
V1.0	文档建立	初稿	Knight20

1. 概述

KM2S模块为串口TTL转USB键盘鼠标模块，把串口接收到的指令转成标准USB键盘鼠标数据发送给电脑。KM2S模块支持普通键盘、多媒体键盘、相对坐标鼠标、绝对坐标鼠标功能。

普通键盘：支持所有多功能键(ctrl/alt/shift)+6个普通按键(a/b/1/2/,/.)同时按下；

多媒体键盘：静音、音量+、音量-、关机、休眠、唤醒、计算器等等；

相对坐标鼠标：鼠标移动时是根据光标当前位置进行移动，例如当前位置为（100,100），向右移动50像素，光标就会移动到（150,100）；

绝对坐标鼠标：鼠标可以精准移动到任何指定坐标，不管当前光标在哪里；绝对坐标需要知道屏幕分辨率才能精准移动。

XCOM V2.6串口调试助手下载链接：https://pan.baidu.com/s/1u2twAZfLwNY0CRoKJvTakw 
提取码：1234

2. 通信说明

KM2S模块串口为TTL类型（不是232串口），通信结构框图如下：

 通信波特率为57600，1位停止位，8位数据位，无校验位

3. 帧格式说明

注：以下所有描述的数据均为16进制格式。

帧头	地址码	命令码	后续数据
2个字节	1个字节	1个字节	N个字节

帧头：占两个字节，固定为0x57、0xAB；

地址码：占一个字节，默认为0x00,可接收任意地址码的命令包，如果芯片地址设置成0x01---0xFE，则只能接收对应地址码或地址码为 0xFF 的命令包。 0xFF 为广播包，芯片不需要进行应答；

命令码：占一个字节，普通键盘为0x01，多媒体键盘为0x11；相对坐标鼠标为0x02，绝对坐标鼠标为0x12；修改PID/VID为0x20，查询PID/VID为0x21；修改地址码为0x22，查询地址码为0x23；查询芯片ID为0x24；复位为0x0F；

后续数据：此长度根据命令码来决定

3.1 普通键盘/0x01

通过该命令向芯片发送普通键盘数据包，模拟普通按键按下或释放动作。 支持全键盘、组合键操作，可支持 8+6 个无冲突按键，其中 8 为 8 个控制键(左 Ctrl、 右 Ctrl、左 Shift、右 Shift、左Windows、右 Windows、左 Alt 和右 Alt)， 6 为 6 个控制键之外的普通按键。

帧头	地址码	命令码	后续数据
0x57,0xAB	0x00	0x01	8个字节键盘数据

8字节键盘数据：

（1）第1个字节为控制键，每个位代表1个按键，1代表按下，0代表松开，具体如下：

bit7	bit6	bit5	bit4	bit3	bit2	bit1	bit0
右 Windows键	右 Alt键	右 Shift键	右 Ctrl键	左 Windows键	左 Alt键	左 Shift键	左 Ctrl键

（2）第2个字节固定为0x00；

（3）第3-8个字节代表6个普通按键，最多可以表示 6 个按键按下，如果无按键按下则填写 0x00；普通按键的键码请下载键值对照表：

键值对照表链接：https://pan.baidu.com/s/1hs4tmFJgecZiuNFT4sGmCA 
提取码：1234

举例1：模拟先按下“A”键，再释放“A”键，则需要发送 2 个命令包为：

按下“A”键：57 AB 00 01 00 00 04 00 00 00 00 00

释放所有按键： 57 AB 00 01 00 00 00 00 00 00 00 00

举例 2：模拟先同时按下“左 Shift” +“A”键+“B”键，然后先释放“B”键，再释放“左 Shift” +“A”键，则需要发送 3 个命令包为：

同时按下“左 Shift” +“A”键+“B”键：57 AB 00 01 02 00 04 05 00 00 00 00

先释放“B”键（“左 Shift” +“A”键保持按下）：57 AB 00 01 02 00 04 00 00 00 00 00

释放所有按键：57 AB 00 01 00 00 00 00 00 00 00 00

指令执行成功后，模块会返回0x01！

3.2 多媒体键盘/0x11

通过该命令向芯片发送多媒体键盘数据包，模拟多媒体按键按下或释放动作。多媒体按键有两类，一类是ACPI键，主要为唤醒键、睡眠键、关机键三个按键；另一类为其他多媒体键，包含静音键、刷新键、计算器键等；

3.2.1 ACPI键

帧头	地址码	命令码	ACPI键类	后续数据
0x57,0xAB	0x00	0x11	0x01	1字节ACPI按键数据

1字节ACPI按键数据：

bit7	bit6	bit5	bit4	bit3	bit2	bit1	bit0
0	0	0	0	0	唤醒键	睡眠键	关机键

举例1：模拟按下睡眠键，再释放按键，则需要发送 2 个命令包为：

按下睡眠键：57 AB 00 11 01 02

释放按键： 57 AB 00 01 01 00

电脑进入睡眠后，可以通过发送唤醒键唤醒电脑；

举例2：模拟按下关机键，再释放按键，则需要发送 2 个命令包为：

按下关机键：57 AB 00 11 01 01

释放按键： 57 AB 00 01 01 00

其实关机键，不发送松开指令也是没问题的，因为关机了。

3.2.2 其他多媒体键

帧头	地址码	命令码	键类	后续数据
0x57,0xAB	0x00	0x11	0x02	3字节多媒体按键数据

3字节多媒体按键数据：

	bit7	bit6	bit5	bit4	bit3	bit2	bit1	bit0
Byte1	Eject	CD  Stop	Prev. Track	Next Track	Play/ Pause	Mute	Volume-	Volume+
Byte2	Refresh	WWW Stop	WWW Forward	WWW Back	WWW Home	WWW Favorites	WWW Search	E-Mail
Byte3	Rewind	Record	Minimize	My Computer	Screen Save	Calculator	Explorer	Media

举例1：模拟按下音量减键，再释放按键，则需要发送 2 个命令包为：

按下音量减键：57 AB 00 11 02 02 00 00

释放按键： 57 AB 00 01 02 00 00 00

举例2：模拟按下计算器键，再释放按键，则需要发送 2 个命令包为：

按下调出计算器键：57 AB 00 11 02 00 00 04

释放按键： 57 AB 00 11 02 00 00 00

指令执行成功后，模块会返回0x11！

 3.3 相对坐标鼠标/0x02

通过该命令向KM2S模块发送相对鼠标数据包，模拟相对鼠标相关动作(包括左中右键按下与释放、滚轮上下滚动、光标上下左右移动)。

帧头	地址码	命令码	后续数据
0x57,0xAB	0x00	0x02	4个字节相对坐标鼠标数据

4个字节相对坐标鼠标数据：

（1）第1个字节为鼠标按键数据，最低 3 位每位表示 1 个按键：

bit7	bit6	bit5	bit4	bit3	bit2	bit1	bit0
0	0	0	0	0	中键	右键	左键

BIT2---BIT0：为 1 表示该键按下，为 0 表示该键释放或未按下。

（2）第2个字节为光标在X方向（左右方向）的移动距离：

• 不动，字节2=0x00，光标在X轴方向不移动；
• 向右移动，0x01<=字节2<=0x7F；移动像素点 = 字节 2；
• 向左移动： 0x80 <= 字节 2 <= 0xFF； 移动像素点 = 0x00 - 字节 2；

（3）第3个字节为光标在Y方向（上下方向）的移动距离：

• 不动，字节3=0x00，光标在Y轴方向不移动；
• 向下移动，0x01<=字节3<=0x7F；移动像素点 = 字节 3；
• 向上移动： 0x80 <= 字节 3 <= 0xFF； 移动像素点 = 0x00 - 字节 3；

（4）第4个字节为滚轮滚动齿数：

0x01---0x7F，表示滚轮向上滚动，单位：齿数；
0x81---0xFF，表示滚轮向下滚动，单位：齿数；

举例1：模拟同时按下左，中，右键，再一起释放按键，则需要发送 2 个命令包为：

按下左，中，右键：57 AB 00 02 07 00 00 00

释放按键： 57 AB 00 02 00 00 00 00

举例2：模拟同时按下左键移动一段距离，再释放按键，则需要发送 3个命令包为：

按下左键：57 AB 00 02 01 00 00 00

向右移动100像素，向上移动50像素：57 AB 00 02 01 64 CE 00

计算方法：

向右（下）移动距离：0x64（16进制）=100（10进制）

0x32（10进制）=50（10进制）

向上（左）移动距离：0xCE（16进制）=0x100（16进制） - 0x32（16进制）

释放按键： 57 AB 00 02 00 00 00 00

指令执行成功后，模块会返回0x02！

 如果电脑移动的单位与实际单位不一致，需要关闭电脑的提高指针精准度功能，如图：

3.4 绝对坐标鼠标/0x12

通过该命令向KM2S模块发送绝对鼠标数据包，模拟绝对鼠标相关动作(包括左中右键按下与释放、滚轮上下滚动、光标移动位置)。

帧头	地址码	命令码	后续数据
0x57,0xAB	0x00	0x12	6个字节绝对坐标鼠标数据

6个字节绝对坐标鼠标数据：

（1）第1个字节为鼠标按键数据，与相对坐标鼠标功能一致；

（2）第2-3个字节为X轴坐标值，字节2为第字节，字节3为高字节；

（3）第4-5个字节为Y轴坐标值，字节4为第字节，字节5为高字节；

（4）第6个字节为滚轮滚动齿数，与相对坐标鼠标功能一致；

坐标计算方法：

芯片默认模拟的绝对鼠标分辨率为 4096 * 4096，外围串口设备下传 XY 绝对值时，需要先根据自身屏幕分辨率进行计算，再下传计算后的值；

例如当前屏幕分辨率为1920x1080，想让光标移动到（1000,500）的位置：

X = （4096*1000）/ 1920 = 2133（10进制）= 0x0855（16进制）；字节2=0x55，字节3=0x08；

Y = （4096*500）/ 1080 = 1896（10进制）= 0x0768（16进制）；字节4=0x68，字节5=0x07；

例如当前屏幕分辨率为1280x768，想让光标移动到（100,30）的位置：

X = （4096*100）/ 1280 = 320（10进制）= 0x0140（16进制）；字节2=0x40，字节3=0x01；

Y = （4096*30）/ 768 = 160（10进制）= 0x00A0（16进制）；字节4=0xA0，字节5=0x00；

举例1：模拟按下左键，再释放按键，则需要发送 2 个命令包为：

按下左键：57 AB 00 12 01 00 00 00 00 00

释放按键： 57 AB 00 12 00 00 00 00 00 00

举例2：屏幕分辨率1920x1080,光标移动到（1000,500），则需要发送1个命令包为：

移动到（1000,500）：57 AB 00 12 00 55 08 68 07 00

指令执行成功后，模块会返回0x12！

3.5 VID及PID

VID为厂商ID，PID为产品ID；正常使用无需修改，如有特殊用途，可以自定义进行修改；

3.5.1 修改VID及PID/0x20

帧头	地址码	命令码	VID	PID
0x57,0xAB	0x00	0x20	2字节VID	2字节PID

指令执行成功后，模块会返回0x20，并自动重启！

3.5.2 读取VID及PID/0x21

读取指令格式：

帧头	地址码	命令码
0x57,0xAB	0x00	0x21

返回数据格式：

命令码	VID	PID
0x21	2字节	2字节

 3.6 地址码

地址码为通信数据里面的地址字节，默认为0x00,可接收任意地址码的命令包，如果模块地址设置成0x01---0xFE，则只能接收对应地址码或地址码为 0xFF 的命令包。 0xFF 为广播包，KM2S模块不需要进行应答；设置成功后立即生效；

3.6.1 设置地址码/0x22

设置地址码格式：

帧头	地址码	命令码	新地址码
0x57,0xAB	0x00	0x22	1字节新地址码

设置成功后会返回0x22及新地址码；

3.6.2 读取地址码/0x23

读取指令格式：

帧头	地址码	命令码
0x57,0xAB	0x00	0x23

返回数据格式：

命令码	地址码
0x23	1字节地址码

 3.7 查询芯片ID/0X24

芯片ID为四字节长度的芯片内置ID，无法修改且唯一，可用于识别模块；

读取指令格式：

帧头	地址码	命令码
0x57,0xAB	0x00	0x24

返回数据格式：

命令码	芯片ID
0x24	4字节芯片ID

 3.8 复位/0x0F

复位指令可控制KM2S模块进行软复位，不需要拔插设备；系统复位前会先发送普通键盘、多媒体键盘、相对鼠标和绝对鼠标所有按键松开指令；