Home | History | Annotate | Line # | Download | only in ic
      1 /*	$NetBSD: ncr5380var.h,v 1.35 2025/09/14 14:24:12 andvar Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 1995 David Jones, Gordon W. Ross
      5  * Copyright (c) 1994 Jarle Greipsland
      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 authors may not be used to endorse or promote products
     17  *    derived from this software without specific prior written permission.
     18  * 4. All advertising materials mentioning features or use of this software
     19  *    must display the following acknowledgement:
     20  *      This product includes software developed by
     21  *      David Jones and Gordon Ross
     22  *
     23  * THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
     24  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
     25  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
     26  * IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
     27  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
     28  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     29  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     30  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     31  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
     32  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     33  */
     34 
     35 /*
     36  * This file defines the interface between the machine-dependent
     37  * module and the machine-independent ncr5380sbc.c module.
     38  */
     39 
     40 /*
     41  * Currently amd64, alpha, i386, mips, news68k, sparc, sun2, and vax
     42  * use real bus space:
     43  *	acorn32: csa driver; easy to convert
     44  *	mac68k: sbc driver; easy to convert
     45  *	pc532: ncr driver; need bus.h first
     46  *	sun3: si driver; need bus.h first
     47  */
     48 #if \
     49     defined(__alpha__) || \
     50     defined(__amd64__) || \
     51     defined(__i386__) || \
     52     defined(__mips__) || \
     53     defined(news68k) || \
     54     defined(__sparc__) || \
     55     defined(sun2) || \
     56     defined(__vax__)
     57 # define NCR5380_USE_BUS_SPACE
     58 #endif
     59 
     60 /*
     61  * Handy read/write macros
     62  */
     63 #ifdef NCR5380_USE_BUS_SPACE
     64 # include <sys/bus.h>
     65 /* bus_space() variety */
     66 # define NCR5380_READ(sc, reg)		bus_space_read_1(sc->sc_regt, \
     67 					    sc->sc_regh, sc->reg)
     68 # define NCR5380_WRITE(sc, reg, val)	bus_space_write_1(sc->sc_regt, \
     69 					    sc->sc_regh, sc->reg, val)
     70 #else
     71 /* legacy memory-mapped variety */
     72 # define NCR5380_READ(sc, reg)		(*sc->reg)
     73 # define NCR5380_WRITE(sc, reg, val)	do { *(sc->reg) = val; } while (0)
     74 #endif
     75 
     76 #define SCI_CLR_INTR(sc)	NCR5380_READ(sc, sci_iack)
     77 #define	SCI_BUSY(sc)		(NCR5380_READ(sc, sci_bus_csr) & SCI_BUS_BSY)
     78 
     79 /* These are NOT artibtrary, but map to bits in sci_tcmd */
     80 #define PHASE_DATA_OUT	0x0
     81 #define PHASE_DATA_IN	0x1
     82 #define PHASE_COMMAND	0x2
     83 #define PHASE_STATUS	0x3
     84 #define PHASE_UNSPEC1	0x4
     85 #define PHASE_UNSPEC2	0x5
     86 #define PHASE_MSG_OUT	0x6
     87 #define PHASE_MSG_IN	0x7
     88 
     89 /*
     90  * This illegal phase is used to prevent the 5380 from having
     91  * a phase-match condition when we don't want one, such as
     92  * when setting up the DMA engine or whatever...
     93  */
     94 #define PHASE_INVALID	PHASE_UNSPEC1
     95 
     96 
     97 /* Per-request state.  This is required in order to support reselection. */
     98 struct sci_req {
     99 	struct		scsipi_xfer *sr_xs;	/* Pointer to xfer struct, NULL=unused */
    100 	int		sr_target, sr_lun;	/* For fast access */
    101 	void		*sr_dma_hand;		/* Current DMA handle */
    102 	uint8_t		*sr_dataptr;		/* Saved data pointer */
    103 	int		sr_datalen;
    104 	int		sr_flags;		/* Internal error code */
    105 #define	SR_IMMED			1	/* Immediate command */
    106 #define	SR_SENSE			2	/* We are getting sense */
    107 #define	SR_OVERDUE			4	/* Timeout while not current */
    108 #define	SR_ERROR			8	/* Error occurred */
    109 	int		sr_status;		/* Status code from last cmd */
    110 };
    111 #define	SCI_OPENINGS	16		/* How many commands we can enqueue. */
    112 
    113 
    114 struct ncr5380_softc {
    115 	device_t		sc_dev;
    116 	struct scsipi_adapter	sc_adapter;
    117 	struct scsipi_channel	sc_channel;
    118 
    119 #ifdef NCR5380_USE_BUS_SPACE
    120 	/* Pointers to bus_space */
    121 	bus_space_tag_t 	sc_regt;
    122 	bus_space_handle_t 	sc_regh;
    123 
    124 	/* Pointers to 5380 registers.  */
    125 	bus_size_t	sci_r0;
    126 	bus_size_t	sci_r1;
    127 	bus_size_t	sci_r2;
    128 	bus_size_t	sci_r3;
    129 	bus_size_t	sci_r4;
    130 	bus_size_t	sci_r5;
    131 	bus_size_t	sci_r6;
    132 	bus_size_t	sci_r7;
    133 #else
    134 	/* Pointers to 5380 registers.  See ncr5380reg.h */
    135 	volatile uint8_t *sci_r0;
    136 	volatile uint8_t *sci_r1;
    137 	volatile uint8_t *sci_r2;
    138 	volatile uint8_t *sci_r3;
    139 	volatile uint8_t *sci_r4;
    140 	volatile uint8_t *sci_r5;
    141 	volatile uint8_t *sci_r6;
    142 	volatile uint8_t *sci_r7;
    143 #endif
    144 
    145 	/* Functions set from MD code */
    146 	int		(*sc_pio_out)(struct ncr5380_softc *,
    147 					   int, int, uint8_t *);
    148 	int		(*sc_pio_in)(struct ncr5380_softc *,
    149 					  int, int, uint8_t *);
    150 	void		(*sc_dma_alloc)(struct ncr5380_softc *);
    151 	void		(*sc_dma_free)(struct ncr5380_softc *);
    152 
    153 	void		(*sc_dma_setup)(struct ncr5380_softc *);
    154 	void		(*sc_dma_start)(struct ncr5380_softc *);
    155 	void		(*sc_dma_poll)(struct ncr5380_softc *);
    156 	void		(*sc_dma_eop)(struct ncr5380_softc *);
    157 	void		(*sc_dma_stop)(struct ncr5380_softc *);
    158 
    159 	void		(*sc_intr_on)(struct ncr5380_softc *);
    160 	void		(*sc_intr_off)(struct ncr5380_softc *);
    161 
    162 	int		sc_flags;	/* Misc. flags and capabilities */
    163 #define	NCR5380_FORCE_POLLING	1	/* Do not use interrupts. */
    164 
    165 	/* Set bits in this to disable disconnect per-target. */
    166 	int 	sc_no_disconnect;
    167 
    168 	/* Set bits in this to disable parity for some target. */
    169 	int		sc_parity_disable;
    170 
    171 	int 	sc_min_dma_len;	/* Smaller than this is done with PIO */
    172 
    173 	/* Begin MI shared data */
    174 
    175 	int		sc_state;
    176 #define	NCR_IDLE		   0	/* Ready for new work. */
    177 #define NCR_WORKING 	0x01	/* Some command is in progress. */
    178 #define	NCR_ABORTING	0x02	/* Bailing out */
    179 #define NCR_DOINGDMA	0x04	/* The FIFO data path is active! */
    180 #define NCR_DROP_MSGIN	0x10	/* Discard all msgs (parity err detected) */
    181 
    182 	/* The request that has the bus now. */
    183 	struct		sci_req *sc_current;
    184 
    185 	/* Active data pointer for current SCSI command. */
    186 	uint8_t		*sc_dataptr;
    187 	int		sc_datalen;
    188 
    189 	/* Begin MI private data */
    190 
    191 	/* The number of operations in progress on the bus */
    192 	volatile int	sc_ncmds;
    193 
    194 	/* Ring buffer of pending/active requests */
    195 	struct		sci_req sc_ring[SCI_OPENINGS];
    196 	int		sc_rr;		/* Round-robin scan pointer */
    197 
    198 	/* Active requests, by target/LUN */
    199 	struct		sci_req *sc_matrix[8][8];
    200 
    201 	/* Message stuff */
    202 	int	sc_prevphase;
    203 
    204 	u_int	sc_msgpriq;	/* Messages we want to send */
    205 	u_int	sc_msgoutq;	/* Messages sent during last MESSAGE OUT */
    206 	u_int	sc_msgout;	/* Message last transmitted */
    207 #define SEND_DEV_RESET		0x01
    208 #define SEND_PARITY_ERROR	0x02
    209 #define SEND_ABORT		0x04
    210 #define SEND_REJECT		0x08
    211 #define SEND_INIT_DET_ERR	0x10
    212 #define SEND_IDENTIFY  		0x20
    213 #define SEND_SDTR		0x40
    214 #define	SEND_WDTR		0x80
    215 #define NCR_MAX_MSG_LEN 8
    216 	uint8_t  sc_omess[NCR_MAX_MSG_LEN];
    217 	uint8_t	*sc_omp;		/* Outgoing message pointer */
    218 	uint8_t	sc_imess[NCR_MAX_MSG_LEN];
    219 	uint8_t	*sc_imp;		/* Incoming message pointer */
    220 	int	sc_rev;			/* Chip revision */
    221 #define NCR_VARIANT_NCR5380	0
    222 #define NCR_VARIANT_DP8490	1
    223 #define NCR_VARIANT_NCR53C400	2
    224 #define NCR_VARIANT_PAS16	3
    225 #define NCR_VARIANT_CXD1180	4
    226 
    227 };
    228 
    229 void	ncr5380_attach(struct ncr5380_softc *);
    230 int	ncr5380_detach(struct ncr5380_softc *, int);
    231 int 	ncr5380_intr(void *);
    232 void	ncr5380_scsipi_request(struct scsipi_channel *,
    233 	    scsipi_adapter_req_t, void *);
    234 int 	ncr5380_pio_in(struct ncr5380_softc *, int, int, uint8_t *);
    235 int 	ncr5380_pio_out(struct ncr5380_softc *, int, int, uint8_t *);
    236 void	ncr5380_init(struct ncr5380_softc *);
    237 
    238 #ifdef	NCR5380_DEBUG
    239 extern struct ncr5380_softc *ncr5380_debug_sc;
    240 void ncr5380_trace(const char *msg, long val);
    241 #define	NCR_TRACE(msg, val) ncr5380_trace(msg, val)
    242 #else	/* NCR5380_DEBUG */
    243 #define	NCR_TRACE(msg, val)	/* nada */
    244 #endif	/* NCR5380_DEBUG */
    245