You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
László Monda 115a6a4f54
Merge pull request #593 from Zynh0722/patch-2
2 weeks ago
.github/workflows ci: set branch in deploy-gh-pages.yml 4 months ago
.vscode Add tasks.json 2 weeks ago
cla Sign CLA 2 weeks ago
doc Rename super to gui and control to ctrl, for sake of consistency. 4 months ago
doc-dev Fix typo in reference manual 2 weeks ago
keycluster Add resetTrackpoint command. 7 months ago
left Add resetTrackpoint command. 7 months ago
lib Include the documentation into releases. 1 year ago
right Explicitly branch the preprocessor based on DEVICE_ID == DEVICE_ID_UHK60V1 1 month ago
scripts Bump version to 9.2.1, update changelog and package.json 2 months ago
shared split the versions header into a fixed and a generated part 7 months ago
touchpad Update 7 months ago
trackball Add resetTrackpoint command. 7 months ago
trackpoint Fix unintended trackpoint reset on fw startup. 7 months ago
.clang-format Add a clang-format config file 6 years ago
.drone.yml Add a step to generate shared/versions.h 7 months ago
.gitattributes Force Unix newlines for *.[ch] files. 6 years ago
.gitignore Ignore clang cache. 2 years ago
.gitmodules Add SDK_2.8.0_MKL17Z32xxx4 submodule via HTTPS. 3 years ago Bump version to 9.2.1, update changelog and package.json 2 months ago Remove Travis CI configuration file, build Drone CI with verbose output and -Werror. (#371) 2 years ago
LICENSE Change license. 3 years ago Update 2 months ago Update nomenclature, improve grammar and wordiness. 1 year ago

Ultimate Hacking Keyboard firmware

Build Status

This repository hosts the firmware of the Ultimate Hacking Keyboard.

If you want to use the latest firmware version for your UHK, then instead of going through the pain of building the firmware, simply download the latest release of Agent and update to the latest firmware version within Agent with a click of a button.


If you're one of the brave few who wants to hack the firmware then read on.

  1. Make sure to clone this repo with:

git clone --recursive

Then, depending whether you want a full IDE experience or just minimal tools for building and flashing firmware, read IDE setup or Minimal development setup (if you prefer a text editor + command line).

IDE setup

  1. Download and install MCUXpresso IDE for Linux, Mac, or Windows.

  2. Install the GNU ARM Eclipse Plugins for in McuXpresso IDE. This is needed to make indexing work, and to avoid the "Orphaned configuration" error message in project properties.

    1. In MCUXpresso IDE, go to Help > "Install New Software...", then a new dialog will appear.
    2. In the Name field type Eclipse Embedded CDT Plug-ins and in the Location field type, then click on the Add button.
    3. Go with the flow and install the plugin.
  3. In the IDE, import this project by invoking File -> Import -> General -> Existing Projects into Workspace, select the left or right directory depending on the desired firmware, then click on the Finish button.

  4. In order to be able to flash the firmware via USB from the IDE, you must build Agent which is Git submodule of the this repo and located in the lib/agent directory.

  5. Finally, in the IDE, click on Run -> External Tools -> External Tools Configurations, then select a release firmware to be flashed such as uhk60-right_release_kboot, and click on the Run button.

Going forward, it's easier to flash the firmware of your choice by using the downwards toolbar icon which is located rightwards of the green play + toolbox icon.

Minimal development setup

  1. Install the ARM cross-compiler, cross-assembler and stdlib implementation. Eg. on Arch Linux the packages arm-none-eabi-binutils, arm-none-eabi-gcc, arm-none-eabi-newlib.

  2. Install Node.js. You find the expected Node.js version in lib/agent/.nvmrc file. Use your OS package manager to install it. Check the NodeJS site for more info. Mac OS users can simply brew install node to get both. Should you need multiple Node.js versions on the same computer, use Node Version Manager for Mac/Linux or for Windows

  3. Build UHK Agent. cd lib/agent && npm ci && npm run build.

  4. Still inside the Agent submodule, compile flashing util scripts. cd packages/usb && npx tsc.

  5. Generate versions.h. cd scripts && npm ci && ./generate-versions-h.js

  6. When developing, cd to the directory you're working on (left/right). To build and flash the firmware, run make flash. Plain make just builds without flashing.


  1. To build a full firmware tarball:
    1. Run npm install in scripts.
    2. Run scripts/make-release.js. (Or scripts/make-release.js --allowSha for development purposes.)
    3. Now, the created tarball scripts/uhk-firmware-VERSION.tar.gz can be flashed with UHK Agent.


Want to contribute? Let us show you how.

Extended macros

Extended macro commands are built in by default, but need to be enabled by set macroEngine.extendedCommands 1 macro command. It is also possible to build with make-release.js --extendedMacros, or make CUSTOM_CFLAGS=-DEXTENDED_MACROS. Further documentation is available in Agent's macro reference side pane, or (in more technical terms) in doc-dev.

Custom Firmwares

The following list contains unofficial forks of the firmware. These forks provide functionality unavailable in the official firmware, but come without guarantees of any kind:

  • - firmware featuring macro engine extended by a set of custom commands, allowing more advanced configurations including custom layer switching logic, doubletap bindings, alternative secondary roles etc.

  • - firmware fork which comes with an alternative implementation of the secondary key role mechanism making it possible to use the feature for keys actively involved in typing (e.g. alphanumeric ones).