DIY macro keypad with USB-C, WiFi and BLE conenctivity.
Hardware list is quite short:
- Adafruit QT Py S3 with 2MB PSRAM
- NeoKey 1x4 QT I2C
- 4 Cherry MX compatible switches
- 4 keycaps
- Qwiic/StemmaQT/EasyC cable - 10 cm long
- 3D printed box (see the model README for details)
You'll need CircuitPython 9.x on board, you can download it here.
All libraries used by this project can be found under src/lib/, copy this directory to the board after you've installed CircuitPython. The documentation can be found here, e.g. HID library docs. If you're using non-US keyboard layout, you might want to add Circuitpython_Keyboard_Layouts by Neradoc to the project.
You'll need some kind of IDE - Adafruit recommends Mu Editor.
First, copy the contents of src directory to QT Py - it'll restart automatically and you should have basic functions working: copy/paste/undo/save (from left to right). You can open code.py file and make some changes - as soon as you save the file the board restarts and your new code is now working.
To try something else, go to examples/[example_name] directory and copy code.py to the board. Each example has a comment block at the beginning explaning what it does, feel free to experiment with it!