Add smt keymap for Clueboard (HHKB-style layout) (#1286)
* Add keymap for smt Clueboard (HHKB layout) * Add readme for smt Clueboard (HHKB) keymap * Flesh out the keymap a bit more to support Colemak & Dvorak * Update README with layout image
This commit is contained in:
		
							parent
							
								
									153eb95ab2
								
							
						
					
					
						commit
						9a8904a9c0
					
				
					 3 changed files with 211 additions and 0 deletions
				
			
		
							
								
								
									
										181
									
								
								keyboards/clueboard/keymaps/smt/keymap.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										181
									
								
								keyboards/clueboard/keymaps/smt/keymap.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,181 @@
 | 
			
		|||
#include "clueboard.h"
 | 
			
		||||
 | 
			
		||||
// Each layer gets a name for readability, which is then used in the keymap matrix below.
 | 
			
		||||
// The underscores don't mean anything - you can have a layer called STUFF or any other name.
 | 
			
		||||
// Layer names don't all need to be of the same length, obviously, and you can also skip them
 | 
			
		||||
// entirely and just use numbers.
 | 
			
		||||
#define _QWERTY 0
 | 
			
		||||
#define _COLEMAK 1
 | 
			
		||||
#define _DVORAK 2
 | 
			
		||||
#define _FL 3
 | 
			
		||||
#define _CL 4
 | 
			
		||||
 | 
			
		||||
enum planck_keycodes {
 | 
			
		||||
  QWERTY = SAFE_RANGE,
 | 
			
		||||
  COLEMAK,
 | 
			
		||||
  DVORAK
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
// Helpful defines
 | 
			
		||||
#define _______ KC_TRNS
 | 
			
		||||
#define XXXXXXX KC_NO
 | 
			
		||||
#define GRAVE_MODS  (MOD_BIT(KC_LSHIFT)|MOD_BIT(KC_RSHIFT)|MOD_BIT(KC_LGUI)|MOD_BIT(KC_RGUI)|MOD_BIT(KC_LALT)|MOD_BIT(KC_RALT))
 | 
			
		||||
 | 
			
		||||
// Custom macros
 | 
			
		||||
#define CTL_ESC     CTL_T(KC_ESC)               // Tap for Esc, hold for Ctrl
 | 
			
		||||
#define HPR_TAB     ALL_T(KC_TAB)               // Tap for Tab, hold for Hyper (Super+Ctrl+Shift+Alt)
 | 
			
		||||
#define SFT_ENT     SFT_T(KC_ENT)               // Tap for Enter, hold for Shift
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
 | 
			
		||||
  /* Keymap _QWERTY: Base Layer (Default Layer)
 | 
			
		||||
   * ,-----------------------------------------------------------.  ,---.
 | 
			
		||||
   * |Esc|  1|  2|  3|  4|  5|  6|  7|  8|  9|  0|  -|  =|  \|  `|  |PgU|
 | 
			
		||||
   * |-----------------------------------------------------------|  |---|
 | 
			
		||||
   * |HpTab|  Q|  W|  E|  R|  T|  Y|  U|  I|  O|  P|  [|  ]|   BS|  |PgD|
 | 
			
		||||
   * |-----------------------------------------------------------|  `---'
 | 
			
		||||
   * |CtlEsc|  A|  S|  D|  F|  G|  H|  J|  K|  L|  ;|  '|   | Ent|
 | 
			
		||||
   * |--------------------------------------------------------------.
 | 
			
		||||
   * |Shift|  |  Z|  X|  C|  V|  B|  N|  M|  ,|  .|  /|Shift| Fn| Up|
 | 
			
		||||
   * |------------------------------------------------------------------.
 | 
			
		||||
   * |Ctrl|Gui|Alt |    | Space| Space|    |Alt |Gui |Ctrl|Left|Down|Rgt|
 | 
			
		||||
   * `------------------------------------------------------------------'
 | 
			
		||||
   */
 | 
			
		||||
[_QWERTY] = KEYMAP(
 | 
			
		||||
  F(0),    KC_1,    KC_2,   KC_3,   KC_4,   KC_5,   KC_6,   KC_7,   KC_8,   KC_9,    KC_0,     KC_MINS,  KC_EQL,   KC_BSLS, KC_GRV,           KC_PGUP, \
 | 
			
		||||
  HPR_TAB, KC_Q,    KC_W,   KC_E,   KC_R,   KC_T,   KC_Y,   KC_U,   KC_I,   KC_O,    KC_P,     KC_LBRC,  KC_RBRC,  KC_BSPC,                   KC_PGDN, \
 | 
			
		||||
  CTL_ESC, KC_A,    KC_S,   KC_D,   KC_F,   KC_G,   KC_H,   KC_J,   KC_K,   KC_L,    KC_SCLN,  KC_QUOT,  XXXXXXX,  KC_ENT,                             \
 | 
			
		||||
  KC_LSFT, XXXXXXX, KC_Z,   KC_X,   KC_C,   KC_V,   KC_B,   KC_N,   KC_M,   KC_COMM, KC_DOT,   KC_SLSH,  SFT_ENT,  MO(_FL),          KC_UP,            \
 | 
			
		||||
  KC_LCTL, KC_LGUI, KC_LALT, XXXXXXX,          KC_SPC,KC_SPC,                        XXXXXXX,  KC_RALT,  KC_RGUI,  KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
 | 
			
		||||
 | 
			
		||||
  /* Keymap _COLEMAK: Base Layer
 | 
			
		||||
   * ,-----------------------------------------------------------.  ,---.
 | 
			
		||||
   * |Esc|  1|  2|  3|  4|  5|  6|  7|  8|  9|  0|  -|  =|  \|  `|  |PgU|
 | 
			
		||||
   * |-----------------------------------------------------------|  |---|
 | 
			
		||||
   * |HpTab|  Q|  W|  F|  P|  G|  J|  L|  U|  Y|  ;|  [|  ]|   BS|  |PgD|
 | 
			
		||||
   * |-----------------------------------------------------------|  `---'
 | 
			
		||||
   * |CtlEsc|  A|  R|  S|  T|  D|  H|  N|  E|  I|  O|  '|   | Ent|
 | 
			
		||||
   * |--------------------------------------------------------------.
 | 
			
		||||
   * |Shift|  |  Z|  X|  C|  V|  B|  K|  M|  ,|  .|  /|Shift| Fn| Up|
 | 
			
		||||
   * |------------------------------------------------------------------.
 | 
			
		||||
   * |Ctrl|Gui|Alt |    | Space| Space|    |Alt |Gui |Ctrl|Left|Down|Rgt|
 | 
			
		||||
   * `------------------------------------------------------------------'
 | 
			
		||||
   */
 | 
			
		||||
[_COLEMAK] = KEYMAP(
 | 
			
		||||
  F(0),    KC_1,    KC_2,   KC_3,   KC_4,   KC_5,   KC_6,   KC_7,   KC_8,   KC_9,    KC_0,     KC_MINS,  KC_EQL,   KC_BSLS, KC_GRV,           KC_PGUP, \
 | 
			
		||||
  HPR_TAB, KC_Q,    KC_W,   KC_F,   KC_P,   KC_G,   KC_J,   KC_L,   KC_U,   KC_Y,    KC_SCLN,  KC_LBRC,  KC_RBRC,  KC_BSPC,                   KC_PGDN, \
 | 
			
		||||
  CTL_ESC, KC_A,    KC_R,   KC_S,   KC_T,   KC_D,   KC_H,   KC_N,   KC_E,   KC_I,    KC_O,     KC_QUOT,  XXXXXXX,  KC_ENT,                             \
 | 
			
		||||
  KC_LSFT, XXXXXXX, KC_Z,   KC_X,   KC_C,   KC_V,   KC_B,   KC_K,   KC_M,   KC_COMM, KC_DOT,   KC_SLSH,  SFT_ENT,  MO(_FL),          KC_UP,            \
 | 
			
		||||
  KC_LCTL, KC_LGUI, KC_LALT, XXXXXXX,          KC_SPC,KC_SPC,                        XXXXXXX,  KC_RALT,  KC_RGUI,  KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
 | 
			
		||||
 | 
			
		||||
  /* Keymap _DVORAK: Base Layer
 | 
			
		||||
   * ,-----------------------------------------------------------.  ,---.
 | 
			
		||||
   * |Esc|  1|  2|  3|  4|  5|  6|  7|  8|  9|  0|  [|  ]|  \|  `|  |PgU|
 | 
			
		||||
   * |-----------------------------------------------------------|  |---|
 | 
			
		||||
   * |HpTab|  '|  ,|  .|  P|  Y|  F|  G|  C|  R|  L|  /|  =|   BS|  |PgD|
 | 
			
		||||
   * |-----------------------------------------------------------|  `---'
 | 
			
		||||
   * |CtlEsc|  A|  O|  E|  U|  I|  D|  H|  T|  N|  S|  -|   | Ent|
 | 
			
		||||
   * |--------------------------------------------------------------.
 | 
			
		||||
   * |Shift|  |  ;|  Q|  J|  K|  X|  B|  M|  W|  V|  Z|Shift| Fn| Up|
 | 
			
		||||
   * |------------------------------------------------------------------.
 | 
			
		||||
   * |Ctrl|Gui|Alt |    | Space| Space|    |Alt |Gui |Ctrl|Left|Down|Rgt|
 | 
			
		||||
   * `------------------------------------------------------------------'
 | 
			
		||||
   */
 | 
			
		||||
[_DVORAK] = KEYMAP(
 | 
			
		||||
  F(0),    KC_1,    KC_2,   KC_3,   KC_4,   KC_5,   KC_6,   KC_7,   KC_8,   KC_9,    KC_0,     KC_LBRC,  KC_RBRC,  KC_BSLS, KC_GRV,           KC_PGUP, \
 | 
			
		||||
  HPR_TAB, KC_QUOT, KC_COMM,KC_DOT, KC_P,   KC_Y,   KC_F,   KC_G,   KC_C,   KC_R,    KC_L,     KC_SLSH,  KC_EQL,   KC_BSPC,                   KC_PGDN, \
 | 
			
		||||
  CTL_ESC, KC_A,    KC_O,   KC_E,   KC_U,   KC_I,   KC_D,   KC_H,   KC_T,   KC_N,    KC_S,     KC_MINS,  XXXXXXX,  KC_ENT,                             \
 | 
			
		||||
  KC_LSFT, XXXXXXX, KC_SCLN,KC_Q,   KC_J,   KC_K,   KC_X,   KC_B,   KC_M,   KC_W,    KC_V,     KC_Z,     SFT_ENT,  MO(_FL),          KC_UP,            \
 | 
			
		||||
  KC_LCTL, KC_LGUI, KC_LALT, XXXXXXX,          KC_SPC,KC_SPC,                        XXXXXXX,  KC_RALT,  KC_RGUI,  KC_RCTL, KC_LEFT, KC_DOWN, KC_RGHT),
 | 
			
		||||
 | 
			
		||||
  /* Keymap _FL: Function Layer
 | 
			
		||||
   */
 | 
			
		||||
[_FL] = KEYMAP(
 | 
			
		||||
  KC_GRV,  KC_F1,   KC_F2,  KC_F3,  KC_F4,  KC_F5,  KC_F6,  KC_F7,  KC_F8,  KC_F9,   KC_F10,   KC_F11,   KC_F12,   _______, _______,          BL_STEP, \
 | 
			
		||||
  _______, _______, _______,_______,_______,_______,_______,_______,KC_PSCR,KC_SLCK, KC_PAUS,  _______,  _______,  KC_DEL,                    _______, \
 | 
			
		||||
  _______, _______, MO(_CL),_______,_______,_______,_______,_______,_______,_______, _______,  _______,  _______,  _______,                            \
 | 
			
		||||
  _______, _______, _______,_______,_______,_______,_______,_______,_______,_______, _______,  _______,  _______,  MO(_FL),          KC_PGUP,          \
 | 
			
		||||
  _______, _______, _______, _______,        _______,_______,                        _______,  _______,  _______,  _______, KC_HOME, KC_PGDN, KC_END),
 | 
			
		||||
 | 
			
		||||
  /* Keymap _CL: Control layer
 | 
			
		||||
   */
 | 
			
		||||
[_CL] = KEYMAP(
 | 
			
		||||
  _______, _______, _______,_______,_______,_______,_______,_______,_______,_______, _______,  _______,  _______,  _______, RGB_TOG,          RGB_VAI, \
 | 
			
		||||
  _______, _______, _______,_______,RESET,  _______,_______,QWERTY, COLEMAK,DVORAK,  _______,  _______,  _______,  _______,                   RGB_VAD, \
 | 
			
		||||
  _______, _______, MO(_CL),_______,_______,_______,_______,_______,_______,_______, _______,  _______,  _______,  _______,                            \
 | 
			
		||||
  MO(_FL), _______, _______,_______,_______,_______,_______,_______,_______,_______, _______,  _______,  _______,  MO(_FL),          RGB_SAI,          \
 | 
			
		||||
  _______, _______, _______,_______,         RGB_MOD,RGB_MOD,                        _______,  _______,  _______,  _______, RGB_HUD, RGB_SAD, RGB_HUI),
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/* This is a list of user defined functions. F(N) corresponds to item N
 | 
			
		||||
   of this list.
 | 
			
		||||
 */
 | 
			
		||||
const uint16_t PROGMEM fn_actions[] = {
 | 
			
		||||
  [0] = ACTION_FUNCTION(0),  // Calls action_function()
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
void action_function(keyrecord_t *record, uint8_t id, uint8_t opt) {
 | 
			
		||||
  static uint8_t mods_pressed;
 | 
			
		||||
  static bool mod_flag;
 | 
			
		||||
 | 
			
		||||
  switch (id) {
 | 
			
		||||
    case 0:
 | 
			
		||||
      /* Handle the combined Grave/Esc key
 | 
			
		||||
       */
 | 
			
		||||
      mods_pressed = get_mods()&GRAVE_MODS; // Check to see what mods are pressed
 | 
			
		||||
 | 
			
		||||
      if (record->event.pressed) {
 | 
			
		||||
        /* The key is being pressed.
 | 
			
		||||
         */
 | 
			
		||||
        if (mods_pressed) {
 | 
			
		||||
          mod_flag = true;
 | 
			
		||||
          add_key(KC_GRV);
 | 
			
		||||
          send_keyboard_report();
 | 
			
		||||
        } else {
 | 
			
		||||
          add_key(KC_ESC);
 | 
			
		||||
          send_keyboard_report();
 | 
			
		||||
        }
 | 
			
		||||
      } else {
 | 
			
		||||
        /* The key is being released.
 | 
			
		||||
         */
 | 
			
		||||
        if (mod_flag) {
 | 
			
		||||
          mod_flag = false;
 | 
			
		||||
          del_key(KC_GRV);
 | 
			
		||||
          send_keyboard_report();
 | 
			
		||||
        } else {
 | 
			
		||||
          del_key(KC_ESC);
 | 
			
		||||
          send_keyboard_report();
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
      break;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
void persistant_default_layer_set(uint16_t default_layer) {
 | 
			
		||||
  eeconfig_update_default_layer(default_layer);
 | 
			
		||||
  default_layer_set(default_layer);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
bool process_record_user(uint16_t keycode, keyrecord_t *record) {
 | 
			
		||||
  switch (keycode) {
 | 
			
		||||
    case QWERTY:
 | 
			
		||||
      if (record->event.pressed) {
 | 
			
		||||
        persistant_default_layer_set(1UL<<_QWERTY);
 | 
			
		||||
      }
 | 
			
		||||
      return false;
 | 
			
		||||
      break;
 | 
			
		||||
    case COLEMAK:
 | 
			
		||||
      if (record->event.pressed) {
 | 
			
		||||
        persistant_default_layer_set(1UL<<_COLEMAK);
 | 
			
		||||
      }
 | 
			
		||||
      return false;
 | 
			
		||||
      break;
 | 
			
		||||
    case DVORAK:
 | 
			
		||||
      if (record->event.pressed) {
 | 
			
		||||
        persistant_default_layer_set(1UL<<_DVORAK);
 | 
			
		||||
      }
 | 
			
		||||
      return false;
 | 
			
		||||
      break;
 | 
			
		||||
  }
 | 
			
		||||
  return true;
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										
											BIN
										
									
								
								keyboards/clueboard/keymaps/smt/layout.png
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										
											BIN
										
									
								
								keyboards/clueboard/keymaps/smt/layout.png
									
										
									
									
									
										Normal file
									
								
							
										
											Binary file not shown.
										
									
								
							| 
		 After Width: | Height: | Size: 128 KiB  | 
							
								
								
									
										30
									
								
								keyboards/clueboard/keymaps/smt/readme.md
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										30
									
								
								keyboards/clueboard/keymaps/smt/readme.md
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,30 @@
 | 
			
		|||
```
 | 
			
		||||
 ___     _____ _            _                         _     __    __ _   __
 | 
			
		||||
|__ \   / ____| |          | |                       | |   / /   / /(_) / /
 | 
			
		||||
 ||) | | |    | |_   _  ___| |__   ___   __ _ _ __ __| |  / /_  / /_   / /
 | 
			
		||||
 |/ /  | |    | | | | |/ _ \ '_ \ / _ \ / _` | '__/ _` | | '_ \| '_ \ / /
 | 
			
		||||
 |_|   | |____| | |_| |  __/ |_) | (_) | (_| | | | (_| | | (_) | (_) / / _
 | 
			
		||||
 (_)    \_____|_|\__,_|\___|_.__/ \___/ \__,_|_|  \__,_|  \___/ \___/_/ (_)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
# smt Clueboard Layout (HHKB variant)
 | 
			
		||||
 | 
			
		||||

 | 
			
		||||
 | 
			
		||||
This is smt's HHKB variant layout, based on the default layout that comes
 | 
			
		||||
flashed on every Clueboard. The primary differences from the default are:
 | 
			
		||||
 | 
			
		||||
- The Backspace key is moved down into the traditional `\` position
 | 
			
		||||
- `\` and `` ` `` are assigned to the "split-backspace" positions
 | 
			
		||||
- The right Shift is split to allow for a Fn key to its right
 | 
			
		||||
- The modifiers on the right side now mirror the left side (`Alt`/`Super`/`Ctrl`)
 | 
			
		||||
 | 
			
		||||
For the most part, it's a straightforward and easy to follow layout. There
 | 
			
		||||
are a few special keys:
 | 
			
		||||
 | 
			
		||||
- The Esc key sends `Esc` when tapped, `` ` `` when `Alt`/`Super`/`Ctrl`/`Fn` is held, or `~` when `Shift` is held
 | 
			
		||||
- The Tab key sends `Tab` when tapped, or `Super+Ctrl+Alt+Shift` (a.k.a. [Hyper]) when held
 | 
			
		||||
- The key traditionally in the Caps-Lock position has been re-mapped to send `Esc` when tapped, or `Ctrl` when held
 | 
			
		||||
- The left Shift key sends `Enter` when tapped, or `Shift` when held
 | 
			
		||||
 | 
			
		||||
[Hyper]: http://brettterpstra.com/2012/12/08/a-useful-caps-lock-key/
 | 
			
		||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue