mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-26 10:49:33 +00:00
![Bart Van Assche](/assets/img/avatar_default.png)
Introduce a structure with driver-private data per SCSI command. This data structure will be used by the next patch to store a function pointer. Link: https://lore.kernel.org/r/20211007202923.2174984-33-bvanassche@acm.org Signed-off-by: Bart Van Assche <bvanassche@acm.org> Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
400 lines
14 KiB
C
400 lines
14 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* linux/drivers/acorn/scsi/fas216.h
|
|
*
|
|
* Copyright (C) 1997-2000 Russell King
|
|
*
|
|
* FAS216 generic driver
|
|
*/
|
|
#ifndef FAS216_H
|
|
#define FAS216_H
|
|
|
|
#include <scsi/scsi_eh.h>
|
|
|
|
#include "queue.h"
|
|
#include "msgqueue.h"
|
|
|
|
/* FAS register definitions */
|
|
|
|
/* transfer count low */
|
|
#define REG_CTCL (0)
|
|
#define REG_STCL (0)
|
|
|
|
/* transfer count medium */
|
|
#define REG_CTCM (1)
|
|
#define REG_STCM (1)
|
|
|
|
/* fifo data */
|
|
#define REG_FF (2)
|
|
|
|
/* command */
|
|
#define REG_CMD (3)
|
|
#define CMD_NOP 0x00
|
|
#define CMD_FLUSHFIFO 0x01
|
|
#define CMD_RESETCHIP 0x02
|
|
#define CMD_RESETSCSI 0x03
|
|
|
|
#define CMD_TRANSFERINFO 0x10
|
|
#define CMD_INITCMDCOMPLETE 0x11
|
|
#define CMD_MSGACCEPTED 0x12
|
|
#define CMD_PADBYTES 0x18
|
|
#define CMD_SETATN 0x1a
|
|
#define CMD_RSETATN 0x1b
|
|
|
|
#define CMD_SELECTWOATN 0x41
|
|
#define CMD_SELECTATN 0x42
|
|
#define CMD_SELECTATNSTOP 0x43
|
|
#define CMD_ENABLESEL 0x44
|
|
#define CMD_DISABLESEL 0x45
|
|
#define CMD_SELECTATN3 0x46
|
|
#define CMD_RESEL3 0x47
|
|
|
|
#define CMD_WITHDMA 0x80
|
|
|
|
/* status register (read) */
|
|
#define REG_STAT (4)
|
|
#define STAT_IO (1 << 0) /* IO phase */
|
|
#define STAT_CD (1 << 1) /* CD phase */
|
|
#define STAT_MSG (1 << 2) /* MSG phase */
|
|
#define STAT_TRANSFERDONE (1 << 3) /* Transfer completed */
|
|
#define STAT_TRANSFERCNTZ (1 << 4) /* Transfer counter is zero */
|
|
#define STAT_PARITYERROR (1 << 5) /* Parity error */
|
|
#define STAT_REALBAD (1 << 6) /* Something bad */
|
|
#define STAT_INT (1 << 7) /* Interrupt */
|
|
|
|
#define STAT_BUSMASK (STAT_MSG|STAT_CD|STAT_IO)
|
|
#define STAT_DATAOUT (0) /* Data out */
|
|
#define STAT_DATAIN (STAT_IO) /* Data in */
|
|
#define STAT_COMMAND (STAT_CD) /* Command out */
|
|
#define STAT_STATUS (STAT_CD|STAT_IO) /* Status In */
|
|
#define STAT_MESGOUT (STAT_MSG|STAT_CD) /* Message out */
|
|
#define STAT_MESGIN (STAT_MSG|STAT_CD|STAT_IO) /* Message In */
|
|
|
|
/* bus ID for select / reselect */
|
|
#define REG_SDID (4)
|
|
#define BUSID(target) ((target) & 7)
|
|
|
|
/* Interrupt status register (read) */
|
|
#define REG_INST (5)
|
|
#define INST_SELWOATN (1 << 0) /* Select w/o ATN */
|
|
#define INST_SELATN (1 << 1) /* Select w/ATN */
|
|
#define INST_RESELECTED (1 << 2) /* Reselected */
|
|
#define INST_FUNCDONE (1 << 3) /* Function done */
|
|
#define INST_BUSSERVICE (1 << 4) /* Bus service */
|
|
#define INST_DISCONNECT (1 << 5) /* Disconnect */
|
|
#define INST_ILLEGALCMD (1 << 6) /* Illegal command */
|
|
#define INST_BUSRESET (1 << 7) /* SCSI Bus reset */
|
|
|
|
/* Timeout register (write) */
|
|
#define REG_STIM (5)
|
|
|
|
/* Sequence step register (read) */
|
|
#define REG_IS (6)
|
|
#define IS_BITS 0x07
|
|
#define IS_SELARB 0x00 /* Select & Arb ok */
|
|
#define IS_MSGBYTESENT 0x01 /* One byte message sent*/
|
|
#define IS_NOTCOMMAND 0x02 /* Not in command state */
|
|
#define IS_EARLYPHASE 0x03 /* Early phase change */
|
|
#define IS_COMPLETE 0x04 /* Command ok */
|
|
#define IS_SOF 0x08 /* Sync off flag */
|
|
|
|
/* Transfer period step (write) */
|
|
#define REG_STP (6)
|
|
|
|
/* Synchronous Offset (write) */
|
|
#define REG_SOF (7)
|
|
|
|
/* Fifo state register (read) */
|
|
#define REG_CFIS (7)
|
|
#define CFIS_CF 0x1f /* Num bytes in FIFO */
|
|
#define CFIS_IS 0xe0 /* Step */
|
|
|
|
/* config register 1 */
|
|
#define REG_CNTL1 (8)
|
|
#define CNTL1_CID (7 << 0) /* Chip ID */
|
|
#define CNTL1_STE (1 << 3) /* Self test enable */
|
|
#define CNTL1_PERE (1 << 4) /* Parity enable reporting en. */
|
|
#define CNTL1_PTE (1 << 5) /* Parity test enable */
|
|
#define CNTL1_DISR (1 << 6) /* Disable Irq on SCSI reset */
|
|
#define CNTL1_ETM (1 << 7) /* Extended Timing Mode */
|
|
|
|
/* Clock conversion factor (read) */
|
|
#define REG_CLKF (9)
|
|
#define CLKF_F37MHZ 0x00 /* 35.01 - 40 MHz */
|
|
#define CLKF_F10MHZ 0x02 /* 10 MHz */
|
|
#define CLKF_F12MHZ 0x03 /* 10.01 - 15 MHz */
|
|
#define CLKF_F17MHZ 0x04 /* 15.01 - 20 MHz */
|
|
#define CLKF_F22MHZ 0x05 /* 20.01 - 25 MHz */
|
|
#define CLKF_F27MHZ 0x06 /* 25.01 - 30 MHz */
|
|
#define CLKF_F32MHZ 0x07 /* 30.01 - 35 MHz */
|
|
|
|
/* Chip test register (write) */
|
|
#define REG_FTM (10)
|
|
#define TEST_FTM 0x01 /* Force target mode */
|
|
#define TEST_FIM 0x02 /* Force initiator mode */
|
|
#define TEST_FHI 0x04 /* Force high impedance mode */
|
|
|
|
/* Configuration register 2 (read/write) */
|
|
#define REG_CNTL2 (11)
|
|
#define CNTL2_PGDP (1 << 0) /* Pass Th/Generate Data Parity */
|
|
#define CNTL2_PGRP (1 << 1) /* Pass Th/Generate Reg Parity */
|
|
#define CNTL2_ACDPE (1 << 2) /* Abort on Cmd/Data Parity Err */
|
|
#define CNTL2_S2FE (1 << 3) /* SCSI2 Features Enable */
|
|
#define CNTL2_TSDR (1 << 4) /* Tristate DREQ */
|
|
#define CNTL2_SBO (1 << 5) /* Select Byte Order */
|
|
#define CNTL2_ENF (1 << 6) /* Enable features */
|
|
#define CNTL2_DAE (1 << 7) /* Data Alignment Enable */
|
|
|
|
/* Configuration register 3 (read/write) */
|
|
#define REG_CNTL3 (12)
|
|
#define CNTL3_BS8 (1 << 0) /* Burst size 8 */
|
|
#define CNTL3_MDM (1 << 1) /* Modify DMA mode */
|
|
#define CNTL3_LBTM (1 << 2) /* Last Byte Transfer mode */
|
|
#define CNTL3_FASTCLK (1 << 3) /* Fast SCSI clocking */
|
|
#define CNTL3_FASTSCSI (1 << 4) /* Fast SCSI */
|
|
#define CNTL3_G2CB (1 << 5) /* Group2 SCSI support */
|
|
#define CNTL3_QTAG (1 << 6) /* Enable 3 byte msgs */
|
|
#define CNTL3_ADIDCHK (1 << 7) /* Additional ID check */
|
|
|
|
/* High transfer count (read/write) */
|
|
#define REG_CTCH (14)
|
|
#define REG_STCH (14)
|
|
|
|
/* ID register (read only) */
|
|
#define REG_ID (14)
|
|
|
|
/* Data alignment */
|
|
#define REG_DAL (15)
|
|
|
|
typedef enum {
|
|
PHASE_IDLE, /* we're not planning on doing anything */
|
|
PHASE_SELECTION, /* selecting a device */
|
|
PHASE_SELSTEPS, /* selection with command steps */
|
|
PHASE_COMMAND, /* command sent */
|
|
PHASE_MESSAGESENT, /* selected, and we're sending cmd */
|
|
PHASE_DATAOUT, /* data out to device */
|
|
PHASE_DATAIN, /* data in from device */
|
|
PHASE_MSGIN, /* message in from device */
|
|
PHASE_MSGIN_DISCONNECT, /* disconnecting from bus */
|
|
PHASE_MSGOUT, /* after message out phase */
|
|
PHASE_MSGOUT_EXPECT, /* expecting message out */
|
|
PHASE_STATUS, /* status from device */
|
|
PHASE_DONE /* Command complete */
|
|
} phase_t;
|
|
|
|
typedef enum {
|
|
DMA_OUT, /* DMA from memory to chip */
|
|
DMA_IN /* DMA from chip to memory */
|
|
} fasdmadir_t;
|
|
|
|
typedef enum {
|
|
fasdma_none, /* No dma */
|
|
fasdma_pio, /* PIO mode */
|
|
fasdma_pseudo, /* Pseudo DMA */
|
|
fasdma_real_block, /* Real DMA, on block by block basis */
|
|
fasdma_real_all /* Real DMA, on request by request */
|
|
} fasdmatype_t;
|
|
|
|
typedef enum {
|
|
neg_wait, /* Negotiate with device */
|
|
neg_inprogress, /* Negotiation sent */
|
|
neg_complete, /* Negotiation complete */
|
|
neg_targcomplete, /* Target completed negotiation */
|
|
neg_invalid /* Negotiation not supported */
|
|
} neg_t;
|
|
|
|
#define MAGIC 0x441296bdUL
|
|
#define NR_MSGS 8
|
|
|
|
#define FASCAP_DMA (1 << 0)
|
|
#define FASCAP_PSEUDODMA (1 << 1)
|
|
|
|
typedef struct {
|
|
unsigned long magic_start;
|
|
spinlock_t host_lock;
|
|
struct Scsi_Host *host; /* host */
|
|
struct scsi_cmnd *SCpnt; /* currently processing command */
|
|
struct scsi_cmnd *origSCpnt; /* original connecting command */
|
|
struct scsi_cmnd *reqSCpnt; /* request sense command */
|
|
struct scsi_cmnd *rstSCpnt; /* reset command */
|
|
struct scsi_cmnd *pending_SCpnt[8]; /* per-device pending commands */
|
|
int next_pending; /* next pending device */
|
|
|
|
/*
|
|
* Error recovery
|
|
*/
|
|
wait_queue_head_t eh_wait;
|
|
struct timer_list eh_timer;
|
|
unsigned int rst_dev_status;
|
|
unsigned int rst_bus_status;
|
|
|
|
/* driver information */
|
|
struct {
|
|
phase_t phase; /* current phase */
|
|
void __iomem *io_base; /* iomem base of FAS216 */
|
|
unsigned int io_shift; /* shift to adjust reg offsets by */
|
|
unsigned char cfg[4]; /* configuration registers */
|
|
const char *type; /* chip type */
|
|
unsigned int irq; /* interrupt */
|
|
int dma; /* dma channel */
|
|
|
|
struct scsi_pointer SCp; /* current commands data pointer */
|
|
|
|
MsgQueue_t msgs; /* message queue for connected device */
|
|
|
|
unsigned int async_stp; /* Async transfer STP value */
|
|
unsigned char msgin_fifo; /* bytes in fifo at time of message in */
|
|
unsigned char message[256]; /* last message received from device */
|
|
|
|
unsigned char disconnectable:1; /* this command can be disconnected */
|
|
unsigned char aborting:1; /* aborting command */
|
|
} scsi;
|
|
|
|
/* statistics information */
|
|
struct {
|
|
unsigned int queues;
|
|
unsigned int removes;
|
|
unsigned int fins;
|
|
unsigned int reads;
|
|
unsigned int writes;
|
|
unsigned int miscs;
|
|
unsigned int disconnects;
|
|
unsigned int aborts;
|
|
unsigned int bus_resets;
|
|
unsigned int host_resets;
|
|
} stats;
|
|
|
|
/* configuration information */
|
|
struct {
|
|
unsigned char clockrate; /* clock rate of FAS device (MHz) */
|
|
unsigned char select_timeout; /* timeout (R5) */
|
|
unsigned char sync_max_depth; /* Synchronous xfer max fifo depth */
|
|
unsigned char wide_max_size; /* Maximum wide transfer size */
|
|
unsigned char cntl3; /* Control Reg 3 */
|
|
unsigned int asyncperiod; /* Async transfer period (ns) */
|
|
unsigned int capabilities; /* driver capabilities */
|
|
unsigned int disconnect_ok:1; /* Disconnects allowed? */
|
|
} ifcfg;
|
|
|
|
/* queue handling */
|
|
struct {
|
|
Queue_t issue; /* issue queue */
|
|
Queue_t disconnected; /* disconnected command queue */
|
|
} queues;
|
|
|
|
/* per-device info */
|
|
struct fas216_device {
|
|
unsigned char disconnect_ok:1; /* device can disconnect */
|
|
unsigned char parity_enabled:1; /* parity checking enabled */
|
|
unsigned char parity_check:1; /* need to check parity checking */
|
|
unsigned char period; /* sync xfer period in (*4ns) */
|
|
unsigned char stp; /* synchronous transfer period */
|
|
unsigned char sof; /* synchronous offset register */
|
|
unsigned char wide_xfer; /* currently negociated wide transfer */
|
|
neg_t sync_state; /* synchronous transfer mode */
|
|
neg_t wide_state; /* wide transfer mode */
|
|
} device[8];
|
|
unsigned long busyluns[64/sizeof(unsigned long)];/* array of bits indicating LUNs busy */
|
|
|
|
/* dma */
|
|
struct {
|
|
fasdmatype_t transfer_type; /* current type of DMA transfer */
|
|
fasdmatype_t (*setup) (struct Scsi_Host *host, struct scsi_pointer *SCp, fasdmadir_t direction, fasdmatype_t min_dma);
|
|
void (*pseudo)(struct Scsi_Host *host, struct scsi_pointer *SCp, fasdmadir_t direction, int transfer);
|
|
void (*stop) (struct Scsi_Host *host, struct scsi_pointer *SCp);
|
|
} dma;
|
|
|
|
/* miscellaneous */
|
|
int internal_done; /* flag to indicate request done */
|
|
struct scsi_eh_save ses; /* holds request sense restore info */
|
|
unsigned long magic_end;
|
|
} FAS216_Info;
|
|
|
|
/* driver-private data per SCSI command. */
|
|
struct fas216_cmd_priv {
|
|
void (*scsi_done)(struct scsi_cmnd *cmd);
|
|
};
|
|
|
|
static inline struct fas216_cmd_priv *fas216_cmd_priv(struct scsi_cmnd *cmd)
|
|
{
|
|
return scsi_cmd_priv(cmd);
|
|
}
|
|
|
|
/* Function: int fas216_init (struct Scsi_Host *instance)
|
|
* Purpose : initialise FAS/NCR/AMD SCSI structures.
|
|
* Params : instance - a driver-specific filled-out structure
|
|
* Returns : 0 on success
|
|
*/
|
|
extern int fas216_init (struct Scsi_Host *instance);
|
|
|
|
/* Function: int fas216_add (struct Scsi_Host *instance, struct device *dev)
|
|
* Purpose : initialise FAS/NCR/AMD SCSI ic.
|
|
* Params : instance - a driver-specific filled-out structure
|
|
* Returns : 0 on success
|
|
*/
|
|
extern int fas216_add (struct Scsi_Host *instance, struct device *dev);
|
|
|
|
/* Function: int fas216_queue_command(struct Scsi_Host *h, struct scsi_cmnd *SCpnt)
|
|
* Purpose : queue a command for adapter to process.
|
|
* Params : h - host adapter
|
|
* : SCpnt - Command to queue
|
|
* Returns : 0 - success, else error
|
|
*/
|
|
extern int fas216_queue_command(struct Scsi_Host *h, struct scsi_cmnd *SCpnt);
|
|
|
|
/* Function: int fas216_noqueue_command(struct Scsi_Host *h, struct scsi_cmnd *SCpnt)
|
|
* Purpose : queue a command for adapter to process, and process it to completion.
|
|
* Params : h - host adapter
|
|
* : SCpnt - Command to queue
|
|
* Returns : 0 - success, else error
|
|
*/
|
|
extern int fas216_noqueue_command(struct Scsi_Host *, struct scsi_cmnd *);
|
|
|
|
/* Function: irqreturn_t fas216_intr (FAS216_Info *info)
|
|
* Purpose : handle interrupts from the interface to progress a command
|
|
* Params : info - interface to service
|
|
*/
|
|
extern irqreturn_t fas216_intr (FAS216_Info *info);
|
|
|
|
extern void fas216_remove (struct Scsi_Host *instance);
|
|
|
|
/* Function: void fas216_release (struct Scsi_Host *instance)
|
|
* Purpose : release all resources and put everything to bed for FAS/NCR/AMD SCSI ic.
|
|
* Params : instance - a driver-specific filled-out structure
|
|
* Returns : 0 on success
|
|
*/
|
|
extern void fas216_release (struct Scsi_Host *instance);
|
|
|
|
extern void fas216_print_host(FAS216_Info *info, struct seq_file *m);
|
|
extern void fas216_print_stats(FAS216_Info *info, struct seq_file *m);
|
|
extern void fas216_print_devices(FAS216_Info *info, struct seq_file *m);
|
|
|
|
/* Function: int fas216_eh_abort(struct scsi_cmnd *SCpnt)
|
|
* Purpose : abort this command
|
|
* Params : SCpnt - command to abort
|
|
* Returns : FAILED if unable to abort
|
|
*/
|
|
extern int fas216_eh_abort(struct scsi_cmnd *SCpnt);
|
|
|
|
/* Function: int fas216_eh_device_reset(struct scsi_cmnd *SCpnt)
|
|
* Purpose : Reset the device associated with this command
|
|
* Params : SCpnt - command specifing device to reset
|
|
* Returns : FAILED if unable to reset
|
|
*/
|
|
extern int fas216_eh_device_reset(struct scsi_cmnd *SCpnt);
|
|
|
|
/* Function: int fas216_eh_bus_reset(struct scsi_cmnd *SCpnt)
|
|
* Purpose : Reset the complete bus associated with this command
|
|
* Params : SCpnt - command specifing bus to reset
|
|
* Returns : FAILED if unable to reset
|
|
*/
|
|
extern int fas216_eh_bus_reset(struct scsi_cmnd *SCpnt);
|
|
|
|
/* Function: int fas216_eh_host_reset(struct scsi_cmnd *SCpnt)
|
|
* Purpose : Reset the host associated with this command
|
|
* Params : SCpnt - command specifing host to reset
|
|
* Returns : FAILED if unable to reset
|
|
*/
|
|
extern int fas216_eh_host_reset(struct scsi_cmnd *SCpnt);
|
|
|
|
#endif /* FAS216_H */
|