Oholeo键盘固件

硬件工程: https://oshwhub.com/dwdwdw37/keyboard_origin

配置器: https://github.com/zhangqili/EMIKeyboardConfigurator

旧版配置器(固件版本v1.0): https://github.com/dwdwdw5163/oholeo_keyboard_software

• 支持传统触发、快速触发(Rapid Trigger)、差速触发三种模式
• 支持Mod tap、Mutex(类似Rappy Snappy)、DKS等高级按键
• 支持绑定键盘，鼠标，媒体控制，系统控制按键
• 支持板载Flash切换配置
• 支持最多5层按键绑定
• 支持切换6键无冲与全键无冲模式
• 支持模拟DInput游戏摇杆与按键，可通过Steam重映射
• 支持模拟XInput游戏手柄，可免映射使用
• 支持模拟MIDI键盘
• 支持低延迟模式，该模式会关闭大部分灯效
• 支持硬件录制播放按键宏
• 配套免驱配置器
• 支持Windows动态光效(实验性，需要在keyboard_conf.h中取消注释LIGHTING_ENABLE，可能会干扰ADC采样)
• 没有主机也能玩贪食蛇

• 使用蜂鸣器播放MIDI音符

• CMake
• Ninja
• gcc(Windows参考https://code.visualstudio.com/docs/cpp/config-mingw搭建MinGW环境，需要将C:\msys64\usr\bin与C:\msys64\ucrt64\bin依次放置在系统Path环境变量的最上方)
• 在ST官网上下载安装STM32Cube开发套件 https://www.st.com.cn/zh/development-tools/stm32cubeclt.html
• 在ST官网上下载安装STM32CubeProgrammer https://www.st.com.cn/zh/development-tools/stm32cubeprog.html，安装STM32Bootloader驱动
• 将该仓库克隆到本地并在该仓库文件夹打开命令行终端

git clone --recurse-submodules https://github.com/zhangqili/oholeo-keyboard-firmware.git
cd oholeo-keyboard-firmware

以STM32CubeCLT 1.17.0为例，该开发套件默认安装至C:\ST\STM32CubeCLT_1.17.0，接下来你需要将开发套件中的编译器目录添加至环境变量

以PowerShell为例

$Env:PATH += ";C:\ST\STM32CubeCLT_1.17.0\GNU-tools-for-STM32\bin"

mkdir build
cd build
cmake .. -G"Ninja" --preset=Release
cd Release
ninja

如果编译成功，你会看到类似以下的结果

[65/65] Linking C executable oholeo-keyboard-firmware.elf
C:/ST/STM32CubeCLT_1.17.0/GNU-tools-for-STM32/bin/../lib/gcc/arm-none-eabi/12.3.1/../../../../arm-none-eabi/bin/ld.exe: warning: oholeo-keyboard-firmware.elf has a LOAD segment with RWX permissions
Memory region         Used Size  Region Size  %age Used
             RAM:       19144 B        32 KB     58.42%
          CCMRAM:          0 GB         8 KB      0.00%
           FLASH:       85936 B       128 KB     65.56%

如果编译遇到问题，请去cmake/gcc-arm-none-eabi.cmake删除所有的-flto=auto

搭建MinGW环境后使用Keil uVision打开MDK-ARM/oholeo-keyboard-firmware.uvprojx，工程默认使用ARM Compiler 6

将STLink连接至PCB的STLink接口，使用以下命令烧录

C:/ST/STM32CubeCLT_1.17.0/STM32CubeProgrammer/bin/STM32_Programmer_CLI.exe -c port=SWD -w ./oholeo-keyboard-firmware.elf -v -s

短接PCB上的BOOT跳线孔上电可进入Bootloader，如果PCB已经烧录了该固件，PCB左上角需要安装磁轴，在PCB上电时按住左上角的Esc键会进入Bootloader。之后使用以下命令烧录

C:/ST/STM32CubeCLT_1.17.0/STM32CubeProgrammer/bin/STM32_Programmer_CLI.exe -c port=USB1 -w ./oholeo-keyboard-firmware.elf -v -s

第一次烧录启动时，请在上电时按住FN键恢复出厂设置