diff options
Diffstat (limited to '')
| -rw-r--r-- | docs/DRIVERS.md | 18 |
1 files changed, 17 insertions, 1 deletions
diff --git a/docs/DRIVERS.md b/docs/DRIVERS.md index e17e15e..2f9f389 100644 --- a/docs/DRIVERS.md +++ b/docs/DRIVERS.md @@ -10,7 +10,23 @@ ACPI (Advanced Configuration and Power Interface) ## ata.c ATA (Advanced Technology Attachment) / IDE (Integrated Drive Electronics) -- ide/ata disk device driver + +This driver exposes a few functions. Because devices are discovered through +the IDE controller, the device types and functions are named with `ide_device_` +prefix, rather than something like `ata_device_`. The functions and types +provided are as follows: + +- `enum ide_error`: Conglomerate error enum/int for all fallible functions in + this module. +- `ide_device_t`: An opaque handle referring to one of the drives attached to + the IDE controller. +- `enum ide_error ata_init(void)`: Initialize the data internal to this driver + by searching for the first PCI device which appears to be an IDE controller + and enumerating all the drives attached to it. After calling this, it is + valid to call `ide_devices_enumerate`. +- `enum ide_error ide_device_read_sectors(ide_device_t, uint16_t numsects, uint32_t lba, uint16_t buf[numsects * 256])`: Given an `ide_device_t`, read a number of sectors (`numsects`) off of it starting at offset `lba`, into memory pointed at by `buf`. Can fail if device faults, the device doesn't exist, if it's an ATAPI device (ATAPI is unimplemented) or if polling the channel fails for any reason (see the `IDE_ERROR_POLL_` entries of the `enum ide_error`. +- `enum ide_error ide_device_write_sectors(ide_device_t, uint16_t numsects, uint32_t lba, uint16_t buf[numsects * 256])`: Given an `ide_device_t`, write a number of sectors (`numsects`) pointed at by `buf` at offset `lba`. Will warn but not fail if the polling operation fails on the disk. +- `struct ide_devicelist ide_devices_enumerate(void)`: Returns a structure which contains a variable number of `ide_device_t`s. It is only valid to call this after calling `ata_init` with return code `IDE_ERROR_OK`. ## clock.c |