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