ZMK改键使用介绍草稿
介绍 
ZMK 固件是基于 Zephyr™ Project 实时操作系统 (RTOS) 构建的开源 (MIT) 键盘固件。ZMK 的目标是提供现代、无线且功能强大的固件,没有许可问题。 
常用仓库列表 
①corne v3(RGB、 OLEDs、 Nice Nano V2):https://github.com/wellkb/crkbd_zmk_nicenanoV2 
②sofle rgb(RGB、 OLEDs、 Nice Nano V2):https://github.com/wellkb/Sofle_RGB_ZMK_NiceNanoV2
新建仓库 
浏览器登录GitHubhttps://github.com/,如果没有账号,需要先新建账号。 
浏览器访问仓库地址(参考上文常用仓库列表),点击“Fork”按钮,参考下图。 
可以修改仓库名、仓库描述,如果不修改,可以直接点击“Create fork”。 
改键 
登录keymap-editor 
点击下图GitHub。 
点击“login with GitHub”。 
点击“Authorize Keymap Editor”。 
点击“Add Repository”。 
点击选择键盘仓库,可以多选,再点击最下方的“install”按钮。然后会进入一个界面,输入GitHub登录密码。 
网页会展示该键盘仓库的按键布局。 
参考 
建议同时参考ZMK的键值手册以获取完整的键值列表和详细说明。https://zmk.dev/docs 
ZMK的键值手册是用户定制和配置键盘时的重要参考资料,它详细列出了所有可用的键值及其对应的功能。 
在使用ZMK键盘固件时,用户可以通过直观的界面来定制和配置每个按键的功能。每个按键的可点击区域被巧妙地分为两部分。 
按键左上方区域绑定行为: 按键左上方区域用于绑定特定的行为,如&kp(代表某个特定功能)、&lt(用于设置长按切层和短按触发)等。选择这些行为后,按键中间区域将展示与之相关的配置选项。 
按键中间区域设置键值: 当按键左上方区域选择为&kp时,按键中间区域初始显示为禁止符号,代表尚未选择键值。点击该区域后,用户可以从ZMK支持的常规按键中选择一个进行绑定。 
点击按键,可以对行为和键值进行设置。 
灰色按钮组合触发: 界面上的灰色按钮允许用户设置组合键值。例如,如果用户选择了A键,并随后选择了LCTRL,则该按键在触发时将同时发送CTRL+A的组合键。 
< 长按切层与短按触发: 当按键左上方区域选择为&lt时,按键中间区域会呈现两个配置选项。第一个为层数值,用于设置长按时切换到的键盘层;第二个为单击键值,即短按时触发的按键。例如,用户可以设置长按进入第1层,而短按则触发A键。 
自定义组合键: 通过点击“Add New Combo”,用户可以轻松添加新的组合键。在右侧选择需要同时按压的键,然后在左侧设置触发该组合键时的按键行为。请注意,每个组合键的名称必须唯一,以避免编译错误。 
宏编辑: ZMK还支持宏功能的配置。点击“Add New Macro”后,用户将进入宏编辑界面。首先输入宏的名称(如&phone),该名称将成为键值绑定时使用的标识。然后,在绑定选项中,用户可以选择各种宏行为,如本例中展示的绑定字符串以输出手机号。由于宏功能较为复杂,部分高级功能可能需要用户自行探索或在社区内交流学习。 
通过ZMK的灵活配置和强大功能,用户可以打造出完全符合个人需求的独特键盘体验。 
编译 
点击“save”按钮。 
点击“commit”。 
出现转圈,等待编译,大概几分钟左右。 
转圈结束后,点击下载图标 
下载firmware。解压下载文件,一般有三个文件,一个重置固件,一个左手固件,一个右手固件。 
键盘固件烧录与配置 
烧录固件 
1. 将键盘通过数据线连接到电脑。 
1. 双击键盘上的复位按键,电脑会识别出连接的U盘。 
1. 将对应命名的固件(如left或right)复制到U盘中,完成固件烧录。 
1. 对于普通键盘,主手通常为左手键盘;对于轨迹球键盘,主手为右手键盘。 
重置与配对 
1. 如果左右键盘配对不上,首先分别烧录reset文件。 
1. 接着烧录对应主手和副手的固件。 
1. 配对成功后,后续修改配置只需烧录主手固件并复位。 
副手无响应,尝试左右手同时复位,或仅副手点击复位。 
键盘使用与功能 
连接模式: 
• 主手键盘支持蓝牙和有线(Type-C)连接。 
• 有线模式下,副手键盘无需连线。 
• 切换有线和蓝牙模式可通过特定按键(如&out OUT_USB和&out OUT_BLE)或电源开关实现。 
蓝牙配置: 
• 主手Type-C线连接电脑时,可通过显示的键盘名搜索并连接蓝牙。 
• 长按换层键进入蓝牙层,清除蓝牙配置时,需先选择设备(如BT0),再点击清除键位(如CTR)。 
OLED屏幕与节能: 
• 键盘配备的OLED屏幕比较耗电。 
• 可以通过&ext_power EP_OFF命令关闭屏幕,打开时需复位或开关电源。 
充电与续航: 
• 副手键盘通常比主手续航更长。 
• 充电电流不应超过2A。 
固件更新: 
• 如果发现改键失败或其他异常,建议访问ZMK官网并更新仓库以获取最新固件。 
2024-05-07
浏览730
📕教程文档
登录后评论
评论
7