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