mirror of https://github.com/ipxe/ipxe.git
334 lines
8.2 KiB
C
334 lines
8.2 KiB
C
#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 */
|