Yeehaw Firmware Guides

SquashKB Docs

SquashKB Store SquashKB Discord SquashKB Instagram

Search…

Documentation Home

Open Source Files

🤠

Yeehaw

Yeehaw Build Guide

Yeehaw Firmware Guides

🪓

Lesovoz

Lesovoz Build Guide

Lesovoz Firmware Guide

🐳

Free Willy

Free Willy Build Guide

Yeehaw Firmware Guides

Here you can find the guides for remapping and programming your Yeehaw Macro Pad. There are 3 different methods shown that each have their own pros and cons. Pick which one is best for you!

Remapping Yeehaw using Via
 This is the easiest of the 3 ways to reprogram your macro pad. The boards will come preflashed with Via firmware, meaning all you have to do is plug the board in, and load up the Via software. Note that Via does not currently support encoder remapping, so it will be defaulted to volume up and down. For a live keymap editor that does support encoders, see the Vial guide below.
 1.) Start by downloading and installing Via if you have not already. The download can be found here.​
 2.) Next, plug your Yeehaw into the computer's USB port. Make sure it is directly plugged into the computer and not through a USB hub, as that will cause issues with Via.
 3.) The keyboard should now load in, and be displayed on screen. Reprogramming the board in Via is as simple as clicking the key you want to remap and selecting the new keycode for that key. Your macro pad is now good to go!
Flashing Yeehaw using your local QMK environment.
To flash using QMK (Not Via/Vial), you will need your QMK local environment set up. If you have not done so, please follow the steps here: QMK Setup Guide​
1.) Within your terminal, navigate to your QMK folder by typing cd [path to your QMK folder here]. You can skip this step if using QMK MSYS.
2.) Make and flash the firmware with the command, qmk compile –kb yeehaw –km default or alternatively if you are not using QMK MSYS, make yeehaw/yeehaw:default:avrdude
3.) When prompted by avrdude to reset the board, simply tap the reset button on the PCB once.
 Remapping Yeehaw using Vial (Encoder Support)
 Vial is very similar to Via, with the main difference being Vial's encoder support. Since the boards are pre-flashed with Via firmware, you will have to flash the Vial firmware onto the pro micro first. Flashing the Vial hex is easiest with QMK toolbox, which can be downloaded here. You will also need the Vial hex, which can be found on my Github here. Lastly, you will need the Vial software, which can be downloaded here.​
 1.) The first step is to flash the Vial hex onto the pro micro. Open QMK toolbox and click "Open", then navigate to the "yeehaw_vial.hex" you downloaded above. Next, make sure atmega32u4 is selected from the dropdown in the Microcontroller section. Now plug your Yeehaw into the computer, and press the reset button on the back of the PCB. Click "Flash", and QMK toolbox will flash the hex file onto the pro micro. If the flash is successful, you should get a message saying, "avrdude.exe: X bytes of flash verified".
 2.) Now open up Vial. The keyboard should be recognized automatically, and you can begin remapping!
 Note: The Vial source code for Yeehaw is also available and can be found here.

Last modified 7mo ago

Copy link

Outline

Remapping Yeehaw using Via

Flashing Yeehaw using your local QMK environment.

Remapping Yeehaw using Vial (Encoder Support)