/* $NetBSD: pi1ppcvar.h,v 1.8 2024/08/13 16:23:48 andvar Exp $ */ /*- * Copyright (c) 2001 Alcove - Nicolas Souchu * Copyright (c) 2005 Joe Britt - SGI PI1 version * 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. * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``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 OR CONTRIBUTORS 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. * * FreeBSD: src/sys/isa/ppcreg.h,v 1.10.2.4 2001/10/02 05:21:45 nsouch Exp * */ #ifndef __PI1PPCVAR_H #define __PI1PPCVAR_H #include #include #include #include #include /* Maximum time to wait for device response */ #define MAXBUSYWAIT (5 * (hz)) /* Poll interval when waiting for device to become ready */ #define PI1PPC_POLL ((hz)/10) /* Diagnostic and verbose printing macros */ #ifdef PI1PPC_DEBUG extern int pi1ppc_debug; #define PI1PPC_DPRINTF(arg) if(pi1ppc_debug) printf arg #else #define PI1PPC_DPRINTF(arg) #endif #ifdef PI1PPC_VERBOSE extern int pi1ppc_verbose; #define PI1PPC_VPRINTF(arg) if(pi1ppc_verbose) printf arg #else #define PI1PPC_VPRINTF(arg) #endif /* Flag used in DMA transfer */ #define PI1PPC_DMA_MODE_READ 0x0 #define PI1PPC_DMA_MODE_WRITE 0x1 /* Flags passed via config */ #define PI1PPC_FLAG_DISABLE_INTR 0x01 #define PI1PPC_FLAG_DISABLE_DMA 0x02 /* Locking for pi1ppc device */ #define PI1PPC_SC_LOCK(sc) (&((sc)->sc_lock)) #define PI1PPC_LOCK(sc) mutex_enter(&sc->sc_lock) #define PI1PPC_UNLOCK(sc) mutex_exit(&sc->sc_lock) /* Single softintr callback entry */ struct pi1ppc_handler_node { void (*func)(void *); void *arg; SLIST_ENTRY(pi1ppc_handler_node) entries; }; /* Generic structure to hold parallel port chipset info. */ struct pi1ppc_softc { /* Generic device attributes */ device_t sc_dev; kmutex_t sc_lock; kcondvar_t sc_in_cv; kcondvar_t sc_out_cv; /* Machine independent bus infrastructure */ bus_space_tag_t sc_iot; bus_space_handle_t sc_ioh; bus_dma_tag_t sc_dmat; bus_dmamap_t sc_dmapt; bus_size_t sc_dma_maxsize; /* Child device */ device_t child; /* Opaque handle used for interrupt handler establishment */ void *sc_ieh; /* List of soft interrupts to call */ SLIST_HEAD(handler_list, pi1ppc_handler_node) sc_handler_listhead; /* Input buffer: working pointers, and size in bytes. */ char * sc_inb; char * sc_inbstart; uint32_t sc_inb_nbytes; int sc_inerr; /* Output buffer pointer, working pointer, and size in bytes. */ char * sc_outb; char * sc_outbstart; uint32_t sc_outb_nbytes; int sc_outerr; /* DMA functions: setup by bus specific attach code */ int (*sc_dma_start)(struct pi1ppc_softc *, void *, u_int, uint8_t); int (*sc_dma_finish)(struct pi1ppc_softc *); int (*sc_dma_abort)(struct pi1ppc_softc *); int (*sc_dma_malloc)(device_t, void **, bus_addr_t *, bus_size_t); void (*sc_dma_free)(device_t, void **, bus_addr_t *, bus_size_t); /* Microsequence related members */ char * sc_ptr; /* microseq current pointer */ int sc_accum; /* microseq accumulator */ /* Device attachment state */ #define PI1PPC_ATTACHED 1 #define PI1PPC_NOATTACH 0 uint8_t sc_dev_ok; /* * Hardware capabilities flags: standard mode and nibble mode are * assumed to always be available since if they aren't you don't * HAVE a parallel port. */ #define PI1PPC_HAS_INTR 0x01 /* Interrupt available */ #define PI1PPC_HAS_DMA 0x02 /* DMA available */ #define PI1PPC_HAS_FIFO 0x04 /* FIFO available */ #define PI1PPC_HAS_PS2 0x08 /* PS2 mode capable */ uint8_t sc_has; /* Chipset detected capabilities */ /* Flags specifying mode of chipset operation . */ #define PI1PPC_MODE_STD 0x01 /* Use centronics-compatible mode */ #define PI1PPC_MODE_PS2 0x02 /* Use PS2 mode */ #define PI1PPC_MODE_NIBBLE 0x10 /* Use nibble mode */ uint8_t sc_mode; /* Current operational mode */ /* Flags which further define chipset operation */ #define PI1PPC_USE_INTR 0x01 /* Use interrupts */ #define PI1PPC_USE_DMA 0x02 /* Use DMA */ uint8_t sc_use; /* Capabilities to use */ /* Parallel Port Chipset model. */ #define GENERIC 6 uint8_t sc_model; /* chipset model */ /* EPP mode - UNUSED */ uint8_t sc_epp; /* Parallel Port Chipset Type. Only Indy-style needed? */ #define PI1PPC_TYPE_INDY 0 uint8_t sc_type; /* Stored register values after an interrupt occurs */ uint8_t sc_ecr_intr; uint8_t sc_ctr_intr; uint8_t sc_str_intr; #define PI1PPC_IRQ_NONE 0x0 #define PI1PPC_IRQ_nACK 0x1 #define PI1PPC_IRQ_DMA 0x2 #define PI1PPC_IRQ_FIFO 0x4 #define PI1PPC_IRQ_nFAULT 0x8 uint8_t sc_irqstat; /* Record irq settings */ #define PI1PPC_DMA_INIT 0x01 #define PI1PPC_DMA_STARTED 0x02 #define PI1PPC_DMA_COMPLETE 0x03 #define PI1PPC_DMA_INTERRUPTED 0x04 #define PI1PPC_DMA_ERROR 0x05 uint8_t sc_dmastat; /* Record dma state */ #define PI1PPC_PWORD_MASK 0x30 #define PI1PPC_PWORD_16 0x00 #define PI1PPC_PWORD_8 0x10 #define PI1PPC_PWORD_32 0x20 uint8_t sc_pword; /* PWord size: used for FIFO DMA transfers */ uint8_t sc_fifo; /* FIFO size */ /* Indicates number of PWords in FIFO queues that generate interrupt */ uint8_t sc_wthr; /* writeIntrThreshold */ uint8_t sc_rthr; /* readIntrThreshold */ }; #ifdef _KERNEL /* Function prototypes */ /* Soft config attach/detach routines */ void pi1ppc_sc_attach(struct pi1ppc_softc *); int pi1ppc_sc_detach(struct pi1ppc_softc *, int); /* Detection routines */ int pi1ppc_detect_port(bus_space_tag_t, bus_space_handle_t); /* Interrupt handler for pi1ppc device */ int pi1ppcintr(void *); #endif /* _KERNEL */ #endif /* __PI1PPCVAR_H */