184 lines
8.2 KiB
Markdown
184 lines
8.2 KiB
Markdown
# M Juma Planck Layout
|
||
|
||
## Layers
|
||
|
||
```ascii
|
||
Keymap: 32 Layers Layer: action code matrix
|
||
----------------- ---------------------
|
||
stack of layers array_of_action_code[row][column]
|
||
____________ precedence _______________________
|
||
/ / | high / ESC / F1 / F2 / F3 ....
|
||
31 /___________// | /-----/-----/-----/-----
|
||
30 /___________// | / TAB / Q / W / E ....
|
||
29 /___________/ | /-----/-----/-----/-----
|
||
: _:_:_:_:_:__ | : /LCtrl/ A / S / D ....
|
||
: / : : : : : / | : / : : : :
|
||
2 /___________// | 2 `--------------------------
|
||
1 /___________// | 1 `--------------------------
|
||
0 /___________/ V low 0 `--------------------------
|
||
```
|
||
|
||
### Qwerty
|
||
|
||
```ascii
|
||
,-----------------------------------------------------------------------------------.
|
||
| Tab | Q | W | E | R | T | Y | U | I | O | P | Bksp |
|
||
|------+------+------+------+------+-------------+------+------+------+------+------|
|
||
| GEsc | A | S | D | F | G | H | J | K | L | ; | " |
|
||
|------+------+------+------+------+------|------+------+------+------+------+------|
|
||
| Shift| Z | X | C | V | B | N | M | , | . | / |Enter |
|
||
|------+------+------+------+------+------+------+------+------+------+------+------|
|
||
| Ctrl | FN | GUI | Alt |Lower | Space FN |Raise | Left | Down | Up |Right |
|
||
`-----------------------------------------------------------------------------------'
|
||
```
|
||
|
||
#### Qwerty Layer Features
|
||
|
||
- [Grave Escape](https://docs.qmk.fm/#/feature_grave_esc)
|
||
- [Tap Dance](https://docs.qmk.fm/#/feature_tap_dance) Left Shift
|
||
- Tap => Shift
|
||
- Double Tap => Capslock
|
||
- [Mod-Tap](https://docs.qmk.fm/#/mod_tap) Enter
|
||
- Tap => Enter
|
||
- Hold => Right Shift
|
||
- [Layer Toggle](https://docs.qmk.fm/#/feature_layers) Space
|
||
- Tap => Space
|
||
- Hold => Activate ***Space Function*** Layer
|
||
|
||
### Raise
|
||
|
||
```ascii
|
||
,-----------------------------------------------------------------------------------.
|
||
| ` | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 0 | Bksp |
|
||
|------+------+------+------+------+-------------+------+------+------+------+------|
|
||
| | | | | | | * | 4 | 5 | 6 | - | \ |
|
||
|------+------+------+------+------+------|------+------+------+------+------+------|
|
||
| | | | | | | / | 1 | 2 | 3 | + |Enter |
|
||
|------+------+------+------+------+------+------+------+------+------+------+------|
|
||
| | | | | | Space | | 0 | . | = | |
|
||
`-----------------------------------------------------------------------------------'
|
||
```
|
||
|
||
### Lower
|
||
|
||
```ascii
|
||
,-----------------------------------------------------------------------------------.
|
||
| ~ | ! | @ | # | $ | % | ^ | & | * | ( | ) | Bksp |
|
||
|------+------+------+------+------+-------------+------+------+------+------+------|
|
||
| | | | / | { | [ | ] | } | \ | - | = | | |
|
||
|------+------+------+------+------+------|------+------+------+------+------+------|
|
||
| | | | | | | | | | _ | + |Enter |
|
||
|------+------+------+------+------+------+------+------+------+------+------+------|
|
||
| | | | | | Space | | Home | PgDn | PgUp | End |
|
||
`-----------------------------------------------------------------------------------'
|
||
```
|
||
|
||
### Function
|
||
|
||
```ascii
|
||
,-----------------------------------------------------------------------------------.
|
||
| | F1 | F2 | F3 | F4 | F5 | F6 | F7 | F8 | F9 | F10 | Del |
|
||
|------+------+------+------+------+-------------+------+------+------+------+------|
|
||
| | F11 | F12 | F13 | F14 | F15 | |INSERT| Home | PgUp | | |
|
||
|------+------+------+------+------+------|------+------+------+------+------+------|
|
||
| | | | | | | |DELETE| End | PgDn | | Enter|
|
||
|------+------+------+------+------+------+------+------+------+------+------+------|
|
||
| | | | | | Space | | | | | |
|
||
`-----------------------------------------------------------------------------------'
|
||
```
|
||
|
||
### Space Function
|
||
|
||
```ascii
|
||
,------------------------------------------------------------------------------------.
|
||
|PRNT SC| | UP | | | | | | | | | |
|
||
|-------+------+------+------+------+-------------+------+------+------+------+------|
|
||
| | LEFT | DOWN | RIGHT| | | LEFT | DOWN | UP | RIGHT| | |
|
||
|-------+------+------+------+------+------|------+------+------+------+------+------|
|
||
| |ALT+1 |ALT+2 |ALT+3 |ALT+4 |ALT+5 |ALT+6 |ALT+7 |ALT+8 |ALT+9 |ALT+10| |
|
||
|-------+------+------+------+------+------+------+------+------+------+------+------|
|
||
| | | | |VOLDWN| |VOL UP| PREV | MUTE |PLY/PS| NEXT |
|
||
`------------------------------------------------------------------------------------'
|
||
```
|
||
|
||
### Gaming
|
||
|
||
```ascii
|
||
,-----------------------------------------------------------------------------------.
|
||
| Tab | Q | W | E | R | T | Y | U | I | O | P | Bksp |
|
||
|------+------+------+------+------+-------------+------+------+------+------+------|
|
||
| Esc | A | S | D | F | G | H | J | K | L | ; | " |
|
||
|------+------+------+------+------+------|------+------+------+------+------+------|
|
||
| Shift| Z | X | C | V | B | N | M | , | . | / |Enter |
|
||
|------+------+------+------+------+------+------+------+------+------+------+------|
|
||
| Ctrl | FN | GUI | Alt |Lower | Space |Raise | Left | Down | Up |Right |
|
||
`-----------------------------------------------------------------------------------'
|
||
```
|
||
|
||
### Adjust (Lower + Raise)
|
||
|
||
```ascii
|
||
,-----------------------------------------------------------------------------------.
|
||
| |RESET |Debug | | | | |DMREC1|DMREC2| | | |
|
||
|------+------+------+------+------+-------------+------+------+------+------+------|
|
||
| |GAMING| | | | | |DMPLY1|DMPLY2|Audoff|Aud on| |
|
||
|------+------+------+------+------+------|------+------+------+------+------+------|
|
||
| | | | | | | |DMRSTP| |Musoff|Mus on|MusMod|
|
||
|------+------+------+------+------+------+------+------+------+------+------+------|
|
||
| | | |AG_TOG| | | | |Voice-|Voice+| |
|
||
`-----------------------------------------------------------------------------------'
|
||
```
|
||
|
||
#### Adjust Layer Features
|
||
|
||
```text
|
||
RESET: Put the keyboard into bootloader mode for flashing
|
||
Debug: Toggle debug mode
|
||
EE_CLR: Reinitializes the keyboard’s EEPROM (persistent memory)
|
||
|
||
AG_TOG: Toggle Alt and GUI swap on both sides (Mac)
|
||
|
||
DM_REC1: Start recording Macro 1
|
||
DM_REC2: Start recording Macro 2
|
||
DM_PLY1: Replay Macro 1
|
||
DM_PLY2: Replay Macro 2
|
||
DM_RSTP: Finish the macro that is currently being recorded.
|
||
|
||
AU_ON: Audio mode on
|
||
AU_OFF: Audio mode off
|
||
AU_TOGG: Toggles Audio mode
|
||
MU_ON: Turn music mode on
|
||
MU_OFF: Turn music mode off
|
||
MU_TOGG: Toggle music mode
|
||
MU_NEXT: Cycle through the music modes:
|
||
CHROMATIC_MODE: Chromatic scale, row changes the octave
|
||
GUITAR_MODE: Chromatic scale, but the row changes the string (+5 st)
|
||
VIOLIN_MODE: Chromatic scale, but the row changes the string (+7 st)
|
||
MAJOR_MODE: Major scale
|
||
|
||
In Music Mode:
|
||
LCTL: start a recording
|
||
LALT: stop recording/stop playing
|
||
LGUI: play recording
|
||
KC_UP: speed-up playback
|
||
KC_DOWN: slow-down playback
|
||
```
|
||
|
||
## Compilation
|
||
|
||
Use the docker image to compile this keyboard layout by running the following from the root of the repo:
|
||
|
||
```sh
|
||
util/docker_build.sh planck/rev6:mjuma
|
||
```
|
||
|
||
## Flashing
|
||
|
||
Flashing on linux can be done through the docker image
|
||
|
||
```sh
|
||
sudo util/docker_build.sh planck/rev6:mjuma:flash
|
||
```
|
||
|
||
or on Windows using the [QMK Toolbox](https://github.com/qmk/qmk_toolbox)
|