quantum/keymap_common.c

   1 /*
   2 Copyright 2012-2017 Jun Wako <wakojun@gmail.com>
   3
   4 This program is free software: you can redistribute it and/or modify
   5 it under the terms of the GNU General Public License as published by
   6 the Free Software Foundation, either version 2 of the License, or
   7 (at your option) any later version.
   8
   9 This program is distributed in the hope that it will be useful,
  10 but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 GNU General Public License for more details.
  13
  14 You should have received a copy of the GNU General Public License
  15 along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16 */
  17
  18 #include "keymap.h"
  19 #include "report.h"
  20 #include "keycode.h"
  21 #include "action_layer.h"
  22 #if defined(__AVR__)
  23 #    include <util/delay.h>
  24 #    include <stdio.h>
  25 #endif
  26 #include "action.h"
  27 #include "action_macro.h"
  28 #include "debug.h"
  29 #include "backlight.h"
  30 #include "quantum.h"
  31
  32 #ifdef MIDI_ENABLE
  33 #    include "process_midi.h"
  34 #endif
  35
  36 extern keymap_config_t keymap_config;
  37
  38 #include <inttypes.h>
  39
  40 /* converts key to action */
  41 action_t action_for_key(uint8_t layer, keypos_t key) {
  42     // 16bit keycodes - important
  43     uint16_t keycode = keymap_key_to_keycode(layer, key);
  44
  45     // keycode remapping
  46     keycode = keycode_config(keycode);
  47
  48     action_t action;
  49     uint8_t  action_layer, when, mod;
  50
  51     switch (keycode) {
  52         case KC_FN0 ... KC_FN31:
  53             action.code = keymap_function_id_to_action(FN_INDEX(keycode));
  54             break;
  55         case KC_A ... KC_EXSEL:
  56         case KC_LCTRL ... KC_RGUI:
  57             action.code = ACTION_KEY(keycode);
  58             break;
  59         case KC_SYSTEM_POWER ... KC_SYSTEM_WAKE:
  60             action.code = ACTION_USAGE_SYSTEM(KEYCODE2SYSTEM(keycode));
  61             break;
  62         case KC_AUDIO_MUTE ... KC_BRIGHTNESS_DOWN:
  63             action.code = ACTION_USAGE_CONSUMER(KEYCODE2CONSUMER(keycode));
  64             break;
  65         case KC_MS_UP ... KC_MS_ACCEL2:
  66             action.code = ACTION_MOUSEKEY(keycode);
  67             break;
  68         case KC_TRNS:
  69             action.code = ACTION_TRANSPARENT;
  70             break;
  71         case QK_MODS ... QK_MODS_MAX:;
  72             // Has a modifier
  73             // Split it up
  74             action.code = ACTION_MODS_KEY(keycode >> 8, keycode & 0xFF);  // adds modifier to key
  75             break;
  76         case QK_FUNCTION ... QK_FUNCTION_MAX:;
  77             // Is a shortcut for function action_layer, pull last 12bits
  78             // This means we have 4,096 FN macros at our disposal
  79             action.code = keymap_function_id_to_action((int)keycode & 0xFFF);
  80             break;
  81         case QK_MACRO ... QK_MACRO_MAX:
  82             if (keycode & 0x800)  // tap macros have upper bit set
  83                 action.code = ACTION_MACRO_TAP(keycode & 0xFF);
  84             else
  85                 action.code = ACTION_MACRO(keycode & 0xFF);
  86             break;
  87         case QK_LAYER_TAP ... QK_LAYER_TAP_MAX:
  88             action.code = ACTION_LAYER_TAP_KEY((keycode >> 0x8) & 0xF, keycode & 0xFF);
  89             break;
  90         case QK_TO ... QK_TO_MAX:;
  91             // Layer set "GOTO"
  92             when         = (keycode >> 0x4) & 0x3;
  93             action_layer = keycode & 0xF;
  94             action.code  = ACTION_LAYER_SET(action_layer, when);
  95             break;
  96         case QK_MOMENTARY ... QK_MOMENTARY_MAX:;
  97             // Momentary action_layer
  98             action_layer = keycode & 0xFF;
  99             action.code  = ACTION_LAYER_MOMENTARY(action_layer);
 100             break;
 101         case QK_DEF_LAYER ... QK_DEF_LAYER_MAX:;
 102             // Set default action_layer
 103             action_layer = keycode & 0xFF;
 104             action.code  = ACTION_DEFAULT_LAYER_SET(action_layer);
 105             break;
 106         case QK_TOGGLE_LAYER ... QK_TOGGLE_LAYER_MAX:;
 107             // Set toggle
 108             action_layer = keycode & 0xFF;
 109             action.code  = ACTION_LAYER_TOGGLE(action_layer);
 110             break;
 111         case QK_ONE_SHOT_LAYER ... QK_ONE_SHOT_LAYER_MAX:;
 112             // OSL(action_layer) - One-shot action_layer
 113             action_layer = keycode & 0xFF;
 114             action.code  = ACTION_LAYER_ONESHOT(action_layer);
 115             break;
 116         case QK_ONE_SHOT_MOD ... QK_ONE_SHOT_MOD_MAX:;
 117             // OSM(mod) - One-shot mod
 118             mod         = mod_config(keycode & 0xFF);
 119             action.code = ACTION_MODS_ONESHOT(mod);
 120             break;
 121         case QK_LAYER_TAP_TOGGLE ... QK_LAYER_TAP_TOGGLE_MAX:
 122             action.code = ACTION_LAYER_TAP_TOGGLE(keycode & 0xFF);
 123             break;
 124         case QK_LAYER_MOD ... QK_LAYER_MOD_MAX:
 125             mod          = mod_config(keycode & 0xF);
 126             action_layer = (keycode >> 4) & 0xF;
 127             action.code  = ACTION_LAYER_MODS(action_layer, mod);
 128             break;
 129         case QK_MOD_TAP ... QK_MOD_TAP_MAX:
 130             mod         = mod_config((keycode >> 0x8) & 0x1F);
 131             action.code = ACTION_MODS_TAP_KEY(mod, keycode & 0xFF);
 132             break;
 133 #ifdef BACKLIGHT_ENABLE
 134         case BL_ON:
 135             action.code = ACTION_BACKLIGHT_ON();
 136             break;
 137         case BL_OFF:
 138             action.code = ACTION_BACKLIGHT_OFF();
 139             break;
 140         case BL_DEC:
 141             action.code = ACTION_BACKLIGHT_DECREASE();
 142             break;
 143         case BL_INC:
 144             action.code = ACTION_BACKLIGHT_INCREASE();
 145             break;
 146         case BL_TOGG:
 147             action.code = ACTION_BACKLIGHT_TOGGLE();
 148             break;
 149         case BL_STEP:
 150             action.code = ACTION_BACKLIGHT_STEP();
 151             break;
 152 #endif
 153 #ifdef SWAP_HANDS_ENABLE
 154         case QK_SWAP_HANDS ... QK_SWAP_HANDS_MAX:
 155             action.code = ACTION(ACT_SWAP_HANDS, keycode & 0xff);
 156             break;
 157 #endif
 158
 159         default:
 160             action.code = ACTION_NO;
 161             break;
 162     }
 163     return action;
 164 }
 165
 166 __attribute__((weak)) const uint16_t PROGMEM fn_actions[] = {
 167
 168 };
 169
 170 /* Macro */
 171 __attribute__((weak)) const macro_t *action_get_macro(keyrecord_t *record, uint8_t id, uint8_t opt) { return MACRO_NONE; }
 172
 173 /* Function */
 174 __attribute__((weak)) void action_function(keyrecord_t *record, uint8_t id, uint8_t opt) {}
 175
 176 // translates key to keycode
 177 __attribute__((weak)) uint16_t keymap_key_to_keycode(uint8_t layer, keypos_t key) {
 178     // Read entire word (16bits)
 179     return pgm_read_word(&keymaps[(layer)][(key.row)][(key.col)]);
 180 }
 181
 182 // translates function id to action
 183 __attribute__((weak)) uint16_t keymap_function_id_to_action(uint16_t function_id) {
 184 // The compiler sees the empty (weak) fn_actions and generates a warning
 185 // This function should not be called in that case, so the warning is too strict
 186 // If this function is called however, the keymap should have overridden fn_actions, and then the compile
 187 // is comparing against the wrong array
 188 #pragma GCC diagnostic push
 189 #pragma GCC diagnostic ignored "-Warray-bounds"
 190     return pgm_read_word(&fn_actions[function_id]);
 191 #pragma GCC diagnostic pop
 192 }