尝试给自己的键盘编译 QMK 固件

Date

Oct 21, 2022

Description

For my keychron k8 rgb

Public

Published

环境

ArchLinux


$ paru -S qmk

固件编译

源码

找到一份支持 keychron 键盘的源码 (非官方) 暂时不支持蓝牙

qmk_firmware

SonixQMK • Updated Aug 22, 2023

官方貌似只支持 K8 Pro 甚至支持蓝牙有点难受

qmk_firmware/keyboards/keychron at bluetooth_playground · Keychron/qmk_firmware

Open-source keyboard firmware for Atmel AVR and Arm USB families - qmk_firmware/keyboards/keychron at bluetooth_playground · Keychron/qmk_firmware

https://github.com/Keychron/qmk_firmware/tree/bluetooth_playground/keyboards/keychron

编译


$ cd qmk_firmware
$ qmk setup
$ qmk compile -kb keychron/k8/rgb/ansi -km via

固件烧录

烧录工具

sonix-flasher

SonixQMK • Updated Aug 17, 2023

环境配置

为了避免使用 root 用户运行烧录工具

可以添加一个 udev 规则


SUBSYSTEM=="usb", ATTR{idVendor}=="05ac", ATTR{idProduct}=="024f", TAG+="uaccess", TAG+="udev-acl"
KERNEL=="hidraw*", ATTR{idVendor}=="05ac", ATTR{idProduct}=="024f", TAG+="uaccess", TAG+="udev-acl"

/etc/udev/rules.d/k8-keyboard.rules

烧录选项

设备选择 SN32F24

offset 选择 0x00 (除非你有 Jumploader)

使用 HFD 的方式可以进入 bootloader 引导

进入引导后, 键盘会只亮个绿灯, 且无法输入到连接的设备上

体验

… 编译出来的固件貌似有点问题, 等有空再继续研究了 😟

~~下次我肯定会换一个对~~ ~~qmk~~ ~~兼容好点的键盘~~

刷回官方固件

Firmware for Keychron K8

How to update the firmware? Note: If everything works fine with your keyboard. Please don't update the firmware. There is a chance it can damage your keyboard. WARNING: ONLY FOR Keychron K8 USERS Please follow the instructions correctly to flash the firmware.

https://www.keychron.com/pages/firmware-for-keychron-k8

参考

QMK on K8

Alltough it seems like Keychron wont bring QMK to old boards themselves with, it seems like alex-dinh has come a long way in making this happen. At ...

https://www.reddit.com/r/Keychron/comments/n118v2/qmk_on_k8/

QMK Firmware Docs

The full documentation of the open-source firmware

https://docs.qmk.fm/#/configurator_step_by_step

QMK Firmware - An open source firmware for AVR and ARM based keyboards

The goal of the QMK software project is to develop a completely customizable, powerful, and enjoyable firmware experience for any project - keyboard or otherwise - and to provide helpful, encouraging, and kind support and feedback for people with any software development experience. View on GitHub This project is maintained by QMK collaborators and contributors like you!

https://qmk.fm/