mirror of
https://github.com/u-boot/u-boot.git
synced 2024-11-24 20:54:24 +08:00
4f543e82b9
Some devices have limited DMA capabilities and require that the buffers passed to them fit specific properties. Add new optional callback which can be used at driver level to indicate whether a buffer alignment is suitable for the device DMA or not. This is a pass-through callback from block uclass to drivers. Signed-off-by: Marek Vasut <marek.vasut+renesas@mailbox.org>
374 lines
10 KiB
C
374 lines
10 KiB
C
/* 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>
|
|
|
|
/* Fix this to the maximum */
|
|
#define SCSI_MAX_DEVICE \
|
|
(CONFIG_SYS_SCSI_MAX_SCSI_ID * CONFIG_SYS_SCSI_MAX_LUN)
|
|
|
|
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);
|
|
|
|
#ifndef CONFIG_DM_SCSI
|
|
void scsi_low_level_init(int busdevfunc);
|
|
void scsi_init(void);
|
|
#endif
|
|
|
|
#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 */
|