aaru-dps/Aaru
1
0
Fork 0
mirror of https://github.com/aaru-dps/Aaru.git synced 2025-12-16 19:24:25 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
devel
Aaru/Aaru.Decoders/SecureDigital/SCR.cs

250 lines
9.4 KiB
C#
Raw Permalink Blame History

// /***************************************************************************
// Aaru Data Preservation Suite
// ----------------------------------------------------------------------------
//
// Filename : SCR.cs
// Author(s) : Natalia Portillo <claunia@claunia.com>
//
// Component : Device structures decoders.
//
// --[ Description ] ----------------------------------------------------------
//
// Decodes SecureDigital SCR.
//
// --[ 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;
using System.Diagnostics.CodeAnalysis;
using System.Text;
namespace Aaru.Decoders.SecureDigital;
[SuppressMessage("ReSharper", "InconsistentNaming")]
[SuppressMessage("ReSharper", "MemberCanBeInternal")]
[SuppressMessage("ReSharper", "MemberCanBePrivate.Global")]
[SuppressMessage("ReSharper", "NotAccessedField.Global")]
public class SCR
{
public BusWidth BusWidth;
public CommandSupport CommandSupport;
public bool DataStatusAfterErase;
public byte ExtendedSecurity;
public byte[] ManufacturerReserved;
public byte Security;
public byte Spec;
public bool Spec3;
public bool Spec4;
public byte SpecX;
public byte Structure;
}
[Flags]
public enum BusWidth : byte
{
OneBit = 1 << 0,
FourBit = 1 << 2
}
[Flags]
public enum CommandSupport : byte
{
SpeedClassControl = 1 << 0,
SetBlockCount = 1 << 1,
ExtensionRegisterSingleBlock = 1 << 2,
ExtensionRegisterMultiBlock = 1 << 3
}
[SuppressMessage("ReSharper", "MemberCanBePrivate.Global")]
[SuppressMessage("ReSharper", "InconsistentNaming")]
[SuppressMessage("ReSharper", "UnusedMember.Global")]
public static partial class Decoders
{
public static SCR DecodeSCR(uint[] response)
{
if(response?.Length != 2) return null;
var data = new byte[8];
byte[] tmp = BitConverter.GetBytes(response[0]);
Array.Copy(tmp, 0, data, 0, 4);
tmp = BitConverter.GetBytes(response[1]);
Array.Copy(tmp, 0, data, 4, 4);
return DecodeSCR(data);
}
public static SCR DecodeSCR(byte[] response)
{
if(response?.Length != 8) return null;
var scr = new SCR
{
Structure = (byte)((response[0] & 0xF0) >> 4),
Spec = (byte)(response[0] & 0x0F),
DataStatusAfterErase = (response[1] & 0x80) == 0x80,
Security = (byte)((response[1] & 0x70) >> 4),
BusWidth = (BusWidth)(response[1] & 0x0F),
Spec3 = (response[2] & 0x80) == 0x80,
ExtendedSecurity = (byte)((response[2] & 0x78) >> 3),
Spec4 = (response[2] & 0x04) == 0x04,
SpecX = (byte)(((response[2] & 0x03) << 2) + ((response[3] & 0xC0) >> 6)),
CommandSupport = (CommandSupport)(response[3] & 0x0F),
ManufacturerReserved = new byte[4]
};
Array.Copy(response, 4, scr.ManufacturerReserved, 0, 4);
return scr;
}
public static string PrettifySCR(SCR scr)
{
if(scr == null) return null;
var sb = new StringBuilder();
sb.AppendLine(Localization.SecureDigital_Device_Configuration_Register);
if(scr.Structure != 0)
sb.AppendFormat("\t" + Localization.Unknown_register_version_0, scr.Structure).AppendLine();
switch(scr.Spec)
{
case 0 when !scr.Spec3 && !scr.Spec4 && scr.SpecX == 0:
sb.AppendLine("\t" +
Localization.Device_follows_SecureDigital_Physical_Layer_Specification_version_1_0x);
break;
case 1 when !scr.Spec3 && !scr.Spec4 && scr.SpecX == 0:
sb.AppendLine("\t" +
Localization.Device_follows_SecureDigital_Physical_Layer_Specification_version_1_10);
break;
case 2 when !scr.Spec3 && !scr.Spec4 && scr.SpecX == 0:
sb.AppendLine("\t" +
Localization.Device_follows_SecureDigital_Physical_Layer_Specification_version_2_00);
break;
case 2 when scr.Spec3 && !scr.Spec4 && scr.SpecX == 0:
sb.AppendLine("\t" +
Localization.Device_follows_SecureDigital_Physical_Layer_Specification_version_3_0x);
break;
case 2 when scr.Spec3 && scr.Spec4 && scr.SpecX == 0:
sb.AppendLine("\t" +
Localization.Device_follows_SecureDigital_Physical_Layer_Specification_version_4_xx);
break;
case 2 when scr.Spec3:
switch(scr.SpecX)
{
case 1:
sb.AppendLine("\t" +
Localization
.Device_follows_SecureDigital_Physical_Layer_Specification_version_5_xx);
break;
case 2:
sb.AppendLine("\t" +
Localization
.Device_follows_SecureDigital_Physical_Layer_Specification_version_6_xx);
break;
case 3:
sb.AppendLine("\t" +
Localization
.Device_follows_SecureDigital_Physical_Layer_Specification_version_7_xx);
break;
case 4:
sb.AppendLine("\t" +
Localization
.Device_follows_SecureDigital_Physical_Layer_Specification_version_8_xx);
break;
}
break;
default:
sb.AppendFormat("\t" +
Localization
.Device_follows_SecureDigital_Physical_Layer_Specification_with_unknown_version_0_1_2_3,
scr.Spec,
scr.Spec3,
scr.Spec4,
scr.SpecX)
.AppendLine();
break;
}
switch(scr.Security)
{
case 0:
sb.AppendLine("\t" + Localization.Device_does_not_support_CPRM);
break;
case 1:
sb.AppendLine("\t" + Localization.Device_does_not_use_CPRM);
break;
case 2:
sb.AppendLine("\t" + Localization.Device_uses_CPRM_according_to_specification_version_1_01);
break;
case 3:
sb.AppendLine("\t" + Localization.Device_uses_CPRM_according_to_specification_version_2_00);
break;
case 4:
sb.AppendLine("\t" + Localization.Device_uses_CPRM_according_to_specification_version_3_xx);
break;
default:
sb.AppendFormat("\t" + Localization.Device_uses_unknown_CPRM_specification_with_code_0, scr.Security)
.AppendLine();
break;
}
if(scr.BusWidth.HasFlag(BusWidth.OneBit)) sb.AppendLine("\t" + Localization.Device_supports_1_bit_data_bus);
if(scr.BusWidth.HasFlag(BusWidth.FourBit)) sb.AppendLine("\t" + Localization.Device_supports_4_bit_data_bus);
if(scr.ExtendedSecurity != 0) sb.AppendLine("\t" + Localization.Device_supports_extended_security);
if(scr.CommandSupport.HasFlag(CommandSupport.ExtensionRegisterMultiBlock))
sb.AppendLine("\t" + Localization.Device_supports_extension_register_multi_block_commands);
if(scr.CommandSupport.HasFlag(CommandSupport.ExtensionRegisterSingleBlock))
sb.AppendLine("\t" + Localization.Device_supports_extension_register_single_block_commands);
if(scr.CommandSupport.HasFlag(CommandSupport.SetBlockCount))
sb.AppendLine("\t" + Localization.Device_supports_set_block_count_command);
if(scr.CommandSupport.HasFlag(CommandSupport.SpeedClassControl))
sb.AppendLine("\t" + Localization.Device_supports_speed_class_control_command);
return sb.ToString();
}
public static string PrettifySCR(uint[] response) => PrettifySCR(DecodeSCR(response));
public static string PrettifySCR(byte[] response) => PrettifySCR(DecodeSCR(response));
}
Reference in New Issue View Git Blame Copy Permalink