mirror of
https://github.com/aaru-dps/Aaru.git
synced 2025-12-16 19:24:25 +00:00
282 lines
11 KiB
C#
282 lines
11 KiB
C#
// /***************************************************************************
|
|
// Aaru Data Preservation Suite
|
|
// ----------------------------------------------------------------------------
|
|
//
|
|
// Filename : 1A.cs
|
|
// Author(s) : Natalia Portillo <claunia@claunia.com>
|
|
//
|
|
// 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 <http://www.gnu.org/licenses/>.
|
|
//
|
|
// ----------------------------------------------------------------------------
|
|
// Copyright © 2011-2025 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
|
|
|
|
/// <summary>Power condition page Page code 0x1A 12 bytes in SPC-1, SPC-2, SPC-3, SPC-4 40 bytes in SPC-5</summary>
|
|
public struct ModePage_1A
|
|
{
|
|
/// <summary>Parameters can be saved</summary>
|
|
public bool PS;
|
|
/// <summary>Idle timer activated</summary>
|
|
public bool Idle;
|
|
/// <summary>Standby timer activated</summary>
|
|
public bool Standby;
|
|
/// <summary>Idle timer</summary>
|
|
public uint IdleTimer;
|
|
/// <summary>Standby timer</summary>
|
|
public uint StandbyTimer;
|
|
|
|
/// <summary>Interactions between background functions and power management</summary>
|
|
public byte PM_BG_Precedence;
|
|
/// <summary>Standby timer Y activated</summary>
|
|
public bool Standby_Y;
|
|
/// <summary>Idle timer B activated</summary>
|
|
public bool Idle_B;
|
|
/// <summary>Idle timer C activated</summary>
|
|
public bool Idle_C;
|
|
/// <summary>Idle timer B</summary>
|
|
public uint IdleTimer_B;
|
|
/// <summary>Idle timer C</summary>
|
|
public uint IdleTimer_C;
|
|
/// <summary>Standby timer Y</summary>
|
|
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($"[bold][blue]{Localization.SCSI_Power_condition_page}[/][/]");
|
|
|
|
if(page.PS) sb.AppendLine($"\t[green]{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[slateblue1]{Localization.Standby_timer_Z_is_set_to_0_ms}[/]",
|
|
$"[teal]{page.StandbyTimer * 100}[/]")
|
|
.AppendLine();
|
|
|
|
if(page is { Standby_Y: true, StandbyTimer_Y: > 0 })
|
|
sb.AppendFormat($"\t[slateblue1]{Localization.Standby_timer_Y_is_set_to_0_ms}[/]",
|
|
$"[teal]{page.StandbyTimer_Y * 100}[/]")
|
|
.AppendLine();
|
|
}
|
|
else
|
|
sb.AppendLine($"\t[red]{Localization.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[slateblue1]{Localization.Idle_timer_A_is_set_to_0_ms}[/]",
|
|
$"[teal]{page.IdleTimer * 100}[/]")
|
|
.AppendLine();
|
|
|
|
if(page is { Idle_B: true, IdleTimer_B: > 0 })
|
|
sb.AppendFormat($"\t[slateblue1]{Localization.Idle_timer_B_is_set_to_0_ms}[/]",
|
|
$"[teal]{page.IdleTimer_B * 100}[/]")
|
|
.AppendLine();
|
|
|
|
if(page is { Idle_C: true, IdleTimer_C: > 0 })
|
|
sb.AppendFormat($"\t[slateblue1]{Localization.Idle_timer_C_is_set_to_0_ms}[/]",
|
|
$"[teal]{page.IdleTimer_C * 100}[/]")
|
|
.AppendLine();
|
|
}
|
|
else
|
|
sb.AppendLine($"\t[red]{Localization.Drive_will_not_enter_idle_mode}[/]");
|
|
|
|
switch(page.PM_BG_Precedence)
|
|
{
|
|
case 0:
|
|
break;
|
|
case 1:
|
|
sb.AppendLine($"\t[olive]{
|
|
Localization.Background_take_precedence_over_low_power_conditions}[/]");
|
|
|
|
break;
|
|
case 2:
|
|
sb.AppendLine($"\t[green]{
|
|
Localization.Low_power_take_precedence_over_background}[/]");
|
|
|
|
break;
|
|
}
|
|
|
|
return sb.ToString();
|
|
}
|
|
|
|
#endregion Mode Page 0x1A: Power condition page
|
|
|
|
#region Mode Page 0x1A subpage 0x01: Power Consumption mode page
|
|
|
|
/// <summary>Power Consumption mode page Page code 0x1A Subpage code 0x01 16 bytes in SPC-5</summary>
|
|
public struct ModePage_1A_S01
|
|
{
|
|
/// <summary>Parameters can be saved</summary>
|
|
public bool PS;
|
|
/// <summary>Active power level</summary>
|
|
public byte ActiveLevel;
|
|
/// <summary>Power Consumption VPD identifier in use</summary>
|
|
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
|
|
} |