VM's macro keyboard

VM's macro keyboard

This project is developed for Arduino Micro boards and it functions as a macro keyboard with rotary encoder. Eight mechanical cherry MX keys can be assigned various functions (writing text, combination and sequences of key codes, multimedia and mouse functions). Rotary encoder supports turning, click and double click.

Features

• up to 4 keys codes sent at once
• sequence of maximum 16 length of separate key commands
• modifier key to change the default behavior of rotary encoder
• STL files for case
• all keys are directly connected to GPIOs, so no diodes are required
• can emulate keyboard, multimedia key, mouse and system commands

This project is inspired by and some code is taken from Control volume knob by Prusa.

Hardware

• 8x Cherry MX - I have used red ones
• 1x 25cm micro USB cable - you can of course use any micro USB cable
• 1x Arduino Pro Micro 5V - as the board is powered from the USB, ie. with 5V, you can solder the J1 solder joint to bypass the LDO
• 1x rotary encoder - make sure it has thread to secure it on the case
• Optional - sillicone wires - in comparison to my old wires, these are angel's stuff. I have used AWG26, but I suggest to use AWG 28, there are no big currents.

Software

Project was tested with following version:

• Arduino IDE 1.8.12
• Arduino AVR boards 1.8.2

Libraries:

• ClickEncoder
• TimerOne 1.1
• HID-Project 2.6.1

Setup

Detailed setup steps are described on my Github .

Additional STLs

Aside from the provided files you need:

• 8x KeyV2: Parametric Mechanical Keycap Library - I have used oem_row-5_length-1.stl
• 1x volume knob - I have used knob_smooth_playpause.3mf

Print instructions

You need supports to print the top case. To minimize the amount of the support material (and time), you can cut the top case at the height of 17mm and then glue the parts together.
It is really nice, when you use two colors of filament for the whole model.