mirror of
				https://github.com/mfulz/qmk_firmware.git
				synced 2025-10-31 13:22:31 +01:00 
			
		
		
		
	 cc5c6b449a
			
		
	
	
		cc5c6b449a
		
	
	
	
	
		
			
			* Add suspend functions * Disable RGB code if it's disabled * Add keyboard_init functions * Change where references so it will compile * Wrong command chained in wake up kb function * Fix non-feature file changes * Add documentation * Re-add matrix init docs * add rgblight code to example * Remove suspend code * Clean up docs * Fix docs * Fix suspend code * more doc fixes * change function to startup_* rather than keyboard_init_ * fix spelling error * fix up docs to finish removing keyboard_init * Use Pre and Post init functions * Update Documenation * Remove changes to my keymap and userspace code * Cleanup * Revert changes to extra files * Forgot a semicolon * Make sure all protocols call keyboard_setup * Cleanup functions * Unset startup_user * Remove changes from division keyboard * Readd startup_user function * Remove all to startup_user * Update docs/custom_quantum_functions.md Co-Authored-By: drashna <drashna@live.com> * Update docs/custom_quantum_functions.md Co-Authored-By: drashna <drashna@live.com> * Add suggestion line * Rebase fixes * Update documentation to be more useful/accurate * Cleanup of documentation * Fix spacing inconsistency * Revert unexpected change to keymap
		
			
				
	
	
		
			83 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			83 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /*
 | |
| Copyright 2011,2012,2013 Jun Wako <wakojun@gmail.com>
 | |
| 
 | |
| This program is free software: you can redistribute it and/or modify
 | |
| it under the terms of the GNU General Public License as published by
 | |
| the Free Software Foundation, either version 2 of the License, or
 | |
| (at your option) any later version.
 | |
| 
 | |
| This program is distributed in the hope that it will be useful,
 | |
| but WITHOUT ANY WARRANTY; without even the implied warranty of
 | |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | |
| GNU General Public License for more details.
 | |
| 
 | |
| You should have received a copy of the GNU General Public License
 | |
| along with this program.  If not, see <http://www.gnu.org/licenses/>.
 | |
| */
 | |
| 
 | |
| #ifndef KEYBOARD_H
 | |
| #define KEYBOARD_H
 | |
| 
 | |
| #include <stdbool.h>
 | |
| #include <stdint.h>
 | |
| 
 | |
| 
 | |
| #ifdef __cplusplus
 | |
| extern "C" {
 | |
| #endif
 | |
| 
 | |
| /* key matrix position */
 | |
| typedef struct {
 | |
|     uint8_t col;
 | |
|     uint8_t row;
 | |
| } keypos_t;
 | |
| 
 | |
| /* key event */
 | |
| typedef struct {
 | |
|     keypos_t key;
 | |
|     bool     pressed;
 | |
|     uint16_t time;
 | |
| } keyevent_t;
 | |
| 
 | |
| /* equivalent test of keypos_t */
 | |
| #define KEYEQ(keya, keyb)       ((keya).row == (keyb).row && (keya).col == (keyb).col)
 | |
| 
 | |
| /* Rules for No Event:
 | |
|  * 1) (time == 0) to handle (keyevent_t){} as empty event
 | |
|  * 2) Matrix(255, 255) to make TICK event available
 | |
|  */
 | |
| static inline bool IS_NOEVENT(keyevent_t event) { return event.time == 0 || (event.key.row == 255 && event.key.col == 255); }
 | |
| static inline bool IS_PRESSED(keyevent_t event) { return (!IS_NOEVENT(event) && event.pressed); }
 | |
| static inline bool IS_RELEASED(keyevent_t event) { return (!IS_NOEVENT(event) && !event.pressed); }
 | |
| 
 | |
| /* Tick event */
 | |
| #define TICK                    (keyevent_t){           \
 | |
|     .key = (keypos_t){ .row = 255, .col = 255 },           \
 | |
|     .pressed = false,                                   \
 | |
|     .time = (timer_read() | 1)                          \
 | |
| }
 | |
| 
 | |
| void disable_jtag(void);
 | |
| 
 | |
| /* it runs once at early stage of startup before keyboard_init. */
 | |
| void keyboard_setup(void);
 | |
| /* it runs once after initializing host side protocol, debug and MCU peripherals. */
 | |
| void keyboard_init(void);
 | |
| /* it runs repeatedly in main loop */
 | |
| void keyboard_task(void);
 | |
| /* it runs when host LED status is updated */
 | |
| void keyboard_set_leds(uint8_t leds);
 | |
| /* it runs whenever code has to behave differently on a slave */
 | |
| bool is_keyboard_master(void);
 | |
| 
 | |
| void keyboard_pre_init_kb(void);
 | |
| void keyboard_pre_init_user(void);
 | |
| void keyboard_post_init_kb(void);
 | |
| void keyboard_post_init_user(void);
 | |
| 
 | |
| #ifdef __cplusplus
 | |
| }
 | |
| #endif
 | |
| 
 | |
| #endif
 |