qmk_firmware

QMK firmware for my keyboards (Corne, Sweep Ferris) and trackball (Ploopy Adept)
Log | Files | Refs | Submodules | LICENSE

readme.md (6746B)


      1 # The Default Zygomorph Layout
      2 ## Layout
      3 
      4 ### Base modifier layout
      5 ```
      6    * ,-----------------------------------------.  ,-----------------------------------------.
      7    * | GESC |      |      |      |      |      |  |      |      |      |      |      | BkSp |
      8    * |------+------+------+------+------+------|  |------+------+------+------+------+------|
      9    * | Tab  |      |      |      |      |      |  |      |      |      |      |      |   \  |
     10    * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     11    * |FN(CAPS)|    |      |      |      |      |  |      |      |      |      |      |   '  |
     12    * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     13    * |Shift |      |      |      |      |      |  |      |      |      |      |      |Shift |
     14    * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     15    * | Ctrl |  Win |  Alt |  RGB | ADJ  | Space|  | Space|  FN  | Left | Down | Up   |Right |
     16    * `-----------------------------------------'  `-----------------------------------------'
     17 ```
     18 
     19 ### Qwerty alphas
     20 ```
     21      * ,-----------------------------------------.  ,-----------------------------------------.
     22      * |      |      |      |      |      |      |  |      |      |      |      |      |      |
     23      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     24      * |      |   Q  |   W  |   E  |   R  |   T  |  |   Y  |   U  |   I  |   O  |   P  |      |
     25      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     26      * |      |   A  |   S  |   D  |   F  |   G  |  |   H  |   J  |   K  |   L  |   ;  |      |
     27      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     28      * |      |   Z  |   X  |   C  |   V  |   B  |  |   N  |   M  |   ,  |   .  |   /  |      |
     29      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     30      * |      |      |      |      |      |      |  |      |      |      |      |      |      |
     31      * `-----------------------------------------'  `-----------------------------------------'
     32 ```
     33 
     34 ### Colemak alphas
     35 ```
     36      * ,-----------------------------------------.  ,-----------------------------------------.
     37      * |      |      |      |      |      |      |  |      |      |      |      |      |      |
     38      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     39      * |      |   Q  |   W  |   F  |   P  |   G  |  |   J  |   L  |   U  |   Y  |   ;  |      |
     40      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     41      * |      |   A  |   R  |   S  |   T  |   D  |  |   H  |   N  |   E  |   I  |   O  |      |
     42      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     43      * |      |   Z  |   X  |   C  |   V  |   B  |  |   K  |   M  |   ,  |   .  |   /  |      |
     44      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     45      * |      |      |      |      |      |      |  |      |      |      |      |      |      |
     46      * `-----------------------------------------'  `-----------------------------------------'
     47 ```
     48 
     49 ### Function (FN)
     50 ```
     51      * ,-----------------------------------------.  ,-----------------------------------------.
     52      * |  F1  |  F2  |  F3  |  F4  |  F5  |  F6  |  |  F7  |  F8  |  F9  |  F10 |  F11 |  F12 |
     53      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     54      * |      | PGDN |  UP  | PGUP |      |      |  |      | PGDN |  UP  | PGUP | PRINT| HOME |
     55      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     56      * |      | LEFT | DOWN | RIGHT|      |      |  |      | LEFT | DOWN | RIGHT|INSERT| END  |
     57      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     58      * |      |      |      |      |      |      |  |      |      |      |      |      |      |
     59      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     60      * |      |      |      |RGBMOD|      |      |  |      | PLAY | NEXT | MUTE | VOL- | VOL+ |
     61      * `-----------------------------------------'  `-----------------------------------------'
     62 ```
     63 
     64 ### Adjust (ADJ)
     65 ```
     66      * ,-----------------------------------------.  ,-----------------------------------------.
     67      * |  F1  |  F2  |  F3  |  F4  |  F5  |  F6  |  |  F7  |  F8  |  F9  |  F10 |  F11 |  F12 |
     68      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     69      * |      | SAD  | VAI  | SAI  | QK_BOOT|      |  |      |      |      |      |      |      |
     70      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     71      * |      | HUD  | VAD  | HUI  |RGBRST|      |  |      |QWERTY|COLEMK|      |      |      |
     72      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     73      * |      |      |      |      |      |      |  |      |      |RGBTOG|  HUI |  SAI | VAI  |
     74      * |------+------+------+------+------+------|  |------+------+------+------+------+------|
     75      * |      |      |      |RGBMOD|      |      |  |      |      |RGBRMOD| HUD |  SAD | VAD  |
     76      * `-----------------------------------------'  `-----------------------------------------'
     77 ```
     78 
     79 ## Customize
     80 
     81 see `qmk_firmware/keyboards/zygomorph/rev1/keymaps/default/rules.mk`
     82 
     83 ```
     84 
     85 # Variables you can set for Zygomorph
     86 
     87 BOOTMAGIC_ENABLE = no       # Enable Bootmagic Lite
     88 MOUSEKEY_ENABLE = no        # Mouse keys(+4700)
     89 EXTRAKEY_ENABLE = yes       # Audio control and System control(+450)
     90 CONSOLE_ENABLE = yes        # Console for debug(+400)
     91 COMMAND_ENABLE = no         # Commands for debug and configuration
     92 NKRO_ENABLE = no
     93 RGBLIGHT_ENABLE = yes       # Enable global lighting effects. Do not enable with RGB Matrix
     94 RGB_MATRIX_ENABLE = no      # Enable per-key coordinate based RGB effects. Do not enable with RGBlight (+8500)
     95 RGB_MATRIX_KEYPRESSES = no  # Enable reactive per-key effects. Can be very laggy (+1500)
     96 RGBLIGHT_FULL_POWER = yes   # Allow maximum RGB brightness. Otherwise, limited to a safe level for a normal USB-A port
     97 SWAP_HANDS_ENABLE = no      # Enable one-hand typing
     98 ENCODER_ENABLE = yes        # Enable rotary encoder (+90)
     99 OLED_ENABLE = yes
    100 IOS_DEVICE_ENABLE = no      # Limit max brightness to connect to IOS device (iPad,iPhone)
    101 ```
    102 ## Compile
    103 
    104 go to qmk top directory.
    105 ```
    106 $ cd qmk_firmware
    107 ```
    108 
    109 build
    110 ```
    111 $ make rgbkb/zygomorph:default
    112 ```
    113 
    114 After the initial flash with AVRdudess, you should be able to flash using this:
    115 ```
    116 $ make rgbkb/zygomorph:default:dfu
    117 ```