common/keyboard.h

   1 /*
   2 Copyright 2011,2012,2013 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 #ifndef KEYBOARD_H
  19 #define KEYBOARD_H
  20
  21 #include <stdbool.h>
  22 #include <stdint.h>
  23
  24
  25 #ifdef __cplusplus
  26 extern "C" {
  27 #endif
  28
  29 /* key matrix position */
  30 typedef struct {
  31     uint8_t col;
  32     uint8_t row;
  33 } key_t;
  34
  35 /* key event */
  36 typedef struct {
  37     key_t    key;
  38     bool     pressed;
  39     uint16_t time;
  40 } keyevent_t;
  41
  42 /* equivalent test of key_t */
  43 #define KEYEQ(keya, keyb)       ((keya).row == (keyb).row && (keya).col == (keyb).col)
  44
  45 /* (time == 0) means no event and assumes matrix has no 255 line. */
  46 #define IS_NOEVENT(event)       ((event).time == 0 || ((event).key.row == 255 && (event).key.col == 255))
  47
  48 #define NOEVENT                 (keyevent_t){           \
  49     .key = (key_t){ .row = 255, .col = 255 },           \
  50     .pressed = false,                                   \
  51     .time = 0                                           \
  52 }
  53
  54 /* tick event */
  55 #define TICK                    (keyevent_t){           \
  56     .key = (key_t){ .row = 255, .col = 255 },           \
  57     .pressed = false,                                   \
  58     .time = (timer_read() | 1)                          \
  59 }
  60
  61
  62 void keyboard_init(void);
  63 void keyboard_task(void);
  64 void keyboard_set_leds(uint8_t leds);
  65
  66 #ifdef __cplusplus
  67 }
  68 #endif
  69
  70 #endif