STM32F103C8 Serial to USB HID Keyboard Mouse Joystick 串口转USB源码
文件大小:
295k
资源说明:STM32F103C8
Serial(UART) to USB HID Keyboard Mouse Joystick
串口 转 USB键盘;鼠标;手柄
(1) 使用Composite Device 组合(复合)设备
(1.1) 1个Device -> 1个 Configuation -> 3个Interfance (Keyboard & Mouse & Joystick)
(1.2) 支持BIOS模式中的操作(使用HID boot模式) 以便兼容在计算器中设定BIOS :
(1.2.1) Keyboard Interfance -> HID (boot mode) -> 2个Endpoint(IN_0x81 & OUT_0x01) -> KeyboardReportDescriptor(不使用Report ID)
(1.2.2) Mouse Interfance -> HID (boot mode) -> 1个Endpoint(IN_0x82) -> MouseReportDescriptor(不使用Report ID)
(1.3) 支持Windows模式中的操作(使用Report ID) :
(1.3.1) Multimedia Keyboard Interfance -> HID -> 1个Endpoint(IN_0x85) -> KeyboardReportDescriptor(使用Report ID)
(1.3.1.1) Report ID (1) : HID Usage Page 0x0C, MediaKey
(1.3.1.2) Report ID (2) : HID Usage Page 0x01, PowerControl
(1.3.2) Mouse Interfance -> HID (boot mode) -> 1个Endpoint(IN_0x84) -> MouseReportDescriptor(使用Report ID)
(1.3.2.1) Report ID (1) : 相对坐标 (-32768 ~ 32767)
(1.3.2.2) Report ID (2) : 绝对坐标 (0 ~ 2048)
(1.4) 支持反馈Keyboard_LED灯号: All Off; Num Lock; Caps Lock; Scroll Lock; Compose; Kana
(1.5) Joystick Interfance -> HID -> 1个Endpoint(IN_0x83) -> JoyStickReportDescriptor
(1.7) 支持GPIO命令, 可控制 12个GPIO 0/1 (hi/low)输出
(1.8) 支持Hardware或Software 插拔(Connect/Disconnect)命令
(1.9) 支持Software Reset命令
(2) 串口接收 命令
(2.1) UART协议: 115200, n, 8, 1
(2.2) 1帧发送字符串格式, 以 '{'开始, '}'结束 ','分隔 共10个10进制数字
例如: {1,2,3,4,5,6,7,8,9,10}
(2.3) 第1位 区分 Keyboard(128) 或是 Mouse(64) 或是 Joystick(32) 或是 Control(32) 命令
Control_cmd = 0x10,
Joystick_cmd = 0x20,
Mouse_cmd = 0x40,
MouseHold_cmd = 0x41,
AbsMouse_cmd = 0x42,
AbsMouseHold_cmd= 0x43,
Keyboard_cmd = 0x80,
KeyboardHold_cmd= 0x81,
MediaKey_cmd = 0x82,
MediaKeyHold_cmd= 0x83,
Switch_cmd = 0xC0,
SwitchHold_cmd = 0xC1
例如:
{16, 0,0,0,0,0,0,0,0} --- 发送Control命令
{32, 0,0,0,0,0,0,0,0} --- 发送Joystick命令
{64, 0,0,0,0,0,0,0,0} --- 发送Mouse命令(相对坐标)
{65, 0,0,0,0,0,0,0,0} --- 发送Mouse命令(相对坐标)(按住不放)
{66, 0,0,0,0,0,0,0,0} --- 发送WinMouse命令(相对坐标/绝对坐标)
{67, 0,0,0,0,0,0,0,0} --- 发送WinMouse命令(相对坐标/绝对坐标)(按住不放)
{128,0,0,0,0,0,0,0,0} --- 发送Keyboard命令
{129,0,0,0,0,0,0,0,0} --- 发送Keyboard命令(按住不放)
{130,0,0,0,0,0,0,0,0} --- 发送MediaKey命令
{131,0,0,0,0,0,0,0,0} --- 发送MediaKey命令(按住不放)
(3) 发送Keyboard键盘命令时 : 第2~9位 分别如下
(3.1) 第2位 : Modify_Key(修饰键)
Key_Release = 0x00,
Left_Control = 0x01,
Left_Shift = 0x02,
Left_Alt = 0x04,
Left_GUI = 0x08,
Right_Control = 0x10,
Right_Shift = 0x20,
Right_Alt = 0x40,
Right_GUI = 0x80,
例如:
{128, 8,0,0,0,0,0,0,0} --- 发送 Win_Key键
{128, 128,0,0,0,0,0,0,0} --- 发送 WinApp_Key键
{128, 32,0,0,0,0,0,0,0} --- 发送 右Shift键
(3.2) 第3位 : 保留,不使用,一律填0
(3.3) 第4~9位 : 可以同时发送6个Keyboard按键
例如:
{128, 0,0,4,5,6,7,8,9} --- 发送 'abcdef'键
{128, 2,0,4,5,6,7,8,9} --- 按住 左Shift 发送 'abcdef'键 => 'ABCDEF'
{128, 0,0,0,5,0,7,0,9} --- 发送 'bdf'键 (0表示 无按键)
{129, 0,0,4,0,0,0,0,0} --- 按住 'a'键不放 (不是 'a'键 连发)
{129, 0,0,0,0,0,0,0,0} --- 释放所有按住的键
(3.4) 发送MediaKeyboard键盘命令时 : 第2~3位 分别如下
(3.4.1) 第2位 : report ID
Report ID = 1 : 使用 HID Usage Page 0x0C
Report ID = 2 : 使用 HID Usage Page 0x01
(3.4.2) 第3位 : 发送WindowsKey
例如:
{130, 1,233} --- (report ID = 1, HID Usage Page 0x0C) 发送 Volume Up (0xE9 = 233)
{130, 1,402} --- (report ID = 1, HID Usage Page 0x0C) 执行 Calculator (0x0192 = 402)
{130, 2,130} --- (report ID = 2, HID Usage Page 0x01) 执行 System Sleep (0x82 = 130)
按键码 可参阅: (HID Usage ID)
http://download.microsoft.com/download/1/6/1/161ba512-40e2-4cc9-843a-923143f3456c/translate.pdf
https://www.hiemalis.org/~keiji/PC/scancode-translate.pdf
https://gist.github.com/MightyPork/6da26e382a7ad91b5496ee55fdc73db2
http://www.usb.org/developers/hidpage/Hut1_12v2.pdf
(4) 发送Mouse鼠标命令时 : 第2~9位 分别如下
(4.1) 第2位 : 鼠标按钮(左,中,右)占3bits
Button_Release = 0x00,
Left_Button = 0x01,
Right_Button = 0x02,
Mid_Button = 0x04,
例如:
{64, 1,0,0,0,0,0,0,0} --- 点击 左键
{64, 2,0,0,0,0,0,0,0} --- 点击 右键
{64, 4,0,0,0,0,0,0,0} --- 点击 中键
{65, 1,0,0,0,0,0,0,0} --- 按住 左键 不放
{65, 0,30,40,0,0,0,0} --- 移动鼠标 并 释放按键
(4.2) 第3~5位 : 移动(X,Y), 滚轮(Wheel)
X: -127~127:左右移动鼠标
Y: -127~127:上下移动鼠标
Wheel: -127~127:上下转动滚轮
例如:
{64, 0,20,-10, 0, 0,0,0,0} --- 鼠标 右移20,上移10
{64, 0, 0, 0,-30} --- 滚轮-30
(4.3) 第6~9位 : 保留,不使用,一律填0 (或不填)
(4.4) 发送Windows模式中的Mouse键盘命令时 : 第2~3位 分别如下
(4.4.1) 第2位 : report ID
Report ID = 1 : 使用 相对坐标
Report ID = 2 : 使用 绝对坐标
(4.4.2) 第3位 : 鼠标按钮(左,中,右)占3bits
Button_Release = 0x00,
Left_Button = 0x01,
Right_Button = 0x02,
Mid_Button = 0x04,
(4.4.3) 第4~6位 : 移动(X,Y), 滚轮(Wheel)
(4.4.3.1) Report ID = 1 : 使用 相对坐标
X: -32768 ~ 32767:左右移动鼠标
Y: -32768 ~ 32767:上下移动鼠标
Wheel: -127~127:上下转动滚轮
(4.4.3.2) Report ID = 2 : 使用 绝对坐标
X: 0 ~ 2048:左右移动鼠标
Y: 0 ~ 2048:上下移动鼠标
Wheel: -127~127:上下转动滚轮
例如:
{66, 1, 0,500,-400} --- 鼠标 右移500,上移400
{66, 2, 0,500, 400} --- 鼠标跳到 距右上角 右边500位置, 距右上角下方400位置
(5) 发送Joystick手柄命令时 : 第2~10位 分别如下
(5.1) 第2~4位 : 移动X,Y,Z
X: -127~127:X轴左右移动手柄
Y: -127~127:Y轴上下移动手柄
Z: -127~127:Z轴转动手柄
例如:
{32,-127, 0, 0, 0,0,0, 0,0,0} --- 移动手柄X轴到-127(最右边)
{32, 0,127, 0, 0,0,0, 0,0,0} --- 移动手柄Y轴到127(最下面)
{32, -95, 32,96, 0,0,0, 0,0,0} --- 移动手柄X,Y,Z轴到(-95,32,96)
(5.2) 第5~7位 : 旋转X,Y,Z
X: -127~127:X轴旋转
Y: -127~127:Y轴旋转
Z: -127~127:Z轴旋转
例如:
{32, 0,0,0, 63, 0, 0, 0,0,0} --- 旋转手柄X轴到63
{32, 0,0,0, 0,-32, 0, 0,0,0} --- 旋转手柄Y轴到-32
{32, 0,0,0, 0, 0,127, 0,0,0} --- 旋转手柄Z轴到127
(5.3) 第8位 : 8个按钮(每个按钮占1bit)
例如:
{32, 0,0,0, 0,0,0, 85, 0,0} --- 按钮: (0x55=85) 1,3,5,7:ON; 2,4,6,8:OFF
{32, 0,0,0, 0,0,0, 170, 0,0} --- 按钮: (0xAA=170) 1,3,5,7:OFF; 2,4,6,8:ON
(5.4) 第9~10位 : 2个 Hat_switch(方向帽) POV1, POV2
POV1: -8~7
POV1_0 = 0, (-8)
POV1_45 = 1, (-6)
POV1_90 = 2, (-6)
POV1_135 = 3, (-5)
POV1_180 = 4, (-4)
POV1_225 = 5, (-3)
POV1_270 = 6, (-2)
POV1_315 = 7, (-1)
POV2: -8~7
POV2_0 = 0, (-8)
POV2_45 = 1, (-7)
POV2_90 = 2, (-6)
POV2_135 = 3, (-5)
POV2_180 = 4, (-4)
POV2_225 = 5, (-3)
POV2_270 = 6, (-2)
POV2_315 = 7, (-1)
例如:
{32, 0,0,0, 0,0,0, 2,0} --- POV1 到90度
{32, 0,0,0, 0,0,0, 0,6} --- POV2 到270度
(6) 发送Switch控制命令时 : 第2~10位 分别如下
(6.1) 第2位 : 控制 PB5 ~ PB0 的输出
例如:
{192, 7,0} --- 发出200ms后关闭, [PB5,PB4,PB3,PB2,PB1,PB0] 的输出: [0,0,0,1,1,1]
{193, 1,0} --- 持续发出PB=1, [PB5,PB4,PB3,PB2,PB1,PB0] 的输出: [0,0,0,0,0,1]
(6.2) 第3位 : 控制 PB13 ~ PB8 的输出
例如:
{192, 7,12} --- 发出200ms后关闭, [PB5,PB4,PB3,PB2,PB1,PB0] 的输出: [0,0,0,1,1,1]
--- [PB13,PB12,PB11,PB10,PB9,PB8] 的输出: [0,0,1,1,0,0]
{192, 0,0} --- 关闭所有, PB5~PB0 PB13~PB8 的输出皆为: 0
(6.3) 第4~9位 : 保留,不使用,一律填0 (或不填)
(7) 发送Control控制命令时 : 第2~10位 分别如下
(7.1) 第2位 : 控制命令
0: 反馈目前的USB状态
1: 重启 此USB HID设备
2: USB联机 (USB Coneect)
15: USB断线 (USB Disconeect)
需电阻(1.0~1.5K)接在 PA8和PA12间,做为 USB V-Bus控制
例如:
{16, 0} --- 反馈目前的USB状态
{16, 1} --- 重启 此USB HID设备
{16, 2} --- USB重新联机 (USB Coneect)
{16, 15} --- USB断线 (USB Disconeect)
PA0 -------- 接GND, USB断线 (USB Disconeect)
PA0 -------- 空接(或接+3V), USB联机 (USB Coneect)
(7.2) 第3~9位 : 保留,不使用,一律填0 (或不填)
本源码包内暂不包含可直接显示的源代码文件,请下载源码包。