]>
Commit | Line | Data |
---|---|---|
713cb680 HT |
1 | /* |
2 | * Chromium OS Matrix Keyboard | |
3 | * | |
4 | * Copyright (c) 2012 The Chromium OS Authors. | |
713cb680 | 5 | * |
1a459660 | 6 | * SPDX-License-Identifier: GPL-2.0+ |
713cb680 HT |
7 | */ |
8 | ||
9 | #include <common.h> | |
10 | #include <cros_ec.h> | |
1fa4bfde | 11 | #include <dm.h> |
e0dd81e3 | 12 | #include <errno.h> |
713cb680 HT |
13 | #include <fdtdec.h> |
14 | #include <input.h> | |
1fa4bfde | 15 | #include <keyboard.h> |
713cb680 HT |
16 | #include <key_matrix.h> |
17 | #include <stdio_dev.h> | |
18 | ||
19 | DECLARE_GLOBAL_DATA_PTR; | |
20 | ||
21 | enum { | |
22 | KBC_MAX_KEYS = 8, /* Maximum keys held down at once */ | |
93322749 SS |
23 | KBC_REPEAT_RATE_MS = 30, |
24 | KBC_REPEAT_DELAY_MS = 240, | |
713cb680 HT |
25 | }; |
26 | ||
1fa4bfde SG |
27 | struct cros_ec_keyb_priv { |
28 | struct input_config *input; /* The input layer */ | |
713cb680 HT |
29 | struct key_matrix matrix; /* The key matrix layer */ |
30 | int key_rows; /* Number of keyboard rows */ | |
31 | int key_cols; /* Number of keyboard columns */ | |
713cb680 | 32 | int ghost_filter; /* 1 to enable ghost filter, else 0 */ |
1fa4bfde | 33 | }; |
713cb680 HT |
34 | |
35 | ||
36 | /** | |
37 | * Check the keyboard controller and return a list of key matrix positions | |
38 | * for which a key is pressed | |
39 | * | |
1fa4bfde | 40 | * @param dev Keyboard device |
713cb680 HT |
41 | * @param keys List of keys that we have detected |
42 | * @param max_count Maximum number of keys to return | |
e0dd81e3 SG |
43 | * @param samep Set to true if this scan repeats the last, else false |
44 | * @return number of pressed keys, 0 for none, -EIO on error | |
713cb680 | 45 | */ |
1fa4bfde SG |
46 | static int check_for_keys(struct udevice *dev, struct key_matrix_key *keys, |
47 | int max_count, bool *samep) | |
713cb680 | 48 | { |
1fa4bfde | 49 | struct cros_ec_keyb_priv *priv = dev_get_priv(dev); |
713cb680 | 50 | struct key_matrix_key *key; |
e0dd81e3 SG |
51 | static struct mbkp_keyscan last_scan; |
52 | static bool last_scan_valid; | |
713cb680 HT |
53 | struct mbkp_keyscan scan; |
54 | unsigned int row, col, bit, data; | |
55 | int num_keys; | |
56 | ||
1fa4bfde | 57 | if (cros_ec_scan_keyboard(dev->parent, &scan)) { |
713cb680 | 58 | debug("%s: keyboard scan failed\n", __func__); |
e0dd81e3 | 59 | return -EIO; |
713cb680 | 60 | } |
e0dd81e3 SG |
61 | *samep = last_scan_valid && !memcmp(&last_scan, &scan, sizeof(scan)); |
62 | ||
63 | /* | |
64 | * This is a bit odd. The EC has no way to tell us that it has run | |
65 | * out of key scans. It just returns the same scan over and over | |
66 | * again. So the only way to detect that we have run out is to detect | |
67 | * that this scan is the same as the last. | |
68 | */ | |
69 | last_scan_valid = true; | |
70 | memcpy(&last_scan, &scan, sizeof(last_scan)); | |
713cb680 | 71 | |
1fa4bfde | 72 | for (col = num_keys = bit = 0; col < priv->matrix.num_cols; |
713cb680 | 73 | col++) { |
1fa4bfde | 74 | for (row = 0; row < priv->matrix.num_rows; row++) { |
713cb680 HT |
75 | unsigned int mask = 1 << (bit & 7); |
76 | ||
77 | data = scan.data[bit / 8]; | |
78 | if ((data & mask) && num_keys < max_count) { | |
79 | key = keys + num_keys++; | |
80 | key->row = row; | |
81 | key->col = col; | |
82 | key->valid = 1; | |
83 | } | |
84 | bit++; | |
85 | } | |
86 | } | |
87 | ||
88 | return num_keys; | |
89 | } | |
90 | ||
713cb680 HT |
91 | /** |
92 | * Check the keyboard, and send any keys that are pressed. | |
93 | * | |
94 | * This is called by input_tstc() and input_getc() when they need more | |
95 | * characters | |
96 | * | |
97 | * @param input Input configuration | |
98 | * @return 1, to indicate that we have something to look at | |
99 | */ | |
100 | int cros_ec_kbc_check(struct input_config *input) | |
101 | { | |
1fa4bfde SG |
102 | struct udevice *dev = input->dev; |
103 | struct cros_ec_keyb_priv *priv = dev_get_priv(dev); | |
713cb680 HT |
104 | static struct key_matrix_key last_keys[KBC_MAX_KEYS]; |
105 | static int last_num_keys; | |
106 | struct key_matrix_key keys[KBC_MAX_KEYS]; | |
107 | int keycodes[KBC_MAX_KEYS]; | |
108 | int num_keys, num_keycodes; | |
109 | int irq_pending, sent; | |
e0dd81e3 | 110 | bool same = false; |
713cb680 HT |
111 | |
112 | /* | |
113 | * Loop until the EC has no more keyscan records, or we have | |
114 | * received at least one character. This means we know that tstc() | |
115 | * will always return non-zero if keys have been pressed. | |
116 | * | |
117 | * Without this loop, a key release (which generates no new ascii | |
118 | * characters) will cause us to exit this function, and just tstc() | |
119 | * may return 0 before all keys have been read from the EC. | |
120 | */ | |
121 | do { | |
1fa4bfde | 122 | irq_pending = cros_ec_interrupt_pending(dev->parent); |
713cb680 | 123 | if (irq_pending) { |
1fa4bfde | 124 | num_keys = check_for_keys(dev, keys, KBC_MAX_KEYS, |
e0dd81e3 SG |
125 | &same); |
126 | if (num_keys < 0) | |
127 | return 0; | |
713cb680 HT |
128 | last_num_keys = num_keys; |
129 | memcpy(last_keys, keys, sizeof(keys)); | |
130 | } else { | |
131 | /* | |
132 | * EC doesn't want to be asked, so use keys from last | |
133 | * time. | |
134 | */ | |
135 | num_keys = last_num_keys; | |
136 | memcpy(keys, last_keys, sizeof(keys)); | |
137 | } | |
138 | ||
139 | if (num_keys < 0) | |
140 | return -1; | |
1fa4bfde | 141 | num_keycodes = key_matrix_decode(&priv->matrix, keys, |
713cb680 HT |
142 | num_keys, keycodes, KBC_MAX_KEYS); |
143 | sent = input_send_keycodes(input, keycodes, num_keycodes); | |
e0dd81e3 SG |
144 | |
145 | /* | |
146 | * For those ECs without an interrupt, stop scanning when we | |
147 | * see that the scan is the same as last time. | |
148 | */ | |
149 | if ((irq_pending < 0) && same) | |
150 | break; | |
713cb680 HT |
151 | } while (irq_pending && !sent); |
152 | ||
153 | return 1; | |
154 | } | |
155 | ||
156 | /** | |
157 | * Decode MBKP keyboard details from the device tree | |
158 | * | |
159 | * @param blob Device tree blob | |
160 | * @param node Node to decode from | |
161 | * @param config Configuration data read from fdt | |
162 | * @return 0 if ok, -1 on error | |
163 | */ | |
164 | static int cros_ec_keyb_decode_fdt(const void *blob, int node, | |
1fa4bfde | 165 | struct cros_ec_keyb_priv *config) |
713cb680 HT |
166 | { |
167 | /* | |
168 | * Get keyboard rows and columns - at present we are limited to | |
169 | * 8 columns by the protocol (one byte per row scan) | |
170 | */ | |
93322749 SS |
171 | config->key_rows = fdtdec_get_int(blob, node, "keypad,num-rows", 0); |
172 | config->key_cols = fdtdec_get_int(blob, node, "keypad,num-columns", 0); | |
713cb680 HT |
173 | if (!config->key_rows || !config->key_cols || |
174 | config->key_rows * config->key_cols / 8 | |
175 | > CROS_EC_KEYSCAN_COLS) { | |
176 | debug("%s: Invalid key matrix size %d x %d\n", __func__, | |
177 | config->key_rows, config->key_cols); | |
178 | return -1; | |
179 | } | |
713cb680 | 180 | config->ghost_filter = fdtdec_get_bool(blob, node, |
3fbb7871 | 181 | "google,needs-ghost-filter"); |
713cb680 HT |
182 | return 0; |
183 | } | |
184 | ||
1fa4bfde | 185 | static int cros_ec_kbd_probe(struct udevice *dev) |
713cb680 | 186 | { |
1fa4bfde SG |
187 | struct cros_ec_keyb_priv *priv = dev_get_priv(dev); |
188 | struct keyboard_priv *uc_priv = dev_get_uclass_priv(dev); | |
189 | struct stdio_dev *sdev = &uc_priv->sdev; | |
190 | struct input_config *input = &uc_priv->input; | |
713cb680 | 191 | const void *blob = gd->fdt_blob; |
1fa4bfde SG |
192 | int node = dev->of_offset; |
193 | int ret; | |
713cb680 | 194 | |
1fa4bfde | 195 | if (cros_ec_keyb_decode_fdt(blob, node, priv)) |
713cb680 | 196 | return -1; |
1fa4bfde SG |
197 | input_set_delays(input, KBC_REPEAT_DELAY_MS, KBC_REPEAT_RATE_MS); |
198 | ret = key_matrix_init(&priv->matrix, priv->key_rows, priv->key_cols, | |
199 | priv->ghost_filter); | |
200 | if (ret) { | |
713cb680 | 201 | debug("%s: cannot init key matrix\n", __func__); |
1fa4bfde | 202 | return ret; |
713cb680 | 203 | } |
1fa4bfde SG |
204 | ret = key_matrix_decode_fdt(&priv->matrix, gd->fdt_blob, node); |
205 | if (ret) { | |
713cb680 | 206 | debug("%s: Could not decode key matrix from fdt\n", __func__); |
1fa4bfde | 207 | return ret; |
713cb680 | 208 | } |
1fa4bfde SG |
209 | debug("%s: Matrix keyboard %dx%d ready\n", __func__, priv->key_rows, |
210 | priv->key_cols); | |
713cb680 | 211 | |
1fa4bfde SG |
212 | priv->input = input; |
213 | input->dev = dev; | |
214 | input_add_tables(input); | |
215 | input->read_keys = cros_ec_kbc_check; | |
216 | strcpy(sdev->name, "cros-ec-keyb"); | |
713cb680 | 217 | |
1fa4bfde SG |
218 | /* Register the device. cros_ec_init_keyboard() will be called soon */ |
219 | return input_stdio_register(sdev); | |
220 | } | |
713cb680 | 221 | |
1fa4bfde SG |
222 | static const struct keyboard_ops cros_ec_kbd_ops = { |
223 | }; | |
713cb680 | 224 | |
1fa4bfde SG |
225 | static const struct udevice_id cros_ec_kbd_ids[] = { |
226 | { .compatible = "google,cros-ec-keyb" }, | |
227 | { } | |
228 | }; | |
713cb680 | 229 | |
1fa4bfde SG |
230 | U_BOOT_DRIVER(cros_ec_kbd) = { |
231 | .name = "cros_ec_kbd", | |
232 | .id = UCLASS_KEYBOARD, | |
233 | .of_match = cros_ec_kbd_ids, | |
234 | .probe = cros_ec_kbd_probe, | |
235 | .ops = &cros_ec_kbd_ops, | |
236 | .priv_auto_alloc_size = sizeof(struct cros_ec_keyb_priv), | |
237 | }; |