// /*************************************************************************** // The Disc Image Chef // ---------------------------------------------------------------------------- // // Filename : Apple2MG.cs // Author(s) : Natalia Portillo // // Component : Disk image plugins. // // --[ Description ] ---------------------------------------------------------- // // Manages XGS emulator disk images. // // --[ 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-2018 Natalia Portillo // ****************************************************************************/ using System; using System.Collections.Generic; using System.Diagnostics.CodeAnalysis; using System.IO; using System.Text; using DiscImageChef.CommonTypes; using DiscImageChef.Console; using DiscImageChef.Filters; namespace DiscImageChef.DiscImages { public class Apple2Mg : IMediaImage { /// /// Magic number, "2IMG" /// const uint MAGIC = 0x474D4932; /// /// Disk image created by ASIMOV2, "!nfc" /// const uint CREATOR_ASIMOV = 0x63666E21; /// /// Disk image created by Bernie ][ the Rescue, "B2TR" /// const uint CREATOR_BERNIE = 0x52543242; /// /// Disk image created by Catakig, "CTKG" /// const uint CREATOR_CATAKIG = 0x474B5443; /// /// Disk image created by Sheppy's ImageMaker, "ShIm" /// const uint CREATOR_SHEPPY = 0x6D496853; /// /// Disk image created by Sweet16, "WOOF" /// const uint CREATOR_SWEET = 0x464F4F57; /// /// Disk image created by XGS, "XGS!" /// const uint CREATOR_XGS = 0x21534758; /// /// Disk image created by CiderPress, "CdrP" /// const uint CREATOR_CIDER = 0x50726443; const uint DOS_SECTOR_ORDER = 0x00000000; const uint PRODOS_SECTOR_ORDER = 0x00000001; const uint NIB_SECTOR_ORDER = 0x00000002; const uint LOCKED_DISK = 0x80000000; const uint VALID_VOLUME_NUMBER = 0x00000100; const uint VOLUME_NUMBER_MASK = 0x000000FF; IFilter a2MgImageFilter; A2ImgHeader imageHeader; ImageInfo imageInfo; public Apple2Mg() { imageInfo = new ImageInfo { ReadableSectorTags = new List(), ReadableMediaTags = new List(), HasPartitions = false, HasSessions = false, Version = null, Application = null, ApplicationVersion = null, Creator = null, Comments = null, MediaManufacturer = null, MediaModel = null, MediaSerialNumber = null, MediaBarcode = null, MediaPartNumber = null, MediaSequence = 0, LastMediaSequence = 0, DriveManufacturer = null, DriveModel = null, DriveSerialNumber = null, DriveFirmwareRevision = null }; } public ImageInfo Info => imageInfo; public string Name => "Apple 2IMG"; public Guid Id => new Guid("CBAF8824-BA5F-415F-953A-19A03519B2D1"); public string Format => "Apple 2IMG"; public List Partitions => throw new FeatureUnsupportedImageException("Feature not supported by image format"); public List Tracks => throw new FeatureUnsupportedImageException("Feature not supported by image format"); public List Sessions => throw new FeatureUnsupportedImageException("Feature not supported by image format"); public bool Identify(IFilter imageFilter) { Stream stream = imageFilter.GetDataForkStream(); stream.Seek(0, SeekOrigin.Begin); if(stream.Length < 65) return false; byte[] header = new byte[64]; stream.Read(header, 0, 64); uint magic = BitConverter.ToUInt32(header, 0x00); if(magic != MAGIC) return false; uint dataoff = BitConverter.ToUInt32(header, 0x18); if(dataoff > stream.Length) return false; uint datasize = BitConverter.ToUInt32(header, 0x1C); // There seems to be incorrect endian in some images on the wild if(datasize == 0x00800C00) datasize = 0x000C8000; if(dataoff + datasize > stream.Length) return false; uint commentoff = BitConverter.ToUInt32(header, 0x20); if(commentoff > stream.Length) return false; uint commentsize = BitConverter.ToUInt32(header, 0x24); if(commentoff + commentsize > stream.Length) return false; uint creatoroff = BitConverter.ToUInt32(header, 0x28); if(creatoroff > stream.Length) return false; uint creatorsize = BitConverter.ToUInt32(header, 0x2C); return creatoroff + creatorsize <= stream.Length; } public bool Open(IFilter imageFilter) { Stream stream = imageFilter.GetDataForkStream(); stream.Seek(0, SeekOrigin.Begin); imageHeader = new A2ImgHeader(); byte[] header = new byte[64]; stream.Read(header, 0, 64); byte[] magic = new byte[4]; byte[] creator = new byte[4]; Array.Copy(header, 0, magic, 0, 4); Array.Copy(header, 4, creator, 0, 4); imageHeader.Magic = BitConverter.ToUInt32(header, 0x00); imageHeader.Creator = BitConverter.ToUInt32(header, 0x04); imageHeader.HeaderSize = BitConverter.ToUInt16(header, 0x08); imageHeader.Version = BitConverter.ToUInt16(header, 0x0A); imageHeader.ImageFormat = BitConverter.ToUInt32(header, 0x0C); imageHeader.Flags = BitConverter.ToUInt32(header, 0x10); imageHeader.Blocks = BitConverter.ToUInt32(header, 0x14); imageHeader.DataOffset = BitConverter.ToUInt32(header, 0x18); imageHeader.DataSize = BitConverter.ToUInt32(header, 0x1C); imageHeader.CommentOffset = BitConverter.ToUInt32(header, 0x20); imageHeader.CommentSize = BitConverter.ToUInt32(header, 0x24); imageHeader.CreatorSpecificOffset = BitConverter.ToUInt32(header, 0x28); imageHeader.CreatorSpecificSize = BitConverter.ToUInt32(header, 0x2C); imageHeader.Reserved1 = BitConverter.ToUInt32(header, 0x30); imageHeader.Reserved2 = BitConverter.ToUInt32(header, 0x34); imageHeader.Reserved3 = BitConverter.ToUInt32(header, 0x38); imageHeader.Reserved4 = BitConverter.ToUInt32(header, 0x3C); if(imageHeader.DataSize == 0x00800C00) { imageHeader.DataSize = 0x000C8000; DicConsole.DebugWriteLine("2MG plugin", "Detected incorrect endian on data size field, correcting."); } DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.magic = \"{0}\"", Encoding.ASCII.GetString(magic)); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.creator = \"{0}\"", Encoding.ASCII.GetString(creator)); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.headerSize = {0}", imageHeader.HeaderSize); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.version = {0}", imageHeader.Version); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.imageFormat = {0}", imageHeader.ImageFormat); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.flags = 0x{0:X8}", imageHeader.Flags); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.blocks = {0}", imageHeader.Blocks); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.dataOffset = 0x{0:X8}", imageHeader.DataOffset); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.dataSize = {0}", imageHeader.DataSize); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.commentOffset = 0x{0:X8}", imageHeader.CommentOffset); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.commentSize = {0}", imageHeader.CommentSize); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.creatorSpecificOffset = 0x{0:X8}", imageHeader.CreatorSpecificOffset); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.creatorSpecificSize = {0}", imageHeader.CreatorSpecificSize); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.reserved1 = 0x{0:X8}", imageHeader.Reserved1); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.reserved2 = 0x{0:X8}", imageHeader.Reserved2); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.reserved3 = 0x{0:X8}", imageHeader.Reserved3); DicConsole.DebugWriteLine("2MG plugin", "ImageHeader.reserved4 = 0x{0:X8}", imageHeader.Reserved4); if(imageHeader.DataSize == 0 && imageHeader.Blocks == 0 && imageHeader.ImageFormat != PRODOS_SECTOR_ORDER) return false; switch(imageHeader.ImageFormat) { case PRODOS_SECTOR_ORDER when imageHeader.Blocks == 0: return false; case PRODOS_SECTOR_ORDER: imageHeader.DataSize = imageHeader.Blocks * 512; break; default: if(imageHeader.Blocks == 0 && imageHeader.DataSize != 0) imageHeader.Blocks = imageHeader.DataSize / 256; else if(imageHeader.DataSize == 0 && imageHeader.Blocks != 0) imageHeader.DataSize = imageHeader.Blocks * 256; break; } imageInfo.SectorSize = (uint)(imageHeader.ImageFormat == PRODOS_SECTOR_ORDER ? 512 : 256); imageInfo.Sectors = imageHeader.Blocks; imageInfo.ImageSize = imageHeader.DataSize; switch(imageHeader.Creator) { case CREATOR_ASIMOV: imageInfo.Application = "ASIMOV2"; break; case CREATOR_BERNIE: imageInfo.Application = "Bernie ][ the Rescue"; break; case CREATOR_CATAKIG: imageInfo.Application = "Catakig"; break; case CREATOR_SHEPPY: imageInfo.Application = "Sheppy's ImageMaker"; break; case CREATOR_SWEET: imageInfo.Application = "Sweet16"; break; case CREATOR_XGS: imageInfo.Application = "XGS"; break; case CREATOR_CIDER: imageInfo.Application = "CiderPress"; break; default: imageInfo.Application = $"Unknown creator code \"{Encoding.ASCII.GetString(creator)}\""; break; } imageInfo.Version = imageHeader.Version.ToString(); if(imageHeader.CommentOffset != 0 && imageHeader.CommentSize != 0) { stream.Seek(imageHeader.CommentOffset, SeekOrigin.Begin); byte[] comments = new byte[imageHeader.CommentSize]; stream.Read(comments, 0, (int)imageHeader.CommentSize); imageInfo.Comments = Encoding.ASCII.GetString(comments); } imageInfo.CreationTime = imageFilter.GetCreationTime(); imageInfo.LastModificationTime = imageFilter.GetLastWriteTime(); imageInfo.MediaTitle = Path.GetFileNameWithoutExtension(imageFilter.GetFilename()); imageInfo.MediaType = GetMediaType(); a2MgImageFilter = imageFilter; imageInfo.XmlMediaType = XmlMediaType.BlockMedia; DicConsole.VerboseWriteLine("2MG image contains a disk of type {0}", imageInfo.MediaType); if(!string.IsNullOrEmpty(imageInfo.Comments)) DicConsole.VerboseWriteLine("2MG comments: {0}", imageInfo.Comments); switch(imageInfo.MediaType) { case MediaType.Apple32SS: imageInfo.Cylinders = 35; imageInfo.Heads = 1; imageInfo.SectorsPerTrack = 13; break; case MediaType.Apple32DS: imageInfo.Cylinders = 35; imageInfo.Heads = 2; imageInfo.SectorsPerTrack = 13; break; case MediaType.Apple33SS: imageInfo.Cylinders = 35; imageInfo.Heads = 1; imageInfo.SectorsPerTrack = 16; break; case MediaType.Apple33DS: imageInfo.Cylinders = 35; imageInfo.Heads = 2; imageInfo.SectorsPerTrack = 16; break; case MediaType.AppleSonySS: imageInfo.Cylinders = 80; imageInfo.Heads = 1; // Variable sectors per track, this suffices imageInfo.SectorsPerTrack = 10; break; case MediaType.AppleSonyDS: imageInfo.Cylinders = 80; imageInfo.Heads = 2; // Variable sectors per track, this suffices imageInfo.SectorsPerTrack = 10; break; } return true; } MediaType GetMediaType() { switch(imageInfo.Sectors) { case 455: return MediaType.Apple32SS; case 910: return MediaType.Apple32DS; case 560: return MediaType.Apple33SS; case 1120: return MediaType.Apple33DS; case 800: return MediaType.AppleSonySS; case 1600: return MediaType.AppleSonyDS; default: return MediaType.Unknown; } } public byte[] ReadSector(ulong sectorAddress) { return ReadSectors(sectorAddress, 1); } public byte[] ReadSectors(ulong sectorAddress, uint length) { if(sectorAddress > imageInfo.Sectors - 1) throw new ArgumentOutOfRangeException(nameof(sectorAddress), "Sector address not found"); if(sectorAddress + length > imageInfo.Sectors) throw new ArgumentOutOfRangeException(nameof(length), "Requested more sectors than available"); byte[] buffer = new byte[length * imageInfo.SectorSize]; Stream stream = a2MgImageFilter.GetDataForkStream(); stream.Seek((long)(imageHeader.DataOffset + sectorAddress * imageInfo.SectorSize), SeekOrigin.Begin); stream.Read(buffer, 0, (int)(length * imageInfo.SectorSize)); return buffer; } public byte[] ReadDiskTag(MediaTagType tag) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public byte[] ReadSectorTag(ulong sectorAddress, SectorTagType tag) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public byte[] ReadSector(ulong sectorAddress, uint track) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public byte[] ReadSectorTag(ulong sectorAddress, uint track, SectorTagType tag) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public byte[] ReadSectorsTag(ulong sectorAddress, uint length, SectorTagType tag) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public byte[] ReadSectors(ulong sectorAddress, uint length, uint track) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public byte[] ReadSectorsTag(ulong sectorAddress, uint length, uint track, SectorTagType tag) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public byte[] ReadSectorLong(ulong sectorAddress) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public byte[] ReadSectorLong(ulong sectorAddress, uint track) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public byte[] ReadSectorsLong(ulong sectorAddress, uint length) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public byte[] ReadSectorsLong(ulong sectorAddress, uint length, uint track) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public List GetSessionTracks(Session session) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public List GetSessionTracks(ushort session) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public bool? VerifySector(ulong sectorAddress) { return null; } public bool? VerifySector(ulong sectorAddress, uint track) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public bool? VerifySectors(ulong sectorAddress, uint length, out List failingLbas, out List unknownLbas) { failingLbas = new List(); unknownLbas = new List(); for(ulong i = 0; i < imageInfo.Sectors; i++) unknownLbas.Add(i); return null; } public bool? VerifySectors(ulong sectorAddress, uint length, uint track, out List failingLbas, out List unknownLbas) { throw new FeatureUnsupportedImageException("Feature not supported by image format"); } public bool? VerifyMediaImage() { return null; } [SuppressMessage("ReSharper", "NotAccessedField.Local")] struct A2ImgHeader { /// /// Offset 0x00, magic /// public uint Magic; /// /// Offset 0x04, disk image creator ID /// public uint Creator; /// /// Offset 0x08, header size, constant 0x0040 /// public ushort HeaderSize; /// /// Offset 0x0A, disk image version /// public ushort Version; /// /// Offset 0x0C, disk image format /// public uint ImageFormat; /// /// Offset 0x10, flags and volume number /// public uint Flags; /// /// Offset 0x14, blocks for ProDOS, 0 otherwise /// public uint Blocks; /// /// Offset 0x18, offset to data /// public uint DataOffset; /// /// Offset 0x1C, data size in bytes /// public uint DataSize; /// /// Offset 0x20, offset to optional comment /// public uint CommentOffset; /// /// Offset 0x24, length of optional comment /// public uint CommentSize; /// /// Offset 0x28, offset to creator specific chunk /// public uint CreatorSpecificOffset; /// /// Offset 0x2C, creator specific chunk size /// public uint CreatorSpecificSize; /// /// Offset 0x30, reserved, should be zero /// public uint Reserved1; /// /// Offset 0x34, reserved, should be zero /// public uint Reserved2; /// /// Offset 0x38, reserved, should be zero /// public uint Reserved3; /// /// Offset 0x3C, reserved, should be zero /// public uint Reserved4; } } }