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.
git clone --recursive git@github.com:UltimateHackingKeyboard/firmware.git
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).
Download and install MCUXpresso IDE for Linux, Mac, or Windows.
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.
Eclipse Embedded CDT Plug-ins
and in the Location field type https://download.eclipse.org/embed-cdt/updates/neon
, then click on the Add button.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.
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.
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.
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
.
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
Build UHK Agent. cd lib/agent && npm ci && npm run build
.
Still inside the Agent submodule, compile flashing util scripts. cd packages/usb && npx tsc
.
Generate versions.h
. cd scripts && npm ci && ./generate-versions-h.js
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.
npm install
in scripts
.scripts/make-release.js
. (Or scripts/make-release.js --allowSha
for development purposes.)scripts/uhk-firmware-VERSION.tar.gz
can be flashed with UHK Agent.Want to contribute? Let us show you how.