Default Layouts and Firmware
The layout shown is as it looks in VIA. Due to a VIA limitation, all keys are shown, even if you choose not to use them.
- Layer 0
- Layer 1
VIA configurator is a graphical tool that can be used to change keymaps. It is available here: https://github.com/olivia/via-config/releases/
You must use a release later than v0.3.5
To change the keymap, simply open VIA Configurator and it will load the keyboard. If it does not work, restart VIA. From there, it's intuitive to change keys.
There is a known bug with QMK Configurator which should be fixed in the upcoming weeks which causes it to build improper bin files.
The easy option to create firmware is to use QMK Configurator. This will give you a graphical interface for creating your desired keymap.
More Hands-on Option
If you'd like to customize more than just a keymap, the best place to start is the QMK Newbs Guide. Follow the guide up until the flashing portion, and then follow the flashing guide below.
One Time Setup
Once the steps in this section are done once, they will not have to be done again, unless your driver resets.
- Install the newest release of Zadig from https://zadig.akeo.ie/.
- Download the newest release of QMK Toolbox from https://github.com/qmk/qmk_toolbox/releases
- Change the switch to "1" on the PCB
- Plug the PCB in
- Open Zadig
- Click "List all Devices" in the Options menu
- Select "STM32 BOOTLOADER" from the device dropdown
- Select WinUSB from the Driver dropdown
- Click the 'Replace Driver' Button
- You should see a "Installing Driver" progress bar appear
After initial setup has been done once, you can use the RESET keycode in QMK to enter flashing mode on your PCB. From there:
- Download the proper firmware for your PCB
- Start QMK Toolbox, and click the "Open" buttom
- Change the filetype dropdown to ".bin" and select the proper firmware
- Hit the "Flash" Button
- At the end, you should see "File downloaded successfully"
- Change the switch back to "0" and hit the reset button
- Verify all the LEDs work