| /* SPDX-License-Identifier: GPL-2.0+ */ |
| /* |
| * (C) Copyright 2001 |
| * Denis Peter, MPL AG Switzerland |
| */ |
| #ifndef _SCSI_H |
| #define _SCSI_H |
| |
| #include <asm/cache.h> |
| #include <bouncebuf.h> |
| #include <linux/dma-direction.h> |
| |
| struct udevice; |
| |
| /** |
| * struct scsi_cmd - information about a SCSI command to be processed |
| * |
| * @cmd: command |
| * @sense_buf: for request sense |
| * @status: SCSI Status |
| * @target: Target ID |
| * @lun: Target LUN |
| * @cmdlen: command len |
| * @datalen: Total data length |
| * @pdata: pointer to data |
| * @msgout: Messge out buffer (NOT USED) |
| * @msgin: Message in buffer |
| * @sensecmdlen: Sense command len |
| * @sensedatalen: Sense data len |
| * @sensecmd: Sense command |
| * @contr_stat: Controller Status |
| * @trans_bytes: tranfered bytes |
| * @priv: Private value |
| * @dma_dir: Direction of data structure |
| */ |
| struct scsi_cmd { |
| unsigned char cmd[16]; |
| unsigned char sense_buf[64] |
| __attribute__((aligned(ARCH_DMA_MINALIGN))); |
| unsigned char status; |
| unsigned char target; |
| unsigned char lun; |
| unsigned char cmdlen; |
| unsigned long datalen; |
| unsigned char *pdata; |
| unsigned char msgout[12]; |
| unsigned char msgin[12]; |
| unsigned char sensecmdlen; |
| unsigned long sensedatalen; |
| unsigned char sensecmd[6]; |
| unsigned long contr_stat; |
| unsigned long trans_bytes; |
| |
| unsigned int priv; |
| enum dma_data_direction dma_dir; |
| }; |
| |
| /*----------------------------------------------------------- |
| ** |
| ** SCSI constants. |
| ** |
| **----------------------------------------------------------- |
| */ |
| |
| /* |
| ** Messages |
| */ |
| |
| #define M_COMPLETE (0x00) |
| #define M_EXTENDED (0x01) |
| #define M_SAVE_DP (0x02) |
| #define M_RESTORE_DP (0x03) |
| #define M_DISCONNECT (0x04) |
| #define M_ID_ERROR (0x05) |
| #define M_ABORT (0x06) |
| #define M_REJECT (0x07) |
| #define M_NOOP (0x08) |
| #define M_PARITY (0x09) |
| #define M_LCOMPLETE (0x0a) |
| #define M_FCOMPLETE (0x0b) |
| #define M_RESET (0x0c) |
| #define M_ABORT_TAG (0x0d) |
| #define M_CLEAR_QUEUE (0x0e) |
| #define M_INIT_REC (0x0f) |
| #define M_REL_REC (0x10) |
| #define M_TERMINATE (0x11) |
| #define M_SIMPLE_TAG (0x20) |
| #define M_HEAD_TAG (0x21) |
| #define M_ORDERED_TAG (0x22) |
| #define M_IGN_RESIDUE (0x23) |
| #define M_IDENTIFY (0x80) |
| |
| #define M_X_MODIFY_DP (0x00) |
| #define M_X_SYNC_REQ (0x01) |
| #define M_X_WIDE_REQ (0x03) |
| #define M_X_PPR_REQ (0x04) |
| |
| /* |
| ** Status |
| */ |
| |
| #define S_GOOD (0x00) |
| #define S_CHECK_COND (0x02) |
| #define S_COND_MET (0x04) |
| #define S_BUSY (0x08) |
| #define S_INT (0x10) |
| #define S_INT_COND_MET (0x14) |
| #define S_CONFLICT (0x18) |
| #define S_TERMINATED (0x20) |
| #define S_QUEUE_FULL (0x28) |
| #define S_ILLEGAL (0xff) |
| #define S_SENSE (0x80) |
| |
| /* |
| * Sense_keys |
| */ |
| |
| #define SENSE_NO_SENSE 0x0 |
| #define SENSE_RECOVERED_ERROR 0x1 |
| #define SENSE_NOT_READY 0x2 |
| #define SENSE_MEDIUM_ERROR 0x3 |
| #define SENSE_HARDWARE_ERROR 0x4 |
| #define SENSE_ILLEGAL_REQUEST 0x5 |
| #define SENSE_UNIT_ATTENTION 0x6 |
| #define SENSE_DATA_PROTECT 0x7 |
| #define SENSE_BLANK_CHECK 0x8 |
| #define SENSE_VENDOR_SPECIFIC 0x9 |
| #define SENSE_COPY_ABORTED 0xA |
| #define SENSE_ABORTED_COMMAND 0xB |
| #define SENSE_VOLUME_OVERFLOW 0xD |
| #define SENSE_MISCOMPARE 0xE |
| |
| #define SCSI_CHANGE_DEF 0x40 /* Change Definition (Optional) */ |
| #define SCSI_COMPARE 0x39 /* Compare (O) */ |
| #define SCSI_COPY 0x18 /* Copy (O) */ |
| #define SCSI_COP_VERIFY 0x3A /* Copy and Verify (O) */ |
| #define SCSI_INQUIRY 0x12 /* Inquiry (MANDATORY) */ |
| #define SCSI_LOG_SELECT 0x4C /* Log Select (O) */ |
| #define SCSI_LOG_SENSE 0x4D /* Log Sense (O) */ |
| #define SCSI_MODE_SEL6 0x15 /* Mode Select 6-byte (Device Specific) */ |
| #define SCSI_MODE_SEL10 0x55 /* Mode Select 10-byte (Device Specific) */ |
| #define SCSI_MODE_SEN6 0x1A /* Mode Sense 6-byte (Device Specific) */ |
| #define SCSI_MODE_SEN10 0x5A /* Mode Sense 10-byte (Device Specific) */ |
| #define SCSI_READ_BUFF 0x3C /* Read Buffer (O) */ |
| #define SCSI_REQ_SENSE 0x03 /* Request Sense (MANDATORY) */ |
| #define SCSI_SEND_DIAG 0x1D /* Send Diagnostic (O) */ |
| #define SCSI_TST_U_RDY 0x00 /* Test Unit Ready (MANDATORY) */ |
| #define SCSI_WRITE_BUFF 0x3B /* Write Buffer (O) */ |
| /*************************************************************************** |
| * %%% Commands Unique to Direct Access Devices %%% |
| ***************************************************************************/ |
| #define SCSI_COMPARE 0x39 /* Compare (O) */ |
| #define SCSI_FORMAT 0x04 /* Format Unit (MANDATORY) */ |
| #define SCSI_LCK_UN_CAC 0x36 /* Lock Unlock Cache (O) */ |
| #define SCSI_PREFETCH 0x34 /* Prefetch (O) */ |
| #define SCSI_MED_REMOVL 0x1E /* Prevent/Allow medium Removal (O) */ |
| #define SCSI_READ6 0x08 /* Read 6-byte (MANDATORY) */ |
| #define SCSI_READ10 0x28 /* Read 10-byte (MANDATORY) */ |
| #define SCSI_READ16 0x48 |
| #define SCSI_RD_CAPAC 0x25 /* Read Capacity (MANDATORY) */ |
| #define SCSI_RD_CAPAC10 SCSI_RD_CAPAC /* Read Capacity (10) */ |
| #define SCSI_RD_CAPAC16 0x9e /* Read Capacity (16) */ |
| #define SCSI_RD_DEFECT 0x37 /* Read Defect Data (O) */ |
| #define SCSI_READ_LONG 0x3E /* Read Long (O) */ |
| #define SCSI_REASS_BLK 0x07 /* Reassign Blocks (O) */ |
| #define SCSI_RCV_DIAG 0x1C /* Receive Diagnostic Results (O) */ |
| #define SCSI_RELEASE 0x17 /* Release Unit (MANDATORY) */ |
| #define SCSI_REZERO 0x01 /* Rezero Unit (O) */ |
| #define SCSI_SRCH_DAT_E 0x31 /* Search Data Equal (O) */ |
| #define SCSI_SRCH_DAT_H 0x30 /* Search Data High (O) */ |
| #define SCSI_SRCH_DAT_L 0x32 /* Search Data Low (O) */ |
| #define SCSI_SEEK6 0x0B /* Seek 6-Byte (O) */ |
| #define SCSI_SEEK10 0x2B /* Seek 10-Byte (O) */ |
| #define SCSI_SEND_DIAG 0x1D /* Send Diagnostics (MANDATORY) */ |
| #define SCSI_SET_LIMIT 0x33 /* Set Limits (O) */ |
| #define SCSI_START_STP 0x1B /* Start/Stop Unit (O) */ |
| #define SCSI_SYNC_CACHE 0x35 /* Synchronize Cache (O) */ |
| #define SCSI_VERIFY 0x2F /* Verify (O) */ |
| #define SCSI_WRITE6 0x0A /* Write 6-Byte (MANDATORY) */ |
| #define SCSI_WRITE10 0x2A /* Write 10-Byte (MANDATORY) */ |
| #define SCSI_WRT_VERIFY 0x2E /* Write and Verify (O) */ |
| #define SCSI_WRITE_LONG 0x3F /* Write Long (O) */ |
| #define SCSI_WRITE_SAME 0x41 /* Write Same (O) */ |
| |
| /** |
| * enum scsi_cmd_phase - current phase of the SCSI protocol |
| * |
| * @SCSIPH_START: Start phase |
| * @SCSIPH_DATA: Data phase |
| * @SCSIPH_STATUS: Status phase |
| */ |
| enum scsi_cmd_phase { |
| SCSIPH_START, |
| SCSIPH_DATA, |
| SCSIPH_STATUS, |
| }; |
| |
| /** |
| * struct scsi_inquiry_resp - holds a SCSI inquiry command |
| * |
| * @type; command type |
| * @flags; command flags |
| * @version; command version |
| * @data_format; data format |
| * @additional_len; additional data length |
| * @spare[3]; spare bytes |
| * @vendor[8]; vendor information |
| * @product[16]; production information |
| * @revision[4]; revision information |
| */ |
| struct scsi_inquiry_resp { |
| u8 type; |
| u8 flags; |
| u8 version; |
| u8 data_format; |
| u8 additional_len; |
| u8 spare[3]; |
| char vendor[8]; |
| char product[16]; |
| char revision[4]; |
| }; |
| |
| /** |
| * struct scsi_read_capacity_resp - holds the response to a read-capacity cmd |
| * |
| * @last_block_addr: Logical block address of last block |
| * @block_len: Length of each block in bytes |
| */ |
| struct scsi_read_capacity_resp { |
| u32 last_block_addr; |
| u32 block_len; |
| }; |
| |
| /** |
| * struct scsi_read10_req - holds a SCSI READ10 request |
| * |
| * @cmd; command type |
| * @lun_flags; LUN flags |
| * @lba; Logical block address to start reading from |
| * @spare; spare bytes |
| * @xfer_len: number of blocks to read |
| * @spare2: more spare bytes |
| */ |
| struct __packed scsi_read10_req { |
| u8 cmd; |
| u8 lun_flags; |
| u32 lba; |
| u8 spare; |
| u16 xfer_len; |
| u8 spare2[3]; |
| }; |
| |
| /** struct scsi_write10_req - data for the write10 command */ |
| struct __packed scsi_write10_req { |
| u8 cmd; |
| u8 lun_flags; |
| u32 lba; |
| u8 spare; |
| u16 xfer_len; |
| u8 spare2[3]; |
| }; |
| |
| /** |
| * struct scsi_plat - stores information about SCSI controller |
| * |
| * @base: Controller base address |
| * @max_lun: Maximum number of logical units |
| * @max_id: Maximum number of target ids |
| * @max_bytes_per_req: Maximum number of bytes per read/write request |
| */ |
| struct scsi_plat { |
| unsigned long base; |
| unsigned long max_lun; |
| unsigned long max_id; |
| unsigned long max_bytes_per_req; |
| }; |
| |
| /* Operations for SCSI */ |
| struct scsi_ops { |
| /** |
| * exec() - execute a command |
| * |
| * @dev: SCSI bus |
| * @cmd: Command to execute |
| * @return 0 if OK, -ve on error |
| */ |
| int (*exec)(struct udevice *dev, struct scsi_cmd *cmd); |
| |
| /** |
| * bus_reset() - reset the bus |
| * |
| * @dev: SCSI bus to reset |
| * @return 0 if OK, -ve on error |
| */ |
| int (*bus_reset)(struct udevice *dev); |
| |
| #if IS_ENABLED(CONFIG_BOUNCE_BUFFER) |
| /** |
| * buffer_aligned() - test memory alignment of block operation buffer |
| * |
| * Some devices have limited DMA capabilities and require that the |
| * buffers passed to them fit specific properties. This optional |
| * callback can be used to indicate whether a buffer alignment is |
| * suitable for the device DMA or not, and trigger use of generic |
| * bounce buffer implementation to help use of unsuitable buffers |
| * at the expense of performance degradation. |
| * |
| * @dev: Block device associated with the request |
| * @state: Bounce buffer state |
| * @return 1 if OK, 0 if unaligned |
| */ |
| int (*buffer_aligned)(struct udevice *dev, struct bounce_buffer *state); |
| #endif /* CONFIG_BOUNCE_BUFFER */ |
| }; |
| |
| #define scsi_get_ops(dev) ((struct scsi_ops *)(dev)->driver->ops) |
| |
| extern struct scsi_ops scsi_ops; |
| |
| /** |
| * scsi_exec() - execute a command |
| * |
| * @dev: SCSI bus |
| * @cmd: Command to execute |
| * Return: 0 if OK, -ve on error |
| */ |
| int scsi_exec(struct udevice *dev, struct scsi_cmd *cmd); |
| |
| /** |
| * scsi_bus_reset() - reset the bus |
| * |
| * @dev: SCSI bus to reset |
| * Return: 0 if OK, -ve on error |
| */ |
| int scsi_bus_reset(struct udevice *dev); |
| |
| /** |
| * scsi_scan() - Scan all SCSI controllers for available devices |
| * |
| * @vebose: true to show information about each device found |
| */ |
| int scsi_scan(bool verbose); |
| |
| /** |
| * scsi_scan_dev() - scan a SCSI bus and create devices |
| * |
| * @dev: SCSI bus |
| * @verbose: true to show information about each device found |
| */ |
| int scsi_scan_dev(struct udevice *dev, bool verbose); |
| |
| #define SCSI_IDENTIFY 0xC0 /* not used */ |
| |
| /* Hardware errors */ |
| #define SCSI_SEL_TIME_OUT 0x00000101 /* Selection time out */ |
| #define SCSI_HNS_TIME_OUT 0x00000102 /* Handshake */ |
| #define SCSI_MA_TIME_OUT 0x00000103 /* Phase error */ |
| #define SCSI_UNEXP_DIS 0x00000104 /* unexpected disconnect */ |
| |
| #define SCSI_INT_STATE 0x00010000 /* unknown Interrupt number is stored in 16 LSB */ |
| |
| #endif /* _SCSI_H */ |