1/* SPDX-License-Identifier: GPL-2.0+ */ 2/* 3 * (C) Copyright 2001 4 * Denis Peter, MPL AG Switzerland 5 */ 6 #ifndef _SCSI_H 7 #define _SCSI_H 8 9#include <asm/cache.h> 10#include <linux/dma-direction.h> 11 12/* Fix this to the maximum */ 13#define SCSI_MAX_DEVICE \ 14 (CONFIG_SYS_SCSI_MAX_SCSI_ID * CONFIG_SYS_SCSI_MAX_LUN) 15 16struct udevice; 17 18struct scsi_cmd { 19 unsigned char cmd[16]; /* command */ 20 /* for request sense */ 21 unsigned char sense_buf[64] 22 __attribute__((aligned(ARCH_DMA_MINALIGN))); 23 unsigned char status; /* SCSI Status */ 24 unsigned char target; /* Target ID */ 25 unsigned char lun; /* Target LUN */ 26 unsigned char cmdlen; /* command len */ 27 unsigned long datalen; /* Total data length */ 28 unsigned char * pdata; /* pointer to data */ 29 unsigned char msgout[12]; /* Messge out buffer (NOT USED) */ 30 unsigned char msgin[12]; /* Message in buffer */ 31 unsigned char sensecmdlen; /* Sense command len */ 32 unsigned long sensedatalen; /* Sense data len */ 33 unsigned char sensecmd[6]; /* Sense command */ 34 unsigned long contr_stat; /* Controller Status */ 35 unsigned long trans_bytes; /* tranfered bytes */ 36 37 unsigned int priv; 38 enum dma_data_direction dma_dir; 39}; 40 41/*----------------------------------------------------------- 42** 43** SCSI constants. 44** 45**----------------------------------------------------------- 46*/ 47 48/* 49** Messages 50*/ 51 52#define M_COMPLETE (0x00) 53#define M_EXTENDED (0x01) 54#define M_SAVE_DP (0x02) 55#define M_RESTORE_DP (0x03) 56#define M_DISCONNECT (0x04) 57#define M_ID_ERROR (0x05) 58#define M_ABORT (0x06) 59#define M_REJECT (0x07) 60#define M_NOOP (0x08) 61#define M_PARITY (0x09) 62#define M_LCOMPLETE (0x0a) 63#define M_FCOMPLETE (0x0b) 64#define M_RESET (0x0c) 65#define M_ABORT_TAG (0x0d) 66#define M_CLEAR_QUEUE (0x0e) 67#define M_INIT_REC (0x0f) 68#define M_REL_REC (0x10) 69#define M_TERMINATE (0x11) 70#define M_SIMPLE_TAG (0x20) 71#define M_HEAD_TAG (0x21) 72#define M_ORDERED_TAG (0x22) 73#define M_IGN_RESIDUE (0x23) 74#define M_IDENTIFY (0x80) 75 76#define M_X_MODIFY_DP (0x00) 77#define M_X_SYNC_REQ (0x01) 78#define M_X_WIDE_REQ (0x03) 79#define M_X_PPR_REQ (0x04) 80 81 82/* 83** Status 84*/ 85 86#define S_GOOD (0x00) 87#define S_CHECK_COND (0x02) 88#define S_COND_MET (0x04) 89#define S_BUSY (0x08) 90#define S_INT (0x10) 91#define S_INT_COND_MET (0x14) 92#define S_CONFLICT (0x18) 93#define S_TERMINATED (0x20) 94#define S_QUEUE_FULL (0x28) 95#define S_ILLEGAL (0xff) 96#define S_SENSE (0x80) 97 98/* 99 * Sense_keys 100 */ 101 102#define SENSE_NO_SENSE 0x0 103#define SENSE_RECOVERED_ERROR 0x1 104#define SENSE_NOT_READY 0x2 105#define SENSE_MEDIUM_ERROR 0x3 106#define SENSE_HARDWARE_ERROR 0x4 107#define SENSE_ILLEGAL_REQUEST 0x5 108#define SENSE_UNIT_ATTENTION 0x6 109#define SENSE_DATA_PROTECT 0x7 110#define SENSE_BLANK_CHECK 0x8 111#define SENSE_VENDOR_SPECIFIC 0x9 112#define SENSE_COPY_ABORTED 0xA 113#define SENSE_ABORTED_COMMAND 0xB 114#define SENSE_VOLUME_OVERFLOW 0xD 115#define SENSE_MISCOMPARE 0xE 116 117 118#define SCSI_CHANGE_DEF 0x40 /* Change Definition (Optional) */ 119#define SCSI_COMPARE 0x39 /* Compare (O) */ 120#define SCSI_COPY 0x18 /* Copy (O) */ 121#define SCSI_COP_VERIFY 0x3A /* Copy and Verify (O) */ 122#define SCSI_INQUIRY 0x12 /* Inquiry (MANDATORY) */ 123#define SCSI_LOG_SELECT 0x4C /* Log Select (O) */ 124#define SCSI_LOG_SENSE 0x4D /* Log Sense (O) */ 125#define SCSI_MODE_SEL6 0x15 /* Mode Select 6-byte (Device Specific) */ 126#define SCSI_MODE_SEL10 0x55 /* Mode Select 10-byte (Device Specific) */ 127#define SCSI_MODE_SEN6 0x1A /* Mode Sense 6-byte (Device Specific) */ 128#define SCSI_MODE_SEN10 0x5A /* Mode Sense 10-byte (Device Specific) */ 129#define SCSI_READ_BUFF 0x3C /* Read Buffer (O) */ 130#define SCSI_REQ_SENSE 0x03 /* Request Sense (MANDATORY) */ 131#define SCSI_SEND_DIAG 0x1D /* Send Diagnostic (O) */ 132#define SCSI_TST_U_RDY 0x00 /* Test Unit Ready (MANDATORY) */ 133#define SCSI_WRITE_BUFF 0x3B /* Write Buffer (O) */ 134/*************************************************************************** 135 * %%% Commands Unique to Direct Access Devices %%% 136 ***************************************************************************/ 137#define SCSI_COMPARE 0x39 /* Compare (O) */ 138#define SCSI_FORMAT 0x04 /* Format Unit (MANDATORY) */ 139#define SCSI_LCK_UN_CAC 0x36 /* Lock Unlock Cache (O) */ 140#define SCSI_PREFETCH 0x34 /* Prefetch (O) */ 141#define SCSI_MED_REMOVL 0x1E /* Prevent/Allow medium Removal (O) */ 142#define SCSI_READ6 0x08 /* Read 6-byte (MANDATORY) */ 143#define SCSI_READ10 0x28 /* Read 10-byte (MANDATORY) */ 144#define SCSI_READ16 0x48 145#define SCSI_RD_CAPAC 0x25 /* Read Capacity (MANDATORY) */ 146#define SCSI_RD_CAPAC10 SCSI_RD_CAPAC /* Read Capacity (10) */ 147#define SCSI_RD_CAPAC16 0x9e /* Read Capacity (16) */ 148#define SCSI_RD_DEFECT 0x37 /* Read Defect Data (O) */ 149#define SCSI_READ_LONG 0x3E /* Read Long (O) */ 150#define SCSI_REASS_BLK 0x07 /* Reassign Blocks (O) */ 151#define SCSI_RCV_DIAG 0x1C /* Receive Diagnostic Results (O) */ 152#define SCSI_RELEASE 0x17 /* Release Unit (MANDATORY) */ 153#define SCSI_REZERO 0x01 /* Rezero Unit (O) */ 154#define SCSI_SRCH_DAT_E 0x31 /* Search Data Equal (O) */ 155#define SCSI_SRCH_DAT_H 0x30 /* Search Data High (O) */ 156#define SCSI_SRCH_DAT_L 0x32 /* Search Data Low (O) */ 157#define SCSI_SEEK6 0x0B /* Seek 6-Byte (O) */ 158#define SCSI_SEEK10 0x2B /* Seek 10-Byte (O) */ 159#define SCSI_SEND_DIAG 0x1D /* Send Diagnostics (MANDATORY) */ 160#define SCSI_SET_LIMIT 0x33 /* Set Limits (O) */ 161#define SCSI_START_STP 0x1B /* Start/Stop Unit (O) */ 162#define SCSI_SYNC_CACHE 0x35 /* Synchronize Cache (O) */ 163#define SCSI_VERIFY 0x2F /* Verify (O) */ 164#define SCSI_WRITE6 0x0A /* Write 6-Byte (MANDATORY) */ 165#define SCSI_WRITE10 0x2A /* Write 10-Byte (MANDATORY) */ 166#define SCSI_WRT_VERIFY 0x2E /* Write and Verify (O) */ 167#define SCSI_WRITE_LONG 0x3F /* Write Long (O) */ 168#define SCSI_WRITE_SAME 0x41 /* Write Same (O) */ 169 170/** 171 * struct scsi_plat - stores information about SCSI controller 172 * 173 * @base: Controller base address 174 * @max_lun: Maximum number of logical units 175 * @max_id: Maximum number of target ids 176 * @max_bytes_per_req: Maximum number of bytes per read/write request 177 */ 178struct scsi_plat { 179 unsigned long base; 180 unsigned long max_lun; 181 unsigned long max_id; 182 unsigned long max_bytes_per_req; 183}; 184 185/* Operations for SCSI */ 186struct scsi_ops { 187 /** 188 * exec() - execute a command 189 * 190 * @dev: SCSI bus 191 * @cmd: Command to execute 192 * @return 0 if OK, -ve on error 193 */ 194 int (*exec)(struct udevice *dev, struct scsi_cmd *cmd); 195 196 /** 197 * bus_reset() - reset the bus 198 * 199 * @dev: SCSI bus to reset 200 * @return 0 if OK, -ve on error 201 */ 202 int (*bus_reset)(struct udevice *dev); 203}; 204 205#define scsi_get_ops(dev) ((struct scsi_ops *)(dev)->driver->ops) 206 207extern struct scsi_ops scsi_ops; 208 209/** 210 * scsi_exec() - execute a command 211 * 212 * @dev: SCSI bus 213 * @cmd: Command to execute 214 * Return: 0 if OK, -ve on error 215 */ 216int scsi_exec(struct udevice *dev, struct scsi_cmd *cmd); 217 218/** 219 * scsi_bus_reset() - reset the bus 220 * 221 * @dev: SCSI bus to reset 222 * Return: 0 if OK, -ve on error 223 */ 224int scsi_bus_reset(struct udevice *dev); 225 226/** 227 * scsi_scan() - Scan all SCSI controllers for available devices 228 * 229 * @vebose: true to show information about each device found 230 */ 231int scsi_scan(bool verbose); 232 233/** 234 * scsi_scan_dev() - scan a SCSI bus and create devices 235 * 236 * @dev: SCSI bus 237 * @verbose: true to show information about each device found 238 */ 239int scsi_scan_dev(struct udevice *dev, bool verbose); 240 241#ifndef CONFIG_DM_SCSI 242void scsi_low_level_init(int busdevfunc); 243void scsi_init(void); 244#endif 245 246#define SCSI_IDENTIFY 0xC0 /* not used */ 247 248/* Hardware errors */ 249#define SCSI_SEL_TIME_OUT 0x00000101 /* Selection time out */ 250#define SCSI_HNS_TIME_OUT 0x00000102 /* Handshake */ 251#define SCSI_MA_TIME_OUT 0x00000103 /* Phase error */ 252#define SCSI_UNEXP_DIS 0x00000104 /* unexpected disconnect */ 253 254#define SCSI_INT_STATE 0x00010000 /* unknown Interrupt number is stored in 16 LSB */ 255 256#endif /* _SCSI_H */ 257