matrix.h 2.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677
  1. /*
  2. Copyright 2011 Jun Wako <wakojun@gmail.com>
  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. #ifndef MATRIX_H
  15. #define MATRIX_H
  16. #include <stdint.h>
  17. #include <stdbool.h>
  18. #include "keyboard.h"
  19. #if (MATRIX_COLS <= 8)
  20. typedef uint8_t matrix_row_t;
  21. #elif (MATRIX_COLS <= 16)
  22. typedef uint16_t matrix_row_t;
  23. #elif (MATRIX_COLS <= 32)
  24. typedef uint32_t matrix_row_t;
  25. #else
  26. #error "MATRIX_COLS: invalid value"
  27. #endif
  28. #define MATRIX_IS_ON(row, col) (matrix_get_row(row) && (1<<col))
  29. #ifdef __cplusplus
  30. extern "C" {
  31. #endif
  32. /* number of matrix rows */
  33. uint8_t matrix_rows(void);
  34. /* number of matrix columns */
  35. uint8_t matrix_cols(void);
  36. /* should be called at early stage of startup before matrix_init.(optional) */
  37. void matrix_setup(void);
  38. /* intialize matrix for scaning. */
  39. void matrix_init(void);
  40. /* scan all key states on matrix */
  41. uint8_t matrix_scan(void);
  42. /* whether modified from previous scan. used after matrix_scan. */
  43. bool matrix_is_modified(void) __attribute__ ((deprecated));
  44. /* whether a switch is on */
  45. bool matrix_is_on(uint8_t row, uint8_t col);
  46. /* matrix state on row */
  47. matrix_row_t matrix_get_row(uint8_t row);
  48. /* print matrix for debug */
  49. void matrix_print(void);
  50. /* power control */
  51. void matrix_power_up(void);
  52. void matrix_power_down(void);
  53. /* executes code for Quantum */
  54. void matrix_init_quantum(void);
  55. void matrix_scan_quantum(void);
  56. void matrix_init_kb(void);
  57. void matrix_scan_kb(void);
  58. void matrix_init_user(void);
  59. void matrix_scan_user(void);
  60. #ifdef __cplusplus
  61. }
  62. #endif
  63. #endif