You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

87 lines
3.3 KiB

dumbpad refactor - adding support for various PCB revisions (#9259) * Placeholder commit - Refactored to support different PCB revisions Individual revision folders still need: - info.json - readme.md all v0x folders support up to two LEDs for layer indication all v1x folders support up to two LEDs for layer indication plus one extra LED for numlock indication v0x - supports single-encoder v0.x PCB revisions v0x_right - supports reversible, single-encoder v0.x PCB revisions v0x_dualencoder - supports dual-encoder v0.x PCB revisions v1x - supports single-encoder v1.x PCB revisiions v1x_right - supports reversible, single-encoder v1.x PCB revisions * Added info.json and readme.md files for all dumbpad revisions * More refactoring, adding shared config.h and rules.mk Removed config.h from default keymap folders - defining TAPPING_TOGGLE in config.h * Minor formatting fix * MATRIX_COL_PINS for v1x_right was not reversed - changed to match v0x_right * adding support for v1x dual encoder PCB * adding alt-f2 tapdance routine for personal keymaps * adding dumbpad build using teensy 2.0 instead of Pro Micro * matched v1x dumbpad encoder and led pins to latest PCB revisions * updated readme, removed v1x_teensy until someone requests it * changed device name to match tmk udev rules, removed unnecessary ifdef * removed user keymaps and folders * missed hotdox keymap - removing * fixing info.json keyboard_names for all versions * Changed biton32 to get_highest_layer in keyboards/dumbpad/v0x/v0x.c * keyboards/dumbpad/v0x/v0x.c - remove matrix_scan_kb, process_record_kb * /dumbpad/v0x/keymaps/default/keymap.c - remove empty functions * /dumbpad/v0x/keymaps/default/keymap.c - changed biton32 to get_highest_layer * keyboards/dumbpad/v0x_dualencoder/keymaps/default/keymap.c - remove empty functions * keyboards/dumbpad/v0x_right/readme.md - smaller board layout image * keyboards/dumbpad/v1x_dualencoder/readme.md - smaller board image * keyboards/dumbpad/v1x/readme.md - smaller board image * keyboards/dumbpad/v1x_right/readme.md - smaller board image * Update keyboards/dumbpad/rules.mk * Apply suggestions from code review Batch applying suggestions from review * fixed removal of led_set_kb * Implementing requested changes from old pull request 9259 * removing unused rules * removed rules.mk from dumbpad base folder * adding templates for each layout * testing default keymap json * Testing applying default keymap for dumbpad * Layout correction: v1.x are 17 position pcb's * Update keyboards/dumbpad/v0x/rules.mk * Update keyboards/dumbpad/v0x/rules.mk * Update keyboards/dumbpad/v0x_dualencoder/keymaps/default/keymap.c * Update keyboards/dumbpad/v0x_dualencoder/rules.mk * Update keyboards/dumbpad/v0x_dualencoder/rules.mk * Update keyboards/dumbpad/v1x_dualencoder/rules.mk * Update keyboards/dumbpad/v1x_dualencoder/templates/keymap.c * Update keyboards/dumbpad/v1x_right/rules.mk * Update keyboards/dumbpad/v1x_right/rules.mk * Update keyboards/dumbpad/rules.mk * Update keyboards/dumbpad/v0x_dualencoder/templates/keymap.c * Update keyboards/dumbpad/v0x_right/rules.mk * Update keyboards/dumbpad/v1x/rules.mk * Update keyboards/dumbpad/v1x/rules.mk * Update keyboards/dumbpad/v1x_dualencoder/keymaps/default/keymap.c * Update keyboards/dumbpad/v1x_dualencoder/rules.mk * Update keyboards/dumbpad/v0x_right/rules.mk * Removing binary files
3 years ago
  1. # dumbpad v1.x dual-encoder
  2. ![dumbpad](https://i.imgur.com/s69rdfA.png)
  3. ## Single- vs Dual-Encoder Support
  4. The combined Cherry MX/encoder sockets allow single- and dual-encoder configurations.
  5. The only rule when using two encoders is that there cannot be two encoders on the left side at once, or two on the right side.
  6. This table shows where the encoders are in the switch grid ("X" for encoder, "s" for switch):
  7. | C0 | C1 | C2 | C3 | C4 |
  8. |:---:|:---:|:---:|:---:|:---:|
  9. | |__X__| s | s |__X__|
  10. | | s | s | s | s |
  11. | | s | s | s | s |
  12. |__X__|__X__| s | s |__X__|
  13. - The three encoders in columns C0 and C1 are connected to each other
  14. - The two encoders in column C4 are connected to each other
  15. So, if doing dual encoders, one must be in column C4 and the other in either C0 or C1. Three or more encoders will not work.
  16. The following sections describe the configurations that the default keymaps in QMK are designed for.
  17. ### Single-Encoder (Default Configuration)
  18. In the default configuration, the encoder is in column 0, the bottom left corner below the Pro Micro. All other sockets are filled with switches.
  19. | C0 | C1 | C2 | C3 | C4 |
  20. |:---:|:---:|:---:|:---:|:---:|
  21. | | s | s | s | s |
  22. | | s | s | s | s |
  23. | | s | s | s | s |
  24. |__X__| s | s | s | s |
  25. ![single encoder](https://i.imgur.com/8ZPz1gFl.jpg)
  26. ### Dual-Encoder Bottom
  27. One dual-encoder configuration has encoders in the bottom two corners of the 4x4 grid, and switches in the rest of the grid. The socket in column 0 is left empty.
  28. | C0 | C1 | C2 | C3 | C4 |
  29. |:---:|:---:|:---:|:---:|:---:|
  30. | | s | s | s | s |
  31. | | s | s | s | s |
  32. | | s | s | s | s |
  33. | |__X__| s | s |__X__|
  34. ![dual-encoder bottom](https://i.imgur.com/QCqKDMSl.jpg)
  35. ### Dual-Encoder Top
  36. Another dual-encoder configuration has encoders in the top two corners of the 4x4 grid, and switches in the rest of the grid. The socket in column 0 is left empty.
  37. | C0 | C1 | C2 | C3 | C4 |
  38. |:---:|:---:|:---:|:---:|:---:|
  39. | |__X__| s | s |__X__|
  40. | | s | s | s | s |
  41. | | s | s | s | s |
  42. | | s | s | s | s |
  43. ![dual-encoder top](https://i.imgur.com/Rq6ox2Ol.jpg)
  44. ### No-Encoder
  45. You may also choose not to use any rotary encoders if you like!
  46. ### Bill Of Materials
  47. - Cherry-style mechanical switches
  48. - EC11 rotary encoder with pushbutton (7-pin) - one or two depending on your desired configuration
  49. - 1n4148 diodes (thru hole) - one per switch and rotary encoder (if using clickable encoder(s))
  50. - 1x Arduino Pro Micro or pin-compatible ATmega32u4-based MCU
  51. - (optional) 3x 3mm LEDs
  52. - (optional) 3x 330 ohm resistors (for limiting current in LEDs)
  53. - (optional) 6mm SPST switch for resetting MCU
  54. * Keyboard Maintainer: [imchipwood](https://github.com/imchipwood)
  55. * Hardware repository: [dumbpad on github](https://github.com/imchipwood/dumbpad)
  56. * PCB Revisions Supported: v1.0_dual
  57. Make example for this keyboard (after setting up your build environment):
  58. make dumbpad/v1x_dualencoder:default
  59. 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).