// /*************************************************************************** // Aaru Data Preservation Suite // ---------------------------------------------------------------------------- // // Filename : Cartridge.cs // Author(s) : Natalia Portillo // // Component : Device structures decoders. // // --[ Description ] ---------------------------------------------------------- // // Decodes Blu-ray cartridge structures. // // --[ 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-2023 Natalia Portillo // ****************************************************************************/ using System; using System.Diagnostics.CodeAnalysis; using System.Text; using Aaru.Console; using Aaru.Helpers; 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")] [SuppressMessage("ReSharper", "UnassignedField.Global")] public static class Cartridge { const string MODULE_NAME = "BD Cartridge Status decoder"; #region Nested type: CartridgeStatus #region Public structures public struct CartridgeStatus { /// Bytes 0 to 1 Always 6 public ushort DataLength; /// Byte 2 Reserved public byte Reserved1; /// Byte 3 Reserved public byte Reserved2; /// Byte 4, bit 7 Medium is inserted in a cartridge public bool Cartridge; /// Byte 4, bit 6 Medium taken out / put in a cartridge public bool OUT; /// Byte 4, bits 5 to 3 Reserved public byte Reserved3; /// Byte 4, bit 2 Cartridge sets write protection public bool CWP; /// Byte 4, bits 1 to 0 Reserved public byte Reserved4; /// Byte 5 Reserved public byte Reserved5; /// Byte 6 Reserved public byte Reserved6; /// Byte 7 Reserved public byte Reserved7; } #endregion Public structures #endregion #region Public methods public static CartridgeStatus? Decode(byte[] CSResponse) { if(CSResponse == null) return null; if(CSResponse.Length != 8) { AaruConsole.DebugWriteLine(MODULE_NAME, Localization.Found_incorrect_Blu_ray_Cartridge_Status_size_0_bytes, CSResponse.Length); return null; } var decoded = new CartridgeStatus { DataLength = BigEndianBitConverter.ToUInt16(CSResponse, 0), Reserved1 = CSResponse[2], Reserved2 = CSResponse[3], Cartridge = Convert.ToBoolean(CSResponse[4] & 0x80), OUT = Convert.ToBoolean(CSResponse[4] & 0x40), Reserved3 = (byte)((CSResponse[4] & 0x38) >> 3), CWP = Convert.ToBoolean(CSResponse[4] & 0x04), Reserved4 = (byte)(CSResponse[4] & 0x03), Reserved5 = CSResponse[5], Reserved6 = CSResponse[6], Reserved7 = CSResponse[7] }; return decoded; } public static string Prettify(CartridgeStatus? CSResponse) { if(CSResponse == null) return null; CartridgeStatus response = CSResponse.Value; var sb = new StringBuilder(); #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.Reserved3_equals_0_X8, response.Reserved3).AppendLine(); if(response.Reserved4 != 0) sb.AppendFormat(Localization.Reserved4_equals_0_X8, 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_X8, response.Reserved7).AppendLine(); #endif if(response.Cartridge) { sb.AppendLine(Localization.Media_is_inserted_in_a_cartridge); if(response.OUT) sb.AppendLine(Localization.Media_has_been_taken_out_or_inserted_in_the_cartridge); if(response.CWP) sb.AppendLine(Localization.Media_is_write_protected); } else { sb.AppendLine(Localization.Media_is_not_in_a_cartridge); #if DEBUG if(response.OUT) sb.AppendLine(Localization.Media_has_out_bit_marked_shouldnt); if(response.CWP) sb.AppendLine(Localization.Media_has_write_protection_bit_marked_shouldnt); #endif } return sb.ToString(); } public static string Prettify(byte[] CSResponse) => Prettify(Decode(CSResponse)); #endregion Public methods }