1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun * (C) Copyright 2002 ELTEC Elektronik AG
3*4882a593Smuzhiyun * Frank Gottschling <fgottschling@eltec.de>
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * SPDX-License-Identifier: GPL-2.0+
6*4882a593Smuzhiyun */
7*4882a593Smuzhiyun
8*4882a593Smuzhiyun /* i8042.c - Intel 8042 keyboard driver routines */
9*4882a593Smuzhiyun
10*4882a593Smuzhiyun #include <common.h>
11*4882a593Smuzhiyun #include <dm.h>
12*4882a593Smuzhiyun #include <errno.h>
13*4882a593Smuzhiyun #include <i8042.h>
14*4882a593Smuzhiyun #include <input.h>
15*4882a593Smuzhiyun #include <keyboard.h>
16*4882a593Smuzhiyun #include <asm/io.h>
17*4882a593Smuzhiyun
18*4882a593Smuzhiyun DECLARE_GLOBAL_DATA_PTR;
19*4882a593Smuzhiyun
20*4882a593Smuzhiyun /* defines */
21*4882a593Smuzhiyun #define in8(p) inb(p)
22*4882a593Smuzhiyun #define out8(p, v) outb(v, p)
23*4882a593Smuzhiyun
24*4882a593Smuzhiyun enum {
25*4882a593Smuzhiyun QUIRK_DUP_POR = 1 << 0,
26*4882a593Smuzhiyun };
27*4882a593Smuzhiyun
28*4882a593Smuzhiyun /* locals */
29*4882a593Smuzhiyun struct i8042_kbd_priv {
30*4882a593Smuzhiyun bool extended; /* true if an extended keycode is expected next */
31*4882a593Smuzhiyun int quirks; /* quirks that we support */
32*4882a593Smuzhiyun };
33*4882a593Smuzhiyun
34*4882a593Smuzhiyun static unsigned char ext_key_map[] = {
35*4882a593Smuzhiyun 0x1c, /* keypad enter */
36*4882a593Smuzhiyun 0x1d, /* right control */
37*4882a593Smuzhiyun 0x35, /* keypad slash */
38*4882a593Smuzhiyun 0x37, /* print screen */
39*4882a593Smuzhiyun 0x38, /* right alt */
40*4882a593Smuzhiyun 0x46, /* break */
41*4882a593Smuzhiyun 0x47, /* editpad home */
42*4882a593Smuzhiyun 0x48, /* editpad up */
43*4882a593Smuzhiyun 0x49, /* editpad pgup */
44*4882a593Smuzhiyun 0x4b, /* editpad left */
45*4882a593Smuzhiyun 0x4d, /* editpad right */
46*4882a593Smuzhiyun 0x4f, /* editpad end */
47*4882a593Smuzhiyun 0x50, /* editpad dn */
48*4882a593Smuzhiyun 0x51, /* editpad pgdn */
49*4882a593Smuzhiyun 0x52, /* editpad ins */
50*4882a593Smuzhiyun 0x53, /* editpad del */
51*4882a593Smuzhiyun 0x00 /* map end */
52*4882a593Smuzhiyun };
53*4882a593Smuzhiyun
kbd_input_empty(void)54*4882a593Smuzhiyun static int kbd_input_empty(void)
55*4882a593Smuzhiyun {
56*4882a593Smuzhiyun int kbd_timeout = KBD_TIMEOUT * 1000;
57*4882a593Smuzhiyun
58*4882a593Smuzhiyun while ((in8(I8042_STS_REG) & STATUS_IBF) && kbd_timeout--)
59*4882a593Smuzhiyun udelay(1);
60*4882a593Smuzhiyun
61*4882a593Smuzhiyun return kbd_timeout != -1;
62*4882a593Smuzhiyun }
63*4882a593Smuzhiyun
kbd_output_full(void)64*4882a593Smuzhiyun static int kbd_output_full(void)
65*4882a593Smuzhiyun {
66*4882a593Smuzhiyun int kbd_timeout = KBD_TIMEOUT * 1000;
67*4882a593Smuzhiyun
68*4882a593Smuzhiyun while (((in8(I8042_STS_REG) & STATUS_OBF) == 0) && kbd_timeout--)
69*4882a593Smuzhiyun udelay(1);
70*4882a593Smuzhiyun
71*4882a593Smuzhiyun return kbd_timeout != -1;
72*4882a593Smuzhiyun }
73*4882a593Smuzhiyun
74*4882a593Smuzhiyun /**
75*4882a593Smuzhiyun * check_leds() - Check the keyboard LEDs and update them it needed
76*4882a593Smuzhiyun *
77*4882a593Smuzhiyun * @ret: Value to return
78*4882a593Smuzhiyun * @return value of @ret
79*4882a593Smuzhiyun */
i8042_kbd_update_leds(struct udevice * dev,int leds)80*4882a593Smuzhiyun static int i8042_kbd_update_leds(struct udevice *dev, int leds)
81*4882a593Smuzhiyun {
82*4882a593Smuzhiyun kbd_input_empty();
83*4882a593Smuzhiyun out8(I8042_DATA_REG, CMD_SET_KBD_LED);
84*4882a593Smuzhiyun kbd_input_empty();
85*4882a593Smuzhiyun out8(I8042_DATA_REG, leds & 0x7);
86*4882a593Smuzhiyun
87*4882a593Smuzhiyun return 0;
88*4882a593Smuzhiyun }
89*4882a593Smuzhiyun
kbd_write(int reg,int value)90*4882a593Smuzhiyun static int kbd_write(int reg, int value)
91*4882a593Smuzhiyun {
92*4882a593Smuzhiyun if (!kbd_input_empty())
93*4882a593Smuzhiyun return -1;
94*4882a593Smuzhiyun out8(reg, value);
95*4882a593Smuzhiyun
96*4882a593Smuzhiyun return 0;
97*4882a593Smuzhiyun }
98*4882a593Smuzhiyun
kbd_read(int reg)99*4882a593Smuzhiyun static int kbd_read(int reg)
100*4882a593Smuzhiyun {
101*4882a593Smuzhiyun if (!kbd_output_full())
102*4882a593Smuzhiyun return -1;
103*4882a593Smuzhiyun
104*4882a593Smuzhiyun return in8(reg);
105*4882a593Smuzhiyun }
106*4882a593Smuzhiyun
kbd_cmd_read(int cmd)107*4882a593Smuzhiyun static int kbd_cmd_read(int cmd)
108*4882a593Smuzhiyun {
109*4882a593Smuzhiyun if (kbd_write(I8042_CMD_REG, cmd))
110*4882a593Smuzhiyun return -1;
111*4882a593Smuzhiyun
112*4882a593Smuzhiyun return kbd_read(I8042_DATA_REG);
113*4882a593Smuzhiyun }
114*4882a593Smuzhiyun
kbd_cmd_write(int cmd,int data)115*4882a593Smuzhiyun static int kbd_cmd_write(int cmd, int data)
116*4882a593Smuzhiyun {
117*4882a593Smuzhiyun if (kbd_write(I8042_CMD_REG, cmd))
118*4882a593Smuzhiyun return -1;
119*4882a593Smuzhiyun
120*4882a593Smuzhiyun return kbd_write(I8042_DATA_REG, data);
121*4882a593Smuzhiyun }
122*4882a593Smuzhiyun
kbd_reset(int quirk)123*4882a593Smuzhiyun static int kbd_reset(int quirk)
124*4882a593Smuzhiyun {
125*4882a593Smuzhiyun int config;
126*4882a593Smuzhiyun
127*4882a593Smuzhiyun /* controller self test */
128*4882a593Smuzhiyun if (kbd_cmd_read(CMD_SELF_TEST) != KBC_TEST_OK)
129*4882a593Smuzhiyun goto err;
130*4882a593Smuzhiyun
131*4882a593Smuzhiyun /* keyboard reset */
132*4882a593Smuzhiyun if (kbd_write(I8042_DATA_REG, CMD_RESET_KBD) ||
133*4882a593Smuzhiyun kbd_read(I8042_DATA_REG) != KBD_ACK ||
134*4882a593Smuzhiyun kbd_read(I8042_DATA_REG) != KBD_POR)
135*4882a593Smuzhiyun goto err;
136*4882a593Smuzhiyun
137*4882a593Smuzhiyun if (kbd_write(I8042_DATA_REG, CMD_DRAIN_OUTPUT) ||
138*4882a593Smuzhiyun kbd_read(I8042_DATA_REG) != KBD_ACK)
139*4882a593Smuzhiyun goto err;
140*4882a593Smuzhiyun
141*4882a593Smuzhiyun /* set AT translation and disable irq */
142*4882a593Smuzhiyun config = kbd_cmd_read(CMD_RD_CONFIG);
143*4882a593Smuzhiyun if (config == -1)
144*4882a593Smuzhiyun goto err;
145*4882a593Smuzhiyun
146*4882a593Smuzhiyun /* Sometimes get a second byte */
147*4882a593Smuzhiyun else if ((quirk & QUIRK_DUP_POR) && config == KBD_POR)
148*4882a593Smuzhiyun config = kbd_cmd_read(CMD_RD_CONFIG);
149*4882a593Smuzhiyun
150*4882a593Smuzhiyun config |= CONFIG_AT_TRANS;
151*4882a593Smuzhiyun config &= ~(CONFIG_KIRQ_EN | CONFIG_MIRQ_EN);
152*4882a593Smuzhiyun if (kbd_cmd_write(CMD_WR_CONFIG, config))
153*4882a593Smuzhiyun goto err;
154*4882a593Smuzhiyun
155*4882a593Smuzhiyun /* enable keyboard */
156*4882a593Smuzhiyun if (kbd_write(I8042_CMD_REG, CMD_KBD_EN) ||
157*4882a593Smuzhiyun !kbd_input_empty())
158*4882a593Smuzhiyun goto err;
159*4882a593Smuzhiyun
160*4882a593Smuzhiyun return 0;
161*4882a593Smuzhiyun err:
162*4882a593Smuzhiyun debug("%s: Keyboard failure\n", __func__);
163*4882a593Smuzhiyun return -1;
164*4882a593Smuzhiyun }
165*4882a593Smuzhiyun
kbd_controller_present(void)166*4882a593Smuzhiyun static int kbd_controller_present(void)
167*4882a593Smuzhiyun {
168*4882a593Smuzhiyun return in8(I8042_STS_REG) != 0xff;
169*4882a593Smuzhiyun }
170*4882a593Smuzhiyun
171*4882a593Smuzhiyun /*
172*4882a593Smuzhiyun * Implement a weak default function for boards that optionally
173*4882a593Smuzhiyun * need to skip the i8042 initialization.
174*4882a593Smuzhiyun *
175*4882a593Smuzhiyun * TODO(sjg@chromium.org): Use device tree for this?
176*4882a593Smuzhiyun */
board_i8042_skip(void)177*4882a593Smuzhiyun int __weak board_i8042_skip(void)
178*4882a593Smuzhiyun {
179*4882a593Smuzhiyun /* As default, don't skip */
180*4882a593Smuzhiyun return 0;
181*4882a593Smuzhiyun }
182*4882a593Smuzhiyun
i8042_flush(void)183*4882a593Smuzhiyun void i8042_flush(void)
184*4882a593Smuzhiyun {
185*4882a593Smuzhiyun int timeout;
186*4882a593Smuzhiyun
187*4882a593Smuzhiyun /*
188*4882a593Smuzhiyun * The delay is to give the keyboard controller some time
189*4882a593Smuzhiyun * to fill the next byte.
190*4882a593Smuzhiyun */
191*4882a593Smuzhiyun while (1) {
192*4882a593Smuzhiyun timeout = 100; /* wait for no longer than 100us */
193*4882a593Smuzhiyun while (timeout > 0 && !(in8(I8042_STS_REG) & STATUS_OBF)) {
194*4882a593Smuzhiyun udelay(1);
195*4882a593Smuzhiyun timeout--;
196*4882a593Smuzhiyun }
197*4882a593Smuzhiyun
198*4882a593Smuzhiyun /* Try to pull next byte if not timeout */
199*4882a593Smuzhiyun if (in8(I8042_STS_REG) & STATUS_OBF)
200*4882a593Smuzhiyun in8(I8042_DATA_REG);
201*4882a593Smuzhiyun else
202*4882a593Smuzhiyun break;
203*4882a593Smuzhiyun }
204*4882a593Smuzhiyun }
205*4882a593Smuzhiyun
i8042_disable(void)206*4882a593Smuzhiyun int i8042_disable(void)
207*4882a593Smuzhiyun {
208*4882a593Smuzhiyun if (kbd_input_empty() == 0)
209*4882a593Smuzhiyun return -1;
210*4882a593Smuzhiyun
211*4882a593Smuzhiyun /* Disable keyboard */
212*4882a593Smuzhiyun out8(I8042_CMD_REG, CMD_KBD_DIS);
213*4882a593Smuzhiyun
214*4882a593Smuzhiyun if (kbd_input_empty() == 0)
215*4882a593Smuzhiyun return -1;
216*4882a593Smuzhiyun
217*4882a593Smuzhiyun return 0;
218*4882a593Smuzhiyun }
219*4882a593Smuzhiyun
i8042_kbd_check(struct input_config * input)220*4882a593Smuzhiyun static int i8042_kbd_check(struct input_config *input)
221*4882a593Smuzhiyun {
222*4882a593Smuzhiyun struct i8042_kbd_priv *priv = dev_get_priv(input->dev);
223*4882a593Smuzhiyun
224*4882a593Smuzhiyun if ((in8(I8042_STS_REG) & STATUS_OBF) == 0) {
225*4882a593Smuzhiyun return 0;
226*4882a593Smuzhiyun } else {
227*4882a593Smuzhiyun bool release = false;
228*4882a593Smuzhiyun int scan_code;
229*4882a593Smuzhiyun int i;
230*4882a593Smuzhiyun
231*4882a593Smuzhiyun scan_code = in8(I8042_DATA_REG);
232*4882a593Smuzhiyun if (scan_code == 0xfa) {
233*4882a593Smuzhiyun return 0;
234*4882a593Smuzhiyun } else if (scan_code == 0xe0) {
235*4882a593Smuzhiyun priv->extended = true;
236*4882a593Smuzhiyun return 0;
237*4882a593Smuzhiyun }
238*4882a593Smuzhiyun if (scan_code & 0x80) {
239*4882a593Smuzhiyun scan_code &= 0x7f;
240*4882a593Smuzhiyun release = true;
241*4882a593Smuzhiyun }
242*4882a593Smuzhiyun if (priv->extended) {
243*4882a593Smuzhiyun priv->extended = false;
244*4882a593Smuzhiyun for (i = 0; ext_key_map[i]; i++) {
245*4882a593Smuzhiyun if (ext_key_map[i] == scan_code) {
246*4882a593Smuzhiyun scan_code = 0x60 + i;
247*4882a593Smuzhiyun break;
248*4882a593Smuzhiyun }
249*4882a593Smuzhiyun }
250*4882a593Smuzhiyun /* not found ? */
251*4882a593Smuzhiyun if (!ext_key_map[i])
252*4882a593Smuzhiyun return 0;
253*4882a593Smuzhiyun }
254*4882a593Smuzhiyun
255*4882a593Smuzhiyun input_add_keycode(input, scan_code, release);
256*4882a593Smuzhiyun return 1;
257*4882a593Smuzhiyun }
258*4882a593Smuzhiyun }
259*4882a593Smuzhiyun
260*4882a593Smuzhiyun /* i8042_kbd_init - reset keyboard and init state flags */
i8042_start(struct udevice * dev)261*4882a593Smuzhiyun static int i8042_start(struct udevice *dev)
262*4882a593Smuzhiyun {
263*4882a593Smuzhiyun struct keyboard_priv *uc_priv = dev_get_uclass_priv(dev);
264*4882a593Smuzhiyun struct i8042_kbd_priv *priv = dev_get_priv(dev);
265*4882a593Smuzhiyun struct input_config *input = &uc_priv->input;
266*4882a593Smuzhiyun int keymap, try;
267*4882a593Smuzhiyun char *penv;
268*4882a593Smuzhiyun int ret;
269*4882a593Smuzhiyun
270*4882a593Smuzhiyun if (!kbd_controller_present() || board_i8042_skip()) {
271*4882a593Smuzhiyun debug("i8042 keyboard controller is not present\n");
272*4882a593Smuzhiyun return -ENOENT;
273*4882a593Smuzhiyun }
274*4882a593Smuzhiyun
275*4882a593Smuzhiyun /* Init keyboard device (default US layout) */
276*4882a593Smuzhiyun keymap = KBD_US;
277*4882a593Smuzhiyun penv = env_get("keymap");
278*4882a593Smuzhiyun if (penv != NULL) {
279*4882a593Smuzhiyun if (strncmp(penv, "de", 3) == 0)
280*4882a593Smuzhiyun keymap = KBD_GER;
281*4882a593Smuzhiyun }
282*4882a593Smuzhiyun
283*4882a593Smuzhiyun for (try = 0; kbd_reset(priv->quirks) != 0; try++) {
284*4882a593Smuzhiyun if (try >= KBD_RESET_TRIES)
285*4882a593Smuzhiyun return -1;
286*4882a593Smuzhiyun }
287*4882a593Smuzhiyun
288*4882a593Smuzhiyun ret = input_add_tables(input, keymap == KBD_GER);
289*4882a593Smuzhiyun if (ret)
290*4882a593Smuzhiyun return ret;
291*4882a593Smuzhiyun
292*4882a593Smuzhiyun i8042_kbd_update_leds(dev, NORMAL);
293*4882a593Smuzhiyun debug("%s: started\n", __func__);
294*4882a593Smuzhiyun
295*4882a593Smuzhiyun return 0;
296*4882a593Smuzhiyun }
297*4882a593Smuzhiyun
298*4882a593Smuzhiyun /**
299*4882a593Smuzhiyun * Set up the i8042 keyboard. This is called by the stdio device handler
300*4882a593Smuzhiyun *
301*4882a593Smuzhiyun * We want to do this init when the keyboard is actually used rather than
302*4882a593Smuzhiyun * at start-up, since keyboard input may not currently be selected.
303*4882a593Smuzhiyun *
304*4882a593Smuzhiyun * Once the keyboard starts there will be a period during which we must
305*4882a593Smuzhiyun * wait for the keyboard to init. We do this only when a key is first
306*4882a593Smuzhiyun * read - see kbd_wait_for_fifo_init().
307*4882a593Smuzhiyun *
308*4882a593Smuzhiyun * @return 0 if ok, -ve on error
309*4882a593Smuzhiyun */
i8042_kbd_probe(struct udevice * dev)310*4882a593Smuzhiyun static int i8042_kbd_probe(struct udevice *dev)
311*4882a593Smuzhiyun {
312*4882a593Smuzhiyun struct keyboard_priv *uc_priv = dev_get_uclass_priv(dev);
313*4882a593Smuzhiyun struct i8042_kbd_priv *priv = dev_get_priv(dev);
314*4882a593Smuzhiyun struct stdio_dev *sdev = &uc_priv->sdev;
315*4882a593Smuzhiyun struct input_config *input = &uc_priv->input;
316*4882a593Smuzhiyun int ret;
317*4882a593Smuzhiyun
318*4882a593Smuzhiyun if (fdtdec_get_bool(gd->fdt_blob, dev_of_offset(dev),
319*4882a593Smuzhiyun "intel,duplicate-por"))
320*4882a593Smuzhiyun priv->quirks |= QUIRK_DUP_POR;
321*4882a593Smuzhiyun
322*4882a593Smuzhiyun /* Register the device. i8042_start() will be called soon */
323*4882a593Smuzhiyun input->dev = dev;
324*4882a593Smuzhiyun input->read_keys = i8042_kbd_check;
325*4882a593Smuzhiyun input_allow_repeats(input, true);
326*4882a593Smuzhiyun strcpy(sdev->name, "i8042-kbd");
327*4882a593Smuzhiyun ret = input_stdio_register(sdev);
328*4882a593Smuzhiyun if (ret) {
329*4882a593Smuzhiyun debug("%s: input_stdio_register() failed\n", __func__);
330*4882a593Smuzhiyun return ret;
331*4882a593Smuzhiyun }
332*4882a593Smuzhiyun debug("%s: ready\n", __func__);
333*4882a593Smuzhiyun
334*4882a593Smuzhiyun return 0;
335*4882a593Smuzhiyun }
336*4882a593Smuzhiyun
337*4882a593Smuzhiyun static const struct keyboard_ops i8042_kbd_ops = {
338*4882a593Smuzhiyun .start = i8042_start,
339*4882a593Smuzhiyun .update_leds = i8042_kbd_update_leds,
340*4882a593Smuzhiyun };
341*4882a593Smuzhiyun
342*4882a593Smuzhiyun static const struct udevice_id i8042_kbd_ids[] = {
343*4882a593Smuzhiyun { .compatible = "intel,i8042-keyboard" },
344*4882a593Smuzhiyun { }
345*4882a593Smuzhiyun };
346*4882a593Smuzhiyun
347*4882a593Smuzhiyun U_BOOT_DRIVER(i8042_kbd) = {
348*4882a593Smuzhiyun .name = "i8042_kbd",
349*4882a593Smuzhiyun .id = UCLASS_KEYBOARD,
350*4882a593Smuzhiyun .of_match = i8042_kbd_ids,
351*4882a593Smuzhiyun .probe = i8042_kbd_probe,
352*4882a593Smuzhiyun .ops = &i8042_kbd_ops,
353*4882a593Smuzhiyun .priv_auto_alloc_size = sizeof(struct i8042_kbd_priv),
354*4882a593Smuzhiyun };
355