logo

qmk_firmware

custom branch of QMK firmware git clone https://anongit.hacktivis.me/git/qmk_firmware.git

readme.md (4916B)


  1. # Viet's Kinesis + Pro Micro
  2. July 2020
  3. This work is inspired by `alvicstep`'s solution. Instead of hooking up the Kinesis to a Teensy 2, this one hooks it up to a Pro Micro.
  4. ## Kinesis Board Layout
  5. The following is a reinterpretation of [@chrisandreae](https://github.com/chrisandreae/keyboard-firmware/blob/public/hardware/kinesis.h)'s work.
  6. ### Used Pins
  7. * 8 columns mapped to output pins 21 - 28
  8. * 16 rows mapped to 4 input pins: pin 39 - 36. Rows are traversed by iterating and setting 16 values from 0000 to 1111.
  9. * 4 leds (e.g. capslock) mapped to input pin 1 - 4
  10. * keypad key mapped to pin 5
  11. * program key mapped to pin 6
  12. * `VCC` mapped to pin 40
  13. ### Matrix Configuration
  14. The matrix configuration of the columns and rows on my Advantage is as follows:
  15. | | row 0 | row 1 | row 2 | row 3 | row 4 | row 5 | row 6 | row 7 | row 8 | row 9 | row A | row B | row C | row D | row E | row F |
  16. | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- | ----- |
  17. | col0 | F6 | F8 | F7 | 5% | 4$ | 3# | 2@ | 1! | =+ | | | | | | | |
  18. | col1 | F3 | F5 | F4 | T | R | E | W | Q | Tab | | | | | | | |
  19. | col2 | Esc | F2 | F1 | G | F | D | S | A | CapsLk | | | | | | | |
  20. | col3 | F9 | F11 | F10 | B | V | C | X | Z | LShift | Up | | Down | | [{ | ]} | |
  21. | col4 | F12 | ScrLk | PrtSc | Right | | Left | Insert | ~ | | 6^ | 7& | 8* | | 9( | 0) | -_ |
  22. | col5 | Pause | | | LAlt | | Home | | End | | Y | U | I | | O | P | `\|` |
  23. | col6 | | | | LCtrl | Delete | Bksp | RCtrl | Enter | Space | H | J | K | | L | ;: | '" |
  24. | col7 | | | | | RGUI | | PageUp | | PageDn | N | M | ,< | | .> | /? | RShift |
  25. (this is a modified copy from [@alvicstep](https://github.com/qmk/qmk_firmware/blob/master/keyboards/kinesis/alvicstep/alvicstep.h))
  26. In the code, keypad and program keys are mapped respectively to col0 and col1 of row C, the 12th row.
  27. ### Omitted Pins
  28. There are pins that we currently omit:
  29. * serial eeprom clock line mapped to pin 7
  30. * serial eeprom data line mapped to pin 8
  31. * EEPROM write protect mapped to pin 10.
  32. * foot switch 1 mapped to pin 11
  33. * PS/2 clock mapped to pin 12
  34. * PS/2 data mapped to pin 13
  35. * foot switch 2 mapped to pin 17
  36. * foot switch 3 mapped to pin 15
  37. * audio mapped to pin 32
  38. ### DIP Socket
  39. Here's an ASCII drawing of the 40 pin DIP socket.
  40. ```
  41. DL2 1 40 VCC
  42. DR1 2 39 A
  43. DR2 3 38 B
  44. DL1 4 37 C
  45. KPD 5 36 G
  46. PGM 6 35
  47. SCL 7 34
  48. SDA 8 33
  49. RST 9 32 BUZZ
  50. WP 10 31 EA
  51. FS1 11 30 ALE
  52. CLOCK 12 29 PSEN
  53. DATA 13 28 r8
  54. 14 27 r7
  55. FS3 15 26 r6
  56. 16 25 r5
  57. FS2 17 24 r4
  58. XTAL1 18 23 r3
  59. XTAL2 19 22 r2
  60. GND 20 21 r1
  61. ```
  62. (this is copied from [@wjanssens](https://raw.githubusercontent.com/wjanssens/tmk_keyboard/master/keyboard/kinesis/doc/readme.txt))
  63. ## Pin Mapping to Pro Micro
  64. The following table is ordered by physical Arduino pin order.
  65. | Arduino | Kinesis | Meaning |
  66. | ------- | ------- | ------- |
  67. | D3 | 36 | G |
  68. | D2 | 37 | C |
  69. | GND | | |
  70. | GND | | |
  71. | D1 | 38 | B |
  72. | D0 | 39 | A |
  73. | D4 | 1 | DL2 |
  74. | C6 | 2 | DR1 |
  75. | D7 | 3 | DR2 |
  76. | E6 | 4 | DL1 |
  77. | B4 | 5 | KPD |
  78. | B5 | 6 | PGM |
  79. | B6 | 21 | r1 |
  80. | B2 | 22 | r2 |
  81. | B3 | 23 | r3 |
  82. | B1 | 24 | r4 |
  83. | F7 | 25 | r5 |
  84. | F6 | 26 | r6 |
  85. | F5 | 27 | r7 |
  86. | F4 | 28 | r8 |
  87. | VCC | 40 | |
  88. | RESET | | |
  89. | GND | 20 | |
  90. | RAW | | |
  91. ## Notes
  92. * The rows are multiplexed. Instead of reading them out, one sets the row value and corresponding column values are returned through r1-r8.
  93. * On my keyboard, the keypad and program key have dedicated pins. Since row 12 had no mapping in the physical matrix, there's a code override injects the keypad and program pins to the first two bits in the matrix.
  94. * I've experimented with debouncing approaches. The current setting delivers a snappier feeling than Kinesis's factory default for me.