tcakp.c revision 1.13 1 /* $NetBSD: tcakp.c,v 1.13 2021/01/17 21:42:35 thorpej Exp $ */
2
3 /*-
4 * Copyright (c) 2017 Jared McNeill <jmcneill (at) invisible.ca>
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
17 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
18 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
19 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
20 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
24 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
25 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26 * POSSIBILITY OF SUCH DAMAGE.
27 */
28
29 #include "opt_fdt.h"
30
31 #include <sys/cdefs.h>
32 __KERNEL_RCSID(0, "$NetBSD: tcakp.c,v 1.13 2021/01/17 21:42:35 thorpej Exp $");
33
34 #include <sys/param.h>
35 #include <sys/systm.h>
36 #include <sys/kernel.h>
37 #include <sys/device.h>
38 #include <sys/conf.h>
39 #include <sys/bus.h>
40 #include <sys/kmem.h>
41 #include <sys/bitops.h>
42
43 #include <dev/i2c/i2cvar.h>
44
45 #include <dev/wscons/wsconsio.h>
46 #include <dev/wscons/wskbdvar.h>
47 #include <dev/wscons/wsksymdef.h>
48 #include <dev/wscons/wsksymvar.h>
49 #include <dev/wscons/linux_keymap.h>
50
51 #ifdef FDT
52 #include <dev/fdt/fdtvar.h>
53 #endif
54
55 #define TCA_MAX_ROWS 8
56 #define TCA_MAX_COLS 10
57
58 #define TCA_CFG 0x01
59 #define CFG_AI __BIT(7)
60 #define CFG_GPI_E_CFG __BIT(6)
61 #define CFG_OVR_FLOW_M __BIT(5)
62 #define CFG_INT_CFG __BIT(4)
63 #define CFG_OVR_FLOW_IEN __BIT(3)
64 #define CFG_K_LCK_IEN __BIT(2)
65 #define CFG_GPI_IEN __BIT(1)
66 #define CFG_KE_IEN __BIT(0)
67 #define TCA_INT_STAT 0x02
68 #define INT_STAT_CAD_INT __BIT(4)
69 #define INT_STAT_OVR_FLOW_INT __BIT(3)
70 #define INT_STAT_K_LCD_INT __BIT(2)
71 #define INT_STAT_GPI_INT __BIT(1)
72 #define INT_STAT_K_INT __BIT(0)
73 #define TCA_KEY_LCK_EC 0x03
74 #define KEY_LCK_EC_K_LCK_EN __BIT(6)
75 #define KEY_LCK_EC_LCK2 __BIT(5)
76 #define KEY_LCK_EC_LCK1 __BIT(4)
77 #define KEY_LCK_EC_KEC __BITS(3,0)
78 #define TCA_EVENT(c) (0x04 + (c) - 'A')
79 #define TCA_EVENT_STATE __BIT(7)
80 #define TCA_EVENT_CODE __BITS(6,0)
81 #define TCA_KP_GPIO1 0x1d
82 #define TCA_KP_GPIO2 0x1e
83 #define TCA_KP_GPIO3 0x1f
84 #define TCA_DEBOUNCE_DIS1 0x29
85 #define TCA_DEBOUNCE_DIS2 0x2a
86 #define TCA_DEBOUNCE_DIS3 0x2b
87
88 struct tcakp_softc {
89 device_t sc_dev;
90 i2c_tag_t sc_i2c;
91 i2c_addr_t sc_addr;
92 int sc_phandle;
93
94 u_int sc_rows;
95 u_int sc_cols;
96 bool sc_autorepeat;
97 u_int sc_row_shift;
98
99 uint16_t sc_keymap[128];
100
101 void *sc_ih;
102 void *sc_sih;
103
104 int sc_enabled;
105 device_t sc_wskbddev;
106 };
107
108 static int tcakp_match(device_t, cfdata_t, void *);
109 static void tcakp_attach(device_t, device_t, void *);
110
111 static int tcakp_i2c_lock(struct tcakp_softc *);
112 static void tcakp_i2c_unlock(struct tcakp_softc *);
113
114 static int tcakp_read(struct tcakp_softc *, uint8_t, uint8_t *);
115 static int tcakp_write(struct tcakp_softc *, uint8_t, uint8_t);
116
117 CFATTACH_DECL_NEW(tcakp, sizeof(struct tcakp_softc),
118 tcakp_match, tcakp_attach, NULL, NULL);
119
120 static const struct device_compatible_entry compat_data[] = {
121 { .compat = "ti,tca8418" },
122
123 { 0 }
124 };
125
126 static u_int
127 tcakp_decode(struct tcakp_softc *sc, uint8_t code)
128 {
129 u_int row = code / TCA_MAX_COLS;
130 u_int col = code % TCA_MAX_COLS;
131 if (col == 0) {
132 row = row - 1;
133 col = TCA_MAX_COLS - 1;
134 } else {
135 col = col - 1;
136 }
137
138 return (row << sc->sc_row_shift) + col;
139 }
140
141 static int
142 tcakp_intr(void *priv)
143 {
144 struct tcakp_softc * const sc = priv;
145
146 /*
147 * Schedule our soft interrupt handler. We can't access the i2c
148 * from hard interrupt context, so just go ahead and claim the
149 * interrupt.
150 *
151 * XXX If we ever end up with an instance that uses
152 * level-sensitive interrupts, we will need to mask
153 * the interrupt source.
154 */
155 softint_schedule(sc->sc_sih);
156 return 1;
157 }
158
159 static void
160 tcakp_softintr(void *priv)
161 {
162 struct tcakp_softc * const sc = priv;
163 uint8_t stat, ev;
164
165 if (tcakp_i2c_lock(sc) != 0)
166 return;
167
168 tcakp_read(sc, TCA_INT_STAT, &stat);
169 if (stat & INT_STAT_K_INT) {
170 tcakp_read(sc, TCA_EVENT('A'), &ev);
171 while (ev != 0) {
172 const bool pressed = __SHIFTOUT(ev, TCA_EVENT_STATE);
173 const uint8_t code = __SHIFTOUT(ev, TCA_EVENT_CODE);
174
175 tcakp_i2c_unlock(sc);
176
177 /* Translate raw code to keymap index */
178 const u_int index = tcakp_decode(sc, code);
179
180 u_int type = pressed ? WSCONS_EVENT_KEY_DOWN :
181 WSCONS_EVENT_KEY_UP;
182 int key = linux_key_to_usb(sc->sc_keymap[index]);
183
184 if (sc->sc_wskbddev)
185 wskbd_input(sc->sc_wskbddev, type, key);
186
187 if (tcakp_i2c_lock(sc) != 0)
188 return;
189 tcakp_read(sc, TCA_EVENT('A'), &ev);
190 }
191 }
192 tcakp_write(sc, TCA_INT_STAT, stat);
193 tcakp_i2c_unlock(sc);
194 }
195
196 static int
197 tcakp_init(struct tcakp_softc *sc)
198 {
199 uint32_t mask;
200 uint8_t val;
201 int error;
202
203 if (sc->sc_rows == 0 || sc->sc_cols == 0) {
204 aprint_error_dev(sc->sc_dev, "not configured\n");
205 return ENXIO;
206 }
207
208 mask = __BITS(sc->sc_rows - 1, 0);
209 mask += __BITS(sc->sc_cols - 1, 0) << 8;
210
211 error = tcakp_i2c_lock(sc);
212 if (error)
213 return error;
214
215 /* Lock the keyboard */
216 tcakp_write(sc, TCA_KEY_LCK_EC, KEY_LCK_EC_K_LCK_EN);
217 /* Select keyboard mode */
218 tcakp_write(sc, TCA_KP_GPIO1, (mask >> 0) & 0xff);
219 tcakp_write(sc, TCA_KP_GPIO2, (mask >> 8) & 0xff);
220 tcakp_write(sc, TCA_KP_GPIO3, (mask >> 16) & 0xff);
221 /* Disable debounce */
222 tcakp_write(sc, TCA_DEBOUNCE_DIS1, (mask >> 0) & 0xff);
223 tcakp_write(sc, TCA_DEBOUNCE_DIS2, (mask >> 8) & 0xff);
224 tcakp_write(sc, TCA_DEBOUNCE_DIS3, (mask >> 16) & 0xff);
225 /* Enable key event interrupts */
226 tcakp_write(sc, TCA_CFG, CFG_INT_CFG | CFG_KE_IEN);
227 /* Clear interrupts */
228 tcakp_read(sc, TCA_INT_STAT, &val);
229 tcakp_write(sc, TCA_INT_STAT, val);
230
231 tcakp_i2c_unlock(sc);
232
233 return 0;
234 }
235
236 static void
237 tcakp_configure_fdt(struct tcakp_softc *sc)
238 {
239 const uint32_t *keymap;
240 int len;
241
242 of_getprop_uint32(sc->sc_phandle, "keypad,num-rows", &sc->sc_rows);
243 of_getprop_uint32(sc->sc_phandle, "keypad,num-columns", &sc->sc_cols);
244 sc->sc_autorepeat = of_getprop_bool(sc->sc_phandle, "keypad,autorepeat");
245
246 keymap = fdtbus_get_prop(sc->sc_phandle, "linux,keymap", &len);
247 if (keymap == NULL || len <= 0)
248 return;
249
250 sc->sc_row_shift = fls32(sc->sc_cols) - 1;
251 if (sc->sc_row_shift & (sc->sc_cols - 1))
252 sc->sc_row_shift++;
253
254 while (len >= 4) {
255 const uint32_t e = be32toh(*keymap);
256 const u_int row = (e >> 24) & 0xff;
257 const u_int col = (e >> 16) & 0xff;
258 const u_int index = (row << sc->sc_row_shift) + col;
259
260 sc->sc_keymap[index] = e & 0xffff;
261
262 len -= 4;
263 keymap++;
264 }
265 }
266
267 static int
268 tcakp_enable(void *v, int on)
269 {
270 struct tcakp_softc * const sc = v;
271 int error;
272
273 error = tcakp_i2c_lock(sc);
274 if (error)
275 return error;
276
277 if (on) {
278 /* Disable key lock */
279 tcakp_write(sc, TCA_KEY_LCK_EC, 0);
280 } else {
281 /* Enable key lock */
282 tcakp_write(sc, TCA_KEY_LCK_EC, KEY_LCK_EC_K_LCK_EN);
283 }
284
285 tcakp_i2c_unlock(sc);
286 return 0;
287 }
288
289 static void
290 tcakp_set_leds(void *v, int leds)
291 {
292 }
293
294 static int
295 tcakp_ioctl(void *v, u_long cmd, void *data, int flag, lwp_t *l)
296 {
297 switch (cmd) {
298 case WSKBDIO_GTYPE:
299 *(int *)data = WSKBD_TYPE_USB;
300 return 0;
301 }
302
303 return EPASSTHROUGH;
304 }
305
306 static const struct wskbd_accessops tcakp_accessops = {
307 tcakp_enable,
308 tcakp_set_leds,
309 tcakp_ioctl,
310 };
311
312 #if notyet
313 static void
314 tcakp_cngetc(void *v, u_int *type, int *data)
315 {
316 struct tcakp_softc * const sc = v;
317 uint8_t ev = 0;
318
319 /* XXX i2c bus acquire */
320
321 do {
322 tcakp_read(sc, TCA_EVENT('A'), &ev);
323 } while (ev == 0);
324
325 const bool pressed = __SHIFTOUT(ev, TCA_EVENT_STATE);
326 const uint8_t code = __SHIFTOUT(ev, TCA_EVENT_CODE);
327 const u_int index = tcakp_decode(sc, code);
328
329 *type = pressed ? WSCONS_EVENT_KEY_DOWN :
330 WSCONS_EVENT_KEY_UP;
331 *data = sc->sc_keymap[index];
332
333 /* XXX i2c bus release */
334 }
335
336 static void
337 tcakp_cnpollc(void *v, int on)
338 {
339 }
340
341 static void
342 tcakp_cnbell(void *v, u_int pitch, u_int period, u_int volume)
343 {
344 }
345
346 static const struct wskbd_consops tcakp_consops = {
347 tcakp_cngetc,
348 tcakp_cnpollc,
349 tcakp_cnbell,
350 };
351 #endif
352
353 extern const struct wscons_keydesc hidkbd_keydesctab[];
354 static const struct wskbd_mapdata tcakp_keymapdata = {
355 hidkbd_keydesctab,
356 KB_US,
357 };
358
359 static int
360 tcakp_match(device_t parent, cfdata_t match, void *aux)
361 {
362 struct i2c_attach_args *ia = aux;
363 int match_result;
364
365 if (iic_use_direct_match(ia, match, compat_data, &match_result))
366 return match_result;
367
368 if (ia->ia_addr == 0x34)
369 return I2C_MATCH_ADDRESS_ONLY;
370
371 return 0;
372 }
373
374 static void
375 tcakp_attach(device_t parent, device_t self, void *aux)
376 {
377 struct tcakp_softc * const sc = device_private(self);
378 struct i2c_attach_args *ia = aux;
379 struct wskbddev_attach_args a;
380
381 sc->sc_dev = self;
382 sc->sc_i2c = ia->ia_tag;
383 sc->sc_addr = ia->ia_addr;
384 sc->sc_phandle = ia->ia_cookie;
385
386 aprint_naive("\n");
387 aprint_normal(": TCA8418\n");
388
389 #ifdef FDT
390 sc->sc_ih = fdtbus_intr_establish(sc->sc_phandle, 0, IPL_VM, 0,
391 tcakp_intr, sc);
392 /*
393 * XXX This is an edge-sensitive interrupt, but we'd like to
394 * be able to check at run-time just to be sure.
395 */
396 if (sc->sc_ih == NULL) {
397 aprint_error_dev(sc->sc_dev, "unable to establish interrupt\n");
398 return;
399 }
400
401 sc->sc_sih = softint_establish(SOFTINT_SERIAL, tcakp_softintr, sc);
402 if (sc->sc_sih == NULL) {
403 aprint_error_dev(sc->sc_dev,
404 "unable to establish soft interrupt\n");
405 return;
406 }
407
408 tcakp_configure_fdt(sc);
409 #endif
410
411 if (tcakp_init(sc) != 0)
412 return;
413
414 memset(&a, 0, sizeof(a));
415 a.console = false; /* XXX */
416 a.keymap = &tcakp_keymapdata;
417 a.accessops = &tcakp_accessops;
418 a.accesscookie = sc;
419
420 sc->sc_wskbddev = config_found_ia(self, "wskbddev", &a, wskbddevprint);
421 }
422
423 static int
424 tcakp_i2c_lock(struct tcakp_softc *sc)
425 {
426 int error;
427
428 error = iic_acquire_bus(sc->sc_i2c, 0);
429 if (error) {
430 aprint_error_dev(sc->sc_dev,
431 "unable to acquire bus lock (%d)\n", error);
432 }
433 return error;
434 }
435
436 static void
437 tcakp_i2c_unlock(struct tcakp_softc *sc)
438 {
439 iic_release_bus(sc->sc_i2c, 0);
440 }
441
442 static int
443 tcakp_read(struct tcakp_softc *sc, uint8_t reg, uint8_t *val)
444 {
445 return iic_exec(sc->sc_i2c, I2C_OP_READ_WITH_STOP, sc->sc_addr,
446 ®, 1, val, 1, 0);
447 }
448
449 static int
450 tcakp_write(struct tcakp_softc *sc, uint8_t reg, uint8_t val)
451 {
452 uint8_t buf[2] = { reg, val };
453
454 return iic_exec(sc->sc_i2c, I2C_OP_WRITE_WITH_STOP,
455 sc->sc_addr, NULL, 0, buf, 2, 0);
456 }
457