• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * NCR 5380 defines
3  *
4  * Copyright 1993, Drew Eckhardt
5  *	Visionary Computing
6  *	(Unix consulting and custom programming)
7  * 	drew@colorado.edu
8  *      +1 (303) 666-5836
9  *
10  * For more information, please consult
11  *
12  * NCR 5380 Family
13  * SCSI Protocol Controller
14  * Databook
15  * NCR Microelectronics
16  * 1635 Aeroplaza Drive
17  * Colorado Springs, CO 80916
18  * 1+ (719) 578-3400
19  * 1+ (800) 334-5454
20  */
21 
22 #ifndef NCR5380_H
23 #define NCR5380_H
24 
25 #include <linux/delay.h>
26 #include <linux/interrupt.h>
27 #include <linux/list.h>
28 #include <linux/workqueue.h>
29 #include <scsi/scsi_dbg.h>
30 #include <scsi/scsi_eh.h>
31 #include <scsi/scsi_transport_spi.h>
32 
33 #define NDEBUG_ARBITRATION	0x1
34 #define NDEBUG_AUTOSENSE	0x2
35 #define NDEBUG_DMA		0x4
36 #define NDEBUG_HANDSHAKE	0x8
37 #define NDEBUG_INFORMATION	0x10
38 #define NDEBUG_INIT		0x20
39 #define NDEBUG_INTR		0x40
40 #define NDEBUG_LINKED		0x80
41 #define NDEBUG_MAIN		0x100
42 #define NDEBUG_NO_DATAOUT	0x200
43 #define NDEBUG_NO_WRITE		0x400
44 #define NDEBUG_PIO		0x800
45 #define NDEBUG_PSEUDO_DMA	0x1000
46 #define NDEBUG_QUEUES		0x2000
47 #define NDEBUG_RESELECTION	0x4000
48 #define NDEBUG_SELECTION	0x8000
49 #define NDEBUG_USLEEP		0x10000
50 #define NDEBUG_LAST_BYTE_SENT	0x20000
51 #define NDEBUG_RESTART_SELECT	0x40000
52 #define NDEBUG_EXTENDED		0x80000
53 #define NDEBUG_C400_PREAD	0x100000
54 #define NDEBUG_C400_PWRITE	0x200000
55 #define NDEBUG_LISTS		0x400000
56 #define NDEBUG_ABORT		0x800000
57 #define NDEBUG_TAGS		0x1000000
58 #define NDEBUG_MERGING		0x2000000
59 
60 #define NDEBUG_ANY		0xFFFFFFFFUL
61 
62 /*
63  * The contents of the OUTPUT DATA register are asserted on the bus when
64  * either arbitration is occurring or the phase-indicating signals (
65  * IO, CD, MSG) in the TARGET COMMAND register and the ASSERT DATA
66  * bit in the INITIATOR COMMAND register is set.
67  */
68 
69 #define OUTPUT_DATA_REG         0	/* wo DATA lines on SCSI bus */
70 #define CURRENT_SCSI_DATA_REG   0	/* ro same */
71 
72 #define INITIATOR_COMMAND_REG	1	/* rw */
73 #define ICR_ASSERT_RST		0x80	/* rw Set to assert RST  */
74 #define ICR_ARBITRATION_PROGRESS 0x40	/* ro Indicates arbitration complete */
75 #define ICR_TRI_STATE		0x40	/* wo Set to tri-state drivers */
76 #define ICR_ARBITRATION_LOST	0x20	/* ro Indicates arbitration lost */
77 #define ICR_DIFF_ENABLE		0x20	/* wo Set to enable diff. drivers */
78 #define ICR_ASSERT_ACK		0x10	/* rw ini Set to assert ACK */
79 #define ICR_ASSERT_BSY		0x08	/* rw Set to assert BSY */
80 #define ICR_ASSERT_SEL 		0x04	/* rw Set to assert SEL */
81 #define ICR_ASSERT_ATN		0x02	/* rw Set to assert ATN */
82 #define ICR_ASSERT_DATA		0x01	/* rw SCSI_DATA_REG is asserted */
83 
84 #ifdef DIFFERENTIAL
85 #define ICR_BASE		ICR_DIFF_ENABLE
86 #else
87 #define ICR_BASE		0
88 #endif
89 
90 #define MODE_REG		2
91 /*
92  * Note : BLOCK_DMA code will keep DRQ asserted for the duration of the
93  * transfer, causing the chip to hog the bus.  You probably don't want
94  * this.
95  */
96 #define MR_BLOCK_DMA_MODE	0x80	/* rw block mode DMA */
97 #define MR_TARGET		0x40	/* rw target mode */
98 #define MR_ENABLE_PAR_CHECK	0x20	/* rw enable parity checking */
99 #define MR_ENABLE_PAR_INTR	0x10	/* rw enable bad parity interrupt */
100 #define MR_ENABLE_EOP_INTR	0x08	/* rw enable eop interrupt */
101 #define MR_MONITOR_BSY		0x04	/* rw enable int on unexpected bsy fail */
102 #define MR_DMA_MODE		0x02	/* rw DMA / pseudo DMA mode */
103 #define MR_ARBITRATE		0x01	/* rw start arbitration */
104 
105 #ifdef PARITY
106 #define MR_BASE			MR_ENABLE_PAR_CHECK
107 #else
108 #define MR_BASE			0
109 #endif
110 
111 #define TARGET_COMMAND_REG	3
112 #define TCR_LAST_BYTE_SENT	0x80	/* ro DMA done */
113 #define TCR_ASSERT_REQ		0x08	/* tgt rw assert REQ */
114 #define TCR_ASSERT_MSG		0x04	/* tgt rw assert MSG */
115 #define TCR_ASSERT_CD		0x02	/* tgt rw assert CD */
116 #define TCR_ASSERT_IO		0x01	/* tgt rw assert IO */
117 
118 #define STATUS_REG		4	/* ro */
119 /*
120  * Note : a set bit indicates an active signal, driven by us or another
121  * device.
122  */
123 #define SR_RST			0x80
124 #define SR_BSY			0x40
125 #define SR_REQ			0x20
126 #define SR_MSG			0x10
127 #define SR_CD			0x08
128 #define SR_IO			0x04
129 #define SR_SEL			0x02
130 #define SR_DBP			0x01
131 
132 /*
133  * Setting a bit in this register will cause an interrupt to be generated when
134  * BSY is false and SEL true and this bit is asserted  on the bus.
135  */
136 #define SELECT_ENABLE_REG	4	/* wo */
137 
138 #define BUS_AND_STATUS_REG	5	/* ro */
139 #define BASR_END_DMA_TRANSFER	0x80	/* ro set on end of transfer */
140 #define BASR_DRQ		0x40	/* ro mirror of DRQ pin */
141 #define BASR_PARITY_ERROR	0x20	/* ro parity error detected */
142 #define BASR_IRQ		0x10	/* ro mirror of IRQ pin */
143 #define BASR_PHASE_MATCH	0x08	/* ro Set when MSG CD IO match TCR */
144 #define BASR_BUSY_ERROR		0x04	/* ro Unexpected change to inactive state */
145 #define BASR_ATN 		0x02	/* ro BUS status */
146 #define BASR_ACK		0x01	/* ro BUS status */
147 
148 /* Write any value to this register to start a DMA send */
149 #define START_DMA_SEND_REG	5	/* wo */
150 
151 /*
152  * Used in DMA transfer mode, data is latched from the SCSI bus on
153  * the falling edge of REQ (ini) or ACK (tgt)
154  */
155 #define INPUT_DATA_REG			6	/* ro */
156 
157 /* Write any value to this register to start a DMA receive */
158 #define START_DMA_TARGET_RECEIVE_REG	6	/* wo */
159 
160 /* Read this register to clear interrupt conditions */
161 #define RESET_PARITY_INTERRUPT_REG	7	/* ro */
162 
163 /* Write any value to this register to start an ini mode DMA receive */
164 #define START_DMA_INITIATOR_RECEIVE_REG 7	/* wo */
165 
166 /* NCR 53C400(A) Control Status Register bits: */
167 #define CSR_RESET              0x80	/* wo  Resets 53c400 */
168 #define CSR_53C80_REG          0x80	/* ro  5380 registers busy */
169 #define CSR_TRANS_DIR          0x40	/* rw  Data transfer direction */
170 #define CSR_SCSI_BUFF_INTR     0x20	/* rw  Enable int on transfer ready */
171 #define CSR_53C80_INTR         0x10	/* rw  Enable 53c80 interrupts */
172 #define CSR_SHARED_INTR        0x08	/* rw  Interrupt sharing */
173 #define CSR_HOST_BUF_NOT_RDY   0x04	/* ro  Is Host buffer ready */
174 #define CSR_SCSI_BUF_RDY       0x02	/* ro  SCSI buffer read */
175 #define CSR_GATED_53C80_IRQ    0x01	/* ro  Last block xferred */
176 
177 #if 0
178 #define CSR_BASE CSR_SCSI_BUFF_INTR | CSR_53C80_INTR
179 #else
180 #define CSR_BASE CSR_53C80_INTR
181 #endif
182 
183 /* Note : PHASE_* macros are based on the values of the STATUS register */
184 #define PHASE_MASK 	(SR_MSG | SR_CD | SR_IO)
185 
186 #define PHASE_DATAOUT		0
187 #define PHASE_DATAIN		SR_IO
188 #define PHASE_CMDOUT		SR_CD
189 #define PHASE_STATIN		(SR_CD | SR_IO)
190 #define PHASE_MSGOUT		(SR_MSG | SR_CD)
191 #define PHASE_MSGIN		(SR_MSG | SR_CD | SR_IO)
192 #define PHASE_UNKNOWN		0xff
193 
194 /*
195  * Convert status register phase to something we can use to set phase in
196  * the target register so we can get phase mismatch interrupts on DMA
197  * transfers.
198  */
199 
200 #define PHASE_SR_TO_TCR(phase) ((phase) >> 2)
201 
202 /*
203  * These are "special" values for the irq and dma_channel fields of the
204  * Scsi_Host structure
205  */
206 
207 #define DMA_NONE	255
208 #define IRQ_AUTO	254
209 #define DMA_AUTO	254
210 #define PORT_AUTO	0xffff	/* autoprobe io port for 53c400a */
211 
212 #ifndef NO_IRQ
213 #define NO_IRQ		0
214 #endif
215 
216 #define FLAG_DMA_FIXUP			1	/* Use DMA errata workarounds */
217 #define FLAG_NO_PSEUDO_DMA		8	/* Inhibit DMA */
218 #define FLAG_LATE_DMA_SETUP		32	/* Setup NCR before DMA H/W */
219 #define FLAG_TOSHIBA_DELAY		128	/* Allow for borken CD-ROMs */
220 
221 struct NCR5380_hostdata {
222 	NCR5380_implementation_fields;		/* implementation specific */
223 	struct Scsi_Host *host;			/* Host backpointer */
224 	unsigned char id_mask, id_higher_mask;	/* 1 << id, all bits greater */
225 	unsigned char busy[8];			/* index = target, bit = lun */
226 	int dma_len;				/* requested length of DMA */
227 	unsigned char last_message;		/* last message OUT */
228 	struct scsi_cmnd *connected;		/* currently connected cmnd */
229 	struct scsi_cmnd *selecting;		/* cmnd to be connected */
230 	struct list_head unissued;		/* waiting to be issued */
231 	struct list_head autosense;		/* priority issue queue */
232 	struct list_head disconnected;		/* waiting for reconnect */
233 	spinlock_t lock;			/* protects this struct */
234 	int flags;
235 	struct scsi_eh_save ses;
236 	struct scsi_cmnd *sensing;
237 	char info[256];
238 	int read_overruns;                /* number of bytes to cut from a
239 	                                   * transfer to handle chip overruns */
240 	struct work_struct main_task;
241 	struct workqueue_struct *work_q;
242 	unsigned long accesses_per_ms;	/* chip register accesses per ms */
243 };
244 
245 #ifdef __KERNEL__
246 
247 struct NCR5380_cmd {
248 	struct list_head list;
249 };
250 
251 #define NCR5380_CMD_SIZE		(sizeof(struct NCR5380_cmd))
252 
253 #define NCR5380_PIO_CHUNK_SIZE		256
254 
NCR5380_to_scmd(struct NCR5380_cmd * ncmd_ptr)255 static inline struct scsi_cmnd *NCR5380_to_scmd(struct NCR5380_cmd *ncmd_ptr)
256 {
257 	return ((struct scsi_cmnd *)ncmd_ptr) - 1;
258 }
259 
260 #ifndef NDEBUG
261 #define NDEBUG (0)
262 #endif
263 
264 #define dprintk(flg, fmt, ...) \
265 	do { if ((NDEBUG) & (flg)) \
266 		printk(KERN_DEBUG fmt, ## __VA_ARGS__); } while (0)
267 
268 #define dsprintk(flg, host, fmt, ...) \
269 	do { if ((NDEBUG) & (flg)) \
270 		shost_printk(KERN_DEBUG, host, fmt, ## __VA_ARGS__); \
271 	} while (0)
272 
273 #if NDEBUG
274 #define NCR5380_dprint(flg, arg) \
275 	do { if ((NDEBUG) & (flg)) NCR5380_print(arg); } while (0)
276 #define NCR5380_dprint_phase(flg, arg) \
277 	do { if ((NDEBUG) & (flg)) NCR5380_print_phase(arg); } while (0)
278 static void NCR5380_print_phase(struct Scsi_Host *instance);
279 static void NCR5380_print(struct Scsi_Host *instance);
280 #else
281 #define NCR5380_dprint(flg, arg)       do {} while (0)
282 #define NCR5380_dprint_phase(flg, arg) do {} while (0)
283 #endif
284 
285 static int NCR5380_probe_irq(struct Scsi_Host *instance, int possible);
286 static int NCR5380_init(struct Scsi_Host *instance, int flags);
287 static int NCR5380_maybe_reset_bus(struct Scsi_Host *);
288 static void NCR5380_exit(struct Scsi_Host *instance);
289 static void NCR5380_information_transfer(struct Scsi_Host *instance);
290 static irqreturn_t NCR5380_intr(int irq, void *dev_id);
291 static void NCR5380_main(struct work_struct *work);
292 static const char *NCR5380_info(struct Scsi_Host *instance);
293 static void NCR5380_reselect(struct Scsi_Host *instance);
294 static struct scsi_cmnd *NCR5380_select(struct Scsi_Host *, struct scsi_cmnd *);
295 static int NCR5380_transfer_dma(struct Scsi_Host *instance, unsigned char *phase, int *count, unsigned char **data);
296 static int NCR5380_transfer_pio(struct Scsi_Host *instance, unsigned char *phase, int *count, unsigned char **data);
297 static int NCR5380_poll_politely2(struct Scsi_Host *, int, int, int, int, int, int, int);
298 
NCR5380_poll_politely(struct Scsi_Host * instance,int reg,int bit,int val,int wait)299 static inline int NCR5380_poll_politely(struct Scsi_Host *instance,
300 					int reg, int bit, int val, int wait)
301 {
302 	return NCR5380_poll_politely2(instance, reg, bit, val,
303 						reg, bit, val, wait);
304 }
305 
306 #endif				/* __KERNEL__ */
307 #endif				/* NCR5380_H */
308