qmk_firmware/keyboards/ploopyco/trackball_nano
Jeff Epler 9632360caa
Use a macro to compute the size of arrays at compile time (#18044)
* Add ARRAY_SIZE and CEILING utility macros

* Apply a coccinelle patch to use ARRAY_SIZE

* fix up some straggling items

* Fix 'make test:secure'

* Enhance ARRAY_SIZE macro to reject acting on pointers

The previous definition would not produce a diagnostic for
```
int *p;
size_t num_elem = ARRAY_SIZE(p)
```
but the new one will.

* explicitly get definition of ARRAY_SIZE

* Convert to ARRAY_SIZE when const is involved

The following spatch finds additional instances where the array is
const and the division is by the size of the type, not the size of
the first element:
```
@ rule5a using "empty.iso" @
type T;
const T[] E;
@@

- (sizeof(E)/sizeof(T))
+ ARRAY_SIZE(E)

@ rule6a using "empty.iso" @
type T;
const T[] E;
@@

- sizeof(E)/sizeof(T)
+ ARRAY_SIZE(E)
```

* New instances of ARRAY_SIZE added since initial spatch run

* Use `ARRAY_SIZE` in docs (found by grep)

* Manually use ARRAY_SIZE

hs_set is expected to be the same size as uint16_t, though it's made
of two 8-bit integers

* Just like char, sizeof(uint8_t) is guaranteed to be 1

This is at least true on any plausible system where qmk is actually used.

Per my understanding it's universally true, assuming that uint8_t exists:
https://stackoverflow.com/questions/48655310/can-i-assume-that-sizeofuint8-t-1

* Run qmk-format on core C files touched in this branch

Co-authored-by: Stefan Kerkmann <karlk90@pm.me>
2022-08-30 10:20:04 +02:00
..
keymaps RESET -> QK_BOOT user keymaps (#17940) 2022-08-21 23:55:30 +01:00
rev1_001 Remove `UNUSED_PINS` (#17931) 2022-08-06 23:23:35 +10:00
config.h Move keyboard USB IDs and strings to data driven: P (#17875) 2022-08-03 17:23:15 +10:00
info.json Move keyboard USB IDs and strings to data driven: P (#17875) 2022-08-03 17:23:15 +10:00
readme.md
rules.mk
trackball_nano.c Use a macro to compute the size of arrays at compile time (#18044) 2022-08-30 10:20:04 +02:00
trackball_nano.h Add lkbm keymap (#17218) 2022-07-02 22:03:11 +10:00

readme.md

Ploopy Trackball Nano

Ploopyco Trackball Nano

It's a DIY, QMK Powered Trackball...Nano!

Make example for this trackball (after setting up your build environment):

make ploopyco/trackball_nano/rev1_001:default:flash
make ploopyco/trackball_nano/rev1_001:via:flash

See the build environment setup and the make instructions for more information. Brand new to QMK? Start with our Complete Newbs Guide.

Hardware Reset Button

The Ploopy Nano 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 Nano, 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.

Customizing your Ploopy Nano Trackball

You can change the DPI/CPI or speed of the trackball by calling adns_set_cpi at any time. Additionally, there is a DPI_CONFIG macro that will cycle through an array of options for the DPI. This is set to 375, 750, and 1375, but can be changed. 750 is the default.

To configure/set your own array, there are two defines to use, PLOOPY_DPI_OPTIONS to set the array, and PLOOPY_DPI_DEFAULT.

#define PLOOPY_DPI_OPTIONS { 375, 750, 1375}
#define PLOOPY_DPI_DEFAULT 1

The PLOOPY_DPI_OPTIONS array sets the values that you want to be able to cycle through, and the order they are in. The "default" define lets the firmware know which of these options is the default and should be loaded by default.

The DPI_CONFIG macro will cycle through the values in the array, each time you hit it. It stores this value in persistent memory, so it will load it the next time the device powers up.

Fuse settings

When flashing the bootloader, use the following fuse settings:

Fuse Setting
Low 0x5E
High 0x99
Extended 0xC3