Add Suspend functions (#3112)
[jackhill/qmk/firmware.git] / quantum / quantum_keycodes.h
CommitLineData
23839b8c 1/* Copyright 2016-2017 Jack Humbert
2 *
3 * This program is free software: you can redistribute it and/or modify
4 * it under the terms of the GNU General Public License as published by
5 * the Free Software Foundation, either version 2 of the License, or
6 * (at your option) any later version.
7 *
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
12 *
13 * You should have received a copy of the GNU General Public License
14 * along with this program. If not, see <http://www.gnu.org/licenses/>.
15 */
d8a608f3
W
16#ifndef QUANTUM_KEYCODES_H
17#define QUANTUM_KEYCODES_H
18
a64ae106
GY
19#ifndef MIDI_ENABLE_STRICT
20#define MIDI_ENABLE_STRICT 0
21#endif
22
23#if !MIDI_ENABLE_STRICT || (defined(MIDI_ENABLE) && defined(MIDI_ADVANCED))
d1fe24ad
GY
24#ifndef MIDI_TONE_KEYCODE_OCTAVES
25#define MIDI_TONE_KEYCODE_OCTAVES 3
26#endif
27#endif
28
6a3c6677
JH
29// Fillers to make layering more clear
30#define _______ KC_TRNS
31#define XXXXXXX KC_NO
32
d8a608f3
W
33enum quantum_keycodes {
34 // Ranges used in shortucuts - not to be used directly
35 QK_TMK = 0x0000,
36 QK_TMK_MAX = 0x00FF,
37 QK_MODS = 0x0100,
38 QK_LCTL = 0x0100,
39 QK_LSFT = 0x0200,
40 QK_LALT = 0x0400,
41 QK_LGUI = 0x0800,
42 QK_RMODS_MIN = 0x1000,
43 QK_RCTL = 0x1100,
44 QK_RSFT = 0x1200,
45 QK_RALT = 0x1400,
46 QK_RGUI = 0x1800,
47 QK_MODS_MAX = 0x1FFF,
48 QK_FUNCTION = 0x2000,
49 QK_FUNCTION_MAX = 0x2FFF,
50 QK_MACRO = 0x3000,
51 QK_MACRO_MAX = 0x3FFF,
52 QK_LAYER_TAP = 0x4000,
53 QK_LAYER_TAP_MAX = 0x4FFF,
54 QK_TO = 0x5000,
55 QK_TO_MAX = 0x50FF,
56 QK_MOMENTARY = 0x5100,
57 QK_MOMENTARY_MAX = 0x51FF,
58 QK_DEF_LAYER = 0x5200,
59 QK_DEF_LAYER_MAX = 0x52FF,
60 QK_TOGGLE_LAYER = 0x5300,
61 QK_TOGGLE_LAYER_MAX = 0x53FF,
62 QK_ONE_SHOT_LAYER = 0x5400,
63 QK_ONE_SHOT_LAYER_MAX = 0x54FF,
64 QK_ONE_SHOT_MOD = 0x5500,
65 QK_ONE_SHOT_MOD_MAX = 0x55FF,
66#ifndef DISABLE_CHORDING
67 QK_CHORDING = 0x5600,
68 QK_CHORDING_MAX = 0x56FF,
69#endif
97816df7
PIN
70 QK_TAP_DANCE = 0x5700,
71 QK_TAP_DANCE_MAX = 0x57FF,
69ea10f9
JH
72 QK_LAYER_TAP_TOGGLE = 0x5800,
73 QK_LAYER_TAP_TOGGLE_MAX = 0x58FF,
7a5ce36f 74 QK_LAYER_MOD = 0x5900,
75 QK_LAYER_MOD_MAX = 0x59FF,
5987f679 76#ifdef STENO_ENABLE
e81e75c1
JW
77 QK_STENO = 0x5A00,
78 QK_STENO_BOLT = 0x5A30,
79 QK_STENO_GEMINI = 0x5A31,
80 QK_STENO_MAX = 0x5A3F,
23ac2a02
JW
81#endif
82#ifdef SWAP_HANDS_ENABLE
83 QK_SWAP_HANDS = 0x5B00,
84 QK_SWAP_HANDS_MAX = 0x5BFF,
5987f679 85#endif
97816df7
PIN
86 QK_MOD_TAP = 0x6000,
87 QK_MOD_TAP_MAX = 0x7FFF,
6788cbd7
JH
88#if defined(UNICODEMAP_ENABLE) && defined(UNICODE_ENABLE)
89 #error "Cannot enable both UNICODEMAP && UNICODE"
90#endif
d8a608f3
W
91#ifdef UNICODE_ENABLE
92 QK_UNICODE = 0x8000,
93 QK_UNICODE_MAX = 0xFFFF,
94#endif
69ea10f9
JH
95#ifdef UNICODEMAP_ENABLE
96 QK_UNICODE_MAP = 0x8000,
97 QK_UNICODE_MAP_MAX = 0x83FF,
98#endif
d8a608f3
W
99
100 // Loose keycodes - to be used directly
101
b92515f1 102 RESET = 0x5C00,
d8a608f3
W
103 DEBUG,
104 MAGIC_SWAP_CONTROL_CAPSLOCK,
105 MAGIC_CAPSLOCK_TO_CONTROL,
106 MAGIC_SWAP_LALT_LGUI,
107 MAGIC_SWAP_RALT_RGUI,
108 MAGIC_NO_GUI,
109 MAGIC_SWAP_GRAVE_ESC,
110 MAGIC_SWAP_BACKSLASH_BACKSPACE,
111 MAGIC_HOST_NKRO,
112 MAGIC_SWAP_ALT_GUI,
113 MAGIC_UNSWAP_CONTROL_CAPSLOCK,
114 MAGIC_UNCAPSLOCK_TO_CONTROL,
115 MAGIC_UNSWAP_LALT_LGUI,
116 MAGIC_UNSWAP_RALT_RGUI,
117 MAGIC_UNNO_GUI,
118 MAGIC_UNSWAP_GRAVE_ESC,
119 MAGIC_UNSWAP_BACKSLASH_BACKSPACE,
120 MAGIC_UNHOST_NKRO,
121 MAGIC_UNSWAP_ALT_GUI,
122 MAGIC_TOGGLE_NKRO,
98316ef0 123 GRAVE_ESC,
d8a608f3
W
124
125 // Leader key
126#ifndef DISABLE_LEADER
127 KC_LEAD,
128#endif
129
abba393f
JC
130 // Auto Shift setup
131 KC_ASUP,
132 KC_ASDN,
133 KC_ASRP,
a1fa70f9 134 KC_ASTG,
4f484bc1
DJ
135 KC_ASON,
136 KC_ASOFF,
abba393f 137
d8a608f3
W
138 // Audio on/off/toggle
139 AU_ON,
140 AU_OFF,
141 AU_TOG,
142
8b0b17a3
DJ
143 // Faux clicky as part of main audio feature
144 CLICKY_TOGGLE,
145 CLICKY_UP,
146 CLICKY_DOWN,
147 CLICKY_RESET,
148
8c93c5d9
PIN
149#ifdef FAUXCLICKY_ENABLE
150 // Faux clicky
151 FC_ON,
152 FC_OFF,
153 FC_TOG,
154#endif
155
d8a608f3
W
156 // Music mode on/off/toggle
157 MU_ON,
158 MU_OFF,
159 MU_TOG,
160
415d38ba
JH
161 // Music mode cycle
162 MU_MOD,
163
d8a608f3
W
164 // Music voice iterate
165 MUV_IN,
166 MUV_DE,
167
5ae1411f 168 // Midi
a64ae106 169#if !MIDI_ENABLE_STRICT || (defined(MIDI_ENABLE) && defined(MIDI_BASIC))
a7c61f29
JH
170 MI_ON,
171 MI_OFF,
172 MI_TOG,
525be99e
GY
173#endif
174
a64ae106 175#if !MIDI_ENABLE_STRICT || (defined(MIDI_ENABLE) && defined(MIDI_ADVANCED))
5ae1411f
GY
176 MIDI_TONE_MIN,
177
a64ae106 178#if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 0
5ae1411f
GY
179 MI_C = MIDI_TONE_MIN,
180 MI_Cs,
181 MI_Db = MI_Cs,
182 MI_D,
183 MI_Ds,
184 MI_Eb = MI_Ds,
185 MI_E,
186 MI_F,
187 MI_Fs,
188 MI_Gb = MI_Fs,
189 MI_G,
190 MI_Gs,
191 MI_Ab = MI_Gs,
192 MI_A,
193 MI_As,
194 MI_Bb = MI_As,
195 MI_B,
d1fe24ad 196#endif
5ae1411f 197
a64ae106 198#if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 1
5ae1411f
GY
199 MI_C_1,
200 MI_Cs_1,
201 MI_Db_1 = MI_Cs_1,
202 MI_D_1,
203 MI_Ds_1,
204 MI_Eb_1 = MI_Ds_1,
205 MI_E_1,
206 MI_F_1,
207 MI_Fs_1,
208 MI_Gb_1 = MI_Fs_1,
209 MI_G_1,
210 MI_Gs_1,
211 MI_Ab_1 = MI_Gs_1,
212 MI_A_1,
213 MI_As_1,
214 MI_Bb_1 = MI_As_1,
215 MI_B_1,
d1fe24ad 216#endif
5ae1411f 217
a64ae106 218#if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 2
5ae1411f
GY
219 MI_C_2,
220 MI_Cs_2,
221 MI_Db_2 = MI_Cs_2,
222 MI_D_2,
223 MI_Ds_2,
224 MI_Eb_2 = MI_Ds_2,
225 MI_E_2,
226 MI_F_2,
227 MI_Fs_2,
228 MI_Gb_2 = MI_Fs_2,
229 MI_G_2,
230 MI_Gs_2,
231 MI_Ab_2 = MI_Gs_2,
232 MI_A_2,
233 MI_As_2,
234 MI_Bb_2 = MI_As_2,
235 MI_B_2,
d1fe24ad 236#endif
5ae1411f 237
a64ae106 238#if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 3
d1fe24ad
GY
239 MI_C_3,
240 MI_Cs_3,
241 MI_Db_3 = MI_Cs_3,
242 MI_D_3,
243 MI_Ds_3,
244 MI_Eb_3 = MI_Ds_3,
245 MI_E_3,
246 MI_F_3,
247 MI_Fs_3,
248 MI_Gb_3 = MI_Fs_3,
249 MI_G_3,
250 MI_Gs_3,
251 MI_Ab_3 = MI_Gs_3,
252 MI_A_3,
253 MI_As_3,
254 MI_Bb_3 = MI_As_3,
255 MI_B_3,
256#endif
257
a64ae106 258#if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 4
d1fe24ad
GY
259 MI_C_4,
260 MI_Cs_4,
261 MI_Db_4 = MI_Cs_4,
262 MI_D_4,
263 MI_Ds_4,
264 MI_Eb_4 = MI_Ds_4,
265 MI_E_4,
266 MI_F_4,
267 MI_Fs_4,
268 MI_Gb_4 = MI_Fs_4,
269 MI_G_4,
270 MI_Gs_4,
271 MI_Ab_4 = MI_Gs_4,
272 MI_A_4,
273 MI_As_4,
274 MI_Bb_4 = MI_As_4,
275 MI_B_4,
276#endif
277
a64ae106 278#if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 5
d1fe24ad
GY
279 MI_C_5,
280 MI_Cs_5,
281 MI_Db_5 = MI_Cs_5,
282 MI_D_5,
283 MI_Ds_5,
284 MI_Eb_5 = MI_Ds_5,
285 MI_E_5,
286 MI_F_5,
287 MI_Fs_5,
288 MI_Gb_5 = MI_Fs_5,
289 MI_G_5,
290 MI_Gs_5,
291 MI_Ab_5 = MI_Gs_5,
292 MI_A_5,
293 MI_As_5,
294 MI_Bb_5 = MI_As_5,
295 MI_B_5,
296#endif
297
a64ae106 298#if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 5
d1fe24ad
GY
299 MIDI_TONE_MAX = MI_B_5,
300#elif MIDI_TONE_KEYCODE_OCTAVES > 4
301 MIDI_TONE_MAX = MI_B_4,
302#elif MIDI_TONE_KEYCODE_OCTAVES > 3
303 MIDI_TONE_MAX = MI_B_3,
304#elif MIDI_TONE_KEYCODE_OCTAVES > 2
5ae1411f 305 MIDI_TONE_MAX = MI_B_2,
d1fe24ad
GY
306#elif MIDI_TONE_KEYCODE_OCTAVES > 1
307 MIDI_TONE_MAX = MI_B_1,
308#elif MIDI_TONE_KEYCODE_OCTAVES > 0
309 MIDI_TONE_MAX = MI_B,
310#endif
5ae1411f
GY
311
312 MIDI_OCTAVE_MIN,
313 MI_OCT_N2 = MIDI_OCTAVE_MIN,
314 MI_OCT_N1,
315 MI_OCT_0,
316 MI_OCT_1,
317 MI_OCT_2,
318 MI_OCT_3,
319 MI_OCT_4,
320 MI_OCT_5,
321 MI_OCT_6,
322 MI_OCT_7,
323 MIDI_OCTAVE_MAX = MI_OCT_7,
324 MI_OCTD, // octave down
325 MI_OCTU, // octave up
326
5e6097f0
GY
327 MIDI_TRANSPOSE_MIN,
328 MI_TRNS_N6 = MIDI_TRANSPOSE_MIN,
329 MI_TRNS_N5,
330 MI_TRNS_N4,
331 MI_TRNS_N3,
332 MI_TRNS_N2,
333 MI_TRNS_N1,
334 MI_TRNS_0,
335 MI_TRNS_1,
336 MI_TRNS_2,
337 MI_TRNS_3,
338 MI_TRNS_4,
339 MI_TRNS_5,
340 MI_TRNS_6,
341 MIDI_TRANSPOSE_MAX = MI_TRNS_6,
342 MI_TRNSD, // transpose down
343 MI_TRNSU, // transpose up
344
5ae1411f
GY
345 MIDI_VELOCITY_MIN,
346 MI_VEL_1 = MIDI_VELOCITY_MIN,
347 MI_VEL_2,
348 MI_VEL_3,
e405ab4b 349 MI_VEL_4,
5ae1411f
GY
350 MI_VEL_5,
351 MI_VEL_6,
352 MI_VEL_7,
353 MI_VEL_8,
354 MI_VEL_9,
355 MI_VEL_10,
356 MIDI_VELOCITY_MAX = MI_VEL_10,
357 MI_VELD, // velocity down
358 MI_VELU, // velocity up
359
360 MIDI_CHANNEL_MIN,
361 MI_CH1 = MIDI_CHANNEL_MIN,
362 MI_CH2,
363 MI_CH3,
364 MI_CH4,
365 MI_CH5,
366 MI_CH6,
367 MI_CH7,
368 MI_CH8,
369 MI_CH9,
370 MI_CH10,
371 MI_CH11,
372 MI_CH12,
373 MI_CH13,
374 MI_CH14,
375 MI_CH15,
376 MI_CH16,
377 MIDI_CHANNEL_MAX = MI_CH16,
378 MI_CHD, // previous channel
379 MI_CHU, // next channel
380
525be99e 381 MI_ALLOFF, // all notes off
7c5e510f 382
5ae1411f 383 MI_SUS, // sustain
7c5e510f
GY
384 MI_PORT, // portamento
385 MI_SOST, // sostenuto
dd8f8e6b 386 MI_SOFT, // soft pedal
7c5e510f 387 MI_LEG, // legato
dd8f8e6b
GY
388
389 MI_MOD, // modulation
390 MI_MODSD, // decrease modulation speed
391 MI_MODSU, // increase modulation speed
3d3c0931 392
393 MI_BENDD, // Bend down
394 MI_BENDU, // Bend up
525be99e 395#endif // MIDI_ADVANCED
d8a608f3
W
396
397 // Backlight functionality
4931510a
BG
398 BL_ON,
399 BL_OFF,
d8a608f3
W
400 BL_DEC,
401 BL_INC,
402 BL_TOGG,
403 BL_STEP,
4931510a 404 BL_BRTG,
d8a608f3
W
405
406 // RGB functionality
407 RGB_TOG,
53b043d4
CG
408 RGB_MODE_FORWARD,
409 RGB_MODE_REVERSE,
d8a608f3
W
410 RGB_HUI,
411 RGB_HUD,
412 RGB_SAI,
413 RGB_SAD,
414 RGB_VAI,
415 RGB_VAD,
afacd423 416 RGB_SPI,
417 RGB_SPD,
4580d3a7 418 RGB_MODE_PLAIN,
419 RGB_MODE_BREATHE,
420 RGB_MODE_RAINBOW,
421 RGB_MODE_SWIRL,
422 RGB_MODE_SNAKE,
423 RGB_MODE_KNIGHT,
424 RGB_MODE_XMAS,
425 RGB_MODE_GRADIENT,
d8a608f3
W
426
427 // Left shift, open paren
428 KC_LSPO,
429
430 // Right shift, close paren
431 KC_RSPC,
432
8a1e6560
ZR
433 // Shift, Enter
434 KC_SFTENT,
435
d8a608f3
W
436 // Printing
437 PRINT_ON,
438 PRINT_OFF,
439
c17070ec
PIN
440 // output selection
441 OUT_AUTO,
442 OUT_USB,
443#ifdef BLUETOOTH_ENABLE
444 OUT_BT,
445#endif
c17070ec 446
8e1be7c7
FS
447#ifdef KEY_LOCK_ENABLE
448 KC_LOCK,
449#endif
450
7ad924ba
JH
451#ifdef TERMINAL_ENABLE
452 TERM_ON,
453 TERM_OFF,
454#endif
455
d8a608f3
W
456 // always leave at the end
457 SAFE_RANGE
458};
459
460// Ability to use mods in layouts
461#define LCTL(kc) (kc | QK_LCTL)
462#define LSFT(kc) (kc | QK_LSFT)
463#define LALT(kc) (kc | QK_LALT)
464#define LGUI(kc) (kc | QK_LGUI)
a2e12faa 465#define LCMD(kc) LGUI(kc)
466#define LWIN(kc) LGUI(kc)
d8a608f3
W
467#define RCTL(kc) (kc | QK_RCTL)
468#define RSFT(kc) (kc | QK_RSFT)
469#define RALT(kc) (kc | QK_RALT)
470#define RGUI(kc) (kc | QK_RGUI)
a2e12faa 471#define RCMD(kc) RGUI(kc)
472#define RWIN(kc) RGUI(kc)
d8a608f3
W
473
474#define HYPR(kc) (kc | QK_LCTL | QK_LSFT | QK_LALT | QK_LGUI)
475#define MEH(kc) (kc | QK_LCTL | QK_LSFT | QK_LALT)
476#define LCAG(kc) (kc | QK_LCTL | QK_LALT | QK_LGUI)
477#define ALTG(kc) (kc | QK_RCTL | QK_RALT)
e3f67e6e 478#define SGUI(kc) (kc | QK_LGUI | QK_LSFT)
e5c331e7 479#define SCMD(kc) SGUI(kc)
480#define SWIN(kc) SGUI(kc)
2aa079d9 481#define LCA(kc) (kc | QK_LCTL | QK_LALT)
d8a608f3
W
482
483#define MOD_HYPR 0xf
484#define MOD_MEH 0x7
485
486
487// Aliases for shifted symbols
488// Each key has a 4-letter code, and some have longer aliases too.
489// While the long aliases are descriptive, the 4-letter codes
490// make for nicer grid layouts (everything lines up), and are
491// the preferred style for Quantum.
492#define KC_TILD LSFT(KC_GRV) // ~
493#define KC_TILDE KC_TILD
494
495#define KC_EXLM LSFT(KC_1) // !
496#define KC_EXCLAIM KC_EXLM
497
498#define KC_AT LSFT(KC_2) // @
499
500#define KC_HASH LSFT(KC_3) // #
501
502#define KC_DLR LSFT(KC_4) // $
503#define KC_DOLLAR KC_DLR
504
505#define KC_PERC LSFT(KC_5) // %
506#define KC_PERCENT KC_PERC
507
508#define KC_CIRC LSFT(KC_6) // ^
509#define KC_CIRCUMFLEX KC_CIRC
510
511#define KC_AMPR LSFT(KC_7) // &
512#define KC_AMPERSAND KC_AMPR
513
514#define KC_ASTR LSFT(KC_8) // *
515#define KC_ASTERISK KC_ASTR
516
517#define KC_LPRN LSFT(KC_9) // (
518#define KC_LEFT_PAREN KC_LPRN
519
520#define KC_RPRN LSFT(KC_0) // )
521#define KC_RIGHT_PAREN KC_RPRN
522
523#define KC_UNDS LSFT(KC_MINS) // _
524#define KC_UNDERSCORE KC_UNDS
525
526#define KC_PLUS LSFT(KC_EQL) // +
527
528#define KC_LCBR LSFT(KC_LBRC) // {
529#define KC_LEFT_CURLY_BRACE KC_LCBR
530
531#define KC_RCBR LSFT(KC_RBRC) // }
532#define KC_RIGHT_CURLY_BRACE KC_RCBR
533
534#define KC_LABK LSFT(KC_COMM) // <
535#define KC_LEFT_ANGLE_BRACKET KC_LABK
536
537#define KC_RABK LSFT(KC_DOT) // >
538#define KC_RIGHT_ANGLE_BRACKET KC_RABK
539
540#define KC_COLN LSFT(KC_SCLN) // :
541#define KC_COLON KC_COLN
542
543#define KC_PIPE LSFT(KC_BSLS) // |
544
545#define KC_LT LSFT(KC_COMM) // <
546
547#define KC_GT LSFT(KC_DOT) // >
548
549#define KC_QUES LSFT(KC_SLSH) // ?
550#define KC_QUESTION KC_QUES
551
552#define KC_DQT LSFT(KC_QUOT) // "
553#define KC_DOUBLE_QUOTE KC_DQT
554#define KC_DQUO KC_DQT
555
556#define KC_DELT KC_DELETE // Del key (four letter code)
557
558// Alias for function layers than expand past FN31
559#define FUNC(kc) (kc | QK_FUNCTION)
560
561// Aliases
562#define S(kc) LSFT(kc)
563#define F(kc) FUNC(kc)
564
565#define M(kc) (kc | QK_MACRO)
566
cfc41497 567#define MACROTAP(kc) (kc | QK_MACRO | FUNC_TAP<<8)
d8a608f3
W
568#define MACRODOWN(...) (record->event.pressed ? MACRO(__VA_ARGS__) : MACRO_NONE)
569
98316ef0 570#define KC_GESC GRAVE_ESC
571
8b0b17a3
DJ
572#define CK_TOGG CLICKY_TOGGLE
573#define CK_RST CLICKY_RESET
574#define CK_UP CLICKY_UP
575#define CK_DOWN CLICKY_DOWN
576
53b043d4
CG
577#define RGB_MOD RGB_MODE_FORWARD
578#define RGB_SMOD RGB_MODE_FORWARD
579#define RGB_RMOD RGB_MODE_REVERSE
580
4580d3a7 581#define RGB_M_P RGB_MODE_PLAIN
582#define RGB_M_B RGB_MODE_BREATHE
583#define RGB_M_R RGB_MODE_RAINBOW
584#define RGB_M_SW RGB_MODE_SWIRL
585#define RGB_M_SN RGB_MODE_SNAKE
586#define RGB_M_K RGB_MODE_KNIGHT
587#define RGB_M_X RGB_MODE_XMAS
588#define RGB_M_G RGB_MODE_GRADIENT
a3357d07 589
d8a608f3
W
590// L-ayer, T-ap - 256 keycode max, 16 layer max
591#define LT(layer, kc) (kc | QK_LAYER_TAP | ((layer & 0xF) << 8))
592
593#define AG_SWAP MAGIC_SWAP_ALT_GUI
594#define AG_NORM MAGIC_UNSWAP_ALT_GUI
595
d8a608f3
W
596// GOTO layer - 16 layers max
597// when:
598// ON_PRESS = 1
599// ON_RELEASE = 2
600// Unless you have a good reason not to do so, prefer ON_PRESS (1) as your default.
601// In fact, we changed it to assume ON_PRESS for sanity/simplicity. If needed, you can add your own
602// keycode modeled after the old version, kept below for this.
603/* #define TO(layer, when) (layer | QK_TO | (when << 0x4)) */
604#define TO(layer) (layer | QK_TO | (ON_PRESS << 0x4))
605
606// Momentary switch layer - 256 layer max
607#define MO(layer) (layer | QK_MOMENTARY)
608
609// Set default layer - 256 layer max
610#define DF(layer) (layer | QK_DEF_LAYER)
611
612// Toggle to layer - 256 layer max
613#define TG(layer) (layer | QK_TOGGLE_LAYER)
614
615// One-shot layer - 256 layer max
616#define OSL(layer) (layer | QK_ONE_SHOT_LAYER)
617
7a5ce36f 618// L-ayer M-od: Momentary switch layer with modifiers active - 16 layer max, left mods only
619#define LM(layer, mod) (QK_LAYER_MOD | (((layer) & 0xF) << 4) | ((mod) & 0xF))
620
d8a608f3 621// One-shot mod
b2979eba 622#define OSM(mod) ((mod) | QK_ONE_SHOT_MOD)
d8a608f3 623
69ea10f9
JH
624// Layer tap-toggle
625#define TT(layer) (layer | QK_LAYER_TAP_TOGGLE)
626
d8a608f3 627// M-od, T-ap - 256 keycode max
b2979eba 628#define MT(mod, kc) (kc | QK_MOD_TAP | (((mod) & 0x1F) << 8))
97816df7 629
d8a608f3 630#define CTL_T(kc) MT(MOD_LCTL, kc)
97816df7
PIN
631#define LCTL_T(kc) MT(MOD_LCTL, kc)
632#define RCTL_T(kc) MT(MOD_RCTL, kc)
633
d8a608f3 634#define SFT_T(kc) MT(MOD_LSFT, kc)
97816df7
PIN
635#define LSFT_T(kc) MT(MOD_LSFT, kc)
636#define RSFT_T(kc) MT(MOD_RSFT, kc)
637
d8a608f3 638#define ALT_T(kc) MT(MOD_LALT, kc)
97816df7
PIN
639#define LALT_T(kc) MT(MOD_LALT, kc)
640#define RALT_T(kc) MT(MOD_RALT, kc)
f46c2b3c 641#define ALGR_T(kc) MT(MOD_RALT, kc) // dual-function AltGR
97816df7 642
d8a608f3 643#define GUI_T(kc) MT(MOD_LGUI, kc)
a2e12faa 644#define CMD_T(kc) GUI_T(kc)
645#define WIN_T(kc) GUI_T(kc)
97816df7 646#define LGUI_T(kc) MT(MOD_LGUI, kc)
a2e12faa 647#define LCMD_T(kc) LGUI_T(kc)
648#define LWIN_T(kc) LGUI_T(kc)
97816df7 649#define RGUI_T(kc) MT(MOD_RGUI, kc)
a2e12faa 650#define RCMD_T(kc) RGUI_T(kc)
651#define RWIN_T(kc) RGUI_T(kc)
97816df7 652
d8a608f3
W
653#define C_S_T(kc) MT((MOD_LCTL | MOD_LSFT), kc) // Control + Shift e.g. for gnome-terminal
654#define MEH_T(kc) MT((MOD_LCTL | MOD_LSFT | MOD_LALT), kc) // Meh is a less hyper version of the Hyper key -- doesn't include Win or Cmd, so just alt+shift+ctrl
655#define LCAG_T(kc) MT((MOD_LCTL | MOD_LALT | MOD_LGUI), kc) // Left control alt and gui
97816df7 656#define RCAG_T(kc) MT((MOD_RCTL | MOD_RALT | MOD_RGUI), kc) // Right control alt and gui
d8a608f3 657#define ALL_T(kc) MT((MOD_LCTL | MOD_LSFT | MOD_LALT | MOD_LGUI), kc) // see http://brettterpstra.com/2012/12/08/a-useful-caps-lock-key/
e3f67e6e 658#define SGUI_T(kc) MT((MOD_LGUI | MOD_LSFT), kc)
e5c331e7 659#define SCMD_T(kc) SGUI_T(kc)
660#define SWIN_T(kc) SGUI_T(kc)
2aa079d9 661#define LCA_T(kc) MT((MOD_LCTL | MOD_LALT), kc) // Left control and left alt
d8a608f3
W
662
663// Dedicated keycode versions for Hyper and Meh, if you want to use them as standalone keys rather than mod-tap
664#define KC_HYPR HYPR(KC_NO)
665#define KC_MEH MEH(KC_NO)
666
667#ifdef UNICODE_ENABLE
668 // For sending unicode codes.
669 // You may not send codes over 7FFF -- this supports most of UTF8.
670 // To have a key that sends out Œ, go UC(0x0152)
671 #define UNICODE(n) (n | QK_UNICODE)
672 #define UC(n) UNICODE(n)
673#endif
674
675#ifdef UNICODEMAP_ENABLE
676 #define X(n) (n | QK_UNICODE_MAP)
677#endif
678
23ac2a02
JW
679#ifdef SWAP_HANDS_ENABLE
680 #define SH_T(key) (QK_SWAP_HANDS | key)
681 #define SH_TG (QK_SWAP_HANDS | OP_SH_TOGGLE)
682 #define SH_TT (QK_SWAP_HANDS | OP_SH_TAP_TOGGLE)
683 #define SH_MON (QK_SWAP_HANDS | OP_SH_ON_OFF)
684 #define SH_MOFF (QK_SWAP_HANDS | OP_SH_OFF_ON)
685 #define SH_ON (QK_SWAP_HANDS | OP_SH_ON)
686 #define SH_OFF (QK_SWAP_HANDS | OP_SH_OFF)
687#endif
688
d8a608f3 689#endif // QUANTUM_KEYCODES_H