]> git.proxmox.com Git - mirror_ubuntu-bionic-kernel.git/blame - drivers/ide/ide-cd.h
ide-cd: coding style fixes for VERBOSE_IDE_CD_ERRORS code
[mirror_ubuntu-bionic-kernel.git] / drivers / ide / ide-cd.h
CommitLineData
1da177e4
LT
1/*
2 * linux/drivers/ide/ide_cd.h
3 *
4 * Copyright (C) 1996-98 Erik Andersen
5 * Copyright (C) 1998-2000 Jens Axboe
6 */
7#ifndef _IDE_CD_H
8#define _IDE_CD_H
9
10#include <linux/cdrom.h>
11#include <asm/byteorder.h>
12
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
15 memory, though. */
16
17#ifndef VERBOSE_IDE_CD_ERRORS
18#define VERBOSE_IDE_CD_ERRORS 1
19#endif
20
1da177e4
LT
21/*
22 * typical timeout for packet command
23 */
24#define ATAPI_WAIT_PC (60 * HZ)
25#define ATAPI_WAIT_WRITE_BUSY (10 * HZ)
26
27/************************************************************************/
28
29#define SECTOR_BITS 9
30#ifndef SECTOR_SIZE
31#define SECTOR_SIZE (1 << SECTOR_BITS)
32#endif
33#define SECTORS_PER_FRAME (CD_FRAMESIZE >> SECTOR_BITS)
34#define SECTOR_BUFFER_SIZE (CD_FRAMESIZE * 32)
1da177e4 35
455d80a9
BZ
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
39
2bc4cf2d
BZ
40enum {
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),
e59724c7
BZ
47 /* Drive is a pre ATAPI 1.2 drive. */
48 IDE_CD_FLAG_PRE_ATAPI12 = (1 << 3),
2bc4cf2d
BZ
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),
53 /*
54 * Drive does not provide data in multiples of SECTOR_SIZE
55 * when more than one interrupt is needed.
56 */
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),
e59724c7
BZ
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),
1da177e4
LT
74};
75
1da177e4
LT
76/* Structure of a MSF cdrom address. */
77struct atapi_msf {
78 byte reserved;
79 byte minute;
80 byte second;
81 byte frame;
82};
83
84/* Space to hold the disk TOC. */
85#define MAX_TRACKS 99
86struct atapi_toc_header {
87 unsigned short toc_length;
88 byte first_track;
89 byte last_track;
90};
91
92struct atapi_toc_entry {
93 byte reserved1;
94#if defined(__BIG_ENDIAN_BITFIELD)
95 __u8 adr : 4;
96 __u8 control : 4;
97#elif defined(__LITTLE_ENDIAN_BITFIELD)
98 __u8 control : 4;
99 __u8 adr : 4;
100#else
101#error "Please fix <asm/byteorder.h>"
102#endif
103 byte track;
104 byte reserved2;
105 union {
106 unsigned lba;
107 struct atapi_msf msf;
108 } addr;
109};
110
111struct atapi_toc {
112 int last_session_lba;
113 int xa_flag;
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. */
118};
119
1da177e4
LT
120/* Extra per-device info for cdrom drives. */
121struct cdrom_info {
122 ide_drive_t *drive;
123 ide_driver_t *driver;
124 struct gendisk *disk;
125 struct kref kref;
126
127 /* Buffer for table of contents. NULL if we haven't allocated
128 a TOC buffer for this device yet. */
129
130 struct atapi_toc *toc;
131
132 unsigned long sector_buffered;
133 unsigned long nsectors_buffered;
134 unsigned char *buffer;
135
136 /* The result of the last successful request sense command
137 on this device. */
138 struct request_sense sense_data;
139
140 struct request request_sense_request;
141 int dma;
1da177e4
LT
142 unsigned long last_block;
143 unsigned long start_seek;
1da177e4 144
2bc4cf2d
BZ
145 unsigned int cd_flags;
146
147 u8 max_speed; /* Max speed of the drive. */
148 u8 current_speed; /* Current speed of the drive. */
1da177e4
LT
149
150 /* Per-device info needed by cdrom.c generic driver. */
151 struct cdrom_device_info devinfo;
152
153 unsigned long write_timeout;
154};
155
156/****************************************************************************
157 * Descriptions of ATAPI error codes.
158 */
159
1da177e4
LT
160/* This stuff should be in cdrom.h, since it is now generic... */
161#if VERBOSE_IDE_CD_ERRORS
89d13ec7
BZ
162/* The generic packet command opcodes for CD/DVD Logical Units,
163 * From Table 57 of the SFF8090 Ver. 3 (Mt. Fuji) draft standard. */
1da177e4
LT
164static const struct {
165 unsigned short packet_command;
166 const char * const text;
167} packet_command_texts[] = {
168 { GPCMD_TEST_UNIT_READY, "Test Unit Ready" },
169 { GPCMD_REQUEST_SENSE, "Request Sense" },
170 { GPCMD_FORMAT_UNIT, "Format Unit" },
171 { GPCMD_INQUIRY, "Inquiry" },
172 { GPCMD_START_STOP_UNIT, "Start/Stop Unit" },
173 { GPCMD_PREVENT_ALLOW_MEDIUM_REMOVAL, "Prevent/Allow Medium Removal" },
174 { GPCMD_READ_FORMAT_CAPACITIES, "Read Format Capacities" },
175 { GPCMD_READ_CDVD_CAPACITY, "Read Cd/Dvd Capacity" },
176 { GPCMD_READ_10, "Read 10" },
177 { GPCMD_WRITE_10, "Write 10" },
178 { GPCMD_SEEK, "Seek" },
179 { GPCMD_WRITE_AND_VERIFY_10, "Write and Verify 10" },
180 { GPCMD_VERIFY_10, "Verify 10" },
181 { GPCMD_FLUSH_CACHE, "Flush Cache" },
182 { GPCMD_READ_SUBCHANNEL, "Read Subchannel" },
183 { GPCMD_READ_TOC_PMA_ATIP, "Read Table of Contents" },
184 { GPCMD_READ_HEADER, "Read Header" },
185 { GPCMD_PLAY_AUDIO_10, "Play Audio 10" },
186 { GPCMD_GET_CONFIGURATION, "Get Configuration" },
187 { GPCMD_PLAY_AUDIO_MSF, "Play Audio MSF" },
188 { GPCMD_PLAYAUDIO_TI, "Play Audio TrackIndex" },
89d13ec7
BZ
189 { GPCMD_GET_EVENT_STATUS_NOTIFICATION,
190 "Get Event Status Notification" },
1da177e4
LT
191 { GPCMD_PAUSE_RESUME, "Pause/Resume" },
192 { GPCMD_STOP_PLAY_SCAN, "Stop Play/Scan" },
193 { GPCMD_READ_DISC_INFO, "Read Disc Info" },
194 { GPCMD_READ_TRACK_RZONE_INFO, "Read Track Rzone Info" },
195 { GPCMD_RESERVE_RZONE_TRACK, "Reserve Rzone Track" },
196 { GPCMD_SEND_OPC, "Send OPC" },
197 { GPCMD_MODE_SELECT_10, "Mode Select 10" },
198 { GPCMD_REPAIR_RZONE_TRACK, "Repair Rzone Track" },
199 { GPCMD_MODE_SENSE_10, "Mode Sense 10" },
200 { GPCMD_CLOSE_TRACK, "Close Track" },
201 { GPCMD_BLANK, "Blank" },
202 { GPCMD_SEND_EVENT, "Send Event" },
203 { GPCMD_SEND_KEY, "Send Key" },
204 { GPCMD_REPORT_KEY, "Report Key" },
205 { GPCMD_LOAD_UNLOAD, "Load/Unload" },
206 { GPCMD_SET_READ_AHEAD, "Set Read-ahead" },
207 { GPCMD_READ_12, "Read 12" },
208 { GPCMD_GET_PERFORMANCE, "Get Performance" },
209 { GPCMD_SEND_DVD_STRUCTURE, "Send DVD Structure" },
210 { GPCMD_READ_DVD_STRUCTURE, "Read DVD Structure" },
211 { GPCMD_SET_STREAMING, "Set Streaming" },
212 { GPCMD_READ_CD_MSF, "Read CD MSF" },
213 { GPCMD_SCAN, "Scan" },
214 { GPCMD_SET_SPEED, "Set Speed" },
215 { GPCMD_PLAY_CD, "Play CD" },
216 { GPCMD_MECHANISM_STATUS, "Mechanism Status" },
217 { GPCMD_READ_CD, "Read CD" },
218};
219
1da177e4
LT
220/* From Table 303 of the SFF8090 Ver. 3 (Mt. Fuji) draft standard. */
221static const char * const sense_key_texts[16] = {
222 "No sense data",
223 "Recovered error",
224 "Not ready",
225 "Medium error",
226 "Hardware error",
227 "Illegal request",
228 "Unit attention",
229 "Data protect",
230 "Blank check",
231 "(reserved)",
232 "(reserved)",
233 "Aborted command",
234 "(reserved)",
235 "(reserved)",
236 "Miscompare",
237 "(reserved)",
238};
239
240/* From Table 304 of the SFF8090 Ver. 3 (Mt. Fuji) draft standard. */
241static const struct {
242 unsigned long asc_ascq;
243 const char * const text;
244} sense_data_texts[] = {
245 { 0x000000, "No additional sense information" },
246 { 0x000011, "Play operation in progress" },
247 { 0x000012, "Play operation paused" },
248 { 0x000013, "Play operation successfully completed" },
249 { 0x000014, "Play operation stopped due to error" },
250 { 0x000015, "No current audio status to return" },
251 { 0x010c0a, "Write error - padding blocks added" },
252 { 0x011700, "Recovered data with no error correction applied" },
253 { 0x011701, "Recovered data with retries" },
254 { 0x011702, "Recovered data with positive head offset" },
255 { 0x011703, "Recovered data with negative head offset" },
256 { 0x011704, "Recovered data with retries and/or CIRC applied" },
257 { 0x011705, "Recovered data using previous sector ID" },
258 { 0x011800, "Recovered data with error correction applied" },
259 { 0x011801, "Recovered data with error correction and retries applied"},
260 { 0x011802, "Recovered data - the data was auto-reallocated" },
261 { 0x011803, "Recovered data with CIRC" },
262 { 0x011804, "Recovered data with L-EC" },
89d13ec7
BZ
263 { 0x015d00, "Failure prediction threshold exceeded"
264 " - Predicted logical unit failure" },
265 { 0x015d01, "Failure prediction threshold exceeded"
266 " - Predicted media failure" },
1da177e4
LT
267 { 0x015dff, "Failure prediction threshold exceeded - False" },
268 { 0x017301, "Power calibration area almost full" },
269 { 0x020400, "Logical unit not ready - cause not reportable" },
270 /* Following is misspelled in ATAPI 2.6, _and_ in Mt. Fuji */
89d13ec7
BZ
271 { 0x020401, "Logical unit not ready"
272 " - in progress [sic] of becoming ready" },
1da177e4
LT
273 { 0x020402, "Logical unit not ready - initializing command required" },
274 { 0x020403, "Logical unit not ready - manual intervention required" },
275 { 0x020404, "Logical unit not ready - format in progress" },
276 { 0x020407, "Logical unit not ready - operation in progress" },
277 { 0x020408, "Logical unit not ready - long write in progress" },
278 { 0x020600, "No reference position found (media may be upside down)" },
279 { 0x023000, "Incompatible medium installed" },
280 { 0x023a00, "Medium not present" },
281 { 0x025300, "Media load or eject failed" },
282 { 0x025700, "Unable to recover table of contents" },
283 { 0x030300, "Peripheral device write fault" },
284 { 0x030301, "No write current" },
285 { 0x030302, "Excessive write errors" },
286 { 0x030c00, "Write error" },
287 { 0x030c01, "Write error - Recovered with auto reallocation" },
288 { 0x030c02, "Write error - auto reallocation failed" },
289 { 0x030c03, "Write error - recommend reassignment" },
290 { 0x030c04, "Compression check miscompare error" },
291 { 0x030c05, "Data expansion occurred during compress" },
292 { 0x030c06, "Block not compressible" },
293 { 0x030c07, "Write error - recovery needed" },
294 { 0x030c08, "Write error - recovery failed" },
295 { 0x030c09, "Write error - loss of streaming" },
296 { 0x031100, "Unrecovered read error" },
297 { 0x031106, "CIRC unrecovered error" },
298 { 0x033101, "Format command failed" },
299 { 0x033200, "No defect spare location available" },
300 { 0x033201, "Defect list update failure" },
301 { 0x035100, "Erase failure" },
302 { 0x037200, "Session fixation error" },
303 { 0x037201, "Session fixation error writin lead-in" },
304 { 0x037202, "Session fixation error writin lead-out" },
305 { 0x037300, "CD control error" },
306 { 0x037302, "Power calibration area is full" },
307 { 0x037303, "Power calibration area error" },
308 { 0x037304, "Program memory area / RMA update failure" },
309 { 0x037305, "Program memory area / RMA is full" },
310 { 0x037306, "Program memory area / RMA is (almost) full" },
1da177e4
LT
311 { 0x040200, "No seek complete" },
312 { 0x040300, "Write fault" },
313 { 0x040900, "Track following error" },
314 { 0x040901, "Tracking servo failure" },
315 { 0x040902, "Focus servo failure" },
316 { 0x040903, "Spindle servo failure" },
317 { 0x041500, "Random positioning error" },
318 { 0x041501, "Mechanical positioning or changer error" },
319 { 0x041502, "Positioning error detected by read of medium" },
320 { 0x043c00, "Mechanical positioning or changer error" },
321 { 0x044000, "Diagnostic failure on component (ASCQ)" },
322 { 0x044400, "Internal CD/DVD logical unit failure" },
323 { 0x04b600, "Media load mechanism failed" },
324 { 0x051a00, "Parameter list length error" },
325 { 0x052000, "Invalid command operation code" },
326 { 0x052100, "Logical block address out of range" },
327 { 0x052102, "Invalid address for write" },
328 { 0x052400, "Invalid field in command packet" },
329 { 0x052600, "Invalid field in parameter list" },
330 { 0x052601, "Parameter not supported" },
331 { 0x052602, "Parameter value invalid" },
332 { 0x052700, "Write protected media" },
333 { 0x052c00, "Command sequence error" },
334 { 0x052c03, "Current program area is not empty" },
335 { 0x052c04, "Current program area is empty" },
336 { 0x053001, "Cannot read medium - unknown format" },
337 { 0x053002, "Cannot read medium - incompatible format" },
338 { 0x053900, "Saving parameters not supported" },
339 { 0x054e00, "Overlapped commands attempted" },
340 { 0x055302, "Medium removal prevented" },
341 { 0x055500, "System resource failure" },
342 { 0x056300, "End of user area encountered on this track" },
343 { 0x056400, "Illegal mode for this track or incompatible medium" },
89d13ec7
BZ
344 { 0x056f00, "Copy protection key exchange failure"
345 " - Authentication failure" },
1da177e4 346 { 0x056f01, "Copy protection key exchange failure - Key not present" },
89d13ec7
BZ
347 { 0x056f02, "Copy protection key exchange failure"
348 " - Key not established" },
1da177e4
LT
349 { 0x056f03, "Read of scrambled sector without authentication" },
350 { 0x056f04, "Media region code is mismatched to logical unit" },
89d13ec7
BZ
351 { 0x056f05, "Drive region must be permanent"
352 " / region reset count error" },
1da177e4
LT
353 { 0x057203, "Session fixation error - incomplete track in session" },
354 { 0x057204, "Empty or partially written reserved track" },
355 { 0x057205, "No more RZONE reservations are allowed" },
356 { 0x05bf00, "Loss of streaming" },
357 { 0x062800, "Not ready to ready transition, medium may have changed" },
358 { 0x062900, "Power on, reset or hardware reset occurred" },
359 { 0x062a00, "Parameters changed" },
360 { 0x062a01, "Mode parameters changed" },
361 { 0x062e00, "Insufficient time for operation" },
362 { 0x063f00, "Logical unit operating conditions have changed" },
363 { 0x063f01, "Microcode has been changed" },
364 { 0x065a00, "Operator request or state change input (unspecified)" },
365 { 0x065a01, "Operator medium removal request" },
366 { 0x0bb900, "Play operation aborted" },
1da177e4
LT
367 /* Here we use 0xff for the key (not a valid key) to signify
368 * that these can have _any_ key value associated with them... */
369 { 0xff0401, "Logical unit is in process of becoming ready" },
370 { 0xff0400, "Logical unit not ready, cause not reportable" },
371 { 0xff0402, "Logical unit not ready, initializing command required" },
372 { 0xff0403, "Logical unit not ready, manual intervention required" },
373 { 0xff0500, "Logical unit does not respond to selection" },
374 { 0xff0800, "Logical unit communication failure" },
375 { 0xff0802, "Logical unit communication parity error" },
376 { 0xff0801, "Logical unit communication time-out" },
377 { 0xff2500, "Logical unit not supported" },
378 { 0xff4c00, "Logical unit failed self-configuration" },
379 { 0xff3e00, "Logical unit has not self-configured yet" },
380};
381#endif
382
383
384#endif /* _IDE_CD_H */