Docs: Make Bootmagic and Command docs a little easier to read (#3499)

* Make Bootmagic and Command docs a little easier to read * Sometimes Bootmagic/Command is default on * "Escape" pipe character so it renders correctly
author: fauxpark <fauxpark@gmail.com> 2018-07-30 01:42:51 +1000
committer: Drashna Jaelre <drashna@live.com> 2018-07-29 08:42:51 -0700
commit: f2ebafcee8b9f672b7ea5a5fcd93a319397008a1 (patch)
tree: b6d2c0ef26fe792dbb4d7ff7bbaba5771aebe47d /docs/feature_bootmagic.md
parent: 595f3cbe5bb06eab583352a047c89859a6fa0753 (diff)
download: qmk_firmware-f2ebafcee8b9f672b7ea5a5fcd93a319397008a1.tar.gz
qmk_firmware-f2ebafcee8b9f672b7ea5a5fcd93a319397008a1.zip
1 files changed, 86 insertions, 75 deletions
diff --git a/docs/feature_bootmagic.md b/docs/feature_bootmagic.md
index beef6c467..d6915d355 100644
--- a/docs/feature_bootmagic.md
+++ b/docs/feature_bootmagic.md
@@ -1,89 +1,100 @@
-# Bootmagic and Magic Keycodes
+# Bootmagic
-There are 3 separate but related features that allow you to change the behavior of your keyboard without reflashing. While each of them have similar functionality you access that functionality in different ways depending on how your keyboard is configured.
+There are three separate but related features that allow you to change the behavior of your keyboard without reflashing. While each of them have similar functionality, it is accessed in different ways depending on how your keyboard is configured.
-Bootmagic is a system for configuring your keyboard while it initializes. To trigger a Bootmagic command you hold down the bootmagic key (`KC_SPACE` on most keyboards) and one or more command keys.
+**Bootmagic** is a system for configuring your keyboard while it initializes. To trigger a Bootmagic command, hold down the Bootmagic key and one or more command keys.
-Bootmagic Keycodes allow you to access the Bootmagic functionality after your keyboard has initialized. To use Bootmagic Keycodes you assign keycodes starting with `MAGIC_`, much in the same way you define any other key.
+**Bootmagic Keycodes** are prefixed with `MAGIC_`, and allow you to access the Bootmagic functionality *after* your keyboard has initialized. To use the keycodes, assign them to your keymap as you would any other keycode.
-Command is a feature that allows you to control different aspects of your keyboard. Command used to be called Magic. Command is typically accessed by holding Left and Right Shift at the same time, although that can be customized. While it shares some functionality with Bootmagic it also allows you to access functionality that Bootmagic does not. For more information see the [Command](feature_command.md) documentation page.
+**Command**, formerly known as **Magic**, is another feature that allows you to control different aspects of your keyboard. While it shares some functionality with Bootmagic, it also allows you to do things that Bootmagic does not, such as printing version information to the console. For more information, see [Command](feature_command.md).
-## Enabling Bootmagic
+On some keyboards Bootmagic is disabled by default. If this is the case, it must be explicitly enabled in your `rules.mk` with:
-Bootmagic is disabled by default. To use Bootmagic you need to enable it in your `rules.mk` file:
+```make
+BOOTMAGIC_ENABLE = yes
+```
-    BOOTMAGIC_ENABLE = yes
+## Hotkeys
-## Bootmagic Hotkeys and Keycodes
+Hold down the Bootmagic key (Space by default) and the desired hotkey while plugging in your keyboard. For example, holding Space+`B` should cause it to enter the bootloader.
-This table describes the default Hotkeys for Bootmagic and the Keycodes for Magic. These may be overriden at the Keyboard or Keymap level. Some functionality is not available in both methods.
+|Hotkey            |Description                                  |
+|------------------|---------------------------------------------|
+|Escape            |Ignore Bootmagic configuration in EEPROM     |
+|`B`               |Enter the bootloader                         |
+|`D`               |Toggle debugging over serial                 |
+|`X`               |Toggle key matrix debugging                  |
+|`K`               |Toggle keyboard debugging                    |
+|`M`               |Toggle mouse debugging                       |
+|Backspace         |Clear the EEPROM                             |
+|Caps Lock         |Toggle treating Caps Lock as Left Control    |
+|Left Control      |Toggle swapping Caps Lock and Left Control   |
+|Left Alt          |Toggle swapping Left Alt and Left GUI        |
+|Right Alt         |Toggle swapping Right Alt and Right GUI      |
+|Left GUI          |Toggle the GUI keys (useful when gaming)     |
+|<code>&#96;</code>|Toggle swapping <code>&#96;</code> and Escape|
+|`\`               |Toggle swapping `\` and Backspace            |
+|`N`               |Toggle N-Key Rollover (NKRO)                 |
+|`0`               |Make layer 0 the default layer               |
+|`1`               |Make layer 1 the default layer               |
+|`2`               |Make layer 2 the default layer               |
+|`3`               |Make layer 3 the default layer               |
+|`4`               |Make layer 4 the default layer               |
+|`5`               |Make layer 5 the default layer               |
+|`6`               |Make layer 6 the default layer               |
+|`7`               |Make layer 7 the default layer               |
-To use the Hotkey hold down `BOOTMAGIC_KEY_SALT` (`KC_SPACE` by default) and the Hotkey while plugging in your keyboard. To use the Keycode assign that keycode to a layer. For example, if you hold down Space+B while plugging in most keyboards, you will enter bootloader mode.
+## Keycodes
-|Hotkey     |Keycode                           |Description                                             |
+|Keycode                           |Aliases  |Description                               |
-|-----------|----------------------------------|--------------------------------------------------------|
+|----------------------------------|---------|------------------------------------------|
-|`ESC`      |                                  |Skip bootmagic and saved eeprom configuration           |
+|`MAGIC_CAPSLOCK_TO_CONTROL`       |         |Treat Caps Lock as Left Control           |
-|`B`        |`RESET`                           |Enter bootloader instead of firmware                    |
+|`MAGIC_UNCAPSLOCK_TO_CONTROL`     |         |Stop treating Caps Lock as Left Control   |
-|`D`        |`DEBUG`                           |Enable debugging (writes messages to serial)            |
+|`MAGIC_HOST_NKRO`                 |         |Force N-Key Rollover (NKRO) on            |
-|`X`        |                                  |Enable matrix debugging                                 |
+|`MAGIC_UNHOST_NKRO`               |         |Force NKRO off                            |
-|`K`        |                                  |Enable keyboard debugging                               |
+|`MAGIC_TOGGLE_NKRO`               |         |Turn NKRO on or off                       |
-|`M`        |                                  |Enable mouse debugging                                  |
+|`MAGIC_NO_GUI`                    |         |Disable the GUI keys (useful when gaming) |
-|`BACKSPACE`|                                  |Clear the saved settings from flash                     |
+|`MAGIC_UNNO_GUI`                  |         |Enable the GUI keys                       |
-|`CAPSLOCK` |`MAGIC_CAPSLOCK_TO_CONTROL`       |Treat `Capslock` as `Control`                           |
+|`MAGIC_SWAP_ALT_GUI`              |`AG_SWAP`|Swap Alt and GUI on both sides (for macOS)|
-|           |`MAGIC_UNCAPSLOCK_TO_CONTROL`     |Stop treating CapsLock as Control                       |
+|`MAGIC_UNSWAP_ALT_GUI`            |`AG_NORM`|Unswap Left Alt and Left GUI              |
-|`LCTRL`    |`MAGIC_SWAP_CONTROL_CAPSLOCK`     |Swap `Control` and `Capslock`                           |
+|`MAGIC_SWAP_BACKSLASH_BACKSPACE`  |         |Swap `\` and Backspace                    |
-|           |`MAGIC_UNSWAP_CONTROL_CAPSLOCK`   |Unswap Left Control and Caps Lock                       |
+|`MAGIC_UNSWAP_BACKSLASH_BACKSPACE`|         |Unswap `\` and Backspace                  |
-|           |`MAGIC_SWAP_ALT_GUI`              |Swap Alt and GUI on both sides                          |
+|`MAGIC_SWAP_CONTROL_CAPSLOCK`     |         |Swap Left Control and Caps Lock           |
-|           |`MAGIC_UNSWAP_ALT_GUI`            |Unswap Left Alt and GUI                                 |
+|`MAGIC_UNSWAP_CONTROL_CAPSLOCK`   |         |Unswap Left Control and Caps Lock         |
-|`LALT`     |`MAGIC_SWAP_LALT_LGUI`            |Swap Left `Alt` and `GUI`, e.g. for OSX Opt and Cmd     |
+|`MAGIC_SWAP_GRAVE_ESC`            |         |Swap <code>&#96;</code> and Escape        |
-|           |`MAGIC_UNSWAP_LALT_LGUI`          |Unswap Left Alt and GUI                                 |
+|`MAGIC_UNSWAP_GRAVE_ESC`          |         |Unswap <code>&#96;</code> and Escape      |
-|`RALT`     |`MAGIC_SWAP_RALT_RGUI`            |Swap Right `Alt` and `GUI`                              |
+|`MAGIC_SWAP_LALT_LGUI`            |         |Swap Left Alt and Left GUI                |
-|           |`MAGIC_UNSWAP_RALT_RGUI`          |Unswap Right Alt and GUI                                |
+|`MAGIC_UNSWAP_LALT_LGUI`          |         |Unswap Left Alt and Left GUI              |
-|`LGUI`     |`MAGIC_NO_GUI`                    |Disable GUI key - e.g. disable Windows key during gaming|
+|`MAGIC_SWAP_RALT_RGUI`            |         |Swap Right Alt and Right GUI              |
-|           |`MAGIC_UNNO_GUI`                  |Enable the GUI key                                      |
+|`MAGIC_UNSWAP_RALT_RGUI`          |         |Unswap Right Alt and Right GUI            |
-|`GRAVE`    |`MAGIC_SWAP_GRAVE_ESC`            |Swap `\`~` and `ESC`                                    |
-|           |`MAGIC_UNSWAP_GRAVE_ESC`          |Unswap `\`~` and Escape                                 |
-|`BACKSLASH`|`MAGIC_SWAP_BACKSLASH_BACKSPACE`  |Swap Blackslash and Backspace                           |
-|           |`MAGIC_UNSWAP_BACKSLASH_BACKSPACE`|Unswap Backslash and Backspace                          |
-|`N`        |`MAGIC_HOST_NKRO`                 |Force N-Key Rollover (NKRO) on                          |
-|           |`MAGIC_UNHOST_NKRO`               |Force NKRO off                                          |
-|           |`MAGIC_TOGGLE_NKRO`               |Toggle NKRO on or off                                   |
-|`0`        |`DF(0)`                           |Make Layer 0 the default layer at bootup                |
-|`1`        |`DF(1)`                           |Make Layer 1 the default layer at bootup                |
-|`2`        |`DF(2)`                           |Make Layer 2 the default layer at bootup                |
-|`3`        |`DF(3)`                           |Make Layer 3 the default layer at bootup                |
-|`4`        |`DF(4)`                           |Make Layer 4 the default layer at bootup                |
-|`5`        |`DF(5)`                           |Make Layer 5 the default layer at bootup                |
-|`6`        |`DF(6)`                           |Make Layer 6 the default layer at bootup                |
-|`7`        |`DF(7)`                           |Make Layer 7 the default layer at bootup                |
-## Bootmagic Configuration
+## Configuration
-When setting up your keyboard and/or keymap there are a number of `#define`s that control the behavior of Bootmagic. To use these put them in your `config.h`, either at the keyboard or keymap level.
+If you would like to change the hotkey assignments for Bootmagic, `#define` these in your `config.h` at either the keyboard or keymap level.
-|Define |Default|Description |
+|Define                                  |Default      |Description                                        |
-|-------|-------|------------|
+|----------------------------------------|-------------|---------------------------------------------------|
-|`BOOTMAGIC_KEY_SALT`|`KC_SPACE`|The key to hold down to trigger Bootmagic during initialization.|
+|`BOOTMAGIC_KEY_SALT`                    |`KC_SPACE`   |The Bootmagic key                                  |
-|`BOOTMAGIC_KEY_SKIP`|`KC_ESC`|The Hotkey to ignore saved eeprom configuration.|
+|`BOOTMAGIC_KEY_SKIP`                    |`KC_ESC`     |Ignore Bootmagic configuration in EEPROM           |
-|`BOOTMAGIC_KEY_EEPROM_CLEAR`|`KC_BSPACE`|The hotkey to clear the saved eeprom configuration.|
+|`BOOTMAGIC_KEY_EEPROM_CLEAR`            |`KC_BSPACE`  |Clear the EEPROM configuration                     |
-|`BOOTMAGIC_KEY_BOOTLOADER`|`KC_B`|The hotkey to enter the bootloader.|
+|`BOOTMAGIC_KEY_BOOTLOADER`              |`KC_B`       |Enter the bootloader                               |
-|`BOOTMAGIC_KEY_DEBUG_ENABLE`|`KC_D`|The hotkey to enable debug mode.|
+|`BOOTMAGIC_KEY_DEBUG_ENABLE`            |`KC_D`       |Toggle debugging over serial                       |
-|`BOOTMAGIC_KEY_DEBUG_MATRIX`|`KC_X`|The hotkey to enable matrix debugging mode.|
+|`BOOTMAGIC_KEY_DEBUG_MATRIX`            |`KC_X`       |Toggle matrix debugging                            |
-|`BOOTMAGIC_KEY_DEBUG_KEYBOARD`|`KC_K`|The hotkey to enable keyboard debugging mode.|
+|`BOOTMAGIC_KEY_DEBUG_KEYBOARD`          |`KC_K`       |Toggle keyboard debugging                          |
-|`BOOTMAGIC_KEY_DEBUG_MOUSE`|`KC_M`|The hotkey to enable mouse debugging mode.|
+|`BOOTMAGIC_KEY_DEBUG_MOUSE`             |`KC_M`       |Toggle mouse debugging                             |
-|`BOOTMAGIC_KEY_SWAP_CONTROL_CAPSLOCK`|`KC_LCTRL`||
+|`BOOTMAGIC_KEY_SWAP_CONTROL_CAPSLOCK`   |`KC_LCTRL`   |Swap Left Control and Caps Lock                    |
-|`BOOTMAGIC_KEY_CAPSLOCK_TO_CONTROL`|`KC_CAPSLOCK`||
+|`BOOTMAGIC_KEY_CAPSLOCK_TO_CONTROL`     |`KC_CAPSLOCK`|Toggle treating Caps Lock as Left Control          |
-|`BOOTMAGIC_KEY_SWAP_LALT_LGUI`|`KC_LALT`||
+|`BOOTMAGIC_KEY_SWAP_LALT_LGUI`          |`KC_LALT`    |Toggle swapping Left Alt and Left GUI (for macOS)  |
-|`BOOTMAGIC_KEY_SWAP_RALT_RGUI`|`KC_RALT`||
+|`BOOTMAGIC_KEY_SWAP_RALT_RGUI`          |`KC_RALT`    |Toggle swapping Right Alt and Right GUI (for macOS)|
-|`BOOTMAGIC_KEY_NO_GUI`|`KC_LGUI`||
+|`BOOTMAGIC_KEY_NO_GUI`                  |`KC_LGUI`    |Toggle the GUI keys (useful when gaming)           |
-|`BOOTMAGIC_KEY_SWAP_GRAVE_ESC`|`KC_GRAVE`||
+|`BOOTMAGIC_KEY_SWAP_GRAVE_ESC`          |`KC_GRAVE`   |Toggle swapping <code>&#96;</code> and Escape      |
-|`BOOTMAGIC_KEY_SWAP_BACKSLASH_BACKSPACE`|`KC_BSLASH`||
+|`BOOTMAGIC_KEY_SWAP_BACKSLASH_BACKSPACE`|`KC_BSLASH`  |Toggle swapping `\` and Backspace                  |
-|`BOOTMAGIC_HOST_NKRO`|`KC_N`||
+|`BOOTMAGIC_HOST_NKRO`                   |`KC_N`       |Toggle N-Key Rollover (NKRO)                       |
-|`BOOTMAGIC_KEY_DEFAULT_LAYER_0`|`KC_0`|Hotkey to set Layer 0 as the default layer|
+|`BOOTMAGIC_KEY_DEFAULT_LAYER_0`         |`KC_0`       |Make layer 0 the default layer                     |
-|`BOOTMAGIC_KEY_DEFAULT_LAYER_1`|`KC_1`|Hotkey to set Layer 1 as the default layer|
+|`BOOTMAGIC_KEY_DEFAULT_LAYER_1`         |`KC_1`       |Make layer 1 the default layer                     |
-|`BOOTMAGIC_KEY_DEFAULT_LAYER_2`|`KC_2`|Hotkey to set Layer 2 as the default layer|
+|`BOOTMAGIC_KEY_DEFAULT_LAYER_2`         |`KC_2`       |Make layer 2 the default layer                     |
-|`BOOTMAGIC_KEY_DEFAULT_LAYER_3`|`KC_3`|Hotkey to set Layer 3 as the default layer|
+|`BOOTMAGIC_KEY_DEFAULT_LAYER_3`         |`KC_3`       |Make layer 3 the default layer                     |
-|`BOOTMAGIC_KEY_DEFAULT_LAYER_4`|`KC_4`|Hotkey to set Layer 4 as the default layer|
+|`BOOTMAGIC_KEY_DEFAULT_LAYER_4`         |`KC_4`       |Make layer 4 the default layer                     |
-|`BOOTMAGIC_KEY_DEFAULT_LAYER_5`|`KC_5`|Hotkey to set Layer 5 as the default layer|
+|`BOOTMAGIC_KEY_DEFAULT_LAYER_5`         |`KC_5`       |Make layer 5 the default layer                     |
-|`BOOTMAGIC_KEY_DEFAULT_LAYER_6`|`KC_6`|Hotkey to set Layer 6 as the default layer|
+|`BOOTMAGIC_KEY_DEFAULT_LAYER_6`         |`KC_6`       |Make layer 6 the default layer                     |
-|`BOOTMAGIC_KEY_DEFAULT_LAYER_7`|`KC_7`|Hotkey to set Layer 7 as the default layer|
+|`BOOTMAGIC_KEY_DEFAULT_LAYER_7`         |`KC_7`       |Make layer 7 the default layer                     |
author	fauxpark <fauxpark@gmail.com>	2018-07-30 01:42:51 +1000
committer	Drashna Jaelre <drashna@live.com>	2018-07-29 08:42:51 -0700
commit	f2ebafcee8b9f672b7ea5a5fcd93a319397008a1 (patch)
tree	b6d2c0ef26fe792dbb4d7ff7bbaba5771aebe47d /docs/feature_bootmagic.md
parent	595f3cbe5bb06eab583352a047c89859a6fa0753 (diff)
download	qmk_firmware-f2ebafcee8b9f672b7ea5a5fcd93a319397008a1.tar.gz qmk_firmware-f2ebafcee8b9f672b7ea5a5fcd93a319397008a1.zip

diff --git a/docs/feature_bootmagic.md b/docs/feature_bootmagic.md index beef6c467..d6915d355 100644 --- a/docs/feature_bootmagic.md +++ b/docs/feature_bootmagic.md
@@ -1,89 +1,100 @@
1	# Bootmagic and Magic Keycodes	1	# Bootmagic
2		2
3	There are 3 separate but related features that allow you to change the behavior of your keyboard without reflashing. While each of them have similar functionality you access that functionality in different ways depending on how your keyboard is configured.	3	There are three separate but related features that allow you to change the behavior of your keyboard without reflashing. While each of them have similar functionality, it is accessed in different ways depending on how your keyboard is configured.
4		4
5	Bootmagic is a system for configuring your keyboard while it initializes. To trigger a Bootmagic command you hold down the bootmagic key (`KC_SPACE` on most keyboards) and one or more command keys.	5	Bootmagic is a system for configuring your keyboard while it initializes. To trigger a Bootmagic command, hold down the Bootmagic key and one or more command keys.
6		6
7	Bootmagic Keycodes allow you to access the Bootmagic functionality after your keyboard has initialized. To use Bootmagic Keycodes you assign keycodes starting with `MAGIC_`, much in the same way you define any other key.	7	Bootmagic Keycodes are prefixed with `MAGIC_`, and allow you to access the Bootmagic functionality after your keyboard has initialized. To use the keycodes, assign them to your keymap as you would any other keycode.
8		8
9	Command is a feature that allows you to control different aspects of your keyboard. Command used to be called Magic. Command is typically accessed by holding Left and Right Shift at the same time, although that can be customized. While it shares some functionality with Bootmagic it also allows you to access functionality that Bootmagic does not. For more information see the [Command](feature_command.md) documentation page.	9	Command, formerly known as Magic, is another feature that allows you to control different aspects of your keyboard. While it shares some functionality with Bootmagic, it also allows you to do things that Bootmagic does not, such as printing version information to the console. For more information, see [Command](feature_command.md).
10		10
11	## Enabling Bootmagic	11	On some keyboards Bootmagic is disabled by default. If this is the case, it must be explicitly enabled in your `rules.mk` with:
12		12
13	Bootmagic is disabled by default. To use Bootmagic you need to enable it in your `rules.mk` file:	13	```make
		14	BOOTMAGIC_ENABLE = yes
		15	```
14		16
15	BOOTMAGIC_ENABLE = yes	17	## Hotkeys
16		18
17	## Bootmagic Hotkeys and Keycodes	19	Hold down the Bootmagic key (Space by default) and the desired hotkey while plugging in your keyboard. For example, holding Space+`B` should cause it to enter the bootloader.
18		20
19	This table describes the default Hotkeys for Bootmagic and the Keycodes for Magic. These may be overriden at the Keyboard or Keymap level. Some functionality is not available in both methods.	21	\|Hotkey \|Description \|
		22	\|------------------\|---------------------------------------------\|
		23	\|Escape \|Ignore Bootmagic configuration in EEPROM \|
		24	\|`B` \|Enter the bootloader \|
		25	\|`D` \|Toggle debugging over serial \|
		26	\|`X` \|Toggle key matrix debugging \|
		27	\|`K` \|Toggle keyboard debugging \|
		28	\|`M` \|Toggle mouse debugging \|
		29	\|Backspace \|Clear the EEPROM \|
		30	\|Caps Lock \|Toggle treating Caps Lock as Left Control \|
		31	\|Left Control \|Toggle swapping Caps Lock and Left Control \|
		32	\|Left Alt \|Toggle swapping Left Alt and Left GUI \|
		33	\|Right Alt \|Toggle swapping Right Alt and Right GUI \|
		34	\|Left GUI \|Toggle the GUI keys (useful when gaming) \|
		35	\|<code>`</code>\|Toggle swapping <code>`</code> and Escape\|
		36	\|`\` \|Toggle swapping `\` and Backspace \|
		37	\|`N` \|Toggle N-Key Rollover (NKRO) \|
		38	\|`0` \|Make layer 0 the default layer \|
		39	\|`1` \|Make layer 1 the default layer \|
		40	\|`2` \|Make layer 2 the default layer \|
		41	\|`3` \|Make layer 3 the default layer \|
		42	\|`4` \|Make layer 4 the default layer \|
		43	\|`5` \|Make layer 5 the default layer \|
		44	\|`6` \|Make layer 6 the default layer \|
		45	\|`7` \|Make layer 7 the default layer \|
20		46
21	To use the Hotkey hold down `BOOTMAGIC_KEY_SALT` (`KC_SPACE` by default) and the Hotkey while plugging in your keyboard. To use the Keycode assign that keycode to a layer. For example, if you hold down Space+B while plugging in most keyboards, you will enter bootloader mode.	47	## Keycodes
22		48
23	\|Hotkey \|Keycode \|Description \|	49	\|Keycode \|Aliases \|Description \|
24	\|-----------\|----------------------------------\|--------------------------------------------------------\|	50	\|----------------------------------\|---------\|------------------------------------------\|
25	\|`ESC` \| \|Skip bootmagic and saved eeprom configuration \|	51	\|`MAGIC_CAPSLOCK_TO_CONTROL` \| \|Treat Caps Lock as Left Control \|
26	\|`B` \|`RESET` \|Enter bootloader instead of firmware \|	52	\|`MAGIC_UNCAPSLOCK_TO_CONTROL` \| \|Stop treating Caps Lock as Left Control \|
27	\|`D` \|`DEBUG` \|Enable debugging (writes messages to serial) \|	53	\|`MAGIC_HOST_NKRO` \| \|Force N-Key Rollover (NKRO) on \|
28	\|`X` \| \|Enable matrix debugging \|	54	\|`MAGIC_UNHOST_NKRO` \| \|Force NKRO off \|
29	\|`K` \| \|Enable keyboard debugging \|	55	\|`MAGIC_TOGGLE_NKRO` \| \|Turn NKRO on or off \|
30	\|`M` \| \|Enable mouse debugging \|	56	\|`MAGIC_NO_GUI` \| \|Disable the GUI keys (useful when gaming) \|
31	\|`BACKSPACE`\| \|Clear the saved settings from flash \|	57	\|`MAGIC_UNNO_GUI` \| \|Enable the GUI keys \|
32	\|`CAPSLOCK` \|`MAGIC_CAPSLOCK_TO_CONTROL` \|Treat `Capslock` as `Control` \|	58	\|`MAGIC_SWAP_ALT_GUI` \|`AG_SWAP`\|Swap Alt and GUI on both sides (for macOS)\|
33	\| \|`MAGIC_UNCAPSLOCK_TO_CONTROL` \|Stop treating CapsLock as Control \|	59	\|`MAGIC_UNSWAP_ALT_GUI` \|`AG_NORM`\|Unswap Left Alt and Left GUI \|
34	\|`LCTRL` \|`MAGIC_SWAP_CONTROL_CAPSLOCK` \|Swap `Control` and `Capslock` \|	60	\|`MAGIC_SWAP_BACKSLASH_BACKSPACE` \| \|Swap `\` and Backspace \|
35	\| \|`MAGIC_UNSWAP_CONTROL_CAPSLOCK` \|Unswap Left Control and Caps Lock \|	61	\|`MAGIC_UNSWAP_BACKSLASH_BACKSPACE`\| \|Unswap `\` and Backspace \|
36	\| \|`MAGIC_SWAP_ALT_GUI` \|Swap Alt and GUI on both sides \|	62	\|`MAGIC_SWAP_CONTROL_CAPSLOCK` \| \|Swap Left Control and Caps Lock \|
37	\| \|`MAGIC_UNSWAP_ALT_GUI` \|Unswap Left Alt and GUI \|	63	\|`MAGIC_UNSWAP_CONTROL_CAPSLOCK` \| \|Unswap Left Control and Caps Lock \|
38	\|`LALT` \|`MAGIC_SWAP_LALT_LGUI` \|Swap Left `Alt` and `GUI`, e.g. for OSX Opt and Cmd \|	64	\|`MAGIC_SWAP_GRAVE_ESC` \| \|Swap <code>`</code> and Escape \|
39	\| \|`MAGIC_UNSWAP_LALT_LGUI` \|Unswap Left Alt and GUI \|	65	\|`MAGIC_UNSWAP_GRAVE_ESC` \| \|Unswap <code>`</code> and Escape \|
40	\|`RALT` \|`MAGIC_SWAP_RALT_RGUI` \|Swap Right `Alt` and `GUI` \|	66	\|`MAGIC_SWAP_LALT_LGUI` \| \|Swap Left Alt and Left GUI \|
41	\| \|`MAGIC_UNSWAP_RALT_RGUI` \|Unswap Right Alt and GUI \|	67	\|`MAGIC_UNSWAP_LALT_LGUI` \| \|Unswap Left Alt and Left GUI \|
42	\|`LGUI` \|`MAGIC_NO_GUI` \|Disable GUI key - e.g. disable Windows key during gaming\|	68	\|`MAGIC_SWAP_RALT_RGUI` \| \|Swap Right Alt and Right GUI \|
43	\| \|`MAGIC_UNNO_GUI` \|Enable the GUI key \|	69	\|`MAGIC_UNSWAP_RALT_RGUI` \| \|Unswap Right Alt and Right GUI \|
44	\|`GRAVE` \|`MAGIC_SWAP_GRAVE_ESC` \|Swap `\`~` and `ESC` \|
45	\| \|`MAGIC_UNSWAP_GRAVE_ESC` \|Unswap `\`~` and Escape \|
46	\|`BACKSLASH`\|`MAGIC_SWAP_BACKSLASH_BACKSPACE` \|Swap Blackslash and Backspace \|
47	\| \|`MAGIC_UNSWAP_BACKSLASH_BACKSPACE`\|Unswap Backslash and Backspace \|
48	\|`N` \|`MAGIC_HOST_NKRO` \|Force N-Key Rollover (NKRO) on \|
49	\| \|`MAGIC_UNHOST_NKRO` \|Force NKRO off \|
50	\| \|`MAGIC_TOGGLE_NKRO` \|Toggle NKRO on or off \|
51	\|`0` \|`DF(0)` \|Make Layer 0 the default layer at bootup \|
52	\|`1` \|`DF(1)` \|Make Layer 1 the default layer at bootup \|
53	\|`2` \|`DF(2)` \|Make Layer 2 the default layer at bootup \|
54	\|`3` \|`DF(3)` \|Make Layer 3 the default layer at bootup \|
55	\|`4` \|`DF(4)` \|Make Layer 4 the default layer at bootup \|
56	\|`5` \|`DF(5)` \|Make Layer 5 the default layer at bootup \|
57	\|`6` \|`DF(6)` \|Make Layer 6 the default layer at bootup \|
58	\|`7` \|`DF(7)` \|Make Layer 7 the default layer at bootup \|
59		70
60	## Bootmagic Configuration	71	## Configuration
61		72
62	When setting up your keyboard and/or keymap there are a number of `#define`s that control the behavior of Bootmagic. To use these put them in your `config.h`, either at the keyboard or keymap level.	73	If you would like to change the hotkey assignments for Bootmagic, `#define` these in your `config.h` at either the keyboard or keymap level.
63		74
64	\|Define \|Default\|Description \|	75	\|Define \|Default \|Description \|
65	\|-------\|-------\|------------\|	76	\|----------------------------------------\|-------------\|---------------------------------------------------\|
66	\|`BOOTMAGIC_KEY_SALT`\|`KC_SPACE`\|The key to hold down to trigger Bootmagic during initialization.\|	77	\|`BOOTMAGIC_KEY_SALT` \|`KC_SPACE` \|The Bootmagic key \|
67	\|`BOOTMAGIC_KEY_SKIP`\|`KC_ESC`\|The Hotkey to ignore saved eeprom configuration.\|	78	\|`BOOTMAGIC_KEY_SKIP` \|`KC_ESC` \|Ignore Bootmagic configuration in EEPROM \|
68	\|`BOOTMAGIC_KEY_EEPROM_CLEAR`\|`KC_BSPACE`\|The hotkey to clear the saved eeprom configuration.\|	79	\|`BOOTMAGIC_KEY_EEPROM_CLEAR` \|`KC_BSPACE` \|Clear the EEPROM configuration \|
69	\|`BOOTMAGIC_KEY_BOOTLOADER`\|`KC_B`\|The hotkey to enter the bootloader.\|	80	\|`BOOTMAGIC_KEY_BOOTLOADER` \|`KC_B` \|Enter the bootloader \|
70	\|`BOOTMAGIC_KEY_DEBUG_ENABLE`\|`KC_D`\|The hotkey to enable debug mode.\|	81	\|`BOOTMAGIC_KEY_DEBUG_ENABLE` \|`KC_D` \|Toggle debugging over serial \|
71	\|`BOOTMAGIC_KEY_DEBUG_MATRIX`\|`KC_X`\|The hotkey to enable matrix debugging mode.\|	82	\|`BOOTMAGIC_KEY_DEBUG_MATRIX` \|`KC_X` \|Toggle matrix debugging \|
72	\|`BOOTMAGIC_KEY_DEBUG_KEYBOARD`\|`KC_K`\|The hotkey to enable keyboard debugging mode.\|	83	\|`BOOTMAGIC_KEY_DEBUG_KEYBOARD` \|`KC_K` \|Toggle keyboard debugging \|
73	\|`BOOTMAGIC_KEY_DEBUG_MOUSE`\|`KC_M`\|The hotkey to enable mouse debugging mode.\|	84	\|`BOOTMAGIC_KEY_DEBUG_MOUSE` \|`KC_M` \|Toggle mouse debugging \|
74	\|`BOOTMAGIC_KEY_SWAP_CONTROL_CAPSLOCK`\|`KC_LCTRL`\|\|	85	\|`BOOTMAGIC_KEY_SWAP_CONTROL_CAPSLOCK` \|`KC_LCTRL` \|Swap Left Control and Caps Lock \|
75	\|`BOOTMAGIC_KEY_CAPSLOCK_TO_CONTROL`\|`KC_CAPSLOCK`\|\|	86	\|`BOOTMAGIC_KEY_CAPSLOCK_TO_CONTROL` \|`KC_CAPSLOCK`\|Toggle treating Caps Lock as Left Control \|
76	\|`BOOTMAGIC_KEY_SWAP_LALT_LGUI`\|`KC_LALT`\|\|	87	\|`BOOTMAGIC_KEY_SWAP_LALT_LGUI` \|`KC_LALT` \|Toggle swapping Left Alt and Left GUI (for macOS) \|
77	\|`BOOTMAGIC_KEY_SWAP_RALT_RGUI`\|`KC_RALT`\|\|	88	\|`BOOTMAGIC_KEY_SWAP_RALT_RGUI` \|`KC_RALT` \|Toggle swapping Right Alt and Right GUI (for macOS)\|
78	\|`BOOTMAGIC_KEY_NO_GUI`\|`KC_LGUI`\|\|	89	\|`BOOTMAGIC_KEY_NO_GUI` \|`KC_LGUI` \|Toggle the GUI keys (useful when gaming) \|
79	\|`BOOTMAGIC_KEY_SWAP_GRAVE_ESC`\|`KC_GRAVE`\|\|	90	\|`BOOTMAGIC_KEY_SWAP_GRAVE_ESC` \|`KC_GRAVE` \|Toggle swapping <code>`</code> and Escape \|
80	\|`BOOTMAGIC_KEY_SWAP_BACKSLASH_BACKSPACE`\|`KC_BSLASH`\|\|	91	\|`BOOTMAGIC_KEY_SWAP_BACKSLASH_BACKSPACE`\|`KC_BSLASH` \|Toggle swapping `\` and Backspace \|
81	\|`BOOTMAGIC_HOST_NKRO`\|`KC_N`\|\|	92	\|`BOOTMAGIC_HOST_NKRO` \|`KC_N` \|Toggle N-Key Rollover (NKRO) \|
82	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_0`\|`KC_0`\|Hotkey to set Layer 0 as the default layer\|	93	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_0` \|`KC_0` \|Make layer 0 the default layer \|
83	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_1`\|`KC_1`\|Hotkey to set Layer 1 as the default layer\|	94	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_1` \|`KC_1` \|Make layer 1 the default layer \|
84	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_2`\|`KC_2`\|Hotkey to set Layer 2 as the default layer\|	95	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_2` \|`KC_2` \|Make layer 2 the default layer \|
85	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_3`\|`KC_3`\|Hotkey to set Layer 3 as the default layer\|	96	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_3` \|`KC_3` \|Make layer 3 the default layer \|
86	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_4`\|`KC_4`\|Hotkey to set Layer 4 as the default layer\|	97	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_4` \|`KC_4` \|Make layer 4 the default layer \|
87	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_5`\|`KC_5`\|Hotkey to set Layer 5 as the default layer\|	98	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_5` \|`KC_5` \|Make layer 5 the default layer \|
88	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_6`\|`KC_6`\|Hotkey to set Layer 6 as the default layer\|	99	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_6` \|`KC_6` \|Make layer 6 the default layer \|
89	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_7`\|`KC_7`\|Hotkey to set Layer 7 as the default layer\|	100	\|`BOOTMAGIC_KEY_DEFAULT_LAYER_7` \|`KC_7` \|Make layer 7 the default layer \|