xref: /freebsd/sys/dev/atkbdc/atkbdcreg.h (revision 02e9120893770924227138ba49df1edb3896112a)
1 /*-
2  * SPDX-License-Identifier: BSD-3-Clause
3  *
4  * Copyright (c) 1996-1999
5  * Kazutaka YOKOTA (yokota@zodiac.mech.utsunomiya-u.ac.jp)
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  * 3. The name of the author may not be used to endorse or promote
17  *    products derived from this software without specific prior written
18  *    permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30  * SUCH DAMAGE.
31  * from kbdio.h,v 1.8 1998/09/25 11:55:46 yokota Exp
32  */
33 
34 #ifndef _DEV_ATKBDC_ATKBDCREG_H_
35 #define	_DEV_ATKBDC_ATKBDCREG_H_
36 
37 /* constants */
38 
39 /* I/O ports */
40 #define KBD_STATUS_PORT 	4	/* status port, read */
41 #define KBD_COMMAND_PORT	4	/* controller command port, write */
42 #define KBD_DATA_PORT		0	/* data port, read/write
43 					 * also used as keyboard command
44 					 * and mouse command port
45 					 */
46 
47 /* controller commands (sent to KBD_COMMAND_PORT) */
48 #define KBDC_SET_COMMAND_BYTE 	0x0060
49 #define KBDC_GET_COMMAND_BYTE 	0x0020
50 #define KBDC_WRITE_TO_AUX_MUX	0x0090
51 #define KBDC_FORCE_AUX_OUTPUT	0x00d3
52 #define KBDC_WRITE_TO_AUX    	0x00d4
53 #define KBDC_DISABLE_AUX_PORT 	0x00a7
54 #define KBDC_ENABLE_AUX_PORT 	0x00a8
55 #define KBDC_TEST_AUX_PORT   	0x00a9
56 #define KBDC_DIAGNOSE	     	0x00aa
57 #define KBDC_TEST_KBD_PORT   	0x00ab
58 #define KBDC_DISABLE_KBD_PORT 	0x00ad
59 #define KBDC_ENABLE_KBD_PORT 	0x00ae
60 
61 /* controller command byte (set by KBDC_SET_COMMAND_BYTE) */
62 #define KBD_TRANSLATION		0x0040
63 #define KBD_RESERVED_BITS	0x0004
64 #define KBD_OVERRIDE_KBD_LOCK	0x0008
65 #define KBD_ENABLE_KBD_PORT    	0x0000
66 #define KBD_DISABLE_KBD_PORT   	0x0010
67 #define KBD_ENABLE_AUX_PORT	0x0000
68 #define KBD_DISABLE_AUX_PORT	0x0020
69 #define KBD_ENABLE_AUX_INT	0x0002
70 #define KBD_DISABLE_AUX_INT	0x0000
71 #define KBD_ENABLE_KBD_INT     	0x0001
72 #define KBD_DISABLE_KBD_INT    	0x0000
73 #define KBD_KBD_CONTROL_BITS	(KBD_DISABLE_KBD_PORT | KBD_ENABLE_KBD_INT)
74 #define KBD_AUX_CONTROL_BITS	(KBD_DISABLE_AUX_PORT | KBD_ENABLE_AUX_INT)
75 
76 /* keyboard device commands (sent to KBD_DATA_PORT) */
77 #define KBDC_RESET_KBD	     	0x00ff
78 #define KBDC_ENABLE_KBD		0x00f4
79 #define KBDC_DISABLE_KBD	0x00f5
80 #define KBDC_SET_DEFAULTS	0x00f6
81 #define KBDC_SEND_DEV_ID	0x00f2
82 #define KBDC_SET_LEDS		0x00ed
83 #define KBDC_ECHO		0x00ee
84 #define KBDC_SET_SCANCODE_SET	0x00f0
85 #define KBDC_SET_TYPEMATIC	0x00f3
86 
87 /* aux device commands (sent to KBD_DATA_PORT) */
88 #define PSMC_RESET_DEV	     	0x00ff
89 #define PSMC_ENABLE_DEV      	0x00f4
90 #define PSMC_DISABLE_DEV     	0x00f5
91 #define PSMC_SET_DEFAULTS	0x00f6
92 #define PSMC_SEND_DEV_ID     	0x00f2
93 #define PSMC_SEND_DEV_STATUS 	0x00e9
94 #define PSMC_SEND_DEV_DATA	0x00eb
95 #define PSMC_SET_SCALING11	0x00e6
96 #define PSMC_SET_SCALING21	0x00e7
97 #define PSMC_SET_RESOLUTION	0x00e8
98 #define PSMC_SET_STREAM_MODE	0x00ea
99 #define PSMC_SET_REMOTE_MODE	0x00f0
100 #define PSMC_SET_SAMPLING_RATE	0x00f3
101 
102 /* PSMC_SET_RESOLUTION argument */
103 #define PSMD_RES_LOW		0	/* typically 25ppi */
104 #define PSMD_RES_MEDIUM_LOW	1	/* typically 50ppi */
105 #define PSMD_RES_MEDIUM_HIGH	2	/* typically 100ppi (default) */
106 #define PSMD_RES_HIGH		3	/* typically 200ppi */
107 #define PSMD_MAX_RESOLUTION	PSMD_RES_HIGH
108 
109 /* PSMC_SET_SAMPLING_RATE */
110 #define PSMD_MAX_RATE		255	/* FIXME: not sure if it's possible */
111 
112 /* status bits (KBD_STATUS_PORT) */
113 #define KBDS_BUFFER_FULL	0x0021
114 #define KBDS_ANY_BUFFER_FULL	0x0001
115 #define KBDS_KBD_BUFFER_FULL	0x0001
116 #define KBDS_AUX_BUFFER_FULL	0x0021
117 #define KBDS_INPUT_BUFFER_FULL	0x0002
118 
119 /* return code */
120 #define KBD_ACK 		0x00fa
121 #define KBD_RESEND		0x00fe
122 #define KBD_RESET_DONE		0x00aa
123 #define KBD_RESET_FAIL		0x00fc
124 #define KBD_DIAG_DONE		0x0055
125 #define KBD_DIAG_FAIL		0x00fd
126 #define KBD_ECHO		0x00ee
127 
128 #define PSM_ACK 		0x00fa
129 #define PSM_RESEND		0x00fe
130 #define PSM_RESET_DONE		0x00aa
131 #define PSM_RESET_FAIL		0x00fc
132 
133 /* aux device ID */
134 #define PSM_MOUSE_ID		0
135 #define PSM_BALLPOINT_ID	2
136 #define PSM_INTELLI_ID		3
137 #define PSM_EXPLORER_ID		4
138 #define PSM_4DMOUSE_ID		6
139 #define PSM_4DPLUS_ID		8
140 #define PSM_4DPLUS_RFSW35_ID	24
141 
142 #ifdef _KERNEL
143 
144 #include "opt_kbd.h"	/* Structures depend on the value if KBDIO_DEBUG */
145 
146 #define ATKBDC_DRIVER_NAME	"atkbdc"
147 
148 /*
149  * driver specific options: the following options may be set by
150  * `options' statements in the kernel configuration file.
151  */
152 
153 /* retry count */
154 #ifndef KBD_MAXRETRY
155 #define KBD_MAXRETRY	3
156 #endif
157 
158 /* timing parameters */
159 #ifndef KBD_RESETDELAY
160 #define KBD_RESETDELAY  200     /* wait 200msec after kbd/mouse reset */
161 #endif
162 #ifndef KBD_MAXWAIT
163 #define KBD_MAXWAIT	5 	/* wait 5 times at most after reset */
164 #endif
165 
166 /* I/O recovery time */
167 #define KBDC_DELAYTIME	20
168 #define KBDD_DELAYTIME	7
169 
170 /* debug option */
171 #ifndef KBDIO_DEBUG
172 #define KBDIO_DEBUG	0
173 #endif
174 
175 /* end of driver specific options */
176 
177 /* types/structures */
178 
179 #define KBDQ_BUFSIZE	32
180 
181 typedef struct _kqueue {
182     int head;
183     int tail;
184     unsigned char q[KBDQ_BUFSIZE];
185 #if KBDIO_DEBUG >= 2
186     int call_count;
187     int qcount;
188     int max_qcount;
189 #endif
190 } kqueue;
191 
192 struct resource;
193 
194 typedef struct atkbdc_softc {
195     struct resource *port0;	/* data port */
196     struct resource *port1;	/* status port */
197     struct resource *irq;
198     bus_space_tag_t iot;
199     bus_space_handle_t ioh0;
200     bus_space_handle_t ioh1;
201     int command_byte;		/* current command byte value */
202     int command_mask;		/* command byte mask bits for kbd/aux devices */
203     int lock;			/* FIXME: XXX not quite a semaphore... */
204     kqueue kbd;			/* keyboard data queue */
205     kqueue aux;			/* auxiliary data queue */
206     int retry;
207     int quirks;			/* controller doesn't like deactivate */
208 #define KBDC_QUIRK_KEEP_ACTIVATED	(1 << 0)
209 #define KBDC_QUIRK_IGNORE_PROBE_RESULT	(1 << 1)
210 #define KBDC_QUIRK_RESET_AFTER_PROBE	(1 << 2)
211 #define KBDC_QUIRK_SETLEDS_ON_INIT	(1 << 3)
212 #define KBDC_QUIRK_DISABLE_MUX_PROBE	(1 << 4)
213     int aux_mux_enabled;	/* active PS/2 multiplexing is enabled */
214     int aux_mux_port;		/* current aux mux port */
215 } atkbdc_softc_t;
216 
217 enum kbdc_device_ivar {
218 	KBDC_IVAR_VENDORID,
219 	KBDC_IVAR_SERIAL,
220 	KBDC_IVAR_LOGICALID,
221 	KBDC_IVAR_COMPATID,
222 };
223 
224 typedef atkbdc_softc_t *KBDC;
225 
226 #define KBDC_RID_KBD	0
227 #define KBDC_RID_AUX	1
228 
229 #define KBDC_AUX_MUX_NUM_PORTS	4
230 
231 /* function prototypes */
232 
233 atkbdc_softc_t *atkbdc_get_softc(int unit);
234 int atkbdc_probe_unit(int unit, struct resource *port0, struct resource *port1);
235 int atkbdc_attach_unit(int unit, atkbdc_softc_t *sc, struct resource *port0,
236 		       struct resource *port1);
237 int atkbdc_configure(void);
238 
239 KBDC atkbdc_open(int unit);
240 int kbdc_lock(KBDC kbdc, int lock);
241 int kbdc_data_ready(KBDC kbdc);
242 
243 int write_controller_command(KBDC kbdc,int c);
244 int write_controller_data(KBDC kbdc,int c);
245 
246 int write_kbd_command(KBDC kbdc,int c);
247 int write_aux_command(KBDC kbdc,int c);
248 int send_kbd_command(KBDC kbdc,int c);
249 int send_aux_command(KBDC kbdc,int c);
250 int send_kbd_command_and_data(KBDC kbdc,int c,int d);
251 int send_aux_command_and_data(KBDC kbdc,int c,int d);
252 
253 int read_controller_data(KBDC kbdc);
254 int read_kbd_data(KBDC kbdc);
255 int read_kbd_data_no_wait(KBDC kbdc);
256 int read_aux_data(KBDC kbdc);
257 int read_aux_data_no_wait(KBDC kbdc);
258 
259 void empty_kbd_buffer(KBDC kbdc, int t);
260 void empty_aux_buffer(KBDC kbdc, int t);
261 void empty_both_buffers(KBDC kbdc, int t);
262 
263 int reset_kbd(KBDC kbdc);
264 int reset_aux_dev(KBDC kbdc);
265 
266 int test_controller(KBDC kbdc);
267 int test_kbd_port(KBDC kbdc);
268 int test_aux_port(KBDC kbdc);
269 
270 int kbdc_get_device_mask(KBDC kbdc);
271 void kbdc_set_device_mask(KBDC kbdc, int mask);
272 
273 int get_controller_command_byte(KBDC kbdc);
274 int set_controller_command_byte(KBDC kbdc, int command, int flag);
275 
276 int set_active_aux_mux_port(KBDC p, int port);
277 int enable_aux_mux(KBDC p);
278 int disable_aux_mux(KBDC p);
279 int aux_mux_is_enabled(KBDC p);
280 
281 #endif /* _KERNEL */
282 
283 #endif /* !_DEV_ATKBDC_ATKBDCREG_H_ */
284