Firmware Customization

Customizing the Technikable keymap/firmware.

Overview

Although ZMK does not yet have GUI keymap update software, updating the keymap can be done without installing any local build tools or toolchain. This step will walk you through setting up your personal keymap/configuration.

Prerequisites

An understanding of the high level ZMK keymaps is helpful in preparing to customize your Technikable keymap.

To have your new Technikable firmware built automatically for you, you will need to create a GitHub account to manage your personal repo.

ZMK Config Repo

After logging into your GitHub account, you'll need to fork the correct repository for the bottom row layout you've assembled:

• Full ortho bottom row: https://github.com/petejohanson/technikable-ortho-config
• MIT/single 2u: https://github.com/petejohanson/technikable-mit-config
• Dual 2u: https://github.com/petejohanson/technikable-dual-2u-config

Once you open the correct link, in the top right corner, click the button labeled "Fork":

Once the fork is prepared, you should be presented with a list of files in your repository:

Clicking the config/ link brings you to the full listing of files for the Technikable:

The technikable.keymap file contains your keymap:

Enabling GitHub Actions

Before making further changes, click the "Actions" link in your fork. When presented with the option, click "I understand my workflows, go ahead and run them" button.

Keymap Editing

From the keymap file page, clicking the small pencil icon will bring you to the web editor and let you make changes to your keymap:

Once happy with your changes, enter a commit message describing them and click the commit button:

GUI Keymap Editor

Alternatively, you can use Nick's amazing Keymap Editor with your newly created repo and it will "just work".

Download & Install

After committing the changes click the "Actions" link along the top to see the list of GitHub Actions builds. Find the new build in the listing, and click on the description:

From there, near the bottom of the screen will be download labeled "firmware", that you should click to download:

Once downloaded, unzip the downloaded file, and you will have a two files, named technikable-zmk.uf2 and technikable@1.1-zmk.uf2. Use technikable@1.1-zmk.uf2 if you have the latest v1.1 PCBs, otherwise use technikable-zmk.uf2

Connect your Technikable to your computer using a USB cable, and double tap the reset button through the small hole on the bottom of the case. The blue LED should flash, slowing down once detected and connected to your computer.

A new USB "drive" should appear on your connected computer, with a name of "TECHNIKABLE". Copy and paste the correct UF2 image to the new USB drive, and Technikable should complete flashing the new image and instantly restart into it.