]> git.proxmox.com Git - mirror_edk2.git/blobdiff - MdePkg/Include/IndustryStandard/Atapi.h
MdePkg: add missing #defines for decoding PCIe 2.1 extended capability structures
[mirror_edk2.git] / MdePkg / Include / IndustryStandard / Atapi.h
index e2c3bd4598b0c35746aa8d4cc81b46b3467c518d..28c810814e9875b40d4bdd3755416c6825cd1689 100644 (file)
@@ -2,13 +2,13 @@
   This file contains just some basic definitions that are needed by drivers\r
   that dealing with ATA/ATAPI interface.\r
 \r
-Copyright (c) 2007 - 2008, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
-are licensed and made available under the terms and conditions of the BSD License\r
-which accompanies this distribution.  The full text of the license may be found at\r
-http://opensource.org/licenses/bsd-license.php\r
-\r
-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
+Copyright (c) 2007 - 2013, Intel Corporation. All rights reserved.<BR>\r
+This program and the accompanying materials are licensed and made available under \r
+the terms and conditions of the BSD License that accompanies this distribution.  \r
+The full text of the license may be found at\r
+http://opensource.org/licenses/bsd-license.php.                                          \r
+    \r
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
 \r
 **/\r
@@ -18,81 +18,253 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 \r
 #pragma pack(1)\r
 \r
-\r
 ///\r
-/// ATAPI_IDENTIFY_DATA is defined in ATA-6\r
+/// ATA5_IDENTIFY_DATA is defined in ATA-5.\r
+/// (This structure is provided mainly for backward-compatibility support.\r
+/// Old drivers may reference fields that are marked "obsolete" in \r
+/// ATA_IDENTIFY_DATA, which currently conforms to ATA-8.) \r
+///\r
+typedef struct {    \r
+  UINT16  config;             ///< General Configuration.\r
+  UINT16  cylinders;          ///< Number of Cylinders.\r
+  UINT16  reserved_2; \r
+  UINT16  heads;              ///< Number of logical heads. \r
+  UINT16  vendor_data1; \r
+  UINT16  vendor_data2; \r
+  UINT16  sectors_per_track; \r
+  UINT16  vendor_specific_7_9[3]; \r
+  CHAR8   SerialNo[20];       ///< ASCII  \r
+  UINT16  vendor_specific_20_21[2];  \r
+  UINT16  ecc_bytes_available;    \r
+  CHAR8   FirmwareVer[8];     ///< ASCII  \r
+  CHAR8   ModelName[40];      ///< ASCII    \r
+  UINT16  multi_sector_cmd_max_sct_cnt; \r
+  UINT16  reserved_48; \r
+  UINT16  capabilities; \r
+  UINT16  reserved_50;     \r
+  UINT16  pio_cycle_timing;    \r
+  UINT16  reserved_52;             \r
+  UINT16  field_validity;     \r
+  UINT16  current_cylinders; \r
+  UINT16  current_heads; \r
+  UINT16  current_sectors;    \r
+  UINT16  CurrentCapacityLsb; \r
+  UINT16  CurrentCapacityMsb;     \r
+  UINT16  reserved_59;     \r
+  UINT16  user_addressable_sectors_lo; \r
+  UINT16  user_addressable_sectors_hi; \r
+  UINT16  reserved_62;     \r
+  UINT16  multi_word_dma_mode;    \r
+  UINT16  advanced_pio_modes; \r
+  UINT16  min_multi_word_dma_cycle_time; \r
+  UINT16  rec_multi_word_dma_cycle_time; \r
+  UINT16  min_pio_cycle_time_without_flow_control; \r
+  UINT16  min_pio_cycle_time_with_flow_control; \r
+  UINT16  reserved_69_79[11];     \r
+  UINT16  major_version_no; \r
+  UINT16  minor_version_no; \r
+  UINT16  command_set_supported_82;    ///< word 82 \r
+  UINT16  command_set_supported_83;    ///< word 83 \r
+  UINT16  command_set_feature_extn;    ///< word 84 \r
+  UINT16  command_set_feature_enb_85;  ///< word 85 \r
+  UINT16  command_set_feature_enb_86;  ///< word 86 \r
+  UINT16  command_set_feature_default; ///< word 87 \r
+  UINT16  ultra_dma_mode;              ///< word 88 \r
+  UINT16  reserved_89_127[39]; \r
+  UINT16  security_status; \r
+  UINT16  vendor_data_129_159[31]; \r
+  UINT16  reserved_160_255[96]; \r
+} ATA5_IDENTIFY_DATA;\r
+\r
+///\r
+/// ATA_IDENTIFY_DATA strictly complies with ATA/ATAPI-8 Spec\r
+/// to define the data returned by an ATA device upon successful\r
+/// completion of the ATA IDENTIFY_DEVICE command.\r
+///\r
+typedef struct {\r
+  UINT16  config;                                  ///< General Configuration.\r
+  UINT16  obsolete_1;\r
+  UINT16  specific_config;                         ///< Specific Configuration.\r
+  UINT16  obsolete_3;\r
+  UINT16  retired_4_5[2]; \r
+  UINT16  obsolete_6;\r
+  UINT16  cfa_reserved_7_8[2];\r
+  UINT16  retired_9; \r
+  CHAR8   SerialNo[20];                            ///< word 10~19\r
+  UINT16  retired_20_21[2];  \r
+  UINT16  obsolete_22;    \r
+  CHAR8   FirmwareVer[8];                          ///< word 23~26\r
+  CHAR8   ModelName[40];                           ///< word 27~46\r
+  UINT16  multi_sector_cmd_max_sct_cnt;\r
+  UINT16  trusted_computing_support; \r
+  UINT16  capabilities_49;\r
+  UINT16  capabilities_50;\r
+  UINT16  obsolete_51_52[2];           \r
+  UINT16  field_validity;     \r
+  UINT16  obsolete_54_58[5];     \r
+  UINT16  multi_sector_setting;\r
+  UINT16  user_addressable_sectors_lo; \r
+  UINT16  user_addressable_sectors_hi; \r
+  UINT16  obsolete_62;     \r
+  UINT16  multi_word_dma_mode;    \r
+  UINT16  advanced_pio_modes; \r
+  UINT16  min_multi_word_dma_cycle_time; \r
+  UINT16  rec_multi_word_dma_cycle_time; \r
+  UINT16  min_pio_cycle_time_without_flow_control; \r
+  UINT16  min_pio_cycle_time_with_flow_control; \r
+  UINT16  additional_supported;                    ///< word 69\r
+  UINT16  reserved_70;\r
+  UINT16  reserved_71_74[4];                       ///< Reserved for IDENTIFY PACKET DEVICE cmd.\r
+  UINT16  queue_depth;     \r
+  UINT16  serial_ata_capabilities;\r
+  UINT16  reserved_77;                             ///< Reserved for Serial ATA\r
+  UINT16  serial_ata_features_supported;\r
+  UINT16  serial_ata_features_enabled;\r
+  UINT16  major_version_no; \r
+  UINT16  minor_version_no; \r
+  UINT16  command_set_supported_82;                ///< word 82\r
+  UINT16  command_set_supported_83;                ///< word 83\r
+  UINT16  command_set_feature_extn;                ///< word 84\r
+  UINT16  command_set_feature_enb_85;              ///< word 85\r
+  UINT16  command_set_feature_enb_86;              ///< word 86\r
+  UINT16  command_set_feature_default;             ///< word 87\r
+  UINT16  ultra_dma_mode;                          ///< word 88 \r
+  UINT16  time_for_security_erase_unit; \r
+  UINT16  time_for_enhanced_security_erase_unit;\r
+  UINT16  advanced_power_management_level;\r
+  UINT16  master_password_identifier;\r
+  UINT16  hardware_configuration_test_result;\r
+  UINT16  obsolete_94;\r
+  UINT16  stream_minimum_request_size;\r
+  UINT16  streaming_transfer_time_for_dma;\r
+  UINT16  streaming_access_latency_for_dma_and_pio;\r
+  UINT16  streaming_performance_granularity[2];    ///< word 98~99\r
+  UINT16  maximum_lba_for_48bit_addressing[4];     ///< word 100~103\r
+  UINT16  streaming_transfer_time_for_pio;\r
+  UINT16  max_no_of_512byte_blocks_per_data_set_cmd;\r
+  UINT16  phy_logic_sector_support;                ///< word 106\r
+  UINT16  interseek_delay_for_iso7779;\r
+  UINT16  world_wide_name[4];                      ///< word 108~111\r
+  UINT16  reserved_for_128bit_wwn_112_115[4];\r
+  UINT16  reserved_for_technical_report;\r
+  UINT16  logic_sector_size_lo;                    ///< word 117\r
+  UINT16  logic_sector_size_hi;                    ///< word 118\r
+  UINT16  features_and_command_sets_supported_ext; ///< word 119\r
+  UINT16  features_and_command_sets_enabled_ext;   ///< word 120\r
+  UINT16  reserved_121_126[6];\r
+  UINT16  obsolete_127;\r
+  UINT16  security_status;                         ///< word 128\r
+  UINT16  vendor_specific_129_159[31]; \r
+  UINT16  cfa_power_mode;                          ///< word 160\r
+  UINT16  reserved_for_compactflash_161_167[7];\r
+  UINT16  device_nominal_form_factor;\r
+  UINT16  is_data_set_cmd_supported;\r
+  CHAR8   additional_product_identifier[8];\r
+  UINT16  reserved_174_175[2];\r
+  CHAR8   media_serial_number[60];                 ///< word 176~205\r
+  UINT16  sct_command_transport;                   ///< word 206\r
+  UINT16  reserved_207_208[2];\r
+  UINT16  alignment_logic_in_phy_blocks;           ///< word 209\r
+  UINT16  write_read_verify_sector_count_mode3[2]; ///< word 210~211\r
+  UINT16  verify_sector_count_mode2[2];\r
+  UINT16  nv_cache_capabilities;\r
+  UINT16  nv_cache_size_in_logical_block_lsw;      ///< word 215\r
+  UINT16  nv_cache_size_in_logical_block_msw;      ///< word 216\r
+  UINT16  nominal_media_rotation_rate;\r
+  UINT16  reserved_218;\r
+  UINT16  nv_cache_options;                        ///< word 219\r
+  UINT16  write_read_verify_mode;                  ///< word 220\r
+  UINT16  reserved_221;\r
+  UINT16  transport_major_revision_number;\r
+  UINT16  transport_minor_revision_number;\r
+  UINT16  reserved_224_229[6];\r
+  UINT64  extended_no_of_addressable_sectors;\r
+  UINT16  min_number_per_download_microcode_mode3; ///< word 234\r
+  UINT16  max_number_per_download_microcode_mode3; ///< word 235\r
+  UINT16  reserved_236_254[19];\r
+  UINT16  integrity_word;\r
+} ATA_IDENTIFY_DATA;\r
+\r
+///\r
+/// ATAPI_IDENTIFY_DATA strictly complies with ATA/ATAPI-8 Spec\r
+/// to define the data returned by an ATAPI device upon successful\r
+/// completion of the ATA IDENTIFY_PACKET_DEVICE command.\r
 ///\r
 typedef struct {\r
-    UINT16  config;             ///< General Configuration\r
-    UINT16  obsolete_1;\r
-    UINT16  specific_config;\r
-    UINT16  obsolete_3;\r
-    UINT16  retired_4_5[2];\r
-    UINT16  obsolete_6;\r
-    UINT16  cfa_reserved_7_8[2];\r
-    UINT16  retired_9;\r
-    CHAR8   SerialNo[20];       ///< ASCII\r
-    UINT16  retired_20_21[2];\r
-    UINT16  obsolete_22;\r
-    CHAR8   FirmwareVer[8];     ///< ASCII\r
-    CHAR8   ModelName[40];      ///< ASCII\r
-    UINT16  multi_sector_cmd_max_sct_cnt;\r
-    UINT16  reserved_48;\r
-    UINT16  capabilities_49;\r
-    UINT16  capabilities_50;\r
-    UINT16  obsolete_51_52[2];\r
-    UINT16  field_validity;\r
-    UINT16  obsolete_54_58[5];\r
-    UINT16  mutil_sector_setting;\r
-    UINT16  user_addressable_sectors_lo;\r
-    UINT16  user_addressable_sectors_hi;\r
-    UINT16  obsolete_62;\r
-    UINT16  multi_word_dma_mode;\r
-    UINT16  advanced_pio_modes;\r
-    UINT16  min_multi_word_dma_cycle_time;\r
-    UINT16  rec_multi_word_dma_cycle_time;\r
-    UINT16  min_pio_cycle_time_without_flow_control;\r
-    UINT16  min_pio_cycle_time_with_flow_control;\r
-    UINT16  reserved_69_74[6];\r
-    UINT16  queue_depth;\r
-    UINT16  reserved_76_79[4];\r
-    UINT16  major_version_no;\r
-    UINT16  minor_version_no;\r
-    UINT16  cmd_set_support_82;\r
-    UINT16  cmd_set_support_83;\r
-    UINT16  cmd_feature_support;\r
-    UINT16  cmd_feature_enable_85;\r
-    UINT16  cmd_feature_enable_86;\r
-    UINT16  cmd_feature_default;\r
-    UINT16  ultra_dma_select;\r
-    UINT16  time_required_for_sec_erase;\r
-    UINT16  time_required_for_enhanced_sec_erase;\r
-    UINT16  current_advanced_power_mgmt_value;\r
-    UINT16  master_pwd_revison_code;\r
-    UINT16  hardware_reset_result;\r
-    UINT16  current_auto_acoustic_mgmt_value;\r
-    UINT16  reserved_95_99[5];\r
-    UINT16  max_user_lba_for_48bit_addr[4];\r
-    UINT16  reserved_104_126[23];\r
-    UINT16  removable_media_status_notification_support;\r
-    UINT16  security_status;\r
-    UINT16  vendor_data_129_159[31];\r
-    UINT16  cfa_power_mode;\r
-    UINT16  cfa_reserved_161_175[15];\r
-    UINT16  current_media_serial_no[30];\r
-    UINT16  reserved_206_254[49];\r
-    UINT16  integrity_word;\r
+  UINT16  config;                                  ///< General Configuration.\r
+  UINT16  reserved_1;\r
+  UINT16  specific_config;                         ///< Specific Configuration.\r
+  UINT16  reserved_3_9[7];\r
+  CHAR8   SerialNo[20];                            ///< word 10~19\r
+  UINT16  reserved_20_22[3];\r
+  CHAR8   FirmwareVer[8];                          ///< word 23~26\r
+  CHAR8   ModelName[40];                           ///< word 27~46\r
+  UINT16  reserved_47_48[2];\r
+  UINT16  capabilities_49;\r
+  UINT16  capabilities_50;\r
+  UINT16  obsolete_51;\r
+  UINT16  reserved_52;\r
+  UINT16  field_validity;                          ///< word 53\r
+  UINT16  reserved_54_61[8];\r
+  UINT16  dma_dir;\r
+  UINT16  multi_word_dma_mode;                     ///< word 63\r
+  UINT16  advanced_pio_modes;                      ///< word 64\r
+  UINT16  min_multi_word_dma_cycle_time;\r
+  UINT16  rec_multi_word_dma_cycle_time;\r
+  UINT16  min_pio_cycle_time_without_flow_control;\r
+  UINT16  min_pio_cycle_time_with_flow_control;\r
+  UINT16  reserved_69_70[2];\r
+  UINT16  obsolete_71_72[2];\r
+  UINT16  reserved_73_74[2];\r
+  UINT16  obsolete_75;\r
+  UINT16  serial_ata_capabilities;\r
+  UINT16  reserved_77;                             ///< Reserved for Serial ATA\r
+  UINT16  serial_ata_features_supported;\r
+  UINT16  serial_ata_features_enabled;\r
+  UINT16  major_version_no;                        ///< word 80\r
+  UINT16  minor_version_no;                        ///< word 81\r
+  UINT16  cmd_set_support_82;\r
+  UINT16  cmd_set_support_83;\r
+  UINT16  cmd_feature_support;\r
+  UINT16  cmd_feature_enable_85;\r
+  UINT16  cmd_feature_enable_86;\r
+  UINT16  cmd_feature_default;\r
+  UINT16  ultra_dma_select;\r
+  UINT16  time_required_for_sec_erase;             ///< word 89\r
+  UINT16  time_required_for_enhanced_sec_erase;    ///< word 90\r
+  UINT16  advanced_power_management_level;\r
+  UINT16  master_pwd_revison_code;\r
+  UINT16  hardware_reset_result;                   ///< word 93\r
+  UINT16  obsolete_94;\r
+  UINT16  reserved_95_107[13];\r
+  UINT16  world_wide_name[4];                      ///< word 108~111\r
+  UINT16  reserved_for_128bit_wwn_112_115[4];\r
+  UINT16  reserved_116_118[3];  \r
+  UINT16  command_and_feature_sets_supported;      ///< word 119\r
+  UINT16  command_and_feature_sets_supported_enabled;\r
+  UINT16  reserved_121_124[4];\r
+  UINT16  atapi_byte_count_0_behavior;             ///< word 125\r
+  UINT16  obsolete_126_127[2];\r
+  UINT16  security_status;\r
+  UINT16  reserved_129_159[31];\r
+  UINT16  cfa_reserved_160_175[16];\r
+  UINT16  reserved_176_221[46];\r
+  UINT16  transport_major_version;\r
+  UINT16  transport_minor_version;\r
+  UINT16  reserved_224_254[31];\r
+  UINT16  integrity_word;\r
 } ATAPI_IDENTIFY_DATA;\r
 \r
+\r
 ///\r
-/// the front of part is defined in ATAPI Removable Rewritable Specification\r
+/// Standard Quiry Data format, defined in SFF-8070i(ATAPI Removable Rewritable Specification).\r
 ///\r
 typedef struct {\r
   UINT8 peripheral_type;\r
   UINT8 RMB;\r
   UINT8 version;\r
   UINT8 response_data_format;\r
-  UINT8 addnl_length;\r
+  UINT8 addnl_length;     ///< n - 4, Numbers of bytes following this one.\r
   UINT8 reserved_5;\r
   UINT8 reserved_6;\r
   UINT8 reserved_7;\r
@@ -102,14 +274,15 @@ typedef struct {
   UINT8 vendor_specific_36_55[55 - 36 + 1];\r
   UINT8 reserved_56_95[95 - 56 + 1];\r
   ///\r
-  /// Some more fields, the sizeof (ATAPI_INQUIRY_DATA) is 255\r
+  /// Vendor-specific parameters fields. The sizeof (ATAPI_INQUIRY_DATA) is 254\r
   /// since allocation_length is one byte in ATAPI_INQUIRY_CMD.\r
   ///\r
-  UINT8 vendor_specific_96_255[254 - 96 + 1];\r
+  UINT8 vendor_specific_96_253[253 - 96 + 1];\r
 } ATAPI_INQUIRY_DATA;\r
 \r
-\r
-\r
+///\r
+/// Request Sense Standard Data, defined in SFF-8070i(ATAPI Removable Rewritable Specification).\r
+///\r
 typedef struct {\r
   UINT8 error_code : 7;\r
   UINT8 valid : 1;\r
@@ -133,16 +306,10 @@ typedef struct {
   UINT8 SKSV : 1;\r
   UINT8 sense_key_specific_16;\r
   UINT8 sense_key_specific_17;\r
-  ///\r
-  /// Followed by additional sense bytes.\r
-  /// the sizeof (ATAPI_REQUEST_SENSE_DATA) is 255, \r
-  /// since allocation_length is one byte in ATAPI_INQUIRY_CMD.\r
-  ///\r
-  UINT8 additional_sense_bytes[254 - 18 + 1];\r
 } ATAPI_REQUEST_SENSE_DATA;\r
 \r
 ///\r
-/// READ CAPACITY Data\r
+/// READ CAPACITY Data, defined in SFF-8070i(ATAPI Removable Rewritable Specification).\r
 ///\r
 typedef struct {\r
   UINT8 LastLba3;\r
@@ -156,7 +323,8 @@ typedef struct {
 } ATAPI_READ_CAPACITY_DATA;\r
 \r
 ///\r
-/// Capacity List Header + Current/Maximum Capacity Descriptor\r
+/// Capacity List Header + Current/Maximum Capacity Descriptor,\r
+/// defined in SFF-8070i(ATAPI Removable Rewritable Specification).\r
 ///\r
 typedef struct {\r
   UINT8 reserved_0;\r
@@ -175,7 +343,7 @@ typedef struct {
 } ATAPI_READ_FORMAT_CAPACITY_DATA;\r
 \r
 ///\r
-/// Test Unit Ready Command\r
+/// Test Unit Ready Command, defined in SFF-8070i(ATAPI Removable Rewritable Specification).\r
 ///\r
 typedef struct {\r
   UINT8 opcode;\r
@@ -193,7 +361,7 @@ typedef struct {
 } ATAPI_TEST_UNIT_READY_CMD;\r
 \r
 ///\r
-/// INQUIRY Command\r
+/// INQUIRY Command, defined in SFF-8070i(ATAPI Removable Rewritable Specification).\r
 ///\r
 typedef struct {\r
   UINT8 opcode;\r
@@ -212,7 +380,7 @@ typedef struct {
 } ATAPI_INQUIRY_CMD;\r
 \r
 ///\r
-/// REQUEST SENSE Command\r
+/// REQUEST SENSE Command, defined in SFF-8070i(ATAPI Removable Rewritable Specification).\r
 ///\r
 typedef struct {\r
   UINT8 opcode;\r
@@ -231,7 +399,7 @@ typedef struct {
 } ATAPI_REQUEST_SENSE_CMD;\r
 \r
 ///\r
-/// READ (10) Command\r
+/// READ (10) Command, defined in SFF-8070i(ATAPI Removable Rewritable Specification).\r
 ///\r
 typedef struct {\r
   UINT8 opcode;\r
@@ -250,7 +418,7 @@ typedef struct {
 } ATAPI_READ10_CMD;\r
 \r
 ///\r
-/// READ Format Capacity Command\r
+/// READ Format Capacity Command, defined in SFF-8070i(ATAPI Removable Rewritable Specification).\r
 ///\r
 typedef struct {\r
   UINT8 opcode;\r
@@ -268,23 +436,8 @@ typedef struct {
   UINT8 reserved_11;\r
 } ATAPI_READ_FORMAT_CAP_CMD;\r
 \r
-typedef struct {\r
-  UINT8 peripheral_type;\r
-  UINT8 RMB;\r
-  UINT8 version;\r
-  UINT8 response_data_format;\r
-  UINT8 addnl_length;\r
-  UINT8 reserved_5;\r
-  UINT8 reserved_6;\r
-  UINT8 reserved_7;\r
-  UINT8 vendor_info[8];\r
-  UINT8 product_id[12];\r
-  UINT8 eeprom_product_code[4];\r
-  UINT8 firmware_rev_level[4];\r
-} ATAPI_USB_INQUIRY_DATA;\r
-\r
 ///\r
-/// MODE SENSE Command\r
+/// MODE SENSE Command, defined in SFF-8070i(ATAPI Removable Rewritable Specification).\r
 ///\r
 typedef struct {\r
   UINT8 opcode;\r
@@ -304,8 +457,8 @@ typedef struct {
 } ATAPI_MODE_SENSE_CMD;\r
 \r
 ///\r
-/// ATAPI_PACKET_COMMAND is not defined in ATA specification.\r
-/// We add it here for the convenience for ATA/ATAPI module writer\r
+/// ATAPI_PACKET_COMMAND is not defined in the ATA specification.\r
+/// We add it here for the convenience of ATA/ATAPI module writers\r
 ///\r
 typedef union {\r
   UINT16                    Data16[6];\r
@@ -326,17 +479,29 @@ typedef union {
 //\r
 // ATA Packet Command Code\r
 //\r
-#define ATA_CMD_SOFT_RESET                  0x08   ///< defined in ATA-6\r
-#define ATA_CMD_PACKET                      0xA0   ///< defined in ATA-6\r
-#define ATA_CMD_IDENTIFY_DEVICE             0xA1   ///< defined in ATA-6\r
-#define ATA_CMD_SERVICE                     0xA2   ///< defined in ATA-6\r
-#define ATA_CMD_TEST_UNIT_READY             0x00   ///< defined in ATA-6\r
-#define ATA_CMD_REQUEST_SENSE               0x03   ///< defined in ATA-6\r
+#define ATA_CMD_SOFT_RESET                  0x08   ///< defined from ATA-3\r
+#define ATA_CMD_PACKET                      0xA0   ///< defined from ATA-3\r
+#define ATA_CMD_IDENTIFY_DEVICE             0xA1   ///< defined from ATA-3\r
+#define ATA_CMD_SERVICE                     0xA2   ///< defined from ATA-3\r
+#define ATA_CMD_TEST_UNIT_READY             0x00   ///< defined from ATA-1\r
+#define ATA_CMD_REQUEST_SENSE               0x03   ///< defined from ATA-4\r
 #define ATA_CMD_INQUIRY                     0x12   ///< defined in ATAPI Removable Rewritable Media Devcies\r
 #define ATA_CMD_READ_FORMAT_CAPACITY        0x23   ///< defined in ATAPI Removable Rewritable Media Devcies\r
 #define ATA_CMD_READ_CAPACITY               0x25   ///< defined in ATAPI Removable Rewritable Media Devcies\r
 #define ATA_CMD_READ_10                     0x28   ///< defined in ATAPI Removable Rewritable Media Devcies\r
 #define ATA_CMD_WRITE_10                    0x2A   ///< defined in ATAPI Removable Rewritable Media Devcies\r
+#define ATA_CMD_READ_12                     0xA8   ///< defined in ATAPI Removable Rewritable Media Devcies\r
+#define ATA_CMD_WRITE_12                    0xAA   ///< defined in ATAPI Removable Rewritable Media Devcies\r
+#define ATA_CMD_START_STOP_UNIT             0x1B   ///< defined in ATAPI Removable Rewritable Media Devcies\r
+///\r
+/// Start/Stop and Eject Operations\r
+///\r
+///@{\r
+#define   ATA_CMD_SUBOP_STOP_DISC           0x00   ///< Stop the Disc\r
+#define   ATA_CMD_SUBOP_START_DISC          0x01   ///< Start the Disc and acquire the format type\r
+#define   ATA_CMD_SUBOP_EJECT_DISC          0x02   ///< Eject the Disc if possible\r
+#define   ATA_CMD_SUBOP_CLOSE_TRAY          0x03   ///< Load the Disc (Close Tray)\r
+///@}\r
 \r
 //\r
 // ATA Commands Code\r
@@ -345,95 +510,93 @@ typedef union {
 //\r
 // Class 1: PIO Data-In Commands\r
 //\r
-#define ATA_CMD_IDENTIFY_DRIVE          0xec\r
-#define ATA_CMD_READ_BUFFER             0xe4\r
-#define ATA_CMD_READ_SECTORS            0x20   ///< defined in ATA-5     \r
-#define ATA_CMD_READ_SECTORS_WITH_RETRY 0x21   ///< defined in ATA-5\r
-#define ATA_CMD_READ_LONG               0x22   ///< defined in ATA-5\r
-#define ATA_CMD_READ_LONG_WITH_RETRY    0x23   ///< defined in ATA-5\r
-#define ATA_CMD_READ_SECTORS_EXT        0x24   ///< defined in ATA-6\r
-\r
+#define ATA_CMD_IDENTIFY_DRIVE          0xec   ///< defined from ATA-3\r
+#define ATA_CMD_READ_BUFFER             0xe4   ///< defined from ATA-1\r
+#define ATA_CMD_READ_SECTORS            0x20   ///< defined from ATA-1     \r
+#define ATA_CMD_READ_SECTORS_WITH_RETRY 0x21   ///< defined from ATA-1, obsoleted from ATA-5\r
+#define ATA_CMD_READ_LONG               0x22   ///< defined from ATA-1, obsoleted from ATA-5\r
+#define ATA_CMD_READ_LONG_WITH_RETRY    0x23   ///< defined from ATA-1, obsoleted from ATA-5\r
+#define ATA_CMD_READ_SECTORS_EXT        0x24   ///< defined from ATA-6\r
 \r
 //\r
 // Class 2: PIO Data-Out Commands\r
 //\r
-#define ATA_CMD_FORMAT_TRACK              0x50  ///< defined in ATA-3\r
-#define ATA_CMD_WRITE_BUFFER              0xe8  ///< defined in ATA-6  \r
-#define ATA_CMD_WRITE_SECTORS             0x30  ///< defined in ATA-6\r
-#define ATA_CMD_WRITE_SECTORS_WITH_RETRY  0x31  ///< defined in ATA-4\r
-#define ATA_CMD_WRITE_LONG                0x32  ///< defined in ATA-3\r
-#define ATA_CMD_WRITE_LONG_WITH_RETRY     0x33  ///< defined in ATA-3\r
-#define ATA_CMD_WRITE_VERIFY              0x3c  ///< defined in ATA-3\r
-#define ATA_CMD_WRITE_SECTORS_EXT         0x34  ///< defined in ATA-6\r
+#define ATA_CMD_FORMAT_TRACK              0x50  ///< defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_CMD_WRITE_BUFFER              0xe8  ///< defined from ATA-1  \r
+#define ATA_CMD_WRITE_SECTORS             0x30  ///< defined from ATA-1\r
+#define ATA_CMD_WRITE_SECTORS_WITH_RETRY  0x31  ///< defined from ATA-1, obsoleted from ATA-5\r
+#define ATA_CMD_WRITE_LONG                0x32  ///< defined from ATA-1, obsoleted from ATA-5\r
+#define ATA_CMD_WRITE_LONG_WITH_RETRY     0x33  ///< defined from ATA-1, obsoleted from ATA-5\r
+#define ATA_CMD_WRITE_VERIFY              0x3c  ///< defined from ATA-1, obsoleted from ATA-5\r
+#define ATA_CMD_WRITE_SECTORS_EXT         0x34  ///< defined from ATA-6\r
 \r
 //\r
 // Class 3 No Data Command\r
 //\r
-#define ATA_CMD_ACK_MEDIA_CHANGE        0xdb  ///< defined in ATA-2\r
-#define ATA_CMD_BOOT_POST_BOOT          0xdc  ///< defined in ATA-2\r
-#define ATA_CMD_BOOT_PRE_BOOT           0xdd  ///< defined in ATA-2\r
-#define ATA_CMD_CHECK_POWER_MODE        0x98  ///< defined in ATA-3\r
-#define ATA_CMD_CHECK_POWER_MODE_ALIAS  0xe5  ///< defined in ATA-6\r
-#define ATA_CMD_DOOR_LOCK               0xde  ///< defined in ATA-6\r
-#define ATA_CMD_DOOR_UNLOCK             0xdf  ///< defined in ATA-6\r
-#define ATA_CMD_EXEC_DRIVE_DIAG         0x90  ///< defined in ATA-6\r
-#define ATA_CMD_IDLE_ALIAS              0x97  ///< defined in ATA-3\r
-#define ATA_CMD_IDLE                    0xe3  ///< defined in ATA-6\r
-#define ATA_CMD_IDLE_IMMEDIATE          0x95  ///< defined in ATA-3\r
-#define ATA_CMD_IDLE_IMMEDIATE_ALIAS    0xe1  ///< defined in ATA-6\r
-#define ATA_CMD_INIT_DRIVE_PARAM        0x91  ///< defined in ATA-5\r
-#define ATA_CMD_RECALIBRATE             0x10  ///< defined in ATA-3\r
-#define ATA_CMD_READ_DRIVE_STATE        0xe9  ///< defined in ATA-2\r
-#define ATA_CMD_SET_MULTIPLE_MODE       0xC6  ///< defined in ATA-6\r
-#define ATA_CMD_READ_VERIFY             0x40  ///< defined in ATA-6\r
-#define ATA_CMD_READ_VERIFY_WITH_RETRY  0x41  ///< defined in ATA-4\r
-#define ATA_CMD_SEEK                    0x70  ///< defined in ATA-6\r
-#define ATA_CMD_SET_FEATURES            0xef  ///< defined in ATA-6\r
-#define ATA_CMD_STANDBY                 0x96  ///< defined in ATA-3\r
-#define ATA_CMD_STANDBY_ALIAS           0xe2  ///< defined in ATA-6\r
-#define ATA_CMD_STANDBY_IMMEDIATE       0x94  ///< defined in ATA-3\r
-#define ATA_CMD_STANDBY_IMMEDIATE_ALIAS 0xe0  ///< defined in ATA-6\r
-///\r
-/// S.M.A.R.T\r
-///\r
-#define ATA_CMD_SMART               0xb0\r
-#define ATA_CONSTANT_C2             0xc2\r
-#define ATA_CONSTANT_4F             0x4f\r
-#define ATA_SMART_ENABLE_OPERATION  0xd8\r
-#define ATA_SMART_RETURN_STATUS     0xda\r
-\r
-\r
-///\r
-/// Class 4: DMA Command\r
-///\r
-#define ATA_CMD_READ_DMA              0xc8   ///< defined in ATA-6\r
-#define ATA_CMD_READ_DMA_WITH_RETRY   0xc9   ///< defined in ATA-4\r
-#define ATA_CMD_READ_DMA_EXT          0x25   ///< defined in ATA-6\r
-#define ATA_CMD_WRITE_DMA             0xca   ///< defined in ATA-6\r
-#define ATA_CMD_WRITE_DMA_WITH_RETRY  0xcb   ///< defined in ATA-4\r
-#define ATA_CMD_WRITE_DMA_EXT         0x35   ///< defined in ATA-6\r
-\r
-\r
-\r
-///\r
-/// default content of device control register, disable INT,\r
+#define ATA_CMD_ACK_MEDIA_CHANGE        0xdb  ///< defined from ATA-1, obsoleted from ATA-5 \r
+#define ATA_CMD_BOOT_POST_BOOT          0xdc  ///< defined from ATA-1, obsoleted from ATA-3\r
+#define ATA_CMD_BOOT_PRE_BOOT           0xdd  ///< defined from ATA-1, obsoleted from ATA-3\r
+#define ATA_CMD_CHECK_POWER_MODE        0x98  ///< defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_CMD_CHECK_POWER_MODE_ALIAS  0xe5  ///< defined from ATA-1\r
+#define ATA_CMD_DOOR_LOCK               0xde  ///< defined from ATA-1\r
+#define ATA_CMD_DOOR_UNLOCK             0xdf  ///< defined from ATA-1\r
+#define ATA_CMD_EXEC_DRIVE_DIAG         0x90  ///< defined from ATA-1\r
+#define ATA_CMD_IDLE_ALIAS              0x97  ///< defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_CMD_IDLE                    0xe3  ///< defined from ATA-1\r
+#define ATA_CMD_IDLE_IMMEDIATE          0x95  ///< defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_CMD_IDLE_IMMEDIATE_ALIAS    0xe1  ///< defined from ATA-1\r
+#define ATA_CMD_INIT_DRIVE_PARAM        0x91  ///< defined from ATA-1, obsoleted from ATA-6\r
+#define ATA_CMD_RECALIBRATE             0x10  ///< defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_CMD_READ_DRIVE_STATE        0xe9  ///< defined from ATA-1, obsoleted from ATA-3\r
+#define ATA_CMD_SET_MULTIPLE_MODE       0xC6  ///< defined from ATA-2\r
+#define ATA_CMD_READ_VERIFY             0x40  ///< defined from ATA-1\r
+#define ATA_CMD_READ_VERIFY_WITH_RETRY  0x41  ///< defined from ATA-1, obsoleted from ATA-5\r
+#define ATA_CMD_SEEK                    0x70  ///< defined from ATA-1\r
+#define ATA_CMD_SET_FEATURES            0xef  ///< defined from ATA-1\r
+#define ATA_CMD_STANDBY                 0x96  ///< defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_CMD_STANDBY_ALIAS           0xe2  ///< defined from ATA-1\r
+#define ATA_CMD_STANDBY_IMMEDIATE       0x94  ///< defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_CMD_STANDBY_IMMEDIATE_ALIAS 0xe0  ///< defined from ATA-1\r
+//\r
+// S.M.A.R.T\r
+//\r
+#define ATA_CMD_SMART               0xb0  ///< defined from ATA-3\r
+#define ATA_CONSTANT_C2             0xc2  ///< reserved\r
+#define ATA_CONSTANT_4F             0x4f  ///< reserved\r
+#define ATA_SMART_ENABLE_OPERATION  0xd8  ///< reserved\r
+#define ATA_SMART_RETURN_STATUS     0xda  ///< defined from ATA-3\r
+\r
+//\r
+// Class 4: DMA Command\r
+//\r
+#define ATA_CMD_READ_DMA              0xc8   ///< defined from ATA-1\r
+#define ATA_CMD_READ_DMA_WITH_RETRY   0xc9   ///< defined from ATA-1, obsoleted from ATA-5\r
+#define ATA_CMD_READ_DMA_EXT          0x25   ///< defined from ATA-6\r
+#define ATA_CMD_WRITE_DMA             0xca   ///< defined from ATA-1\r
+#define ATA_CMD_WRITE_DMA_WITH_RETRY  0xcb   ///< defined from ATA-1, obsoleted from ATA-\r
+#define ATA_CMD_WRITE_DMA_EXT         0x35   ///< defined from ATA-6\r
+        \r
+///\r
+/// Default content of device control register, disable INT,\r
 /// Bit3 is set to 1 according ATA-1\r
 ///\r
 #define ATA_DEFAULT_CTL           (0x0a)  \r
 ///\r
-/// default context of Device/Head Register,\r
-/// Bit7 and Bit5 are set to 1 for back-compatibilities\r
+/// Default context of Device/Head Register,\r
+/// Bit7 and Bit5 are set to 1 for back-compatibilities.\r
 ///\r
 #define ATA_DEFAULT_CMD           (0xa0)\r
 \r
 #define ATAPI_MAX_BYTE_COUNT  (0xfffe)\r
 \r
-///\r
-/// Sense Key, Additional Sense Codes and Additional Sense Code Qualifier\r
-/// defined in MultiMedia Commands (MMC, MMC-2) \r
-///\r
-/// Sense Key \r
-///\r
+#define ATA_REQUEST_SENSE_ERROR (0x70) ///< defined in SFF-8070i\r
+\r
+//\r
+// Sense Key, Additional Sense Codes and Additional Sense Code Qualifier\r
+// defined in MultiMedia Commands (MMC, MMC-2) \r
+//\r
+// Sense Key \r
+//\r
 #define ATA_SK_NO_SENSE         (0x0)\r
 #define ATA_SK_RECOVERY_ERROR   (0x1)\r
 #define ATA_SK_NOT_READY        (0x2)\r
@@ -465,7 +628,7 @@ typedef union {
 #define ATA_ASC_INVALID_FIELD               (0x24)\r
 #define ATA_ASC_WRITE_PROTECTED             (0x27)\r
 #define ATA_ASC_MEDIA_CHANGE                (0x28)\r
-#define ATA_ASC_RESET                       (0x29)  ///< Power On Reset or Bus Reset occurred\r
+#define ATA_ASC_RESET                       (0x29)  ///< Power On Reset or Bus Reset occurred.\r
 #define ATA_ASC_ILLEGAL_FIELD               (0x26)\r
 #define ATA_ASC_NO_MEDIA                    (0x3A)\r
 #define ATA_ASC_ILLEGAL_MODE_FOR_THIS_TRACK (0x64)\r
@@ -475,35 +638,36 @@ typedef union {
 //\r
 #define ATA_ASCQ_IN_PROGRESS  (0x01)\r
 \r
-///\r
-/// Error Register\r
-///\r
-#define ATA_ERRREG_BBK   BIT7  ///< Bad block detected      defined in ATA-1\r
-#define ATA_ERRREG_UNC   BIT6  ///< Uncorrectable Data      defined in ATA-3\r
-#define ATA_ERRREG_MC    BIT5  ///< Media Change            defined in ATA-3\r
-#define ATA_ERRREG_IDNF  BIT4  ///< ID Not Found            defined in ATA-3\r
-#define ATA_ERRREG_MCR   BIT3  ///< Media Change Requested  defined in ATA-3\r
-#define ATA_ERRREG_ABRT  BIT2  ///< Aborted Command         defined in ATA-6\r
-#define ATA_ERRREG_TK0NF BIT1  ///< Track 0 Not Found       defined in ATA-3\r
-#define ATA_ERRREG_AMNF  BIT0  ///< Address Mark Not Found  defined in ATA-3\r
+//\r
+// Error Register\r
+//\r
+#define ATA_ERRREG_BBK   BIT7  ///< Bad block detected      defined from ATA-1, obsoleted from ATA-2\r
+#define ATA_ERRREG_UNC   BIT6  ///< Uncorrectable Data      defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_ERRREG_MC    BIT5  ///< Media Change            defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_ERRREG_IDNF  BIT4  ///< ID Not Found            defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_ERRREG_MCR   BIT3  ///< Media Change Requested  defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_ERRREG_ABRT  BIT2  ///< Aborted Command         defined from ATA-1\r
+#define ATA_ERRREG_TK0NF BIT1  ///< Track 0 Not Found       defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_ERRREG_AMNF  BIT0  ///< Address Mark Not Found  defined from ATA-1, obsoleted from ATA-4\r
 \r
-///\r
-/// Status Register\r
-///\r
-#define ATA_STSREG_BSY   BIT7  ///< Controller Busy         defined in ATA-6\r
-#define ATA_STSREG_DRDY  BIT6  ///< Drive Ready             defined in ATA-6\r
-#define ATA_STSREG_DWF   BIT5  ///< Drive Write Fault       defined in ATA-6\r
-#define ATA_STSREG_DSC   BIT4  ///< Disk Seek Complete      defined in ATA-3\r
-#define ATA_STSREG_DRQ   BIT3  ///< Data Request            defined in ATA-6\r
-#define ATA_STSREG_CORR  BIT2  ///< Corrected Data          defined in ATA-3\r
-#define ATA_STSREG_IDX   BIT1  ///< Index                   defined in ATA-3\r
-#define ATA_STSREG_ERR   BIT0  ///< Error                   defined in ATA-6\r
+//\r
+// Status Register\r
+//\r
+#define ATA_STSREG_BSY   BIT7  ///< Controller Busy         defined from ATA-1\r
+#define ATA_STSREG_DRDY  BIT6  ///< Drive Ready             defined from ATA-1\r
+#define ATA_STSREG_DWF   BIT5  ///< Drive Write Fault       defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_STSREG_DF    BIT5  ///< Drive Fault             defined from ATA-6\r
+#define ATA_STSREG_DSC   BIT4  ///< Disk Seek Complete      defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_STSREG_DRQ   BIT3  ///< Data Request            defined from ATA-1\r
+#define ATA_STSREG_CORR  BIT2  ///< Corrected Data          defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_STSREG_IDX   BIT1  ///< Index                   defined from ATA-1, obsoleted from ATA-4\r
+#define ATA_STSREG_ERR   BIT0  ///< Error                   defined from ATA-1\r
 \r
-///\r
-/// Device Control Register\r
-///\r
-#define ATA_CTLREG_SRST  BIT2  ///< Software Reset\r
-#define ATA_CTLREG_IEN_L BIT1  ///< Interrupt Enable #\r
+//\r
+// Device Control Register\r
+//\r
+#define ATA_CTLREG_SRST  BIT2  ///< Software Reset.\r
+#define ATA_CTLREG_IEN_L BIT1  ///< Interrupt Enable #.\r
 \r
 #endif\r
 \r