Skip to content

Commit 6af6dc2

Browse files
sjg20Samuel Ortiz
authored andcommitted
input: Add ChromeOS EC keyboard driver
Use the key-matrix layer to interpret key scan information from the EC and inject input based on the FDT-supplied key map. This driver registers itself with the ChromeOS EC driver to perform communications. The matrix-keypad FDT binding is used with a small addition to control ghosting. Signed-off-by: Simon Glass <[email protected]> Signed-off-by: Luigi Semenzato <[email protected]> Signed-off-by: Vincent Palatin <[email protected]> Acked-by: Dmitry Torokhov <[email protected]> Signed-off-by: Samuel Ortiz <[email protected]>
1 parent 4384041 commit 6af6dc2

File tree

4 files changed

+419
-0
lines changed

4 files changed

+419
-0
lines changed
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
ChromeOS EC Keyboard
2+
3+
Google's ChromeOS EC Keyboard is a simple matrix keyboard implemented on
4+
a separate EC (Embedded Controller) device. It provides a message for reading
5+
key scans from the EC. These are then converted into keycodes for processing
6+
by the kernel.
7+
8+
This binding is based on matrix-keymap.txt and extends/modifies it as follows:
9+
10+
Required properties:
11+
- compatible: "google,cros-ec-keyb"
12+
13+
Optional properties:
14+
- google,needs-ghost-filter: True to enable a ghost filter for the matrix
15+
keyboard. This is recommended if the EC does not have its own logic or
16+
hardware for this.
17+
18+
19+
Example:
20+
21+
cros-ec-keyb {
22+
compatible = "google,cros-ec-keyb";
23+
keypad,num-rows = <8>;
24+
keypad,num-columns = <13>;
25+
google,needs-ghost-filter;
26+
/*
27+
* Keymap entries take the form of 0xRRCCKKKK where
28+
* RR=Row CC=Column KKKK=Key Code
29+
* The values below are for a US keyboard layout and
30+
* are taken from the Linux driver. Note that the
31+
* 102ND key is not used for US keyboards.
32+
*/
33+
linux,keymap = <
34+
/* CAPSLCK F1 B F10 */
35+
0x0001003a 0x0002003b 0x00030030 0x00040044
36+
/* N = R_ALT ESC */
37+
0x00060031 0x0008000d 0x000a0064 0x01010001
38+
/* F4 G F7 H */
39+
0x0102003e 0x01030022 0x01040041 0x01060023
40+
/* ' F9 BKSPACE L_CTRL */
41+
0x01080028 0x01090043 0x010b000e 0x0200001d
42+
/* TAB F3 T F6 */
43+
0x0201000f 0x0202003d 0x02030014 0x02040040
44+
/* ] Y 102ND [ */
45+
0x0205001b 0x02060015 0x02070056 0x0208001a
46+
/* F8 GRAVE F2 5 */
47+
0x02090042 0x03010029 0x0302003c 0x03030006
48+
/* F5 6 - \ */
49+
0x0304003f 0x03060007 0x0308000c 0x030b002b
50+
/* R_CTRL A D F */
51+
0x04000061 0x0401001e 0x04020020 0x04030021
52+
/* S K J ; */
53+
0x0404001f 0x04050025 0x04060024 0x04080027
54+
/* L ENTER Z C */
55+
0x04090026 0x040b001c 0x0501002c 0x0502002e
56+
/* V X , M */
57+
0x0503002f 0x0504002d 0x05050033 0x05060032
58+
/* L_SHIFT / . SPACE */
59+
0x0507002a 0x05080035 0x05090034 0x050B0039
60+
/* 1 3 4 2 */
61+
0x06010002 0x06020004 0x06030005 0x06040003
62+
/* 8 7 0 9 */
63+
0x06050009 0x06060008 0x0608000b 0x0609000a
64+
/* L_ALT DOWN RIGHT Q */
65+
0x060a0038 0x060b006c 0x060c006a 0x07010010
66+
/* E R W I */
67+
0x07020012 0x07030013 0x07040011 0x07050017
68+
/* U R_SHIFT P O */
69+
0x07060016 0x07070036 0x07080019 0x07090018
70+
/* UP LEFT */
71+
0x070b0067 0x070c0069>;
72+
};

drivers/input/keyboard/Kconfig

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -628,4 +628,16 @@ config KEYBOARD_W90P910
628628
To compile this driver as a module, choose M here: the
629629
module will be called w90p910_keypad.
630630

631+
config KEYBOARD_CROS_EC
632+
tristate "ChromeOS EC keyboard"
633+
select INPUT_MATRIXKMAP
634+
depends on MFD_CROS_EC
635+
help
636+
Say Y here to enable the matrix keyboard used by ChromeOS devices
637+
and implemented on the ChromeOS EC. You must enable one bus option
638+
(MFD_CROS_EC_I2C or MFD_CROS_EC_SPI) to use this.
639+
640+
To compile this driver as a module, choose M here: the
641+
module will be called cros_ec_keyb.
642+
631643
endif

drivers/input/keyboard/Makefile

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ obj-$(CONFIG_KEYBOARD_AMIGA) += amikbd.o
1111
obj-$(CONFIG_KEYBOARD_ATARI) += atakbd.o
1212
obj-$(CONFIG_KEYBOARD_ATKBD) += atkbd.o
1313
obj-$(CONFIG_KEYBOARD_BFIN) += bf54x-keys.o
14+
obj-$(CONFIG_KEYBOARD_CROS_EC) += cros_ec_keyb.o
1415
obj-$(CONFIG_KEYBOARD_DAVINCI) += davinci_keyscan.o
1516
obj-$(CONFIG_KEYBOARD_EP93XX) += ep93xx_keypad.o
1617
obj-$(CONFIG_KEYBOARD_GOLDFISH_EVENTS) += goldfish_events.o

0 commit comments

Comments
 (0)