summaryrefslogtreecommitdiffstats
path: root/keyboards/planck/rev7/readme.md
diff options
context:
space:
mode:
authorQMK Bot <hello@qmk.fm>2023-06-09 01:46:47 +0000
committerQMK Bot <hello@qmk.fm>2023-06-09 01:46:47 +0000
commit4c60ebdbe0560d40cdcbfde8688cafc6a83c899d (patch)
tree3cdc175295e23ad6231271fa741c952556f446c5 /keyboards/planck/rev7/readme.md
parent806b61c2f71c085de73a93493a6624b5699d63cc (diff)
parent232281946d1baab9db4da3f5f6da210792c4c184 (diff)
Merge remote-tracking branch 'origin/master' into develop
Diffstat (limited to 'keyboards/planck/rev7/readme.md')
-rw-r--r--keyboards/planck/rev7/readme.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/keyboards/planck/rev7/readme.md b/keyboards/planck/rev7/readme.md
new file mode 100644
index 0000000000..f41ec9afd5
--- /dev/null
+++ b/keyboards/planck/rev7/readme.md
@@ -0,0 +1,31 @@
+# Planck
+
+A compact 40% (12x4) ortholinear keyboard kit designed by OLKB and sold by Drop. A complete hardware rework of the rev6 Planck PCB, with support for up to 8 rotary encoders. [More info on qmk.fm](http://qmk.fm/planck/)
+
+* Keyboard Maintainer: [Jack Humbert](https://github.com/jackhumbert)
+* Hardware Supported: Planck PCB rev7
+* Hardware Availability: [Drop](https://drop.com/buy/planck-mechanical-keyboard?mode=guest_open)
+
+Make example for this keyboard (after setting up your build environment):
+
+ make planck/rev7:default
+
+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).
+
+## Encoders
+
+Encoders much have matching pulse & detent resolutions (e.g. 24/24) for the scanning to work properly. Multiple encoders can be used at the same time, and are zero-indexed (compared to being one-indexed on the PCB's silkscreen) in the `encoder_update_user(index, clockwise)` function:
+
+```
+,-----------------------------------------------------------------------------------.
+| 0 | | | | | | | | | | | 4 |
+|------+------+------+------+------+------+------+------+------+------+------+------|
+| 1 | | | | | | | | | | | 5 |
+|------+------+------+------+------+------+------+------+------+------+------+------|
+| 2 | | | | | | | | | | | 6 |
+|------+------+------+------+------+------+------+------+------+------+------+------|
+| 3 | | | | | | | | | | 7 |
+`-----------------------------------------------------------------------------------'
+```
+
+If an encoder has a switch built-in, it's connected to the key at that location. On the default keymap, each encoder will play its own rising/falling tone sequence when rotated, and will reset the pitch after one second of inactivity. \ No newline at end of file