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

Updated Appendix D: QMK Firmware Programming (markdown)

ploopyco 2021-05-17 10:25:09 -04:00
parent d8ad9ffae1
commit 7fda663526
1 changed files with 9 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -49,12 +49,18 @@ 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. Open it by removing the screw in the base.
3. Hold the hardware reset button. It's the only tactile push buttons switch on the board.
4. While holding the hardware reset button, plug the Ploopy Nano 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. Open it by removing the screw in the base and removing the top.
3. Pop the PCB out of the base. *(Note: once you've done this a few times, you can reflash the board without popping the PCB out, since the holes are obviously also exposed on the back of the PCB.)*
4. Look for a pair of vias (gold-plated holes) that have the words `BOOTLOADER` above them. If you're looking at the board "right side up", then you should see the words in the top-right corner, and the two holes will be right below the words.
5. Get a paper clip (non-insulated, i.e. no plastic shit covering it) or a pair of tweezers, or some wire. Whatever you've got on hand that's metal.
6. Stick the paper clip or tweezers into the holes. You're trying to form an electrical connection between the two holes.
7. While you've got the two vias connected with your metal bridge, plug the Ploopy Nano 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.
8. Let go with the paper clip or tweezers. That's done for now.
And that's it. While plugged in this way, the Ploopy Nano Trackball will accept new firmware.
Whenever you want to put new firmware onto the Ploopy Nano, go through these steps again.
## Flashing the firmware
Use your preferred method of flashing QMK firmware.