qmk_sweep_skeletyl/keyboards/planck/rev7
2024-02-18 21:17:15 +11:00
..
keymaps/default Remove userspace keymaps (#22544) 2023-11-27 05:36:45 +11:00
chconf.h Adds Planck Rev 7 & Updates rev6_drop to Matrix Lite Implementation (#21175) 2023-06-08 21:46:09 -04:00
config.h Migrate RGB Matrix config to info.json - NOPQ (#22866) 2024-01-10 09:55:09 +00:00
halconf.h Adds Planck Rev 7 & Updates rev6_drop to Matrix Lite Implementation (#21175) 2023-06-08 21:46:09 -04:00
info.json Add encoder abstraction. (#21548) 2024-02-18 21:17:15 +11:00
matrix.c Add encoder abstraction. (#21548) 2024-02-18 21:17:15 +11:00
mcuconf.h Adds Planck Rev 7 & Updates rev6_drop to Matrix Lite Implementation (#21175) 2023-06-08 21:46:09 -04:00
readme.md Planck Matrix Fixes (#21196) 2023-06-20 20:32:32 -04:00
rev7.c Adds Planck Rev 7 & Updates rev6_drop to Matrix Lite Implementation (#21175) 2023-06-08 21:46:09 -04:00
rules.mk Remove LAYOUTS_HAS_RGB (#22917) 2024-01-18 23:07:54 +00:00

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

  • Keyboard Maintainer: Jack Humbert
  • Hardware Supported: Planck PCB rev7
  • Hardware Availability: Drop

Make example for this keyboard (after setting up your build environment):

make planck/rev7:default

See the build environment setup and the make instructions for more information. Brand new to QMK? Start with our Complete Newbs Guide.

Encoders

Encoders must 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(uint8_t index, bool 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. The encoder map feature is not currently supported.

Some Planck-specific config.h options:

// sets the length (in seconds) of the watchdog timer, which will reset the keyboard due to hang/crash in the code
#define PLANCK_WATCHDOG_TIMEOUT 1.0
// disables the watchdog timer - you may want to disable the watchdog timer if you use longer macros
#define PLANCK_WATCHDOG_DISABLE
// the resolution of the encoders used in the encoder matrix
#define PLANCK_ENCODER_RESOLUTION 4