Building Firmware; Zmk Token List; Crea Ng Macros Via Direct Programming - Kinesis Advantage360 KB360-PRO-GBR User Manual

6.3 Building Firmware

Anytime you "Commit Changes" you can navigate to the Actions tab in your Adv360 Repo where you will see
a new workflow entitled "Updated Keymap". GitHub will automatically build a new set of left and right
keyboard firmware files with your custom layout. The yellow dot indicates the build is in progress. Each build
will take several minutes so be patient.
Once the build is complete, the yellow dot will turn green. Click the "Updated keymap" link to load the build
page and then click "firmware" to download both the left and right firmware files to your PC. Then follow the
firmware update instructions in the next chapter to "flash" the firmware onto the keyboard.

6.4 ZMK Token List

ZMK supports a wide array of keyboard actions (letters, numbers, symbols, media, mouse actions). Visit the
link below for a handy list of tokens to reference when programming your keyboard. Note: Not all tokens may
be supported in your version of ZMK as ZMK is constantly evolving and improving.
ZMK Tokens: https://zmk.dev/docs/codes/
6.5 Creating Macros via Direct Programming
The ZMK engine does not support recording macros on-the-fly like earlier versions of the Advantage. Macros
can be created by direct programming the macros.dtsi file on GitHub (or via the GUI as described in Section
6.2). Open the "Code" tab on GitHub, then open the
"config" folder, and then the macros.dtsi file. Click the
pencil icon to edit the file. There are several example
macros stored in this file already and we recommend
editing one of those macros. First change the name to
something short and memorable in all 3 locations.
Then input the desired sequence of keys on the
bindings line using the tokens linked above. Then click
the "Commit changes" button.
Example macros.dtsi Syntax
macro_name: macro_name {
compatible = "zmk,behavior-macro";
label = "macro_name";
#binding-cells = <0>;
bindings = <&kp E>, <&kp X>, <&kp A>, <&kp M>, <&kp P>, <&kp L>, <&kp E>;
};
Once you've written your macro to the macros.dtsi file, navigate back to the "config" folder and open the
"adv360.keymap" file. Click the pencil icon to edit this file and then assign your macro to the desired key
position in the desired layer using the syntax "&macro_name". Click "Commit changes" and now navigate to
the Actions tab and follow the instructions (See Section 7.1) to download and install your new firmware file
with the updated keymap.
17