aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGraham P Heath <graham.p.heath@gmail.com>2018-02-23 12:15:34 -0600
committerJack Humbert <jack.humb@gmail.com>2018-02-23 13:15:34 -0500
commitf7461748744c1e3a5bae3b7a54d5b0d8439606e6 (patch)
tree2be896601415981f29b1c0fdc6a2b14165aaa713
parenta8daf3ffba0606d3e80dc5f12d2da336305aed0d (diff)
downloadqmk_firmware-f7461748744c1e3a5bae3b7a54d5b0d8439606e6.tar.gz
qmk_firmware-f7461748744c1e3a5bae3b7a54d5b0d8439606e6.zip
Graham's Keymaps. (#2422)
* add my config * fix backlight, clean up that code * group background code, restore static var * qwerty is supposed to be in the middle * wrap layer change backlight in ifdef * backlight levels and some more 'emojis'. * Restructure to make it possible to press cmd ent on the right side of the board with one hand. * Expose the period through the number layer. Add Hyper keys to mouse layer * reduce mouse speed * add a : -P key * Thumbs up and down, remove some keys that are duplicated via function keys, clean up * fix build issues * add various emoji * duplicate default Meira keymaps * Miera updates * add documented but unmapped emoji * Sound for the Meira, was stumped by a file size! Thanks drashna! * add docs * docs * revert lib changes... * clean up * clean up * remove make file * Fixes missing key
-rw-r--r--keyboards/meira/keymaps/grahampheath/config.h35
-rw-r--r--keyboards/meira/keymaps/grahampheath/keymap.c425
-rw-r--r--keyboards/meira/keymaps/grahampheath/readme.md55
-rw-r--r--keyboards/meira/keymaps/grahampheath/rules.mk3
-rw-r--r--keyboards/planck/keymaps/grahampheath/config.h51
-rw-r--r--keyboards/planck/keymaps/grahampheath/keymap.c450
-rw-r--r--keyboards/planck/keymaps/grahampheath/readme.md4
-rw-r--r--keyboards/planck/keymaps/grahampheath/rules.mk9
8 files changed, 1032 insertions, 0 deletions
diff --git a/keyboards/meira/keymaps/grahampheath/config.h b/keyboards/meira/keymaps/grahampheath/config.h
new file mode 100644
index 000000000..fcc5e4f13
--- /dev/null
+++ b/keyboards/meira/keymaps/grahampheath/config.h
@@ -0,0 +1,35 @@
1/* Copyright 2017 Cole Markham, WoodKeys.click
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 */
16
17#ifndef CONFIG_USER_H
18#define CONFIG_USER_H
19
20#include "../../config.h"
21
22// place overrides here
23#define MUSIC_MASK (keycode != KC_NO)
24#define C6_AUDIO
25#ifdef AUDIO_ENABLE
26 #define STARTUP_SONG SONG(PLANCK_SOUND)
27 // #define STARTUP_SONG SONG(NO_SOUND)
28
29 #define DEFAULT_LAYER_SONGS { SONG(QWERTY_SOUND), \
30 SONG(COLEMAK_SOUND), \
31 SONG(DVORAK_SOUND) \
32 }
33#endif
34
35#endif
diff --git a/keyboards/meira/keymaps/grahampheath/keymap.c b/keyboards/meira/keymaps/grahampheath/keymap.c
new file mode 100644
index 000000000..6a4b9333c
--- /dev/null
+++ b/keyboards/meira/keymaps/grahampheath/keymap.c
@@ -0,0 +1,425 @@
1/* Copyright 2017 Cole Markham
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 */
16#include "meira.h"
17#include "action_layer.h"
18#include "action_code.h"
19
20#ifdef RGBLIGHT_ENABLE
21//Following line allows macro to read current RGB settings
22extern rgblight_config_t rgblight_config;
23#endif
24
25#define _QWERTY 0
26#define _COLEMAK 1
27#define _DVORAK 2
28#define _LOWER 3
29#define _RAISE 4
30#define _EMOJI 5
31#define _ADJUST 16
32
33enum custom_keycodes {
34 QWERTY = SAFE_RANGE,
35 COLEMAK,
36 DVORAK,
37 LOWER,
38 RAISE,
39 EMOJI,
40 ADJUST,
41 TOUNGE,
42 JOY,
43 FROWN,
44 HEART,
45 THMBUP,
46 THMBDN,
47 SHRUG,
48 WINK,
49 GRIN,
50 LLAP,
51 CRY,
52 SHIT,
53 FLIP,
54 FNGLEFT,
55 ABOVE,
56 FNGRIGHT,
57 CONFUSED
58};
59
60// define variables for reactive RGB
61bool TOG_STATUS = false;
62int RGB_current_mode;
63
64#define KC_X0 MT(MOD_LCTL, KC_ESC) // Hold for Left Ctrl, Tap for ESC
65#define KC_X1 MT(MOD_RSFT, KC_ENT) // Hold for Right Shift, Tap for Enter
66#define KC_X2 MT(MOD_RSFT, LGUI(KC_ENT)) // Send Command Enter
67#define KC_X3 MT(KC_LGUI, KC_SPC) // Hold for Left GUI, Tap for Space
68#define KC_EMOJ TT(_EMOJI) // Hold for Emoji Layer, or tap 5 times.
69#define KC_QS LGUI(KC_SPC) // Send Command + Space (for QuickSilver).
70#define KC_TABR LGUI(KC_RCBR) // Send Command + } (for tab changing).
71#define KC_TABL LGUI(KC_LCBR) // Send Command + { (for tab changing).
72#define HYPR_0 HYPR(KC_TILD) // Send Hyper + ~.
73#define HYPR_1 HYPR(KC_EXLM) // Send Hyper + !.
74#define HYPR_2 HYPR(KC_AT) // Send Hyper + @.
75
76const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
77 /* Qwerty
78 * ,-----------------------------------------------------------------------------------.
79 * | Esc | Q | W | E | R | T | Y | U | I | O | P | Bksp |
80 * |------+------+------+------+------+-------------+------+------+------+------+------|
81 * | Tab | A | S | D | F | G | H | J | K | L | ; | ' |
82 * |------+------+------+------+------+------|------+------+------+------+------+------|
83 * | Shift| Z | X | C | V | B | N | M | , | . | / |Enter |
84 * |------+------+------+------+------+------+------+------+------+------+------+------|
85 * |Emoji |Adjust| Ctrl | Alt |Lower | Cmd |Space |Raise | Left | Down | Up |Right |
86 * `-----------------------------------------------------------------------------------'
87 */
88 [_QWERTY] = KEYMAP( \
89 KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_BSPC, \
90 KC_X0, KC_A, KC_S, KC_D, KC_F, KC_G, KC_H, KC_J, KC_K, KC_L, KC_SCLN, KC_QUOT, \
91 KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_X1, \
92 KC_EMOJ, KC_LCTL, KC_LALT, KC_LGUI, LOWER, KC_X3, KC_SPC, RAISE, KC_LEFT, KC_DOWN, KC_UP, KC_RGHT \
93 ),
94
95 /* Colemak
96 * ,-----------------------------------------------------------------------------------.
97 * | Tab | Q | W | F | P | G | J | L | U | Y | ; | Bksp |
98 * |------+------+------+------+------+-------------+------+------+------+------+------|
99 * | Esc | A | R | S | T | D | H | N | E | I | O | " |
100 * |------+------+------+------+------+------|------+------+------+------+------+------|
101 * | Shift| Z | X | C | V | B | K | M | , | . | / |Enter |
102 * |------+------+------+------+------+------+------+------+------+------+------+------|
103 * |Adjust| Ctrl | Alt | GUI |Lower |Space |Space |Raise | Left | Down | Up |Right |
104 * `-----------------------------------------------------------------------------------'
105 */
106 [_COLEMAK] = KEYMAP( \
107 KC_TAB, KC_Q, KC_W, KC_F, KC_P, KC_G, KC_J, KC_L, KC_U, KC_Y, KC_SCLN, KC_BSPC, \
108 KC_ESC, KC_A, KC_R, KC_S, KC_T, KC_D, KC_H, KC_N, KC_E, KC_I, KC_O, KC_QUOT, \
109 KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_K, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_ENT , \
110 ADJUST, KC_LCTL, KC_LALT, KC_LGUI, LOWER, KC_SPC, KC_SPC, RAISE, KC_LEFT, KC_DOWN, KC_UP, KC_RGHT \
111 ),
112
113 /* Dvorak
114 * ,-----------------------------------------------------------------------------------.
115 * | Tab | " | , | . | P | Y | F | G | C | R | L | Bksp |
116 * |------+------+------+------+------+-------------+------+------+------+------+------|
117 * | Esc | A | O | E | U | I | D | H | T | N | S | / |
118 * |------+------+------+------+------+------|------+------+------+------+------+------|
119 * | Shift| ; | Q | J | K | X | B | M | W | V | Z |Enter |
120 * |------+------+------+------+------+------+------+------+------+------+------+------|
121 * |Adjust| Ctrl | Alt | GUI |Lower |Space |Space |Raise | Left | Down | Up |Right |
122 * `-----------------------------------------------------------------------------------'
123 */
124 [_DVORAK] = KEYMAP( \
125 KC_TAB, KC_QUOT, KC_COMM, KC_DOT, KC_P, KC_Y, KC_F, KC_G, KC_C, KC_R, KC_L, KC_BSPC, \
126 KC_ESC, KC_A, KC_O, KC_E, KC_U, KC_I, KC_D, KC_H, KC_T, KC_N, KC_S, KC_SLSH, \
127 KC_LSFT, KC_SCLN, KC_Q, KC_J, KC_K, KC_X, KC_B, KC_M, KC_W, KC_V, KC_Z, KC_ENT , \
128 ADJUST, KC_LCTL, KC_LALT, KC_LGUI, LOWER, KC_SPC, KC_SPC, RAISE, KC_LEFT, KC_DOWN, KC_UP, KC_RGHT \
129 ),
130
131 /* Emoji Layer
132 *
133 * ┌─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┐
134 * │HYPR0│ │ ;-) │ │ │ :-P │ │ │:'-( │FLIP │ │ │
135 * ├─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
136 * │HYPR1│ 👆 │SHRUG│ │ :-( │ │ <3 │ :-) │ │LLAP │ │ │
137 * ├─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
138 * │HYPR2│ │ │ | :-\ │ │ │ :-D │ SHIT│ │ │ │
139 * ├─────┼─────┼─────┼─────┼─────┼─────┴─────┼─────┼─────┼─────┼─────┼─────┤
140 * │ │ │ │ │Brig-│ Sleep │Brig+│ 👈 │ 👎 | 👍 │ 👉 │
141 * └─────┴─────┴─────┴─────┴─────┴───────────┴─────┴─────┴─────┴─────┴─────┘
142 */
143 [_EMOJI] = KEYMAP ( \
144 HYPR_0, _______, WINK, _______, _______, TOUNGE, _______, _______, CRY, FLIP, _______, _______, \
145 HYPR_1, ABOVE, SHRUG, _______, FROWN, _______, HEART, JOY, _______, LLAP, _______, _______, \
146 HYPR_2, _______, _______, _______, CONFUSED, _______, _______, GRIN, SHIT, _______, _______, _______, \
147 _______, _______, _______, _______, KC_SLCK, KC_SLEP, KC_SLEP, KC_PAUS, FNGLEFT, THMBDN, THMBUP, FNGRIGHT \
148 ),
149
150
151
152 /* Lower
153 * ,-----------------------------------------------------------------------------------.
154 * | | ! | @ | # | $ | % | ^ | & | * | ( | ) | Bksp |
155 * |------+------+------+------+------+-------------+------+------+------+------+------|
156 * | ~ | F1 | F2 | F3 | F4 | F5 | F6 | _ | + | | \ | | |
157 * |------+------+------+------+------+------|------+------+------+------+------+------|
158 * | | F7 | F8 | F9 | F10 | F11 | F12 |ISO ~ |ISO | | | |Enter |
159 * |------+------+------+------+------+------+------+------+------+------+------+------|
160 * | | | | | | | | Tab- | Vol- | Vol+ | Tab+ |
161 * `-----------------------------------------------------------------------------------'
162 */
163 [_LOWER] = KEYMAP( \
164 KC_TILD, KC_EXLM, KC_AT, KC_HASH, KC_DLR, KC_PERC, KC_CIRC, KC_AMPR, KC_ASTR, KC_LPRN, KC_RPRN, KC_BSPC, \
165 KC_DEL, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_UNDS, KC_PLUS, KC_LCBR, KC_RCBR, KC_PIPE, \
166 KC_LSFT, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12,S(KC_NUHS),S(KC_NUBS),_______, _______, _______, \
167 _______, _______, _______, _______, _______, KC_QS, KC_QS, _______, KC_TABL, THMBDN, THMBUP, KC_TABR \
168 ),
169
170 /* Raise
171 * ,-----------------------------------------------------------------------------------.
172 * | | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 0 | Bksp |
173 * |------+------+------+------+------+-------------+------+------+------+------+------|
174 * | ` | F1 | F2 | F3 | F4 | F5 | F6 | - | = | [ | ] | \ |
175 * |------+------+------+------+------+------|------+------+------+------+------+------|
176 * | | F7 | F8 | F9 | F10 | F11 | F12 |ISO # |ISO / | | |Enter |
177 * |------+------+------+------+------+------+------+------+------+------+------+------|
178 * | | | | | | | | Home | PgUp | PgDn | End |
179 * `-----------------------------------------------------------------------------------'
180 */
181 [_RAISE] = KEYMAP( \
182 KC_GRV, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_BSPC, \
183 KC_DEL, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_MINS, KC_EQL, KC_LBRC, KC_RBRC, KC_BSLS, \
184 KC_LSFT, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, KC_NUHS, KC_NUBS, _______, _______, KC_X2, \
185 _______, _______, _______, _______, _______, _______, _______, _______, KC_HOME, KC_PGDN, KC_PGUP, KC_END \
186 ),
187
188 /* Adjust (Lower + Raise)
189 * ,-----------------------------------------------------------------------------------.
190 * | | Reset| | | | | | | | | | Del |
191 * |------+------+------+------+------+-------------+------+------+------+------+------|
192 * | | | |Aud on|Audoff|AGnorm|AGswap|Qwerty|Colemk|Dvorak| | |
193 * |------+------+------+------+------+------|------+------+------+------+------+------|
194 * | | | | | | | | | | | | |
195 * |------+------+------+------+------+------+------+------+------+------+------+------|
196 * | | | | | | | | | | | |
197 * `-----------------------------------------------------------------------------------'
198 */
199 [_ADJUST] = KEYMAP( \
200 _______, RESET, _______, KC_MRWD, KC_MPLY, KC_MFFD, KC_PSCR, _______, _______, _______, _______, KC_DEL, \
201 _______, _______, _______, AU_ON, AU_OFF, AG_NORM, AG_SWAP, QWERTY, COLEMAK, DVORAK, _______, _______, \
202 _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, \
203 _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______ \
204 )
205};
206
207const uint16_t PROGMEM fn_actions[] = {
208
209};
210
211const macro_t *action_get_macro(keyrecord_t *record, uint8_t id, uint8_t opt)
212{
213 // MACRODOWN only works in this function
214 switch(id) {
215 case 0:
216 if (record->event.pressed) {
217 register_code(KC_RSFT);
218 } else {
219 unregister_code(KC_RSFT);
220 }
221 break;
222 }
223 return MACRO_NONE;
224};
225
226#ifdef AUDIO_ENABLE
227
228 float tone_qwerty[][2] = SONG(QWERTY_SOUND);
229 float tone_dvorak[][2] = SONG(DVORAK_SOUND);
230 float tone_colemak[][2] = SONG(COLEMAK_SOUND);
231
232
233 float plover_song[][2] = SONG(PLOVER_SOUND);
234 float plover_gb_song[][2] = SONG(PLOVER_GOODBYE_SOUND);
235#endif
236
237void matrix_init_user(void) {
238
239}
240
241void matrix_scan_user(void) {
242
243}
244
245bool process_record_user(uint16_t keycode, keyrecord_t *record) {
246 switch (keycode) {
247 case QWERTY:
248 if (record->event.pressed) {
249 #ifdef AUDIO_ENABLE
250 PLAY_NOTE_ARRAY(tone_qwerty, false, 0);
251 #endif
252 }
253 return false;
254 break;
255 case COLEMAK:
256 if (record->event.pressed) {
257 #ifdef AUDIO_ENABLE
258 PLAY_NOTE_ARRAY(tone_colemak, false, 0);
259 #endif
260 }
261 return false;
262 break;
263 case DVORAK:
264 if (record->event.pressed) {
265 #ifdef AUDIO_ENABLE
266 PLAY_NOTE_ARRAY(tone_dvorak, false, 0);
267 #endif
268 }
269 return false;
270 break;
271 case LOWER:
272 if (record->event.pressed) {
273 layer_on(_LOWER);
274 update_tri_layer(_LOWER, _RAISE, _ADJUST);
275 } else {
276 layer_off(_LOWER);
277 update_tri_layer(_LOWER, _RAISE, _ADJUST);
278 }
279 return false;
280 break;
281 case RAISE:
282 if (record->event.pressed) {
283 layer_on(_RAISE);
284 update_tri_layer(_LOWER, _RAISE, _ADJUST);
285 } else {
286 layer_off(_RAISE);
287 update_tri_layer(_LOWER, _RAISE, _ADJUST);
288 }
289 return false;
290 break;
291 case ADJUST:
292 // FIXME add RGB feedback
293 if (record->event.pressed) {
294 layer_on(_ADJUST);
295 } else {
296 layer_off(_ADJUST);
297 }
298 return false;
299 break;
300 case BL_TOGG:
301#ifdef ISSI_ENABLE
302 if (record->event.pressed) {
303 print("Enabling backlight\n");
304 issi_init();
305 }
306#endif
307 return false;
308 break;
309 case BL_STEP:
310 if (record->event.pressed) {
311 print("Stepping backlight\n");
312
313 }
314 return false;
315 break;
316 case FLIP:
317 if (record->event.pressed) {
318 SEND_STRING("&fliptable;");
319 }
320 return false;
321 break;
322 case CONFUSED:
323 if (record->event.pressed) {
324 SEND_STRING(":-\\");
325 }
326 // register_codeturn false;
327 break;
328 case SHIT:
329 if (record->event.pressed) {
330 SEND_STRING("&shit; ");
331 }
332 return false;
333 break;
334 case CRY:
335 if (record->event.pressed) {
336 SEND_STRING(":'-( ");
337 }
338 return false;
339 break;
340 case LLAP:
341 if (record->event.pressed) {
342 SEND_STRING("&llap; ");
343 }
344 return false;
345 break;
346 case GRIN:
347 if (record->event.pressed) {
348 SEND_STRING(":-D ");
349 }
350 return false;
351 break;
352 case TOUNGE:
353 if (record->event.pressed) {
354 SEND_STRING(":-P ");
355 }
356 return false;
357 break;
358 case JOY:
359 if (record->event.pressed) {
360 SEND_STRING(":-) ");
361 }
362 return false;
363 break;
364 case FROWN:
365 if (record->event.pressed) {
366 SEND_STRING(":-( ");
367 }
368 return false;
369 break;
370 case HEART:
371 if (record->event.pressed) {
372 SEND_STRING("<3 ");
373 }
374 return false;
375 break;
376 case SHRUG:
377 if (record->event.pressed) {
378 SEND_STRING("&shrug; ");
379 }
380 return false;
381 break;
382 case THMBUP:
383 if (record->event.pressed) {
384 SEND_STRING("&thumbup; ");
385 }
386 return false;
387 break;
388 case THMBDN:
389 if (record->event.pressed) {
390 SEND_STRING("&thumbdown; ");
391 }
392 return false;
393 break;
394 case FNGLEFT:
395 if (record->event.pressed) {
396 SEND_STRING("&fingerleft; ");
397 }
398 return false;
399 break;
400 case FNGRIGHT:
401 if (record->event.pressed) {
402 SEND_STRING("&fingerright; ");
403 }
404 return false;
405 break;
406 case WINK:
407 if (record->event.pressed) {
408 SEND_STRING(";-) ");
409 }
410 return false;
411 break;
412 case ABOVE:
413 if (record->event.pressed) {
414 SEND_STRING("&above; ");
415 }
416 return false;
417 break;
418
419 }
420 return true;
421}
422
423void led_set_user(uint8_t usb_led) {
424
425}
diff --git a/keyboards/meira/keymaps/grahampheath/readme.md b/keyboards/meira/keymaps/grahampheath/readme.md
new file mode 100644
index 000000000..10459e356
--- /dev/null
+++ b/keyboards/meira/keymaps/grahampheath/readme.md
@@ -0,0 +1,55 @@
1# Graham's Meira.
2
3Don't expect this to work for you unaltered! For the record, these are my notes, not a guide for you :-)
4
5## Known issues:
6Anything over 28k will begin to overwrite the boot loader, which is a pain!
7
8Be sure to check file size with:
9```
10avr-size meira_promicro_grahampheath.hex
11```
12
13## Sounds
14I've added a [8ohm 0.5W speaker](http://a.co/6MIKZSy), its a bit large, but it fits in approximately the same space as the ProMicro. I soldered directly to PC6 and GND.
15
16As the Meira code stood, adding sound increased the hex beyond what the boot loader could handle, so I had to dial way back on features that I wasnt using, like backlighting and RGB support. I also removed function keys, though I think you could restore some of these features, you certainly can't restore all of them and still fit with a boot loader.
17
18## Build
19
20Built for the ProMicro with:
21```
22make meira/promicro:grahampheath
23```
24
25Build and upload with, which is cool because it will sense your port.
26```
27make meira/promicro:grahampheath:avrdude
28```
29
30Program a hex directly with:
31```
32avrdude -p atmega32u4 -P /dev/tty.usbmodem14111 -c avr109 -v -e -D -U flash:w:meira_promicro_grahampheath.hex
33```
34
35If you use an AVRISP you will be program a hex without a boot loader:
36```
37avrdude -p atmega32u4 -P /dev/tty.usbmodem14111 -c avrisp -v -e -U flash:w:meira_promicro_grahampheath.hex
38```
39
40## Bricked
41Did you overwrite your boot loader?
42
43I did...
44
45I used an [Ardunio as an ISP](https://learn.sparkfun.com/tutorials/installing-an-arduino-bootloader), and was able to program various boot loaders. Ultimately it seemed like this was the right combo:
46
47[ProMicro pinout](https://cdn.sparkfun.com/assets/9/c/3/c/4/523a1765757b7f5c6e8b4567.png)
48
49[Wiring](https://forum.arduino.cc/index.php?PHPSESSID=467mm69btif69hdj5e3gil5465&action=dlattach;topic=363341.0;attach=145820): [via u/dmjlambert](https://forum.arduino.cc/index.php?topic=363341.0)
50
51ProMicro boot loader hex is called `Caterina-promicro16.hex` and is stored on [Sparkfun's GitHub](https://github.com/sparkfun/Arduino_Boards)
52
53```
54avrdude -c avrisp -p m32u4 -P /dev/tty.usbmodem14141 -v -e -U flash:w:Caterina-promicro16.hex -U efuse:w:0xcb:m -U hfuse:w:0xd8:m -U lfuse:w:0xff:m
55```
diff --git a/keyboards/meira/keymaps/grahampheath/rules.mk b/keyboards/meira/keymaps/grahampheath/rules.mk
new file mode 100644
index 000000000..8288530c9
--- /dev/null
+++ b/keyboards/meira/keymaps/grahampheath/rules.mk
@@ -0,0 +1,3 @@
1AUDIO_ENABLE = yes # Audio output on port C6
2EXTRAFLAGS+=-flto # -4-7k
3MOUSEKEY_ENABLE = no # Mouse keys(-47kb)
diff --git a/keyboards/planck/keymaps/grahampheath/config.h b/keyboards/planck/keymaps/grahampheath/config.h
new file mode 100644
index 000000000..1c842420b
--- /dev/null
+++ b/keyboards/planck/keymaps/grahampheath/config.h
@@ -0,0 +1,51 @@
1#ifndef CONFIG_USER_H
2#define CONFIG_USER_H
3
4#include "../../config.h"
5
6#ifdef AUDIO_ENABLE
7 #define STARTUP_SONG SONG(PLANCK_SOUND)
8 // #define STARTUP_SONG SONG(NO_SOUND)
9
10 #define DEFAULT_LAYER_SONGS { SONG(QWERTY_SOUND), \
11 SONG(COLEMAK_SOUND), \
12 SONG(DVORAK_SOUND) \
13 }
14#endif
15
16#define MUSIC_MASK (keycode != KC_NO)
17
18/*
19 * MIDI options
20 */
21
22/* Prevent use of disabled MIDI features in the keymap */
23//#define MIDI_ENABLE_STRICT 1
24
25/* enable basic MIDI features:
26 - MIDI notes can be sent when in Music mode is on
27*/
28
29#define MIDI_BASIC
30
31/* enable advanced MIDI features:
32 - MIDI notes can be added to the keymap
33 - Octave shift and transpose
34 - Virtual sustain, portamento, and modulation wheel
35 - etc.
36*/
37//#define MIDI_ADVANCED
38
39/* override number of MIDI tone keycodes (each octave adds 12 keycodes and allocates 12 bytes) */
40//#define MIDI_TONE_KEYCODE_OCTAVES 2
41
42#endif
43
44#define TAPPING_TERM 200
45
46#undef BACKLIGHT_LEVELS
47#define BACKLIGHT_LEVELS 4
48
49#undef MOUSEKEY_WHEEL_MAX_SPEED
50#define MOUSEKEY_WHEEL_MAX_SPEED 5
51
diff --git a/keyboards/planck/keymaps/grahampheath/keymap.c b/keyboards/planck/keymaps/grahampheath/keymap.c
new file mode 100644
index 000000000..96d900018
--- /dev/null
+++ b/keyboards/planck/keymaps/grahampheath/keymap.c
@@ -0,0 +1,450 @@
1/* Copyright 2015-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 */
16#include "planck.h"
17#include "action_layer.h"
18#include "action_code.h"
19
20extern keymap_config_t keymap_config;
21
22enum planck_layers {
23 _QWERTY,
24 _COLEMAK,
25 _DVORAK,
26 _LOWER,
27 _RAISE,
28 _EMOJI,
29 _PLOVER,
30 _ADJUST
31};
32
33enum planck_keycodes {
34 QWERTY = SAFE_RANGE,
35 COLEMAK,
36 DVORAK,
37 PLOVER,
38 LOWER,
39 RAISE,
40 BACKLIT,
41 EXT_PLV,
42 TOUNGE,
43 JOY,
44 FROWN,
45 HEART,
46 THMBUP,
47 THMBDN,
48 SHRUG,
49 WINK,
50 GRIN,
51 LLAP,
52 CRY,
53 SHIT,
54 FLIP,
55 FNGLEFT,
56 ABOVE,
57 FNGRIGHT,
58 CONFUSED
59};
60
61
62#define KC_X0 MT(MOD_LCTL, KC_ESC) // Hold for Left Ctrl, Tap for ESC
63#define KC_X1 MT(MOD_RSFT, KC_ENT) // Hold for Right Shift, Tap for Enter
64#define KC_X2 MT(MOD_RSFT, LGUI(KC_ENT)) // Send Command Enter
65#define KC_MOUS TT(_EMOJI) // Hold for Mouse Layer, or tap 5 times.
66#define KC_QS LGUI(KC_SPC) // Send Command + Space (for QuickSilver).
67#define KC_TABR LGUI(KC_RCBR) // Send Command + } (for tab changing).
68#define KC_TABL LGUI(KC_LCBR) // Send Command + { (for tab changing).
69#define HYPR_0 HYPR(KC_TILD) // Send Hyper + ~.
70#define HYPR_1 HYPR(KC_EXLM) // Send Hyper + !.
71#define HYPR_2 HYPR(KC_AT) // Send Hyper + @.
72
73
74const uint16_t PROGMEM keymaps[][MATRIX_ROWS][MATRIX_COLS] = {
75/* Qwerty
76 * ,-----------------------------------------------------------------------------------.
77 * | Tab | Q | W | E | R | T | Y | U | I | O | P | Bksp |
78 * |------+------+------+------+------+-------------+------+------+------+------+------|
79 * | Esc* | A | S | D | F | G | H | J | K | L | ; | " |
80 * |------+------+------+------+------+------|------+------+------+------+------+------|
81 * | Shift| Z | X | C | V | B | N | M | , | . | / |Shift*|
82 * |------+------+------+------+------+------+------+------+------+------+------+------|
83 * | GUI | Ctrl | Alt | GUI |Lower | Space |Raise | Left | Down | Up |Right |
84 * `-----------------------------------------------------------------------------------'
85 * - Right Shift: Tap for Enter, hold for shift.
86 * - Escape: Tap for Esc, hold for Ctrl.
87 */
88[_QWERTY] = {
89 {KC_TAB, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_BSPC},
90 {KC_X0, KC_A, KC_S, KC_D, KC_F, KC_G, KC_H, KC_J, KC_K, KC_L, KC_SCLN, KC_QUOT},
91 {KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_N, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_X1 },
92 {KC_MOUS, KC_LCTL, KC_LALT, KC_LGUI, LOWER, KC_SPC, KC_SPC, RAISE, KC_LEFT, KC_DOWN, KC_UP, KC_RGHT}
93},
94
95/* Colemak
96 * ,-----------------------------------------------------------------------------------.
97 * | Tab | Q | W | F | P | G | J | L | U | Y | ; | Bksp |
98 * |------+------+------+------+------+-------------+------+------+------+------+------|
99 * | Esc | A | R | S | T | D | H | N | E | I | O | " |
100 * |------+------+------+------+------+------|------+------+------+------+------+------|
101 * | Shift| Z | X | C | V | B | K | M | , | . | / |Enter |
102 * |------+------+------+------+------+------+------+------+------+------+------+------|
103 * | Brite| Ctrl | Alt | GUI |Lower | Space |Raise | Left | Down | Up |Right |
104 * `-----------------------------------------------------------------------------------'
105 */
106[_COLEMAK] = {
107 {KC_TAB, KC_Q, KC_W, KC_F, KC_P, KC_G, KC_J, KC_L, KC_U, KC_Y, KC_SCLN, KC_BSPC},
108 {KC_ESC, KC_A, KC_R, KC_S, KC_T, KC_D, KC_H, KC_N, KC_E, KC_I, KC_O, KC_QUOT},
109 {KC_LSFT, KC_Z, KC_X, KC_C, KC_V, KC_B, KC_K, KC_M, KC_COMM, KC_DOT, KC_SLSH, KC_ENT },
110 {BACKLIT, KC_LCTL, KC_LALT, KC_LGUI, LOWER, KC_SPC, KC_SPC, RAISE, KC_LEFT, KC_DOWN, KC_UP, KC_RGHT}
111},
112
113/* Dvorak
114 * ,-----------------------------------------------------------------------------------.
115 * | Tab | " | , | . | P | Y | F | G | C | R | L | Bksp |
116 * |------+------+------+------+------+-------------+------+------+------+------+------|
117 * | Esc | A | O | E | U | I | D | H | T | N | S | / |
118 * |------+------+------+------+------+------|------+------+------+------+------+------|
119 * | Shift| ; | Q | J | K | X | B | M | W | V | Z |Enter |
120 * |------+------+------+------+------+------+------+------+------+------+------+------|
121 * | Brite| Ctrl | Alt | GUI |Lower | Space |Raise | Left | Down | Up |Right |
122 * `-----------------------------------------------------------------------------------'
123 */
124[_DVORAK] = {
125 {KC_TAB, KC_QUOT, KC_COMM, KC_DOT, KC_P, KC_Y, KC_F, KC_G, KC_C, KC_R, KC_L, KC_BSPC},
126 {KC_ESC, KC_A, KC_O, KC_E, KC_U, KC_I, KC_D, KC_H, KC_T, KC_N, KC_S, KC_SLSH},
127 {KC_LSFT, KC_SCLN, KC_Q, KC_J, KC_K, KC_X, KC_B, KC_M, KC_W, KC_V, KC_Z, KC_ENT },
128 {BACKLIT, KC_LCTL, KC_LALT, KC_LGUI, LOWER, KC_SPC, KC_SPC, RAISE, KC_LEFT, KC_DOWN, KC_UP, KC_RGHT}
129},
130
131
132/* Emoji Layer
133 *
134 * ┌─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┐
135 * │HYPR0│ │ ;-) │ │ │ :-P │ │ │:'-( │FLIP │ │ │
136 * ├─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
137 * │HYPR1│ 👆 │SHRUG│ │ :-( │ │ <3 │ :-) │ │LLAP │ │ │
138 * ├─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
139 * │HYPR2│ │ │ | :-\ │ │ │ :-D │ SHIT│ │ │ │
140 * ├─────┼─────┼─────┼─────┼─────┼─────┴─────┼─────┼─────┼─────┼─────┼─────┤
141 * │ │ │ │ │Brig-│ Sleep │Brig+│ 👈 │ 👎 | 👍 │ 👉 │
142 * └─────┴─────┴─────┴─────┴─────┴───────────┴─────┴─────┴─────┴─────┴─────┘
143 */
144[_EMOJI] = {
145 {HYPR_0, _______, WINK, _______, _______, TOUNGE, _______, _______, CRY, FLIP, _______, _______},
146 {HYPR_1, ABOVE, SHRUG, _______, FROWN, _______, HEART, JOY, _______, LLAP, _______, _______},
147 {HYPR_2, _______, _______, _______, CONFUSED, _______, _______, GRIN, SHIT, _______, _______, _______},
148 {_______, _______, _______, _______, KC_SLCK, KC_SLEP, KC_SLEP, KC_PAUS, FNGLEFT, THMBDN, THMBUP, FNGRIGHT}
149},
150
151
152/* Lower
153 * ,-----------------------------------------------------------------------------------.
154 * | ~ | ! | @ | # | $ | % | ^ | & | * | ( | ) | Bksp |
155 * |------+------+------+------+------+-------------+------+------+------+------+------|
156 * | Del | F1 | F2 | F3 | F4 | F5 | F6 | _ | + | { | } | | |
157 * |------+------+------+------+------+------|------+------+------+------+------+------|
158 * | Shft | F7 | F8 | F9 | F10 | F11 | F12 |ISO ~ |ISO | | | | |
159 * |------+------+------+------+------+------+------+------+------+------+------+------|
160 * | | | | | | | |Tab-L | 👎 | 👍 |Tab-R |
161 * `-----------------------------------------------------------------------------------'
162 */
163[_LOWER] = {
164 {KC_TILD, KC_EXLM, KC_AT, KC_HASH, KC_DLR, KC_PERC, KC_CIRC, KC_AMPR, KC_ASTR, KC_LPRN, KC_RPRN, KC_BSPC},
165 {KC_DEL, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_UNDS, KC_PLUS, KC_LCBR, KC_RCBR, KC_PIPE},
166 {KC_LSFT, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, S(KC_NUHS), S(KC_NUBS), _______, _______, _______},
167 {_______, _______, _______, _______, _______, KC_QS, KC_QS, _______, KC_TABL, THMBDN, THMBUP, KC_TABR}
168},
169
170/* Raise
171 * ,-----------------------------------------------------------------------------------.
172 * | ` | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 0 | Bksp |
173 * |------+------+------+------+------+-------------+------+------+------+------+------|
174 * | Del | F1 | F2 | F3 | F4 | F5 | F6 | - | = | [ | ] | \ |
175 * |------+------+------+------+------+------|------+------+------+------+------+------|
176 * | Shft | F7 | F8 | F9 | F10 | F11 | F12 |ISO # |ISO / | | Up |CTLENT|
177 * |------+------+------+------+------+------+------+------+------+------+------+------|
178 * | | | | | | | | | Left | Down | Right|
179 * `-----------------------------------------------------------------------------------'
180 */
181[_RAISE] = {
182 {KC_GRV, KC_1, KC_2, KC_3, KC_4, KC_5, KC_6, KC_7, KC_8, KC_9, KC_0, KC_BSPC},
183 {KC_DEL, KC_F1, KC_F2, KC_F3, KC_F4, KC_F5, KC_F6, KC_MINS, KC_EQL, KC_LBRC, KC_RBRC, KC_BSLS},
184 {KC_LSFT, KC_F7, KC_F8, KC_F9, KC_F10, KC_F11, KC_F12, KC_NUHS, KC_NUBS, _______, KC_UP, KC_X2},
185 {_______, _______, _______, _______, _______, _______, _______, _______, _______, KC_LEFT, KC_DOWN, KC_RGHT}
186},
187
188/* Plover layer (http://opensteno.org)
189 * ,-----------------------------------------------------------------------------------.
190 * | # | # | # | # | # | # | # | # | # | # | # | # |
191 * |------+------+------+------+------+-------------+------+------+------+------+------|
192 * | | S | T | P | H | * | * | F | P | L | T | D |
193 * |------+------+------+------+------+------|------+------+------+------+------+------|
194 * | | S | K | W | R | * | * | R | B | G | S | Z |
195 * |------+------+------+------+------+------+------+------+------+------+------+------|
196 * | Exit | | | A | O | | E | U | | | |
197 * `-----------------------------------------------------------------------------------'
198 */
199[_PLOVER] = {
200 {KC_1, KC_1, KC_1, KC_1, KC_1, KC_1, KC_1, KC_1, KC_1, KC_1, KC_1, KC_1 },
201 {XXXXXXX, KC_Q, KC_W, KC_E, KC_R, KC_T, KC_Y, KC_U, KC_I, KC_O, KC_P, KC_LBRC},
202 {XXXXXXX, KC_A, KC_S, KC_D, KC_F, KC_G, KC_H, KC_J, KC_K, KC_L, KC_SCLN, KC_QUOT},
203 {EXT_PLV, XXXXXXX, XXXXXXX, KC_C, KC_V, XXXXXXX, XXXXXXX, KC_N, KC_M, XXXXXXX, XXXXXXX, XXXXXXX}
204},
205
206/* Adjust (Lower + Raise)
207 * ,-----------------------------------------------------------------------------------.
208 * | | Reset| | | | | | | | | | Del |
209 * |------+------+------+------+------+-------------+------+------+------+------+------|
210 * | | | |Aud on|Audoff|AGnorm|AGswap|Qwerty|Colemk|Dvorak|Plover| |
211 * |------+------+------+------+------+------|------+------+------+------+------+------|
212 * | |Voice-|Voice+|Mus on|Musoff|MIDIon|MIDIof| | | | | |
213 * |------+------+------+------+------+------+------+------+------+------+------+------|
214 * |Brite | | | | | | | | | | |
215 * `-----------------------------------------------------------------------------------'
216 */
217[_ADJUST] = {
218 {_______, RESET, DEBUG, _______, _______, _______, _______, TERM_ON, TERM_OFF,_______, _______, KC_DEL },
219 {_______, _______, MU_MOD, AU_ON, AU_OFF, AG_NORM, AG_SWAP, QWERTY, COLEMAK, DVORAK, PLOVER, _______},
220 {_______, MUV_DE, MUV_IN, MU_ON, MU_OFF, MI_ON, MI_OFF, _______, _______, _______, _______, _______},
221 {BACKLIT, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______, _______}
222}
223
224
225};
226
227#ifdef AUDIO_ENABLE
228 float plover_song[][2] = SONG(PLOVER_SOUND);
229 float plover_gb_song[][2] = SONG(PLOVER_GOODBYE_SOUND);
230#endif
231
232#ifdef BACKLIGHT_ENABLE
233 bool has_layer_changed = true;
234
235 void matrix_scan_user(void) {
236 uint8_t layer = biton32(layer_state);
237 static uint8_t old_layer = 0;
238
239 if (old_layer != layer) {
240 has_layer_changed = true;
241 old_layer = layer;
242 }
243
244 if (has_layer_changed) {
245 has_layer_changed = false;
246
247 switch (layer) {
248 case _LOWER:
249 backlight_set(1);
250 break;
251 case _QWERTY:
252 backlight_set(2);
253 break;
254 case _RAISE:
255 backlight_set(3);
256 break;
257 case _ADJUST:
258 backlight_set(4);
259 break;
260 }
261 }
262 };
263#endif
264
265bool process_record_user(uint16_t keycode, keyrecord_t *record) {
266 switch (keycode) {
267 case QWERTY:
268 if (record->event.pressed) {
269 print("mode just switched to qwerty and this is a huge string\n");
270 set_single_persistent_default_layer(_QWERTY);
271 }
272 return false;
273 break;
274 case COLEMAK:
275 if (record->event.pressed) {
276 set_single_persistent_default_layer(_COLEMAK);
277 }
278 return false;
279 break;
280 case DVORAK:
281 if (record->event.pressed) {
282 set_single_persistent_default_layer(_DVORAK);
283 }
284 return false;
285 break;
286 case LOWER:
287 if (record->event.pressed) {
288 layer_on(_LOWER);
289 update_tri_layer(_LOWER, _RAISE, _ADJUST);
290 } else {
291 layer_off(_LOWER);
292 update_tri_layer(_LOWER, _RAISE, _ADJUST);
293 }
294 return false;
295 break;
296 case RAISE:
297 if (record->event.pressed) {
298 layer_on(_RAISE);
299 update_tri_layer(_LOWER, _RAISE, _ADJUST);
300 } else {
301 layer_off(_RAISE);
302 update_tri_layer(_LOWER, _RAISE, _ADJUST);
303 }
304 return false;
305 break;
306 case BACKLIT:
307 if (record->event.pressed) {
308 register_code(KC_RSFT);
309 #ifdef BACKLIGHT_ENABLE
310 backlight_step();
311 #endif
312 } else {
313 unregister_code(KC_RSFT);
314 }
315 return false;
316 break;
317 case PLOVER:
318 if (record->event.pressed) {
319 #ifdef AUDIO_ENABLE
320 stop_all_notes();
321 PLAY_SONG(plover_song);
322 #endif
323 layer_off(_RAISE);
324 layer_off(_LOWER);
325 layer_off(_ADJUST);
326 layer_off(_EMOJI);
327 layer_on(_PLOVER);
328 if (!eeconfig_is_enabled()) {
329 eeconfig_init();
330 }
331 keymap_config.raw = eeconfig_read_keymap();
332 keymap_config.nkro = 1;
333 eeconfig_update_keymap(keymap_config.raw);
334 }
335 return false;
336 break;
337 case EXT_PLV:
338 if (record->event.pressed) {
339 #ifdef AUDIO_ENABLE
340 PLAY_SONG(plover_gb_song);
341 #endif
342 layer_off(_PLOVER);
343 }
344 return false;
345 break;
346 case FLIP:
347 if (record->event.pressed) {
348 SEND_STRING("&fliptable;");
349 }
350 return false;
351 break;
352 case CONFUSED:
353 if (record->event.pressed) {
354 SEND_STRING(":-\\");
355 }
356 return false;
357 break;
358 case SHIT:
359 if (record->event.pressed) {
360 SEND_STRING("&shit; ");
361 }
362 return false;
363 break;
364 case CRY:
365 if (record->event.pressed) {
366 SEND_STRING(":'-( ");
367 }
368 return false;
369 break;
370 case LLAP:
371 if (record->event.pressed) {
372 SEND_STRING("&llap; ");
373 }
374 return false;
375 break;
376 case GRIN:
377 if (record->event.pressed) {
378 SEND_STRING(":-D ");
379 }
380 return false;
381 break;
382 case TOUNGE:
383 if (record->event.pressed) {
384 SEND_STRING(":-P ");
385 }
386 return false;
387 break;
388 case JOY:
389 if (record->event.pressed) {
390 SEND_STRING(":-) ");
391 }
392 return false;
393 break;
394 case FROWN:
395 if (record->event.pressed) {
396 SEND_STRING(":-( ");
397 }
398 return false;
399 break;
400 case HEART:
401 if (record->event.pressed) {
402 SEND_STRING("<3 ");
403 }
404 return false;
405 break;
406 case SHRUG:
407 if (record->event.pressed) {
408 SEND_STRING("&shrug; ");
409 }
410 return false;
411 break;
412 case THMBUP:
413 if (record->event.pressed) {
414 SEND_STRING("&thumbup; ");
415 }
416 return false;
417 break;
418 case THMBDN:
419 if (record->event.pressed) {
420 SEND_STRING("&thumbdown; ");
421 }
422 return false;
423 break;
424 case FNGLEFT:
425 if (record->event.pressed) {
426 SEND_STRING("&fingerleft; ");
427 }
428 return false;
429 break;
430 case FNGRIGHT:
431 if (record->event.pressed) {
432 SEND_STRING("&fingerright; ");
433 }
434 return false;
435 break;
436 case WINK:
437 if (record->event.pressed) {
438 SEND_STRING(";-) ");
439 }
440 return false;
441 break;
442 case ABOVE:
443 if (record->event.pressed) {
444 SEND_STRING("&above; ");
445 }
446 return false;
447 break;
448 }
449 return true;
450}
diff --git a/keyboards/planck/keymaps/grahampheath/readme.md b/keyboards/planck/keymaps/grahampheath/readme.md
new file mode 100644
index 000000000..ec8020f18
--- /dev/null
+++ b/keyboards/planck/keymaps/grahampheath/readme.md
@@ -0,0 +1,4 @@
1# Graham's Planck
2
3## Sounds
4I've added a [8ohm 0.5W speaker](http://a.co/6MIKZSy), its a bit large, but it fits in approximately the same space as the ProMicro. I soldered to the pcb hole labeled PC6 on my Rev 3 Planck PCB, and GND on the near by chip. [Pic of an identical mod][https://i1.sndcdn.com/artworks-000128070066-myh0ls-t500x500.jpg] (not mine).
diff --git a/keyboards/planck/keymaps/grahampheath/rules.mk b/keyboards/planck/keymaps/grahampheath/rules.mk
new file mode 100644
index 000000000..2ff606255
--- /dev/null
+++ b/keyboards/planck/keymaps/grahampheath/rules.mk
@@ -0,0 +1,9 @@
1ifndef QUANTUM_DIR
2 include ../../../../Makefile
3endif
4BACKLIGHT_ENABLE = yes # Enable keyboard backlight functionality
5NKRO_ENABLE = yes # N-Key rollover.
6# MOUSEKEY_ENABLE = yes # Mouse mode.
7TAP_DANCE_ENABLE = no # Tap dance enabled.
8UNICODEMAP_ENABLE = no # Unicode keymap (sucks on osx).
9AUDIO_ENABLE = yes # Audio output on port C6