1 /*- 2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD 3 * 4 * Copyright (c) 2004 Joerg Wunsch 5 * 6 * derived from sys/i386/isa/pcf.c which is: 7 * 8 * Copyright (c) 1998 Nicolas Souchu, Marc Bouget 9 * All rights reserved. 10 * 11 * Redistribution and use in source and binary forms, with or without 12 * modification, are permitted provided that the following conditions 13 * are met: 14 * 1. Redistributions of source code must retain the above copyright 15 * notice, this list of conditions and the following disclaimer. 16 * 2. Redistributions in binary form must reproduce the above copyright 17 * notice, this list of conditions and the following disclaimer in the 18 * documentation and/or other materials provided with the distribution. 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 */ 32 #include <sys/cdefs.h> 33 __FBSDID("$FreeBSD$"); 34 35 /* 36 * Hardware driver for a Philips PCF8584 I2C bus controller sitting 37 * on a generic ISA bus. 38 */ 39 40 #include <sys/param.h> 41 #include <sys/bus.h> 42 #include <sys/lock.h> 43 #include <sys/kernel.h> 44 #include <sys/module.h> 45 #include <sys/mutex.h> 46 #include <sys/resource.h> 47 #include <sys/systm.h> 48 49 #include <machine/bus.h> 50 #include <machine/resource.h> 51 52 #include <sys/rman.h> 53 54 #include <isa/isareg.h> 55 #include <isa/isavar.h> 56 57 #include <dev/iicbus/iiconf.h> 58 #include <dev/pcf/pcfvar.h> 59 #include "iicbus_if.h" 60 61 #define PCF_NAME "pcf" 62 63 static void pcf_isa_identify(driver_t *, device_t); 64 static int pcf_isa_probe(device_t); 65 static int pcf_isa_attach(device_t); 66 static int pcf_isa_detach(device_t); 67 68 static device_method_t pcf_isa_methods[] = { 69 /* device interface */ 70 DEVMETHOD(device_identify, pcf_isa_identify), 71 DEVMETHOD(device_probe, pcf_isa_probe), 72 DEVMETHOD(device_attach, pcf_isa_attach), 73 DEVMETHOD(device_detach, pcf_isa_detach), 74 75 /* iicbus interface */ 76 DEVMETHOD(iicbus_callback, iicbus_null_callback), 77 DEVMETHOD(iicbus_repeated_start, pcf_repeated_start), 78 DEVMETHOD(iicbus_start, pcf_start), 79 DEVMETHOD(iicbus_stop, pcf_stop), 80 DEVMETHOD(iicbus_write, pcf_write), 81 DEVMETHOD(iicbus_read, pcf_read), 82 DEVMETHOD(iicbus_reset, pcf_rst_card), 83 { 0, 0 } 84 }; 85 86 static driver_t pcf_isa_driver = { 87 PCF_NAME, 88 pcf_isa_methods, 89 sizeof(struct pcf_softc), 90 }; 91 92 static void 93 pcf_isa_identify(driver_t *driver, device_t parent) 94 { 95 BUS_ADD_CHILD(parent, ISA_ORDER_SPECULATIVE, PCF_NAME, 0); 96 97 return; 98 } 99 100 static int 101 pcf_isa_probe(device_t dev) 102 { 103 rman_res_t start, count; 104 u_int rid = 0, port, error; 105 106 /* skip PnP probes */ 107 if (isa_get_logicalid(dev)) 108 return (ENXIO); 109 110 /* The port address must be explicitly specified */ 111 bus_get_resource(dev, SYS_RES_IOPORT, rid, &start, &count); 112 if ((error = resource_int_value(PCF_NAME, 0, "port", &port)) != 0) 113 return (error); 114 115 /* Probe is only successful for the specified base io */ 116 if (port != (u_int)start) 117 return (ENXIO); 118 119 device_set_desc(dev, "PCF8584 I2C bus controller"); 120 121 return (0); 122 } 123 124 static int 125 pcf_isa_attach(device_t dev) 126 { 127 struct pcf_softc *sc; 128 int rv = ENXIO; 129 130 sc = DEVTOSOFTC(dev); 131 mtx_init(&sc->pcf_lock, device_get_nameunit(dev), "pcf", MTX_DEF); 132 133 /* IO port is mandatory */ 134 sc->res_ioport = bus_alloc_resource_any(dev, SYS_RES_IOPORT, 135 &sc->rid_ioport, RF_ACTIVE); 136 if (sc->res_ioport == 0) { 137 device_printf(dev, "cannot reserve I/O port range\n"); 138 goto error; 139 } 140 141 sc->pcf_flags = device_get_flags(dev); 142 143 if (!(sc->pcf_flags & IIC_POLLED)) { 144 sc->res_irq = bus_alloc_resource_any(dev, SYS_RES_IRQ, &sc->rid_irq, 145 RF_ACTIVE); 146 if (sc->res_irq == 0) { 147 device_printf(dev, "can't reserve irq, polled mode.\n"); 148 sc->pcf_flags |= IIC_POLLED; 149 } 150 } 151 152 /* reset the chip */ 153 pcf_rst_card(dev, IIC_FASTEST, PCF_DEFAULT_ADDR, NULL); 154 155 if (sc->res_irq) { 156 rv = bus_setup_intr(dev, sc->res_irq, 157 INTR_TYPE_NET /* | INTR_ENTROPY */, 158 NULL, pcf_intr, sc, &sc->intr_cookie); 159 if (rv) { 160 device_printf(dev, "could not setup IRQ\n"); 161 goto error; 162 } 163 } 164 165 if ((sc->iicbus = device_add_child(dev, "iicbus", -1)) == NULL) 166 device_printf(dev, "could not allocate iicbus instance\n"); 167 168 /* probe and attach the iicbus */ 169 bus_generic_attach(dev); 170 171 return (0); 172 173 error: 174 if (sc->res_irq != 0) { 175 bus_release_resource(dev, SYS_RES_IRQ, sc->rid_irq, 176 sc->res_irq); 177 } 178 if (sc->res_ioport != 0) { 179 bus_release_resource(dev, SYS_RES_IOPORT, sc->rid_ioport, 180 sc->res_ioport); 181 } 182 mtx_destroy(&sc->pcf_lock); 183 return (rv); 184 } 185 186 static int 187 pcf_isa_detach(device_t dev) 188 { 189 struct pcf_softc *sc; 190 int rv; 191 192 sc = DEVTOSOFTC(dev); 193 194 if ((rv = bus_generic_detach(dev)) != 0) 195 return (rv); 196 197 if ((rv = device_delete_child(dev, sc->iicbus)) != 0) 198 return (rv); 199 200 if (sc->res_irq != 0) { 201 bus_teardown_intr(dev, sc->res_irq, sc->intr_cookie); 202 bus_release_resource(dev, SYS_RES_IRQ, sc->rid_irq, sc->res_irq); 203 } 204 205 bus_release_resource(dev, SYS_RES_IOPORT, sc->rid_ioport, sc->res_ioport); 206 mtx_destroy(&sc->pcf_lock); 207 208 return (0); 209 } 210 211 DRIVER_MODULE(pcf_isa, isa, pcf_isa_driver, 0, 0); 212