keychron_qmk_firmware/keyboards/ploopyco/trackball_mini/readme.md

45 lines
1.8 KiB
Markdown
Raw Normal View History

# Ploopy Trackball Mini
![Ploopyco Trackball Mini](https://ploopy.co/wp-content/uploads/2021/07/mini4.jpg)
It's a DIY, QMK Powered Trackball...Mini!
* Maintainer: [PloopyCo](https://github.com/ploopyco)
* Key contributors: [Drashna Jael're](https://github.com/drashna/), [Germ](https://github.com/germ/)
* Hardware Supported: ATMega32u4 16MHz(5v)
* Hardware Availability: [Store](https://ploopy.co), [GitHub](https://github.com/ploopyco)
Make example for this trackball (after setting up your build environment):
make ploopyco/trackball_mini/rev1_002:default:flash
make ploopyco/trackball_mini/rev1_002:via:flash
To jump to the bootloader, hold down "Button 4" (immediate right of the ball)
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
## Hardware Reset Button
The Ploopy Mini has a handy bootloader reset mechanism: two via pins on the board, designated by the reference designator `MCU.J.X BOOTLOADER`. If you stick an uninsulated paperclip or a pair of metal tweezers into both holes and plug in the Mini, it will start in bootloader mode.
## Revisions
Occasionally, new revisions of the PCB will be released. Every board comes with a designator that looks something like `R1.001`.
Match the firmware that you flash onto the board with the designator on the board.
## Fuse settings
When flashing the bootloader, use the following fuse settings:
| Fuse | Setting |
|----------|-------------|
| Low | `0x5E` |
| High | `0x99` |
| Extended | `0xC3` |
# Customizing your Ploopy Mini Trackball
You can find customziation options [here](../readme.md).