xref: /freebsd/sys/dev/superio/superio.c (revision c0c234543263c95cb79d46cfb1dfae2d91d335e4)
150f14c4fSAndriy Gapon /*-
250f14c4fSAndriy Gapon  * SPDX-License-Identifier: BSD-2-Clause
350f14c4fSAndriy Gapon  *
450f14c4fSAndriy Gapon  * Copyright (c) 2019 Andriy Gapon
5e3722b78SAndriy Gapon  *
6e3722b78SAndriy Gapon  * Redistribution and use in source and binary forms, with or without
7e3722b78SAndriy Gapon  * modification, are permitted provided that the following conditions
8e3722b78SAndriy Gapon  * are met:
9e3722b78SAndriy Gapon  * 1. Redistributions of source code must retain the above copyright
10e3722b78SAndriy Gapon  *    notice, this list of conditions and the following disclaimer.
11e3722b78SAndriy Gapon  * 2. Redistributions in binary form must reproduce the above copyright
12e3722b78SAndriy Gapon  *    notice, this list of conditions and the following disclaimer in the
13e3722b78SAndriy Gapon  *    documentation and/or other materials provided with the distribution.
14e3722b78SAndriy Gapon  *
1550f14c4fSAndriy Gapon  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16e3722b78SAndriy Gapon  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17e3722b78SAndriy Gapon  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18e3722b78SAndriy Gapon  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19e3722b78SAndriy Gapon  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20e3722b78SAndriy Gapon  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21e3722b78SAndriy Gapon  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22e3722b78SAndriy Gapon  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23e3722b78SAndriy Gapon  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24e3722b78SAndriy Gapon  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25e3722b78SAndriy Gapon  * SUCH DAMAGE.
2650f14c4fSAndriy Gapon  *
2750f14c4fSAndriy Gapon  * $FreeBSD$
28e3722b78SAndriy Gapon  */
29e3722b78SAndriy Gapon 
30e3722b78SAndriy Gapon #include <sys/cdefs.h>
31e3722b78SAndriy Gapon __FBSDID("$FreeBSD$");
32e3722b78SAndriy Gapon 
33e3722b78SAndriy Gapon #include <sys/param.h>
34e3722b78SAndriy Gapon #include <sys/systm.h>
35e3722b78SAndriy Gapon #include <sys/bus.h>
36e3722b78SAndriy Gapon #include <sys/conf.h>
37e3722b78SAndriy Gapon #include <sys/kernel.h>
38e3722b78SAndriy Gapon #include <sys/lock.h>
39e3722b78SAndriy Gapon #include <sys/mutex.h>
40e3722b78SAndriy Gapon #include <sys/malloc.h>
41e3722b78SAndriy Gapon #include <sys/module.h>
42e3722b78SAndriy Gapon #include <sys/proc.h>
43e3722b78SAndriy Gapon #include <sys/rman.h>
44e3722b78SAndriy Gapon #include <sys/time.h>
45e3722b78SAndriy Gapon 
46e3722b78SAndriy Gapon #include <machine/bus.h>
47e3722b78SAndriy Gapon #include <machine/resource.h>
48e3722b78SAndriy Gapon #include <machine/stdarg.h>
49e3722b78SAndriy Gapon 
50e3722b78SAndriy Gapon #include <isa/isavar.h>
51e3722b78SAndriy Gapon 
52e3722b78SAndriy Gapon #include <dev/superio/superio.h>
530aee3bdcSAndriy Gapon #include <dev/superio/superio_io.h>
54e3722b78SAndriy Gapon 
55e3722b78SAndriy Gapon #include "isa_if.h"
56e3722b78SAndriy Gapon 
57e3722b78SAndriy Gapon typedef void (*sio_conf_enter_f)(struct resource*, uint16_t);
58e3722b78SAndriy Gapon typedef void (*sio_conf_exit_f)(struct resource*, uint16_t);
59e3722b78SAndriy Gapon 
60e3722b78SAndriy Gapon struct sio_conf_methods {
61e3722b78SAndriy Gapon 	sio_conf_enter_f	enter;
62e3722b78SAndriy Gapon 	sio_conf_exit_f		exit;
63e3722b78SAndriy Gapon 	superio_vendor_t	vendor;
64e3722b78SAndriy Gapon };
65e3722b78SAndriy Gapon 
66e3722b78SAndriy Gapon struct sio_device {
67e3722b78SAndriy Gapon 	uint8_t			ldn;
68e3722b78SAndriy Gapon 	superio_dev_type_t	type;
69e3722b78SAndriy Gapon };
70e3722b78SAndriy Gapon 
71e3722b78SAndriy Gapon struct superio_devinfo {
72e3722b78SAndriy Gapon 	STAILQ_ENTRY(superio_devinfo) link;
73e3722b78SAndriy Gapon 	struct resource_list	resources;
74e3722b78SAndriy Gapon 	device_t		dev;
75e3722b78SAndriy Gapon 	uint8_t			ldn;
76e3722b78SAndriy Gapon 	superio_dev_type_t	type;
77e3722b78SAndriy Gapon 	uint16_t		iobase;
78e3722b78SAndriy Gapon 	uint16_t		iobase2;
79e3722b78SAndriy Gapon 	uint8_t			irq;
80e3722b78SAndriy Gapon 	uint8_t			dma;
81e3722b78SAndriy Gapon };
82e3722b78SAndriy Gapon 
83e3722b78SAndriy Gapon struct siosc {
84e3722b78SAndriy Gapon 	struct mtx			conf_lock;
85e3722b78SAndriy Gapon 	STAILQ_HEAD(, superio_devinfo)	devlist;
86e3722b78SAndriy Gapon 	struct resource*		io_res;
870aee3bdcSAndriy Gapon 	struct cdev			*chardev;
88e3722b78SAndriy Gapon 	int				io_rid;
89e3722b78SAndriy Gapon 	uint16_t			io_port;
90e3722b78SAndriy Gapon 	const struct sio_conf_methods	*methods;
91e3722b78SAndriy Gapon 	const struct sio_device		*known_devices;
92e3722b78SAndriy Gapon 	superio_vendor_t		vendor;
93e3722b78SAndriy Gapon 	uint16_t			devid;
94e3722b78SAndriy Gapon 	uint8_t				revid;
95e3722b78SAndriy Gapon 	uint8_t				current_ldn;
96e3722b78SAndriy Gapon 	uint8_t				ldn_reg;
97e3722b78SAndriy Gapon 	uint8_t				enable_reg;
98e3722b78SAndriy Gapon };
99e3722b78SAndriy Gapon 
1000aee3bdcSAndriy Gapon static	d_ioctl_t	superio_ioctl;
1010aee3bdcSAndriy Gapon 
1020aee3bdcSAndriy Gapon static struct cdevsw superio_cdevsw = {
1030aee3bdcSAndriy Gapon 	.d_version =	D_VERSION,
1040aee3bdcSAndriy Gapon 	.d_ioctl =	superio_ioctl,
1050aee3bdcSAndriy Gapon 	.d_name =	"superio",
1060aee3bdcSAndriy Gapon };
1070aee3bdcSAndriy Gapon 
108e3722b78SAndriy Gapon #define NUMPORTS	2
109e3722b78SAndriy Gapon 
110e3722b78SAndriy Gapon static uint8_t
111e3722b78SAndriy Gapon sio_read(struct resource* res, uint8_t reg)
112e3722b78SAndriy Gapon {
113e3722b78SAndriy Gapon 	bus_write_1(res, 0, reg);
114e3722b78SAndriy Gapon 	return (bus_read_1(res, 1));
115e3722b78SAndriy Gapon }
116e3722b78SAndriy Gapon 
117e3722b78SAndriy Gapon /* Read a word from two one-byte registers, big endian. */
118e3722b78SAndriy Gapon static uint16_t
119e3722b78SAndriy Gapon sio_readw(struct resource* res, uint8_t reg)
120e3722b78SAndriy Gapon {
121e3722b78SAndriy Gapon 	uint16_t v;
122e3722b78SAndriy Gapon 
123e3722b78SAndriy Gapon 	v = sio_read(res, reg);
124e3722b78SAndriy Gapon 	v <<= 8;
125e3722b78SAndriy Gapon 	v |= sio_read(res, reg + 1);
126e3722b78SAndriy Gapon 	return (v);
127e3722b78SAndriy Gapon }
128e3722b78SAndriy Gapon 
129e3722b78SAndriy Gapon static void
130e3722b78SAndriy Gapon sio_write(struct resource* res, uint8_t reg, uint8_t val)
131e3722b78SAndriy Gapon {
132e3722b78SAndriy Gapon 	bus_write_1(res, 0, reg);
133e3722b78SAndriy Gapon 	bus_write_1(res, 1, val);
134e3722b78SAndriy Gapon }
135e3722b78SAndriy Gapon 
136e3722b78SAndriy Gapon static void
137e3722b78SAndriy Gapon sio_ldn_select(struct siosc *sc, uint8_t ldn)
138e3722b78SAndriy Gapon {
139e3722b78SAndriy Gapon 	mtx_assert(&sc->conf_lock, MA_OWNED);
140e3722b78SAndriy Gapon 	if (ldn == sc->current_ldn)
141e3722b78SAndriy Gapon 		return;
142e3722b78SAndriy Gapon 	sio_write(sc->io_res, sc->ldn_reg, ldn);
143e3722b78SAndriy Gapon 	sc->current_ldn = ldn;
144e3722b78SAndriy Gapon }
145e3722b78SAndriy Gapon 
146e3722b78SAndriy Gapon static uint8_t
147e3722b78SAndriy Gapon sio_ldn_read(struct siosc *sc, uint8_t ldn, uint8_t reg)
148e3722b78SAndriy Gapon {
149e3722b78SAndriy Gapon 	mtx_assert(&sc->conf_lock, MA_OWNED);
150e3722b78SAndriy Gapon 	if (reg >= sc->enable_reg) {
151e3722b78SAndriy Gapon 		sio_ldn_select(sc, ldn);
152e3722b78SAndriy Gapon 		KASSERT(sc->current_ldn == ldn, ("sio_ldn_select failed"));
153e3722b78SAndriy Gapon 	}
154e3722b78SAndriy Gapon 	return (sio_read(sc->io_res, reg));
155e3722b78SAndriy Gapon }
156e3722b78SAndriy Gapon 
157e3722b78SAndriy Gapon static uint16_t
158e3722b78SAndriy Gapon sio_ldn_readw(struct siosc *sc, uint8_t ldn, uint8_t reg)
159e3722b78SAndriy Gapon {
160e3722b78SAndriy Gapon 	mtx_assert(&sc->conf_lock, MA_OWNED);
161e3722b78SAndriy Gapon 	if (reg >= sc->enable_reg) {
162e3722b78SAndriy Gapon 		sio_ldn_select(sc, ldn);
163e3722b78SAndriy Gapon 		KASSERT(sc->current_ldn == ldn, ("sio_ldn_select failed"));
164e3722b78SAndriy Gapon 	}
165e3722b78SAndriy Gapon 	return (sio_readw(sc->io_res, reg));
166e3722b78SAndriy Gapon }
167e3722b78SAndriy Gapon 
168e3722b78SAndriy Gapon static void
169e3722b78SAndriy Gapon sio_ldn_write(struct siosc *sc, uint8_t ldn, uint8_t reg, uint8_t val)
170e3722b78SAndriy Gapon {
171e3722b78SAndriy Gapon 	mtx_assert(&sc->conf_lock, MA_OWNED);
172e3722b78SAndriy Gapon 	if (reg <= sc->ldn_reg) {
173e3722b78SAndriy Gapon 		printf("ignored attempt to write special register 0x%x\n", reg);
174e3722b78SAndriy Gapon 		return;
175e3722b78SAndriy Gapon 	}
176e3722b78SAndriy Gapon 	sio_ldn_select(sc, ldn);
177e3722b78SAndriy Gapon 	KASSERT(sc->current_ldn == ldn, ("sio_ldn_select failed"));
178e3722b78SAndriy Gapon 	sio_write(sc->io_res, reg, val);
179e3722b78SAndriy Gapon }
180e3722b78SAndriy Gapon 
181e3722b78SAndriy Gapon static void
182e3722b78SAndriy Gapon sio_conf_enter(struct siosc *sc)
183e3722b78SAndriy Gapon {
184e3722b78SAndriy Gapon 	mtx_lock(&sc->conf_lock);
185e3722b78SAndriy Gapon 	sc->methods->enter(sc->io_res, sc->io_port);
186e3722b78SAndriy Gapon }
187e3722b78SAndriy Gapon 
188e3722b78SAndriy Gapon static void
189e3722b78SAndriy Gapon sio_conf_exit(struct siosc *sc)
190e3722b78SAndriy Gapon {
191e3722b78SAndriy Gapon 	sc->methods->exit(sc->io_res, sc->io_port);
192e84d4316SAndriy Gapon 	sc->current_ldn = 0xff;
193e3722b78SAndriy Gapon 	mtx_unlock(&sc->conf_lock);
194e3722b78SAndriy Gapon }
195e3722b78SAndriy Gapon 
196e3722b78SAndriy Gapon static void
197e3722b78SAndriy Gapon ite_conf_enter(struct resource* res, uint16_t port)
198e3722b78SAndriy Gapon {
199e3722b78SAndriy Gapon 	bus_write_1(res, 0, 0x87);
200e3722b78SAndriy Gapon 	bus_write_1(res, 0, 0x01);
201e3722b78SAndriy Gapon 	bus_write_1(res, 0, 0x55);
202e3722b78SAndriy Gapon 	bus_write_1(res, 0, port == 0x2e ? 0x55 : 0xaa);
203e3722b78SAndriy Gapon }
204e3722b78SAndriy Gapon 
205e3722b78SAndriy Gapon static void
206e3722b78SAndriy Gapon ite_conf_exit(struct resource* res, uint16_t port)
207e3722b78SAndriy Gapon {
208e3722b78SAndriy Gapon 	sio_write(res, 0x02, 0x02);
209e3722b78SAndriy Gapon }
210e3722b78SAndriy Gapon 
211e3722b78SAndriy Gapon static const struct sio_conf_methods ite_conf_methods = {
212e3722b78SAndriy Gapon 	.enter = ite_conf_enter,
213e3722b78SAndriy Gapon 	.exit = ite_conf_exit,
214e3722b78SAndriy Gapon 	.vendor = SUPERIO_VENDOR_ITE
215e3722b78SAndriy Gapon };
216e3722b78SAndriy Gapon 
217e3722b78SAndriy Gapon static void
218e3722b78SAndriy Gapon nvt_conf_enter(struct resource* res, uint16_t port)
219e3722b78SAndriy Gapon {
220e3722b78SAndriy Gapon 	bus_write_1(res, 0, 0x87);
221e3722b78SAndriy Gapon 	bus_write_1(res, 0, 0x87);
222e3722b78SAndriy Gapon }
223e3722b78SAndriy Gapon 
224e3722b78SAndriy Gapon static void
225e3722b78SAndriy Gapon nvt_conf_exit(struct resource* res, uint16_t port)
226e3722b78SAndriy Gapon {
227e3722b78SAndriy Gapon 	bus_write_1(res, 0, 0xaa);
228e3722b78SAndriy Gapon }
229e3722b78SAndriy Gapon 
230e3722b78SAndriy Gapon static const struct sio_conf_methods nvt_conf_methods = {
231e3722b78SAndriy Gapon 	.enter = nvt_conf_enter,
232e3722b78SAndriy Gapon 	.exit = nvt_conf_exit,
233e3722b78SAndriy Gapon 	.vendor = SUPERIO_VENDOR_NUVOTON
234e3722b78SAndriy Gapon };
235e3722b78SAndriy Gapon 
236*c0c23454SPoul-Henning Kamp static void
237*c0c23454SPoul-Henning Kamp fintek_conf_enter(struct resource* res, uint16_t port)
238*c0c23454SPoul-Henning Kamp {
239*c0c23454SPoul-Henning Kamp 	bus_write_1(res, 0, 0x87);
240*c0c23454SPoul-Henning Kamp 	bus_write_1(res, 0, 0x87);
241*c0c23454SPoul-Henning Kamp }
242*c0c23454SPoul-Henning Kamp 
243*c0c23454SPoul-Henning Kamp static void
244*c0c23454SPoul-Henning Kamp fintek_conf_exit(struct resource* res, uint16_t port)
245*c0c23454SPoul-Henning Kamp {
246*c0c23454SPoul-Henning Kamp 	bus_write_1(res, 0, 0xaa);
247*c0c23454SPoul-Henning Kamp }
248*c0c23454SPoul-Henning Kamp 
249*c0c23454SPoul-Henning Kamp static const struct sio_conf_methods fintek_conf_methods = {
250*c0c23454SPoul-Henning Kamp 	.enter = fintek_conf_enter,
251*c0c23454SPoul-Henning Kamp 	.exit = fintek_conf_exit,
252*c0c23454SPoul-Henning Kamp 	.vendor = SUPERIO_VENDOR_FINTEK
253*c0c23454SPoul-Henning Kamp };
254*c0c23454SPoul-Henning Kamp 
255e3722b78SAndriy Gapon static const struct sio_conf_methods * const methods_table[] = {
256e3722b78SAndriy Gapon 	&ite_conf_methods,
257e3722b78SAndriy Gapon 	&nvt_conf_methods,
258*c0c23454SPoul-Henning Kamp 	&fintek_conf_methods,
259e3722b78SAndriy Gapon 	NULL
260e3722b78SAndriy Gapon };
261e3722b78SAndriy Gapon 
262e3722b78SAndriy Gapon static const uint16_t ports_table[] = {
263e3722b78SAndriy Gapon 	0x2e, 0x4e, 0
264e3722b78SAndriy Gapon };
265e3722b78SAndriy Gapon 
266e3722b78SAndriy Gapon const struct sio_device ite_devices[] = {
267e3722b78SAndriy Gapon 	{ .ldn = 4, .type = SUPERIO_DEV_HWM },
268e3722b78SAndriy Gapon 	{ .ldn = 7, .type = SUPERIO_DEV_WDT },
269e3722b78SAndriy Gapon 	{ .type = SUPERIO_DEV_NONE },
270e3722b78SAndriy Gapon };
271e3722b78SAndriy Gapon 
272e3722b78SAndriy Gapon const struct sio_device nvt_devices[] = {
273e3722b78SAndriy Gapon 	{ .ldn = 8, .type = SUPERIO_DEV_WDT },
274e3722b78SAndriy Gapon 	{ .type = SUPERIO_DEV_NONE },
275e3722b78SAndriy Gapon };
276e3722b78SAndriy Gapon 
277e3722b78SAndriy Gapon const struct sio_device nct5104_devices[] = {
278e3722b78SAndriy Gapon 	{ .ldn = 7, .type = SUPERIO_DEV_GPIO },
279e3722b78SAndriy Gapon 	{ .ldn = 8, .type = SUPERIO_DEV_WDT },
280e3722b78SAndriy Gapon 	{ .ldn = 15, .type = SUPERIO_DEV_GPIO },
281e3722b78SAndriy Gapon 	{ .type = SUPERIO_DEV_NONE },
282e3722b78SAndriy Gapon };
283e3722b78SAndriy Gapon 
284*c0c23454SPoul-Henning Kamp const struct sio_device fintek_devices[] = {
285*c0c23454SPoul-Henning Kamp 	{ .ldn = 7, .type = SUPERIO_DEV_WDT },
286*c0c23454SPoul-Henning Kamp 	{ .type = SUPERIO_DEV_NONE },
287*c0c23454SPoul-Henning Kamp };
288*c0c23454SPoul-Henning Kamp 
289e3722b78SAndriy Gapon static const struct {
290e3722b78SAndriy Gapon 	superio_vendor_t	vendor;
291e3722b78SAndriy Gapon 	uint16_t		devid;
292e3722b78SAndriy Gapon 	uint16_t		mask;
293e3722b78SAndriy Gapon 	const char		*descr;
294e3722b78SAndriy Gapon 	const struct sio_device	*devices;
295e3722b78SAndriy Gapon } superio_table[] = {
296e3722b78SAndriy Gapon 	{
297e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_ITE, .devid = 0x8712,
298e3722b78SAndriy Gapon 		.devices = ite_devices,
299e3722b78SAndriy Gapon 	},
300e3722b78SAndriy Gapon 	{
301e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_ITE, .devid = 0x8716,
302e3722b78SAndriy Gapon 		.devices = ite_devices,
303e3722b78SAndriy Gapon 	},
304e3722b78SAndriy Gapon 	{
305e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_ITE, .devid = 0x8718,
306e3722b78SAndriy Gapon 		.devices = ite_devices,
307e3722b78SAndriy Gapon 	},
308e3722b78SAndriy Gapon 	{
309e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_ITE, .devid = 0x8720,
310e3722b78SAndriy Gapon 		.devices = ite_devices,
311e3722b78SAndriy Gapon 	},
312e3722b78SAndriy Gapon 	{
313e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_ITE, .devid = 0x8721,
314e3722b78SAndriy Gapon 		.devices = ite_devices,
315e3722b78SAndriy Gapon 	},
316e3722b78SAndriy Gapon 	{
317e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_ITE, .devid = 0x8726,
318e3722b78SAndriy Gapon 		.devices = ite_devices,
319e3722b78SAndriy Gapon 	},
320e3722b78SAndriy Gapon 	{
321e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_ITE, .devid = 0x8728,
322e3722b78SAndriy Gapon 		.devices = ite_devices,
323e3722b78SAndriy Gapon 	},
324e3722b78SAndriy Gapon 	{
325e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_ITE, .devid = 0x8771,
326e3722b78SAndriy Gapon 		.devices = ite_devices,
327e3722b78SAndriy Gapon 	},
328e3722b78SAndriy Gapon 	{
329e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0x1061, .mask = 0x00,
330e3722b78SAndriy Gapon 		.descr	= "Nuvoton NCT5104D/NCT6102D/NCT6106D (rev. A)",
331e3722b78SAndriy Gapon 		.devices = nct5104_devices,
332e3722b78SAndriy Gapon 	},
333e3722b78SAndriy Gapon 	{
334e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0x5200, .mask = 0xff,
335e3722b78SAndriy Gapon 		.descr = "Winbond 83627HF/F/HG/G",
336e3722b78SAndriy Gapon 		.devices = nvt_devices,
337e3722b78SAndriy Gapon 	},
338e3722b78SAndriy Gapon 	{
339e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0x5900, .mask = 0xff,
340e3722b78SAndriy Gapon 		.descr = "Winbond 83627S",
341e3722b78SAndriy Gapon 		.devices = nvt_devices,
342e3722b78SAndriy Gapon 	},
343e3722b78SAndriy Gapon 	{
344e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0x6000, .mask = 0xff,
345e3722b78SAndriy Gapon 		.descr = "Winbond 83697HF",
346e3722b78SAndriy Gapon 		.devices = nvt_devices,
347e3722b78SAndriy Gapon 	},
348e3722b78SAndriy Gapon 	{
349e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0x6800, .mask = 0xff,
350e3722b78SAndriy Gapon 		.descr = "Winbond 83697UG",
351e3722b78SAndriy Gapon 		.devices = nvt_devices,
352e3722b78SAndriy Gapon 	},
353e3722b78SAndriy Gapon 	{
354e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0x7000, .mask = 0xff,
355e3722b78SAndriy Gapon 		.descr = "Winbond 83637HF",
356e3722b78SAndriy Gapon 		.devices = nvt_devices,
357e3722b78SAndriy Gapon 	},
358e3722b78SAndriy Gapon 	{
359e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0x8200, .mask = 0xff,
360e3722b78SAndriy Gapon 		.descr = "Winbond 83627THF",
361e3722b78SAndriy Gapon 		.devices = nvt_devices,
362e3722b78SAndriy Gapon 	},
363e3722b78SAndriy Gapon 	{
364e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0x8500, .mask = 0xff,
365e3722b78SAndriy Gapon 		.descr = "Winbond 83687THF",
366e3722b78SAndriy Gapon 		.devices = nvt_devices,
367e3722b78SAndriy Gapon 	},
368e3722b78SAndriy Gapon 	{
369e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0x8800, .mask = 0xff,
370e3722b78SAndriy Gapon 		.descr = "Winbond 83627EHF",
371e3722b78SAndriy Gapon 		.devices = nvt_devices,
372e3722b78SAndriy Gapon 	},
373e3722b78SAndriy Gapon 	{
374e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xa000, .mask = 0xff,
375e3722b78SAndriy Gapon 		.descr = "Winbond 83627DHG",
376e3722b78SAndriy Gapon 		.devices = nvt_devices,
377e3722b78SAndriy Gapon 	},
378e3722b78SAndriy Gapon 	{
379e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xa200, .mask = 0xff,
380e3722b78SAndriy Gapon 		.descr = "Winbond 83627UHG",
381e3722b78SAndriy Gapon 		.devices = nvt_devices,
382e3722b78SAndriy Gapon 	},
383e3722b78SAndriy Gapon 	{
384e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xa500, .mask = 0xff,
385e3722b78SAndriy Gapon 		.descr = "Winbond 83667HG",
386e3722b78SAndriy Gapon 		.devices = nvt_devices,
387e3722b78SAndriy Gapon 	},
388e3722b78SAndriy Gapon 	{
389e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xb000, .mask = 0xff,
390e3722b78SAndriy Gapon 		.descr = "Winbond 83627DHG-P",
391e3722b78SAndriy Gapon 		.devices = nvt_devices,
392e3722b78SAndriy Gapon 	},
393e3722b78SAndriy Gapon 	{
394e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xb300, .mask = 0xff,
395e3722b78SAndriy Gapon 		.descr = "Winbond 83667HG-B",
396e3722b78SAndriy Gapon 		.devices = nvt_devices,
397e3722b78SAndriy Gapon 	},
398e3722b78SAndriy Gapon 	{
399e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xb400, .mask = 0xff,
400e3722b78SAndriy Gapon 		.descr = "Nuvoton NCT6775",
401e3722b78SAndriy Gapon 		.devices = nvt_devices,
402e3722b78SAndriy Gapon 	},
403e3722b78SAndriy Gapon 	{
404e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xc300, .mask = 0xff,
405e3722b78SAndriy Gapon 		.descr = "Nuvoton NCT6776",
406e3722b78SAndriy Gapon 		.devices = nvt_devices,
407e3722b78SAndriy Gapon 	},
408e3722b78SAndriy Gapon 	{
409e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xc400, .mask = 0xff,
410e3722b78SAndriy Gapon 		.descr = "Nuvoton NCT5104D/NCT6102D/NCT6106D (rev. B+)",
411e3722b78SAndriy Gapon 		.devices = nct5104_devices,
412e3722b78SAndriy Gapon 	},
413e3722b78SAndriy Gapon 	{
414e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xc500, .mask = 0xff,
415e3722b78SAndriy Gapon 		.descr = "Nuvoton NCT6779",
416e3722b78SAndriy Gapon 		.devices = nvt_devices,
417e3722b78SAndriy Gapon 	},
418e3722b78SAndriy Gapon 	{
419e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xc800, .mask = 0xff,
420e3722b78SAndriy Gapon 		.descr = "Nuvoton NCT6791",
421e3722b78SAndriy Gapon 		.devices = nvt_devices,
422e3722b78SAndriy Gapon 	},
423e3722b78SAndriy Gapon 	{
424e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xc900, .mask = 0xff,
425e3722b78SAndriy Gapon 		.descr = "Nuvoton NCT6792",
426e3722b78SAndriy Gapon 		.devices = nvt_devices,
427e3722b78SAndriy Gapon 	},
428e3722b78SAndriy Gapon 	{
429e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xd100, .mask = 0xff,
430e3722b78SAndriy Gapon 		.descr = "Nuvoton NCT6793",
431e3722b78SAndriy Gapon 		.devices = nvt_devices,
432e3722b78SAndriy Gapon 	},
433e3722b78SAndriy Gapon 	{
434e3722b78SAndriy Gapon 		.vendor = SUPERIO_VENDOR_NUVOTON, .devid = 0xd300, .mask = 0xff,
435e3722b78SAndriy Gapon 		.descr = "Nuvoton NCT6795",
436e3722b78SAndriy Gapon 		.devices = nvt_devices,
437e3722b78SAndriy Gapon 	},
438*c0c23454SPoul-Henning Kamp 	{
439*c0c23454SPoul-Henning Kamp 		.vendor = SUPERIO_VENDOR_FINTEK, .devid = 0x1210, .mask = 0xff,
440*c0c23454SPoul-Henning Kamp 		.descr = "Fintek F81803",
441*c0c23454SPoul-Henning Kamp 		.devices = fintek_devices,
442*c0c23454SPoul-Henning Kamp 	},
443e3722b78SAndriy Gapon 	{ 0, 0 }
444e3722b78SAndriy Gapon };
445e3722b78SAndriy Gapon 
446e3722b78SAndriy Gapon static const char *
447e3722b78SAndriy Gapon devtype_to_str(superio_dev_type_t type)
448e3722b78SAndriy Gapon {
449e3722b78SAndriy Gapon 	switch (type) {
450e3722b78SAndriy Gapon 	case SUPERIO_DEV_NONE:
4516529459aSLi-Wen Hsu 		return ("none");
452e3722b78SAndriy Gapon 	case SUPERIO_DEV_HWM:
453e3722b78SAndriy Gapon 		return ("HWM");
454e3722b78SAndriy Gapon 	case SUPERIO_DEV_WDT:
455e3722b78SAndriy Gapon 		return ("WDT");
456e3722b78SAndriy Gapon 	case SUPERIO_DEV_GPIO:
457e3722b78SAndriy Gapon 		return ("GPIO");
458e3722b78SAndriy Gapon 	case SUPERIO_DEV_MAX:
459e3722b78SAndriy Gapon 		return ("invalid");
460e3722b78SAndriy Gapon 	}
4616529459aSLi-Wen Hsu 	return ("invalid");
462e3722b78SAndriy Gapon }
463e3722b78SAndriy Gapon 
464e3722b78SAndriy Gapon static int
465e3722b78SAndriy Gapon superio_detect(device_t dev, bool claim, struct siosc *sc)
466e3722b78SAndriy Gapon {
467e3722b78SAndriy Gapon 	struct resource *res;
468e3722b78SAndriy Gapon 	rman_res_t port;
469e3722b78SAndriy Gapon 	rman_res_t count;
470e3722b78SAndriy Gapon 	uint16_t devid;
471e3722b78SAndriy Gapon 	uint8_t revid;
472e3722b78SAndriy Gapon 	int error;
473e3722b78SAndriy Gapon 	int rid;
474e3722b78SAndriy Gapon 	int i, m;
475e3722b78SAndriy Gapon 
476e3722b78SAndriy Gapon 	error = bus_get_resource(dev, SYS_RES_IOPORT, 0, &port, &count);
477e3722b78SAndriy Gapon 	if (error != 0)
478e3722b78SAndriy Gapon 		return (error);
479e3722b78SAndriy Gapon 	if (port > UINT16_MAX || count < NUMPORTS) {
480e3722b78SAndriy Gapon 		device_printf(dev, "unexpected I/O range size\n");
481e3722b78SAndriy Gapon 		return (ENXIO);
482e3722b78SAndriy Gapon 	}
483e3722b78SAndriy Gapon 
484e3722b78SAndriy Gapon 	/*
485e3722b78SAndriy Gapon 	 * Make a temporary resource reservation for hardware probing.
486e3722b78SAndriy Gapon 	 * If we can't get the resources we need then
487e3722b78SAndriy Gapon 	 * we need to abort.  Possibly this indicates
488e3722b78SAndriy Gapon 	 * the resources were used by another device
489e3722b78SAndriy Gapon 	 * in which case the probe would have failed anyhow.
490e3722b78SAndriy Gapon 	 */
491e3722b78SAndriy Gapon 	rid = 0;
492e3722b78SAndriy Gapon 	res = bus_alloc_resource_any(dev, SYS_RES_IOPORT, &rid, RF_ACTIVE);
493e3722b78SAndriy Gapon 	if (res == NULL) {
494e3722b78SAndriy Gapon 		if (claim)
495e3722b78SAndriy Gapon 			device_printf(dev, "failed to allocate I/O resource\n");
496e3722b78SAndriy Gapon 		return (ENXIO);
497e3722b78SAndriy Gapon 	}
498e3722b78SAndriy Gapon 
499e3722b78SAndriy Gapon 	for (m = 0; methods_table[m] != NULL; m++) {
500e3722b78SAndriy Gapon 		methods_table[m]->enter(res, port);
501e3722b78SAndriy Gapon 		if (methods_table[m]->vendor == SUPERIO_VENDOR_ITE) {
502e3722b78SAndriy Gapon 			devid = sio_readw(res, 0x20);
503e3722b78SAndriy Gapon 			revid = sio_read(res, 0x22);
504e3722b78SAndriy Gapon 		} else if (methods_table[m]->vendor == SUPERIO_VENDOR_NUVOTON) {
505e3722b78SAndriy Gapon 			devid = sio_read(res, 0x20);
506e3722b78SAndriy Gapon 			revid = sio_read(res, 0x21);
507e3722b78SAndriy Gapon 			devid = (devid << 8) | revid;
508*c0c23454SPoul-Henning Kamp 		} else if (methods_table[m]->vendor == SUPERIO_VENDOR_FINTEK) {
509*c0c23454SPoul-Henning Kamp 			devid = sio_read(res, 0x20);
510*c0c23454SPoul-Henning Kamp 			revid = sio_read(res, 0x21);
511*c0c23454SPoul-Henning Kamp 			devid = (devid << 8) | revid;
512e3722b78SAndriy Gapon 		} else {
513e3722b78SAndriy Gapon 			continue;
514e3722b78SAndriy Gapon 		}
515e3722b78SAndriy Gapon 		methods_table[m]->exit(res, port);
516e3722b78SAndriy Gapon 		for (i = 0; superio_table[i].vendor != 0; i++) {
517e3722b78SAndriy Gapon 			uint16_t mask;
518e3722b78SAndriy Gapon 
519e3722b78SAndriy Gapon 			mask = superio_table[i].mask;
520e3722b78SAndriy Gapon 			if (superio_table[i].vendor !=
521e3722b78SAndriy Gapon 			    methods_table[m]->vendor)
522e3722b78SAndriy Gapon 				continue;
523e3722b78SAndriy Gapon 			if ((superio_table[i].devid & ~mask) != (devid & ~mask))
524e3722b78SAndriy Gapon 				continue;
525e3722b78SAndriy Gapon 			break;
526e3722b78SAndriy Gapon 		}
527e3722b78SAndriy Gapon 
528e3722b78SAndriy Gapon 		/* Found a matching SuperIO entry. */
529e3722b78SAndriy Gapon 		if (superio_table[i].vendor != 0)
530e3722b78SAndriy Gapon 			break;
531e3722b78SAndriy Gapon 	}
532e3722b78SAndriy Gapon 
533e3722b78SAndriy Gapon 	if (methods_table[m] == NULL)
534e3722b78SAndriy Gapon 		error = ENXIO;
535e3722b78SAndriy Gapon 	else
536e3722b78SAndriy Gapon 		error = 0;
537e3722b78SAndriy Gapon 	if (!claim || error != 0) {
538e3722b78SAndriy Gapon 		bus_release_resource(dev, SYS_RES_IOPORT, rid, res);
539e3722b78SAndriy Gapon 		return (error);
540e3722b78SAndriy Gapon 	}
541e3722b78SAndriy Gapon 
542e3722b78SAndriy Gapon 	sc->methods = methods_table[m];
543e3722b78SAndriy Gapon 	sc->vendor = sc->methods->vendor;
544e3722b78SAndriy Gapon 	sc->known_devices = superio_table[i].devices;
545e3722b78SAndriy Gapon 	sc->io_res = res;
546e3722b78SAndriy Gapon 	sc->io_rid = rid;
547e3722b78SAndriy Gapon 	sc->io_port = port;
548e3722b78SAndriy Gapon 	sc->devid = devid;
549e3722b78SAndriy Gapon 	sc->revid = revid;
550e3722b78SAndriy Gapon 
551e3722b78SAndriy Gapon 	KASSERT(sc->vendor == SUPERIO_VENDOR_ITE ||
552e3722b78SAndriy Gapon 	    sc->vendor == SUPERIO_VENDOR_NUVOTON,
553e3722b78SAndriy Gapon 	    ("Only ITE and Nuvoton SuperIO-s are supported"));
554e3722b78SAndriy Gapon 	sc->ldn_reg = 0x07;
555e3722b78SAndriy Gapon 	sc->enable_reg = 0x30;
556e3722b78SAndriy Gapon 	sc->current_ldn = 0xff;	/* no device should have this */
557e3722b78SAndriy Gapon 
558e3722b78SAndriy Gapon 	if (superio_table[i].descr != NULL) {
559e3722b78SAndriy Gapon 		device_set_desc(dev, superio_table[i].descr);
560e3722b78SAndriy Gapon 	} else if (sc->vendor == SUPERIO_VENDOR_ITE) {
561e3722b78SAndriy Gapon 		char descr[64];
562e3722b78SAndriy Gapon 
563e3722b78SAndriy Gapon 		snprintf(descr, sizeof(descr),
564e3722b78SAndriy Gapon 		    "ITE IT%4x SuperIO (revision 0x%02x)",
565e3722b78SAndriy Gapon 		    sc->devid, sc->revid);
566e3722b78SAndriy Gapon 		device_set_desc_copy(dev, descr);
567e3722b78SAndriy Gapon 	}
568e3722b78SAndriy Gapon 	return (0);
569e3722b78SAndriy Gapon }
570e3722b78SAndriy Gapon 
571e3722b78SAndriy Gapon static void
572e3722b78SAndriy Gapon superio_identify(driver_t *driver, device_t parent)
573e3722b78SAndriy Gapon {
574e3722b78SAndriy Gapon 	device_t	child;
575e3722b78SAndriy Gapon 	int i;
576e3722b78SAndriy Gapon 
577e3722b78SAndriy Gapon 	/*
578e3722b78SAndriy Gapon 	 * Don't create child devices if any already exist.
579e3722b78SAndriy Gapon 	 * Those could be created via isa hints or if this
580e3722b78SAndriy Gapon 	 * driver is loaded, unloaded and then loaded again.
581e3722b78SAndriy Gapon 	 */
582e3722b78SAndriy Gapon 	if (device_find_child(parent, "superio", -1)) {
583e3722b78SAndriy Gapon 		if (bootverbose)
584e3722b78SAndriy Gapon 			printf("superio: device(s) already created\n");
585e3722b78SAndriy Gapon 		return;
586e3722b78SAndriy Gapon 	}
587e3722b78SAndriy Gapon 
588e3722b78SAndriy Gapon 	/*
589e3722b78SAndriy Gapon 	 * Create a child for each candidate port.
590e3722b78SAndriy Gapon 	 * It would be nice if we could somehow clean up those
591e3722b78SAndriy Gapon 	 * that this driver fails to probe.
592e3722b78SAndriy Gapon 	 */
593e3722b78SAndriy Gapon 	for (i = 0; ports_table[i] != 0; i++) {
594e3722b78SAndriy Gapon 		child = BUS_ADD_CHILD(parent, ISA_ORDER_SPECULATIVE,
595e3722b78SAndriy Gapon 		    "superio", -1);
596e3722b78SAndriy Gapon 		if (child == NULL) {
597e3722b78SAndriy Gapon 			device_printf(parent, "failed to add superio child\n");
598e3722b78SAndriy Gapon 			continue;
599e3722b78SAndriy Gapon 		}
600e3722b78SAndriy Gapon 		bus_set_resource(child, SYS_RES_IOPORT,	0, ports_table[i], 2);
601e3722b78SAndriy Gapon 		if (superio_detect(child, false, NULL) != 0)
602e3722b78SAndriy Gapon 			device_delete_child(parent, child);
603e3722b78SAndriy Gapon 	}
604e3722b78SAndriy Gapon }
605e3722b78SAndriy Gapon 
606e3722b78SAndriy Gapon static int
607e3722b78SAndriy Gapon superio_probe(device_t dev)
608e3722b78SAndriy Gapon {
609e3722b78SAndriy Gapon 	struct siosc *sc;
610e3722b78SAndriy Gapon 	int error;
611e3722b78SAndriy Gapon 
612e3722b78SAndriy Gapon 	/* Make sure we do not claim some ISA PNP device. */
613e3722b78SAndriy Gapon 	if (isa_get_logicalid(dev) != 0)
614e3722b78SAndriy Gapon 		return (ENXIO);
615e3722b78SAndriy Gapon 
616e3722b78SAndriy Gapon 	/*
617e3722b78SAndriy Gapon 	 * XXX We can populate the softc now only because we return
618e3722b78SAndriy Gapon 	 * BUS_PROBE_SPECIFIC
619e3722b78SAndriy Gapon 	 */
620e3722b78SAndriy Gapon 	sc = device_get_softc(dev);
621e3722b78SAndriy Gapon 	error = superio_detect(dev, true, sc);
622e3722b78SAndriy Gapon 	if (error != 0)
623e3722b78SAndriy Gapon 		return (error);
624e3722b78SAndriy Gapon 	return (BUS_PROBE_SPECIFIC);
625e3722b78SAndriy Gapon }
626e3722b78SAndriy Gapon 
627e3722b78SAndriy Gapon static void
628e3722b78SAndriy Gapon superio_add_known_child(device_t dev, superio_dev_type_t type, uint8_t ldn)
629e3722b78SAndriy Gapon {
630e3722b78SAndriy Gapon 	struct siosc *sc = device_get_softc(dev);
631e3722b78SAndriy Gapon 	struct superio_devinfo *dinfo;
632e3722b78SAndriy Gapon 	device_t child;
633e3722b78SAndriy Gapon 
634e3722b78SAndriy Gapon 	child = BUS_ADD_CHILD(dev, 0, NULL, -1);
635e3722b78SAndriy Gapon 	if (child == NULL) {
636e3722b78SAndriy Gapon 		device_printf(dev, "failed to add child for ldn %d, type %s\n",
637e3722b78SAndriy Gapon 		    ldn, devtype_to_str(type));
638e3722b78SAndriy Gapon 		return;
639e3722b78SAndriy Gapon 	}
640e3722b78SAndriy Gapon 	dinfo = device_get_ivars(child);
641e3722b78SAndriy Gapon 	dinfo->ldn = ldn;
642e3722b78SAndriy Gapon 	dinfo->type = type;
643e3722b78SAndriy Gapon 	sio_conf_enter(sc);
644e3722b78SAndriy Gapon 	dinfo->iobase = sio_ldn_readw(sc, ldn, 0x60);
645e3722b78SAndriy Gapon 	dinfo->iobase2 = sio_ldn_readw(sc, ldn, 0x62);
646e3722b78SAndriy Gapon 	dinfo->irq = sio_ldn_readw(sc, ldn, 0x70);
647e3722b78SAndriy Gapon 	dinfo->dma = sio_ldn_readw(sc, ldn, 0x74);
648e3722b78SAndriy Gapon 	sio_conf_exit(sc);
649e3722b78SAndriy Gapon 	STAILQ_INSERT_TAIL(&sc->devlist, dinfo, link);
650e3722b78SAndriy Gapon }
651e3722b78SAndriy Gapon 
652e3722b78SAndriy Gapon static int
653e3722b78SAndriy Gapon superio_attach(device_t dev)
654e3722b78SAndriy Gapon {
655e3722b78SAndriy Gapon 	struct siosc *sc = device_get_softc(dev);
656e3722b78SAndriy Gapon 	int i;
657e3722b78SAndriy Gapon 
658e3722b78SAndriy Gapon 	mtx_init(&sc->conf_lock, device_get_nameunit(dev), "superio", MTX_DEF);
659e3722b78SAndriy Gapon 	STAILQ_INIT(&sc->devlist);
660e3722b78SAndriy Gapon 
661e3722b78SAndriy Gapon 	for (i = 0; sc->known_devices[i].type != SUPERIO_DEV_NONE; i++) {
662e3722b78SAndriy Gapon 		superio_add_known_child(dev, sc->known_devices[i].type,
663e3722b78SAndriy Gapon 		    sc->known_devices[i].ldn);
664e3722b78SAndriy Gapon 	}
665e3722b78SAndriy Gapon 
666e3722b78SAndriy Gapon 	bus_generic_probe(dev);
667e3722b78SAndriy Gapon 	bus_generic_attach(dev);
6680aee3bdcSAndriy Gapon 
6690aee3bdcSAndriy Gapon 	sc->chardev = make_dev(&superio_cdevsw, device_get_unit(dev),
6700aee3bdcSAndriy Gapon 	    UID_ROOT, GID_WHEEL, 0600, "superio%d", device_get_unit(dev));
6710aee3bdcSAndriy Gapon 	if (sc->chardev == NULL)
6720aee3bdcSAndriy Gapon 		device_printf(dev, "failed to create character device\n");
673174bd5b0SAndriy Gapon 	else
6740aee3bdcSAndriy Gapon 		sc->chardev->si_drv1 = sc;
675e3722b78SAndriy Gapon 	return (0);
676e3722b78SAndriy Gapon }
677e3722b78SAndriy Gapon 
678e3722b78SAndriy Gapon static int
679e3722b78SAndriy Gapon superio_detach(device_t dev)
680e3722b78SAndriy Gapon {
681e3722b78SAndriy Gapon 	struct siosc *sc = device_get_softc(dev);
682e3722b78SAndriy Gapon 	int error;
683e3722b78SAndriy Gapon 
684e3722b78SAndriy Gapon 	error = bus_generic_detach(dev);
685e3722b78SAndriy Gapon 	if (error != 0)
686e3722b78SAndriy Gapon 		return (error);
6870aee3bdcSAndriy Gapon 	if (sc->chardev != NULL)
6880aee3bdcSAndriy Gapon 		destroy_dev(sc->chardev);
689e3722b78SAndriy Gapon 	device_delete_children(dev);
690e3722b78SAndriy Gapon 	bus_release_resource(dev, SYS_RES_IOPORT, sc->io_rid, sc->io_res);
691e3722b78SAndriy Gapon 	mtx_destroy(&sc->conf_lock);
692e3722b78SAndriy Gapon 	return (0);
693e3722b78SAndriy Gapon }
694e3722b78SAndriy Gapon 
695e3722b78SAndriy Gapon static device_t
696e3722b78SAndriy Gapon superio_add_child(device_t dev, u_int order, const char *name, int unit)
697e3722b78SAndriy Gapon {
698e3722b78SAndriy Gapon 	struct superio_devinfo *dinfo;
699e3722b78SAndriy Gapon 	device_t child;
700e3722b78SAndriy Gapon 
701e3722b78SAndriy Gapon 	child = device_add_child_ordered(dev, order, name, unit);
702e3722b78SAndriy Gapon 	if (child == NULL)
703e3722b78SAndriy Gapon 		return (NULL);
704e3722b78SAndriy Gapon 	dinfo = malloc(sizeof(*dinfo), M_DEVBUF, M_NOWAIT | M_ZERO);
705e3722b78SAndriy Gapon 	if (dinfo == NULL) {
706e3722b78SAndriy Gapon 		device_delete_child(dev, child);
707e3722b78SAndriy Gapon 		return (NULL);
708e3722b78SAndriy Gapon 	}
709e3722b78SAndriy Gapon 	dinfo->ldn = 0xff;
710e3722b78SAndriy Gapon 	dinfo->type = SUPERIO_DEV_NONE;
711e3722b78SAndriy Gapon 	dinfo->dev = child;
712e3722b78SAndriy Gapon 	resource_list_init(&dinfo->resources);
713e3722b78SAndriy Gapon 	device_set_ivars(child, dinfo);
714e3722b78SAndriy Gapon 	return (child);
715e3722b78SAndriy Gapon }
716e3722b78SAndriy Gapon 
717e3722b78SAndriy Gapon static int
718e3722b78SAndriy Gapon superio_read_ivar(device_t dev, device_t child, int which, uintptr_t *result)
719e3722b78SAndriy Gapon {
720e3722b78SAndriy Gapon 	struct superio_devinfo *dinfo;
721e3722b78SAndriy Gapon 
722e3722b78SAndriy Gapon 	dinfo = device_get_ivars(child);
723e3722b78SAndriy Gapon 	switch (which) {
724e3722b78SAndriy Gapon 	case SUPERIO_IVAR_LDN:
725e3722b78SAndriy Gapon 		*result = dinfo->ldn;
726e3722b78SAndriy Gapon 		break;
727e3722b78SAndriy Gapon 	case SUPERIO_IVAR_TYPE:
728e3722b78SAndriy Gapon 		*result = dinfo->type;
729e3722b78SAndriy Gapon 		break;
730e3722b78SAndriy Gapon 	case SUPERIO_IVAR_IOBASE:
731e3722b78SAndriy Gapon 		*result = dinfo->iobase;
732e3722b78SAndriy Gapon 		break;
733e3722b78SAndriy Gapon 	case SUPERIO_IVAR_IOBASE2:
734e3722b78SAndriy Gapon 		*result = dinfo->iobase2;
735e3722b78SAndriy Gapon 		break;
736e3722b78SAndriy Gapon 	case SUPERIO_IVAR_IRQ:
737e3722b78SAndriy Gapon 		*result = dinfo->irq;
738e3722b78SAndriy Gapon 		break;
739e3722b78SAndriy Gapon 	case SUPERIO_IVAR_DMA:
740e3722b78SAndriy Gapon 		*result = dinfo->dma;
741e3722b78SAndriy Gapon 		break;
742e3722b78SAndriy Gapon 	default:
743e3722b78SAndriy Gapon 		return (ENOENT);
744e3722b78SAndriy Gapon 	}
745e3722b78SAndriy Gapon 	return (0);
746e3722b78SAndriy Gapon }
747e3722b78SAndriy Gapon 
748e3722b78SAndriy Gapon static int
749e3722b78SAndriy Gapon superio_write_ivar(device_t dev, device_t child, int which, uintptr_t value)
750e3722b78SAndriy Gapon {
751e3722b78SAndriy Gapon 
752e3722b78SAndriy Gapon 	switch (which) {
753e3722b78SAndriy Gapon 	case SUPERIO_IVAR_LDN:
754e3722b78SAndriy Gapon 	case SUPERIO_IVAR_TYPE:
755e3722b78SAndriy Gapon 	case SUPERIO_IVAR_IOBASE:
756e3722b78SAndriy Gapon 	case SUPERIO_IVAR_IOBASE2:
757e3722b78SAndriy Gapon 	case SUPERIO_IVAR_IRQ:
758e3722b78SAndriy Gapon 	case SUPERIO_IVAR_DMA:
759e3722b78SAndriy Gapon 		return (EINVAL);
760e3722b78SAndriy Gapon 	default:
761e3722b78SAndriy Gapon 		return (ENOENT);
762e3722b78SAndriy Gapon 	}
763e3722b78SAndriy Gapon }
764e3722b78SAndriy Gapon 
765e3722b78SAndriy Gapon static struct resource_list *
766e3722b78SAndriy Gapon superio_get_resource_list(device_t dev, device_t child)
767e3722b78SAndriy Gapon {
768e3722b78SAndriy Gapon 	struct superio_devinfo *dinfo = device_get_ivars(child);
769e3722b78SAndriy Gapon 
770e3722b78SAndriy Gapon 	return (&dinfo->resources);
771e3722b78SAndriy Gapon }
772e3722b78SAndriy Gapon 
773e3722b78SAndriy Gapon static int
774e3722b78SAndriy Gapon superio_printf(struct superio_devinfo *dinfo, const char *fmt, ...)
775e3722b78SAndriy Gapon {
776e3722b78SAndriy Gapon 	va_list ap;
777e3722b78SAndriy Gapon 	int retval;
778e3722b78SAndriy Gapon 
779e3722b78SAndriy Gapon 	retval = printf("superio:%s@ldn%0x2x: ",
780e3722b78SAndriy Gapon 	    devtype_to_str(dinfo->type), dinfo->ldn);
781e3722b78SAndriy Gapon 	va_start(ap, fmt);
782e3722b78SAndriy Gapon 	retval += vprintf(fmt, ap);
783e3722b78SAndriy Gapon 	va_end(ap);
784e3722b78SAndriy Gapon 	return (retval);
785e3722b78SAndriy Gapon }
786e3722b78SAndriy Gapon 
787e3722b78SAndriy Gapon static void
788e3722b78SAndriy Gapon superio_child_detached(device_t dev, device_t child)
789e3722b78SAndriy Gapon {
790e3722b78SAndriy Gapon 	struct superio_devinfo *dinfo;
791e3722b78SAndriy Gapon 	struct resource_list *rl;
792e3722b78SAndriy Gapon 
793e3722b78SAndriy Gapon 	dinfo = device_get_ivars(child);
794e3722b78SAndriy Gapon 	rl = &dinfo->resources;
795e3722b78SAndriy Gapon 
796e3722b78SAndriy Gapon 	if (resource_list_release_active(rl, dev, child, SYS_RES_IRQ) != 0)
797e3722b78SAndriy Gapon 		superio_printf(dinfo, "Device leaked IRQ resources\n");
798e3722b78SAndriy Gapon 	if (resource_list_release_active(rl, dev, child, SYS_RES_MEMORY) != 0)
799e3722b78SAndriy Gapon 		superio_printf(dinfo, "Device leaked memory resources\n");
800e3722b78SAndriy Gapon 	if (resource_list_release_active(rl, dev, child, SYS_RES_IOPORT) != 0)
801e3722b78SAndriy Gapon 		superio_printf(dinfo, "Device leaked I/O resources\n");
802e3722b78SAndriy Gapon }
803e3722b78SAndriy Gapon 
804e3722b78SAndriy Gapon static int
805e3722b78SAndriy Gapon superio_child_location_str(device_t parent, device_t child, char *buf,
806e3722b78SAndriy Gapon     size_t buflen)
807e3722b78SAndriy Gapon {
808e3722b78SAndriy Gapon 	uint8_t ldn;
809e3722b78SAndriy Gapon 
810e3722b78SAndriy Gapon 	ldn = superio_get_ldn(child);
811e3722b78SAndriy Gapon 	snprintf(buf, buflen, "ldn=0x%02x", ldn);
812e3722b78SAndriy Gapon 	return (0);
813e3722b78SAndriy Gapon }
814e3722b78SAndriy Gapon 
815e3722b78SAndriy Gapon static int
816e3722b78SAndriy Gapon superio_child_pnp_str(device_t parent, device_t child, char *buf,
817e3722b78SAndriy Gapon     size_t buflen)
818e3722b78SAndriy Gapon {
819e3722b78SAndriy Gapon 	superio_dev_type_t type;
820e3722b78SAndriy Gapon 
821e3722b78SAndriy Gapon 	type = superio_get_type(child);
822e3722b78SAndriy Gapon 	snprintf(buf, buflen, "type=%s", devtype_to_str(type));
823e3722b78SAndriy Gapon 	return (0);
824e3722b78SAndriy Gapon }
825e3722b78SAndriy Gapon 
826e3722b78SAndriy Gapon static int
827e3722b78SAndriy Gapon superio_print_child(device_t parent, device_t child)
828e3722b78SAndriy Gapon {
829e3722b78SAndriy Gapon 	superio_dev_type_t type;
830e3722b78SAndriy Gapon 	uint8_t ldn;
831e3722b78SAndriy Gapon 	int retval;
832e3722b78SAndriy Gapon 
833e3722b78SAndriy Gapon 	ldn = superio_get_ldn(child);
834e3722b78SAndriy Gapon 	type = superio_get_type(child);
835e3722b78SAndriy Gapon 
836e3722b78SAndriy Gapon 	retval = bus_print_child_header(parent, child);
837e3722b78SAndriy Gapon 	retval += printf(" at %s ldn 0x%02x", devtype_to_str(type), ldn);
838e3722b78SAndriy Gapon 	retval += bus_print_child_footer(parent, child);
839e3722b78SAndriy Gapon 
840e3722b78SAndriy Gapon 	return (retval);
841e3722b78SAndriy Gapon }
842e3722b78SAndriy Gapon 
843e3722b78SAndriy Gapon superio_vendor_t
844e3722b78SAndriy Gapon superio_vendor(device_t dev)
845e3722b78SAndriy Gapon {
846e3722b78SAndriy Gapon 	device_t sio_dev = device_get_parent(dev);
847e3722b78SAndriy Gapon 	struct siosc *sc = device_get_softc(sio_dev);
848e3722b78SAndriy Gapon 
849e3722b78SAndriy Gapon 	return (sc->vendor);
850e3722b78SAndriy Gapon }
851e3722b78SAndriy Gapon 
852e3722b78SAndriy Gapon uint16_t
853e3722b78SAndriy Gapon superio_devid(device_t dev)
854e3722b78SAndriy Gapon {
855e3722b78SAndriy Gapon 	device_t sio_dev = device_get_parent(dev);
856e3722b78SAndriy Gapon 	struct siosc *sc = device_get_softc(sio_dev);
857e3722b78SAndriy Gapon 
858e3722b78SAndriy Gapon 	return (sc->devid);
859e3722b78SAndriy Gapon }
860e3722b78SAndriy Gapon 
861e3722b78SAndriy Gapon uint8_t
862e3722b78SAndriy Gapon superio_revid(device_t dev)
863e3722b78SAndriy Gapon {
864e3722b78SAndriy Gapon 	device_t sio_dev = device_get_parent(dev);
865e3722b78SAndriy Gapon 	struct siosc *sc = device_get_softc(sio_dev);
866e3722b78SAndriy Gapon 
867e3722b78SAndriy Gapon 	return (sc->revid);
868e3722b78SAndriy Gapon }
869e3722b78SAndriy Gapon 
870e3722b78SAndriy Gapon uint8_t
871e3722b78SAndriy Gapon superio_read(device_t dev, uint8_t reg)
872e3722b78SAndriy Gapon {
873e3722b78SAndriy Gapon 	device_t sio_dev = device_get_parent(dev);
874e3722b78SAndriy Gapon 	struct siosc *sc = device_get_softc(sio_dev);
875e3722b78SAndriy Gapon 	struct superio_devinfo *dinfo = device_get_ivars(dev);
876e3722b78SAndriy Gapon 	uint8_t v;
877e3722b78SAndriy Gapon 
878e3722b78SAndriy Gapon 	sio_conf_enter(sc);
879e3722b78SAndriy Gapon 	v = sio_ldn_read(sc, dinfo->ldn, reg);
880e3722b78SAndriy Gapon 	sio_conf_exit(sc);
881e3722b78SAndriy Gapon 	return (v);
882e3722b78SAndriy Gapon }
883e3722b78SAndriy Gapon 
884e3722b78SAndriy Gapon void
885e3722b78SAndriy Gapon superio_write(device_t dev, uint8_t reg, uint8_t val)
886e3722b78SAndriy Gapon {
887e3722b78SAndriy Gapon 	device_t sio_dev = device_get_parent(dev);
888e3722b78SAndriy Gapon 	struct siosc *sc = device_get_softc(sio_dev);
889e3722b78SAndriy Gapon 	struct superio_devinfo *dinfo = device_get_ivars(dev);
890e3722b78SAndriy Gapon 
891e3722b78SAndriy Gapon 	sio_conf_enter(sc);
892e3722b78SAndriy Gapon 	sio_ldn_write(sc, dinfo->ldn, reg, val);
893e3722b78SAndriy Gapon 	sio_conf_exit(sc);
894e3722b78SAndriy Gapon }
895e3722b78SAndriy Gapon 
896e3722b78SAndriy Gapon bool
897e3722b78SAndriy Gapon superio_dev_enabled(device_t dev, uint8_t mask)
898e3722b78SAndriy Gapon {
899e3722b78SAndriy Gapon 	device_t sio_dev = device_get_parent(dev);
900e3722b78SAndriy Gapon 	struct siosc *sc = device_get_softc(sio_dev);
901e3722b78SAndriy Gapon 	struct superio_devinfo *dinfo = device_get_ivars(dev);
902e3722b78SAndriy Gapon 	uint8_t v;
903e3722b78SAndriy Gapon 
904e3722b78SAndriy Gapon 	/* GPIO device is always active in ITE chips. */
905e3722b78SAndriy Gapon 	if (sc->vendor == SUPERIO_VENDOR_ITE && dinfo->ldn == 7)
906e3722b78SAndriy Gapon 		return (true);
907e3722b78SAndriy Gapon 
908e3722b78SAndriy Gapon 	v = superio_read(dev, sc->enable_reg);
909e3722b78SAndriy Gapon 	return ((v & mask) != 0);
910e3722b78SAndriy Gapon }
911e3722b78SAndriy Gapon 
912e3722b78SAndriy Gapon void
913e3722b78SAndriy Gapon superio_dev_enable(device_t dev, uint8_t mask)
914e3722b78SAndriy Gapon {
915e3722b78SAndriy Gapon 	device_t sio_dev = device_get_parent(dev);
916e3722b78SAndriy Gapon 	struct siosc *sc = device_get_softc(sio_dev);
917e3722b78SAndriy Gapon 	struct superio_devinfo *dinfo = device_get_ivars(dev);
918e3722b78SAndriy Gapon 	uint8_t v;
919e3722b78SAndriy Gapon 
920e3722b78SAndriy Gapon 	/* GPIO device is always active in ITE chips. */
921e3722b78SAndriy Gapon 	if (sc->vendor == SUPERIO_VENDOR_ITE && dinfo->ldn == 7)
922e3722b78SAndriy Gapon 		return;
923e3722b78SAndriy Gapon 
924e3722b78SAndriy Gapon 	sio_conf_enter(sc);
925e3722b78SAndriy Gapon 	v = sio_ldn_read(sc, dinfo->ldn, sc->enable_reg);
926e3722b78SAndriy Gapon 	v |= mask;
927e3722b78SAndriy Gapon 	sio_ldn_write(sc, dinfo->ldn, sc->enable_reg, v);
928e3722b78SAndriy Gapon 	sio_conf_exit(sc);
929e3722b78SAndriy Gapon }
930e3722b78SAndriy Gapon 
931e3722b78SAndriy Gapon void
932e3722b78SAndriy Gapon superio_dev_disable(device_t dev, uint8_t mask)
933e3722b78SAndriy Gapon {
934e3722b78SAndriy Gapon 	device_t sio_dev = device_get_parent(dev);
935e3722b78SAndriy Gapon 	struct siosc *sc = device_get_softc(sio_dev);
936e3722b78SAndriy Gapon 	struct superio_devinfo *dinfo = device_get_ivars(dev);
937e3722b78SAndriy Gapon 	uint8_t v;
938e3722b78SAndriy Gapon 
939e3722b78SAndriy Gapon 	/* GPIO device is always active in ITE chips. */
940e3722b78SAndriy Gapon 	if (sc->vendor == SUPERIO_VENDOR_ITE && dinfo->ldn == 7)
941e3722b78SAndriy Gapon 		return;
942e3722b78SAndriy Gapon 
943e3722b78SAndriy Gapon 	sio_conf_enter(sc);
944e3722b78SAndriy Gapon 	v = sio_ldn_read(sc, dinfo->ldn, sc->enable_reg);
945e3722b78SAndriy Gapon 	v &= ~mask;
946e3722b78SAndriy Gapon 	sio_ldn_write(sc, dinfo->ldn, sc->enable_reg, v);
947e3722b78SAndriy Gapon 	sio_conf_exit(sc);
948e3722b78SAndriy Gapon }
949e3722b78SAndriy Gapon 
950e3722b78SAndriy Gapon device_t
951e3722b78SAndriy Gapon superio_find_dev(device_t superio, superio_dev_type_t type, int ldn)
952e3722b78SAndriy Gapon {
953e3722b78SAndriy Gapon 	struct siosc *sc = device_get_softc(superio);
954e3722b78SAndriy Gapon 	struct superio_devinfo *dinfo;
955e3722b78SAndriy Gapon 
956e3722b78SAndriy Gapon 	if (ldn < -1 || ldn > UINT8_MAX)
957e3722b78SAndriy Gapon 		return (NULL);		/* ERANGE */
958e3722b78SAndriy Gapon 	if (type == SUPERIO_DEV_NONE && ldn == -1)
959e3722b78SAndriy Gapon 		return (NULL);		/* EINVAL */
960e3722b78SAndriy Gapon 
961e3722b78SAndriy Gapon 	STAILQ_FOREACH(dinfo, &sc->devlist, link) {
962e3722b78SAndriy Gapon 		if (ldn != -1 && dinfo->ldn != ldn)
963e3722b78SAndriy Gapon 			continue;
964e3722b78SAndriy Gapon 		if (type != SUPERIO_DEV_NONE && dinfo->type != type)
965e3722b78SAndriy Gapon 			continue;
966e3722b78SAndriy Gapon 		return (dinfo->dev);
967e3722b78SAndriy Gapon 	}
968e3722b78SAndriy Gapon 	return (NULL);
969e3722b78SAndriy Gapon }
970e3722b78SAndriy Gapon 
9710aee3bdcSAndriy Gapon static int
9720aee3bdcSAndriy Gapon superio_ioctl(struct cdev *dev, u_long cmd, caddr_t data, int flags,
9730aee3bdcSAndriy Gapon     struct thread *td)
9740aee3bdcSAndriy Gapon {
9750aee3bdcSAndriy Gapon 	struct siosc *sc;
9760aee3bdcSAndriy Gapon 	struct superiocmd *s;
9770aee3bdcSAndriy Gapon 
9780aee3bdcSAndriy Gapon 	sc = dev->si_drv1;
9790aee3bdcSAndriy Gapon 	s = (struct superiocmd *)data;
9800aee3bdcSAndriy Gapon 	switch (cmd) {
9810aee3bdcSAndriy Gapon 	case SUPERIO_CR_READ:
9820aee3bdcSAndriy Gapon 		sio_conf_enter(sc);
9830aee3bdcSAndriy Gapon 		s->val = sio_ldn_read(sc, s->ldn, s->cr);
9840aee3bdcSAndriy Gapon 		sio_conf_exit(sc);
9850aee3bdcSAndriy Gapon 		return (0);
9860aee3bdcSAndriy Gapon 	case SUPERIO_CR_WRITE:
9870aee3bdcSAndriy Gapon 		sio_conf_enter(sc);
9880aee3bdcSAndriy Gapon 		sio_ldn_write(sc, s->ldn, s->cr, s->val);
9890aee3bdcSAndriy Gapon 		sio_conf_exit(sc);
9900aee3bdcSAndriy Gapon 		return (0);
9910aee3bdcSAndriy Gapon 	default:
9920aee3bdcSAndriy Gapon 		return (ENOTTY);
9930aee3bdcSAndriy Gapon 	}
9940aee3bdcSAndriy Gapon }
9950aee3bdcSAndriy Gapon 
996e3722b78SAndriy Gapon static devclass_t superio_devclass;
997e3722b78SAndriy Gapon 
998e3722b78SAndriy Gapon static device_method_t superio_methods[] = {
999e3722b78SAndriy Gapon 	DEVMETHOD(device_identify,	superio_identify),
1000e3722b78SAndriy Gapon 	DEVMETHOD(device_probe,		superio_probe),
1001e3722b78SAndriy Gapon 	DEVMETHOD(device_attach,	superio_attach),
1002e3722b78SAndriy Gapon 	DEVMETHOD(device_detach,	superio_detach),
1003e3722b78SAndriy Gapon 	DEVMETHOD(device_shutdown,	bus_generic_shutdown),
1004e3722b78SAndriy Gapon 	DEVMETHOD(device_suspend,	bus_generic_suspend),
1005e3722b78SAndriy Gapon 	DEVMETHOD(device_resume,	bus_generic_resume),
1006e3722b78SAndriy Gapon 
1007e3722b78SAndriy Gapon 	DEVMETHOD(bus_add_child,	superio_add_child),
1008e3722b78SAndriy Gapon 	DEVMETHOD(bus_child_detached,	superio_child_detached),
1009e3722b78SAndriy Gapon 	DEVMETHOD(bus_child_location_str, superio_child_location_str),
1010e3722b78SAndriy Gapon 	DEVMETHOD(bus_child_pnpinfo_str, superio_child_pnp_str),
1011e3722b78SAndriy Gapon 	DEVMETHOD(bus_print_child,	superio_print_child),
1012e3722b78SAndriy Gapon 	DEVMETHOD(bus_read_ivar,	superio_read_ivar),
1013e3722b78SAndriy Gapon 	DEVMETHOD(bus_write_ivar,	superio_write_ivar),
1014e3722b78SAndriy Gapon 	DEVMETHOD(bus_get_resource_list, superio_get_resource_list),
1015e3722b78SAndriy Gapon 	DEVMETHOD(bus_alloc_resource,	bus_generic_rl_alloc_resource),
1016e3722b78SAndriy Gapon 	DEVMETHOD(bus_release_resource,	bus_generic_rl_release_resource),
1017e3722b78SAndriy Gapon 	DEVMETHOD(bus_set_resource,	bus_generic_rl_set_resource),
1018e3722b78SAndriy Gapon 	DEVMETHOD(bus_get_resource,	bus_generic_rl_get_resource),
1019e3722b78SAndriy Gapon 	DEVMETHOD(bus_delete_resource,	bus_generic_rl_delete_resource),
1020e3722b78SAndriy Gapon 	DEVMETHOD(bus_activate_resource, bus_generic_activate_resource),
1021e3722b78SAndriy Gapon 	DEVMETHOD(bus_deactivate_resource, bus_generic_deactivate_resource),
1022e3722b78SAndriy Gapon 	DEVMETHOD(bus_setup_intr,	bus_generic_setup_intr),
1023e3722b78SAndriy Gapon 	DEVMETHOD(bus_teardown_intr,	bus_generic_teardown_intr),
1024e3722b78SAndriy Gapon 
1025e3722b78SAndriy Gapon 	DEVMETHOD_END
1026e3722b78SAndriy Gapon };
1027e3722b78SAndriy Gapon 
1028e3722b78SAndriy Gapon static driver_t superio_driver = {
1029e3722b78SAndriy Gapon 	"superio",
1030e3722b78SAndriy Gapon 	superio_methods,
1031e3722b78SAndriy Gapon 	sizeof(struct siosc)
1032e3722b78SAndriy Gapon };
1033e3722b78SAndriy Gapon 
1034e3722b78SAndriy Gapon DRIVER_MODULE(superio, isa, superio_driver, superio_devclass, 0, 0);
1035e3722b78SAndriy Gapon MODULE_VERSION(superio, 1);
1036