ZMK 固件可用的动作、按键说明:
ZMK 固件中可以使用哪些按键
ZMK 固件可以使用哪些动作
- 字母层:
字母
- 符号层:
数字
、符号
- 媒体层:
方向键
、屏幕亮度
、音量上下
、静音
、上一曲
|暂停
|下一曲
、PageUp
、PageDown
、Home
、End
、前进
、后退
- 功能层:
蓝牙设备切换
、触控板开关
、BootLoader
固件升级
、键盘灯控制
、输出途径切换(蓝牙、USB)
、键盘重启
- 字母层:
- 符号层:
alt
点击:临时进入符号层
,2 秒内点击任意符号,上屏对应符号并立即退出符号层
,<四个键盘灯长亮>
alt
长按:进入符号层
,<四个键盘灯长亮>
- 媒体层:
- 右侧
aA↑
点击:切换媒体层
、字母层
<四个键盘灯呼吸>
- 功能层:
$
键点击:输入 $$
键长按:进入功能层
,<四个键盘灯闪烁>
![Screenshot 2024-03-28 at 10 51 28](https://private-user-images.githubusercontent.com/12215982/317576650-d6bf4867-6593-4022-9983-c264dc2d1786.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjEyNDY2OTEsIm5iZiI6MTcyMTI0NjM5MSwicGF0aCI6Ii8xMjIxNTk4Mi8zMTc1NzY2NTAtZDZiZjQ4NjctNjU5My00MDIyLTk5ODMtYzI2NGRjMmQxNzg2LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA3MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNzE3VDE5NTk1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTBiNWZjYjQ1ZjJhY2UyMjBjOGE2NDRlYWJlZmY0NDk5YjYzNWIyMWNmMjc0ZWYzOTczZDJkYzAzNTRjNGU2NmEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.ffGLWOTkpIRQY4Umi50Hxqyfd0syr6molDN7ywDB3n4)
你可以自己 clone 仓库到本地,或者直接在线上修改。
打开 Fork 后的仓库,找到 .keymap
文件,编辑它
对应可用的键位和操作可以查看下面的文档:
![Screenshot 2024-03-28 at 10 52 08](https://private-user-images.githubusercontent.com/12215982/317576889-a5a3aef6-52d0-4281-b716-2d44873e6868.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjEyNDY2OTEsIm5iZiI6MTcyMTI0NjM5MSwicGF0aCI6Ii8xMjIxNTk4Mi8zMTc1NzY4ODktYTVhM2FlZjYtNTJkMC00MjgxLWI3MTYtMmQ0NDg3M2U2ODY4LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA3MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNzE3VDE5NTk1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTZjYWYzNjVhZThhNGRhZGZkMDE3ZTQ2NjM1YjZiMTE5NzVmNzljNjRhMTI1OWYzZDljZjc3ZDMxODNmNmU1ZjMmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.wjJdrqnKv3Wn4l6g5Hu4RhXQA5We5iAiFdtV7zVdZ08)
编辑完成之后,点击右上角的 Commit 按钮提交你的修改。
![Screenshot 2024-03-28 at 10 52 44](https://private-user-images.githubusercontent.com/12215982/317577293-28eff4c3-fc2c-4858-9417-8cbc34ba6277.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjEyNDY2OTEsIm5iZiI6MTcyMTI0NjM5MSwicGF0aCI6Ii8xMjIxNTk4Mi8zMTc1NzcyOTMtMjhlZmY0YzMtZmMyYy00ODU4LTk0MTctOGNiYzM0YmE2Mjc3LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA3MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNzE3VDE5NTk1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTQ3OGMwNTEzMTkzZDc0ZDE0MzdjODMzOWYyNWViNTJjNjE3N2FjODJiYTMwNjU1MTNhMDJiOWQ5MDFlYzM1ODUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.D08wfENcxyCObZooxeBlZY6vbk-Pvvm7NfvKONm5cZ4)
修改完成并提交之后,github 会自动将最新的仓库内容编译出最新的键盘固件。
点击 Actions
标签进入 Actions 页面。首次可能没有自动运行,需要手动执行。
之后就不用手动操作了,会自动运行。
![Screenshot 2024-03-28 at 08 49 51](https://private-user-images.githubusercontent.com/12215982/317577748-f48e8221-451d-4b6c-9906-cc6add94d363.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjEyNDY2OTEsIm5iZiI6MTcyMTI0NjM5MSwicGF0aCI6Ii8xMjIxNTk4Mi8zMTc1Nzc3NDgtZjQ4ZTgyMjEtNDUxZC00YjZjLTk5MDYtY2M2YWRkOTRkMzYzLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA3MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNzE3VDE5NTk1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWNhZmFmNWFkZGZlODFhZTU5YzNmODg3YWU1ZGQ4YWY1Zjg0MmYyZjBjMjZmOTJkZjc3ZmI3MzRmMDE2MTE2MzImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.7Z7X4hXkXzx5eDakbrx5yppQuOZ_hbj7oKqcH9kG_ig)
点击运行之后,在列表中会多出一个正在执行的任务。
![Screenshot 2024-03-28 at 08 50 06](https://private-user-images.githubusercontent.com/12215982/317577917-b45a4a51-b83c-4ca8-90a9-e216a4c18ce2.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjEyNDY2OTEsIm5iZiI6MTcyMTI0NjM5MSwicGF0aCI6Ii8xMjIxNTk4Mi8zMTc1Nzc5MTctYjQ1YTRhNTEtYjgzYy00Y2E4LTkwYTktZTIxNmE0YzE4Y2UyLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA3MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNzE3VDE5NTk1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWMyOTk2YWI1OTIwZGQ5ZjFjYTg4ZDYyZjQzZDkxMjQzOGEyYjVmMDhmMDIyZDllNGNkNjJjOTI1NzY3NTc2ODQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.GYUTpYH8rLNSqMhH-zlJTS3iNlYfNjJjSjoKoL4mDME)
点开它,能看到它的具体进度
![Screenshot 2024-03-28 at 08 50 17](https://private-user-images.githubusercontent.com/12215982/317577931-e2cfd5f2-5dbd-42ef-8a66-3c51f5301612.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjEyNDY2OTEsIm5iZiI6MTcyMTI0NjM5MSwicGF0aCI6Ii8xMjIxNTk4Mi8zMTc1Nzc5MzEtZTJjZmQ1ZjItNWRiZC00MmVmLThhNjYtM2M1MWY1MzAxNjEyLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA3MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNzE3VDE5NTk1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTNkYTRjNmMzOTQxYzAwODUyZTEyNDE0ZmFiZjkxMmFiZTJjMWY1YjFlNWQzNjBmZWU2ZTg3N2U5ODc3N2VkYzUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.SNj6bMoOAHIRwkVSRO6x66W0fC-4hq9kDlyZJ_XMw3E)
完成之后会在最下多出一个名为 firmware 的文件,点击下载它,会下载下来一个名为 firmware.zip
的文件
![Screenshot 2024-03-28 at 09 15 15](https://private-user-images.githubusercontent.com/12215982/317578273-40f59100-c644-43d2-a07c-dd83aa2b2cc8.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjEyNDY2OTEsIm5iZiI6MTcyMTI0NjM5MSwicGF0aCI6Ii8xMjIxNTk4Mi8zMTc1NzgyNzMtNDBmNTkxMDAtYzY0NC00M2QyLWEwN2MtZGQ4M2FhMmIyY2M4LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA3MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNzE3VDE5NTk1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTBmODM3NTcxNmUwYTAxOTRiMTJjZjFhNGUyMGVjMmE0MGMxMGM4ZDU4NzY4MDhjYzhiYmM2OWFiZmU1MmFiZjgmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.4dJXY6S8SxU0QSVXEm0E-zmdvk4nxOljzdn5d-_82ZU)
解压下载好的 firmware.zip
文件,解压后会获得 bbxxxx-zmk.uf2
的文件,这个文件就是键盘固件
![Screenshot 2024-03-28 at 08 58 32](https://private-user-images.githubusercontent.com/12215982/317581071-de14cce4-3e72-4aba-81ab-8849898cff7a.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjEyNDY2OTEsIm5iZiI6MTcyMTI0NjM5MSwicGF0aCI6Ii8xMjIxNTk4Mi8zMTc1ODEwNzEtZGUxNGNjZTQtM2U3Mi00YWJhLTgxYWItODg0OTg5OGNmZjdhLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA3MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNzE3VDE5NTk1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTc3YjMzNzFmMzExMWY2YWQ4YzZmZmY5ZDBkNDk1MjE3YTE0MTg3YzI1NjM0MjUzOTNjZWRjNTVjNzY3MzQyNWEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.dp8nr4-LYlVYC3kANRyVh2zbUxLOo_g-vL8wiZVkV1g)
USB 连接键盘,进入固件更新模式(具体操作参见键盘说明书)。
此时电脑上会多出一个名为 NICENANO
的外接硬盘。
将固件拖动到这个盘里,当电脑提示硬盘已弹出
或者硬盘非正常弹出
,表示升级完成。
macOS 上的提示是这样的,不要慌张,这是正常的。
![Screenshot 2024-03-28 at 09 15 45](https://private-user-images.githubusercontent.com/12215982/317579895-37cb6907-a432-4e6b-a744-c993dfa6dd92.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjEyNDY2OTEsIm5iZiI6MTcyMTI0NjM5MSwicGF0aCI6Ii8xMjIxNTk4Mi8zMTc1Nzk4OTUtMzdjYjY5MDctYTQzMi00ZTZiLWE3NDQtYzk5M2RmYTZkZDkyLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA3MTclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwNzE3VDE5NTk1MVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWQzY2ZmOTM4MWZiZmJjZGQwMWIzMTA5MGZiZmJhZWRkZjRmNTU3NTc4YTUwOTk4YmE1MWU3OTY2OTczNTk4OTUmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.bZJlvGoUT3UuCOciZCL-2HD6SZ63_ZbisSnDGvPECW0)