Building Firmware.md

BUILDING HEX

Table of Contents

• Setting Up and Installing Software
• Building your keymap and keyboard firmware
• Flashing your Let's Split with your created firmware

---

For the default keymap, with no customization

1. Change the directory to your QMK folder

• Do this using the cd command

Hard drives are accessed from cd /mnt/<driveletter>

Example cd /mnt/c/Users/Nick/Documents/qmk_firmware_master/

2. Type make lets_split/rev2:default and it will build all of the hex’s that are available by default (Serial and i2c, for Rev 2)

3. Your hex files will be generated for you in the same folder, qmk_firmware_master/

• All you need is your lets_split_rev2_default.hex file

For customization (Skip if you wanted just the default layout, steps for that are above)

1. Customize and configure your files in the Rev 2 folder (keymap.c for layout, but check QMK docs on GitHub for more advanced)

• Only if using Rev 2 PCB, if you are using Rev 1, type make lets_split/rev1:<keymap>

• For me, I had to reverse the right side, because it was flipped, read the instructions for that above, at the end of the _zsh's guide, he goes over how to fix this. I’m not going to go into customization in this guide, so just check the QMK Docs

3. Type make lets_split/rev2:<keymap> and replace <keymap> with your keymap, for example: make lets_split/rev2:nick

4. Your hex file will be generated for you in the root folder, qmk_firmware_master/

• All you need is your .hex file, so copy that somewhere safe, or you can just drag it in the let’s split folder in QMK

Next Step(Flashing firmware)