// /*************************************************************************** // Aaru Data Preservation Suite // ---------------------------------------------------------------------------- // // Filename : DDS.cs // Author(s) : Natalia Portillo // // Component : Device structures decoders. // // --[ Description ] ---------------------------------------------------------- // // Decodes Blu-ray Disc Definition Structure. // // --[ 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-2025 Natalia Portillo // ****************************************************************************/ using System; using System.Diagnostics.CodeAnalysis; using System.Text; using Aaru.Helpers; using Aaru.Logging; using Spectre.Console; namespace Aaru.Decoders.Bluray; /// Information from the following standards: /// ANSI X3.304-1997 /// T10/1048-D revision 9.0 /// T10/1048-D revision 10a /// T10/1228-D revision 7.0c /// T10/1228-D revision 11a /// T10/1363-D revision 10g /// T10/1545-D revision 1d /// T10/1545-D revision 5 /// T10/1545-D revision 5a /// T10/1675-D revision 2c /// T10/1675-D revision 4 /// T10/1836-D revision 2g [SuppressMessage("ReSharper", "InconsistentNaming")] [SuppressMessage("ReSharper", "MemberCanBeInternal")] [SuppressMessage("ReSharper", "MemberCanBePrivate.Global")] [SuppressMessage("ReSharper", "NotAccessedField.Global")] public static class DDS { #region Nested type: DiscDefinitionStructure #region Public structures public struct DiscDefinitionStructure { /// Bytes 0 to 1 Data Length public ushort DataLength; /// Byte 2 Reserved public byte Reserved1; /// Byte 3 Reserved public byte Reserved2; /// Bytes 4 to 5 "DS" public ushort Signature; /// Byte 6 DDS format public byte Format; /// Byte 7 Reserved public byte Reserved3; /// Bytes 8 to 11 DDS update count public uint UpdateCount; /// Bytes 12 to 19 Reserved public ulong Reserved4; /// Bytes 20 to 23 First PSN of Drive Area public uint DriveAreaPSN; /// Bytes 24 to 27 Reserved public uint Reserved5; /// Bytes 28 to 31 First PSN of Defect List public uint DefectListPSN; /// Bytes 32 to 35 Reserved public uint Reserved6; /// Bytes 36 to 39 PSN of LSN 0 of user data area public uint PSNofLSNZero; /// Bytes 40 to 43 Last LSN of user data area public uint LastUserAreaLSN; /// Bytes 44 to 47 ISA0 size public uint ISA0; /// Bytes 48 to 51 OSA size public uint OSA; /// Bytes 52 to 55 ISA1 size public uint ISA1; /// Byte 56 Spare Area full flags public byte SpareAreaFullFlags; /// Byte 57 Reserved public byte Reserved7; /// Byte 58 Disc type specific field public byte DiscTypeSpecificField1; /// Byte 59 Reserved public byte Reserved8; /// Byte 60 to 63 Disc type specific field public uint DiscTypeSpecificField2; /// Byte 64 to 67 Reserved public uint Reserved9; /// Bytes 68 to 99 Status bits of INFO1/2 and PAC1/2 on L0 and L1 public byte[] StatusBits; /// Bytes 100 to end Disc type specific data public byte[] DiscTypeSpecificData; } #endregion Public structures #endregion #region Private constants /// Disc Definition Structure Identifier "DS" const ushort DDSIdentifier = 0x4453; const string MODULE_NAME = "BD DDS decoder"; #endregion Private constants #region Public methods public static DiscDefinitionStructure? Decode(byte[] DDSResponse) { if(DDSResponse == null) return null; var decoded = new DiscDefinitionStructure { DataLength = BigEndianBitConverter.ToUInt16(DDSResponse, 0), Reserved1 = DDSResponse[2], Reserved2 = DDSResponse[3], Signature = BigEndianBitConverter.ToUInt16(DDSResponse, 4) }; if(decoded.Signature != DDSIdentifier) { AaruLogging.Debug(MODULE_NAME, Localization.Found_incorrect_DDS_signature_0, decoded.Signature); return null; } decoded.Format = DDSResponse[6]; decoded.Reserved3 = DDSResponse[7]; decoded.UpdateCount = BigEndianBitConverter.ToUInt32(DDSResponse, 8); decoded.Reserved4 = BigEndianBitConverter.ToUInt64(DDSResponse, 12); decoded.DriveAreaPSN = BigEndianBitConverter.ToUInt32(DDSResponse, 20); decoded.Reserved5 = BigEndianBitConverter.ToUInt32(DDSResponse, 24); decoded.DefectListPSN = BigEndianBitConverter.ToUInt32(DDSResponse, 28); decoded.Reserved6 = BigEndianBitConverter.ToUInt32(DDSResponse, 32); decoded.PSNofLSNZero = BigEndianBitConverter.ToUInt32(DDSResponse, 36); decoded.LastUserAreaLSN = BigEndianBitConverter.ToUInt32(DDSResponse, 40); decoded.ISA0 = BigEndianBitConverter.ToUInt32(DDSResponse, 44); decoded.OSA = BigEndianBitConverter.ToUInt32(DDSResponse, 48); decoded.ISA1 = BigEndianBitConverter.ToUInt32(DDSResponse, 52); decoded.SpareAreaFullFlags = DDSResponse[56]; decoded.Reserved7 = DDSResponse[57]; decoded.DiscTypeSpecificField1 = DDSResponse[58]; decoded.Reserved8 = DDSResponse[59]; decoded.DiscTypeSpecificField2 = BigEndianBitConverter.ToUInt32(DDSResponse, 60); decoded.Reserved9 = BigEndianBitConverter.ToUInt32(DDSResponse, 64); decoded.StatusBits = new byte[32]; Array.Copy(DDSResponse, 68, decoded.StatusBits, 0, 32); decoded.DiscTypeSpecificData = new byte[DDSResponse.Length - 100]; Array.Copy(DDSResponse, 100, decoded.DiscTypeSpecificData, 0, DDSResponse.Length - 100); return decoded; } public static string Prettify(DiscDefinitionStructure? DDSResponse) { if(DDSResponse == null) return null; DiscDefinitionStructure response = DDSResponse.Value; var sb = new StringBuilder(); sb.AppendFormat(Localization.DDS_Format_0, response.Format).AppendLine(); sb.AppendFormat(Localization.DDS_has_been_updated_0_times, response.UpdateCount).AppendLine(); sb.AppendFormat(Localization.First_PSN_of_Drive_Area_0, response.DriveAreaPSN).AppendLine(); sb.AppendFormat(Localization.First_PSN_of_Defect_List_0, response.DefectListPSN).AppendLine(); sb.AppendFormat(Localization.PSN_of_User_Data_Areas_LSN_0_0, response.PSNofLSNZero).AppendLine(); sb.AppendFormat(Localization.Last_User_Data_Areas_LSN_0_0, response.LastUserAreaLSN).AppendLine(); sb.AppendFormat(Localization.ISA0_size_0, response.ISA0).AppendLine(); sb.AppendFormat(Localization.OSA_size_0, response.OSA).AppendLine(); sb.AppendFormat(Localization.ISA1_size_0, response.ISA1).AppendLine(); sb.AppendFormat(Localization.Spare_Area_Full_Flags_0, response.SpareAreaFullFlags).AppendLine(); sb.AppendFormat(Localization.Disc_Type_Specific_Field_1_0, response.DiscTypeSpecificField1).AppendLine(); sb.AppendFormat(Localization.Disc_Type_Specific_Field_2_0, response.DiscTypeSpecificField2).AppendLine(); sb.AppendLine(Localization.Blu_ray_DDS_Status_Bits_in_hex_follows); sb.AppendLine(Markup.Escape(PrintHex.ByteArrayToHexArrayString(response.StatusBits, color: true))); sb.AppendLine(Localization.Blu_ray_DDS_Disc_Type_Specific_Data_in_hex_follows); sb.AppendLine(Markup.Escape(PrintHex.ByteArrayToHexArrayString(response.DiscTypeSpecificData, color: true))); #if DEBUG if(response.Reserved1 != 0) sb.AppendFormat(Localization.Reserved1_equals_0_X8, response.Reserved1).AppendLine(); if(response.Reserved2 != 0) sb.AppendFormat(Localization.Reserved2_equals_0_X8, response.Reserved2).AppendLine(); if(response.Reserved3 != 0) sb.AppendFormat(Localization.Reserved_3_equals_0_X2, response.Reserved3).AppendLine(); if(response.Reserved4 != 0) sb.AppendFormat(Localization.Reserved4_equals_0_X16, response.Reserved4).AppendLine(); if(response.Reserved5 != 0) sb.AppendFormat(Localization.Reserved5_equals_0_X8, response.Reserved5).AppendLine(); if(response.Reserved6 != 0) sb.AppendFormat(Localization.Reserved6_equals_0_X8, response.Reserved6).AppendLine(); if(response.Reserved7 != 0) sb.AppendFormat(Localization.Reserved7_equals_0_X2, response.Reserved7).AppendLine(); if(response.Reserved8 != 0) sb.AppendFormat(Localization.Reserved8_equals_0_X2, response.Reserved8).AppendLine(); if(response.Reserved9 != 0) sb.AppendFormat(Localization.Reserved9_equals_0_X8, response.Reserved9).AppendLine(); #endif return sb.ToString(); } public static string Prettify(byte[] DDSResponse) => Prettify(Decode(DDSResponse)); #endregion Public methods }