summaryrefslogtreecommitdiffstats
path: root/drivers/scsi/wd33c93.h
blob: c0584037b21b17fdf565bd11c572dea455242613 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
/*
 *    wd33c93.h -  Linux device driver definitions for the
 *                 Commodore Amiga A2091/590 SCSI controller card
 *
 *    IMPORTANT: This file is for version 1.25 - 09/Jul/1997
 *
 * Copyright (c) 1996 John Shifflett, GeoLog Consulting
 *    john@geolog.com
 *    jshiffle@netcom.com
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2, or (at your option)
 * any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 */

#ifndef WD33C93_H
#define WD33C93_H

#include <linux/config.h>

#define PROC_INTERFACE     /* add code for /proc/scsi/wd33c93/xxx interface */
#ifdef  PROC_INTERFACE
#define PROC_STATISTICS    /* add code for keeping various real time stats */
#endif

#define SYNC_DEBUG         /* extra info on sync negotiation printed */
#define DEBUGGING_ON       /* enable command-line debugging bitmask */
#define DEBUG_DEFAULTS 0   /* default debugging bitmask */


#define ILLEGAL_STATUS_BYTE   0xff

#ifdef DEBUGGING_ON
#define DB(f,a) if (hostdata->args & (f)) a;
#else
#define DB(f,a)
#endif

#define uchar unsigned char

/* WD register names. */
#define WD_OWN_ID                0x00 /* Own ID register        */
#define WD_CONTROL               0x01 /* Control bits           */
#define WD_TIMEOUT_PERIOD        0x02 /* SCSI timeout period    */
#define WD_CDB_1                 0x03 /* SCSI command byte 1    */
#define WD_CDB_2                 0x04 /* SCSI command byte 2    */
#define WD_CDB_3                 0x05 /* SCSI command byte 3    */
#define WD_CDB_4                 0x06 /* SCSI command byte 4    */
#define WD_CDB_5                 0x07 /* SCSI command byte 5    */
#define WD_CDB_6                 0x08 /* SCSI command byte 6    */
#define WD_CDB_7                 0x09 /* SCSI command byte 7    */
#define WD_CDB_8                 0x0a /* SCSI command byte 8    */
#define WD_CDB_9                 0x0b /* SCSI command byte 9    */
#define WD_CDB_10                0x0c /* SCSI command byte 10   */
#define WD_CDB_11                0x0d /* SCSI command byte 11   */
#define WD_CDB_12                0x0e /* SCSI command byte 12   */
#define WD_TARGET_LUN            0x0f /* Target | Lun           */
#define WD_COMMAND_PHASE         0x10 /* Phase register         */
#define WD_SYNCHRONOUS_TRANSFER  0x11 /* Synchronous indicator  */
#define WD_TRANSFER_COUNT_MSB    0x12 /* Trans cnt, bits<23:16> */
#define WD_TRANSFER_COUNT        0x13 /* Trans cnt, bits<15:8>  */
#define WD_TRANSFER_COUNT_LSB    0x14 /* Trans cnt, bits<7:0>   */
#define WD_DESTINATION_ID        0x15 /* Dest ID register       */
#define WD_SOURCE_ID             0x16 /* Src ID register        */
#define WD_SCSI_STATUS           0x17 /* Status register        */
#define WD_COMMAND               0x18 /* Command reg            */
#define WD_DATA                  0x19 /* Data bus bit reg       */
#define WD_QUEUE_TAG             0x1a /* Queue TAG reg (wd93b)  */
#define WD_AUXILIARY_STATUS      0x1f /* Aux status reg         */

/* WD commands. */
#define WD_CMD_RESET             0x00 /* Reset SCSI bus and wd93x chip       */
#define WD_CMD_ABORT             0x01 /* Stop and abort current action       */
#define WD_CMD_ASSERT_ATN        0x02 /* Assert ATN on SCSI bus              */
#define WD_CMD_NEGATE_ACK        0x03 /* De-assert ACK on SCSI bus           */
#define WD_CMD_DISCONNECT        0x04 /* Causes wd93x to force disconnect    */
#define WD_CMD_RESELECT          0x05 /* Causes wd93x to reselect as targ    */
#define WD_CMD_SEL_ATN           0x06 /* Tells wd93x to select w/ATN assrt   */
#define WD_CMD_SEL               0x07 /* Tells wd93x to select w/o ATN assrt */
#define WD_CMD_SEL_ATN_XFER      0x08 /* Select w/ATN and transfer data      */
#define WD_CMD_SEL_XFER          0x09 /* Select w/o ATN and transfer data    */
#define WD_CMD_RESEL_RECEIVE     0x0a /* Reselect and into receive mode      */
#define WD_CMD_RESEL_SEND        0x0b /* Reselect and into send mode         */
#define WD_CMD_WAIT_SEL_RECEIVE  0x0c /* Await selection, into receive mode  */
#define WD_CMD_TRANS_ADDR        0x18 /* Address translate                   */
#define WD_CMD_TRANS_INFO        0x20 /* Information transfer                */
#define WD_CMD_TRANSFER_PAD      0x21 /* Information pad                     */
#define WD_CMD_SBT_MODE          0x80 /* XXX investigate for this comment    */

/* ASR (Auxiliary Status) register values. */
#define ASR_INT         (0x80) /* Showing an interrupt                           */
#define ASR_LCI         (0x40) /* Ignored most recent command                    */
#define ASR_BSY         (0x20) /* A level II command in progress, therefore busy */
#define ASR_CIP         (0x10) /* A command is in progress                       */
#define ASR_PE          (0x02) /* Detected a parity error                        */
#define ASR_DBR         (0x01) /* The data buffer is ready                       */

/* SCSI Bus Phases. */
#define PHS_DATA_OUT    (0x00)
#define PHS_DATA_IN     (0x01)
#define PHS_COMMAND     (0x02)
#define PHS_STATUS      (0x03)
#define PHS_MESS_OUT    (0x06)
#define PHS_MESS_IN     (0x07)

/* Command Status Register definitions */

/* reset state interrupts */
#define CSR_RESET          0x00
#define CSR_RESET_AF       0x01

/* successful completion interrupts */
#define CSR_RESELECT       0x10
#define CSR_SELECT         0x11
#define CSR_SEL_XFER_DONE  0x16
#define CSR_XFER_DONE      0x18

/* paused or aborted interrupts */
#define CSR_MSGIN          0x20
#define CSR_SDP            0x21
#define CSR_SEL_ABORT      0x22
#define CSR_RESEL_ABORT    0x25
#define CSR_RESEL_ABORT_AM 0x27
#define CSR_ABORT          0x28

/* terminated interrupts */
#define CSR_INVALID        0x40
#define CSR_UNEXP_DISC     0x41
#define CSR_TIMEOUT        0x42
#define CSR_PARITY         0x43
#define CSR_PARITY_ATN     0x44
#define CSR_BAD_STATUS     0x45
#define CSR_UNEXP          0x48

/* service required interrupts */
#define CSR_RESEL          0x80
#define CSR_RESEL_AM       0x81
#define CSR_DISC           0x85
#define CSR_SRV_REQ        0x88

/* Own ID/CDB Size register */
#define OWNID_EAF          0x08
#define OWNID_EHP          0x10
#define OWNID_RAF          0x20
#define OWNID_FS_8         0x00
#define OWNID_FS_12        0x40
#define OWNID_FS_16        0x80

/* define these so we don't have to change a2091.c, etc. */
#define WD33C93_FS_8_10    OWNID_FS_8
#define WD33C93_FS_12_15   OWNID_FS_12
#define WD33C93_FS_16_20   OWNID_FS_16

/* Control register */
#define CTRL_HSP           0x01
#define CTRL_HA            0x02
#define CTRL_IDI           0x04
#define CTRL_EDI           0x08
#define CTRL_HHP           0x10
#define CTRL_POLLED        0x00
#define CTRL_BURST         0x20
#define CTRL_BUS           0x40
#define CTRL_DMA           0x80

/* Timeout Period register */
#define TIMEOUT_PERIOD_VALUE  20    /* 20 = 200 ms */

/* Synchronous Transfer Register */
#define STR_FSS      0x80

/* Destination ID register */
#define DSTID_DPD    0x40
#define DATA_OUT_DIR 0
#define DATA_IN_DIR  1
#define DSTID_SCC    0x80

   /* Source ID register */
#define SRCID_MASK   0x07
#define SRCID_SIV    0x08
#define SRCID_DSP    0x20
#define SRCID_ES     0x40
#define SRCID_ER     0x80

   /* This is what the 3393 chip looks like to us */
typedef struct {
	volatile unsigned char   SASR;
	char                     pad;
#ifdef CONFIG_SGI
	char                     pad2, pad3; /* HPC is funny like this... */
#endif
	volatile unsigned char   SCMD;
} wd33c93_regs;

typedef int (*dma_setup_t) (Scsi_Cmnd *SCpnt, int dir_in);
typedef void (*dma_stop_t) (struct Scsi_Host *instance, Scsi_Cmnd *SCpnt,
			    int status);

#define DEFAULT_SX_PER   376     /* (ns) fairly safe */
#define DEFAULT_SX_OFF   0       /* aka async */

#define OPTIMUM_SX_PER   252     /* (ns) best we can do (mult-of-4) */
#define OPTIMUM_SX_OFF   12      /* size of wd3393 fifo */

struct sx_period {
	unsigned int   period_ns;
	uchar          reg_value;
};

/* FEF: defines for hostdata->dma_buffer_pool */
#define BUF_CHIP_ALLOCED 0
#define BUF_SCSI_ALLOCED 1

struct WD33C93_hostdata {
	struct Scsi_Host *next;
	wd33c93_regs     *regp;
	uchar            clock_freq;
	uchar            chip;             /* what kind of wd33c93? */
	uchar            microcode;        /* microcode rev */
	int              dma_dir;          /* data transfer dir. */
	dma_setup_t      dma_setup;
	dma_stop_t       dma_stop;
	unsigned int     dma_xfer_mask;
	uchar            *dma_bounce_buffer;
	unsigned int     dma_bounce_len;
	uchar            dma_buffer_pool;  /* FEF: buffer from chip_ram? */
	volatile uchar   busy[8];          /* index = target, bit = lun */
	volatile Scsi_Cmnd *input_Q;       /* commands waiting to be started */
	volatile Scsi_Cmnd *selecting;     /* trying to select this command */
	volatile Scsi_Cmnd *connected;     /* currently connected command */
	volatile Scsi_Cmnd *disconnected_Q;/* commands waiting for reconnect */
	uchar            state;            /* what we are currently doing */
	uchar            dma;              /* current state of DMA (on/off) */
	uchar            level2;           /* extent to which Level-2 commands are used */
	uchar            disconnect;       /* disconnect/reselect policy */
	unsigned int     args;             /* set from command-line argument */
	uchar            incoming_msg[8];  /* filled during message_in phase */
	int              incoming_ptr;     /* mainly used with EXTENDED messages */
	uchar            outgoing_msg[8];  /* send this during next message_out */
	int              outgoing_len;     /* length of outgoing message */
	unsigned int     default_sx_per;   /* default transfer period for SCSI bus */
	uchar            sync_xfer[8];     /* sync_xfer reg settings per target */
	uchar            sync_stat[8];     /* status of sync negotiation per target */
	uchar            no_sync;          /* bitmask: don't do sync on these targets */
	uchar            no_dma;           /* set this flag to disable DMA */
#ifdef PROC_INTERFACE
	uchar            proc;             /* bitmask: what's in proc output */
#ifdef PROC_STATISTICS
	unsigned long    cmd_cnt[8];       /* # of commands issued per target */
	unsigned long    int_cnt;          /* # of interrupts serviced */
	unsigned long    pio_cnt;          /* # of pio data transfers */
	unsigned long    dma_cnt;          /* # of DMA data transfers */
	unsigned long    disc_allowed_cnt[8]; /* # of disconnects allowed per target */
	unsigned long    disc_done_cnt[8]; /* # of disconnects done per target*/
#endif
#endif
};

#define CMDHOSTDATA(cmd)   ((struct WD33C93_hostdata *) (cmd)->host->hostdata)
#define INSTHOSTDATA(inst) ((struct WD33C93_hostdata *) (inst)->hostdata)

/* defines for hostdata->chip */
#define C_WD33C93             0
#define C_WD33C93A            1
#define C_WD33C93B            2
#define C_UNKNOWN_CHIP        100

/* defines for hostdata->state */
#define S_UNCONNECTED         0
#define S_SELECTING           1
#define S_RUNNING_LEVEL2      2
#define S_CONNECTED           3
#define S_PRE_TMP_DISC        4
#define S_PRE_CMP_DISC        5

/* defines for hostdata->dma */
#define D_DMA_OFF             0
#define D_DMA_RUNNING         1

/* defines for hostdata->level2 */
/* NOTE: only the first 3 are implemented so far */

/*  (The first 8 bits are reserved for compatibility. They function */
#if 0
#define L2_SELECT    2  /* start with SEL_ATN_XFER, but never resume it */
#endif

#define L2_NONE      0
#define L2_BASIC     3  /* resume after STATUS ints & RDP messages */
#define L2_DATA      4  /* resume after DATA_IN/OUT ints */
#define L2_MOST      5  /* resume after anything except a RESELECT int */
#define L2_RESELECT  6  /* resume after everything, including RESELECT ints */
#define L2_ALL       7  /* always resume */

/* defines for hostdata->disconnect */
#define DIS_NEVER    0
#define DIS_ADAPTIVE 1
#define DIS_ALWAYS   2

/* defines for hostdata->args */
#define DB_TEST1              (1<<0)
#define DB_TEST2              (1<<1)
#define DB_QCMD               (1<<2)
#define DB_EXECUTE            (1<<3)
#define DB_INTR               (1<<4)
#define DB_TRANSFER           (1<<5)
#define DB_MASK               (0x3f)

/* defines for hostdata->sync_stat[] */
#define SS_UNSET     0
#define SS_FIRST     1
#define SS_WAITING   2
#define SS_SET       3

/* defines for hostdata->proc */
#define PR_VERSION   (1<<0)
#define PR_INFO      (1<<1)
#define PR_STATISTICS (1<<2)
#define PR_CONNECTED (1<<3)
#define PR_INPUTQ    (1<<4)
#define PR_DISCQ     (1<<5)
#define PR_TEST      (1<<6)
#define PR_STOP      (1<<7)

void wd33c93_init (struct Scsi_Host *instance, wd33c93_regs *regs,
		   dma_setup_t setup, dma_stop_t stop, int clock_freq);
int wd33c93_abort (Scsi_Cmnd *cmd);
int wd33c93_queuecommand (Scsi_Cmnd *cmd, void (*done)(Scsi_Cmnd *));
void wd33c93_intr (struct Scsi_Host *instance);
int wd33c93_proc_info(char *, char **, off_t, int, int, int);

#if LINUX_VERSION_CODE >= 0x010300
int wd33c93_reset (Scsi_Cmnd *, unsigned int);
#else
int wd33c93_reset (Scsi_Cmnd *);
#endif

#endif /* WD33C93_H */