mirror of
https://github.com/osiweb/unified_retro_keyboard.git
synced 2024-10-09 00:55:47 +00:00
78 lines
2.7 KiB
C
78 lines
2.7 KiB
C
|
// -*- mode: C; tab-width: 4 ; indent-tabs-mode: nil -*-
|
||
|
//
|
||
|
// Unfified Keyboard Project
|
||
|
// ASDF keyboard firmware
|
||
|
//
|
||
|
// asdf_hook.h
|
||
|
//
|
||
|
// Definitions and prototypes for configurable function hooks
|
||
|
//
|
||
|
// Copyright 2019 David Fenyes
|
||
|
// 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 3 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 <https://www.gnu.org/licenses/>.
|
||
|
//
|
||
|
|
||
|
#if !defined(ASDF_HOOKS_H)
|
||
|
#define ASDF_HOOKS_H
|
||
|
|
||
|
// These are "hooks" output identifiers that can be mapped to the real outputs using
|
||
|
// keymap initializer commands.
|
||
|
typedef enum {
|
||
|
ASDF_HOOK_SCANNER,
|
||
|
ASDF_HOOK_OUTPUT,
|
||
|
ASDF_HOOK_EACH_SCAN,
|
||
|
ASDF_NUM_HOOKS,
|
||
|
} asdf_hook_id_t;
|
||
|
|
||
|
#define ASDF_HOOK_KEYMAP_SETUP ASDF_NUM_HOOKS
|
||
|
|
||
|
// Each keymap specifies an array of initializer structs to configure function hooks,
|
||
|
// specifying the hook ID and mapped function.
|
||
|
|
||
|
typedef void (*asdf_hook_function_t)(void);
|
||
|
|
||
|
typedef struct {
|
||
|
asdf_hook_id_t hook_id;
|
||
|
asdf_hook_function_t hook_func;
|
||
|
} asdf_hook_initializer_t;
|
||
|
|
||
|
|
||
|
// PROCEDURE: asdf_hook_do
|
||
|
// INPUTS: (asdf_hook_id_t) hook_id: The hook for which to execute attache functions.
|
||
|
// OUTPUTS: none
|
||
|
// DESCRIPTION: if the hook ID is valid, then execute the function attached to the hook.
|
||
|
// SIDE EFFECTS: variable depending on the hooks.
|
||
|
void asdf_hook_do(asdf_hook_id_t hook_id);
|
||
|
|
||
|
// PROCEDURE: asdf_hook_get
|
||
|
// INPUTS: (asdf_hook_id_t) hook_id: The hook for which to retrieve the attached
|
||
|
// function.
|
||
|
// OUTPUTS: none
|
||
|
// DESCRIPTION: if the hook ID is valid, then retrieve the function attached to the hook.
|
||
|
// SIDE EFFECTS: none
|
||
|
asdf_hook_function_t asdf_hook_get(asdf_hook_id_t hook_id);
|
||
|
|
||
|
// PROCEDURE: asdf_hook_init
|
||
|
// INPUTS: (asdf_hook_initializer_t *) initializer_list - contains the hook
|
||
|
// initializer list for the selected keymap.
|
||
|
// OUTPUTS: none
|
||
|
// DESCRIPTION: Initializes function hooks for the selected keymap. If a
|
||
|
// function is assigned to the "KEYMAP_SETUP" hook, then execute the function.
|
||
|
// There is no actual slot where KEYMAP_SETUP functions are stored.
|
||
|
void asdf_hook_init(asdf_hook_initializer_t *const initializer_list);
|
||
|
|
||
|
#endif /* !defined (ASDF_HOOKS_H) */
|
||
|
|
||
|
//-------|---------|---------+---------+---------+---------+---------+---------+
|
||
|
// Above line is 80 columns, and should display completely in the editor.
|