xref: /openbmc/u-boot/include/i8042.h (revision 76b00aca)
1 /*
2  * (C) Copyright 2002 ELTEC Elektronik AG
3  * Frank Gottschling <fgottschling@eltec.de>
4  *
5  * SPDX-License-Identifier:	GPL-2.0+
6  */
7 
8 /* i8042.h - Intel 8042 keyboard driver header */
9 
10 #ifndef _I8042_H_
11 #define _I8042_H_
12 
13 /* defines */
14 
15 #define I8042_DATA_REG	0x60	/* keyboard i/o buffer */
16 #define I8042_STS_REG	0x64	/* keyboard status read */
17 #define I8042_CMD_REG	0x64	/* keyboard ctrl write */
18 
19 /* Status register bit defines */
20 #define STATUS_OBF	(1 << 0)
21 #define STATUS_IBF	(1 << 1)
22 
23 /* Configuration byte bit defines */
24 #define CONFIG_KIRQ_EN	(1 << 0)
25 #define CONFIG_MIRQ_EN	(1 << 1)
26 #define CONFIG_SET_BIST	(1 << 2)
27 #define CONFIG_KCLK_DIS	(1 << 4)
28 #define CONFIG_MCLK_DIS	(1 << 5)
29 #define CONFIG_AT_TRANS	(1 << 6)
30 
31 /* i8042 commands */
32 #define CMD_RD_CONFIG	0x20	/* read configuration byte */
33 #define CMD_WR_CONFIG	0x60	/* write configuration byte */
34 #define CMD_SELF_TEST	0xaa	/* controller self-test */
35 #define CMD_KBD_DIS	0xad	/* keyboard disable */
36 #define CMD_KBD_EN	0xae	/* keyboard enable */
37 #define CMD_SET_KBD_LED	0xed	/* set keyboard led */
38 #define CMD_DRAIN_OUTPUT 0xf4   /* drain output buffer */
39 #define CMD_RESET_KBD	0xff	/* reset keyboard */
40 
41 /* i8042 command result */
42 #define KBC_TEST_OK	0x55
43 #define KBD_ACK		0xfa
44 #define KBD_POR		0xaa
45 
46 /* keyboard scan codes */
47 
48 #define KBD_US		0	/* default US layout */
49 #define KBD_GER		1	/* german layout */
50 
51 #define KBD_TIMEOUT	1000	/* 1 sec */
52 #define KBD_RESET_TRIES	3
53 
54 #define AS		0	/* normal character index */
55 #define SH		1	/* shift index */
56 #define CN		2	/* control index */
57 #define NM		3	/* numeric lock index */
58 #define AK		4	/* right alt key */
59 #define CP		5	/* capslock index */
60 #define ST		6	/* stop output index */
61 #define EX		7	/* extended code index */
62 #define ES		8	/* escape and extended code index */
63 
64 #define NORMAL		0x0000	/* normal key */
65 #define STP		0x0001	/* scroll lock stop output*/
66 #define NUM		0x0002	/* numeric lock */
67 #define CAPS		0x0004	/* capslock */
68 #define SHIFT		0x0008	/* shift */
69 #define CTRL		0x0010	/* control*/
70 #define EXT		0x0020	/* extended scan code 0xe0 */
71 #define ESC		0x0040	/* escape key press */
72 #define E1		0x0080	/* extended scan code 0xe1 */
73 #define BRK		0x0100	/* make break flag for keyboard */
74 #define ALT		0x0200	/* right alt */
75 
76 /* exports */
77 
78 /**
79  * Flush all buffer from keyboard controller to host.
80  */
81 void i8042_flush(void);
82 
83 /**
84  * Disables the keyboard so that key strokes no longer generate scancodes to
85  * the host.
86  *
87  * @return 0 if ok, -1 if keyboard input was found while disabling
88  */
89 int i8042_disable(void);
90 
91 #endif /* _I8042_H_ */
92