This project simplifies the creation of custom USB HID keyboards.
- A microcontroller board compatible with CircuitPython.
- Hardware buttons or any electrical component that can close and open an electrical connection.
- Some wires and connectors to connect the buttons to the board.
- Download CircuitPython 7.x and flash it to your
board (CircuitPython versions higher than 7.x may also work, but compatibility
is not guaranteed). Your board will now appear as a USB mass storage device
called
CIRCUITPY
volume. - Download the
Adafruit CircuitPython library bundle
compatible with your CircuitPython version, extract it and copy the
adafruit_hid
,asyncio
andadafruit_ticks
modules into thelib
folder of theCIRCUITPY
volume. - Copy the
.py
files form this folder onto theCIRCUITPY
volume. - Customize the
config.py
file according to your board and needs, e.g. assign your board's GPIO pins to keystrokes.
The device outputs diagnostic messages to the serial console offered by your board.
Developed by Christian Stussak for IMAGINARY gGmbH.
Copyright 2022 IMAGINARY gGmbH
Licensed under the MIT license (see the LICENSE
file).