MirrorMirror
/
classic-trackball
mirror of https://github.com/ploopyco/classic-trackball.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Updated Appendix C: QMK Firmware Programming (markdown)

ploopyco 2021-03-29 11:02:54 -04:00
parent 4101dd67ab
commit 74309dacce
1 changed files with 10 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
Appendix-C:-QMK-Firmware-Programming.md

@ -26,6 +26,14 @@ Whenever you see that, use the following syntax:
and you'll be fine.
## Choose the correct firmware
Look for some writing on the base PCB (it sits flat against the bottom of the case, and it holds the microcontroller and the sensor optic). If you see that it has a version of "R1.005" or higher, use the `rev1_005` firmware. If it's "R1.004" or lower, use the `rev1` firmware.
**LEFTIES ONLY:**
- If you're compiling from source, use the `rev1` version of the firmware. Make sure to change the `rev1/rules.mk` configuration file to have the line `BOOTLOADER=atmel-dfu` instead of `BOOTLOADER=caterina`.
- If you don't want to be bothered with all that, a precompiled hex file is available for you [right here](https://github.com/ploopyco/classic-trackball-lefty/blob/master/firmware/ploopyco_trackball_rev1_leftie_via.hex). It comes with VIA already configured.
## Building the Ploopy Trackball firmware
With your terminal window open and pointed at your QMK build environment, compile the firmware with the following command:
@ -45,8 +53,8 @@ For more details on building QMK firmware in general, see the [QMK firmware guid
Putting the Ploopy Trackball into bootloader mode is very easy.
1. Unplug it from your computer.
2. Hold the "forward" button. This is the button just to the right of the ball; it normally sits under your ring (fourth) finger.
3. While holding the forward button, plug the Ploopy Trackball into your computer. If you're using QMK Toolbox, it should show up in the console. If using `dmesg`, it'll show up as an Atmel DFU device.
2. If you're using a right-handed Ploopy Classic, hold the "forward" button. This is the button just to the right of the ball; it normally sits under your ring (fourth) finger. If you're using a left-handed Ploopy classic, hold the "back" button.
3. While holding the button, plug the Ploopy Trackball into your computer. If you're using QMK Toolbox, it should show up in the console. If using `dmesg`, it'll show up as an Atmel DFU device.
And that's it. While plugged in this way, the Ploopy Trackball will accept new firmware.