Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
1/* SPDX-License-Identifier: GPL-2.0-only */
2#ifndef _SPARSE_KEYMAP_H
3#define _SPARSE_KEYMAP_H
4
5/*
6 * Copyright (c) 2009 Dmitry Torokhov
7 */
8
9#define KE_END 0 /* Indicates end of keymap */
10#define KE_KEY 1 /* Ordinary key/button */
11#define KE_SW 2 /* Switch (predetermined value) */
12#define KE_VSW 3 /* Switch (value supplied at runtime) */
13#define KE_IGNORE 4 /* Known entry that should be ignored */
14#define KE_LAST KE_IGNORE
15
16/**
17 * struct key_entry - keymap entry for use in sparse keymap
18 * @type: Type of the key entry (KE_KEY, KE_SW, KE_VSW, KE_END);
19 * drivers are allowed to extend the list with their own
20 * private definitions.
21 * @code: Device-specific data identifying the button/switch
22 * @keycode: KEY_* code assigned to a key/button
23 * @sw.code: SW_* code assigned to a switch
24 * @sw.value: Value that should be sent in an input even when KE_SW
25 * switch is toggled. KE_VSW switches ignore this field and
26 * expect driver to supply value for the event.
27 *
28 * This structure defines an entry in a sparse keymap used by some
29 * input devices for which traditional table-based approach is not
30 * suitable.
31 */
32struct key_entry {
33 int type; /* See KE_* above */
34 u32 code;
35 union {
36 u16 keycode; /* For KE_KEY */
37 struct { /* For KE_SW, KE_VSW */
38 u8 code;
39 u8 value; /* For KE_SW, ignored by KE_VSW */
40 } sw;
41 };
42};
43
44struct key_entry *sparse_keymap_entry_from_scancode(struct input_dev *dev,
45 unsigned int code);
46struct key_entry *sparse_keymap_entry_from_keycode(struct input_dev *dev,
47 unsigned int code);
48int sparse_keymap_setup(struct input_dev *dev,
49 const struct key_entry *keymap,
50 int (*setup)(struct input_dev *, struct key_entry *));
51
52void sparse_keymap_report_entry(struct input_dev *dev, const struct key_entry *ke,
53 unsigned int value, bool autorelease);
54
55bool sparse_keymap_report_event(struct input_dev *dev, unsigned int code,
56 unsigned int value, bool autorelease);
57
58#endif /* _SPARSE_KEYMAP_H */