Lesovoz Firmware Guide

Here you can find the guides for remapping and programming your Lesovoz PCB.

Remapping with Vial

Lesovoz comes pre-flashed with Vial, which allows you to remap your keymap on the fly. To do so, download Vial, plug in your Lesovoz, and click the refresh to begin editing. Vial allows you to change your keymap, program macros, and even configure combos. The layout defaults to full ortho, so if you need to change it, that can be done in the layouts tab.

Please note that the default Vial firmware has the LEDs set to MO(1) and any keypress, and is also limited to 4 combos. You cannot change these within the Vial GUI, so if you would like to compile your own Vial hex file or QMK hex file to make these changes, the source code can be found on my vial-qmk fork here. I have also provided a Vial hex with the LEDs off on the Lesovoz open source files repo.

Flashing a Hex to Lesovoz

To flash a new hex file to your Lesovoz PCB, QMK Toolbox is the easiest method. Start by downloading QMK Toolbox (qmk_toolbox.exe for Windows), and when prompted to install drivers for your device, select yes. Next, browse for the hex file you are flashing in the Local File section, select atmega328p from the Microcontroller section, and check the Auto Flash and Flash when ready boxes. Your QMK toolbox GUI should now look something like this:

Now put your Lesovoz into bootloader mode. If you are using the pre-flashed firmware, you can do so by holding the bottom right most key and pressing the top right most key. Otherwise, use the reset and boot switches on the PCB in this order: Press and hold BOOT, Tap RESET, Release BOOT. The flash sequence should start, and you will know it has completed when it looks like this.

Be sure not to unplug your board while it is flashing. To exit bootloader mode and begin using your board, press the reset switch, or unplug and re-plug in your board.

Last updated