This guide is no longer being updated and instead has moved to GitHub (click and scroll down)
- Setting Up and Installing Software
- Building your keymap and keyboard firmware
- Flashing your Let's Split with your created firmware
- Flashing for Linux (_zsh's overly verbose guide has a good secion for this)
- /u/wootpatoot's Original Flashing Instructions
-
Install Bash Shell on Windows, follow this guide
-
Download and install AVRDudess, link here
-
Download and install WinAVR or LIBUSB to get the
LIBUSB0.DLL
- If you don’t then attempting to flash the pro micro won’t do anything
- I’m going to be using WinAVR for this, so download and install it
- Go to install location of WinAVR and go to to the following path, using mine as an example
C:\Program Files (x86)\WinAVR\utils\libusb\bin
- Copy the 4
libusb0
files from the WinAVR folder into the AVRDUDESS Program Files location and it should look like this now
- Clone with Git or Download the QMK Zip and unzip it
https://github.com/qmk/qmk_firmware
- For this guide I’m going to make it easy and just download the Zip
- Extract the zip so you have a folder named QMK or qmk_firmware_master
- Place this in a nice easy location, that doesn’t require administrator access, like your documents folder or desktop
-
Open a bash shell window through the start menu (should be called bash.exe or Bash on Ubuntu on Windows)
-
Change the directory to your QMK copy, which you just unzipped.
- Do this using the
cd
command (Hard drives are accessed in bash by typingcd /mnt/<driveletter>
)
Example cd /mnt/c/Users/Nick/Documents/qmk_firmware_master
-
Run
sudo util/install_dependencies.sh
, This will runapt-get upgrade
-
Wait a while (5 minutes for me), and then you are good to go
- Change the directory to your Lets_Split 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/keyboards/lets_split
- Type
make
and it will build all of the hex’s that are available by default (Serial and i2c, for both Rev 1 & Rev 2)
- Your hex file and a folder will be generated for you at the following location
qmk_firmware_master/.build
- This folder will be generated and your appropriate hex files will be inside, 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
- Change the directory to your Lets_Split 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/keyboards/lets_split
- Customize and configure your files in the Rev 2 folder (keymap.c for layout, but check QMK wiki on GitHub for more advanced)
- Only if using Rev 2 PCB, if you are using Rev 1 just do everything in Rev 1 folder, and type
make rev1
- 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 Wiki
-
Type
make rev2
-
Your hex file and a folder will be generated for you at the following location
qmk_firmware_master/.build
- This folder will be generated and your appropriate hex files will be inside, 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
- Open up AVRDUDESS
- If you get an error saying that it can’t start because libusb0.dll is missing then read step 2 of the SETUP GUIDE above
- Select Atmel AppNote AVR109 Boot Loader for the programmer
- Select ATmega32U4 for the MCU
- Select your .hex file in the for the flash box (click the … box to the right)
- Select the
eeprom-lefthand.eep
file in the QMK Lets_split folder for the EEPROM box
- Make sure to select only one file, as you will have to change this file when flashing the right side
-
Connect only the left side of your board to the computer through a USB cable
-
Take note of the port drop down menu and see if you have any COMM listings, if you do, then Don’t select those particular ones in the next step
- Locate the ground and reset pins on your pro micro and short them, was 2 from the top on the right side of the pro micro for me
-
Take something metal and touch between the ground and reset pins to short them out, or if your’s has a reset button then press that to enter the bootloader mode
-
Quickly open the Port drop down menu and select the new COMM port that has popped up, then click program
- If the pro micro came out of bootloader mode, then you won’t be able to flash it, but all you have to do is enter bootloader mode again by shorting the pins again.
-
Now the left side is done, we have to flash the right side, so connect it to your PC through USB
-
Be sure to change the EEPROM file to the right hand one (eeprom-righthand.eep)
-
Locate the ground and reset pins on your pro micro and short them, was 3 from the top on the right side of the pro micro for me
-
Take something metal and touch between the ground and reset pins to short them out, or if your’s has a reset button then press that to enter the bootloader mode
-
Quickly open the Port drop down menu and select the new COMM port that has popped up, then click program
- If the pro micro came out of bootloader mode, then you won’t be able to flash it, but all you have to do is enter bootloader mode again by shorting the pins again.
-
Time to test it out, plug in your TRRS cable to both sides, and then plug in the USB on the left side and open a notepad window to test out all the keys and make sure your soldering skills were good
-
Congrats on correctly flashing your own Let’s Split, and hope this helps those out who are having trouble with programming their Let’s Splits like I did
-Written by /u/CampAsAChamp
Help and references from
-
/u/wootpatoot
-
/u/_zsh
-
/u/jackhumbert
-
/u/Jolly_Green_Giant
Hi, I was just madening when I read that the eeprom files now are common for the split keyboards and are placed in \qmk_firmware\quantum\split_common\ Hope to help someone