66 lines
2.1 KiB
Markdown
66 lines
2.1 KiB
Markdown
# ADV360-PRO-ZMK
|
|
|
|
## Modifying the keymap
|
|
|
|
There is a GUI for editing the keymap. It is available at https://kinesiscorporation.github.io/Adv360-Pro-GUI
|
|
|
|
## Building the Firmware with GitHub Actions
|
|
|
|
### Setup
|
|
|
|
1. Fork this repo.
|
|
2. Enable GitHub Actions on your fork.
|
|
|
|
### Build firmware
|
|
|
|
1. Push a commit to trigger the build.
|
|
2. Download the artifact.
|
|
|
|
## Building the Firmware in a local container
|
|
|
|
### Setup
|
|
|
|
#### Software
|
|
|
|
* Either Podman or Docker is required, Podman is preferred if both are present.
|
|
* Make is also required
|
|
|
|
#### Windows specific
|
|
|
|
* If compiling on Windows use WSL2 and Docker [Docker Setup Guide](https://docs.docker.com/desktop/windows/wsl/).
|
|
* Install make using `sudo apt-get install make`.
|
|
* The repository can be cloned directly into the WSL2 instance or accessed through the C: mount point WSL provides by default (`/mnt/c/path-to-repo`).
|
|
|
|
### Build firmware
|
|
|
|
1. Execute `make`.
|
|
2. Check the `firmware` directory for the latest firmware build.
|
|
|
|
### Cleanup
|
|
|
|
The built docker container and compiled firmware files can be deleted with `make clean`.
|
|
|
|
## Flashing firmware
|
|
|
|
Follow the programming instruction on page 8 of the [Quick Start Guide](https://kinesis-ergo.com/wp-content/uploads/Advantage360-Professional-QSG-v8-25-22.pdf) to flash the firmware.
|
|
|
|
### briefly
|
|
|
|
1. Extract the firmwares from the downloaded archive.
|
|
1. Connect the keyboards via USB.
|
|
1. Mod+macro1 to put the left side into bootloader mode; it should attach to your computer as a USB drive. (There's also a physical button between the Delete/Home/End keys.)
|
|
1. Copy `left.uf2` to the USB drive and it will disconnect.
|
|
1. Power off both keyboards (by unplugging them and making sure the switch is off).
|
|
1. Restart the left then the right keyboard.
|
|
1. Mod+macro3 to put the right side into bootloader mode. (There's also a physical button between the Enter/PgUp/PgDn keys.)
|
|
1. Copy `right.uf2` to the mounted drive.
|
|
1. Keyboard may need to be power cycled again.
|
|
1. Enjoy!
|
|
|
|
## Other support
|
|
|
|
Further support resources can be found on Kinesis.com:
|
|
|
|
* https://kinesis-ergo.com/support/kb360pro/#firmware-updates
|
|
* https://kinesis-ergo.com/support/kb360pro/#manuals
|