This repository contains scripts for the Pimoroni Keybow 2040
It is built on top of the work by Sandy Macdonald as part of the Keybow project
- Your keybow must be running >= 7.x of Circuit Python or from github
- If you use the
make.shscript in the root, the firmware .uf2 file will be placed in a firmware sub directory
- If you use the
- You must be using a compatible version of the library
- Libraries required are:
- adafruit_bus_device
- adafruit_hid
- adafruit_is31fl3731
- You also need a copy of the keybow library
- Code is formatted using Black - See here for setup details
- Editor of choice is VSCode
- Terminal is zsh
- Copy the library to
/lib - Copy
keybow2040.pyto/lib - Copy
boot.pyto the root of theCIRCUITPYdirectory - Copy
code.pyto the root of theCIRCUITPYdirectory
Alternatively, you can use the script in the root of the repository, simply run make.sh and it will build you a directory build/circuitpy. Simply copy the whole contents from here to the root of the CIRCUITPY volume.
The code.py sets up the Keybow to send shortcut commands. When you press the key, it will light that key. Repeats are not sent. The default configuration is very specific to my needs, and currently sends commands related to media playback, as well as the CLion IDE.
The current key layout is below:
| Debugger continue | Debugger step over | Debugger step in | Debugger step out |
| Go to definition | Find usage | Switch between h/cpp | Find and replace |
| Empty | Empty | Empty | Empty |
| Play / Pause | Next track | Volume down | Volume up |
By default the code in boot.py will prevent the CIRCUITPY drive from appearing in the host machine. If you want to make it visible, for example for editing the code.py file, you need to hold SW0 (Bottom left button if the USB port is pointing up) and then plugin the USB cable. This will enable the device to mount as a volume.
The artwork is in both sketch and pdf format. It is designed to be printed at 100%, and if you then cut it out it will fit nicely in to these relegendable caps