qmk-firmware/keyboards/planck/keymaps/mjuma/readme.md
Mohammad Juma eda8c94c60
[Keymap] addition for mjuma in keyboards/planck/keymaps (#10885)
* Add planck layout

* switch gaming toggle to TG

* rename readme
2021-01-24 07:46:37 -08:00

8.2 KiB
Raw Blame History

M Juma Planck Layout

Layers

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

,-----------------------------------------------------------------------------------.
| 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

Raise

,-----------------------------------------------------------------------------------.
|   `  |   1  |   2  |   3  |   4  |   5  |   6  |   7  |   8  |   9  |   0  | Bksp |
|------+------+------+------+------+-------------+------+------+------+------+------|
|      |      |      |      |      |      |   *  |   4  |   5  |   6  |   -  |  \   |
|------+------+------+------+------+------|------+------+------+------+------+------|
|      |      |      |      |      |      |   /  |   1  |   2  |   3  |   +  |Enter |
|------+------+------+------+------+------+------+------+------+------+------+------|
|      |      |      |      |      |    Space    |      |   0  |   .  |   =  |      |
`-----------------------------------------------------------------------------------'

Lower

,-----------------------------------------------------------------------------------.
|   ~  |   !  |   @  |   #  |   $  |   %  |   ^  |   &  |   *  |   (  |   )  | Bksp |
|------+------+------+------+------+-------------+------+------+------+------+------|
|      |      |      |   /  |   {  |   [  |   ]  |   }  |   \  |   -  |   =  |  |   |
|------+------+------+------+------+------|------+------+------+------+------+------|
|      |      |      |      |      |      |      |      |      |   _  |   +  |Enter |
|------+------+------+------+------+------+------+------+------+------+------+------|
|      |      |      |      |      |    Space    |      | Home | PgDn | PgUp | End  |
`-----------------------------------------------------------------------------------'

Function

,-----------------------------------------------------------------------------------.
|      |  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

,------------------------------------------------------------------------------------.
|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

,-----------------------------------------------------------------------------------.
| 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)

,-----------------------------------------------------------------------------------.
|      |RESET |DEBUG |      |      |      |      |DMREC1|DMREC2|      |      |      |
|------+------+------+------+------+-------------+------+------+------+------+------|
|      |GAMING|      |      |      |      |      |DMPLY1|DMPLY2|Audoff|Aud on|      |
|------+------+------+------+------+------|------+------+------+------+------+------|
|      |      |      |      |      |      |      |DMRSTP|      |Musoff|Mus on|MusMod|
|------+------+------+------+------+------+------+------+------+------+------+------|
|      |      |      |AG_TOG|      |             |      |      |Voice-|Voice+|      |
`-----------------------------------------------------------------------------------'

Adjust Layer Features

RESET:       Put the keyboard into bootloader mode for flashing
DEBUG:       Toggle debug mode
EEP_RST:     Reinitializes the keyboards 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:

util/docker_build.sh planck/rev6:mjuma

Flashing

Flashing on linux can be done through the docker image

sudo util/docker_build.sh planck/rev6:mjuma:flash

or on Windows using the QMK Toolbox