Class SkewedTrackSectorDevice

java.lang.Object

org.applecommander.device.SkewedTrackSectorDevice

All Implemented Interfaces:

CapabilityProvider, Device, TrackSectorDevice, HintProvider, Container, InformationProvider

public class SkewedTrackSectorDevice
extends Object
implements TrackSectorDevice

This is an overlay on a TrackSectorDevice to give the proper sector skew to the device.

From Beneath Apple DOS (2020).
-------- SECTOR ORDERING --------
Physical*  DOS 3.3  Pascal*  CP/M
    0         0        0       0
    1         D        2       3
    2         B        4       6
    3         9        6       9
    4         7        8       C
    5         5        A       F
    6         3        C       2
    7         1        E       5
    8         E        1       8
    9         C        3       B
    A         A        5       E
    B         8        7       1
    C         6        9       4
    D         4        B       7
    E         2        D       A
    F         F        F       D

Notes:
• Physical = RDOS and DOS 3.2 sector ordering
• Pascal = ProDOS sector ordering

Nested Class Summary

Nested classes/interfaces inherited from interface TrackSectorDevice

TrackSectorDevice.Geometry

Field Summary

Fields inherited from interface TrackSectorDevice

SECTOR_SIZE

Method Summary

Modifier and Type	Method	Description
boolean	can(Capability capability)	Helps identify capabilities of the existing component.
static TrackSectorDevice	dosToCpmSkew(TrackSectorDevice device)
static TrackSectorDevice	dosToPascalSkew(TrackSectorDevice device)
static TrackSectorDevice	dosToPhysicalSkew(TrackSectorDevice device)
void	format()	Format a disk.
<T> Optional<T>	get(Class<T> iface)
TrackSectorDevice.Geometry	getGeometry()	Get information that describes the disk geometry.
List<InformationGroup>	information()
boolean	is(Hint hint)
static TrackSectorDevice	pascalToCpmSkew(TrackSectorDevice device)
static TrackSectorDevice	pascalToPhysicalSkew(TrackSectorDevice device)
static TrackSectorDevice	physicalToDosSkew(TrackSectorDevice device)
static TrackSectorDevice	physicalToPascalSkew(TrackSectorDevice device)
DataBuffer	readSector(int track, int sector)	Read a single sector from the disk.
static TrackSectorDevice	truncate16sectorTo13(TrackSectorDevice device)
void	writeSector(int track, int sector, DataBuffer data)	Write a single sector to the disk.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface HintProvider

isAny

Methods inherited from interface TrackSectorDevice

calculateRequiredSectors, performRange, readRange, writeRange

Method Details

physicalToDosSkew

public static TrackSectorDevice physicalToDosSkew(TrackSectorDevice device)

physicalToPascalSkew

public static TrackSectorDevice physicalToPascalSkew(TrackSectorDevice device)

pascalToPhysicalSkew

public static TrackSectorDevice pascalToPhysicalSkew(TrackSectorDevice device)

dosToPhysicalSkew

public static TrackSectorDevice dosToPhysicalSkew(TrackSectorDevice device)

dosToPascalSkew

public static TrackSectorDevice dosToPascalSkew(TrackSectorDevice device)

dosToCpmSkew

public static TrackSectorDevice dosToCpmSkew(TrackSectorDevice device)

pascalToCpmSkew

public static TrackSectorDevice pascalToCpmSkew(TrackSectorDevice device)

truncate16sectorTo13

public static TrackSectorDevice truncate16sectorTo13(TrackSectorDevice device)

get

public <T> Optional<T> get(Class<T> iface)

Specified by:

get in interface Container

is

public boolean is(Hint hint)

Specified by:

is in interface HintProvider

can

public boolean can(Capability capability)

Description copied from interface: CapabilityProvider

Helps identify capabilities of the existing component.

Specified by:

can in interface CapabilityProvider

getGeometry

public TrackSectorDevice.Geometry getGeometry()

Description copied from interface: TrackSectorDevice

Get information that describes the disk geometry.

Specified by:

getGeometry in interface TrackSectorDevice

readSector

public DataBuffer readSector(int track,
 int sector)

Description copied from interface: TrackSectorDevice

Read a single sector from the disk.

Specified by:

readSector in interface TrackSectorDevice

writeSector

public void writeSector(int track,
 int sector,
 DataBuffer data)

Description copied from interface: TrackSectorDevice

Write a single sector to the disk.

Specified by:

writeSector in interface TrackSectorDevice

format

public void format()

Description copied from interface: TrackSectorDevice

Format a disk. For most disks, this is simply a wipe to all zeros. If this disk has extended format (such as nibble formats), this is the opportunity to write out that format.

NOTE: Adapter type devices have to be cautious about what device is responsible about formatting. For example, a UniDOS disk is 2x400K volumes on an 800K block device -- if they defer formatting to the 800K block device, a format on one volume also wipes out the other (in this case, do not defer to the "parent"). However, if the block adapter contains a nibble-based TrackSectorDevice, the actual formatting needs to get to the nibble device so it can lay down sector markers and the rest of the track structure.

Specified by:

format in interface TrackSectorDevice

information

public List<InformationGroup> information()

Specified by:

information in interface InformationProvider