QTPy-Knob
QT Py USB Media Knob using rotary encoder & neopixel ring
The QTPy-Knob features:
- Media knob for volume up/down/mute with "qtpy-knob.py" CircuitPython program
- Stylish design reminiscent of Griffin Powermate
- Recessed USB-C connector to for safety
- No screws needed for assembly
- Only 3 wires needed to solder (none if you want to forgo LED lighting)
- Reprogrammable for any USB macro key action via CircuitPython
A small video about it: https://www.youtube.com/watch?v=pt7JgoSlgOg
This is an attempt to make a minimal and easy-to-build version of similar, previous projects like:
Components
Parts needed:
- Adafruit QT Py (https://www.adafruit.com/product/4600)
- Adafruit Neopixel Ring (https://www.adafruit.com/product/1463 or equiv)
- Rotary encoder (PEC11-4120F-S0018 or equiv. The 3D printed case expects encoder w/ 20mm shaft & 7mm threaded barrel, see here for mods if using a 15mm encoder)
- 3D printed enclosure (see "cad" folder)
Software
Software installation consists of:
- Install CircuitPython on the QT Py
- Install required CircuitPython libraries to QT Py
- Copy qtpy_knob.py to QT Py
The CircuitPython installation step is described here: https://learn.adafruit.com/welcome-to-circuitpython/installing-circuitpython
The last two steps can be accomplished with the below
git clone https://github.com/todbot/qtpy-knob
cd qtpy-knob
pip3 install circup
circup install -r requirements.txt
cp qtpy_knob.py /Volumes/CIRCUITPY/code.py
Variations
There are a few variations of the code provided:
qtpy_knob_scroller.py
-- performs scrolling instead of volume knobqtpy_knob_simple.py
-- no neopixel stuff, just encoder and USB sendingqtpy_knob_midi_cc.py
-- sends MIDI CC instead of keyboard/mouse
Assembly
Steps:
- Plug rotary encoder to bottom of QT Py. If your encoder has metal on the bottom, add a bit of tape (Kapton, Scotch, electrical) in between the QT Py and the encoder. If your encoder has mounting tabs, cut them off. Solder the five pins.
- Print out the enclosure on your 3d printer. Standard 0.2mm at 20% infill is fine. The STL files are:
qtpyknob-base.stl
-- Base that houses the QT Py & rotary encoderqtpyknob-basecap.stl
-- Cap that goes on the bottom of the baseqtpyknob-knob.stl
-- Knob that you turnqtpyknob-diffuser.stl
-- Light diffuser that goes between base & knob, should be printed with translucent or clear plastic. Or you can leave it out. Or you can approxiate it with a disk cut out clear plastic like a CD case
Use the rotary encoder's washer & screw to hold QTPy+encoder assembly
- Solder three wires to the Neopixel ring, insert the ring into the enclosure and solder the wires to the 3V, Gnd, and MI pins of the QT Py. Use a bit of hot glue to secure the Neopixel ring if it doesn't snap in.
- Snap the bottom cap on and the knob top on and you're done with physical assembly!
Wiring diagram
Assembly animation
Useful links
Resources that helped me out on this:
- https://learn.adafruit.com/media-dial
- https://learn.adafruit.com/make-it-a-keyboard/circuitpython
- https://github.com/adafruit/Adafruit_CircuitPython_HID/tree/master/examples
- https://circuitpython.readthedocs.io/projects/hid/en/latest/api.html#adafruit-hid-consumer-control-consumercontrol
- https://learn.adafruit.com/trinket-usb-volume-knob