After just setting up a QMK environment and creating and flashing a firmware for my Hotdox keyboard, I decided to write the steps down because I will inevitably forget something the next time I need to change something.
Installing the tools on macOS
The official docs are good, but the current Brew version of avr-gcc
is broken and needs to be manually built from source after setting up QMK:
brew uninstall --ignore-dependencies avr-gcc@8
brew install --build-from-source avr-gcc@8
Creating a new layout
qmk new-keymap -kb hotdox
Building the firmware
qmk compile -kb hotdox -km anttti
Flashing the firmware
Once the keyboard is built, the .hex
file is found in ~/qmk_firmware/.build
and it can be flashed with QMK Toolbox.