Keyboard firmwares for Atmel AVR and Cortex-M
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

keyboard.c 19KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622
  1. /*
  2. Copyright 2011 Jun Wako <[email protected]>
  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. This program is distributed in the hope that it will be useful,
  8. but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  10. GNU General Public License for more details.
  11. You should have received a copy of the GNU General Public License
  12. along with this program. If not, see <http://www.gnu.org/licenses/>.
  13. */
  14. #include "keyboard.h"
  15. #include "matrix.h"
  16. #include "keymap.h"
  17. #include "host.h"
  18. #include "led.h"
  19. #include "keycode.h"
  20. #include "timer.h"
  21. #include "print.h"
  22. #include "debug.h"
  23. #include "command.h"
  24. #include "util.h"
  25. #ifdef MOUSEKEY_ENABLE
  26. #include "mousekey.h"
  27. #endif
  28. #define LAYER_DELAY 250
  29. typedef enum keykind {
  30. NONE,
  31. FN_DOWN, FN_UP,
  32. FNK_DOWN, FNK_UP,
  33. KEY_DOWN, KEY_UP,
  34. MOD_DOWN, MOD_UP,
  35. } keykind_t;
  36. typedef enum { IDLE, DELAYING, WAITING, PRESSING } kbdstate_t;
  37. #ifdef KEYMAP_DEFAULT_LAYER
  38. uint8_t default_layer = KEYMAP_DEFAULT_LAYER;
  39. uint8_t current_layer = KEYMAP_DEFAULT_LAYER;
  40. #else
  41. uint8_t default_layer = 0;
  42. uint8_t current_layer = 0;
  43. #endif
  44. /* keyboard internal states */
  45. static kbdstate_t kbdstate = IDLE;
  46. static uint8_t fn_state_bits = 0;
  47. static keyrecord_t delayed_fn;
  48. static keyrecord_t waiting_key;
  49. static const char *state_str(kbdstate_t state)
  50. {
  51. if (state == IDLE) return PSTR("IDLE");
  52. if (state == DELAYING) return PSTR("DELAYING");
  53. if (state == WAITING) return PSTR("WAITING");
  54. if (state == PRESSING) return PSTR("PRESSING");
  55. return PSTR("UNKNOWN");
  56. }
  57. static inline keykind_t get_keykind(uint8_t code, bool pressed)
  58. {
  59. if IS_KEY(code) return (pressed ? KEY_DOWN : KEY_UP);
  60. if IS_MOD(code) return (pressed ? MOD_DOWN : MOD_UP);
  61. if IS_FN(code) {
  62. if (keymap_fn_keycode(FN_INDEX(code)))
  63. return (pressed ? FNK_DOWN : FNK_UP);
  64. else
  65. return (pressed ? FN_DOWN : FN_UP);
  66. }
  67. if IS_MOUSEKEY(code) return (pressed ? KEY_DOWN : KEY_UP);
  68. if IS_SYSTEM(code) return (pressed ? KEY_DOWN : KEY_UP);
  69. if IS_CONSUMER(code) return (pressed ? KEY_DOWN : KEY_UP);
  70. return NONE;
  71. }
  72. static void clear_keyboard(void)
  73. {
  74. host_clear_keys();
  75. host_clear_mods();
  76. host_send_keyboard_report();
  77. host_system_send(0);
  78. host_consumer_send(0);
  79. #ifdef MOUSEKEY_ENABLE
  80. mousekey_clear();
  81. mousekey_send();
  82. #endif
  83. }
  84. static void clear_keyboard_but_mods(void)
  85. {
  86. host_clear_keys();
  87. host_send_keyboard_report();
  88. host_system_send(0);
  89. host_consumer_send(0);
  90. #ifdef MOUSEKEY_ENABLE
  91. mousekey_clear();
  92. mousekey_send();
  93. #endif
  94. }
  95. static bool anykey_sent_to_host(void)
  96. {
  97. return (host_has_anykey() || host_mouse_in_use() ||
  98. host_last_sysytem_report() || host_last_consumer_report());
  99. }
  100. static void layer_switch_on(uint8_t code)
  101. {
  102. if (!IS_FN(code)) return;
  103. fn_state_bits |= FN_BIT(code);
  104. uint8_t new_layer = (fn_state_bits ? keymap_fn_layer(biton(fn_state_bits)) : default_layer);
  105. if (current_layer != new_layer) {
  106. debug("Layer Switch(on): "); debug_hex(current_layer);
  107. debug(" -> "); debug_hex(new_layer); debug("\n");
  108. clear_keyboard_but_mods();
  109. current_layer = new_layer;
  110. }
  111. }
  112. static bool layer_switch_off(uint8_t code)
  113. {
  114. if (!IS_FN(code)) return false;
  115. fn_state_bits &= ~FN_BIT(code);
  116. uint8_t new_layer = (fn_state_bits ? keymap_fn_layer(biton(fn_state_bits)) : default_layer);
  117. if (current_layer != new_layer) {
  118. debug("Layer Switch(off): "); debug_hex(current_layer);
  119. debug(" -> "); debug_hex(new_layer); debug("\n");
  120. clear_keyboard_but_mods();
  121. current_layer = new_layer;
  122. return true;
  123. }
  124. return false;
  125. }
  126. static void register_code(uint8_t code)
  127. {
  128. if IS_KEY(code) {
  129. if (command_proc(code)) {
  130. //clear_keyboard();
  131. } else {
  132. host_add_key(code);
  133. host_send_keyboard_report();
  134. }
  135. }
  136. else if IS_MOD(code) {
  137. host_add_mod_bit(MOD_BIT(code));
  138. host_send_keyboard_report();
  139. }
  140. else if IS_FN(code) {
  141. host_add_key(keymap_fn_keycode(FN_INDEX(code)));
  142. host_send_keyboard_report();
  143. }
  144. else if IS_MOUSEKEY(code) {
  145. #ifdef MOUSEKEY_ENABLE
  146. mousekey_on(code);
  147. mousekey_send();
  148. #endif
  149. }
  150. else if IS_CONSUMER(code) {
  151. uint16_t usage = 0;
  152. switch (code) {
  153. case KC_AUDIO_MUTE:
  154. usage = AUDIO_MUTE;
  155. break;
  156. case KC_AUDIO_VOL_UP:
  157. usage = AUDIO_VOL_UP;
  158. break;
  159. case KC_AUDIO_VOL_DOWN:
  160. usage = AUDIO_VOL_DOWN;
  161. break;
  162. case KC_MEDIA_NEXT_TRACK:
  163. usage = TRANSPORT_NEXT_TRACK;
  164. break;
  165. case KC_MEDIA_PREV_TRACK:
  166. usage = TRANSPORT_PREV_TRACK;
  167. break;
  168. case KC_MEDIA_STOP:
  169. usage = TRANSPORT_STOP;
  170. break;
  171. case KC_MEDIA_PLAY_PAUSE:
  172. usage = TRANSPORT_PLAY_PAUSE;
  173. break;
  174. case KC_MEDIA_SELECT:
  175. usage = AL_CC_CONFIG;
  176. break;
  177. case KC_MAIL:
  178. usage = AL_EMAIL;
  179. break;
  180. case KC_CALCULATOR:
  181. usage = AL_CALCULATOR;
  182. break;
  183. case KC_MY_COMPUTER:
  184. usage = AL_LOCAL_BROWSER;
  185. break;
  186. case KC_WWW_SEARCH:
  187. usage = AC_SEARCH;
  188. break;
  189. case KC_WWW_HOME:
  190. usage = AC_HOME;
  191. break;
  192. case KC_WWW_BACK:
  193. usage = AC_BACK;
  194. break;
  195. case KC_WWW_FORWARD:
  196. usage = AC_FORWARD;
  197. break;
  198. case KC_WWW_STOP:
  199. usage = AC_STOP;
  200. break;
  201. case KC_WWW_REFRESH:
  202. usage = AC_REFRESH;
  203. break;
  204. case KC_WWW_FAVORITES:
  205. usage = AC_BOOKMARKS;
  206. break;
  207. }
  208. host_consumer_send(usage);
  209. }
  210. else if IS_SYSTEM(code) {
  211. uint16_t usage = 0;
  212. switch (code) {
  213. case KC_SYSTEM_POWER:
  214. usage = SYSTEM_POWER_DOWN;
  215. break;
  216. case KC_SYSTEM_SLEEP:
  217. usage = SYSTEM_SLEEP;
  218. break;
  219. case KC_SYSTEM_WAKE:
  220. usage = SYSTEM_WAKE_UP;
  221. break;
  222. }
  223. host_system_send(usage);
  224. }
  225. }
  226. static void unregister_code(uint8_t code)
  227. {
  228. if IS_KEY(code) {
  229. host_del_key(code);
  230. host_send_keyboard_report();
  231. }
  232. else if IS_MOD(code) {
  233. host_del_mod_bit(MOD_BIT(code));
  234. host_send_keyboard_report();
  235. }
  236. else if IS_FN(code) {
  237. host_del_key(keymap_fn_keycode(FN_INDEX(code)));
  238. host_send_keyboard_report();
  239. }
  240. else if IS_MOUSEKEY(code) {
  241. #ifdef MOUSEKEY_ENABLE
  242. mousekey_off(code);
  243. mousekey_send();
  244. #endif
  245. }
  246. else if IS_CONSUMER(code) {
  247. host_consumer_send(0x0000);
  248. }
  249. else if IS_SYSTEM(code) {
  250. host_system_send(0x0000);
  251. }
  252. }
  253. /*
  254. *
  255. * Event/State|IDLE PRESSING DELAYING[f] WAITING[f,k]
  256. * -----------+------------------------------------------------------------------
  257. * Fn Down |(L+) -*1 WAITING(Sk) IDLE(Rf,Ps)*7
  258. * Up |(L-) IDLE(L-)*8 IDLE(L-)*8 IDLE(L-)*8
  259. * Fnk Down |DELAYING(Sf)* (Rf) WAITING(Sk) IDLE(Rf,Ps,Rf)
  260. * Up |(L-) IDLE(L-/Uf)*8 IDLE(Rf,Uf/L-)*3 IDLE(Rf,Ps,Uf/L-)*3
  261. * Key Down |PRESSING(Rk) (Rk) WAITING(Sk) IDLE(Rf,Ps,Rk)
  262. * Up |(Uk) IDLE(Uk)*4 (Uk) IDLE(L+,Ps,Pk)/(Uk)*a
  263. * |
  264. * Delay |- - IDLE(L+) IDLE(L+,Ps)
  265. * Magic Key |COMMAND*5
  266. *
  267. * *1: ignore Fn if other key is down.
  268. * *2: register Fnk if any key is pressing
  269. * *3: register/unregister delayed Fnk and move to IDLE if code == delayed Fnk, else *8
  270. * *4: if no keys registered to host
  271. * *5: unregister all keys
  272. * *6: only if no keys down
  273. * *7: ignore Fn because Fnk key and stored key are down.
  274. * *8: move to IDLE if layer switch(off) occurs, else stay at current state
  275. * *9: repeat key if pressing Fnk twice quickly(move to PRESSING)
  276. * *a: layer switch and process waiting key and code if code == wainting key, else unregister key
  277. *
  278. * States:
  279. * IDLE: No key is down except modifiers
  280. * DELAYING: delay layer switch after pressing Fn with alt keycode
  281. * WAITING: key is pressed during DELAYING
  282. *
  283. * Events:
  284. * Fn: Fn key without alternative keycode
  285. * Fnk: Fn key with alternative keycode
  286. * -: ignore
  287. * Delay: layer switch delay term is elapsed
  288. *
  289. * Actions:
  290. * Rk: register key
  291. * Uk: unregister key
  292. * Rf: register Fn(alt keycode)
  293. * Uf: unregister Fn(alt keycode)
  294. * Rs: register stored key
  295. * Us: unregister stored key
  296. * Sk: Store key(waiting Key)
  297. * Sf: Store Fn(delayed Fn)
  298. * Ps: Process stored key
  299. * Ps: Process key
  300. * Is: Interpret stored keys in current layer
  301. * L+: Switch to new layer(*unregister* all keys but modifiers)
  302. * L-: Switch back to last layer(*unregister* all keys but modifiers)
  303. * Ld: Switch back to default layer(*unregister* all keys but modifiers)
  304. */
  305. #define NEXT(state) do { \
  306. debug("NEXT: "); debug_P(state_str(kbdstate)); \
  307. kbdstate = state; \
  308. debug(" -> "); debug_P(state_str(kbdstate)); debug("\n"); \
  309. } while (0)
  310. static inline void process_key(keyevent_t event)
  311. {
  312. uint8_t code = keymap_get_keycode(current_layer, event.key.row, event.key.col);
  313. keykind_t kind = get_keykind(code, event.pressed);
  314. uint8_t tmp_mods;
  315. debug("state: "); debug_P(state_str(kbdstate));
  316. debug(" kind: "); debug_hex(kind);
  317. debug(" code: "); debug_hex(code);
  318. if (event.pressed) { debug("d"); } else { debug("u"); }
  319. debug("\n");
  320. switch (kbdstate) {
  321. case IDLE:
  322. switch (kind) {
  323. case FN_DOWN:
  324. layer_switch_on(code);
  325. break;
  326. case FN_UP:
  327. layer_switch_off(code);
  328. break;
  329. case FNK_DOWN:
  330. // repeat Fn alt key when press Fn key down, up then down again quickly
  331. if (KEYEQ(delayed_fn.event.key, event.key) &&
  332. timer_elapsed(delayed_fn.time) < LAYER_DELAY) {
  333. register_code(code);
  334. NEXT(PRESSING);
  335. } else {
  336. delayed_fn = (keyrecord_t) {
  337. .event = event,
  338. .code = code,
  339. .mods = keyboard_report->mods,
  340. .time = timer_read()
  341. };
  342. NEXT(DELAYING);
  343. }
  344. break;
  345. case FNK_UP:
  346. layer_switch_off(code);
  347. break;
  348. case KEY_DOWN:
  349. register_code(code);
  350. NEXT(PRESSING);
  351. break;
  352. case MOD_DOWN:
  353. register_code(code);
  354. break;
  355. case KEY_UP:
  356. case MOD_UP:
  357. unregister_code(code);
  358. break;
  359. default:
  360. break;
  361. }
  362. break;
  363. case PRESSING:
  364. switch (kind) {
  365. case FN_DOWN:
  366. // ignored when any key is pressed
  367. break;
  368. case FN_UP:
  369. if (layer_switch_off(code))
  370. NEXT(IDLE);
  371. break;
  372. case FNK_DOWN:
  373. register_code(code);
  374. break;
  375. case FNK_UP:
  376. if (layer_switch_off(code)) {
  377. NEXT(IDLE);
  378. } else {
  379. unregister_code(code);
  380. if (!anykey_sent_to_host())
  381. NEXT(IDLE);
  382. }
  383. break;
  384. case KEY_DOWN:
  385. case MOD_DOWN:
  386. register_code(code);
  387. break;
  388. case KEY_UP:
  389. case MOD_UP:
  390. unregister_code(code);
  391. if (!anykey_sent_to_host())
  392. NEXT(IDLE);
  393. break;
  394. default:
  395. break;
  396. }
  397. break;
  398. case DELAYING:
  399. switch (kind) {
  400. case FN_DOWN:
  401. case FNK_DOWN:
  402. case KEY_DOWN:
  403. waiting_key = (keyrecord_t) {
  404. .event = event,
  405. .code = code,
  406. .mods = keyboard_report->mods,
  407. .time = timer_read()
  408. };
  409. NEXT(WAITING);
  410. break;
  411. case MOD_DOWN:
  412. register_code(code);
  413. break;
  414. case FN_UP:
  415. if (layer_switch_off(code))
  416. NEXT(IDLE);
  417. break;
  418. case FNK_UP:
  419. if (code == delayed_fn.code) {
  420. // type Fn with alt keycode
  421. // restore the mod status at the time of pressing Fn key
  422. tmp_mods = keyboard_report->mods;
  423. host_set_mods(delayed_fn.mods);
  424. register_code(delayed_fn.code);
  425. unregister_code(delayed_fn.code);
  426. host_set_mods(tmp_mods);
  427. NEXT(IDLE);
  428. } else {
  429. if (layer_switch_off(code))
  430. NEXT(IDLE);
  431. }
  432. break;
  433. case KEY_UP:
  434. case MOD_UP:
  435. unregister_code(code);
  436. break;
  437. default:
  438. break;
  439. }
  440. break;
  441. case WAITING:
  442. switch (kind) {
  443. case FN_DOWN:
  444. case FNK_DOWN:
  445. case KEY_DOWN:
  446. tmp_mods = keyboard_report->mods;
  447. host_set_mods(delayed_fn.mods);
  448. register_code(delayed_fn.code);
  449. host_set_mods(waiting_key.mods);
  450. register_code(waiting_key.code);
  451. host_set_mods(tmp_mods);
  452. if (kind == FN_DOWN) {
  453. // ignore Fn
  454. } else if (kind == FNK_DOWN) {
  455. register_code(code);
  456. } else if (kind == KEY_DOWN) {
  457. register_code(code);
  458. }
  459. NEXT(IDLE);
  460. break;
  461. case MOD_DOWN:
  462. register_code(code);
  463. break;
  464. case FN_UP:
  465. if (layer_switch_off(code))
  466. NEXT(IDLE);
  467. break;
  468. case FNK_UP:
  469. if (code == delayed_fn.code) {
  470. // alt down, key down, alt up
  471. tmp_mods = keyboard_report->mods;
  472. host_set_mods(delayed_fn.mods);
  473. register_code(delayed_fn.code);
  474. host_set_mods(waiting_key.mods);
  475. register_code(waiting_key.code);
  476. unregister_code(delayed_fn.code);
  477. host_set_mods(tmp_mods);
  478. NEXT(IDLE);
  479. } else {
  480. if (layer_switch_off(code))
  481. NEXT(IDLE);
  482. }
  483. break;
  484. case KEY_UP:
  485. if (code == waiting_key.code) {
  486. layer_switch_on(delayed_fn.code);
  487. NEXT(IDLE);
  488. // process waiting_key
  489. tmp_mods = keyboard_report->mods;
  490. host_set_mods(waiting_key.mods);
  491. process_key(waiting_key.event);
  492. host_set_mods(tmp_mods);
  493. process_key(event);
  494. } else {
  495. unregister_code(code);
  496. }
  497. break;
  498. case MOD_UP:
  499. unregister_code(code);
  500. break;
  501. default:
  502. break;
  503. }
  504. break;
  505. }
  506. }
  507. void keyboard_init(void)
  508. {
  509. debug_keyboard = true;
  510. timer_init();
  511. matrix_init();
  512. #ifdef PS2_MOUSE_ENABLE
  513. ps2_mouse_init();
  514. #endif
  515. }
  516. void keyboard_task(void)
  517. {
  518. static matrix_row_t matrix_prev[MATRIX_ROWS];
  519. matrix_row_t matrix_row = 0;
  520. matrix_row_t matrix_change = 0;
  521. matrix_scan();
  522. for (int r = 0; r < MATRIX_ROWS; r++) {
  523. matrix_row = matrix_get_row(r);
  524. matrix_change = matrix_row ^ matrix_prev[r];
  525. if (matrix_change) {
  526. matrix_debug();
  527. for (int c = 0; c < MATRIX_COLS; c++) {
  528. if (matrix_change & (1<<c)) {
  529. process_key((keyevent_t){
  530. .key = (key_t){ .row = r, .col = c },
  531. .pressed = (matrix_row & (1<<c))
  532. });
  533. // record a processed key
  534. matrix_prev[r] ^= (1<<c);
  535. // process a key per task call
  536. goto MATRIX_LOOP_END;
  537. }
  538. }
  539. }
  540. }
  541. MATRIX_LOOP_END:
  542. // layer switch when delay term elapses
  543. if (kbdstate == DELAYING || kbdstate == WAITING) {
  544. if (timer_elapsed(delayed_fn.time) > LAYER_DELAY) {
  545. if (kbdstate == DELAYING) {
  546. layer_switch_on(delayed_fn.code);
  547. NEXT(IDLE);
  548. }
  549. if (kbdstate == WAITING) {
  550. layer_switch_on(delayed_fn.code);
  551. NEXT(IDLE);
  552. uint8_t tmp_mods = keyboard_report->mods;
  553. host_set_mods(waiting_key.mods);
  554. process_key(waiting_key.event);
  555. host_set_mods(tmp_mods);
  556. }
  557. }
  558. }
  559. #ifdef MOUSEKEY_ENABLE
  560. // mousekey repeat & acceleration
  561. mousekey_task();
  562. #endif
  563. // FAIL SAFE: clear all key if no key down
  564. if (matrix_change) {
  565. matrix_row_t is_matrix_on = 0;
  566. for (int r = 0; r < MATRIX_ROWS; r++) {
  567. is_matrix_on |= matrix_get_row(r);
  568. }
  569. if (!is_matrix_on) {
  570. debug("FAIL SAFE: clear all keys(default layer).\n");
  571. clear_keyboard();
  572. current_layer = default_layer;
  573. }
  574. }
  575. return;
  576. }
  577. void keyboard_set_leds(uint8_t leds)
  578. {
  579. led_set(leds);
  580. }