]> git.donarmstrong.com Git - qmk_firmware.git/blob - FAQ-Keymap.md
Updated FAQ Keymap (markdown)
[qmk_firmware.git] / FAQ-Keymap.md
1 # Keymap
2 ## Power key doesn't work
3 Use `KC_PWR` instead of `KC_POWER` or vice versa.
4 - `KC_PWR` works with Windows and Linux, not with OSX.
5 - `KC_POWER` works with OSX and Linux, not with Windows.
6
7 http://geekhack.org/index.php?topic=14290.msg1327264#msg1327264
8
9 ## Oneshot modifier
10 Solves my personal 'the' problem. I often got 'the' or 'THe' wrongly instead of 'The'.  Oneshot Shift mitgates this for me.
11 https://github.com/tmk/tmk_keyboard/issues/67
12
13 ## Modifier/Layer stuck
14 Modifier keys or layers can be stuck unless layer switching is configured properly.
15 For Modifier keys and layer actions you have to place `KC_TRANS` on same position of destination layer to  unregister the modifier key or return to previous layer on release event.
16
17 https://github.com/tmk/tmk_keyboard/blob/master/doc/keymap.md#31-momentary-switching
18 http://geekhack.org/index.php?topic=57008.msg1492604#msg1492604
19
20
21 ## Mechanical Lock Switch Support
22 https://github.com/tmk/tmk_keyboard#mechanical-locking-support
23
24 This feature is for *mechanical lock switch* like this Alps one.
25 http://deskthority.net/wiki/Alps_SKCL_Lock
26
27 Using enabling this feature and using keycodes `LCAP`, `LNUM` or `LSCR` in keymap you can use physical locking CapsLock, NumLock or ScrollLock keys as you expected.
28
29 Old vintage mechanical keyboards occasionally have lock switches but modern ones don't have. ***You don't need this feature in most case and just use keycodes `CAPS`, `NLCK` and `SLCK`.***
30
31
32 ## Input language specific charactors other than ASCII like Cédille 'Ç'
33 NO UNIVERSAL METHOD TO INPUT THOSE WORKS OVER ALL SYSTEMS. You have to define MACRO in way specific to your OS or layout.
34
35 See this post for example code.
36 http://deskthority.net/workshop-f7/tmk-keyboard-firmware-collection-t4478-120.html#p195620
37
38 On **Windows** you can use `AltGr` key or **Alt code**.
39 - http://en.wikipedia.org/wiki/AltGr_key
40 - http://en.wikipedia.org/wiki/Alt_code
41
42 On **Mac** OS defines `Option` key combinations.
43 - http://en.wikipedia.org/wiki/Option_key#Alternative_keyboard_input
44
45 On **Xorg** you can use `compose` key, instead.
46 - http://en.wikipedia.org/wiki/Compose_key
47
48 And see this for **Unicode** input.
49 - http://en.wikipedia.org/wiki/Unicode_input