2 * linux/drivers/ide/ide_cd.h
4 * Copyright (C) 1996-98 Erik Andersen
5 * Copyright (C) 1998-2000 Jens Axboe
10 #include <linux/cdrom.h>
11 #include <asm/byteorder.h>
13 /* Turn this on to have the driver print out the meanings of the
14 ATAPI error codes. This will use up additional kernel-space
17 #ifndef VERBOSE_IDE_CD_ERRORS
18 #define VERBOSE_IDE_CD_ERRORS 1
22 * typical timeout for packet command
24 #define ATAPI_WAIT_PC (60 * HZ)
25 #define ATAPI_WAIT_WRITE_BUSY (10 * HZ)
27 /************************************************************************/
31 #define SECTOR_SIZE (1 << SECTOR_BITS)
33 #define SECTORS_PER_FRAME (CD_FRAMESIZE >> SECTOR_BITS)
34 #define SECTOR_BUFFER_SIZE (CD_FRAMESIZE * 32)
36 /* Capabilities Page size including 8 bytes of Mode Page Header */
37 #define ATAPI_CAPABILITIES_PAGE_SIZE (8 + 20)
38 #define ATAPI_CAPABILITIES_PAGE_PAD_SIZE 4
41 /* Device sends an interrupt when ready for a packet command. */
42 IDE_CD_FLAG_DRQ_INTERRUPT = (1 << 0),
43 /* Drive cannot lock the door. */
44 IDE_CD_FLAG_NO_DOORLOCK = (1 << 1),
45 /* Drive cannot eject the disc. */
46 IDE_CD_FLAG_NO_EJECT = (1 << 2),
47 /* Drive is a pre ATAPI 1.2 drive. */
48 IDE_CD_FLAG_PRE_ATAPI12 = (1 << 3),
49 /* TOC addresses are in BCD. */
50 IDE_CD_FLAG_TOCADDR_AS_BCD = (1 << 4),
51 /* TOC track numbers are in BCD. */
52 IDE_CD_FLAG_TOCTRACKS_AS_BCD = (1 << 5),
54 * Drive does not provide data in multiples of SECTOR_SIZE
55 * when more than one interrupt is needed.
57 IDE_CD_FLAG_LIMIT_NFRAMES = (1 << 6),
58 /* Seeking in progress. */
59 IDE_CD_FLAG_SEEKING = (1 << 7),
60 /* Driver has noticed a media change. */
61 IDE_CD_FLAG_MEDIA_CHANGED = (1 << 8),
62 /* Saved TOC information is current. */
63 IDE_CD_FLAG_TOC_VALID = (1 << 9),
64 /* We think that the drive door is locked. */
65 IDE_CD_FLAG_DOOR_LOCKED = (1 << 10),
66 /* SET_CD_SPEED command is unsupported. */
67 IDE_CD_FLAG_NO_SPEED_SELECT = (1 << 11),
68 IDE_CD_FLAG_VERTOS_300_SSD = (1 << 12),
69 IDE_CD_FLAG_VERTOS_600_ESD = (1 << 13),
70 IDE_CD_FLAG_SANYO_3CD = (1 << 14),
71 IDE_CD_FLAG_FULL_CAPS_PAGE = (1 << 15),
72 IDE_CD_FLAG_PLAY_AUDIO_OK = (1 << 16),
73 IDE_CD_FLAG_LE_SPEED_FIELDS = (1 << 17),
76 /* Structure of a MSF cdrom address. */
84 /* Space to hold the disk TOC. */
86 struct atapi_toc_header {
87 unsigned short toc_length;
92 struct atapi_toc_entry {
94 #if defined(__BIG_ENDIAN_BITFIELD)
97 #elif defined(__LITTLE_ENDIAN_BITFIELD)
101 #error "Please fix <asm/byteorder.h>"
107 struct atapi_msf msf;
112 int last_session_lba;
114 unsigned long capacity;
115 struct atapi_toc_header hdr;
116 struct atapi_toc_entry ent[MAX_TRACKS+1];
117 /* One extra for the leadout. */
120 /* Extra per-device info for cdrom drives. */
123 ide_driver_t *driver;
124 struct gendisk *disk;
127 /* Buffer for table of contents. NULL if we haven't allocated
128 a TOC buffer for this device yet. */
130 struct atapi_toc *toc;
132 unsigned long sector_buffered;
133 unsigned long nsectors_buffered;
134 unsigned char *buffer;
136 /* The result of the last successful request sense command
138 struct request_sense sense_data;
140 struct request request_sense_request;
142 unsigned long last_block;
143 unsigned long start_seek;
145 unsigned int cd_flags;
147 u8 max_speed; /* Max speed of the drive. */
148 u8 current_speed; /* Current speed of the drive. */
150 /* Per-device info needed by cdrom.c generic driver. */
151 struct cdrom_device_info devinfo;
153 unsigned long write_timeout;
156 /****************************************************************************
157 * Descriptions of ATAPI error codes.
160 /* This stuff should be in cdrom.h, since it is now generic... */
162 /* ATAPI sense keys (from table 140 of ATAPI 2.6) */
163 #define NO_SENSE 0x00
164 #define RECOVERED_ERROR 0x01
165 #define NOT_READY 0x02
166 #define MEDIUM_ERROR 0x03
167 #define HARDWARE_ERROR 0x04
168 #define ILLEGAL_REQUEST 0x05
169 #define UNIT_ATTENTION 0x06
170 #define DATA_PROTECT 0x07
171 #define BLANK_CHECK 0x08
172 #define ABORTED_COMMAND 0x0b
173 #define MISCOMPARE 0x0e
177 /* This stuff should be in cdrom.h, since it is now generic... */
178 #if VERBOSE_IDE_CD_ERRORS
180 /* The generic packet command opcodes for CD/DVD Logical Units,
181 * From Table 57 of the SFF8090 Ver. 3 (Mt. Fuji) draft standard. */
182 static const struct {
183 unsigned short packet_command;
184 const char * const text;
185 } packet_command_texts[] = {
186 { GPCMD_TEST_UNIT_READY, "Test Unit Ready" },
187 { GPCMD_REQUEST_SENSE, "Request Sense" },
188 { GPCMD_FORMAT_UNIT, "Format Unit" },
189 { GPCMD_INQUIRY, "Inquiry" },
190 { GPCMD_START_STOP_UNIT, "Start/Stop Unit" },
191 { GPCMD_PREVENT_ALLOW_MEDIUM_REMOVAL, "Prevent/Allow Medium Removal" },
192 { GPCMD_READ_FORMAT_CAPACITIES, "Read Format Capacities" },
193 { GPCMD_READ_CDVD_CAPACITY, "Read Cd/Dvd Capacity" },
194 { GPCMD_READ_10, "Read 10" },
195 { GPCMD_WRITE_10, "Write 10" },
196 { GPCMD_SEEK, "Seek" },
197 { GPCMD_WRITE_AND_VERIFY_10, "Write and Verify 10" },
198 { GPCMD_VERIFY_10, "Verify 10" },
199 { GPCMD_FLUSH_CACHE, "Flush Cache" },
200 { GPCMD_READ_SUBCHANNEL, "Read Subchannel" },
201 { GPCMD_READ_TOC_PMA_ATIP, "Read Table of Contents" },
202 { GPCMD_READ_HEADER, "Read Header" },
203 { GPCMD_PLAY_AUDIO_10, "Play Audio 10" },
204 { GPCMD_GET_CONFIGURATION, "Get Configuration" },
205 { GPCMD_PLAY_AUDIO_MSF, "Play Audio MSF" },
206 { GPCMD_PLAYAUDIO_TI, "Play Audio TrackIndex" },
207 { GPCMD_GET_EVENT_STATUS_NOTIFICATION, "Get Event Status Notification" },
208 { GPCMD_PAUSE_RESUME, "Pause/Resume" },
209 { GPCMD_STOP_PLAY_SCAN, "Stop Play/Scan" },
210 { GPCMD_READ_DISC_INFO, "Read Disc Info" },
211 { GPCMD_READ_TRACK_RZONE_INFO, "Read Track Rzone Info" },
212 { GPCMD_RESERVE_RZONE_TRACK, "Reserve Rzone Track" },
213 { GPCMD_SEND_OPC, "Send OPC" },
214 { GPCMD_MODE_SELECT_10, "Mode Select 10" },
215 { GPCMD_REPAIR_RZONE_TRACK, "Repair Rzone Track" },
216 { GPCMD_MODE_SENSE_10, "Mode Sense 10" },
217 { GPCMD_CLOSE_TRACK, "Close Track" },
218 { GPCMD_BLANK, "Blank" },
219 { GPCMD_SEND_EVENT, "Send Event" },
220 { GPCMD_SEND_KEY, "Send Key" },
221 { GPCMD_REPORT_KEY, "Report Key" },
222 { GPCMD_LOAD_UNLOAD, "Load/Unload" },
223 { GPCMD_SET_READ_AHEAD, "Set Read-ahead" },
224 { GPCMD_READ_12, "Read 12" },
225 { GPCMD_GET_PERFORMANCE, "Get Performance" },
226 { GPCMD_SEND_DVD_STRUCTURE, "Send DVD Structure" },
227 { GPCMD_READ_DVD_STRUCTURE, "Read DVD Structure" },
228 { GPCMD_SET_STREAMING, "Set Streaming" },
229 { GPCMD_READ_CD_MSF, "Read CD MSF" },
230 { GPCMD_SCAN, "Scan" },
231 { GPCMD_SET_SPEED, "Set Speed" },
232 { GPCMD_PLAY_CD, "Play CD" },
233 { GPCMD_MECHANISM_STATUS, "Mechanism Status" },
234 { GPCMD_READ_CD, "Read CD" },
239 /* From Table 303 of the SFF8090 Ver. 3 (Mt. Fuji) draft standard. */
240 static const char * const sense_key_texts[16] = {
259 /* From Table 304 of the SFF8090 Ver. 3 (Mt. Fuji) draft standard. */
260 static const struct {
261 unsigned long asc_ascq;
262 const char * const text;
263 } sense_data_texts[] = {
264 { 0x000000, "No additional sense information" },
265 { 0x000011, "Play operation in progress" },
266 { 0x000012, "Play operation paused" },
267 { 0x000013, "Play operation successfully completed" },
268 { 0x000014, "Play operation stopped due to error" },
269 { 0x000015, "No current audio status to return" },
270 { 0x010c0a, "Write error - padding blocks added" },
271 { 0x011700, "Recovered data with no error correction applied" },
272 { 0x011701, "Recovered data with retries" },
273 { 0x011702, "Recovered data with positive head offset" },
274 { 0x011703, "Recovered data with negative head offset" },
275 { 0x011704, "Recovered data with retries and/or CIRC applied" },
276 { 0x011705, "Recovered data using previous sector ID" },
277 { 0x011800, "Recovered data with error correction applied" },
278 { 0x011801, "Recovered data with error correction and retries applied"},
279 { 0x011802, "Recovered data - the data was auto-reallocated" },
280 { 0x011803, "Recovered data with CIRC" },
281 { 0x011804, "Recovered data with L-EC" },
283 "Failure prediction threshold exceeded - Predicted logical unit failure" },
285 "Failure prediction threshold exceeded - Predicted media failure" },
286 { 0x015dff, "Failure prediction threshold exceeded - False" },
287 { 0x017301, "Power calibration area almost full" },
288 { 0x020400, "Logical unit not ready - cause not reportable" },
289 /* Following is misspelled in ATAPI 2.6, _and_ in Mt. Fuji */
291 "Logical unit not ready - in progress [sic] of becoming ready" },
292 { 0x020402, "Logical unit not ready - initializing command required" },
293 { 0x020403, "Logical unit not ready - manual intervention required" },
294 { 0x020404, "Logical unit not ready - format in progress" },
295 { 0x020407, "Logical unit not ready - operation in progress" },
296 { 0x020408, "Logical unit not ready - long write in progress" },
297 { 0x020600, "No reference position found (media may be upside down)" },
298 { 0x023000, "Incompatible medium installed" },
299 { 0x023a00, "Medium not present" },
300 { 0x025300, "Media load or eject failed" },
301 { 0x025700, "Unable to recover table of contents" },
302 { 0x030300, "Peripheral device write fault" },
303 { 0x030301, "No write current" },
304 { 0x030302, "Excessive write errors" },
305 { 0x030c00, "Write error" },
306 { 0x030c01, "Write error - Recovered with auto reallocation" },
307 { 0x030c02, "Write error - auto reallocation failed" },
308 { 0x030c03, "Write error - recommend reassignment" },
309 { 0x030c04, "Compression check miscompare error" },
310 { 0x030c05, "Data expansion occurred during compress" },
311 { 0x030c06, "Block not compressible" },
312 { 0x030c07, "Write error - recovery needed" },
313 { 0x030c08, "Write error - recovery failed" },
314 { 0x030c09, "Write error - loss of streaming" },
315 { 0x031100, "Unrecovered read error" },
316 { 0x031106, "CIRC unrecovered error" },
317 { 0x033101, "Format command failed" },
318 { 0x033200, "No defect spare location available" },
319 { 0x033201, "Defect list update failure" },
320 { 0x035100, "Erase failure" },
321 { 0x037200, "Session fixation error" },
322 { 0x037201, "Session fixation error writin lead-in" },
323 { 0x037202, "Session fixation error writin lead-out" },
324 { 0x037300, "CD control error" },
325 { 0x037302, "Power calibration area is full" },
326 { 0x037303, "Power calibration area error" },
327 { 0x037304, "Program memory area / RMA update failure" },
328 { 0x037305, "Program memory area / RMA is full" },
329 { 0x037306, "Program memory area / RMA is (almost) full" },
331 { 0x040200, "No seek complete" },
332 { 0x040300, "Write fault" },
333 { 0x040900, "Track following error" },
334 { 0x040901, "Tracking servo failure" },
335 { 0x040902, "Focus servo failure" },
336 { 0x040903, "Spindle servo failure" },
337 { 0x041500, "Random positioning error" },
338 { 0x041501, "Mechanical positioning or changer error" },
339 { 0x041502, "Positioning error detected by read of medium" },
340 { 0x043c00, "Mechanical positioning or changer error" },
341 { 0x044000, "Diagnostic failure on component (ASCQ)" },
342 { 0x044400, "Internal CD/DVD logical unit failure" },
343 { 0x04b600, "Media load mechanism failed" },
344 { 0x051a00, "Parameter list length error" },
345 { 0x052000, "Invalid command operation code" },
346 { 0x052100, "Logical block address out of range" },
347 { 0x052102, "Invalid address for write" },
348 { 0x052400, "Invalid field in command packet" },
349 { 0x052600, "Invalid field in parameter list" },
350 { 0x052601, "Parameter not supported" },
351 { 0x052602, "Parameter value invalid" },
352 { 0x052700, "Write protected media" },
353 { 0x052c00, "Command sequence error" },
354 { 0x052c03, "Current program area is not empty" },
355 { 0x052c04, "Current program area is empty" },
356 { 0x053001, "Cannot read medium - unknown format" },
357 { 0x053002, "Cannot read medium - incompatible format" },
358 { 0x053900, "Saving parameters not supported" },
359 { 0x054e00, "Overlapped commands attempted" },
360 { 0x055302, "Medium removal prevented" },
361 { 0x055500, "System resource failure" },
362 { 0x056300, "End of user area encountered on this track" },
363 { 0x056400, "Illegal mode for this track or incompatible medium" },
364 { 0x056f00, "Copy protection key exchange failure - Authentication failure" },
365 { 0x056f01, "Copy protection key exchange failure - Key not present" },
366 { 0x056f02, "Copy protection key exchange failure - Key not established" },
367 { 0x056f03, "Read of scrambled sector without authentication" },
368 { 0x056f04, "Media region code is mismatched to logical unit" },
369 { 0x056f05, "Drive region must be permanent / region reset count error" },
370 { 0x057203, "Session fixation error - incomplete track in session" },
371 { 0x057204, "Empty or partially written reserved track" },
372 { 0x057205, "No more RZONE reservations are allowed" },
373 { 0x05bf00, "Loss of streaming" },
374 { 0x062800, "Not ready to ready transition, medium may have changed" },
375 { 0x062900, "Power on, reset or hardware reset occurred" },
376 { 0x062a00, "Parameters changed" },
377 { 0x062a01, "Mode parameters changed" },
378 { 0x062e00, "Insufficient time for operation" },
379 { 0x063f00, "Logical unit operating conditions have changed" },
380 { 0x063f01, "Microcode has been changed" },
381 { 0x065a00, "Operator request or state change input (unspecified)" },
382 { 0x065a01, "Operator medium removal request" },
383 { 0x0bb900, "Play operation aborted" },
385 /* Here we use 0xff for the key (not a valid key) to signify
386 * that these can have _any_ key value associated with them... */
387 { 0xff0401, "Logical unit is in process of becoming ready" },
388 { 0xff0400, "Logical unit not ready, cause not reportable" },
389 { 0xff0402, "Logical unit not ready, initializing command required" },
390 { 0xff0403, "Logical unit not ready, manual intervention required" },
391 { 0xff0500, "Logical unit does not respond to selection" },
392 { 0xff0800, "Logical unit communication failure" },
393 { 0xff0802, "Logical unit communication parity error" },
394 { 0xff0801, "Logical unit communication time-out" },
395 { 0xff2500, "Logical unit not supported" },
396 { 0xff4c00, "Logical unit failed self-configuration" },
397 { 0xff3e00, "Logical unit has not self-configured yet" },
402 #endif /* _IDE_CD_H */