MdePkg/Include/IndustryStandard/Atapi.h

   1 /** @file
   2   This file contains just some basic definitions that are needed by drivers
   3   that dealing with ATA/ATAPI interface.
   4
   5 Copyright (c) 2007 - 2008, Intel Corporation
   6 All rights reserved. This program and the accompanying materials
   7 are licensed and made available under the terms and conditions of the BSD License
   8 which accompanies this distribution.  The full text of the license may be found at
   9 http://opensource.org/licenses/bsd-license.php
  10
  11 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  12 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
  13
  14 **/
  15
  16 #ifndef _ATAPI_H_
  17 #define _ATAPI_H_
  18
  19 #pragma pack(1)
  20
  21 ///
  22 /// ATAPI_IDENTIFY_DATA is defined in ATA-6
  23 ///
  24 typedef struct {
  25     UINT16  config;             ///< General Configuration
  26     UINT16  obsolete_1;
  27     UINT16  specific_config;
  28     UINT16  obsolete_3;
  29     UINT16  retired_4_5[2];
  30     UINT16  obsolete_6;
  31     UINT16  cfa_reserved_7_8[2];
  32     UINT16  retired_9;
  33     CHAR8   SerialNo[20];       ///< ASCII
  34     UINT16  retired_20_21[2];
  35     UINT16  obsolete_22;
  36     CHAR8   FirmwareVer[8];     ///< ASCII
  37     CHAR8   ModelName[40];      ///< ASCII
  38     UINT16  multi_sector_cmd_max_sct_cnt;
  39     UINT16  reserved_48;
  40     UINT16  capabilities_49;
  41     UINT16  capabilities_50;
  42     UINT16  obsolete_51_52[2];
  43     UINT16  field_validity;
  44     UINT16  obsolete_54_58[5];
  45     UINT16  mutil_sector_setting;
  46     UINT16  user_addressable_sectors_lo;
  47     UINT16  user_addressable_sectors_hi;
  48     UINT16  obsolete_62;
  49     UINT16  multi_word_dma_mode;
  50     UINT16  advanced_pio_modes;
  51     UINT16  min_multi_word_dma_cycle_time;
  52     UINT16  rec_multi_word_dma_cycle_time;
  53     UINT16  min_pio_cycle_time_without_flow_control;
  54     UINT16  min_pio_cycle_time_with_flow_control;
  55     UINT16  reserved_69_74[6];
  56     UINT16  queue_depth;
  57     UINT16  reserved_76_79[4];
  58     UINT16  major_version_no;
  59     UINT16  minor_version_no;
  60     UINT16  cmd_set_support_82;
  61     UINT16  cmd_set_support_83;
  62     UINT16  cmd_feature_support;
  63     UINT16  cmd_feature_enable_85;
  64     UINT16  cmd_feature_enable_86;
  65     UINT16  cmd_feature_default;
  66     UINT16  ultra_dma_select;
  67     UINT16  time_required_for_sec_erase;
  68     UINT16  time_required_for_enhanced_sec_erase;
  69     UINT16  current_advanced_power_mgmt_value;
  70     UINT16  master_pwd_revison_code;
  71     UINT16  hardware_reset_result;
  72     UINT16  current_auto_acoustic_mgmt_value;
  73     UINT16  reserved_95_99[5];
  74     UINT16  max_user_lba_for_48bit_addr[4];
  75     UINT16  reserved_104_126[23];
  76     UINT16  removable_media_status_notification_support;
  77     UINT16  security_status;
  78     UINT16  vendor_data_129_159[31];
  79     UINT16  cfa_power_mode;
  80     UINT16  cfa_reserved_161_175[15];
  81     UINT16  current_media_serial_no[30];
  82     UINT16  reserved_206_254[49];
  83     UINT16  integrity_word;
  84 } ATAPI_IDENTIFY_DATA;
  85
  86 ///
  87 /// Standard Quiry Data format, defined in SFF-8070i(ATAPI Removable Rewritable Specification)
  88 ///
  89 typedef struct {
  90   UINT8 peripheral_type;
  91   UINT8 RMB;
  92   UINT8 version;
  93   UINT8 response_data_format;
  94   UINT8 addnl_length;     ///< n - 4, Numbers of bytes following this one
  95   UINT8 reserved_5;
  96   UINT8 reserved_6;
  97   UINT8 reserved_7;
  98   UINT8 vendor_info[8];
  99   UINT8 product_id[16];
 100   UINT8 product_revision_level[4];
 101   UINT8 vendor_specific_36_55[55 - 36 + 1];
 102   UINT8 reserved_56_95[95 - 56 + 1];
 103   ///
 104   /// Vendor specific parameters fields, the sizeof (ATAPI_INQUIRY_DATA) is 254
 105   /// since allocation_length is one byte in ATAPI_INQUIRY_CMD.
 106   ///
 107   UINT8 vendor_specific_96_253[253 - 96 + 1];
 108 } ATAPI_INQUIRY_DATA;
 109
 110 ///
 111 /// Request Sense Standard Data, defined in SFF-8070i(ATAPI Removable Rewritable Specification)
 112 ///
 113 typedef struct {
 114   UINT8 error_code : 7;
 115   UINT8 valid : 1;
 116   UINT8 reserved_1;
 117   UINT8 sense_key : 4;
 118   UINT8 reserved_2 : 1;
 119   UINT8 Vendor_specifc_1 : 3;
 120   UINT8 vendor_specific_3;
 121   UINT8 vendor_specific_4;
 122   UINT8 vendor_specific_5;
 123   UINT8 vendor_specific_6;
 124   UINT8 addnl_sense_length;           ///< n - 7
 125   UINT8 vendor_specific_8;
 126   UINT8 vendor_specific_9;
 127   UINT8 vendor_specific_10;
 128   UINT8 vendor_specific_11;
 129   UINT8 addnl_sense_code;             ///< mandatory
 130   UINT8 addnl_sense_code_qualifier;   ///< mandatory
 131   UINT8 field_replaceable_unit_code;  ///< optional
 132   UINT8 sense_key_specific_15 : 7;
 133   UINT8 SKSV : 1;
 134   UINT8 sense_key_specific_16;
 135   UINT8 sense_key_specific_17;
 136 } ATAPI_REQUEST_SENSE_DATA;
 137
 138 ///
 139 /// READ CAPACITY Data, defined in SFF-8070i(ATAPI Removable Rewritable Specification)
 140 ///
 141 typedef struct {
 142   UINT8 LastLba3;
 143   UINT8 LastLba2;
 144   UINT8 LastLba1;
 145   UINT8 LastLba0;
 146   UINT8 BlockSize3;
 147   UINT8 BlockSize2;
 148   UINT8 BlockSize1;
 149   UINT8 BlockSize0;
 150 } ATAPI_READ_CAPACITY_DATA;
 151
 152 ///
 153 /// Capacity List Header + Current/Maximum Capacity Descriptor,
 154 /// defined in SFF-8070i(ATAPI Removable Rewritable Specification)
 155 ///
 156 typedef struct {
 157   UINT8 reserved_0;
 158   UINT8 reserved_1;
 159   UINT8 reserved_2;
 160   UINT8 Capacity_Length;
 161   UINT8 LastLba3;
 162   UINT8 LastLba2;
 163   UINT8 LastLba1;
 164   UINT8 LastLba0;
 165   UINT8 DesCode : 2;
 166   UINT8 reserved_9 : 6;
 167   UINT8 BlockSize2;
 168   UINT8 BlockSize1;
 169   UINT8 BlockSize0;
 170 } ATAPI_READ_FORMAT_CAPACITY_DATA;
 171
 172 ///
 173 /// Test Unit Ready Command, defined in SFF-8070i(ATAPI Removable Rewritable Specification)
 174 ///
 175 typedef struct {
 176   UINT8 opcode;
 177   UINT8 reserved_1;
 178   UINT8 reserved_2;
 179   UINT8 reserved_3;
 180   UINT8 reserved_4;
 181   UINT8 reserved_5;
 182   UINT8 reserved_6;
 183   UINT8 reserved_7;
 184   UINT8 reserved_8;
 185   UINT8 reserved_9;
 186   UINT8 reserved_10;
 187   UINT8 reserved_11;
 188 } ATAPI_TEST_UNIT_READY_CMD;
 189
 190 ///
 191 /// INQUIRY Command, defined in SFF-8070i(ATAPI Removable Rewritable Specification)
 192 ///
 193 typedef struct {
 194   UINT8 opcode;
 195   UINT8 reserved_1 : 5;
 196   UINT8 lun : 3;
 197   UINT8 page_code;        ///< defined in SFF8090i, V6
 198   UINT8 reserved_3;
 199   UINT8 allocation_length;
 200   UINT8 reserved_5;
 201   UINT8 reserved_6;
 202   UINT8 reserved_7;
 203   UINT8 reserved_8;
 204   UINT8 reserved_9;
 205   UINT8 reserved_10;
 206   UINT8 reserved_11;
 207 } ATAPI_INQUIRY_CMD;
 208
 209 ///
 210 /// REQUEST SENSE Command, defined in SFF-8070i(ATAPI Removable Rewritable Specification)
 211 ///
 212 typedef struct {
 213   UINT8 opcode;
 214   UINT8 reserved_1 : 5;
 215   UINT8 lun : 3;
 216   UINT8 reserved_2;
 217   UINT8 reserved_3;
 218   UINT8 allocation_length;
 219   UINT8 reserved_5;
 220   UINT8 reserved_6;
 221   UINT8 reserved_7;
 222   UINT8 reserved_8;
 223   UINT8 reserved_9;
 224   UINT8 reserved_10;
 225   UINT8 reserved_11;
 226 } ATAPI_REQUEST_SENSE_CMD;
 227
 228 ///
 229 /// READ (10) Command, defined in SFF-8070i(ATAPI Removable Rewritable Specification)
 230 ///
 231 typedef struct {
 232   UINT8 opcode;
 233   UINT8 reserved_1 : 5;
 234   UINT8 lun : 3;
 235   UINT8 Lba0;
 236   UINT8 Lba1;
 237   UINT8 Lba2;
 238   UINT8 Lba3;
 239   UINT8 reserved_6;
 240   UINT8 TranLen0;
 241   UINT8 TranLen1;
 242   UINT8 reserved_9;
 243   UINT8 reserved_10;
 244   UINT8 reserved_11;
 245 } ATAPI_READ10_CMD;
 246
 247 ///
 248 /// READ Format Capacity Command, defined in SFF-8070i(ATAPI Removable Rewritable Specification)
 249 ///
 250 typedef struct {
 251   UINT8 opcode;
 252   UINT8 reserved_1 : 5;
 253   UINT8 lun : 3;
 254   UINT8 reserved_2;
 255   UINT8 reserved_3;
 256   UINT8 reserved_4;
 257   UINT8 reserved_5;
 258   UINT8 reserved_6;
 259   UINT8 allocation_length_hi;
 260   UINT8 allocation_length_lo;
 261   UINT8 reserved_9;
 262   UINT8 reserved_10;
 263   UINT8 reserved_11;
 264 } ATAPI_READ_FORMAT_CAP_CMD;
 265
 266 ///
 267 /// MODE SENSE Command, defined in SFF-8070i(ATAPI Removable Rewritable Specification)
 268 ///
 269 typedef struct {
 270   UINT8 opcode;
 271   UINT8 reserved_1 : 5;
 272   UINT8 lun : 3;
 273   UINT8 page_code : 6;
 274   UINT8 page_control : 2;
 275   UINT8 reserved_3;
 276   UINT8 reserved_4;
 277   UINT8 reserved_5;
 278   UINT8 reserved_6;
 279   UINT8 parameter_list_length_hi;
 280   UINT8 parameter_list_length_lo;
 281   UINT8 reserved_9;
 282   UINT8 reserved_10;
 283   UINT8 reserved_11;
 284 } ATAPI_MODE_SENSE_CMD;
 285
 286 ///
 287 /// ATAPI_PACKET_COMMAND is not defined in ATA specification.
 288 /// We add it here for the convenience for ATA/ATAPI module writer.
 289 ///
 290 typedef union {
 291   UINT16                    Data16[6];
 292   ATAPI_TEST_UNIT_READY_CMD TestUnitReady;
 293   ATAPI_READ10_CMD          Read10;
 294   ATAPI_REQUEST_SENSE_CMD   RequestSence;
 295   ATAPI_INQUIRY_CMD         Inquiry;
 296   ATAPI_MODE_SENSE_CMD      ModeSense;
 297   ATAPI_READ_FORMAT_CAP_CMD ReadFormatCapacity;
 298 } ATAPI_PACKET_COMMAND;
 299
 300 #pragma pack()
 301
 302
 303 #define ATAPI_MAX_DMA_EXT_CMD_SECTORS 0x10000
 304 #define ATAPI_MAX_DMA_CMD_SECTORS     0x100
 305
 306 //
 307 // ATA Packet Command Code
 308 //
 309 #define ATA_CMD_SOFT_RESET                  0x08   ///< defined in ATA-6
 310 #define ATA_CMD_PACKET                      0xA0   ///< defined in ATA-6
 311 #define ATA_CMD_IDENTIFY_DEVICE             0xA1   ///< defined in ATA-6
 312 #define ATA_CMD_SERVICE                     0xA2   ///< defined in ATA-6
 313 #define ATA_CMD_TEST_UNIT_READY             0x00   ///< defined in ATA-6
 314 #define ATA_CMD_REQUEST_SENSE               0x03   ///< defined in ATA-6
 315 #define ATA_CMD_INQUIRY                     0x12   ///< defined in ATAPI Removable Rewritable Media Devcies
 316 #define ATA_CMD_READ_FORMAT_CAPACITY        0x23   ///< defined in ATAPI Removable Rewritable Media Devcies
 317 #define ATA_CMD_READ_CAPACITY               0x25   ///< defined in ATAPI Removable Rewritable Media Devcies
 318 #define ATA_CMD_READ_10                     0x28   ///< defined in ATAPI Removable Rewritable Media Devcies
 319 #define ATA_CMD_WRITE_10                    0x2A   ///< defined in ATAPI Removable Rewritable Media Devcies
 320
 321 //
 322 // ATA Commands Code
 323 //
 324
 325 //
 326 // Class 1: PIO Data-In Commands
 327 //
 328 #define ATA_CMD_IDENTIFY_DRIVE          0xec
 329 #define ATA_CMD_READ_BUFFER             0xe4
 330 #define ATA_CMD_READ_SECTORS            0x20   ///< defined in ATA-5
 331 #define ATA_CMD_READ_SECTORS_WITH_RETRY 0x21   ///< defined in ATA-5
 332 #define ATA_CMD_READ_LONG               0x22   ///< defined in ATA-5
 333 #define ATA_CMD_READ_LONG_WITH_RETRY    0x23   ///< defined in ATA-5
 334 #define ATA_CMD_READ_SECTORS_EXT        0x24   ///< defined in ATA-6
 335
 336 //
 337 // Class 2: PIO Data-Out Commands
 338 //
 339 #define ATA_CMD_FORMAT_TRACK              0x50  ///< defined in ATA-3
 340 #define ATA_CMD_WRITE_BUFFER              0xe8  ///< defined in ATA-6
 341 #define ATA_CMD_WRITE_SECTORS             0x30  ///< defined in ATA-6
 342 #define ATA_CMD_WRITE_SECTORS_WITH_RETRY  0x31  ///< defined in ATA-4
 343 #define ATA_CMD_WRITE_LONG                0x32  ///< defined in ATA-3
 344 #define ATA_CMD_WRITE_LONG_WITH_RETRY     0x33  ///< defined in ATA-3
 345 #define ATA_CMD_WRITE_VERIFY              0x3c  ///< defined in ATA-3
 346 #define ATA_CMD_WRITE_SECTORS_EXT         0x34  ///< defined in ATA-6
 347
 348 //
 349 // Class 3 No Data Command
 350 //
 351 #define ATA_CMD_ACK_MEDIA_CHANGE        0xdb  ///< defined in ATA-2
 352 #define ATA_CMD_BOOT_POST_BOOT          0xdc  ///< defined in ATA-2
 353 #define ATA_CMD_BOOT_PRE_BOOT           0xdd  ///< defined in ATA-2
 354 #define ATA_CMD_CHECK_POWER_MODE        0x98  ///< defined in ATA-3
 355 #define ATA_CMD_CHECK_POWER_MODE_ALIAS  0xe5  ///< defined in ATA-6
 356 #define ATA_CMD_DOOR_LOCK               0xde  ///< defined in ATA-6
 357 #define ATA_CMD_DOOR_UNLOCK             0xdf  ///< defined in ATA-6
 358 #define ATA_CMD_EXEC_DRIVE_DIAG         0x90  ///< defined in ATA-6
 359 #define ATA_CMD_IDLE_ALIAS              0x97  ///< defined in ATA-3
 360 #define ATA_CMD_IDLE                    0xe3  ///< defined in ATA-6
 361 #define ATA_CMD_IDLE_IMMEDIATE          0x95  ///< defined in ATA-3
 362 #define ATA_CMD_IDLE_IMMEDIATE_ALIAS    0xe1  ///< defined in ATA-6
 363 #define ATA_CMD_INIT_DRIVE_PARAM        0x91  ///< defined in ATA-5
 364 #define ATA_CMD_RECALIBRATE             0x10  ///< defined in ATA-3
 365 #define ATA_CMD_READ_DRIVE_STATE        0xe9  ///< defined in ATA-2
 366 #define ATA_CMD_SET_MULTIPLE_MODE       0xC6  ///< defined in ATA-6
 367 #define ATA_CMD_READ_VERIFY             0x40  ///< defined in ATA-6
 368 #define ATA_CMD_READ_VERIFY_WITH_RETRY  0x41  ///< defined in ATA-4
 369 #define ATA_CMD_SEEK                    0x70  ///< defined in ATA-6
 370 #define ATA_CMD_SET_FEATURES            0xef  ///< defined in ATA-6
 371 #define ATA_CMD_STANDBY                 0x96  ///< defined in ATA-3
 372 #define ATA_CMD_STANDBY_ALIAS           0xe2  ///< defined in ATA-6
 373 #define ATA_CMD_STANDBY_IMMEDIATE       0x94  ///< defined in ATA-3
 374 #define ATA_CMD_STANDBY_IMMEDIATE_ALIAS 0xe0  ///< defined in ATA-6
 375 //
 376 // S.M.A.R.T
 377 //
 378 #define ATA_CMD_SMART               0xb0
 379 #define ATA_CONSTANT_C2             0xc2
 380 #define ATA_CONSTANT_4F             0x4f
 381 #define ATA_SMART_ENABLE_OPERATION  0xd8
 382 #define ATA_SMART_RETURN_STATUS     0xda
 383
 384 //
 385 // Class 4: DMA Command
 386 //
 387 #define ATA_CMD_READ_DMA              0xc8   ///< defined in ATA-6
 388 #define ATA_CMD_READ_DMA_WITH_RETRY   0xc9   ///< defined in ATA-4
 389 #define ATA_CMD_READ_DMA_EXT          0x25   ///< defined in ATA-6
 390 #define ATA_CMD_WRITE_DMA             0xca   ///< defined in ATA-6
 391 #define ATA_CMD_WRITE_DMA_WITH_RETRY  0xcb   ///< defined in ATA-4
 392 #define ATA_CMD_WRITE_DMA_EXT         0x35   ///< defined in ATA-6
 393
 394 ///
 395 /// default content of device control register, disable INT,
 396 /// Bit3 is set to 1 according ATA-1
 397 ///
 398 #define ATA_DEFAULT_CTL           (0x0a)
 399 ///
 400 /// default context of Device/Head Register,
 401 /// Bit7 and Bit5 are set to 1 for back-compatibilities
 402 ///
 403 #define ATA_DEFAULT_CMD           (0xa0)
 404
 405 #define ATAPI_MAX_BYTE_COUNT  (0xfffe)
 406
 407 #define ATA_REQUEST_SENSE_ERROR (0x70) ///< defined in SFF-8070i
 408
 409 //
 410 // Sense Key, Additional Sense Codes and Additional Sense Code Qualifier
 411 // defined in MultiMedia Commands (MMC, MMC-2)
 412 //
 413 // Sense Key
 414 //
 415 #define ATA_SK_NO_SENSE         (0x0)
 416 #define ATA_SK_RECOVERY_ERROR   (0x1)
 417 #define ATA_SK_NOT_READY        (0x2)
 418 #define ATA_SK_MEDIUM_ERROR     (0x3)
 419 #define ATA_SK_HARDWARE_ERROR   (0x4)
 420 #define ATA_SK_ILLEGAL_REQUEST  (0x5)
 421 #define ATA_SK_UNIT_ATTENTION   (0x6)
 422 #define ATA_SK_DATA_PROTECT     (0x7)
 423 #define ATA_SK_BLANK_CHECK      (0x8)
 424 #define ATA_SK_VENDOR_SPECIFIC  (0x9)
 425 #define ATA_SK_RESERVED_A       (0xA)
 426 #define ATA_SK_ABORT            (0xB)
 427 #define ATA_SK_RESERVED_C       (0xC)
 428 #define ATA_SK_OVERFLOW         (0xD)
 429 #define ATA_SK_MISCOMPARE       (0xE)
 430 #define ATA_SK_RESERVED_F       (0xF)
 431
 432 //
 433 // Additional Sense Codes
 434 //
 435 #define ATA_ASC_NOT_READY                   (0x04)
 436 #define ATA_ASC_MEDIA_ERR1                  (0x10)
 437 #define ATA_ASC_MEDIA_ERR2                  (0x11)
 438 #define ATA_ASC_MEDIA_ERR3                  (0x14)
 439 #define ATA_ASC_MEDIA_ERR4                  (0x30)
 440 #define ATA_ASC_MEDIA_UPSIDE_DOWN           (0x06)
 441 #define ATA_ASC_INVALID_CMD                 (0x20)
 442 #define ATA_ASC_LBA_OUT_OF_RANGE            (0x21)
 443 #define ATA_ASC_INVALID_FIELD               (0x24)
 444 #define ATA_ASC_WRITE_PROTECTED             (0x27)
 445 #define ATA_ASC_MEDIA_CHANGE                (0x28)
 446 #define ATA_ASC_RESET                       (0x29)  ///< Power On Reset or Bus Reset occurred
 447 #define ATA_ASC_ILLEGAL_FIELD               (0x26)
 448 #define ATA_ASC_NO_MEDIA                    (0x3A)
 449 #define ATA_ASC_ILLEGAL_MODE_FOR_THIS_TRACK (0x64)
 450
 451 //
 452 // Additional Sense Code Qualifier
 453 //
 454 #define ATA_ASCQ_IN_PROGRESS  (0x01)
 455
 456 //
 457 // Error Register
 458 //
 459 #define ATA_ERRREG_BBK   BIT7  ///< Bad block detected      defined in ATA-1
 460 #define ATA_ERRREG_UNC   BIT6  ///< Uncorrectable Data      defined in ATA-3
 461 #define ATA_ERRREG_MC    BIT5  ///< Media Change            defined in ATA-3
 462 #define ATA_ERRREG_IDNF  BIT4  ///< ID Not Found            defined in ATA-3
 463 #define ATA_ERRREG_MCR   BIT3  ///< Media Change Requested  defined in ATA-3
 464 #define ATA_ERRREG_ABRT  BIT2  ///< Aborted Command         defined in ATA-6
 465 #define ATA_ERRREG_TK0NF BIT1  ///< Track 0 Not Found       defined in ATA-3
 466 #define ATA_ERRREG_AMNF  BIT0  ///< Address Mark Not Found  defined in ATA-3
 467
 468 //
 469 // Status Register
 470 //
 471 #define ATA_STSREG_BSY   BIT7  ///< Controller Busy         defined in ATA-6
 472 #define ATA_STSREG_DRDY  BIT6  ///< Drive Ready             defined in ATA-6
 473 #define ATA_STSREG_DWF   BIT5  ///< Drive Write Fault       defined in ATA-6
 474 #define ATA_STSREG_DSC   BIT4  ///< Disk Seek Complete      defined in ATA-3
 475 #define ATA_STSREG_DRQ   BIT3  ///< Data Request            defined in ATA-6
 476 #define ATA_STSREG_CORR  BIT2  ///< Corrected Data          defined in ATA-3
 477 #define ATA_STSREG_IDX   BIT1  ///< Index                   defined in ATA-3
 478 #define ATA_STSREG_ERR   BIT0  ///< Error                   defined in ATA-6
 479
 480 //
 481 // Device Control Register
 482 //
 483 #define ATA_CTLREG_SRST  BIT2  ///< Software Reset
 484 #define ATA_CTLREG_IEN_L BIT1  ///< Interrupt Enable #
 485
 486 #endif
 487