readme.md (3541B)
1 # Rotary Numpad 2 3 4  5 6 This is a personal project of mine where I wanted a number pad that I can put on the left side of keyboard that doesn't have a numberpad. I fell in love with the feel of rotary encoders on my 3d printer, so added three to be able to play around with. 7 8 * Keyboard Maintainer: [rabijl](https://github.com/rabijl) 9 * Hardware Supported: Sparkfun Pro Micro 5V (atmega32u4) 10 * Hardware Availability: https://www.sparkfun.com/products/12640 11 12 ## How to build from scratch 13 14 I handsoldered gateron blue switches to a 3D printed case. The design is modified from the [Ultipad](https://www.thingiverse.com/thing:4248565). \ 15 I used a sparkfun Pro Micro as my microcontroller and the pinout can be found in the `info.json`. I found this [site](https://golem.hu/article/pro-micro-pinout/) \ 16 to be very useful to identify different pins. You can find useful information on rotary encoders from the qmk docs [here](https://docs.qmk.fm/#/reference_info_json?id=encoders) and [here](https://docs.qmk.fm/#/feature_encoders). 17 18 ### matrix 19 20 Due to the three rotary encoders, I had to use most of the available pins. Fortunately, all the buttons still fit in a 6x4 matrix. Looking at the diagram below, the three buttons in the first column correspond to each encoder button. 21 22 ``` 23 ┌──┐┌──┐┌──┐┌──┐ 24 │0A││0B││0C││0D│ 25 ┌──┐ └──┘└──┘└──┘└──┘ 26 │5A│ 27 └──┘ ┌──┐┌──┐┌──┐┌──┐ 28 │1A││1B││1C││1D│ 29 └──┘└──┘└──┘└──┘ 30 ┌──┐┌──┐┌──┐┌──┐ 31 │2A││2B││2C││2D│ 32 ┌──┐ └──┘└──┘└──┘│ │ 33 │3D│ ┌──┐┌──┐┌──┐│ │ 34 └──┘ │3A││3B││3C││ │ 35 └──┘└──┘└──┘└──┘ 36 ┌──┐┌──┐┌──┐┌──┐ 37 │4A││4B││4C││4D│ 38 └──┘└──┘└──┘│ │ 39 ┌──┐ ┌──────┐┌──┐│ │ 40 │5D│ │5B ││5C││ │ 41 └──┘ └──────┘└──┘└──┘ 42 43 ``` 44 45 ## Flashing 46 47 Make example for this keyboard (after setting up your build environment): 48 49 qmk compile -kb handwired/rabijl/rotary_numpad -km default 50 51 Flashing example for this keyboard: 52 53 qmk flash -kb handwired/rabijl/rotary_numpad -km default 54 55 See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs). 56 57 ## Bootloader 58 59 Enter the bootloader in 3 ways: 60 61 * **Short reset leads**: tap the reset lead to ground twice quickly after qmk is in flash mode 62 * **Keycode in layout**: double tap the key mapped to `QK_BOOT`. On the default keymap this can be found by holding in key (0,C) and tapping key (0,A), see the matrix section for the positions of these keys. 63 * **Bootmagic reset**: Hold down the key at (0,A) in the matrix (see matrix section) and plug in the keyboard 64 65 **Note:** if the keyboard doesn't show up after putting the keyboard in reset mode, check that 66 your user is added to the `tty` and/or `uucp` groups. \ 67 You may need to logout after adding these groups to your user, for the changes to take affect.