Advantage360 Professional (ZMK Bluetooth)
Where are all the newest ZMK features?
Since we started building the Pro 360 firmware the ZMK team has made some exciting new advances in the core firmware. We have released a new “beta” version of firmware on GitHub that has the latest features from the Zephyr 3.0 update. Power-users can install this and send us feedback.
What kind of batteries does the keyboard use?
The Advantage360 Pro uses a custom, rechargeable lithium-ion battery. Just connect each module to your PC using the included charging cables and charge the batteries overnight. The batteries are not designed to be replaced regularly but after years of use their max charge (like all batteries) will wear down. Contact firstname.lastname@example.org to enquire about a replacement batteries.
How do I switch between Windows, Mac, and PC mode?
The Advantage360 Pro has done away with what were previously known as Thumb Key Modes as they made programming the keyboard inherently more complicated. You can still customize the thumb keys in each of the different layers to whichever modifiers suit your preferences.
How do I remap a key?
The Advantage360 Pro does not support onboard programming and is designed for power-users only. To customize the keyboard layout it is necessary to edit the keyboard configuration files on the GitHub platform or using the Keymap Editor GUI, and then flash the firmware. Please consult the User Manual for step-by-step directions.
If onboard programming is an important feature for you, please contact Kinesis to see about exchanging keyboards.
How do I create a macro?
The Advantage360 Pro does not support onboard programming and is designed for power-users only. To customize the keyboard layout it is necessary to edit the keyboard configuration files on the GitHub platform or using the Keymap Editor GUI, and then flash the firmware on each side of the keyboard. Please consult the User Manual for step-by-step directions.
If onboard programming is an important feature for you, please contact Kinesis to see about exchanging keyboards.
How do I update my keyboard after making changes on GitHub?
Each time you update your keymap with new remaps or macros or use the GUI , you will need to download a new set of left and right firmware files from GitHub and flash them to the corresponding keyboard module. Please consult the User Manual for step-by-step directions.
How should I clean my keyboard?
Basic cleaning should be performed regularly by using compressed air to remove any loose debris in the key wells.
A more thorough cleaning is possible, but take care not to damage the keyboard by getting it wet or forcing off the keycaps. Unplug the keyboard and remove all the individual keycaps to gain access to the keywell, which can collect lots of dirt after time. Use the included keycap removal tool and grab two sides of the keycap and pull straight up. If you do not have a keycap removal tool you can purchase one on Amazon or use two paperclips bent into the shape of a “J”.
- Soak the loose keycaps in warm soapy water lightly scrub to remove any gunk. Rinse the keycaps and let them thoroughly dry.
- Use compressed air to remove any loose debris in the key wells and use cotton swabs with rubbing alcohol to remove gunk.
- Use a microfiber cloth and a small amout rubbing alcohol to clean the outer plastic keyboard case.
Do not reconnect the keyboard to your PC until it is thoroughly dry.
Where are the media keys?
There are no multimedia keys in the default Advantage 360 layout but you can add any number of media actions to any key in any layer via GitHub. Please consult the User Manual for step-by-step directions.
View the full list of supported actions here: https://zmk.dev/docs/codes/
Tip: Use the consumer media tokens that start with “C_” instead of the keyboard tokens that start with “K_”. Note that not all actions are supported on all operating systems.
How often do I need to charge the battery?
Battery usage will vary from user-to-user and will depend greatly on your settings. To extend your battery life try dimming the backlighting using the command Mod + Down Arrow, or turn off the backlighting completely using the command Mod + Enter. The battery is only rated for a given number of charge cycles so we recommend charging the battery only when necessary to maximize its life span.
To check the current battery charge level, use the command Mod + Hotkey 4 and the indicator LEDs will display the status of each battery (Note: It is normal for the left side to need more frequent recharging)
- Green: More than 80%
- Yellow: 51-79%
- Orange: 21-50%
- Red: Less than 20% (Charge soon)
Note: Windows 11 battery level functionality is not currently supported.
We recommend replacing your battery every three years for maximum safety and performance. Please read section 8.5 of the User Manual above for detailed information on battery specs, safety, performance.
If your Advantage360 Professional is not working as expected, you have several options.
Step 1: Reference the FAQs above and the Troubleshooting Tips at right.
Step 2: Install the new Beta v2.0 Firmware.
Step 3: Check out the ZMK Discord and talk to some power users.
Step 4: If you still need help, use the link at the bottom of the page to submit a Trouble Ticket.
Please note: The Advantage360 keyboard uses the open-source ZMK engine and is not designed for novice users. Kinesis Technical Support can help point you in the right direction and provide written documentation, but we cannot provide individualized ZMK training and programming help.
Unfortunately Kinesis is not able to troubleshoot custom firmware builds, but here are some common problems we’ve heard about:
- You have an incomplete key binding
- You have an empty macro
- You have a feature that is not supported in the Kinesis branch of ZMK (Try upgrading to the newer version “Beta v2.0”)
Tip: The best bet to troubleshoot a failed build is to revert all the way back to the default layout, and then add each change incrementally and run a build to identify exactly where the failure is occurring.
Check the new Layer LEDs to see if you have inadvertently toggled into the Keypad Layer. If the Layer LED is off then you are in the Base Layer, if its white then you are in the Keypad Layer, if its Blue then you are in the new Fn Layer (where the F1-F12 keys reside). If the Layer LED is white then tap the Kp key once to toggle out the Keypad Layer. If the Layer LED is Blue you are temporarily “stuck” in the Fn layer. Press both of the new Fn “pinky” keys simultaneously to toggle back to the Base Layer.
- Connect both module to a PC via the included cables to see if you simply have a dead battery or a more serious problem. If the keyboard works over USB than you may just need to charge the battery (each module has its own rechargeable battery…).
- If the batteries are charged and the keyboard is still having problems you can use a paper clip to to depress the Reset Button once to reset each module.
- If that doesn’t work you can try re-installing a new copy of firmware on each module, either the production version 1.0 or the new beta version 2.0.
If that doesn’t work, install the generic settings-reset.uf2 file from your GitHub repo. The keyboard will be disabled in this mode but you can reopen the bootloader and trying installing your firmware again from a blank slate.
The keyboard will always send keystrokes to whichever device the left module is plugged into, regardless of profile or pairing status. If you want to send key strokes to a device wirelessly, it must not be connected to any other device via the charging cable.
If your computer doesn’t have native support for Bluetooth Low Energy (BLE) devices you have several options:
- Connect the Left Module to your PC using the included charging cable and use the Pro exclusively as a “wired” keyboard. You will still need to plug in the right module to your PC periodically to charge the battery, but otherwise you will have full functionality.
- Purchase a 3rd party Bluetooth dongle that can connect to your PC. Finding a dongle that will work well with your PC and our keyboard can be tricky but we recommended the TP Link UB4A (Available from Amazon).
- Return the Pro and get the base model Advantage360 which is optimized for a wired USB connection.
When all three of the right module LEDs are flashing Red is means the right module cannot locate the left module. That could be because the Left module is Off, has a dead battery, or is out of range.
But sometimes the left and right side can just temporarily lose touch with each other. If this happens, the quickest fix is to disconnect both modules from your PC and use the On/Off switch power cycle both modules, starting with the Left module. If that does not work, you can force the modules to sync by powering them up simultaneously via the On/Off switches.
In some instances, like after performing a Settings Reset, it may be necessary to manually re-sync the modules and there are two ways to do that.
- Use a paper clip to tap both the left and right reset button in rapid succession (i.e., nearly simultaneously)
- Connect both modules to power: left first, then right
When the Profile LED flashes slowly it means that the keyboard has stored a bluetooth PC for the active Profile, but that particular PC is not in range. Check that PC and confirm that it is powered on and bluetooth is enabled. If that doesn’t work, you should remove the keyboard from the device in it’s bluetooth menu and then use the bluetooth clear command on the keyboard (Mod + Windows) and try re-pairing from scratch.
If you are trying to pair a new device, use the shortcuts Mod + 1/2/3/4/5 to load one of the other 5 “Profiles”. Each Profile can only be paired with a single device at a time.
When the Profile LED is flashing rapidly it means the keyboard has not been paired over bluetooth in the active Profile (1-5), but is currently “discoverable”. Toggle to a different Profile (Mod + 1-5) to re-establish the connection with another device or simply pair the keyboard from your bluetooth enabled device.
If you are having difficulty connecting or reconnecting to a previous paired device, please follow these steps:
- Use the Bluetooth Clear command (Mod + Windows Key) to forget any previously paired devices associated with the active Profile
- Visit your PC’s Bluetooth menu and forget/remove any previous connections to the “Adv360Pro”
Once you’ve cleared the connection both at the keyboard and PC level, try pairing again from scratch.
First, make sure you have the desired module connected to the PC as the drive cannot mount wirelessly. There are 2 ways to mount the drive:
- Quickly double-clicking the Reset Button using a paper click.
- Using the short-cuts Mod + HK1 and Mod + HK3 for the left and right module respectively.
Note: Some operating systems are very restrictive when it comes to removable storage drives (e.g., macOS) so check your PC settings to support pasting files to such a drive.
Not all operating systems support sending this status over Bluetooth, sorry!
Create a GitHub Repository: To get started programming your Advantage360 Pro you’ll need to set up an account with GitHub, a 3rd party open-source hosting site.
- Set up a GitHub account here: https://github.com/signup
- Find the Adv360 Repository and “Fork” it: https://github.com/KinesisCorporation/Adv360-Pro-ZMK
- Then enable “Workflows” from the “Actions” tab
- Choose the “v2.0 beta” branch for all he latest features.
- From there you can edit the “adv360.keymap” or the “macros.dtsi” files (Code>config).
- Once you are finished, click “Commit Changes”, download the new firmware files, and flash them to your keyboard.
Consult the User Manual above for step-by-step instructions and proceed with caution.
To update the firmware on the Advantage360 Pro, download the appropriate left and right side files from GitHub (there may be multiple branches to choose from) and follow the steps in the guide below to update the left module, and then the right module. Consult the User Manual above for additional details and proceed with caution.
If you are having trouble with your keyboard or want to perform a “major” update, we recommend first performing a “Settings Reset” to return the keyboard to its native state.
- Visit the Adv360-Pro-ZMK Repo and download the “settings-reset.uf2” file from the “Code” tab
- Follow the instructions in the guide at left but install the settings-reset.uf2 on BOTH the left and right “ADV360PRO” drives.*
- Install the left side first, then the right side. The power on both modules at once to re-sync them.
- Once the modules have been resynced, connect each module via USB and follow the instructions at left to install the desired firmware files on both modules.
*Note: The keyboard will be disabled once reset until new firmware is installed.