¶ 1. 功能特性
- 支持VIA网页改键，可设置为普通键，多媒体和系统控制键，鼠标键，Surface Dial键。
- 双层按键切换，可通过VIA设置任意键切层或按住任意键切层。
- 按键复用功能，任意键可设置为复用键，最多5个复用键，每个复用键可通过VIA设置单击、双击、按住三种操作。
- VIA网页可录制宏，发送字符串，可设置宏循环次数1-254，最大值时255时为无限循环，再次按宏停止。
- VIA网页里宏设置可输入KC_F13-KC_F21键代替鼠标键，能设置鼠标宏，做鼠标连点器，游戏宏等。
键值对应：KC_F13->鼠标左键，KC_F14->鼠标右键，KC_F15->鼠标中键，KC_F16-KC_F19—>鼠标指针上下左右，KC_F20->鼠标滚轮上滚，KC_F21->鼠标滚轮下滚。 - 适配WS2812 RGB，VIA网页里可设置RGB颜色，支持SignalRGB神光同步，支持多种灯效，音乐律动。
¶ 2. 型号功能列表
| 型号 | 硬件 | 可设按键类型 | 按键拓展 | RGB灯效 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 型号 | 型号简介 | 按键 | 旋钮 | RGB | 多媒体和系统键 | 键盘 | 鼠标 | Surface Dial | 双层键 | 复用键 | 宏(Bytes) | SingalRGB | 离线灯效 | 按键调灯效 |
| NKnob | USB单旋钮 | 1 | 1 | 2x2 | 支持 | 支持 | 支持 | 支持 | 不支持 | 1 | 104 | 支持 | 1 | 不支持 |
| NKey | USB单按键 | 1 | 0 | 1 | 支持 | 支持 | 支持 | 支持 | 不支持 | 1 | 99 | 支持 | 1 | 支持 |
| NRGB | USB灯条 | 1 | 0 | 15x1 | 支持 | 支持 | 支持 | 不支持 | 不支持 | 1 | 104 | 支持 | 6 | 支持 |
¶ 3. 配置文件下载
注意：点击链接会直接打开网页，需要右键链接选择"链接另存为..."，即可保存为文件
| 型号 | 型号说明 | 烧录升级用固件 | 固件更新时间 | VIA网页改键导入文件 | VIA预设配置 | SignalRGB支持插件 |
|---|---|---|---|---|---|---|
| NKnob | USB单旋钮 | NKnob_V101.zip | 20240103 | NKnob_via.json | VIA_Layout | NKnob_signalrgb.js |
| NKey | USB单按键 | NKey_V101.zip | 20240103 | NKey_via.json | 无 | NKey_signalrgb.js |
| NRGB | USB灯条 | NRGB_V101.zip | 20240103 | NRGB_via.json | 无 | NRGB_signalrgb.js |
¶ 4. VIA网页改键说明
¶ 1. 导入json配置文件
- 初次使用需导入json配置文件，在上面的配置文件下载列表中下载你设备对应的***_via.json文件
- 把设备插入USB口，然后右键点击这里在新标签页打开VIA改键网页
- 打开网页后选项栏点击齿轮设置图标，再打开Show Design tab来开启导入json文件功能
- 点击选项栏刷子图标，然后点击load导入步骤1中下载的***_via.json文件
- 点击选项栏键盘图标，再点击Authorize device添加键盘，在弹出的列表里选择设备连接
- 连接后会在上半部分显示设备实际按键布局和键值，下半部分显示能设置的按键和功能选项
¶ 2. 设置键盘键、多媒体和系统键、鼠标键、Surface Dial键、宏键、复用键等
- 先选择上面键盘里要改的按键，然后再选下面要设置成的按键，可以选键盘键、多媒体和系统键、鼠标键、Surface Dial功能键等，部分特殊功能键不支持。
- 有些按键设置不能直接选择按键，需要输入按键代码。比如设置旋钮、复用键等
- 按键代码获取：将鼠标移动到想设置的按键上，即可在左下角看到对应按键的代码，比如音量加(Vol+)对应的键码如图可知为KC_VOLU
- 左边选项列表为键值类型列表，点击切换按键类型即可选择不同类型按键。
- 有时候需要配置类似于ctrl+c的组合键，可使用SPECIAL最下面的Any键输入组合键键码，比如ctrl+c则输入LCTL(KC_C)
- 下图为组合键键码，可多级嵌套，比如LCTL(LALT(KC_C))即为ctrl+alt+c组合键
¶ 3. 宏功能
- 可设置M0-M4共5个宏，先将任意键设为M0-M4的宏按键，按图示选择或输入键码MACRO(0)-MACRO(4)：
- 在宏功能设置栏中录制或手动编辑宏对应的具体功能，宏有字符串输入和操作步骤录制播放功能。操作步骤如图：
- 鼠标宏不能录制，可使用输入宏方式输入KC_F13-KC_F21键代替鼠标键
KC_F13->鼠标左键，KC_F14->鼠标右键，KC_F15->鼠标中键，
KC_F16-KC_F19—>鼠标指针上下左右，KC_F20->鼠标滚轮上滚，KC_F21->鼠标滚轮下滚
- 如保存不了就是内存不足，要减掉几个步骤才能保存，或者开启自动省略步骤功能减少内存占用，1个字符占一个字节，一个操作4字节。
- 可设置宏循环次数1-254，最大值时255时为无限循环，再次按宏停止
¶ 4. 保存和导入按键配置
- 可保存已设置好的按键配置，更改按键配置的时候直接导入即可快速设置，可分享你的称手配置。
- 部分设备有预设的配置，可在配置文件下载列表中下载，解压后即可通过导入按键配置功能直接设置。
- 比如单旋钮NKnob有以下预设配置可直接导入
¶ 5. RGB灯效调节
- 通过VIA可设置设备的RGB离线灯效，带旋钮的设备只支持设置灯的RGB颜色
- 不带旋钮的设备大部分支持6种离线灯效，可切换不同灯效，设置灯效的
- 部分支持多种灯效的设备支持将任意键设为灯效调节键
¶ 6. 复用键
- 复用键支持一个按键设置多个功能，先将按键设为复用键，按图示选择或输入键码CUSTOM(7)-MACRO(11)，不同设备支持的复用键个数不同：
- 在复用键设置栏中设置复用键的单击，双击，长按对应的不同键值，需要输入键码，键码获取方式在按键设置章节
- 按键的判定是200ms为判定间隔，按一下200ms内没按键为单击，200ms内再按一下为双击，按住到200ms没松手为按住，所以有一点延迟。旋钮因为操控性原因左旋右旋设为复用键会不好掌控，按下设为复用键没问题。
¶ 7. 系统设置
- 恢复出厂设置可清除设置的按键配置回到出厂状态
- 升级选项可使设备进入升级模式让设备被升级工具识别到，能更新固件
¶ 8. 固件升级
- 固件升级主要是解决bug和添加功能特性，根据固件版本号和更新日期判断是否需要升级，非必要不升级。在配置文件下载中下载最新固件并解压得到 xxx_Vxxx.hex 文件
- 下载固件升级烧录工具，点击这里下载烧录工具，按如图1-8步骤设置
- 在VIA中使设备进入升级模式，烧录工具识别到后会自动下载即可升级成功
¶ 5. SignalRGB神光同步
- 在SignalRGB官网下载并安装SignalRGB软件，点击打开SignalRGB官网
- 下载离线灯效安装包点击下载，解压后点击包里的一键安装附加包，安装离线灯效。
- 在上面的配置文件下载列表中下载你设备对应的signalrgb.js文件
- 将下载的***_signalrgb.js文件添加到SignalRGB的插件文件夹下，如：C:\Documents\WhirlwindFX\Plugins，然后重启SignalRGB软件来载入插件支持设备。
- SignalRGB里可开启或关闭设备的神光同步功能，关闭后设备使用via设置的灯效。开启后可选择SignalRGB灯效。
