// /*************************************************************************** // Aaru Data Preservation Suite // ---------------------------------------------------------------------------- // // Filename : CIS.cs // Author(s) : Natalia Portillo // // 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 . // // ---------------------------------------------------------------------------- // 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 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 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 buffer = new(); List 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(); firstString = true; continue; } // TODO: Check this if(!secondString) { tuple.Product = StringHandlers.CToString(buffer.ToArray()); buffer = new List(); firstString = true; continue; } if(strings == null) strings = new List(); strings.Add(StringHandlers.CToString(buffer.ToArray())); buffer = new List(); } 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)); }