root/sys/dev/isa/tcic2_isa.c
/*      $NetBSD: tcic2_isa.c,v 1.30 2022/09/25 17:09:36 thorpej Exp $   */

/*
 *
 * Copyright (c) 1998, 1999 Christoph Badura. All rights reserved.
 * Copyright (c) 1997 Marc Horowitz.  All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *      This product includes software developed by Marc Horowitz.
 * 4. The name of the author may not be used to endorse or promote products
 *    derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#include <sys/cdefs.h>
__KERNEL_RCSID(0, "$NetBSD: tcic2_isa.c,v 1.30 2022/09/25 17:09:36 thorpej Exp $");

#include <sys/param.h>
#include <sys/systm.h>
#include <sys/device.h>
#include <sys/extent.h>

#include <sys/bus.h>
#include <sys/intr.h>

#include <dev/isa/isareg.h>
#include <dev/isa/isavar.h>

#include <dev/pcmcia/pcmciareg.h>
#include <dev/pcmcia/pcmciavar.h>
#include <dev/pcmcia/pcmciachip.h>

#include <dev/ic/tcic2reg.h>
#include <dev/ic/tcic2var.h>

/*****************************************************************************
 * Configurable parameters.
 *****************************************************************************/

#include "opt_tcic_isa_alloc_iobase.h"
#include "opt_tcic_isa_alloc_iosize.h"
#include "opt_tcic_isa_intr_alloc_mask.h"

/*
 * Default I/O allocation range.  If both are set to non-zero, these
 * values will be used instead.  Otherwise, the code attempts to probe
 * the bus width.  Systems with 10 address bits should use 0x300 and 0xff.
 * Systems with 12 address bits (most) should use 0x400 and 0xbff.
 */

#ifndef TCIC_ISA_ALLOC_IOBASE
#define TCIC_ISA_ALLOC_IOBASE           0
#endif

#ifndef TCIC_ISA_ALLOC_IOSIZE
#define TCIC_ISA_ALLOC_IOSIZE           0
#endif

int     tcic_isa_alloc_iobase = TCIC_ISA_ALLOC_IOBASE;
int     tcic_isa_alloc_iosize = TCIC_ISA_ALLOC_IOSIZE;

/*
 * Default IRQ allocation bitmask.  This defines the range of allowable
 * IRQs for PCMCIA slots.  Useful if order of probing would screw up other
 * devices, or if TCIC hardware/cards have trouble with certain interrupt
 * lines.
 *
 * We disable IRQ 10 by default, since some common laptops (namely, the
 * NEC Versa series) reserve IRQ 10 for the docking station SCSI interface.
 *
 * XXX Do we care about this?  the Versa doesn't use a tcic. -chb
 */

#ifndef TCIC_ISA_INTR_ALLOC_MASK
#define TCIC_ISA_INTR_ALLOC_MASK        0xffff
#endif

int     tcic_isa_intr_alloc_mask = TCIC_ISA_INTR_ALLOC_MASK;

/*****************************************************************************
 * End of configurable parameters.
 *****************************************************************************/

#ifdef TCICISADEBUG
int     tcic_isa_debug = 1;
#define DPRINTF(arg) if (tcic_isa_debug) printf arg;
#else
#define DPRINTF(arg)
#endif

int     tcic_isa_probe(device_t, cfdata_t, void *);
void    tcic_isa_attach(device_t, device_t, void *);

void    *tcic_isa_chip_intr_establish(pcmcia_chipset_handle_t,
            struct pcmcia_function *, int, int (*) (void *), void *);
void    tcic_isa_chip_intr_disestablish(pcmcia_chipset_handle_t, void *);

CFATTACH_DECL_NEW(tcic_isa, sizeof(struct tcic_softc),
    tcic_isa_probe, tcic_isa_attach, NULL, NULL);

static const struct pcmcia_chip_functions tcic_isa_functions = {
        tcic_chip_mem_alloc,
        tcic_chip_mem_free,
        tcic_chip_mem_map,
        tcic_chip_mem_unmap,

        tcic_chip_io_alloc,
        tcic_chip_io_free,
        tcic_chip_io_map,
        tcic_chip_io_unmap,

        tcic_isa_chip_intr_establish,
        tcic_isa_chip_intr_disestablish,

        tcic_chip_socket_enable,
        tcic_chip_socket_disable,
        tcic_chip_socket_settype,

        NULL,   /* card_detect */
};

int
tcic_isa_probe(device_t parent, cfdata_t match, void *aux)
{
        struct isa_attach_args *ia = aux;
        bus_space_tag_t iot = ia->ia_iot;
        bus_space_handle_t ioh, memh;
        int val, found, msize;

        if (ia->ia_nio < 1)
                return (0);
        if (ia->ia_niomem < 1)
                return (0);

        if (ISA_DIRECT_CONFIG(ia))
                return (0);

        /* Disallow wildcarded i/o address. */
        if (ia->ia_io[0].ir_addr == ISA_UNKNOWN_PORT)
                return (0);
        if (ia->ia_iomem[0].ir_addr == ISA_UNKNOWN_IOMEM)
                return (0);

        if (bus_space_map(iot, ia->ia_io[0].ir_addr, TCIC_IOSIZE, 0, &ioh))
                return (0);

        if (ia->ia_iomem[0].ir_size == ISA_UNKNOWN_IOSIZ)
                msize = TCIC_MEMSIZE;
        else
                msize = ia->ia_iomem[0].ir_size;

        if (bus_space_map(ia->ia_memt, ia->ia_iomem[0].ir_addr,
            msize, 0, &memh)) {
                bus_space_unmap(iot, ioh, TCIC_IOSIZE);
                return (0);
        }

        DPRINTF(("tcic probing 0x%03x\n", ia->ia_iomem[0].ir_addr));
        found = 0;

        /*
         * First, check for the reserved bits to be zero.
         */
        if (tcic_check_reserved_bits(iot, ioh)) {
                DPRINTF(("tcic: reserved bits checked OK\n"));
                /* Second, check whether the we know how to handle the chip. */
                if ((val = tcic_chipid(iot, ioh))) {
                        DPRINTF(("tcic id: 0x%02x\n", val));
                        if (tcic_chipid_known(val))
                                found++;
                }
        }
        else {
                DPRINTF(("tcic: reserved bits didn't check OK\n"));
        }

        bus_space_unmap(iot, ioh, TCIC_IOSIZE);
        bus_space_unmap(ia->ia_memt, memh, msize);

        if (!found)
                return (0);

        ia->ia_nio = 1;
        ia->ia_io[0].ir_size = TCIC_IOSIZE;

        ia->ia_niomem = 1;
        ia->ia_iomem[0].ir_size = msize;

        /* IRQ is special. */

        ia->ia_ndrq = 0;

        return (1);
}

void
tcic_isa_attach(device_t parent, device_t self, void *aux)
{
        struct tcic_softc *sc = device_private(self);
        struct isa_attach_args *ia = aux;
        isa_chipset_tag_t ic = ia->ia_ic;
        bus_space_tag_t iot = ia->ia_iot;
        bus_space_tag_t memt = ia->ia_memt;
        bus_space_handle_t ioh;
        bus_space_handle_t memh;

        sc->sc_dev = self;
        aprint_naive("\n");

        /* Map i/o space. */
        if (bus_space_map(iot, ia->ia_io[0].ir_addr, TCIC_IOSIZE, 0, &ioh)) {
                aprint_error(": can't map i/o space\n");
                return;
        }

        /* Map mem space. */
        if (bus_space_map(memt, ia->ia_iomem[0].ir_addr,
            ia->ia_iomem[0].ir_size, 0, &memh)) {
                aprint_error(": can't map mem space\n");
                return;
        }

        sc->membase = ia->ia_iomem[0].ir_addr;
        sc->subregionmask =
            (1 << (ia->ia_iomem[0].ir_size / TCIC_MEM_PAGESIZE)) - 1;
        sc->memsize2 = tcic_log2((u_int)ia->ia_iomem[0].ir_size);

        sc->intr_est = ic;
        sc->pct = (pcmcia_chipset_tag_t) & tcic_isa_functions;

        sc->iot = iot;
        sc->ioh = ioh;
        sc->memt = memt;
        sc->memh = memh;

        /*
         * determine chip type and initialise some chip type dependent
         * parameters in softc.
         */
        sc->chipid = tcic_chipid(iot, ioh);
        sc->validirqs = tcic_validirqs(sc->chipid);

        /*
         * allocate an irq.  interrupts are relatively
         * scarce but for TCIC controllers very infrequent.
         */

        if (ia->ia_nirq < 1)
                sc->irq = ISA_UNKNOWN_IRQ;
        else
                sc->irq = ia->ia_irq[0].ir_irq;
        if (sc->irq == ISA_UNKNOWN_IRQ) {
                if (isa_intr_alloc(ic,
                    sc->validirqs & (tcic_isa_intr_alloc_mask & 0xff00),
                    IST_EDGE, &sc->irq)) {
                        aprint_normal("\n");
                        aprint_error_dev(self, "can't allocate interrupt\n");
                        return;
                }
                aprint_normal(": using irq %d", sc->irq);
        }
        aprint_normal("\n");

        tcic_attach(sc);


        /*
         * XXX mycroft recommends I/O space range 0x400-0xfff.
         */

        /*
         * XXX some hardware doesn't seem to grok addresses in 0x400 range--
         * apparently missing a bit or more of address lines. (e.g.
         * CIRRUS_PD672X with Linksys EthernetCard ne2000 clone in TI
         * TravelMate 5000--not clear which is at fault)
         *
         * Add a kludge to detect 10 bit wide buses and deal with them,
         * and also a config file option to override the probe.
         */

#if 0
        /*
         * This is what we'd like to use, but...
         */
        sc->iobase = 0x400;
        sc->iosize = 0xbff;
#else
        /*
         * ...the above bus width probe doesn't always work.
         * So, experimentation has shown the following range
         * to not lose on systems that 0x300-0x3ff loses on
         * (e.g. the NEC Versa 6030X).
         */
        sc->iobase = 0x330;
        sc->iosize = 0x0cf;
#endif

        DPRINTF(("%s: bus_space_alloc range 0x%04lx-0x%04lx)\n",
            device_xname(self), (long) sc->iobase,
            (long) sc->iobase + sc->iosize));

        if (tcic_isa_alloc_iobase && tcic_isa_alloc_iosize) {
                sc->iobase = tcic_isa_alloc_iobase;
                sc->iosize = tcic_isa_alloc_iosize;

                DPRINTF(("%s: bus_space_alloc range 0x%04lx-0x%04lx "
                    "(config override)\n", device_xname(self),
                    (long)sc->iobase, (long)sc->iobase + sc->iosize));
        }
        sc->ih = isa_intr_establish(ic, sc->irq, IST_EDGE, IPL_TTY,
            tcic_intr, sc);
        if (sc->ih == NULL) {
                aprint_error_dev(self, "can't establish interrupt\n");
                return;
        }

        tcic_attach_sockets(sc);
}

void *
tcic_isa_chip_intr_establish(pcmcia_chipset_handle_t pch,
    struct pcmcia_function *pf, int ipl, int (*fct)(void *), void *arg)
{
        struct tcic_handle *h = (struct tcic_handle *) pch;
        int irq, ist;
        void *ih;

        DPRINTF(("%s: tcic_isa_chip_intr_establish\n",
            device_xname(h->sc->sc_dev)));

        /* XXX should we convert level to pulse? -chb  */
        if (pf->cfe->flags & PCMCIA_CFE_IRQLEVEL)
                ist = IST_LEVEL;
        else if (pf->cfe->flags & PCMCIA_CFE_IRQPULSE)
                ist = IST_PULSE;
        else
                ist = IST_LEVEL;

        if (isa_intr_alloc(h->sc->intr_est,
            h->sc->validirqs & tcic_isa_intr_alloc_mask, ist, &irq))
                return (NULL);
        if ((ih = isa_intr_establish(h->sc->intr_est, irq, ist, ipl,
            fct, arg)) == NULL)
                return (NULL);

        DPRINTF(("%s: intr estrablished\n", device_xname(h->sc->sc_dev)));

        h->ih_irq = irq;

        printf("%s: card irq %d\n", device_xname(h->pcmcia), irq);

        return (ih);
}

void
tcic_isa_chip_intr_disestablish(pcmcia_chipset_handle_t pch, void *ih)
{
        struct tcic_handle *h = (struct tcic_handle *) pch;
        int val, reg;

        DPRINTF(("%s: tcic_isa_chip_intr_disestablish\n",
            device_xname(h->sc->sc_dev)));

        h->ih_irq = 0;

        reg = TCIC_IR_SCF1_N(h->sock);
        val = tcic_read_ind_2(h, reg);
        val &= ~TCIC_SCF1_IRQ_MASK;
        tcic_write_ind_2(h, reg, val);

        isa_intr_disestablish(h->sc->intr_est, ih);
}