123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333 |
- #ifndef INT13_H
- #define INT13_H
-
- /** @file
- *
- * INT 13 emulation
- *
- */
-
- FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
-
- #include <stdint.h>
- #include <ipxe/list.h>
- #include <ipxe/edd.h>
- #include <realmode.h>
-
- /**
- * @defgroup int13ops INT 13 operation codes
- * @{
- */
-
- /** Reset disk system */
- #define INT13_RESET 0x00
- /** Get status of last operation */
- #define INT13_GET_LAST_STATUS 0x01
- /** Read sectors */
- #define INT13_READ_SECTORS 0x02
- /** Write sectors */
- #define INT13_WRITE_SECTORS 0x03
- /** Get drive parameters */
- #define INT13_GET_PARAMETERS 0x08
- /** Get disk type */
- #define INT13_GET_DISK_TYPE 0x15
- /** Extensions installation check */
- #define INT13_EXTENSION_CHECK 0x41
- /** Extended read */
- #define INT13_EXTENDED_READ 0x42
- /** Extended write */
- #define INT13_EXTENDED_WRITE 0x43
- /** Verify sectors */
- #define INT13_EXTENDED_VERIFY 0x44
- /** Extended seek */
- #define INT13_EXTENDED_SEEK 0x47
- /** Get extended drive parameters */
- #define INT13_GET_EXTENDED_PARAMETERS 0x48
- /** Get CD-ROM status / terminate emulation */
- #define INT13_CDROM_STATUS_TERMINATE 0x4b
- /** Read CD-ROM boot catalog */
- #define INT13_CDROM_READ_BOOT_CATALOG 0x4d
-
- /** @} */
-
- /**
- * @defgroup int13status INT 13 status codes
- * @{
- */
-
- /** Operation completed successfully */
- #define INT13_STATUS_SUCCESS 0x00
- /** Invalid function or parameter */
- #define INT13_STATUS_INVALID 0x01
- /** Read error */
- #define INT13_STATUS_READ_ERROR 0x04
- /** Reset failed */
- #define INT13_STATUS_RESET_FAILED 0x05
- /** Write error */
- #define INT13_STATUS_WRITE_ERROR 0xcc
-
- /** @} */
-
- /** Block size for non-extended INT 13 calls */
- #define INT13_BLKSIZE 512
-
- /** @defgroup int13fddtype INT 13 floppy disk drive types
- * @{
- */
-
- /** 360K */
- #define INT13_FDD_TYPE_360K 0x01
- /** 1.2M */
- #define INT13_FDD_TYPE_1M2 0x02
- /** 720K */
- #define INT13_FDD_TYPE_720K 0x03
- /** 1.44M */
- #define INT13_FDD_TYPE_1M44 0x04
-
- /** An INT 13 disk address packet */
- struct int13_disk_address {
- /** Size of the packet, in bytes */
- uint8_t bufsize;
- /** Reserved */
- uint8_t reserved_a;
- /** Block count */
- uint8_t count;
- /** Reserved */
- uint8_t reserved_b;
- /** Data buffer */
- struct segoff buffer;
- /** Starting block number */
- uint64_t lba;
- /** Data buffer (EDD 3.0+ only) */
- uint64_t buffer_phys;
- /** Block count (EDD 4.0+ only) */
- uint32_t long_count;
- /** Reserved */
- uint32_t reserved_c;
- } __attribute__ (( packed ));
-
- /** INT 13 disk parameters */
- struct int13_disk_parameters {
- /** Size of this structure */
- uint16_t bufsize;
- /** Flags */
- uint16_t flags;
- /** Number of cylinders */
- uint32_t cylinders;
- /** Number of heads */
- uint32_t heads;
- /** Number of sectors per track */
- uint32_t sectors_per_track;
- /** Total number of sectors on drive */
- uint64_t sectors;
- /** Bytes per sector */
- uint16_t sector_size;
- /** Device parameter table extension */
- struct segoff dpte;
- /** Device path information */
- struct edd_device_path_information dpi;
- } __attribute__ (( packed ));
-
- /**
- * @defgroup int13types INT 13 disk types
- * @{
- */
-
- /** No such drive */
- #define INT13_DISK_TYPE_NONE 0x00
- /** Floppy without change-line support */
- #define INT13_DISK_TYPE_FDD 0x01
- /** Floppy with change-line support */
- #define INT13_DISK_TYPE_FDD_CL 0x02
- /** Hard disk */
- #define INT13_DISK_TYPE_HDD 0x03
-
- /** @} */
-
- /**
- * @defgroup int13flags INT 13 disk parameter flags
- * @{
- */
-
- /** DMA boundary errors handled transparently */
- #define INT13_FL_DMA_TRANSPARENT 0x01
- /** CHS information is valid */
- #define INT13_FL_CHS_VALID 0x02
- /** Removable drive */
- #define INT13_FL_REMOVABLE 0x04
- /** Write with verify supported */
- #define INT13_FL_VERIFIABLE 0x08
- /** Has change-line supported (valid only for removable drives) */
- #define INT13_FL_CHANGE_LINE 0x10
- /** Drive can be locked (valid only for removable drives) */
- #define INT13_FL_LOCKABLE 0x20
- /** CHS is max possible, not current media (valid only for removable drives) */
- #define INT13_FL_CHS_MAX 0x40
-
- /** @} */
-
- /**
- * @defgroup int13exts INT 13 extension flags
- * @{
- */
-
- /** Extended disk access functions supported */
- #define INT13_EXTENSION_LINEAR 0x01
- /** Removable drive functions supported */
- #define INT13_EXTENSION_REMOVABLE 0x02
- /** EDD functions supported */
- #define INT13_EXTENSION_EDD 0x04
- /** 64-bit extensions are present */
- #define INT13_EXTENSION_64BIT 0x08
-
- /** @} */
-
- /**
- * @defgroup int13vers INT 13 extension versions
- * @{
- */
-
- /** INT13 extensions version 1.x */
- #define INT13_EXTENSION_VER_1_X 0x01
- /** INT13 extensions version 2.0 (EDD-1.0) */
- #define INT13_EXTENSION_VER_2_0 0x20
- /** INT13 extensions version 2.1 (EDD-1.1) */
- #define INT13_EXTENSION_VER_2_1 0x21
- /** INT13 extensions version 3.0 (EDD-3.0) */
- #define INT13_EXTENSION_VER_3_0 0x30
-
- /** @} */
-
- /** Maximum number of sectors for which CHS geometry is allowed to be valid
- *
- * This number is taken from the EDD specification.
- */
- #define INT13_MAX_CHS_SECTORS 15482880
-
- /** Bootable CD-ROM specification packet */
- struct int13_cdrom_specification {
- /** Size of packet in bytes */
- uint8_t size;
- /** Boot media type */
- uint8_t media_type;
- /** Drive number */
- uint8_t drive;
- /** CD-ROM controller number */
- uint8_t controller;
- /** LBA of disk image to emulate */
- uint32_t lba;
- /** Device specification */
- uint16_t device;
- /** Segment of 3K buffer for caching CD-ROM reads */
- uint16_t cache_segment;
- /** Load segment for initial boot image */
- uint16_t load_segment;
- /** Number of 512-byte sectors to load */
- uint16_t load_sectors;
- /** Low 8 bits of cylinder number */
- uint8_t cyl;
- /** Sector number, plus high 2 bits of cylinder number */
- uint8_t cyl_sector;
- /** Head number */
- uint8_t head;
- } __attribute__ (( packed ));
-
- /** Bootable CD-ROM boot catalog command packet */
- struct int13_cdrom_boot_catalog_command {
- /** Size of packet in bytes */
- uint8_t size;
- /** Number of sectors of boot catalog to read */
- uint8_t count;
- /** Buffer for boot catalog */
- uint32_t buffer;
- /** First sector in boot catalog to transfer */
- uint16_t start;
- } __attribute__ (( packed ));
-
- /** A C/H/S address within a partition table entry */
- struct partition_chs {
- /** Head number */
- uint8_t head;
- /** Sector number, plus high 2 bits of cylinder number */
- uint8_t cyl_sector;
- /** Low 8 bits of cylinder number */
- uint8_t cyl;
- } __attribute__ (( packed ));
-
- #define PART_HEAD(chs) ( (chs).head )
- #define PART_SECTOR(chs) ( (chs).cyl_sector & 0x3f )
- #define PART_CYLINDER(chs) ( (chs).cyl | ( ( (chs).cyl_sector & 0xc0 ) << 2 ) )
-
- /** A partition table entry within the MBR */
- struct partition_table_entry {
- /** Bootable flag */
- uint8_t bootable;
- /** C/H/S start address */
- struct partition_chs chs_start;
- /** System indicator (partition type) */
- uint8_t type;
- /** C/H/S end address */
- struct partition_chs chs_end;
- /** Linear start address */
- uint32_t start;
- /** Linear length */
- uint32_t length;
- } __attribute__ (( packed ));
-
- /** A Master Boot Record */
- struct master_boot_record {
- /** Code area */
- uint8_t code[440];
- /** Disk signature */
- uint32_t signature;
- /** Padding */
- uint8_t pad[2];
- /** Partition table */
- struct partition_table_entry partitions[4];
- /** 0x55aa MBR signature */
- uint16_t magic;
- } __attribute__ (( packed ));
-
- /** MBR magic signature */
- #define INT13_MBR_MAGIC 0xaa55
-
- /** A floppy disk geometry */
- struct int13_fdd_geometry {
- /** Number of tracks */
- uint8_t tracks;
- /** Number of heads and sectors per track */
- uint8_t heads_spt;
- };
-
- /** Define a floppy disk geometry */
- #define INT13_FDD_GEOMETRY( cylinders, heads, sectors ) \
- { \
- .tracks = (cylinders), \
- .heads_spt = ( ( (heads) << 6 ) | (sectors) ), \
- }
-
- /** Get floppy disk number of cylinders */
- #define INT13_FDD_CYLINDERS( geometry ) ( (geometry)->tracks )
-
- /** Get floppy disk number of heads */
- #define INT13_FDD_HEADS( geometry ) ( (geometry)->heads_spt >> 6 )
-
- /** Get floppy disk number of sectors per track */
- #define INT13_FDD_SECTORS( geometry ) ( (geometry)->heads_spt & 0x3f )
-
- /** A floppy drive parameter table */
- struct int13_fdd_parameters {
- uint8_t step_rate__head_unload;
- uint8_t head_load__ndma;
- uint8_t motor_off_delay;
- uint8_t bytes_per_sector;
- uint8_t sectors_per_track;
- uint8_t gap_length;
- uint8_t data_length;
- uint8_t format_gap_length;
- uint8_t format_filler;
- uint8_t head_settle_time;
- uint8_t motor_start_time;
- } __attribute__ (( packed ));
-
- #endif /* INT13_H */
|