1 /*        $NetBSD: ncr5380var.h,v 1.34 2018/01/24 09:04:45 skrll 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 hnadle */
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