mirror of
https://github.com/aaru-dps/Aaru.git
synced 2025-12-16 19:24:25 +00:00
Move all files into project subdirectory
This commit is contained in:
324
Aaru.Decoders/PCMCIA/CIS.cs
Normal file
324
Aaru.Decoders/PCMCIA/CIS.cs
Normal file
@@ -0,0 +1,324 @@
|
||||
// /***************************************************************************
|
||||
// Aaru Data Preservation Suite
|
||||
// ----------------------------------------------------------------------------
|
||||
//
|
||||
// Filename : CIS.cs
|
||||
// Author(s) : Natalia Portillo <claunia@claunia.com>
|
||||
//
|
||||
// Component : Device structures decoders.
|
||||
//
|
||||
// --[ Description ] ----------------------------------------------------------
|
||||
//
|
||||
// Decodes PCMCIA Card Information 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 <http://www.gnu.org/licenses/>.
|
||||
//
|
||||
// ----------------------------------------------------------------------------
|
||||
// Copyright © 2011-2023 Natalia Portillo
|
||||
// ****************************************************************************/
|
||||
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Diagnostics.CodeAnalysis;
|
||||
using System.Linq;
|
||||
using System.Text;
|
||||
using Aaru.Helpers;
|
||||
|
||||
namespace Aaru.Decoders.PCMCIA;
|
||||
|
||||
[SuppressMessage("ReSharper", "InconsistentNaming")]
|
||||
[SuppressMessage("ReSharper", "MemberCanBeInternal")]
|
||||
[SuppressMessage("ReSharper", "MemberCanBePrivate.Global")]
|
||||
[SuppressMessage("ReSharper", "UnusedMember.Global")]
|
||||
public static class CIS
|
||||
{
|
||||
// TODO: Handle links? Or are they removed in lower layers of the operating system drivers?
|
||||
public static Tuple[] GetTuples(byte[] data)
|
||||
{
|
||||
List<Tuple> tuples = new();
|
||||
var position = 0;
|
||||
|
||||
while(position < data.Length)
|
||||
{
|
||||
var tuple = new Tuple
|
||||
{
|
||||
Code = (TupleCodes)data[position]
|
||||
};
|
||||
|
||||
if(tuple.Code == TupleCodes.CISTPL_NULL)
|
||||
continue;
|
||||
|
||||
if(tuple.Code == TupleCodes.CISTPL_END)
|
||||
break;
|
||||
|
||||
tuple.Link = data[position + 1];
|
||||
|
||||
if(position + 2 + tuple.Link > data.Length)
|
||||
break;
|
||||
|
||||
tuple.Data = new byte[tuple.Link + 2];
|
||||
Array.Copy(data, position, tuple.Data, 0, tuple.Link + 2);
|
||||
|
||||
tuples.Add(tuple);
|
||||
position += tuple.Link + 2;
|
||||
}
|
||||
|
||||
return tuples.ToArray();
|
||||
}
|
||||
|
||||
public static DeviceGeometryTuple DecodeDeviceGeometryTuple(Tuple tuple)
|
||||
{
|
||||
if(tuple == null)
|
||||
return null;
|
||||
|
||||
if(tuple.Code != TupleCodes.CISTPL_DEVICEGEO && tuple.Code != TupleCodes.CISTPL_DEVICEGEO_A)
|
||||
return null;
|
||||
|
||||
return tuple.Data == null ? null : DecodeDeviceGeometryTuple(tuple.Data);
|
||||
}
|
||||
|
||||
public static DeviceGeometryTuple DecodeDeviceGeometryTuple(byte[] data)
|
||||
{
|
||||
if((data?.Length - 2) % 6 != 0)
|
||||
return null;
|
||||
|
||||
var tuple = new DeviceGeometryTuple();
|
||||
List<DeviceGeometry> geometries = new();
|
||||
|
||||
for(var position = 2; position < data.Length; position += 6)
|
||||
{
|
||||
var geometry = new DeviceGeometry
|
||||
{
|
||||
CardInterface = data[position],
|
||||
EraseBlockSize = data[position + 1],
|
||||
ReadBlockSize = data[position + 2],
|
||||
WriteBlockSize = data[position + 3],
|
||||
Partitions = data[position + 4],
|
||||
Interleaving = data[position + 5]
|
||||
};
|
||||
|
||||
geometries.Add(geometry);
|
||||
}
|
||||
|
||||
tuple.Code = (TupleCodes)data[0];
|
||||
tuple.Link = data[1];
|
||||
tuple.Geometries = geometries.ToArray();
|
||||
|
||||
return tuple;
|
||||
}
|
||||
|
||||
public static string PrettifyDeviceGeometryTuple(DeviceGeometryTuple tuple)
|
||||
{
|
||||
if(tuple == null)
|
||||
return null;
|
||||
|
||||
if(tuple.Code != TupleCodes.CISTPL_DEVICEGEO && tuple.Code != TupleCodes.CISTPL_DEVICEGEO_A)
|
||||
return null;
|
||||
|
||||
var sb = new StringBuilder();
|
||||
sb.AppendLine(Localization.PCMCIA_Device_Geometry_Tuples);
|
||||
|
||||
foreach(DeviceGeometry geometry in tuple.Geometries)
|
||||
{
|
||||
sb.AppendLine("\t" + Localization.Geometry);
|
||||
|
||||
sb.AppendFormat("\t\t" + Localization.Device_width_0_bits, (1 << geometry.CardInterface - 1) * 8).
|
||||
AppendLine();
|
||||
|
||||
sb.AppendFormat("\t\t" + Localization.Erase_block_0_bytes,
|
||||
(1 << geometry.EraseBlockSize - 1) * (1 << geometry.Interleaving - 1)).
|
||||
AppendLine();
|
||||
|
||||
sb.AppendFormat("\t\t" + Localization.Read_block_0_bytes,
|
||||
(1 << geometry.ReadBlockSize - 1) * (1 << geometry.Interleaving - 1)).
|
||||
AppendLine();
|
||||
|
||||
sb.AppendFormat("\t\t" + Localization.Write_block_0_bytes,
|
||||
(1 << geometry.WriteBlockSize - 1) * (1 << geometry.Interleaving - 1)).
|
||||
AppendLine();
|
||||
|
||||
sb.AppendFormat("\t\t" + Localization.Partition_alignment_0_bytes,
|
||||
(1 << geometry.EraseBlockSize - 1) *
|
||||
(1 << geometry.Interleaving - 1) *
|
||||
(1 << geometry.Partitions - 1)).
|
||||
AppendLine();
|
||||
}
|
||||
|
||||
return sb.ToString();
|
||||
}
|
||||
|
||||
public static string PrettifyDeviceGeometryTuple(Tuple tuple) =>
|
||||
PrettifyDeviceGeometryTuple(DecodeDeviceGeometryTuple(tuple));
|
||||
|
||||
public static string PrettifyDeviceGeometryTuple(byte[] data) =>
|
||||
PrettifyDeviceGeometryTuple(DecodeDeviceGeometryTuple(data));
|
||||
|
||||
public static ManufacturerIdentificationTuple DecodeManufacturerIdentificationTuple(Tuple tuple)
|
||||
{
|
||||
if(tuple?.Code != TupleCodes.CISTPL_MANFID)
|
||||
return null;
|
||||
|
||||
return tuple.Data == null ? null : DecodeManufacturerIdentificationTuple(tuple.Data);
|
||||
}
|
||||
|
||||
public static ManufacturerIdentificationTuple DecodeManufacturerIdentificationTuple(byte[] data)
|
||||
{
|
||||
if(data == null)
|
||||
return null;
|
||||
|
||||
if(data.Length < 6)
|
||||
return null;
|
||||
|
||||
return new ManufacturerIdentificationTuple
|
||||
{
|
||||
Code = (TupleCodes)data[0],
|
||||
Link = data[1],
|
||||
ManufacturerID = BitConverter.ToUInt16(data, 2),
|
||||
CardID = BitConverter.ToUInt16(data, 4)
|
||||
};
|
||||
}
|
||||
|
||||
public static string PrettifyManufacturerIdentificationTuple(ManufacturerIdentificationTuple tuple)
|
||||
{
|
||||
if(tuple?.Code != TupleCodes.CISTPL_MANFID)
|
||||
return null;
|
||||
|
||||
var sb = new StringBuilder();
|
||||
sb.AppendLine(Localization.Manufacturer_Identification_Tuple);
|
||||
sb.AppendFormat("\t" + Localization.Manufacturer_ID_0, VendorCode.Prettify(tuple.ManufacturerID)).AppendLine();
|
||||
sb.AppendFormat("\t" + Localization.Card_ID_0, tuple.CardID).AppendLine();
|
||||
|
||||
return sb.ToString();
|
||||
}
|
||||
|
||||
public static string PrettifyManufacturerIdentificationTuple(Tuple tuple) =>
|
||||
PrettifyManufacturerIdentificationTuple(DecodeManufacturerIdentificationTuple(tuple));
|
||||
|
||||
public static string PrettifyManufacturerIdentificationTuple(byte[] data) =>
|
||||
PrettifyManufacturerIdentificationTuple(DecodeManufacturerIdentificationTuple(data));
|
||||
|
||||
public static Level1VersionTuple DecodeLevel1VersionTuple(Tuple tuple)
|
||||
{
|
||||
if(tuple?.Code != TupleCodes.CISTPL_VERS_1)
|
||||
return null;
|
||||
|
||||
return tuple.Data == null ? null : DecodeLevel1VersionTuple(tuple.Data);
|
||||
}
|
||||
|
||||
public static Level1VersionTuple DecodeLevel1VersionTuple(byte[] data)
|
||||
{
|
||||
if(data == null)
|
||||
return null;
|
||||
|
||||
if(data.Length < 4)
|
||||
return null;
|
||||
|
||||
List<byte> buffer = new();
|
||||
List<string> strings = null;
|
||||
var firstString = false;
|
||||
const bool secondString = false;
|
||||
|
||||
var tuple = new Level1VersionTuple
|
||||
{
|
||||
Code = (TupleCodes)data[0],
|
||||
Link = data[1],
|
||||
MajorVersion = data[2],
|
||||
MinorVersion = data[3]
|
||||
};
|
||||
|
||||
for(var position = 4; position < data.Length; position++)
|
||||
{
|
||||
if(data[position] == 0xFF)
|
||||
break;
|
||||
|
||||
buffer.Add(data[position]);
|
||||
|
||||
if(data[position] != 0x00)
|
||||
continue;
|
||||
|
||||
if(!firstString)
|
||||
{
|
||||
tuple.Manufacturer = StringHandlers.CToString(buffer.ToArray());
|
||||
buffer = new List<byte>();
|
||||
firstString = true;
|
||||
|
||||
continue;
|
||||
}
|
||||
|
||||
// TODO: Check this
|
||||
if(!secondString)
|
||||
{
|
||||
tuple.Product = StringHandlers.CToString(buffer.ToArray());
|
||||
buffer = new List<byte>();
|
||||
firstString = true;
|
||||
|
||||
continue;
|
||||
}
|
||||
|
||||
if(strings == null)
|
||||
strings = new List<string>();
|
||||
|
||||
strings.Add(StringHandlers.CToString(buffer.ToArray()));
|
||||
buffer = new List<byte>();
|
||||
}
|
||||
|
||||
if(strings != null)
|
||||
tuple.AdditionalInformation = strings.ToArray();
|
||||
|
||||
return tuple;
|
||||
}
|
||||
|
||||
public static string PrettifyLevel1VersionTuple(Level1VersionTuple tuple)
|
||||
{
|
||||
if(tuple?.Code != TupleCodes.CISTPL_VERS_1)
|
||||
return null;
|
||||
|
||||
var sb = new StringBuilder();
|
||||
sb.AppendLine(Localization.PCMCIA_Level_1_Version_Product_Information_Tuple);
|
||||
|
||||
sb.AppendFormat("\t" + Localization.Card_indicates_compliance_with_PC_Card_Standard_Release_0_1,
|
||||
tuple.MajorVersion, tuple.MinorVersion).
|
||||
AppendLine();
|
||||
|
||||
if(string.IsNullOrEmpty(tuple.Manufacturer))
|
||||
sb.AppendLine("\t" + Localization.No_manufacturer_information_string);
|
||||
else
|
||||
sb.AppendFormat(Localization.Manufacturer_0, tuple.Manufacturer).AppendLine();
|
||||
|
||||
if(string.IsNullOrEmpty(tuple.Product))
|
||||
sb.AppendLine("\t" + Localization.No_product_name_string);
|
||||
else
|
||||
sb.AppendFormat(Localization.Product_name_0, tuple.Product).AppendLine();
|
||||
|
||||
if(tuple.AdditionalInformation == null || tuple.AdditionalInformation.Length == 0)
|
||||
sb.AppendLine("\t" + Localization.No_additional_information);
|
||||
else
|
||||
{
|
||||
sb.AppendLine("\t" + Localization.Additional_information);
|
||||
|
||||
foreach(string info in tuple.AdditionalInformation.Where(info => !string.IsNullOrEmpty(info)))
|
||||
sb.Append($"\t\t{info}").AppendLine();
|
||||
}
|
||||
|
||||
return sb.ToString();
|
||||
}
|
||||
|
||||
public static string PrettifyLevel1VersionTuple(Tuple tuple) =>
|
||||
PrettifyLevel1VersionTuple(DecodeLevel1VersionTuple(tuple));
|
||||
|
||||
public static string PrettifyLevel1VersionTuple(byte[] data) =>
|
||||
PrettifyLevel1VersionTuple(DecodeLevel1VersionTuple(data));
|
||||
}
|
||||
Reference in New Issue
Block a user