The ZMK documentation covers both basic and advanced functionality and has a table of OS compatibility for keycodes. Please note that the RGB Underglow, Backlight and Power Management sections are not relevant to the Advantage 360 Pro's custom ZMK fork. For more information see this note
I use nickcoutsos/keymap-editor to edit the keymap for this repo, as it is a much better and more built-out version than Kinesis's visual editor, and is much easier than editing raw zmk.
- Push a commit.
- Dispatch the Build action.
- Download the artifact.
Put either module in bootloader mode by pressing and holding the Top Right button on the right module to enter the programming layer, and then press the lowest button on the inner index column to enter bootloader mode.
Drag and drop the file into the drive that shows up to flash the firmware. In most cases you only need to flash the left side.
- Extract the firmwares from the archive downloaded from the GitHub build job (If using the cloud builder) or the firmware folder (If building locally).
- Connect the left side keyboard to USB.
- Press to put the left side into bootloader mode; it should attach to your computer as a USB drive.
- Copy
left.uf2
to the USB drive and it will disconnect. - Power off both keyboards (by unplugging them and making sure the switches are off).
- Turn on the left side keyboard with the switch.
- Connect the right side keyboard to USB to power it on.
- Press Mod+macro3 to put the right side into bootloader mode to attach it as a USB drive.
- Copy
right.uf2
to the mounted drive. - Unplug the right side keyboard and turn it back on.
- Enjoy!
Note: There are also physical reset buttons on both keyboards which can be used to enter and exit the bootloader mode. Their location is described in section 2.7 on page 9 in the User Manual and use is described in section 5.9 on page 14.
Note: Some operating systems wont always treat the drive as ejected after the settings-reset file is flashed or may throw a spurious error, this doesn't mean that the flashing process has failed.
If you encounter a git conflict when updating your repository to V3.0 please follow the instructions on how to resolve it here.
Updating from V2.0 based firmwares to V3.0 based firmwares can be a rather complex process. There are reset files for every major firmware revision as well as documentation on the update process available here.
Starting on 11/15/2023 the Advantage 360 Pro will now automatically record the compilation date, branch and Git commit hash in a macro that can be accessed with Mod+V. This will type out the following string: YYYYMMDD-XXXX-YYYYYY, where XXXX is the first 4 characters of the Git branch and YYYYYY is the Git commit hash. In addition to this the builds compiled by GitHub actions are now timestamped and also record the commit hash in the filename.
By default this keyboard has NKRO enabled, however for compatibility reasons the higher ranges are not enabled. If you want to use F13-F24 or the INTL1-9 keys with NKRO enabled you can change CONFIG_ZMK_HID_KEYBOARD_EXTENDED_REPORT=n
to CONFIG_ZMK_HID_KEYBOARD_EXTENDED_REPORT=y
in adv360_left_defconfig
By default reporting the battery level over BLE is disabled as this can cause some computers to spontaneously wake up repeatedly. If you'd like to enable this functionality change CONFIG_BT_BAS=n
to CONFIG_BT_BAS=y
in adv360_left_defconfig.
The color of the CAPS/NUM/SCROLL LOCK indicator LEDs may be configured by specifying a hexadecimal RGB color code. For example, CONFIG_ZMK_RGB_UNDERGLOW_MOD_COLOR=0xFF0000
would give red indicator colors. In order to set the indicator color on both modules, ensure that both adv360_left_defconfig and adv360_right_defconfig have been updated.
A total of 32 layers are supported by ZMK, with the highest currently active layer displayed using the layer LEDs on each of the left and right modules. All possible colors are listed below; for the first 8 layers the same color is displayed on both modules. After that, only the right module color will cycle through until "rolling over", which will cause the left module color to change as well (and this then repeats). To avoid confusion, the black/off LED color is only used for layer 0.
Layer # | L/R | Layer # | L/R | Layer # | L/R | Layer # | L/R |
---|---|---|---|---|---|---|---|
0 | 8 | 16 | 24 | ||||
1 | 9 | 17 | 25 | ||||
2 | 10 | 18 | 26 | ||||
3 | 11 | 19 | 27 | ||||
4 | 12 | 20 | 28 | ||||
5 | 13 | 21 | 29 | ||||
6 | 14 | 22 | 30 | ||||
7 | 15 | 23 | 31 |
The changelog for both the config repo and the underlying ZMK fork that the config repo builds against can be found here.
The Advantage 360 Pro is always getting updates and refinements. If you are willing to beta test you can follow this guide from ZMK on how to change where your config repo points to. The west.yml
file that is mentioned is located in config/. This link can take you to the file. Typically you will only need to change the revision:
to match the beta branch. There is currently no beta branch available for testing.
Feedback on beta branches should be submitted as a GitHub issue on the base ZMK repository as opposed to this config repository.
In the event of a major update the beta branch may not be compatible with the current mainline version of the config repository. If this is the case it will be detailed here along with instructions on how to update.
By default this config repository references a customised version of ZMK with Advantage 360 Pro specific functionality and changes over base ZMK. The Kinesis fork is regularly updated to bring the latest updates and changes from base ZMK however will not always be completely up to date, some features such as new keycodes will not be immediately available on the 360 Pro after they are implemented in base ZMK.
Whilst the Advantage 360 Pro is compatible with base ZMK (The pull request to merge it can be seen here if you want to see how to implement it) some of the more advanced features (the indicator RGB leds) will not work, and Kinesis cannot provide customer service for usage of base ZMK. Likewise the ZMK community cannot provide support for either the Kinesis keymap editor, nor any usage of the Kinesis custom fork.
Further support resources can be found on Kinesis.com:
- https://kinesis-ergo.com/support/kb360pro/#firmware-updates
- https://kinesis-ergo.com/support/kb360pro/#manuals
In the event of a hardware issue it may be necessary to open a support ticket directly with Kinesis as opposed to a GitHub issue in this repository.