// /*************************************************************************** // Aaru Data Preservation Suite // ---------------------------------------------------------------------------- // // Filename : 1A.cs // Author(s) : Natalia Portillo // // Component : Device structures decoders. // // --[ Description ] ---------------------------------------------------------- // // Decodes SCSI MODE PAGE 1Ah: Power condition page. // // --[ 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.Diagnostics.CodeAnalysis; using System.Text; namespace Aaru.Decoders.SCSI; [SuppressMessage("ReSharper", "InconsistentNaming")] [SuppressMessage("ReSharper", "MemberCanBeInternal")] [SuppressMessage("ReSharper", "MemberCanBePrivate.Global")] public static partial class Modes { #region Mode Page 0x1A: Power condition page /// Power condition page Page code 0x1A 12 bytes in SPC-1, SPC-2, SPC-3, SPC-4 40 bytes in SPC-5 public struct ModePage_1A { /// Parameters can be saved public bool PS; /// Idle timer activated public bool Idle; /// Standby timer activated public bool Standby; /// Idle timer public uint IdleTimer; /// Standby timer public uint StandbyTimer; /// Interactions between background functions and power management public byte PM_BG_Precedence; /// Standby timer Y activated public bool Standby_Y; /// Idle timer B activated public bool Idle_B; /// Idle timer C activated public bool Idle_C; /// Idle timer B public uint IdleTimer_B; /// Idle timer C public uint IdleTimer_C; /// Standby timer Y public uint StandbyTimer_Y; public byte CCF_Idle; public byte CCF_Standby; public byte CCF_Stopped; } public static ModePage_1A? DecodeModePage_1A(byte[] pageResponse) { if((pageResponse?[0] & 0x40) == 0x40) return null; if((pageResponse?[0] & 0x3F) != 0x1A) return null; if(pageResponse[1] + 2 != pageResponse.Length) return null; if(pageResponse.Length < 12) return null; var decoded = new ModePage_1A(); decoded.PS |= (pageResponse[0] & 0x80) == 0x80; decoded.Standby |= (pageResponse[3] & 0x01) == 0x01; decoded.Idle |= (pageResponse[3] & 0x02) == 0x02; decoded.IdleTimer = (uint)((pageResponse[4] << 24) + (pageResponse[5] << 16) + (pageResponse[6] << 8) + pageResponse[7]); decoded.StandbyTimer = (uint)((pageResponse[8] << 24) + (pageResponse[9] << 16) + (pageResponse[10] << 8) + pageResponse[11]); if(pageResponse.Length < 40) return decoded; decoded.PM_BG_Precedence = (byte)((pageResponse[2] & 0xC0) >> 6); decoded.Standby_Y |= (pageResponse[2] & 0x01) == 0x01; decoded.Idle_B |= (pageResponse[3] & 0x04) == 0x04; decoded.Idle_C |= (pageResponse[3] & 0x08) == 0x08; decoded.IdleTimer_B = (uint)((pageResponse[12] << 24) + (pageResponse[13] << 16) + (pageResponse[14] << 8) + pageResponse[15]); decoded.IdleTimer_C = (uint)((pageResponse[16] << 24) + (pageResponse[17] << 16) + (pageResponse[18] << 8) + pageResponse[19]); decoded.StandbyTimer_Y = (uint)((pageResponse[20] << 24) + (pageResponse[21] << 16) + (pageResponse[22] << 8) + pageResponse[23]); decoded.CCF_Idle = (byte)((pageResponse[39] & 0xC0) >> 6); decoded.CCF_Standby = (byte)((pageResponse[39] & 0x30) >> 4); decoded.CCF_Stopped = (byte)((pageResponse[39] & 0x0C) >> 2); return decoded; } public static string PrettifyModePage_1A(byte[] pageResponse) => PrettifyModePage_1A(DecodeModePage_1A(pageResponse)); public static string PrettifyModePage_1A(ModePage_1A? modePage) { if(!modePage.HasValue) return null; ModePage_1A page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine("SCSI Power condition page:"); if(page.PS) sb.AppendLine("\t" + Localization.Parameters_can_be_saved); if(page is { Standby: true, StandbyTimer: > 0 } or { Standby_Y: true, StandbyTimer_Y: > 0 }) { if(page is { Standby: true, StandbyTimer: > 0 }) sb.AppendFormat("\t" + "Standby timer Z is set to {0} ms", page.StandbyTimer * 100).AppendLine(); if(page is { Standby_Y: true, StandbyTimer_Y: > 0 }) sb.AppendFormat("\t" + "Standby timer Y is set to {0} ms", page.StandbyTimer_Y * 100).AppendLine(); } else sb.AppendLine("\t" + "Drive will not enter standby mode"); if(page is { Idle: true, IdleTimer: > 0 } or { Idle_B: true, IdleTimer_B: > 0 } or { Idle_C: true, IdleTimer_C: > 0 }) { if(page is { Idle: true, IdleTimer: > 0 }) sb.AppendFormat("\t" + "Idle timer A is set to {0} ms", page.IdleTimer * 100).AppendLine(); if(page is { Idle_B: true, IdleTimer_B: > 0 }) sb.AppendFormat("\t" + "Idle timer B is set to {0} ms", page.IdleTimer_B * 100).AppendLine(); if(page is { Idle_C: true, IdleTimer_C: > 0 }) sb.AppendFormat("\t" + "Idle timer C is set to {0} ms", page.IdleTimer_C * 100).AppendLine(); } else sb.AppendLine("\t" + "Drive will not enter idle mode"); switch(page.PM_BG_Precedence) { case 0: break; case 1: sb.AppendLine("\t" + "Performing background functions take precedence over maintaining low power conditions"); break; case 2: sb.AppendLine("\t" + "Maintaining low power conditions take precedence over performing background functions"); break; } return sb.ToString(); } #endregion Mode Page 0x1A: Power condition page #region Mode Page 0x1A subpage 0x01: Power Consumption mode page /// Power Consumption mode page Page code 0x1A Subpage code 0x01 16 bytes in SPC-5 public struct ModePage_1A_S01 { /// Parameters can be saved public bool PS; /// Active power level public byte ActiveLevel; /// Power Consumption VPD identifier in use public byte PowerConsumptionIdentifier; } public static ModePage_1A_S01? DecodeModePage_1A_S01(byte[] pageResponse) { if((pageResponse?[0] & 0x40) != 0x40) return null; if((pageResponse[0] & 0x3F) != 0x1A) return null; if(pageResponse[1] != 0x01) return null; if((pageResponse[2] << 8) + pageResponse[3] + 4 != pageResponse.Length) return null; if(pageResponse.Length < 16) return null; var decoded = new ModePage_1A_S01(); decoded.PS |= (pageResponse[0] & 0x80) == 0x80; decoded.ActiveLevel = (byte)(pageResponse[6] & 0x03); decoded.PowerConsumptionIdentifier = pageResponse[7]; return decoded; } public static string PrettifyModePage_1A_S01(byte[] pageResponse) => PrettifyModePage_1A_S01(DecodeModePage_1A_S01(pageResponse)); public static string PrettifyModePage_1A_S01(ModePage_1A_S01? modePage) { if(!modePage.HasValue) return null; ModePage_1A_S01 page = modePage.Value; var sb = new StringBuilder(); sb.AppendLine(Localization.SCSI_Power_Consumption_page); if(page.PS) sb.AppendLine("\t" + Localization.Parameters_can_be_saved); switch(page.ActiveLevel) { case 0: sb. AppendFormat("\t" + Localization.Device_power_consumption_is_dictated_by_identifier_0_of_Power_Consumption_VPD, page.PowerConsumptionIdentifier). AppendLine(); break; case 1: sb.AppendLine("\t" + Localization.Device_is_in_highest_relative_power_consumption_level); break; case 2: sb.AppendLine("\t" + Localization.Device_is_in_intermediate_relative_power_consumption_level); break; case 3: sb.AppendLine("\t" + Localization.Device_is_in_lowest_relative_power_consumption_level); break; } return sb.ToString(); } #endregion Mode Page 0x1A subpage 0x01: Power Consumption mode page }