【经验分享】如何DIY一款属于自己的HID键盘?

[复制链接]

STMCU小助手发布时间：2022-6-21 21:42

文章
文章封面:
文章简介:	如何DIY一款属于自己的HID键盘?

这是一个自定义游戏键盘，带有四个热插拔机械键和可自定义的RGB LED。它由STM32F103Cx微控制器供电，并通过Arduino IDE进行编程。

文章末尾分享该项目资料。

功能概述：

快速STM32F103Cx微控制器可实现低输入延迟。
USB全速，轮询速率为1000hz。
可热插拔的键。
EEPROM设置存储。
动态密钥自定义（使用Windows用户的GUI）
具有添加更多功能的三种RGB模式。
完全开源。
兼容Arduino。
模块化且易于携带。
0 _ e. g5 c3 z9 L

0 e9 a2 L8 x" x

设计框图

$~V@BC@OE{E66FP0%7M1Z_K1.png$

键盘使用STM32F103C8T6作为控制器。由于USB端口上的电源引脚为5V供电，但是该款单片机需要使用3.3V电源供电，因此需要将5V转为3.3V，项目中使用MCP1703T来实现该功能。使用Cherry MX风格的机械开关来作为键盘的按键。另外，还可以通过按键来控制LED的模式、颜色、亮度。

系统原理图

系统PCB

PCB大小为58mm x 59mm。为了能够方便手工焊接，所有的SMD器件均使用0805封装。

硬件上提供了STLINK下载接口：

SWDIO-SWDIO
SWCLK-SWCLK
GND-GND
3V3-3.3V
& B. |5 ^, z: ?# b) i, h
- r/ ]' `# l: B$ r8 J! `! G

材料清单：

1个STM32F103CxT6
2个7.3mm高的触觉开关
4个反向安装4-PLCC LED
6个0805 10K欧姆电阻
4个0805 68欧姆电阻
5个0805 1.5K欧姆电阻
3个N沟道SOT-23-3 3.3V电平MOSFET
3个0805 100nF电容器
2个0805 1uF电容器
2个0805 20pF电容器
1个0805 4.7uF电容器
1个MCP1703T-3302T / DB 3.3V稳压器
1个1210 500mA PTC自恢复保险丝
1个USB3090微型USB A / B端口
1x 90度接头排
1个8MHz HC-49晶体
4个圆形橡胶保险杠
4个Kailh热插拔插槽
4个Cherry MX RGB或同等开
6 c2 \0 G' z/ x, t

' c6 |0 E$ `! H

安装STM32Duino

打开arduino ide，打开首选项

添加完成之后，打开开发板管理器，搜索STM，安装STM32F1xx/GD32F1xx

STM32Duino内的USB库已经提供的USB HID功能，但其轮询间隔为10ms，因此我们还要对其进行修改。

进入目录C:\Users{username}\AppData\Local\Arduino15\packages\stm32duino\hardware\STM32F1{版本名称}\libraries\USBComposite下，打开usb_hid.c文件
搜索bInterval，将该值修改为0x01。轮询间隔修改为1ms

" p% f- s4 S/ K0 O

代码配置说明

去抖时间/ M% ?# w$ L- }0 M9 I/ S! q }
这是检测到按键后按键拒绝注册按键释放的时间。需要一个反跳时间，因为机械开关在按下后自然会“反跳”，如果不使用反跳计时器，可能会在很短的时间内记录多次错误的按键。在这种情况下，设置防抖计时器的方式不会影响延迟，因此更改此值不会使按键延迟更多。Cherry指定反弹时间为5毫秒，该值应适用于大多数机械开关。
RGB LED
# x! J$ |' d% U: ^: L' I禁用此选项将禁用所有与RGB LED控制有关的代码。这可能会节省一些CPU周期，但不足以有效地更改键盘的性能。
串行通讯' N- @/ J9 X d% m D. j; q
禁用此选项将不允许通过串行或驱动程序软件对键盘进行编程，但是由于微控制器不再需要不断侦听串行命令，因此它将节省一些CPU周期。尽管理论上微控制器在不启用串行的情况下应该运行得更快，但是速度差异可以忽略不计。
RGB LED颜色和图案
' l; E9 @/ o9 y% l! {' N如果需要修改RGB LED颜色，则必须直接编辑代码。在checkRGBMode()函数下定义的颜色存储所有的灯光模式0颜色（静态），而incrementColor()下的颜色存储灯光模式2（颜色循环）颜色。1 N& ^! ^6 H8 i
更改颜色，只需更改rgbBrightness []值。这些值以百分比表示该颜色的亮度，其中0为0％，1为100％。rgbBrightness []中的1-3数组分别表示红色，绿色和蓝色。
ledDelay：
% d3 ?# H4 D- w, d这表示在灯光模式2下颜色切换过程之间的延迟，这意味着如果延迟较高，则颜色将缓慢切换，而如果延迟较低，则颜色将更快切换。
colorIncrementDelay
" w7 u; ]% b8 ~5 s. ~这表示在灯光模式2下切换颜色之间的时间。

; U7 ~7 m7 j4 C6 \
% x+ l+ y5 s% `+ n6 R

使用键盘

该键盘的使用非常简单，直接插入电脑USB口，即可作为正常，低延迟，轮询速率为1000hz的HID键盘使用。同时，还可以通过按键修改LED的模式和颜色。
按键说明：
$ M2 M6 g% Q4 C/ ] Y! u# x

* |5 Y6 B4 `! N o

按下模式按钮的时间少于0.3s会更改照明模式。
按下按钮超过0.3s但少于5s会更改LED颜色，可以通过代码进行自定义。
按住按钮超过5s将开始改变LED的亮度，并且按住按钮时亮度将以1s的增量下降。亮度将在释放按钮时设定。
+ N. t+ V7 |9 [6 p+ l

, S' f2 C3 i$ F, C, m

灯光模式：
7 x0 j; d9 V: L; W: `5 k% s' U4 B
6 s5 i$ {( p0 Q0 |5 H- A

静态色
按下键时点亮
交替（默认固件在红色和蓝色之间，但是可以有多种颜色）
4 {" M* S. L' z& X- u! n Y
+ d- n2 u. N% D: t% I/ r$ t

系统的所有配置信息都是存放在EEPROM中。

# g) v9 i5 H" p" _4 e" |. b2 r" Z* o8 F; [% A1 y

配置按键

若想能够随时、方便的修改按键对应的键值，则需要开启程序中的串口通信功能。有了该功能后，系统将可以通过串口命令对其进行配置。也可通过上位机软件对其进行配置

串口命令："s：{key number}:{character}:"

9 [. Z# y f f( \. Q5 h

"s:1:k:",将按键1设置为k
0 o: i1 @: v; ?6 E

使用上位机软件

5 G- o9 ^/ T. E- ^) I+ {3 A' n! k' z: H- ^( r

上位机软件说明

连接设备后，可以使用该程序即时设置按键绑定。为此，请使用名为"keybinds"的面板。您可以通过下拉菜单（参考帮助-键映射的键映射）选择键编号，然后可以通过文本框输入键绑定值。目前仅接受Ascii字符和数字，不幸的是，冒号不是可行的选择，因为它被用作分隔符。如果要禁用该键，只需在文本框中什么也不放，然后按set键即可。
填写完两个选项后，只需按设置按钮，如果一切顺利，就可以设置按键绑定。即使断电，此新设置也将保存在微控制器上。
原始序列号和状态5 K1 s1 r& F- |7 m+ K% d
这两个部分用于诊断目的。原始串行是设备发送回的串行数据的显示，状态面板显示了存储在设备上的不同设置。

& s$ m. I) e% F9 U9 C; ]% E( y% a1 r9 [6 }# R4 n. N2 x5 k