// /*************************************************************************** // Aaru Data Preservation Suite // ---------------------------------------------------------------------------- // // Filename : EVPD.cs // Author(s) : Natalia Portillo // // Component : Device structures decoders. // // --[ Description ] ---------------------------------------------------------- // // Decodes SCSI EVPDs. // // --[ License ] -------------------------------------------------------------- // // This library is free software; you can redistribute it and/or modify // it under the terms of the GNU Lesser General Public License as // published by the Free Software Foundation; either version 2.1 of the // License, or (at your option) any later version. // // This library is distributed in the hope that it will be useful, but // WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU // Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public // License along with this library; if not, see . // // ---------------------------------------------------------------------------- // Copyright © 2011-2022 Natalia Portillo // ****************************************************************************/ namespace Aaru.Decoders.SCSI; using System; using System.Collections.Generic; using System.Diagnostics.CodeAnalysis; using System.Linq; using System.Text; using System.Text.RegularExpressions; using Aaru.CommonTypes.Structs.Devices.ATA; using Aaru.CommonTypes.Structs.Devices.SCSI; using Aaru.Helpers; [SuppressMessage("ReSharper", "InconsistentNaming"), SuppressMessage("ReSharper", "MemberCanBeInternal"), SuppressMessage("ReSharper", "MemberCanBePrivate.Global"), SuppressMessage("ReSharper", "NotAccessedField.Global"), SuppressMessage("ReSharper", "UnassignedField.Global")] public static class EVPD { /// Decodes VPD page 0x00: Supported VPD pages /// A byte array containing all supported VPD pages. /// Page 0x00. public static byte[] DecodePage00(byte[] page) { if(page?[1] != 0) return null; if(page.Length != page[3] + 4) return null; var decoded = new byte[page.Length - 4]; Array.Copy(page, 4, decoded, 0, page.Length - 4); return decoded; } /// Decides VPD pages 0x01 to 0x7F: ASCII Information /// An ASCII string with the contents of the page. /// Page 0x01-0x7F. public static string DecodeASCIIPage(byte[] page) { if(page == null) return null; if(page[1] == 0 || page[1] > 0x7F) return null; if(page.Length != page[3] + 4) return null; var ascii = new byte[page[4]]; Array.Copy(page, 5, ascii, 0, page[4]); return StringHandlers.CToString(ascii); } /// Decodes VPD page 0x80: Unit Serial Number /// The unit serial number. /// Page 0x80. public static string DecodePage80(byte[] page) { if(page?[1] != 0x80) return null; if(page.Length != page[3] + 4) return null; var ascii = new byte[page.Length - 4]; Array.Copy(page, 4, ascii, 0, page.Length - 4); for(var i = 0; i < ascii.Length - 1; i++) if(ascii[i] < 0x20) return null; return StringHandlers.CToString(ascii); } /// Decodes VPD page 0x82: ASCII implemented operating definition /// ASCII implemented operating definition. /// Page 0x82. public static string DecodePage82(byte[] page) { if(page?[1] != 0x82) return null; if(page.Length != page[3] + 4) return null; var ascii = new byte[page.Length - 4]; Array.Copy(page, 4, ascii, 0, page.Length - 4); return StringHandlers.CToString(ascii); } #region EVPD Page 0xB1: Manufacturer-assigned Serial Number page public static string DecodePageB1(byte[] page) { if(page?[1] != 0xB1) return null; if(page.Length != page[3] + 4) return null; var ascii = new byte[page.Length - 4]; Array.Copy(page, 4, ascii, 0, page.Length - 4); return StringHandlers.CToString(ascii).Trim(); } #endregion EVPD Page 0xB1: Manufacturer-assigned Serial Number page #region EVPD Page 0xB2: TapeAlert Supported Flags page public static ulong DecodePageB2(byte[] page) { if(page?[1] != 0xB2) return 0; if(page.Length != 12) return 0; var bitmap = new byte[8]; Array.Copy(page, 4, bitmap, 0, 8); return BitConverter.ToUInt64(bitmap.Reverse().ToArray(), 0); } #endregion EVPD Page 0xB2: TapeAlert Supported Flags page #region EVPD Page 0xB3: Automation Device Serial Number page public static string DecodePageB3(byte[] page) { if(page?[1] != 0xB3) return null; if(page.Length != page[3] + 4) return null; var ascii = new byte[page.Length - 4]; Array.Copy(page, 4, ascii, 0, page.Length - 4); return StringHandlers.CToString(ascii).Trim(); } #endregion EVPD Page 0xB3: Automation Device Serial Number page #region EVPD Page 0xB4: Data Transfer Device Element Address page public static string DecodePageB4(byte[] page) { if(page?[1] != 0xB3) return null; if(page.Length != page[3] + 4) return null; var element = new byte[page.Length - 4]; var sb = new StringBuilder(); foreach(byte b in element) sb.AppendFormat("{0:X2}", b); return sb.ToString(); } #endregion EVPD Page 0xB4: Data Transfer Device Element Address page #region EVPD Page 0x81: Implemented operating definition page /// Implemented operating definition page Page code 0x81 public struct Page_81 { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public byte PageLength; /// Current operating definition public ScsiDefinitions Current; /// Default operating definition public ScsiDefinitions Default; /// Support operating definition list public ScsiDefinitions[] Supported; } public static Page_81? DecodePage_81(byte[] pageResponse) { if(pageResponse?[1] != 0x81) return null; if(pageResponse[3] + 4 != pageResponse.Length) return null; if(pageResponse.Length < 6) return null; var decoded = new Page_81 { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (byte)(pageResponse[3] + 4), Current = (ScsiDefinitions)(pageResponse[4] & 0x7F), Default = (ScsiDefinitions)(pageResponse[5] & 0x7F) }; var position = 6; var definitions = new List(); while(position < pageResponse.Length) { var definition = (ScsiDefinitions)(pageResponse[position] & 0x7F); position++; definitions.Add(definition); } decoded.Supported = definitions.ToArray(); return decoded; } public static string PrettifyPage_81(byte[] pageResponse) => PrettifyPage_81(DecodePage_81(pageResponse)); public static string DefinitionToString(ScsiDefinitions definition) { switch(definition) { case ScsiDefinitions.Current: return ""; case ScsiDefinitions.CCS: return "CCS"; case ScsiDefinitions.SCSI1: return "SCSI-1"; case ScsiDefinitions.SCSI2: return "SCSI-2"; case ScsiDefinitions.SCSI3: return "SCSI-3"; default: return $"Unknown definition code {(byte)definition}"; } } public static string PrettifyPage_81(Page_81? modePage) { if(!modePage.HasValue) return null; Page_81 page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("SCSI Implemented operating definitions:"); sb.AppendFormat("\tDefault operating definition: {0}", DefinitionToString(page.Current)).AppendLine(); sb.AppendFormat("\tCurrent operating definition: {0}", DefinitionToString(page.Current)).AppendLine(); if(page.Supported.Length == 0) { sb.AppendLine("\tThere are no supported definitions"); return sb.ToString(); } sb.AppendLine("\tSupported operating definitions:"); foreach(ScsiDefinitions definition in page.Supported) sb.AppendFormat("\t\t{0}", DefinitionToString(definition)).AppendLine(); return sb.ToString(); } #endregion EVPD Page 0x81: Implemented operating definition page #region EVPD Page 0x83: Device identification page public enum IdentificationAssociation : byte { /// Identifier field is associated with the addressed logical unit LogicalUnit = 0, /// Identifier field is associated with the target port TargetPort = 1, /// Identifier field is associated with the target device that contains the LUN TargetDevice = 2 } public enum IdentificationCodeSet : byte { /// Identifier is binary Binary = 1, /// Identifier is pure ASCII ASCII = 2, /// Identifier is in UTF-8 UTF8 = 3 } public enum IdentificationTypes : byte { /// No assignment authority was used and there is no guarantee the identifier is unique NoAuthority = 0, /// Concatenates vendor and product identifier from INQUIRY plus unit serial number from page 80h Inquiry = 1, /// Identifier is a 64-bit IEEE EUI-64, or extended EUI = 2, /// Identifier is compatible with 64-bit FC-PH Name_Identifier NAA = 3, /// Identifier to relative port in device Relative = 4, /// Identifier to group of target ports in device TargetPortGroup = 5, /// Identifier to group of target LUNs in device LogicalUnitGroup = 6, /// MD5 of device identification values MD5 = 7, /// SCSI name string SCSI = 8, /// Protocol specific port identifier ProtocolSpecific = 9 } public struct IdentificatonDescriptor { /// Protocol identifier public ProtocolIdentifiers ProtocolIdentifier; /// Defines how the identifier is stored public IdentificationCodeSet CodeSet; /// Set if protocol identifier is valid public bool PIV; /// Identifies which decide the identifier associates with public IdentificationAssociation Association; /// Defines the type of the identifier public IdentificationTypes Type; /// Length of the identifier public byte Length; /// Identifier as a string if applicable public string ASCII; /// Binary identifier public byte[] Binary; } /// Device identification page Page code 0x83 public struct Page_83 { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public byte PageLength; /// The descriptors. public IdentificatonDescriptor[] Descriptors; } public static Page_83? DecodePage_83(byte[] pageResponse) { if(pageResponse?[1] != 0x83) return null; if(pageResponse[3] + 4 != pageResponse.Length) return null; if(pageResponse.Length < 6) return null; var decoded = new Page_83 { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (byte)(pageResponse[3] + 4) }; var position = 4; var descriptors = new List(); while(position < pageResponse.Length) { var descriptor = new IdentificatonDescriptor { ProtocolIdentifier = (ProtocolIdentifiers)((pageResponse[position] & 0xF0) >> 4), CodeSet = (IdentificationCodeSet)(pageResponse[position] & 0x0F), PIV = (pageResponse[position + 1] & 0x80) == 0x80, Association = (IdentificationAssociation)((pageResponse[position + 1] & 0x30) >> 4), Type = (IdentificationTypes)(pageResponse[position + 1] & 0x0F), Length = pageResponse[position + 3] }; descriptor.Binary = new byte[descriptor.Length]; if(descriptor.Length + position + 4 >= pageResponse.Length) descriptor.Length = (byte)(pageResponse.Length - position - 4); Array.Copy(pageResponse, position + 4, descriptor.Binary, 0, descriptor.Length); switch(descriptor.CodeSet) { case IdentificationCodeSet.ASCII: descriptor.ASCII = StringHandlers.CToString(descriptor.Binary); break; case IdentificationCodeSet.UTF8: descriptor.ASCII = Encoding.UTF8.GetString(descriptor.Binary); break; default: descriptor.ASCII = ""; break; } position += 4 + descriptor.Length; descriptors.Add(descriptor); } decoded.Descriptors = descriptors.ToArray(); return decoded; } public static string PrettifyPage_83(byte[] pageResponse) => PrettifyPage_83(DecodePage_83(pageResponse)); public static string PrettifyPage_83(Page_83? modePage) { if(!modePage.HasValue) return null; Page_83 page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("SCSI Device identification:"); if(page.Descriptors.Length == 0) { sb.AppendLine("\tThere are no identifiers"); return sb.ToString(); } foreach(IdentificatonDescriptor descriptor in page.Descriptors) { switch(descriptor.Association) { case IdentificationAssociation.LogicalUnit: sb.AppendLine("\tIdentifier belongs to addressed logical unit"); break; case IdentificationAssociation.TargetPort: sb.AppendLine("\tIdentifier belongs to target port"); break; case IdentificationAssociation.TargetDevice: sb.AppendLine("\tIdentifier belongs to target device that contains the addressed logical unit"); break; default: sb.AppendFormat("\tIndentifier has unknown association with code {0}", (byte)descriptor.Association).AppendLine(); break; } if(descriptor.PIV) { string protocol; switch(descriptor.ProtocolIdentifier) { case ProtocolIdentifiers.ADT: protocol = "Automation/Drive Interface Transport"; break; case ProtocolIdentifiers.ATA: protocol = "AT Attachment Interface (ATA/ATAPI)"; break; case ProtocolIdentifiers.FibreChannel: protocol = "Fibre Channel"; break; case ProtocolIdentifiers.Firewire: protocol = "IEEE 1394"; break; case ProtocolIdentifiers.iSCSI: protocol = "Internet SCSI"; break; case ProtocolIdentifiers.NoProtocol: protocol = "no specific"; break; case ProtocolIdentifiers.PCIe: protocol = "PCI Express"; break; case ProtocolIdentifiers.RDMAP: protocol = "SCSI Remote Direct Memory Access"; break; case ProtocolIdentifiers.SAS: protocol = "Serial Attachment SCSI"; break; case ProtocolIdentifiers.SCSI: protocol = "Parallel SCSI"; break; case ProtocolIdentifiers.SCSIe: protocol = "SCSI over PCI Express"; break; case ProtocolIdentifiers.SSA: protocol = "SSA"; break; case ProtocolIdentifiers.UAS: protocol = "USB Attached SCSI"; break; default: protocol = $"unknown code {(byte)descriptor.ProtocolIdentifier}"; break; } sb.AppendFormat("\tDescriptor referes to {0} protocol", protocol).AppendLine(); } switch(descriptor.Type) { case IdentificationTypes.NoAuthority: switch(descriptor.CodeSet) { case IdentificationCodeSet.ASCII: case IdentificationCodeSet.UTF8: sb.AppendFormat("\tVendor descriptor contains: {0}", descriptor.ASCII).AppendLine(); break; case IdentificationCodeSet.Binary: sb.AppendFormat("\tVendor descriptor contains binary data (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)).AppendLine(); break; default: sb.AppendFormat("\tVendor descriptor contains unknown kind {1} of data (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40), (byte)descriptor.CodeSet).AppendLine(); break; } break; case IdentificationTypes.Inquiry: switch(descriptor.CodeSet) { case IdentificationCodeSet.ASCII: case IdentificationCodeSet.UTF8: sb.AppendFormat("\tInquiry descriptor contains: {0}", descriptor.ASCII).AppendLine(); break; case IdentificationCodeSet.Binary: sb.AppendFormat("\tInquiry descriptor contains binary data (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)).AppendLine(); break; default: sb.AppendFormat("\tInquiry descriptor contains unknown kind {1} of data (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40), (byte)descriptor.CodeSet).AppendLine(); break; } break; case IdentificationTypes.EUI: if(descriptor.CodeSet is IdentificationCodeSet.ASCII or IdentificationCodeSet.UTF8) sb.AppendFormat("\tIEEE EUI-64: {0}", descriptor.ASCII).AppendLine(); else { sb.AppendFormat("\tIEEE EUI-64: {0:X2}", descriptor.Binary[0]); for(var i = 1; i < descriptor.Binary.Length; i++) sb.AppendFormat(":{0:X2}", descriptor.Binary[i]); sb.AppendLine(); } break; case IdentificationTypes.NAA: if(descriptor.CodeSet is IdentificationCodeSet.ASCII or IdentificationCodeSet.UTF8) sb.AppendFormat("\tNAA: {0}", descriptor.ASCII).AppendLine(); else { sb.AppendFormat("\tNAA: {0:X2}", descriptor.Binary[0]); for(var i = 1; i < descriptor.Binary.Length; i++) sb.AppendFormat(":{0:X2}", descriptor.Binary[i]); sb.AppendLine(); } break; case IdentificationTypes.Relative: if(descriptor.CodeSet is IdentificationCodeSet.ASCII or IdentificationCodeSet.UTF8) sb.AppendFormat("\tRelative target port identifier: {0}", descriptor.ASCII).AppendLine(); else sb.AppendFormat("\tRelative target port identifier: {0}", (descriptor.Binary[2] << 8) + descriptor.Binary[3]).AppendLine(); break; case IdentificationTypes.TargetPortGroup: if(descriptor.CodeSet is IdentificationCodeSet.ASCII or IdentificationCodeSet.UTF8) sb.AppendFormat("\tTarget group identifier: {0}", descriptor.ASCII).AppendLine(); else sb.AppendFormat("\tTarget group identifier: {0}", (descriptor.Binary[2] << 8) + descriptor.Binary[3]).AppendLine(); break; case IdentificationTypes.LogicalUnitGroup: if(descriptor.CodeSet is IdentificationCodeSet.ASCII or IdentificationCodeSet.UTF8) sb.AppendFormat("\tLogical unit group identifier: {0}", descriptor.ASCII).AppendLine(); else sb.AppendFormat("\tLogical unit group identifier: {0}", (descriptor.Binary[2] << 8) + descriptor.Binary[3]).AppendLine(); break; case IdentificationTypes.MD5: if(descriptor.CodeSet is IdentificationCodeSet.ASCII or IdentificationCodeSet.UTF8) sb.AppendFormat("\tMD5 logical unit identifier: {0}", descriptor.ASCII).AppendLine(); else { sb.AppendFormat("\tMD5 logical unit identifier: {0:x2}", descriptor.Binary[0]); for(var i = 1; i < descriptor.Binary.Length; i++) sb.AppendFormat("{0:x2}", descriptor.Binary[i]); sb.AppendLine(); } break; case IdentificationTypes.SCSI: if(descriptor.CodeSet is IdentificationCodeSet.ASCII or IdentificationCodeSet.UTF8) sb.AppendFormat("\tSCSI name string identifier: {0}", descriptor.ASCII).AppendLine(); else sb.AppendFormat("\tSCSI name string identifier (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)).AppendLine(); break; case IdentificationTypes.ProtocolSpecific: { if(descriptor.PIV) switch(descriptor.ProtocolIdentifier) { case ProtocolIdentifiers.ADT: sb. AppendFormat("\tProtocol (Automation/Drive Interface Transport) specific descriptor with unknown format (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)). AppendLine(); break; case ProtocolIdentifiers.ATA: sb. AppendFormat("\tProtocol (ATA/ATAPI) specific descriptor with unknown format (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)). AppendLine(); break; case ProtocolIdentifiers.FibreChannel: sb. AppendFormat("\tProtocol (Fibre Channel) specific descriptor with unknown format (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)). AppendLine(); break; case ProtocolIdentifiers.Firewire: sb. AppendFormat("\tProtocol (IEEE 1394) specific descriptor with unknown format (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)). AppendLine(); break; case ProtocolIdentifiers.iSCSI: sb. AppendFormat("\tProtocol (Internet SCSI) specific descriptor with unknown format (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)). AppendLine(); break; case ProtocolIdentifiers.NoProtocol: sb. AppendFormat("\tProtocol (unknown) specific descriptor with unknown format (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)). AppendLine(); break; case ProtocolIdentifiers.PCIe: sb. AppendFormat("\tProtocol (PCI Express) specific descriptor with unknown format (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)). AppendLine(); break; case ProtocolIdentifiers.RDMAP: sb. AppendFormat("\tProtocol (SCSI Remote Direct Memory Access) specific descriptor with unknown format (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)). AppendLine(); break; case ProtocolIdentifiers.SAS: sb. AppendFormat("\tProtocol (Serial Attachment SCSI) specific descriptor with unknown format (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)). AppendLine(); break; case ProtocolIdentifiers.SCSI: sb. AppendFormat("\tProtocol (Parallel SCSI) specific descriptor with unknown format (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)). AppendLine(); break; case ProtocolIdentifiers.SSA: sb.AppendFormat("\tProtocol (SSA) specific descriptor with unknown format (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)).AppendLine(); break; case ProtocolIdentifiers.SCSIe: sb.AppendFormat("\tProtocol (SCSIe) specific descriptor: Routing ID is {0}", (descriptor.Binary[0] << 8) + descriptor.Binary[1]).AppendLine(); break; case ProtocolIdentifiers.UAS: sb.AppendFormat("\tProtocol (UAS) specific descriptor: USB address {0} interface {1}", descriptor.Binary[0] & 0x7F, descriptor.Binary[2]).AppendLine(); break; default: sb. AppendFormat("\tProtocol (unknown code {0}) specific descriptor with unknown format (hex): {1}", (byte)descriptor.ProtocolIdentifier, PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40)). AppendLine(); break; } } break; default: switch(descriptor.CodeSet) { case IdentificationCodeSet.ASCII: case IdentificationCodeSet.UTF8: sb.AppendFormat("\tUnknown descriptor type {1} contains: {0}", descriptor.ASCII, (byte)descriptor.Type).AppendLine(); break; case IdentificationCodeSet.Binary: sb.AppendFormat("\tUnknown descriptor type {1} contains binary data (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40), (byte)descriptor.Type).AppendLine(); break; default: sb.AppendFormat("Inquiry descriptor type {2} contains unknown kind {1} of data (hex): {0}", PrintHex.ByteArrayToHexArrayString(descriptor.Binary, 40), (byte)descriptor.CodeSet, (byte)descriptor.Type).AppendLine(); break; } break; } } return sb.ToString(); } #endregion EVPD Page 0x83: Device identification page #region EVPD Page 0x84: Software Interface Identification page public struct SoftwareIdentifier { /// EUI-48 identifier public byte[] Identifier; } /// Software Interface Identification page Page code 0x84 public struct Page_84 { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public byte PageLength; /// The descriptors. public SoftwareIdentifier[] Identifiers; } public static Page_84? DecodePage_84(byte[] pageResponse) { if(pageResponse?[1] != 0x84) return null; if(pageResponse[3] + 4 != pageResponse.Length) return null; if(pageResponse.Length < 10) return null; var decoded = new Page_84 { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (byte)(pageResponse[3] + 4) }; var position = 4; var identifiers = new List(); while(position < pageResponse.Length) { var identifier = new SoftwareIdentifier { Identifier = new byte[6] }; Array.Copy(pageResponse, position, identifier.Identifier, 0, 6); identifiers.Add(identifier); position += 6; } decoded.Identifiers = identifiers.ToArray(); return decoded; } public static string PrettifyPage_84(byte[] pageResponse) => PrettifyPage_84(DecodePage_84(pageResponse)); public static string PrettifyPage_84(Page_84? modePage) { if(!modePage.HasValue) return null; Page_84 page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("SCSI Software Interface Identifiers:"); if(page.Identifiers.Length == 0) { sb.AppendLine("\tThere are no identifiers"); return sb.ToString(); } foreach(SoftwareIdentifier identifier in page.Identifiers) { sb.AppendFormat("\t{0:X2}", identifier.Identifier[0]); for(var i = 1; i < identifier.Identifier.Length; i++) sb.AppendFormat(":{0:X2}", identifier.Identifier[i]); sb.AppendLine(); } return sb.ToString(); } #endregion EVPD Page 0x84: Software Interface Identification page #region EVPD Page 0x85: Management Network Addresses page public enum NetworkServiceTypes : byte { Unspecified = 0, StorageConf = 1, Diagnostics = 2, Status = 3, Logging = 4, CodeDownload = 5, CopyService = 6, Administrative = 7 } public struct NetworkDescriptor { /// Identifies which device the identifier associates with public IdentificationAssociation Association; /// Defines the type of the identifier public NetworkServiceTypes Type; /// Length of the identifier public ushort Length; /// Binary identifier public byte[] Address; } /// Device identification page Page code 0x85 public struct Page_85 { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public ushort PageLength; /// The descriptors. public NetworkDescriptor[] Descriptors; } public static Page_85? DecodePage_85(byte[] pageResponse) { if(pageResponse?[1] != 0x85) return null; if((pageResponse[2] << 8) + pageResponse[3] + 4 != pageResponse.Length) return null; if(pageResponse.Length < 4) return null; var decoded = new Page_85 { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (ushort)((pageResponse[2] << 8) + pageResponse[3] + 4) }; var position = 4; var descriptors = new List(); while(position < pageResponse.Length) { var descriptor = new NetworkDescriptor { Association = (IdentificationAssociation)((pageResponse[position] & 0x60) >> 5), Type = (NetworkServiceTypes)(pageResponse[position] & 0x1F), Length = (ushort)((pageResponse[position + 2] << 8) + pageResponse[position + 3]) }; descriptor.Address = new byte[descriptor.Length]; Array.Copy(pageResponse, position + 4, descriptor.Address, 0, descriptor.Length); position += 4 + descriptor.Length; descriptors.Add(descriptor); } decoded.Descriptors = descriptors.ToArray(); return decoded; } public static string PrettifyPage_85(byte[] pageResponse) => PrettifyPage_85(DecodePage_85(pageResponse)); public static string PrettifyPage_85(Page_85? modePage) { if(!modePage.HasValue) return null; Page_85 page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("SCSI Management Network Addresses:"); if(page.Descriptors.Length == 0) { sb.AppendLine("\tThere are no addresses"); return sb.ToString(); } foreach(NetworkDescriptor descriptor in page.Descriptors) { switch(descriptor.Association) { case IdentificationAssociation.LogicalUnit: sb.AppendLine("\tIdentifier belongs to addressed logical unit"); break; case IdentificationAssociation.TargetPort: sb.AppendLine("\tIdentifier belongs to target port"); break; case IdentificationAssociation.TargetDevice: sb.AppendLine("\tIdentifier belongs to target device that contains the addressed logical unit"); break; default: sb.AppendFormat("\tIndentifier has unknown association with code {0}", (byte)descriptor.Association).AppendLine(); break; } switch(descriptor.Type) { case NetworkServiceTypes.CodeDownload: sb.AppendFormat("Address for code download: {0}", StringHandlers.CToString(descriptor.Address)). AppendLine(); break; case NetworkServiceTypes.Diagnostics: sb.AppendFormat("Address for diagnostics: {0}", StringHandlers.CToString(descriptor.Address)). AppendLine(); break; case NetworkServiceTypes.Logging: sb.AppendFormat("Address for logging: {0}", StringHandlers.CToString(descriptor.Address)). AppendLine(); break; case NetworkServiceTypes.Status: sb.AppendFormat("Address for status: {0}", StringHandlers.CToString(descriptor.Address)). AppendLine(); break; case NetworkServiceTypes.StorageConf: sb.AppendFormat("Address for storage configuration service: {0}", StringHandlers.CToString(descriptor.Address)).AppendLine(); break; case NetworkServiceTypes.Unspecified: sb.AppendFormat("Unspecified address: {0}", StringHandlers.CToString(descriptor.Address)). AppendLine(); break; case NetworkServiceTypes.CopyService: sb.AppendFormat("Address for copy service: {0}", StringHandlers.CToString(descriptor.Address)). AppendLine(); break; case NetworkServiceTypes.Administrative: sb.AppendFormat("Address for administrative configuration service: {0}", StringHandlers.CToString(descriptor.Address)).AppendLine(); break; default: sb.AppendFormat("Address of unknown type {1}: {0}", StringHandlers.CToString(descriptor.Address), (byte)descriptor.Type).AppendLine(); break; } } return sb.ToString(); } #endregion EVPD Page 0x85: Management Network Addresses page #region EVPD Page 0x86: Extended INQUIRY data page /// Device identification page Page code 0x86 public struct Page_86 { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public byte PageLength; /// Indicates how a device server activates microcode public byte ActivateMicrocode; /// Protection types supported by device public byte SPT; /// Checks logical block guard field public bool GRD_CHK; /// Checks logical block application tag public bool APP_CHK; /// Checks logical block reference public bool REF_CHK; /// Supports unit attention condition sense key specific data public bool UASK_SUP; /// Supports grouping public bool GROUP_SUP; /// Supports priority public bool PRIOR_SUP; /// Supports head of queue public bool HEADSUP; /// Supports ordered public bool ORDSUP; /// Supports simple public bool SIMPSUP; /// Supports marking a block as uncorrectable public bool WU_SUP; /// Supports disabling correction on WRITE LONG public bool CRD_SUP; /// Supports a non-volatile cache public bool NV_SUP; /// Supports a volatile cache public bool V_SUP; /// Disable protection information checks public bool NO_PI_CHK; /// Protection information interval supported public bool P_I_I_SUP; /// Clears all LUNs unit attention when clearing one public bool LUICLR; /// Referrals support public bool R_SUP; /// History snapshots release effects public bool HSSRELEF; /// Capability based command security public bool CBCS; /// Indicates how it handles microcode updating with multiple nexuxes public byte Nexus; /// Time to complete extended self-test public ushort ExtendedTestMinutes; /// Power on activation support public bool POA_SUP; /// Hard reset actication public bool HRA_SUP; /// Vendor specific activation public bool VSA_SUP; /// Maximum length in bytes of sense data public byte MaximumSenseLength; } public static Page_86? DecodePage_86(byte[] pageResponse) { if(pageResponse?[1] != 0x86) return null; if(pageResponse[3] + 4 != pageResponse.Length) return null; if(pageResponse.Length < 64) return null; return new Page_86 { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (byte)(pageResponse[3] + 4), ActivateMicrocode = (byte)((pageResponse[4] & 0xC0) >> 6), SPT = (byte)((pageResponse[4] & 0x38) >> 3), GRD_CHK = (pageResponse[4] & 0x04) == 0x04, APP_CHK = (pageResponse[4] & 0x02) == 0x02, REF_CHK = (pageResponse[4] & 0x01) == 0x01, UASK_SUP = (pageResponse[5] & 0x20) == 0x20, GROUP_SUP = (pageResponse[5] & 0x10) == 0x10, PRIOR_SUP = (pageResponse[5] & 0x08) == 0x08, HEADSUP = (pageResponse[5] & 0x04) == 0x04, ORDSUP = (pageResponse[5] & 0x02) == 0x02, SIMPSUP = (pageResponse[5] & 0x01) == 0x01, WU_SUP = (pageResponse[6] & 0x08) == 0x08, CRD_SUP = (pageResponse[6] & 0x04) == 0x04, NV_SUP = (pageResponse[6] & 0x02) == 0x02, V_SUP = (pageResponse[6] & 0x01) == 0x01, NO_PI_CHK = (pageResponse[7] & 0x20) == 0x20, P_I_I_SUP = (pageResponse[7] & 0x10) == 0x10, LUICLR = (pageResponse[7] & 0x01) == 0x01, R_SUP = (pageResponse[8] & 0x10) == 0x10, HSSRELEF = (pageResponse[8] & 0x02) == 0x02, CBCS = (pageResponse[8] & 0x01) == 0x01, Nexus = (byte)(pageResponse[9] & 0x0F), ExtendedTestMinutes = (ushort)((pageResponse[10] << 8) + pageResponse[11]), POA_SUP = (pageResponse[12] & 0x80) == 0x80, HRA_SUP = (pageResponse[12] & 0x40) == 0x40, VSA_SUP = (pageResponse[12] & 0x20) == 0x20, MaximumSenseLength = pageResponse[13] }; } public static string PrettifyPage_86(byte[] pageResponse) => PrettifyPage_86(DecodePage_86(pageResponse)); public static string PrettifyPage_86(Page_86? modePage) { if(!modePage.HasValue) return null; Page_86 page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("SCSI Extended INQUIRY Data:"); switch(page.PeripheralDeviceType) { case PeripheralDeviceTypes.DirectAccess: case PeripheralDeviceTypes.SCSIZonedBlockDevice: switch(page.SPT) { case 0: sb.AppendLine("Logical unit supports type 1 protection"); break; case 1: sb.AppendLine("Logical unit supports types 1 and 2 protection"); break; case 2: sb.AppendLine("Logical unit supports type 2 protection"); break; case 3: sb.AppendLine("Logical unit supports types 1 and 3 protection"); break; case 4: sb.AppendLine("Logical unit supports type 3 protection"); break; case 5: sb.AppendLine("Logical unit supports types 2 and 3 protection"); break; case 7: sb.AppendLine("Logical unit supports types 1, 2 and 3 protection"); break; default: sb.AppendFormat("Logical unit supports unknown protection defined by code {0}", page.SPT). AppendLine(); break; } break; case PeripheralDeviceTypes.SequentialAccess when page.SPT == 1: sb.AppendLine("Logical unit supports logical block protection"); break; } if(page.GRD_CHK) sb.AppendLine("Device checks the logical block guard"); if(page.APP_CHK) sb.AppendLine("Device checks the logical block application tag"); if(page.REF_CHK) sb.AppendLine("Device checks the logical block reference tag"); if(page.UASK_SUP) sb.AppendLine("Device supports unit attention condition sense key specific data"); if(page.GROUP_SUP) sb.AppendLine("Device supports grouping"); if(page.PRIOR_SUP) sb.AppendLine("Device supports priority"); if(page.HEADSUP) sb.AppendLine("Device supports head of queue"); if(page.ORDSUP) sb.AppendLine("Device supports the ORDERED task attribute"); if(page.SIMPSUP) sb.AppendLine("Device supports the SIMPLE task attribute"); if(page.WU_SUP) sb.AppendLine("Device supports marking a block as uncorrectable with WRITE LONG"); if(page.CRD_SUP) sb.AppendLine("Device supports disabling correction with WRITE LONG"); if(page.NV_SUP) sb.AppendLine("Device has a non-volatile cache"); if(page.V_SUP) sb.AppendLine("Device has a volatile cache"); if(page.NO_PI_CHK) sb.AppendLine("Device has disabled protection information checks"); if(page.P_I_I_SUP) sb.AppendLine("Device supports protection information intervals"); if(page.LUICLR) sb.AppendLine("Device clears any unit attention condition in all LUNs after reporting for any LUN"); if(page.R_SUP) sb.AppendLine("Device supports referrals"); if(page.HSSRELEF) sb.AppendLine("Devoce implements alternate reset handling"); if(page.CBCS) sb.AppendLine("Device supports capability-based command security"); if(page.POA_SUP) sb.AppendLine("Device supports power-on activation for new microcode"); if(page.HRA_SUP) sb.AppendLine("Device supports hard reset activation for new microcode"); if(page.VSA_SUP) sb.AppendLine("Device supports vendor specific activation for new microcode"); if(page.ExtendedTestMinutes > 0) sb.AppendFormat("Extended self-test takes {0} to complete", TimeSpan.FromMinutes(page.ExtendedTestMinutes)). AppendLine(); if(page.MaximumSenseLength > 0) sb.AppendFormat("Device supports a maximum of {0} bytes for sense data", page.MaximumSenseLength). AppendLine(); return sb.ToString(); } #endregion EVPD Page 0x86: Extended INQUIRY data page #region EVPD Page 0x89: ATA Information page /// ATA Information page Page code 0x89 public struct Page_89 { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public ushort PageLength; /// Contains the SAT vendor identification public byte[] VendorIdentification; /// Contains the SAT product identification public byte[] ProductIdentification; /// Contains the SAT revision level public byte[] ProductRevisionLevel; /// Contains the ATA device signature public byte[] Signature; /// Contains the command code used to identify the device public byte CommandCode; /// Contains the response to ATA IDENTIFY (PACKET) DEVICE public byte[] IdentifyData; } public static Page_89? DecodePage_89(byte[] pageResponse) { if(pageResponse?[1] != 0x89) return null; if((pageResponse[2] << 8) + pageResponse[3] + 4 != pageResponse.Length) return null; if(pageResponse.Length < 572) return null; var decoded = new Page_89 { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (ushort)((pageResponse[2] << 8) + pageResponse[3] + 4), VendorIdentification = new byte[8], ProductIdentification = new byte[16], ProductRevisionLevel = new byte[4], Signature = new byte[20], IdentifyData = new byte[512] }; Array.Copy(pageResponse, 8, decoded.VendorIdentification, 0, 8); Array.Copy(pageResponse, 16, decoded.ProductIdentification, 0, 16); Array.Copy(pageResponse, 32, decoded.ProductRevisionLevel, 0, 4); Array.Copy(pageResponse, 36, decoded.Signature, 0, 20); decoded.CommandCode = pageResponse[56]; Array.Copy(pageResponse, 60, decoded.IdentifyData, 0, 512); return decoded; } public static string PrettifyPage_89(byte[] pageResponse) => PrettifyPage_89(DecodePage_89(pageResponse)); // TODO: Decode ATA signature? public static string PrettifyPage_89(Page_89? modePage) { if(!modePage.HasValue) return null; Page_89 page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("SCSI to ATA Translation Layer Data:"); sb.AppendFormat("\tTranslation layer vendor: {0}", VendorString.Prettify(StringHandlers.CToString(page.VendorIdentification).Trim())).AppendLine(); sb.AppendFormat("\tTranslation layer name: {0}", StringHandlers.CToString(page.ProductIdentification).Trim()). AppendLine(); sb.AppendFormat("\tTranslation layer release level: {0}", StringHandlers.CToString(page.ProductRevisionLevel).Trim()).AppendLine(); switch(page.CommandCode) { case 0xEC: sb.AppendLine("\tDevice responded to ATA IDENTIFY DEVICE command."); break; case 0xA1: sb.AppendLine("\tDevice responded to ATA IDENTIFY PACKET DEVICE command."); break; default: sb.AppendFormat("\tDevice responded to ATA command {0:X2}h", page.CommandCode).AppendLine(); break; } switch(page.Signature[0]) { case 0x00: sb.AppendLine("\tDevice uses Parallel ATA."); break; case 0x34: sb.AppendLine("\tDevice uses Serial ATA."); break; default: sb.AppendFormat("\tDevice uses unknown transport with code {0}", page.Signature[0]).AppendLine(); break; } Identify.IdentifyDevice? id = Identify.Decode(page.IdentifyData); if(id != null) { sb.AppendLine("\tATA IDENTIFY information follows:"); sb.AppendFormat("{0}", ATA.Identify.Prettify(id)).AppendLine(); } else sb.AppendLine("\tCould not decode ATA IDENTIFY information"); return sb.ToString(); } #endregion EVPD Page 0x89: ATA Information page #region EVPD Page 0xC0 (Quantum): Firmware Build Information page /// Firmware Build Information page Page code 0xC0 (Quantum) public struct Page_C0_Quantum { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public byte PageLength; /// Servo firmware checksum public ushort ServoFirmwareChecksum; /// Servo EEPROM checksum public ushort ServoEEPROMChecksum; /// Read/Write firmware checksum public uint ReadWriteFirmwareChecksum; /// Read/Write firmware build data public byte[] ReadWriteFirmwareBuildData; } public static Page_C0_Quantum? DecodePage_C0_Quantum(byte[] pageResponse) { if(pageResponse?[1] != 0xC0) return null; if(pageResponse[3] != 20) return null; if(pageResponse.Length != 36) return null; var decoded = new Page_C0_Quantum { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (byte)(pageResponse[3] + 4), ServoFirmwareChecksum = (ushort)((pageResponse[4] << 8) + pageResponse[5]), ServoEEPROMChecksum = (ushort)((pageResponse[6] << 8) + pageResponse[7]), ReadWriteFirmwareChecksum = (uint)((pageResponse[8] << 24) + (pageResponse[9] << 16) + (pageResponse[10] << 8) + pageResponse[11]), ReadWriteFirmwareBuildData = new byte[24] }; Array.Copy(pageResponse, 12, decoded.ReadWriteFirmwareBuildData, 0, 24); return decoded; } public static string PrettifyPage_C0_Quantum(byte[] pageResponse) => PrettifyPage_C0_Quantum(DecodePage_C0_Quantum(pageResponse)); public static string PrettifyPage_C0_Quantum(Page_C0_Quantum? modePage) { if(!modePage.HasValue) return null; Page_C0_Quantum page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("Quantum Firmware Build Information page:"); sb.AppendFormat("\tServo firmware checksum: 0x{0:X4}", page.ServoFirmwareChecksum).AppendLine(); sb.AppendFormat("\tEEPROM firmware checksum: 0x{0:X4}", page.ServoEEPROMChecksum).AppendLine(); sb.AppendFormat("\tRead/write firmware checksum: 0x{0:X8}", page.ReadWriteFirmwareChecksum).AppendLine(); sb.AppendFormat("\tRead/write firmware build date: {0}", StringHandlers.CToString(page.ReadWriteFirmwareBuildData)).AppendLine(); return sb.ToString(); } #endregion EVPD Page 0xC0 (Quantum): Firmware Build Information page #region EVPD Pages 0xC0, 0xC1 (Certance): Drive component revision level pages /// Drive component revision level pages Page codes 0xC0, 0xC1 (Certance) public struct Page_C0_C1_Certance { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public byte PageLength; public byte[] Component; public byte[] Version; public byte[] Date; public byte[] Variant; } public static Page_C0_C1_Certance? DecodePage_C0_C1_Certance(byte[] pageResponse) { if(pageResponse == null) return null; if(pageResponse[1] != 0xC0 && pageResponse[1] != 0xC1) return null; if(pageResponse[3] != 92) return null; if(pageResponse.Length != 96) return null; var decoded = new Page_C0_C1_Certance { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (byte)(pageResponse[3] + 4), Component = new byte[26], Version = new byte[19], Date = new byte[24], Variant = new byte[23] }; Array.Copy(pageResponse, 4, decoded.Component, 0, 26); Array.Copy(pageResponse, 30, decoded.Version, 0, 19); Array.Copy(pageResponse, 49, decoded.Date, 0, 24); Array.Copy(pageResponse, 73, decoded.Variant, 0, 23); return decoded; } public static string PrettifyPage_C0_C1_Certance(byte[] pageResponse) => PrettifyPage_C0_C1_Certance(DecodePage_C0_C1_Certance(pageResponse)); public static string PrettifyPage_C0_C1_Certance(Page_C0_C1_Certance? modePage) { if(!modePage.HasValue) return null; Page_C0_C1_Certance page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("Certance Drive Component Revision Levels page:"); sb.AppendFormat("\tComponent: {0}", StringHandlers.CToString(page.Component)).AppendLine(); sb.AppendFormat("\tVersion: {0}", StringHandlers.CToString(page.Version)).AppendLine(); sb.AppendFormat("\tDate: {0}", StringHandlers.CToString(page.Date)).AppendLine(); sb.AppendFormat("\tVariant: {0}", StringHandlers.CToString(page.Variant)).AppendLine(); return sb.ToString(); } #endregion EVPD Pages 0xC0, 0xC1 (Certance): Drive component revision level pages #region EVPD Pages 0xC2, 0xC3, 0xC4, 0xC5, 0xC6 (Certance): Drive component serial number pages /// Drive component serial number pages Page codes 0xC2, 0xC3, 0xC4, 0xC5, 0xC6 (Certance) public struct Page_C2_C3_C4_C5_C6_Certance { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public byte PageLength; public byte[] SerialNumber; } public static Page_C2_C3_C4_C5_C6_Certance? DecodePage_C2_C3_C4_C5_C6_Certance(byte[] pageResponse) { if(pageResponse == null) return null; if(pageResponse[1] != 0xC2 && pageResponse[1] != 0xC3 && pageResponse[1] != 0xC4 && pageResponse[1] != 0xC5 && pageResponse[1] != 0xC6) return null; if(pageResponse[3] != 12) return null; if(pageResponse.Length != 16) return null; var decoded = new Page_C2_C3_C4_C5_C6_Certance { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (byte)(pageResponse[3] + 4), SerialNumber = new byte[12] }; Array.Copy(pageResponse, 4, decoded.SerialNumber, 0, 12); return decoded; } public static string PrettifyPage_C2_C3_C4_C5_C6_Certance(byte[] pageResponse) => PrettifyPage_C2_C3_C4_C5_C6_Certance(DecodePage_C2_C3_C4_C5_C6_Certance(pageResponse)); public static string PrettifyPage_C2_C3_C4_C5_C6_Certance(Page_C2_C3_C4_C5_C6_Certance? modePage) { if(!modePage.HasValue) return null; Page_C2_C3_C4_C5_C6_Certance page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("Certance Drive Component Serial Number page:"); switch(page.PageCode) { case 0xC2: sb.AppendFormat("\tHead Assembly Serial Number: {0}", StringHandlers.CToString(page.SerialNumber)). AppendLine(); break; case 0xC3: sb.AppendFormat("\tReel Motor 1 Serial Number: {0}", StringHandlers.CToString(page.SerialNumber)). AppendLine(); break; case 0xC4: sb.AppendFormat("\tReel Motor 2 Serial Number: {0}", StringHandlers.CToString(page.SerialNumber)). AppendLine(); break; case 0xC5: sb.AppendFormat("\tBoard Serial Number: {0}", StringHandlers.CToString(page.SerialNumber)).AppendLine(); break; case 0xC6: sb.AppendFormat("\tBase Mechanical Serial Number: {0}", StringHandlers.CToString(page.SerialNumber)). AppendLine(); break; } return sb.ToString(); } #endregion EVPD Pages 0xC0, 0xC1 (Certance): Drive component revision level pages #region EVPD Page 0xDF (Certance): Drive status pages /// Drive status pages Page codes 0xDF (Certance) public struct Page_DF_Certance { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public byte PageLength; /// Command forwarding public byte CmdFwd; /// Alerts public bool Alerts; /// Removable prevention public bool NoRemov; /// Unit reservation public bool UnitRsvd; /// Needs cleaning public bool Clean; /// Tape threaded public bool Threaded; /// Commands await forwarding public bool Lun1Cmd; /// Autoload mode public byte AutoloadMode; /// Cartridge type public byte CartridgeType; /// Cartridge format public byte CartridgeFormat; /// Cartridge capacity in 10e9 bytes public ushort CartridgeCapacity; /// Port A transport type public byte PortATransportType; /// Port A SCSI ID public byte PortASelectionID; /// Total number of head-tape contact time public uint OperatingHours; /// ID that reserved the device public ulong InitiatorID; /// Cartridge serial number public byte[] CartridgeSerialNumber; } public static Page_DF_Certance? DecodePage_DF_Certance(byte[] pageResponse) { if(pageResponse?[1] != 0xDF) return null; if(pageResponse[3] != 60) return null; if(pageResponse.Length != 64) return null; var decoded = new Page_DF_Certance { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (byte)(pageResponse[3] + 4), CmdFwd = (byte)((pageResponse[5] & 0xC0) >> 5), Alerts = (pageResponse[5] & 0x20) == 0x20, NoRemov = (pageResponse[5] & 0x08) == 0x08, UnitRsvd = (pageResponse[5] & 0x04) == 0x04, Clean = (pageResponse[5] & 0x01) == 0x01, Threaded = (pageResponse[6] & 0x10) == 0x10, Lun1Cmd = (pageResponse[6] & 0x08) == 0x08, AutoloadMode = (byte)(pageResponse[6] & 0x07), CartridgeType = pageResponse[8], CartridgeFormat = pageResponse[9], CartridgeCapacity = (ushort)((pageResponse[10] << 8) + pageResponse[11] + 4), PortATransportType = pageResponse[12], PortASelectionID = pageResponse[15], OperatingHours = (uint)((pageResponse[20] << 24) + (pageResponse[21] << 16) + (pageResponse[22] << 8) + pageResponse[23]), CartridgeSerialNumber = new byte[32] }; var buf = new byte[8]; Array.Copy(pageResponse, 24, buf, 0, 8); decoded.InitiatorID = BitConverter.ToUInt64(buf.Reverse().ToArray(), 0); Array.Copy(pageResponse, 32, decoded.CartridgeSerialNumber, 0, 32); return decoded; } public static string PrettifyPage_DF_Certance(byte[] pageResponse) => PrettifyPage_DF_Certance(DecodePage_DF_Certance(pageResponse)); public static string PrettifyPage_DF_Certance(Page_DF_Certance? modePage) { if(!modePage.HasValue) return null; Page_DF_Certance page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("Certance drive status page:"); switch(page.CmdFwd) { case 0: sb.AppendLine("\tCommand forwarding is disabled"); break; case 1: sb.AppendLine("\tCommand forwarding is enabled"); break; default: sb.AppendFormat("\tUnknown command forwarding code {0}", page.CmdFwd).AppendLine(); break; } if(page.Alerts) sb.AppendLine("\tAlerts are enabled"); if(page.NoRemov) sb.AppendLine("\tCartridge removable is prevented"); if(page.UnitRsvd) sb.AppendFormat("\tUnit is reserved by initiator ID {0:X16}", page.InitiatorID).AppendLine(); if(page.Clean) sb.AppendLine("\tDevice needs cleaning cartridge"); if(page.Threaded) sb.AppendLine("\tCartridge tape is threaded"); if(page.Lun1Cmd) sb.AppendLine("\tThere are commands pending to be forwarded"); switch(page.AutoloadMode) { case 0: sb.AppendLine("\tCartridge will be loaded and threaded on insertion"); break; case 1: sb.AppendLine("\tCartridge will be loaded but not threaded on insertion"); break; case 2: sb.AppendLine("\tCartridge will not be loaded"); break; default: sb.AppendFormat("\tUnknown autoloading mode code {0}", page.AutoloadMode).AppendLine(); break; } switch(page.PortATransportType) { case 0: sb.AppendLine("\tPort A link is down"); break; case 3: sb.AppendLine("\tPort A uses Parallel SCSI Ultra-160 interface"); break; default: sb.AppendFormat("\tUnknown port A transport type code {0}", page.PortATransportType).AppendLine(); break; } if(page.PortATransportType > 0) sb.AppendFormat("\tDrive responds to SCSI ID {0}", page.PortASelectionID).AppendLine(); sb.AppendFormat("\tDrive has been operating {0}", TimeSpan.FromHours(page.OperatingHours)).AppendLine(); if(page.CartridgeType > 0) { switch(page.CartridgeFormat) { case 0: sb.AppendLine("\tInserted cartridge is LTO"); break; default: sb.AppendFormat("\tUnknown cartridge format code {0}", page.CartridgeType).AppendLine(); break; } switch(page.CartridgeType) { case 0: sb.AppendLine("\tThere is no cartridge inserted"); break; case 1: sb.AppendLine("\tCleaning cartridge inserted"); break; case 2: sb.AppendLine("\tUnknown data cartridge inserted"); break; case 3: sb.AppendLine("\tFirmware cartridge inserted"); break; case 4: sb.AppendLine("\tLTO Ultrium 1 Type A cartridge inserted"); break; case 5: sb.AppendLine("\tLTO Ultrium 1 Type B cartridge inserted"); break; case 6: sb.AppendLine("\tLTO Ultrium 1 Type C cartridge inserted"); break; case 7: sb.AppendLine("\tLTO Ultrium 1 Type D cartridge inserted"); break; case 8: sb.AppendLine("\tLTO Ultrium 2 cartridge inserted"); break; default: sb.AppendFormat("\tUnknown cartridge type code {0}", page.CartridgeType).AppendLine(); break; } sb.AppendFormat("\tCartridge has an uncompressed capabity of {0} gigabytes", page.CartridgeCapacity). AppendLine(); sb.AppendFormat("\tCartridge serial number: {0}", StringHandlers.SpacePaddedToString(page.CartridgeSerialNumber)).AppendLine(); } else sb.AppendLine("\tThere is no cartridge inserted"); return sb.ToString(); } #endregion EVPD Page 0xDF (Certance): Drive status pages #region EVPD Page 0xC0 (IBM): Drive Component Revision Levels page /// Drive Component Revision Levels page Page code 0xC0 (IBM) public struct Page_C0_IBM { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public byte PageLength; public byte[] CodeName; public byte[] Date; } public static Page_C0_IBM? DecodePage_C0_IBM(byte[] pageResponse) { if(pageResponse?[1] != 0xC0) return null; if(pageResponse[3] != 39) return null; if(pageResponse.Length != 43) return null; var decoded = new Page_C0_IBM { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (byte)(pageResponse[3] + 4), CodeName = new byte[12], Date = new byte[8] }; Array.Copy(pageResponse, 4, decoded.CodeName, 0, 12); Array.Copy(pageResponse, 23, decoded.Date, 0, 8); return decoded; } public static string PrettifyPage_C0_IBM(byte[] pageResponse) => PrettifyPage_C0_IBM(DecodePage_C0_IBM(pageResponse)); public static string PrettifyPage_C0_IBM(Page_C0_IBM? modePage) { if(!modePage.HasValue) return null; Page_C0_IBM page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("IBM Drive Component Revision Levels page:"); sb.AppendFormat("\tCode name: {0}", StringHandlers.CToString(page.CodeName)).AppendLine(); sb.AppendFormat("\tDate: {0}", StringHandlers.CToString(page.Date)).AppendLine(); return sb.ToString(); } #endregion EVPD Page 0xC0 (IBM): Drive Component Revision Levels page #region EVPD Page 0xC1 (IBM): Drive Serial Numbers page /// Drive Serial Numbers page Page code 0xC1 (IBM) public struct Page_C1_IBM { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public byte PageLength; public byte[] ManufacturingSerial; public byte[] ReportedSerial; } public static Page_C1_IBM? DecodePage_C1_IBM(byte[] pageResponse) { if(pageResponse?[1] != 0xC1) return null; if(pageResponse[3] != 24) return null; if(pageResponse.Length != 28) return null; var decoded = new Page_C1_IBM { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (byte)(pageResponse[3] + 4), ManufacturingSerial = new byte[12], ReportedSerial = new byte[12] }; Array.Copy(pageResponse, 4, decoded.ManufacturingSerial, 0, 12); Array.Copy(pageResponse, 16, decoded.ReportedSerial, 0, 12); return decoded; } public static string PrettifyPage_C1_IBM(byte[] pageResponse) => PrettifyPage_C1_IBM(DecodePage_C1_IBM(pageResponse)); public static string PrettifyPage_C1_IBM(Page_C1_IBM? modePage) { if(!modePage.HasValue) return null; Page_C1_IBM page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("IBM Drive Serial Numbers page:"); sb.AppendFormat("\tManufacturing serial number: {0}", StringHandlers.CToString(page.ManufacturingSerial)). AppendLine(); sb.AppendFormat("\tReported serial number: {0}", StringHandlers.CToString(page.ReportedSerial)).AppendLine(); return sb.ToString(); } #endregion EVPD Page 0xC1 (IBM): Drive Serial Numbers page #region EVPD Page 0xB0: Sequential-access device capabilities page /// Sequential-access device capabilities page Page code 0xB0 public struct Page_B0 { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public ushort PageLength; public bool TSMC; public bool WORM; } public static Page_B0? DecodePage_B0(byte[] pageResponse) { if(pageResponse?[1] != 0xB0) return null; if((pageResponse[2] << 8) + pageResponse[3] + 4 != pageResponse.Length) return null; if(pageResponse.Length < 5) return null; var decoded = new Page_B0 { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (ushort)((pageResponse[2] << 8) + pageResponse[3] + 4), TSMC = (pageResponse[4] & 0x02) == 0x02, WORM = (pageResponse[4] & 0x01) == 0x01 }; return decoded; } public static string PrettifyPage_B0(byte[] pageResponse) => PrettifyPage_B0(DecodePage_B0(pageResponse)); public static string PrettifyPage_B0(Page_B0? modePage) { if(!modePage.HasValue) return null; Page_B0 page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("SCSI Sequential-access Device Capabilities:"); if(page.WORM) sb.AppendLine("\tDevice supports WORM media"); if(page.TSMC) sb.AppendLine("\tDevice supports Tape Stream Mirroring"); return sb.ToString(); } #endregion EVPD Page 0xB0: Sequential-access device capabilities page #region EVPD Pages 0xC0 to 0xC5 (HP): Drive component revision level pages /// Drive component revision level pages Page codes 0xC0 to 0xC5 (HP) public struct Page_C0_to_C5_HP { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public byte PageLength; public byte[] Component; public byte[] Version; public byte[] Date; public byte[] Variant; public byte[] Copyright; } public static Page_C0_to_C5_HP? DecodePage_C0_to_C5_HP(byte[] pageResponse) { if(pageResponse == null) return null; if(pageResponse[1] != 0xC0 && pageResponse[1] != 0xC1 && pageResponse[1] != 0xC2 && pageResponse[1] != 0xC3 && pageResponse[1] != 0xC4 && pageResponse[1] != 0xC5) return null; if(pageResponse.Length < 4) return null; var decoded = new Page_C0_to_C5_HP { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (byte)(pageResponse[3] + 4), PageCode = pageResponse[1] }; if(pageResponse[3] == 92 && pageResponse.Length >= 96) { decoded.Component = new byte[26]; decoded.Version = new byte[19]; decoded.Date = new byte[24]; decoded.Variant = new byte[23]; Array.Copy(pageResponse, 4, decoded.Component, 0, 26); Array.Copy(pageResponse, 30, decoded.Version, 0, 19); Array.Copy(pageResponse, 49, decoded.Date, 0, 24); Array.Copy(pageResponse, 73, decoded.Variant, 0, 23); return decoded; } if(pageResponse[4] != pageResponse[3] - 1) return null; var array = new List(); const string fwRegExStr = @"Firmware Rev\s+=\s+(?\d+\.\d+)\s+Build date\s+=\s+(?(\w|\d|\s*.)*)\s*$"; const string fwcRegExStr = @"FW_CONF\s+=\s+(?0x[0-9A-Fa-f]{8})\s*$"; const string servoRegExStr = @"Servo\s+Rev\s+=\s+(?\d+\.\d+)\s*$"; var fwRegEx = new Regex(fwRegExStr); var fwcRegEx = new Regex(fwcRegExStr); var servoRegEx = new Regex(servoRegExStr); for(var pos = 5; pos < pageResponse.Length; pos++) if(pageResponse[pos] == 0x00) { string str = StringHandlers.CToString(array.ToArray()); Match fwMatch = fwRegEx.Match(str); Match fwcMatch = fwcRegEx.Match(str); Match servoMatch = servoRegEx.Match(str); if(str.ToLowerInvariant().StartsWith("copyright", StringComparison.Ordinal)) decoded.Copyright = Encoding.ASCII.GetBytes(str); else if(fwMatch.Success) { decoded.Component = Encoding.ASCII.GetBytes("Firmware"); decoded.Version = Encoding.ASCII.GetBytes(fwMatch.Groups["fw"].Value); decoded.Date = Encoding.ASCII.GetBytes(fwMatch.Groups["date"].Value); } else if(fwcMatch.Success) decoded.Variant = Encoding.ASCII.GetBytes(fwMatch.Groups["value"].Value); else if(servoMatch.Success) { decoded.Component = Encoding.ASCII.GetBytes("Servo"); decoded.Version = Encoding.ASCII.GetBytes(servoMatch.Groups["version"].Value); } array = new List(); } else array.Add(pageResponse[pos]); return decoded; } public static string PrettifyPage_C0_to_C5_HP(byte[] pageResponse) => PrettifyPage_C0_to_C5_HP(DecodePage_C0_to_C5_HP(pageResponse)); public static string PrettifyPage_C0_to_C5_HP(Page_C0_to_C5_HP? modePage) { if(!modePage.HasValue) return null; Page_C0_to_C5_HP page = modePage.Value; var sb = new StringBuilder(); switch(page.PageCode) { case 0xC0: sb.AppendLine("HP Drive Firmware Revision Levels page:"); break; case 0xC1: sb.AppendLine("HP Drive Hardware Revision Levels page:"); break; case 0xC2: sb.AppendLine("HP Drive PCA Revision Levels page:"); break; case 0xC3: sb.AppendLine("HP Drive Mechanism Revision Levels page:"); break; case 0xC4: sb.AppendLine("HP Drive Head Assembly Revision Levels page:"); break; case 0xC5: sb.AppendLine("HP Drive ACI Revision Levels page:"); break; } if(page.Component != null && page.Component.Length > 0) sb.AppendFormat("\tComponent: {0}", StringHandlers.CToString(page.Component)).AppendLine(); if(page.Version != null && page.Version.Length > 0) sb.AppendFormat("\tVersion: {0}", StringHandlers.CToString(page.Version)).AppendLine(); if(page.Date != null && page.Date.Length > 0) sb.AppendFormat("\tDate: {0}", StringHandlers.CToString(page.Date)).AppendLine(); if(page.Variant != null && page.Variant.Length > 0) sb.AppendFormat("\tVariant: {0}", StringHandlers.CToString(page.Variant)).AppendLine(); if(page.Copyright != null && page.Copyright.Length > 0) sb.AppendFormat("\tCopyright: {0}", StringHandlers.CToString(page.Copyright)).AppendLine(); return sb.ToString(); } #endregion EVPD Pages 0xC0 to 0xC5 (HP): Drive component revision level pages #region EVPD Page 0xC0 (Seagate): Firmware numbers page /// Firmware numbers page Page code 0xC0 (Seagate) public struct Page_C0_Seagate { /// The peripheral qualifier. public PeripheralQualifiers PeripheralQualifier; /// The type of the peripheral device. public PeripheralDeviceTypes PeripheralDeviceType; /// The page code. public byte PageCode; /// The length of the page. public byte PageLength; public byte[] ControllerFirmware; public byte[] BootFirmware; public byte[] ServoFirmware; } public static Page_C0_Seagate? DecodePage_C0_Seagate(byte[] pageResponse) { if(pageResponse?[1] != 0xC0) return null; if(pageResponse[3] != 12) return null; if(pageResponse.Length != 16) return null; var decoded = new Page_C0_Seagate { PeripheralQualifier = (PeripheralQualifiers)((pageResponse[0] & 0xE0) >> 5), PeripheralDeviceType = (PeripheralDeviceTypes)(pageResponse[0] & 0x1F), PageLength = (byte)(pageResponse[3] + 4), PageCode = pageResponse[1], ControllerFirmware = new byte[4], BootFirmware = new byte[4], ServoFirmware = new byte[4] }; Array.Copy(pageResponse, 4, decoded.ControllerFirmware, 0, 4); Array.Copy(pageResponse, 8, decoded.BootFirmware, 0, 4); Array.Copy(pageResponse, 12, decoded.ServoFirmware, 0, 4); return decoded; } public static string PrettifyPage_C0_Seagate(byte[] pageResponse) => PrettifyPage_C0_Seagate(DecodePage_C0_Seagate(pageResponse)); public static string PrettifyPage_C0_Seagate(Page_C0_Seagate? modePage) { if(!modePage.HasValue) return null; Page_C0_Seagate page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("Seagate Firmware Numbers page:"); sb.AppendFormat("\tController firmware version: {0}", StringHandlers.CToString(page.ControllerFirmware)). AppendLine(); sb.AppendFormat("\tBoot firmware version: {0}", StringHandlers.CToString(page.BootFirmware)).AppendLine(); sb.AppendFormat("\tServo firmware version: {0}", StringHandlers.CToString(page.ServoFirmware)).AppendLine(); return sb.ToString(); } #endregion EVPD Page 0xC0 (Seagate): Firmware numbers page }