|
|
- # 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
- EEP_RST: 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_TOG: Toggles Audio mode
- MU_ON: Turn music mode on
- MU_OFF: Turn music mode off
- MU_TOG: Toggle music mode
- MU_MOD: 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)
|