mg/keybow2040
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
No description
7 commits 4 branches 0 tags 482 KiB
Python 100%
Find a file
sandyjmacdonald ec652b0898 First bash at README.
2021-03-11 13:30:40 +00:00
examples First bash at README. 2021-03-11 13:30:40 +00:00
.gitignore Adding .DS_Store to .gitignore 2021-03-10 23:57:02 +00:00
keybow-2040-github-1.jpg First bash at README. 2021-03-11 13:30:40 +00:00
keybow2040.py Adding more examples. Disabling rotation because it ain't working. 2021-03-10 23:51:42 +00:00
LICENSE Initial commit 2021-03-10 20:39:25 +00:00
README.md First bash at README. 2021-03-11 13:30:40 +00:00

README.md

Keybow 2040 CircuitPython

This CircuitPython library is for the RP2040-powered Keybow 2040 from Pimoroni, a 16-key mini mechanical keyboard with RGB backlit keys. Find out more about Keybow 2040 at the link below.

Keybow 2040 at pimoroni.com.

Keybow 2040 with backlit keys on marble background

The library abstracts away most of the complexity of having to check pin states, and interact with the IS31FL3731 LED driver library, and exposes classes for individual keys and the whole Keybow (a collection of Key instances).

Getting started quickly!

You'll need to grab the latest version of Adafruit's Keybow 2040-flavoured CircuitPython, from the link below.

Adafruit CircuitPython for Keybow 2040

Unplug your Keybow 2040's USB-C cable, press and hold the button on the top edge of Keybow 2040 while plugging the USB-C cable back into your computer to mount it as a drive (it should show up as RPI-RP2 or something similar).

Drag and drop the xxxxxxxx.uf2 file that you downloaded onto the drive and it should reboot and load the CircuitPython firmware. The drive should now show up as CIRCUITPY.

The Adafruit IS31FL3731 LED driver library for CircuitPython is a prequisite for this Keybow 2040 library, so you'll need to download it from GitHub at the link below, and then drop the adafruit_is31fl3731 folder into the lib folder on your CIRCUITPY drive.

Adafruit IS31FL3731 CircuitPython library

Finally, drop the keybow2040.py file from this library into the lib folder on your CIRCUITPY drive also, and you're all set!

Pick one of the examples (I'd suggest the reactive.press.py example to begin), copy the code, and save it in the code.py file on your CIRCUITPY drive using your favourite text editor. As soon as you save the code.py file, or make any other changes, then it should load up and run the code!