1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3 * linux/drivers/acorn/scsi/fas216.h
4 *
5 * Copyright (C) 1997-2000 Russell King
6 *
7 * FAS216 generic driver
8 */
9 #ifndef FAS216_H
10 #define FAS216_H
11
12 #include <scsi/scsi_eh.h>
13
14 #include "queue.h"
15 #include "msgqueue.h"
16
17 /* FAS register definitions */
18
19 /* transfer count low */
20 #define REG_CTCL (0)
21 #define REG_STCL (0)
22
23 /* transfer count medium */
24 #define REG_CTCM (1)
25 #define REG_STCM (1)
26
27 /* fifo data */
28 #define REG_FF (2)
29
30 /* command */
31 #define REG_CMD (3)
32 #define CMD_NOP 0x00
33 #define CMD_FLUSHFIFO 0x01
34 #define CMD_RESETCHIP 0x02
35 #define CMD_RESETSCSI 0x03
36
37 #define CMD_TRANSFERINFO 0x10
38 #define CMD_INITCMDCOMPLETE 0x11
39 #define CMD_MSGACCEPTED 0x12
40 #define CMD_PADBYTES 0x18
41 #define CMD_SETATN 0x1a
42 #define CMD_RSETATN 0x1b
43
44 #define CMD_SELECTWOATN 0x41
45 #define CMD_SELECTATN 0x42
46 #define CMD_SELECTATNSTOP 0x43
47 #define CMD_ENABLESEL 0x44
48 #define CMD_DISABLESEL 0x45
49 #define CMD_SELECTATN3 0x46
50 #define CMD_RESEL3 0x47
51
52 #define CMD_WITHDMA 0x80
53
54 /* status register (read) */
55 #define REG_STAT (4)
56 #define STAT_IO (1 << 0) /* IO phase */
57 #define STAT_CD (1 << 1) /* CD phase */
58 #define STAT_MSG (1 << 2) /* MSG phase */
59 #define STAT_TRANSFERDONE (1 << 3) /* Transfer completed */
60 #define STAT_TRANSFERCNTZ (1 << 4) /* Transfer counter is zero */
61 #define STAT_PARITYERROR (1 << 5) /* Parity error */
62 #define STAT_REALBAD (1 << 6) /* Something bad */
63 #define STAT_INT (1 << 7) /* Interrupt */
64
65 #define STAT_BUSMASK (STAT_MSG|STAT_CD|STAT_IO)
66 #define STAT_DATAOUT (0) /* Data out */
67 #define STAT_DATAIN (STAT_IO) /* Data in */
68 #define STAT_COMMAND (STAT_CD) /* Command out */
69 #define STAT_STATUS (STAT_CD|STAT_IO) /* Status In */
70 #define STAT_MESGOUT (STAT_MSG|STAT_CD) /* Message out */
71 #define STAT_MESGIN (STAT_MSG|STAT_CD|STAT_IO) /* Message In */
72
73 /* bus ID for select / reselect */
74 #define REG_SDID (4)
75 #define BUSID(target) ((target) & 7)
76
77 /* Interrupt status register (read) */
78 #define REG_INST (5)
79 #define INST_SELWOATN (1 << 0) /* Select w/o ATN */
80 #define INST_SELATN (1 << 1) /* Select w/ATN */
81 #define INST_RESELECTED (1 << 2) /* Reselected */
82 #define INST_FUNCDONE (1 << 3) /* Function done */
83 #define INST_BUSSERVICE (1 << 4) /* Bus service */
84 #define INST_DISCONNECT (1 << 5) /* Disconnect */
85 #define INST_ILLEGALCMD (1 << 6) /* Illegal command */
86 #define INST_BUSRESET (1 << 7) /* SCSI Bus reset */
87
88 /* Timeout register (write) */
89 #define REG_STIM (5)
90
91 /* Sequence step register (read) */
92 #define REG_IS (6)
93 #define IS_BITS 0x07
94 #define IS_SELARB 0x00 /* Select & Arb ok */
95 #define IS_MSGBYTESENT 0x01 /* One byte message sent*/
96 #define IS_NOTCOMMAND 0x02 /* Not in command state */
97 #define IS_EARLYPHASE 0x03 /* Early phase change */
98 #define IS_COMPLETE 0x04 /* Command ok */
99 #define IS_SOF 0x08 /* Sync off flag */
100
101 /* Transfer period step (write) */
102 #define REG_STP (6)
103
104 /* Synchronous Offset (write) */
105 #define REG_SOF (7)
106
107 /* Fifo state register (read) */
108 #define REG_CFIS (7)
109 #define CFIS_CF 0x1f /* Num bytes in FIFO */
110 #define CFIS_IS 0xe0 /* Step */
111
112 /* config register 1 */
113 #define REG_CNTL1 (8)
114 #define CNTL1_CID (7 << 0) /* Chip ID */
115 #define CNTL1_STE (1 << 3) /* Self test enable */
116 #define CNTL1_PERE (1 << 4) /* Parity enable reporting en. */
117 #define CNTL1_PTE (1 << 5) /* Parity test enable */
118 #define CNTL1_DISR (1 << 6) /* Disable Irq on SCSI reset */
119 #define CNTL1_ETM (1 << 7) /* Extended Timing Mode */
120
121 /* Clock conversion factor (read) */
122 #define REG_CLKF (9)
123 #define CLKF_F37MHZ 0x00 /* 35.01 - 40 MHz */
124 #define CLKF_F10MHZ 0x02 /* 10 MHz */
125 #define CLKF_F12MHZ 0x03 /* 10.01 - 15 MHz */
126 #define CLKF_F17MHZ 0x04 /* 15.01 - 20 MHz */
127 #define CLKF_F22MHZ 0x05 /* 20.01 - 25 MHz */
128 #define CLKF_F27MHZ 0x06 /* 25.01 - 30 MHz */
129 #define CLKF_F32MHZ 0x07 /* 30.01 - 35 MHz */
130
131 /* Chip test register (write) */
132 #define REG_FTM (10)
133 #define TEST_FTM 0x01 /* Force target mode */
134 #define TEST_FIM 0x02 /* Force initiator mode */
135 #define TEST_FHI 0x04 /* Force high impedance mode */
136
137 /* Configuration register 2 (read/write) */
138 #define REG_CNTL2 (11)
139 #define CNTL2_PGDP (1 << 0) /* Pass Th/Generate Data Parity */
140 #define CNTL2_PGRP (1 << 1) /* Pass Th/Generate Reg Parity */
141 #define CNTL2_ACDPE (1 << 2) /* Abort on Cmd/Data Parity Err */
142 #define CNTL2_S2FE (1 << 3) /* SCSI2 Features Enable */
143 #define CNTL2_TSDR (1 << 4) /* Tristate DREQ */
144 #define CNTL2_SBO (1 << 5) /* Select Byte Order */
145 #define CNTL2_ENF (1 << 6) /* Enable features */
146 #define CNTL2_DAE (1 << 7) /* Data Alignment Enable */
147
148 /* Configuration register 3 (read/write) */
149 #define REG_CNTL3 (12)
150 #define CNTL3_BS8 (1 << 0) /* Burst size 8 */
151 #define CNTL3_MDM (1 << 1) /* Modify DMA mode */
152 #define CNTL3_LBTM (1 << 2) /* Last Byte Transfer mode */
153 #define CNTL3_FASTCLK (1 << 3) /* Fast SCSI clocking */
154 #define CNTL3_FASTSCSI (1 << 4) /* Fast SCSI */
155 #define CNTL3_G2CB (1 << 5) /* Group2 SCSI support */
156 #define CNTL3_QTAG (1 << 6) /* Enable 3 byte msgs */
157 #define CNTL3_ADIDCHK (1 << 7) /* Additional ID check */
158
159 /* High transfer count (read/write) */
160 #define REG_CTCH (14)
161 #define REG_STCH (14)
162
163 /* ID register (read only) */
164 #define REG_ID (14)
165
166 /* Data alignment */
167 #define REG_DAL (15)
168
169 typedef enum {
170 PHASE_IDLE, /* we're not planning on doing anything */
171 PHASE_SELECTION, /* selecting a device */
172 PHASE_SELSTEPS, /* selection with command steps */
173 PHASE_COMMAND, /* command sent */
174 PHASE_MESSAGESENT, /* selected, and we're sending cmd */
175 PHASE_DATAOUT, /* data out to device */
176 PHASE_DATAIN, /* data in from device */
177 PHASE_MSGIN, /* message in from device */
178 PHASE_MSGIN_DISCONNECT, /* disconnecting from bus */
179 PHASE_MSGOUT, /* after message out phase */
180 PHASE_MSGOUT_EXPECT, /* expecting message out */
181 PHASE_STATUS, /* status from device */
182 PHASE_DONE /* Command complete */
183 } phase_t;
184
185 typedef enum {
186 DMA_OUT, /* DMA from memory to chip */
187 DMA_IN /* DMA from chip to memory */
188 } fasdmadir_t;
189
190 typedef enum {
191 fasdma_none, /* No dma */
192 fasdma_pio, /* PIO mode */
193 fasdma_pseudo, /* Pseudo DMA */
194 fasdma_real_block, /* Real DMA, on block by block basis */
195 fasdma_real_all /* Real DMA, on request by request */
196 } fasdmatype_t;
197
198 typedef enum {
199 neg_wait, /* Negotiate with device */
200 neg_inprogress, /* Negotiation sent */
201 neg_complete, /* Negotiation complete */
202 neg_targcomplete, /* Target completed negotiation */
203 neg_invalid /* Negotiation not supported */
204 } neg_t;
205
206 #define MAGIC 0x441296bdUL
207 #define NR_MSGS 8
208
209 #define FASCAP_DMA (1 << 0)
210 #define FASCAP_PSEUDODMA (1 << 1)
211
212 typedef struct {
213 unsigned long magic_start;
214 spinlock_t host_lock;
215 struct Scsi_Host *host; /* host */
216 struct scsi_cmnd *SCpnt; /* currently processing command */
217 struct scsi_cmnd *origSCpnt; /* original connecting command */
218 struct scsi_cmnd *reqSCpnt; /* request sense command */
219 struct scsi_cmnd *rstSCpnt; /* reset command */
220 struct scsi_cmnd *pending_SCpnt[8]; /* per-device pending commands */
221 int next_pending; /* next pending device */
222
223 /*
224 * Error recovery
225 */
226 wait_queue_head_t eh_wait;
227 struct timer_list eh_timer;
228 unsigned int rst_dev_status;
229 unsigned int rst_bus_status;
230
231 /* driver information */
232 struct {
233 phase_t phase; /* current phase */
234 void __iomem *io_base; /* iomem base of FAS216 */
235 unsigned int io_shift; /* shift to adjust reg offsets by */
236 unsigned char cfg[4]; /* configuration registers */
237 const char *type; /* chip type */
238 unsigned int irq; /* interrupt */
239 int dma; /* dma channel */
240
241 struct scsi_pointer SCp; /* current commands data pointer */
242
243 MsgQueue_t msgs; /* message queue for connected device */
244
245 unsigned int async_stp; /* Async transfer STP value */
246 unsigned char msgin_fifo; /* bytes in fifo at time of message in */
247 unsigned char message[256]; /* last message received from device */
248
249 unsigned char disconnectable:1; /* this command can be disconnected */
250 unsigned char aborting:1; /* aborting command */
251 } scsi;
252
253 /* statistics information */
254 struct {
255 unsigned int queues;
256 unsigned int removes;
257 unsigned int fins;
258 unsigned int reads;
259 unsigned int writes;
260 unsigned int miscs;
261 unsigned int disconnects;
262 unsigned int aborts;
263 unsigned int bus_resets;
264 unsigned int host_resets;
265 } stats;
266
267 /* configuration information */
268 struct {
269 unsigned char clockrate; /* clock rate of FAS device (MHz) */
270 unsigned char select_timeout; /* timeout (R5) */
271 unsigned char sync_max_depth; /* Synchronous xfer max fifo depth */
272 unsigned char wide_max_size; /* Maximum wide transfer size */
273 unsigned char cntl3; /* Control Reg 3 */
274 unsigned int asyncperiod; /* Async transfer period (ns) */
275 unsigned int capabilities; /* driver capabilities */
276 unsigned int disconnect_ok:1; /* Disconnects allowed? */
277 } ifcfg;
278
279 /* queue handling */
280 struct {
281 Queue_t issue; /* issue queue */
282 Queue_t disconnected; /* disconnected command queue */
283 } queues;
284
285 /* per-device info */
286 struct fas216_device {
287 unsigned char disconnect_ok:1; /* device can disconnect */
288 unsigned char parity_enabled:1; /* parity checking enabled */
289 unsigned char parity_check:1; /* need to check parity checking */
290 unsigned char period; /* sync xfer period in (*4ns) */
291 unsigned char stp; /* synchronous transfer period */
292 unsigned char sof; /* synchronous offset register */
293 unsigned char wide_xfer; /* currently negociated wide transfer */
294 neg_t sync_state; /* synchronous transfer mode */
295 neg_t wide_state; /* wide transfer mode */
296 } device[8];
297 unsigned long busyluns[64/sizeof(unsigned long)];/* array of bits indicating LUNs busy */
298
299 /* dma */
300 struct {
301 fasdmatype_t transfer_type; /* current type of DMA transfer */
302 fasdmatype_t (*setup) (struct Scsi_Host *host, struct scsi_pointer *SCp, fasdmadir_t direction, fasdmatype_t min_dma);
303 void (*pseudo)(struct Scsi_Host *host, struct scsi_pointer *SCp, fasdmadir_t direction, int transfer);
304 void (*stop) (struct Scsi_Host *host, struct scsi_pointer *SCp);
305 } dma;
306
307 /* miscellaneous */
308 int internal_done; /* flag to indicate request done */
309 struct scsi_eh_save ses; /* holds request sense restore info */
310 unsigned long magic_end;
311 } FAS216_Info;
312
313 /* driver-private data per SCSI command. */
314 struct fas216_cmd_priv {
315 /*
316 * @scsi_pointer must be the first member. See also arm_scsi_pointer().
317 */
318 struct scsi_pointer scsi_pointer;
319 void (*scsi_done)(struct scsi_cmnd *cmd);
320 };
321
fas216_cmd_priv(struct scsi_cmnd * cmd)322 static inline struct fas216_cmd_priv *fas216_cmd_priv(struct scsi_cmnd *cmd)
323 {
324 return scsi_cmd_priv(cmd);
325 }
326
327 /* Function: int fas216_init (struct Scsi_Host *instance)
328 * Purpose : initialise FAS/NCR/AMD SCSI structures.
329 * Params : instance - a driver-specific filled-out structure
330 * Returns : 0 on success
331 */
332 extern int fas216_init (struct Scsi_Host *instance);
333
334 /* Function: int fas216_add (struct Scsi_Host *instance, struct device *dev)
335 * Purpose : initialise FAS/NCR/AMD SCSI ic.
336 * Params : instance - a driver-specific filled-out structure
337 * Returns : 0 on success
338 */
339 extern int fas216_add (struct Scsi_Host *instance, struct device *dev);
340
341 /* Function: int fas216_queue_command(struct Scsi_Host *h, struct scsi_cmnd *SCpnt)
342 * Purpose : queue a command for adapter to process.
343 * Params : h - host adapter
344 * : SCpnt - Command to queue
345 * Returns : 0 - success, else error
346 */
347 extern int fas216_queue_command(struct Scsi_Host *h, struct scsi_cmnd *SCpnt);
348
349 /* Function: int fas216_noqueue_command(struct Scsi_Host *h, struct scsi_cmnd *SCpnt)
350 * Purpose : queue a command for adapter to process, and process it to completion.
351 * Params : h - host adapter
352 * : SCpnt - Command to queue
353 * Returns : 0 - success, else error
354 */
355 extern int fas216_noqueue_command(struct Scsi_Host *, struct scsi_cmnd *);
356
357 /* Function: irqreturn_t fas216_intr (FAS216_Info *info)
358 * Purpose : handle interrupts from the interface to progress a command
359 * Params : info - interface to service
360 */
361 extern irqreturn_t fas216_intr (FAS216_Info *info);
362
363 extern void fas216_remove (struct Scsi_Host *instance);
364
365 /* Function: void fas216_release (struct Scsi_Host *instance)
366 * Purpose : release all resources and put everything to bed for FAS/NCR/AMD SCSI ic.
367 * Params : instance - a driver-specific filled-out structure
368 * Returns : 0 on success
369 */
370 extern void fas216_release (struct Scsi_Host *instance);
371
372 extern void fas216_print_host(FAS216_Info *info, struct seq_file *m);
373 extern void fas216_print_stats(FAS216_Info *info, struct seq_file *m);
374 extern void fas216_print_devices(FAS216_Info *info, struct seq_file *m);
375
376 /* Function: int fas216_eh_abort(struct scsi_cmnd *SCpnt)
377 * Purpose : abort this command
378 * Params : SCpnt - command to abort
379 * Returns : FAILED if unable to abort
380 */
381 extern int fas216_eh_abort(struct scsi_cmnd *SCpnt);
382
383 /* Function: int fas216_eh_device_reset(struct scsi_cmnd *SCpnt)
384 * Purpose : Reset the device associated with this command
385 * Params : SCpnt - command specifing device to reset
386 * Returns : FAILED if unable to reset
387 */
388 extern int fas216_eh_device_reset(struct scsi_cmnd *SCpnt);
389
390 /* Function: int fas216_eh_bus_reset(struct scsi_cmnd *SCpnt)
391 * Purpose : Reset the complete bus associated with this command
392 * Params : SCpnt - command specifing bus to reset
393 * Returns : FAILED if unable to reset
394 */
395 extern int fas216_eh_bus_reset(struct scsi_cmnd *SCpnt);
396
397 /* Function: int fas216_eh_host_reset(struct scsi_cmnd *SCpnt)
398 * Purpose : Reset the host associated with this command
399 * Params : SCpnt - command specifing host to reset
400 * Returns : FAILED if unable to reset
401 */
402 extern int fas216_eh_host_reset(struct scsi_cmnd *SCpnt);
403
404 #endif /* FAS216_H */
405