/Rapid-trigger-minipad

低成本实现Wooting键盘的Rapid trigger功能,不必为几个按键购买整个键盘,人人都能做,WouoUI例程。

Primary LanguageC++Apache License 2.0Apache-2.0

Rapid-trigger-minipad

Rapid trigger是Wooting键盘的特色功能,是指没有固定键程,靠上下移动判定触发的功能,能解决切指卡手的大难题,传言能破解osu!这款游戏。

我本来想尝试一下wooting,但其价格昂贵,没有渠道,二手抢钱等等问题让我很不爽,于是决定自己做,我想这也是许多玩家想做的,所以我将它分享出来,现在,它属于每一名玩家了。

本项目提供三种主控方案,其中以STM32为主,出于性能和性价比考虑,CH552和RP2040版本将不再更新,但仍然保留代码给有需要的人。

按键为独立模块并且全部使用杜邦线连接,按键间距可调,STM32版本最多支持10个模拟输入按键,这应该能满足大部分玩家在按键数量和个性化上的需求了。

这并不是很厉害的技术,但确实还算有趣,感兴趣的话欢迎尝试制作。我希望这个项目越多人关注越好,最好在玩家群体里流行开来,我认为这种功能被说是走捷径的根源就是不够普及,所以都来用吧。

参考或使用此项目请遵守附带的开源协议,如愿意分享,欢迎投稿至第三方文件夹。

13

项目特点

  • 制作简单,无需任何专业操作(如焊接等)和专业知识就能制作。
  • 无法垄断,所有材料在国内都有渠道购买并且供货充足。
  • 本地控制,增加控制器,除按键总键程外,所有设置都可以在本地完成。
  • 丝滑菜单,控制器使用模仿稚晖君MonoUI的多级菜单,动画被优化到非常丝滑,可以当解压玩具(真的)。
  • 按键数多,最多能添加10个模拟按键,多于市面上其它方案,并且每个按键都可以不一样。
  • 三种模式,支持不同极性按键,不同极性传感器的所有组合,组合对应两个模式,还有禁用模式。
  • 键距可调,每个按键为独立制作并且可以在外壳内自由摆放,提供多种宽度的填充模块。
  • 成本较低,使用stm32作为主控,价格比arduino更低,按键数量可以自行选择以降低成本。
  • 性能更好,经测试,ADC精度比频率等因素更影响表现,而stm32有精度更高的ADC,因此是最优选择。

控制器

主菜单:

屏幕截图 2023-05-29 011856

编辑页:

屏幕截图 2023-05-29 012131

弹窗:

屏幕截图 2023-05-29 012300

电压测量页:

屏幕截图 2023-05-29 012449

演示视频:https://www.bilibili.com/video/BV17T41187xi/

控制器使用0.96寸OLED显示,EC11旋钮控制,使用了我的另一个项目:WouoUI,关于UI的描述请查看该项目。

控制器支持调整的参数:

  • 触发值
  • 释放值
  • 上死区
  • 下死区
  • 键值
  • 模式(压缩包内的代码不支持该项)
  • 初始化时放大抖动的倍数

注意:

  • 外壳模型尚未支持安装屏幕和旋钮,请自行修改外壳,否则请使用压缩包内的代码。
  • 安装轴体下的磁铁时,请使用压缩包内的工具代码,检查磁铁方向是否安装正确,要求按下增大,释放减小。
  • 控制器是给以后可能使用的成品轴体设计的,轴体极性不确定,手制轴体的话,可以确保表现的唯一,无需另一种模式。
  • 压缩包内的代码,Rapid trigger功能部分,与更高版本没有本质区别,无需介意版本号较低。

内部结构

四按键版本:

Notes_230225_033130_2

十按键版本:

Notes_230225_033130_2 (1)

制作教程

  1. 轴体改造篇:https://www.bilibili.com/read/cv21948435
  2. 软件设置篇:https://www.bilibili.com/read/cv21969155
  3. 硬件组装篇:https://www.bilibili.com/read/cv21985212

参考项目

  1. hall-2k-keypad-handmade:https://github.com/chent7/hall-2k-keypad-handmade(主要)
  2. 如何DIY一款属于自己的HID键盘:https://mp.weixin.qq.com/s/o-8_3SQS2AGT_WTyTLYQnA
  3. 【三键侧透光小键盘】CH552G:https://oshwhub.com/phantomr/styudy-xiao-jian-pan-ch552g

推荐项目

下列项目都有Rapid trigger功能,它们各有优势,对我的项目有建议的,在给出建议之外,也可以尝试在这些项目中寻找解决方案。

改进空间

目前我的方案在通用性和表现上都已经很不错了,动手能力不强的普通玩家完全可以放心尝试,不会令你们失望的。 对于不惜代价追求极致的人来说,我的方案可能显得太过廉价,因此在这里提出一些改进空间,欢迎尝试,如果愿意分享的话,请合并在第三方设计项目中供他人参考。

  • 使用stm32作为主控,不是因为廉价,而是因为它拥有最高的ADC分辨率,这个最影响体验。
  • 使用stm32标准库或者hal库实现通信功能,因为有成熟的方案可用,但因为IDE劝退新手而弃用。
  • 使用AH491线性霍尔传感器,这种灵敏度很高为15mv/Gs,但相对的会放大抖动,因为不好调试而弃用。
  • 使用pcb,能降低干扰并且有助于批量化生产,但因为无法实现可调键距和需要焊接而弃用。
  • 使用成品磁轴,轴芯有个小磁铁跟着上下移动的那种,因为有垄断风险而弃用,目前已知的有三种:
    1. wooting的lekker轴,这个要海淘。
    2. 佳达隆的ks-20,这个买不到。
    3. 东莞市益谦电子有限公司,1688搜索“磁轴”能找到,应该能买到。

建议收集

可以直接在GitHub上提建议,也可以在B站专门的动态下提。

赛博乞讨(划掉

开发不易,如果有帮到你,请我喝杯咖啡可好 1697424547928

更新

软件

v 3.2

  • 优化动画函数,动画结束后不会再进行无意义的浮点数计算。

v 3.1

  • 修复EC11旋钮使界面卡死的问题,感谢 GitHub 安红豆 提供的线索。

v 3.0

  • UI 流畅度优化,实现了优雅的平滑动画,动画算法被优化到只有两行。
  • UI 架构优化,基本重构了 v2.x,实现了独立弹窗,白天和黑暗模式,单选和多选框,开关等。
  • 删除主界面列表菜单风格,增加主界面图标动画可选项。
  • 删除关于本机页配置查看功能,增加参数修改页面,参数直接显示在每行末尾功能。
  • 选择框跳转动画改为宽度和竖直方向位置都从当前位置到上一级选中位置平滑过渡。
  • 增加动画速度可调区间。10 ~ 100。
  • 修复循环模式选择框在跳转动画未结束前,选择项后退时,列表与屏幕错位的问题。
  • 修复选择框在选择滚动过快时,滚出屏幕外的问题。
  • 增加独立弹窗动画,背景虚化开关功能。
  • 重新设计电压测试页,增加波形显示功能,现在可以同时观察数值和波形。

v 2.1

  • 重构代码,只保存路径和选择框所在位置,分页面类型定义变量。
  • 增加图标和列表两种主界面风格。
  • 支持本地查看所有配置,在关于本机页面。
  • 支持128×64,128×32两种主流OLED屏幕分辨率,只需要替换驱动即可。
  • 增加列表展开动画效果。
  • 增加选择框展开和跳转动画效果。
  • 增强动画速度的可调精度。
  • 增加循环模式。
  • 增加旋钮方向反转选项。

v 2.0

  • 增加模仿MonoUI的丝滑菜单。
  • 支持不同极性的轴和不同极性的传感器,使用对应模式即可。
  • 支持在本地设置所有参数。
  • 支持断电保存功能。
  • 支持引脚测试,可以在本地查看引脚电压变化曲线。

v 1.3

  • 初始化改为并行扫描,按键数增加不会明显延长初始化时间。
  • 增加初始化指示灯,在板子上的蓝灯未熄灭前,不要按下按键。

v 1.2

  • 解决了插入后微小干扰下误触发的bug。
  • 增加了上下死区。
  • 增加除字母外其它按键的支持。

v 1.1

  • 解决了插入后不断输入的bug。
  • 优化了初始化方式。

v 1.0

  • 简单移植hall-2k-keypad-handmade。

硬件:

v 1.2

  • 增加OLED显示屏。
  • 增加EC11旋钮。

v 1.1

  • 增加十按键版本外壳模型。
  • 增加几种填充模块模型。

v 1.0

  • 四按键版本外壳模型。
  • 独立按键所需模型。
  • 材料清单。