Macropad Workshop by Google developer student club and Innovation space in Eindhoven university of Technology

Workshop session

1. Macropad Workshop Presented by: Ainius Sinickas, Povilas Kazlauskas, Zilvinas Aleksa 

2. ‹#› Partners

3. ‹#› Game plan Group 1 18:30 Hardware presentation + macropad assembly 20:00 Software presentation + programing 17:40 Food 18:20 Introduction Group 2 18:30 Software presentation + programing 20:00 Hardware presentation + macropad assembly

4. ‹#› End product

5. ‹#› Time for work Group 1 hardware presentation Group 2 software presentation

6. Hardware

7. ‹#› What goes into our macropad? Case Keycaps Microcontroler Mechanical Switches Rotary encoder

8. ‹#› Case 3D printing Laser cutting

9. ‹#› Keycaps

10. ‹#› Mechanical Switches

11. ‹#› Microcontrolers Our microcontroler has to have: Enough digital input pins HID compatibility (be able to send keyboard and mouse commands to the computer) Bluetooth support (optional)

12. ‹#› Digital input pins Used for checking if input is high(1) or low(0) 5V or 3.3V tolerant

13. ‹#› Pull up and Pull down resistors Important in preventing a floating state Some microcontrolers have pull up and pull down resistors built-in

14. ‹#› Rotary encoder, use cases Is used to determine the direction the knob is being rotated and the amount it was rotated Has continuous rotation Incremental input Perfect for manual volume control Scrolling through menu options

15. ‹#› Rotary encoder, how does it work Two pins which are shifted to be out of phase The order in which the pins are triggered determines the direction

16. ‹#› Time to learn how to solder

17. ‹#› 5 steps of soldering Before soldering (and after every 4 th solder joint): Apply solder to the soldering iron tip Clean the soldering iron tip Reapply solder to the soldering iron tip Connecting two wires: Apply solder to the parts you want to connect Heat up the two parts while touching them together

18. ‹#› Differences to soldering wires to a PCB pad Apply solder only to the wire and not to the PCB pad Push the wire through the hole and only then apply solder to the pad

19. ‹#› Lets go solder

20. Software

21. ‹#› Software Premade options: TMK (replaced by QMK) QMK (wired) ZMK (wireless) KMK (python) Write yourself: MicroPython / CircuitPython C / C++ / Arduino

22. ‹#› We need to learn how to: G et input from switches S imulate Human Interface Devices (HID) G et rotation from the rotary encoder C ombine everything On your own time: A dd control for RGB lights (+5 fps) Shortcuts

23. ‹#› Preparation Flashing CircuitPython firmware to the raspberry pi pico board (done) https://learn.adafruit.com/getting-started-with-raspberry-pi-pico-circuitpython/circuitpython https://circuitpython.org/board/vcc_gnd_yd_rp2040/ Adding additional Adafruit libraries (done) https://github.com/adafruit/Adafruit_CircuitPython_Bundle?tab=readme-ov-file Setting up Mu Editor (hopefully done) https://learn.adafruit.com/getting-started-with-raspberry-pi-pico-circuitpython/installing-mu-editor

24. ‹#› Getting input from the switches https://learn.adafruit.com/getting-started-with-raspberry-pi-pico-circuitpython/blinky-and-a-button

25. ‹#› Simulating HID device https://docs.circuitpython.org/projects/hid/en/latest/

26. ‹#› Getting rotation from the rotary encoder https://learn.adafruit.com/rotary-encoder/circuitpython

27. ‹#› Combining everything

28. ‹#› Layout Keycode documentation https://docs.circuitpython.org/projects/hid/en/latest/api.html#adafruit-hid-keycode-keycode Use Layout with the write() method for more complex text https://docs.circuitpython.org/projects/hid/en/latest/examples.html

29. ‹#› Making shortcuts

30. ‹#› Making shortcuts