PCI IDE Controller: Difference between revisions

m
Bot: fixing lint errors, replacing obsolete HTML tags: <font> (2x)
[unchecked revision][unchecked revision]
m (Large cleanup, needs grammar and technical checks. Part one)
m (Bot: fixing lint errors, replacing obsolete HTML tags: <font> (2x))
 
(45 intermediate revisions by 20 users not shown)
Line 1:
{{Disputed|Talk:IDE}}
IDE is a keyword which refers to the electrical specification of the cables which connect ATA drives (like hard drives) to another device. The drives use the ATA (Advanced Technology Attachment) interface. An IDE cable also can terminate at an IDE card connected to PCI.
 
[[ATAPI]] is an extension to ATA (recently renamed to PATA) which adds support for the SCSI command set.
== Parallel/Serial ATA/ATAPI ==
IDE can connect up to 4 drives. Each drive can be one of the following:
* ATA (Serial): Used for most modern hard drives.
* ATA (Parallel): Commonly used for hard drives.
* ATAPI (Serial): Used for most modern optical drives.
* ATAPI (Parallel): Commonly used for optical drives.
Accessing an ATA/PATA drive works the same way as accessing a SATA drive. This also implicitly states that accessing a PATAPI ODD is the same as accessing a SATAPI ODD. An IDE driver does not need to know whether a drive is parallel or serial, it only has to know whether it's using ATA or ATAPI.
== IDE Interface ==
If you open your case up and take a look at your motherboard, you will most likely see one or two (or possibly more) of the slots.
 
The white and green ports are IDE ports, also known as ''channels''. In this example there are both primary and secondary IDE channels which only PATA can be connected to; this means that it only supports PATA/PATAPI drives.
===Parallel/Serial ATA/ATAPI===
IDE can connect up to 4 drives. Each drive may be:
 
Each port can have a PATA cable connected to it. One master drive, or two drives (master and slave), can be connected to one PATA cable. So that leaves us with the following possibilities:
* Parallel ATA: Commonly used in hard drives.
* Parallel ATAPI: Commonly used in optical drives.
* Serial ATA: Used in most modern hard drives.
* Serial ATAPI: Used in most modern optical drives.
 
The Way of accessing ATA Drives is one, means that the way of accessing PATA HDDs is the same of SATA HDDs. also the way of accessing PATAPI ODDs is the same of SATAPI ODDs.
The IDE device driver doesn't need to know if a drive is Parallel or Serial, only if it is ATA or ATAPI.
 
===IDE Interface===
[[Image:Ide-motherboard-connectors.jpg|thumb|IDE on motherboard|256px|The white and green ports are the Parallel IDE ports on the motherboard.]]
[[Image:PATA-Cable.jpg|thumb|PATA Cable|256px|PATA cable which connects to to a Parallel IDE port.]]
[[Image:SATA-motherboard.jpg|thumb|SATA Ports|256px|4 Serial IDE ports on the motherboard.]]
[[Image:SATA-Cable.gif|thumb|SATA Cable|256px|SATA cable which connects to a SATA port.]]
 
If you open your case and look at the mother board, you will see a port or two like these in the picture to the right.
 
The white and green ports are IDE ports, also known as channels. In this example there are both primary and secondary IDE channels which only PATA can be connected to; this means that it only supports PATA/PATAPI drives.
 
Each port can have a PATA cable connected to it (see photo on right). One master drive, or two drives (master and slave) can be connected to one PATA cable.
So we can have:
* Primary Master Drive.
* Primary Slave Drive.
* Secondary Master Drive.
* Secondary Slave Drive.
Each drive maycan be either PATA or PATAPI.
== Serial IDE ==
 
Almost every modern (this article is probably written in early 2010 so it assumes motherboards still have ide/ahci modes) motherboard has a Serial IDE channel which allows [[SATA]] and SATAPI Drives to be connected to it. There are 4 Serial IDE Ports. Each port is connected to a drive with a SATA Cable. Basically you can only have one drive connected to the Serial IDE port. Each pair of ports (every 2 ports) form one channel.
===Serial IDE===
Almost every modern motherboard has a Serial IDE channel which allows [[SATA]] and SATAPI Drives to be connected to it.
There are four Serial IDE Ports; these appear in the photo to the right. Each port is connected to a drive with a Serial ATA (SATA) Cable.
So from the pictures we can understand that only one drive can be connected to Serial IDE Port, each two ports make a channel, and also Serial IDE has:
 
Serial IDE also has a few possibilities:
* Primary Master, also called SATA1.
* Primary Slave, also called SATA2.
* Secondary Master, also called SATA3.
* Secondary Slave, also called SATA4.
== Detecting a PCI IDE Controller ==
Each IDE controller appears as a device on the [[PCI]] bus and can be identified by reading the configuration space. If the class code is 0x01 (Mass Storage Controller) and the subclass code is 0x01 (IDE), the device is an IDE controller. The programming interface byte(Prog If) determines how you'll access it.
* Bit 0: When set, the primary channel is in PCI native mode. When clear, the primary channel is in compatibility mode (ports 0x1F0-0x1F7, 0x3F6, IRQ14).
* Bit 1: When set, you can modify bit 0 to switch between PCI native and compatibility mode. When clear, you cannot modify bit 0.
* Bit 2: When set, the secondary channel is in PCI native mode. When clear, the secondary channel is in compatibility mode (ports 0x170-0x177, 0x376, IRQ15).
* Bit 3: When set, you can modify bit 2 to switch between PCI native and compatibility mode. When clear, you cannot modify bit 2.
* Bit 7: When set, this is a bus master IDE controller. When clear, this controller doesn't support DMA.
If you want to access an IDE channel in PCI native mode or use the bus master function, you must additionally read the BARs to find which I/O ports to use.
* BAR0: Base address of primary channel in PCI native mode (8 ports)
* BAR1: Base address of primary channel control port in PCI native mode (4 ports)
* BAR2: Base address of secondary channel in PCI native mode (8 ports)
* BAR3: Base address of secondary channel control port in PCI native mode (4 ports)
* BAR4: Bus master IDE (16 ports, 8 for each channel)
Note that BAR1 and BAR3 specify 4 ports, but only the port at offset 2 is used. Offsets 0, 1, and 3 should not be accessed.
 
If either IDE channel is in PCI native mode, you must also read the interrupt line or interrupt pin register to determine which interrupt to use. If both channels are in PCI native mode, they'll both share the same interrupt. The interrupt line field is only valid when using the [[8259 PIC|PIC]].
===Detecting an IDE drive===
== Detecting IDE Drives ==
Each IDE drive appears as a device on the [[PCI]] bus. If the class code is 0x01 (Mass Storage Controller) and the subclass code is 0x1, (IDE) this device is an IDE Device.
The IDE device only uses five BARs out of the six
* BAR0: Base address of primary channel (I/O space), if it is 0x0 or 0x1, the port is 0x1F0.
* BAR1: Base address of primary channel control port (I/O space), if it is 0x0 or 0x1, the port is 0x3F4.
* BAR2: Base address of secondary channel (I/O space), if it is 0x0 or 0x1, the port is 0x170.
* BAR3: Base address of secondary channel control port, if it is 0x0 or 0x1, the port is 0x374.
* BAR4: Bus Master IDE; refers to the base of I/O range consisting of 16 ports. Each 8 ports controls DMA on the primary and secondary channel respectively.
 
A parallel IDE drive will use IRQs 14 and 15; a serial IDE uses only one IRQ. To read this IRQ, we look through the device's PCI configuration space:
<source lang="c">
outl((1 << 31) | (bus << 16) | (device << 11) | (func << 8) | 8, 0xCF8); // Send the parameters.
if ((inl(0xCFC) >> 16) != 0xFFFF) { // If device exists (class isn't 0xFFFF)
// Check if this device needs an IRQ assignment:
outl((1 << 31) | (bus << 16) | (device << 11) | (func << 8) | 0x3C, 0xCF8); // Read the interrupt line field
outb(0xFE, 0xCFC); // Change the IRQ field to 0xFE
outl((1 << 31) | (bus << 16) | (device << 11) | (func << 8) | 0x3C, 0xCF8); // Read the interrupt line field
if ((inl(0xCFC) & 0xFF) == 0xFE) {
// This device needs an IRQ assignment.
} else {
// The device doesn't use IRQs, check if this is an Parallel IDE:
if (class == 0x01 && subclass == 0x01 && (ProgIF == 0x8A || ProgIF == 0x80)) {
// This is a Parallel IDE Controller which used IRQs 14 and 15.
}
}
}
</source>
 
===Detecting IDE Drives===
 
To initialise the IDE driver, we call ide_initialise:
<sourcesyntaxhighlight lang="c">
void ide_initialize(unsigned int BAR0, unsigned int BAR1, unsigned int BAR2, unsigned int BAR3,
unsigned int BAR4) {
</syntaxhighlight>
</source>
 
If you only want to support the parallel IDE, you can use these parameters:
<sourcesyntaxhighlight lang="c">
ide_initialize(0x1F0, 0x3F40x3F6, 0x170, 0x3740x376, 0x000);
</syntaxhighlight>
</source>
 
We can assume that BAR4 is 0x0 because we are not going to use it yet.
We will return to ide_initialize function, which searches for drives connected to the IDE, but. beforeBefore we are goinggo into this function, we should write some support functions and definitions which will help us a lot. But before that, we should write some definitions:
=== Status ===
 
The Command/Status Port returns a bit mask referring to the status of a channel when read.
<source lang="c">
<syntaxhighlight lang="c">
#define ATA_SR_BSY 0x80
#define ATA_SR_BSY ATA_SR_DRDY 0x80 0x40 // Busy
#define ATA_SR_DRDY ATA_SR_DF 0x40 // 0x20Drive ready
#define ATA_SR_DF ATA_SR_DSC 0x20 0x10 // Drive write fault
#define ATA_SR_DSC ATA_SR_DRQ 0x10 0x08 // Drive seek complete
#define ATA_SR_DRQ ATA_SR_CORR 0x08 0x04 // Data request ready
#define ATA_SR_CORR ATA_SR_IDX 0x04 0x02// Corrected data
#define ATA_SR_IDX ATA_SR_ERR 0x02 0x01 // Index
#define ATA_SR_ERR 0x01 // Error
</source>
</syntaxhighlight>
There is a port called the Command/Status Port, when it is read the status of channel is returned; the above bit mask expresses these states.
=== Errors ===
 
The Features/Error Port, which returns the most recent error upon read, has these possible bit masks
<source lang="c">
<syntaxhighlight lang="c">
#define ATA_ER_BBK 0x80
#define ATA_ER_BBK ATA_ER_UNC 0x80 0x40 // Bad block
#define ATA_ER_UNC ATA_ER_MC 0x40 0x20// Uncorrectable data
#define ATA_ER_MC ATA_ER_IDNF 0x20 0x10 // Media changed
#define ATA_ER_IDNF ATA_ER_MCR 0x10 0x08// ID mark not found
#define ATA_ER_MCR ATA_ER_ABRT 0x08 0x04 // Media change request
#define ATA_ER_ABRT ATA_ER_TK0NF 0x04 0x02 // Command aborted
#define ATA_ER_TK0NF ATA_ER_AMNF 0x02 0x01// Track 0 not found
#define ATA_ER_AMNF 0x01 // No address mark
</source>
</syntaxhighlight>
There is also port called the Features/Error Port, which returns the most recent error upon read; the above definitions express the possible bit masks
=== Commands ===
 
When you write to the Command/Status port, you are executing one of the commands below.
<source lang="c">
<syntaxhighlight lang="c">
#define ATA_CMD_READ_PIO 0x20
#define ATA_CMD_READ_PIO ATA_CMD_READ_PIO_EXT 0x240x20
#define ATA_CMD_READ_PIO_EXT ATA_CMD_READ_DMA 0xC80x24
#define ATA_CMD_READ_DMA ATA_CMD_READ_DMA_EXT 0x250xC8
#define ATA_CMD_READ_DMA_EXT ATA_CMD_WRITE_PIO 0x300x25
#define ATA_CMD_WRITE_PIO ATA_CMD_WRITE_PIO_EXT 0x340x30
#define ATA_CMD_WRITE_PIO_EXT ATA_CMD_WRITE_DMA 0xCA0x34
#define ATA_CMD_WRITE_DMA ATA_CMD_WRITE_DMA_EXT 0x350xCA
#define ATA_CMD_WRITE_DMA_EXT ATA_CMD_CACHE_FLUSH 0xE70x35
#define ATA_CMD_CACHE_FLUSH ATA_CMD_CACHE_FLUSH_EXT 0xEA0xE7
#define ATA_CMD_CACHE_FLUSH_EXT 0xEA
#define ATA_CMD_PACKET 0xA0
#define ATA_CMD_PACKET ATA_CMD_IDENTIFY_PACKET 0xA1 0xA0
#define ATA_CMD_IDENTIFY_PACKET 0xA1
#define ATA_CMD_IDENTIFY 0xEC
#define ATA_CMD_IDENTIFY 0xEC
</source>
</syntaxhighlight>
When you write to the Command/Status port, you are executing one of the commands above.
The commands below are for ATAPI devices, which will be understood soon.
 
<sourcesyntaxhighlight lang="c">
#define ATAPI_CMD_READ 0xA8
#define ATAPI_CMD_EJECT 0x1B
</syntaxhighlight>
</source>
ATA_CMD_IDENTIFY_PACKET and ATA_CMD_IDENTIFY return a buffer of 512 bytes called the identification space; the following definitions are used to read information from the identification space.
 
<syntaxhighlight lang="c">
The commands above are for ATAPI Devices which will be understood soon.
#define ATA_IDENT_DEVICETYPE 0
 
#define ATA_IDENT_CYLINDERS 2
ATA_CMD_IDENTIFY_PACKET and ATA_CMD_IDENTIFY return a buffer of 512 bytes called Identification space; the following definitions are used to read information from the identification space.
#define ATA_IDENT_HEADS 6
<source lang="c">
#define ATA_IDENT_SECTORS ATA_IDENT_DEVICETYPE 012
#define ATA_IDENT_SERIAL ATA_IDENT_CYLINDERS 220
#define ATA_IDENT_MODEL ATA_IDENT_HEADS 654
#define ATA_IDENT_CAPABILITIES 98
#define ATA_IDENT_SECTORS 12
#define ATA_IDENT_FIELDVALID 106
#define ATA_IDENT_SERIAL 20
#define ATA_IDENT_MAX_LBA ATA_IDENT_MODEL 54120
#define ATA_IDENT_COMMANDSETS 164
#define ATA_IDENT_CAPABILITIES 98
#define ATA_IDENT_MAX_LBA_EXT 200
#define ATA_IDENT_FIELDVALID 106
</syntaxhighlight>
#define ATA_IDENT_MAX_LBA 120
When you select a drive, you should specify the interface type and whether it is the master or slave:
#define ATA_IDENT_COMMANDSETS 164
<syntaxhighlight lang="c">
#define ATA_IDENT_MAX_LBA_EXT 200
#define IDE_ATA 0x00
</source>
#define IDE_ATAPI 0x01
 
When you select a drive, you should specify if it is the master drive or the slave one:
<source lang="c">
#define ATA_MASTER 0x00
#define ATA_SLAVE 0x01
</source>
 
<source lang="c">
#define IDE_ATA 0x00
#define IDE_ATAPI 0x01
</source>
 
<source lang="c">
#define ATA_REG_DATA 0x00
#define ATA_REG_ERROR 0x01
#define ATA_REG_FEATURES 0x01
#define ATA_REG_SECCOUNT0 0x02
#define ATA_REG_LBA0 0x03
#define ATA_REG_LBA1 0x04
#define ATA_REG_LBA2 0x05
#define ATA_REG_HDDEVSEL 0x06
#define ATA_REG_COMMAND 0x07
#define ATA_REG_STATUS 0x07
#define ATA_REG_SECCOUNT1 0x08
#define ATA_REG_LBA3 0x09
#define ATA_REG_LBA4 0x0A
#define ATA_REG_LBA5 0x0B
#define ATA_REG_CONTROL 0x0C
#define ATA_REG_ALTSTATUS 0x0C
#define ATA_REG_DEVADDRESS 0x0D
</source>
 
 
Task File is a range of ports [8 ports] which are used by primary channel [BAR0] or Secondary Channel [BAR2].
 
#define ATA_MASTER 0x00
#define ATA_SLAVE 0x01
</syntaxhighlight>
Task File is a range of 8 ports which are offsets from BAR0 (primary channel) and/or BAR2 (secondary channel). To exemplify:
* BAR0 + 0 is first port.
* BAR0 + 1 is second port.
* BAR0 + 32 is the third ... etc ...
<syntaxhighlight lang="c">
 
#define ATA_REG_DATA 0x00
if BAR0 is 0x1F0:
#define ATA_REG_ERROR 0x01
* The Data Port of the Primary Channel is 0x1F0.
#define ATA_REG_FEATURES 0x01
* The Features/Error Port of the Primary Channel is 0x1F1.
#define ATA_REG_SECCOUNT0 0x02
* etc ...
#define ATA_REG_LBA0 0x03
The same with the secondary channel.
#define ATA_REG_LBA1 0x04
 
#define ATA_REG_LBA2 0x05
There is a port which is called "ALTSTATUS/CONTROL PORT", when is read, you read alternate status, when this port is written to, you are controlling a channel.
#define ATA_REG_HDDEVSEL 0x06
 
#define ATA_REG_COMMAND 0x07
* For the Primary Channel, ALTSTATUS/CONTROL Port is BAR1 + 2.
#define ATA_REG_STATUS 0x07
* For the Secondary Channel, ALTSTATUS/CONTROL Port is BAR3 + 2.
#define ATA_REG_SECCOUNT1 0x08
 
#define ATA_REG_LBA3 0x09
We can know say that Each Channel has 13 Register, for a primary channel:
#define ATA_REG_LBA4 0x0A
 
#define ATA_REG_LBA5 0x0B
* Data Register: BAR0[0]; // Read and Write
#define ATA_REG_CONTROL 0x0C
* Error Register: BAR0[1]; // Read Only
#define ATA_REG_ALTSTATUS 0x0C
* Features Register: BAR0[1]; // Write Only
#define ATA_REG_DEVADDRESS 0x0D
* SECCOUNT0: BAR0[2]; // Read and Write
</syntaxhighlight>
* LBA0: BAR0[3]; // Read and Write
The ALTSTATUS/CONTROL port returns the alternate status when read and controls a channel when written to.
* LBA1: BAR0[4]; // Read and Write
* For the primary channel, ALTSTATUS/CONTROL port is BAR1 + 2.
* LBA2: BAR0[5]; // Read and Write
* For the secondary channel, ALTSTATUS/CONTROL port is BAR3 + 2.
* HDDEVSEL: BAR0[6]; // Read and Write, this port is used to select a drive in the channel.
We can now say that each channel has 13 registers. For the primary channel, we use these values:
* Command Register: BAR0[7]; // Write Only.
* StatusData Register: BAR0[7] + 0; // Read Only.-Write
* Alternate StatusError Register: BAR1[2]BAR0 + 1; // Read Only.
* ControlFeatures Register: BAR1[2]BAR0 + 1; // Write Only.
* SECCOUNT0: BAR0 + 2; // Read-Write
* DEVADDRESS: BAR1[2]; // I don't know what is the benefit from this register.
* LBA0: BAR0 + 3; // Read-Write
 
* LBA1: BAR0 + 4; // Read-Write
The map above is the same with the secondary channel, but it is using BAR2 and BAR3 instead of BAR0 and BAR1.
* LBA2: BAR0 + 5; // Read-Write
 
* HDDEVSEL: BAR0 + 6; // Read-Write, used to select a drive in the channel.
<source lang="c">
* Command Register: BAR0 + 7; // Write Only.
* Status Register: BAR0 + 7; // Read Only.
* Alternate Status Register: BAR1 + 2; // Read Only.
* Control Register: BAR1 + 2; // Write Only.
* DEVADDRESS: BAR1 + 3; // I don't know what is the benefit from this register.
The map above is the same with the secondary channel, but it uses BAR2 and BAR3 instead of BAR0 and BAR1.
<syntaxhighlight lang="c">
// Channels:
#define ATA_PRIMARY 0x00
#define ATA_SECONDARY 0x01
</source>
 
<source lang="c">
// Directions:
#define ATA_READ 0x00
#define ATA_WRITE 0x01
</syntaxhighlight>
</source>
We have defined everything needed by the driver, now lets move to an important part. We said that
 
* BAR0 is the start of the I/O ports used by the primary channel.
We have had defined all definitions needed by the driver, now lets move to an important part, we said that
* BAR0BAR1 is the Basestart of the I/O Portsports usedwhich bycontrol the Primaryprimary Channelchannel.
* BAR1BAR2 is the Basestart of the I/O Portsports whichused controlby Primarysecondary Channelchannel.
* BAR2BAR3 is the Basestart of the I/O Portsports usedwhich bycontrol Secondarysecondary Channelchannel.
* BAR3BAR4 is the Basestart of 8 I/O Portsports controls the primary whichchannel's controlBus SecondaryMaster ChannelIDE.
* BAR4 + 8 is the Base of 8 I/O Portsports controls Primarysecondary Channelchannel's Bus Master IDE [BMIDE].
* BAR4 + 8 is the Base of 8 I/O Ports controls Secondary Channel's Bus Master IDE [BMIDE].
 
So we can make this global structure:
<syntaxhighlight lang="c">
 
struct IDEChannelRegisters {
<source lang="c">
struct channel {
unsigned short base; // I/O Base.
unsigned short ctrl; // Control Base
Line 245 ⟶ 190:
unsigned char nIEN; // nIEN (No Interrupt);
} channels[2];
</syntaxhighlight>
</source>
We also need a buffer to read the identification space into, we need a variable that indicates if an irq is invoked or not, and finally we need an array of 6 words [12 bytes] for ATAPI Drives:
 
<syntaxhighlight lang="c">
We also need a buffer to read the identification space in it, we need a variable that indicates if an irq is invoked or not, and finally we need an array of 6 words [12 bytes] for ATAPI Drives:
 
<source lang="c">
unsigned char ide_buf[2048] = {0};
volatile unsigned static char ide_irq_invoked = 0;
unsigned static char atapi_packet[12] = {0xA8, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
</syntaxhighlight>
</source>
 
We said the the IDE can contain up to 4 drives:
<syntaxhighlight lang="c">
 
<source lang="c">
struct ide_device {
unsigned char reservedReserved; // 0 (Empty) or 1 (This Drive really exists).
unsigned char channelChannel; // 0 (Primary Channel) or 1 (Secondary Channel).
unsigned char driveDrive; // 0 (Master Drive) or 1 (Slave Drive).
unsigned short typeType; // 0: ATA, 1:ATAPI.
unsigned short signSignature; // Drive Signature
unsigned short capabilitiesCapabilities;// Features.
unsigned int commandsetsCommandSets; // Command Sets Supported.
unsigned int sizeSize; // Size in Sectors.
unsigned char modelModel[41]; // Model in string.
} ide_devices[4];
</syntaxhighlight>
</source>
 
When we read a register in a channel, like STATUS Register, it is easy to execute:
<syntaxhighlight lang="c">
 
ide_read(channel, ATA_REG_STATUS);
 
<source lang="c">
unsigned char ide_read(unsigned char channel, unsigned char reg) {
unsigned char result;
if (reg > 0x07 && reg < 0x0C) ide_write(channel, ATA_REG_CONTROL, 0x80 | channels[channel].nIEN);
if ide_write(regchannel, <ATA_REG_CONTROL, 0x08)0x80 result| = inb(channels[channel].base + reg - 0x00nIEN);
if (reg < 0x08)
else if (reg < 0x0C) result = inb(channels[channel].base + reg - 0x06);
else if (reg < 0x0E) result = inb(channels[channel].ctrl base + reg - 0x0A0x00);
else if (reg < 0x16) result = inb(channels[channel].bmide + reg - 0x0E0x0C);
if (regresult >= 0x07 && reg < 0x0C) ide_writeinb(channel, ATA_REG_CONTROL, channels[channel].nIENbase + reg - 0x06);
else if (reg < 0x0E)
result = inb(channels[channel].ctrl + reg - 0x0A);
else if (reg < 0x16)
result = inb(channels[channel].bmide + reg - 0x0E);
if (reg > 0x07 && reg < 0x0C)
ide_write(channel, ATA_REG_CONTROL, channels[channel].nIEN);
return result;
}
</syntaxhighlight>
</source>
We also need a function for writing to registers:
 
<syntaxhighlight lang="c">
And Also there is a function for writing to registers:
 
<source lang="c">
void ide_write(unsigned char channel, unsigned char reg, unsigned char data) {
if (reg > 0x07 && reg < 0x0C) ide_write(channel, ATA_REG_CONTROL, 0x80 | channels[channel].nIEN);
if ide_write(regchannel, <ATA_REG_CONTROL, 0x08)0x80 outb(data,| channels[channel].base + reg - 0x00nIEN);
if (reg < 0x08)
else if (reg < 0x0C) outb(data, channels[channel].base + reg - 0x06);
else if (reg < 0x0E) outb(data, channels[channel].ctrlbase + reg - 0x0A0x00, data);
else if (reg < 0x16) outb(data, channels[channel].bmide + reg - 0x0E0x0C);
outb(channels[channel].base + reg - 0x06, data);
if (reg > 0x07 && reg < 0x0C) ide_write(channel, ATA_REG_CONTROL, channels[channel].nIEN);
else if (reg < 0x0E)
outb(channels[channel].ctrl + reg - 0x0A, data);
else if (reg < 0x16)
outb(channels[channel].bmide + reg - 0x0E, data);
if (reg > 0x07 && reg < 0x0C)
ide_write(channel, ATA_REG_CONTROL, channels[channel].nIEN);
}
</syntaxhighlight>
</source>
To read the identification space, we should read the Data Register as a double word 128 times. We can then copy them to our buffer.
 
<syntaxhighlight lang="c">
If We want to read the identification space, we should read Data Register as Double Word for 128 times. the first read is the first dword, the second read is the second dword, and so on. we can read the 128 dwords and copy them to our buffer.
 
<source lang="c">
void ide_read_buffer(unsigned char channel, unsigned char reg, unsigned int buffer,
unsigned int quads) {
/* WARNING: This code contains a serious bug. The inline assembly trashes ES and
if (reg > 0x07 && reg < 0x0C) ide_write(channel, ATA_REG_CONTROL, 0x80 | channels[channel].nIEN);
* ESP for all of the code the compiler generates between the inline
* assembly blocks.
*/
if (reg > 0x07 && reg < 0x0C)
ide_write(channel, ATA_REG_CONTROL, 0x80 | channels[channel].nIEN);
asm("pushw %es; movw %ds, %ax; movw %ax, %es");
if (reg < 0x08) insl(channels[channel].base + reg - 0x00, buffer, quads);
else if (reg < 0x0C) insl(channels[channel].base + reg - 0x060x00, buffer, quads);
else if (reg < 0x0E) insl(channels[channel].ctrl + reg - 0x0A, buffer, quads0x0C);
else if (reg < 0x16) insl(channels[channel].bmidebase + reg - 0x0E0x06, buffer, quads);
else if (reg < 0x0E)
insl(channels[channel].ctrl + reg - 0x0A, buffer, quads);
else if (reg < 0x16)
insl(channels[channel].bmide + reg - 0x0E, buffer, quads);
asm("popw %es;");
if (reg > 0x07 && reg < 0x0C) ide_write(channel, ATA_REG_CONTROL, channels[channel].nIEN);
ide_write(channel, ATA_REG_CONTROL, channels[channel].nIEN);
}
</syntaxhighlight>
</source>
When we send a command, we should wait for 400 nanosecond, then read the Status port. If the Busy bit is on, we should read the status port again until the Busy bit is 0; then we can read the results of the command. This operation is called "Polling". We can also use IRQs instead of polling.
 
After many commands, if the Device Fault bit is set, there is a failure; if DRQ is not set, there is an error. If the ERR bit is set, there is an error which is described in Error port.
When we send a command, we should wait for 400 nanosecond, then we should read Status Port, if Busy Bit is on, so we should read status port again, until Busy Bit is 0, in this case, we can read the results of the command. this operation is called "Polling", we can use IRQs instead of polling, and IRQs are suitable for
<syntaxhighlight lang="c">
Multi-Tasking Environments, but i think Polling is much faster than IRQs.
 
After Many Commands, if DF is set [Device Fault Bit], so there is a failure, and if DRQ is not set, so there is an error. if ERR bit is set, so there is an error which is described in Error Port.
 
<source lang="c">
unsigned char ide_polling(unsigned char channel, unsigned int advanced_check) {
 
// (I) Delay 400 nanosecond for BSY to be set:
// -------------------------------------------------
for(int i = 0; i < 4; i++)
ide_read(channel, ATA_REG_ALTSTATUS); // Reading Alternate Status Port wastes 100ns.
ide_read(channel, ATA_REG_ALTSTATUS); // Reading the Alternate Status Portport wastes 100ns; loop four times.
ide_read(channel, ATA_REG_ALTSTATUS); // Reading Alternate Status Port wastes 100ns.
ide_read(channel, ATA_REG_ALTSTATUS); // Reading Alternate Status Port wastes 100ns.
 
// (II) Wait for BSY to be cleared:
// -------------------------------------------------
while (ide_read(channel, ATA_REG_STATUS) & ATA_SR_BSY); // Wait for BSY to be zero.
; // Wait for BSY to be zero.
 
if (advanced_check) {
 
unsigned char state = ide_read(channel, ATA_REG_STATUS); // Read Status Register.
 
// (III) Check For Errors:
// -------------------------------------------------
if (state & ATA_SR_ERR) return 2; // Error.
return 2; // Error.
 
// (IV) Check If Device fault:
// -------------------------------------------------
if (state & ATA_SR_DF ) return 1; // Device Fault.
return 1; // Device Fault.
 
// (V) Check DRQ:
// -------------------------------------------------
// BSY = 0; DF = 0; ERR = 0 so we should check for DRQ now.
if (!(state & ATA_SR_DRQ)) return== 3; // DRQ should be set0)
return 3; // DRQ should be set
 
}
Line 358 ⟶ 313:
 
}
</syntaxhighlight>
</source>
If there is an error, we have a function which prints errors on screen:
 
<syntaxhighlight lang="c">
if there is an error, we have a functions which print errors on screen:
 
<source lang="c">
unsigned char ide_print_error(unsigned int drive, unsigned char err) {
if (err == 0)
if (err == 0) return err;
 
printk(" IDE:");
if (err == 1) {printk("- Device Fault\n "); err = 19;}
else if (err == 2) {
Line 382 ⟶ 335:
else if (err == 4) {printk("- Write Protected\n "); err = 8;}
printk("- [%s %s] %s\n",
(const char *[]){"Primary", "Secondary"}[ide_devices[drive].channel], // Use the channel as an index into the array
(const char *[]){"Master", "Slave"}[ide_devices[drive].drive], // Same as above, using the drive
ide_devices[drive].model);
 
return err;
}
</syntaxhighlight>
</source>
Now let's return to the initialization function:
 
<syntaxhighlight lang="c">
Now lets return to the initialization function:
 
<source lang="c">
void ide_initialize(unsigned int BAR0, unsigned int BAR1, unsigned int BAR2, unsigned int BAR3,
unsigned int BAR4) {
Line 399 ⟶ 350:
 
// 1- Detect I/O Ports which interface IDE Controller:
channels[ATA_PRIMARY ].base = (BAR0 &= 0xFFFFFFFC) + 0x1F0 * (!BAR0);
channels[ATA_PRIMARY ].ctrl = (BAR1 &= 0xFFFFFFFC) + 0x3F40x3F6 * (!BAR1);
channels[ATA_SECONDARY].base = (BAR2 &= 0xFFFFFFFC) + 0x170 * (!BAR2);
channels[ATA_SECONDARY].ctrl = (BAR3 &= 0xFFFFFFFC) + 0x3740x376 * (!BAR3);
channels[ATA_PRIMARY ].bmide = (BAR4 &= 0xFFFFFFFC) + 0; // Bus Master IDE
channels[ATA_SECONDARY].bmide = (BAR4 &= 0xFFFFFFFC) + 8; // Bus Master IDE
</syntaxhighlight>
 
Then we should disable IRQs in both channels by setting bit 1 (nIEN) in the Control port:
 
<syntaxhighlight lang="c">
Then We Should Disable IRQs in the both channels [This is temporary]:
This happens by setting bit 1 [nIEN] in Control Port:
 
Code:
// 2- Disable IRQs:
ide_write(ATA_PRIMARY , ATA_REG_CONTROL, 2);
ide_write(ATA_SECONDARY, ATA_REG_CONTROL, 2);
</syntaxhighlight>
</source>
Now we need to check for drives which could be connected to each channel. We will select the master drive of each channel, and send the ATA_IDENTIFY command (which is supported by ATA Drives). If there's no error, there are values returned in registers which determine the type of Drive; if no drive is present, there will be strange values.
 
Notice that if bit 4 in HDDEVSEL is set to 1, we are selecting the slave drive, if set to 0, we are selecting the master drive.
Now we need to check for drives connected to each channel, we will select the master drive of each channel, and send the command ATA_IDENTIFY (Which is supported by ATA Drives). if error, there is values returned in registers determines the type of Drive, if no drive, there will be strange values.
<syntaxhighlight lang="c">
 
Notice that bit4 in HDDEVSEL, if set to 1, we are selecting the slave drive, if set to 0, we are selecting the master drive.
 
<source lang="c">
// 3- Detect ATA-ATAPI Devices:
for (i = 0; i < 2; i++)
Line 426 ⟶ 372:
 
unsigned char err = 0, type = IDE_ATA, status;
ide_devices[count].reserved Reserved = 0; // Assuming that no drive here.
 
// (I) Select Drive:
ide_write(i, ATA_REG_HDDEVSEL, 0xA0 | (j << 4)); // Select Drive.
sleep(1); // Wait 1ms for drive select to work.
 
Line 438 ⟶ 384:
 
// (III) Polling:
if (!(ide_read(i, ATA_REG_STATUS)) == 0) continue; // If Status = 0, No Device.
 
while(1) {
status = ide_read(i, ATA_REG_STATUS);
if ( (status & ATA_SR_ERR)) {err = 1; break;} // If Err, Device is not ATA.
if (!(status & ATA_SR_BSY) && (status & ATA_SR_DRQ)) break; // Everything is right.
}
Line 448 ⟶ 394:
// (IV) Probe for ATAPI Devices:
 
if (err != 0) {
unsigned char cl = ide_read(i, ATA_REG_LBA1);
unsigned char ch = ide_read(i, ATA_REG_LBA2);
 
if (cl == 0x14 && ch == 0xEB) type = IDE_ATAPI;
else if (cl == 0x69 && ch ==0x96) type = IDE_ATAPI;
else continue;if //(cl Unknown Type (And== always0x69 not&& bech a== device0x96).
type = IDE_ATAPI;
else
continue; // Unknown Type (may not be a device).
 
ide_write(i, ATA_REG_COMMAND, ATA_CMD_IDENTIFY_PACKET);
Line 464 ⟶ 413:
 
// (VI) Read Device Parameters:
ide_devices[count].reservedReserved = 1;
ide_devices[count].typeType = type;
ide_devices[count].channelChannel = i;
ide_devices[count].driveDrive = j;
ide_devices[count].sign Signature = *((unsigned short *)(ide_buf + ATA_IDENT_DEVICETYPE ))[0];
ide_devices[count].capabilitiesCapabilities = *((unsigned short *)(ide_buf + ATA_IDENT_CAPABILITIES))[0];
ide_devices[count].commandsetsCommandSets = *((unsigned int *)(ide_buf +ATA_IDENT_COMMANDSETS ATA_IDENT_COMMANDSETS))[0];
 
// (VII) Get Size:
if (ide_devices[count].commandsetsCommandSets & (1 << 26)){
// Device uses 48-Bit Addressing:
ide_devices[count].sizeSize = *((unsigned int *) (ide_buf + ATA_IDENT_MAX_LBA_EXT ))[0];
else
// Note that Quafios is 32-Bit Operating System, So last 2 Words are ignored.
} else {
// Device uses CHS or 28-bit Addressing:
ide_devices[count].sizeSize = *((unsigned int *) (ide_buf + ATA_IDENT_MAX_LBA ))[0];
}
 
// (VIII) String indicates model of device (like Western Digital HDD and SONY DVD-RW...):
for(k = ATA_IDENT_MODEL0; k < (ATA_IDENT_MODEL+40); k += 2) {
ide_devices[count].modelModel[k - ATA_IDENT_MODEL] = ide_buf[ATA_IDENT_MODEL + k + 1];
ide_devices[count].modelModel[(k +1) - ATA_IDENT_MODEL1] = ide_buf[ATA_IDENT_MODEL + k];}
ide_devices[count].modelModel[40] = 0; // Terminate String.
 
count++;
Line 493 ⟶ 440:
// 4- Print Summary:
for (i = 0; i < 4; i++)
if (ide_devices[i].reservedReserved == 1) {
printk(" Found %s Drive %dGB - %s\n",
(const char *[]){"ATA", "ATAPI"}[ide_devices[i].typeType], /* Type */
ide_devices[i].sizeSize / 1024 / 1024 / 2, /* Size */
ide_devices[i].modelModel);
}
}
</syntaxhighlight>
</source>
== Read/Write From ATA Drive ==
 
Now we're moving to a slightly more advanced part, it is to read and write from/to an ATA drive.
===Read/Write From ATA Drive===
Now we are moving to a bit more advanced part, it is to read and write from/to an ATA Drive.
There is 3 ways of addressing a sector:
* CHS (Cylinder-Head-Sector): an old way of addressing sectors in ATA drives, I think all ATA-Drives drives should support this way of addressing.
* LBA28: Accessing a sector by its LBA Address. but the address should be 28-bit longLBA address. iAll thinkATA all ATA-Drivesdrives should support this way of addressing, the problem ofwith LBA28 Addressing is that it allows only toallows access 128GB fromto thebe ATA-Diskaccessed, so if ATA-Diskthe disk is morebigger than 128GB, it should support the LBA48 Feature Set.
* LBA48: Accessing a sector by its LBA Address. but the address should be 48-bit longLBA address. asAs we use integers in GCC, so our maximum address in this tutorial is 32-bit long, which allows accessing ana ATA-Drivedrive with a size of up to 2TB.
So we can conclude an algorithm to determine which type of Addressing we are going to use:
 
<pre>
So We can conclude an algorithm to determine which type of Addressing we are going to use:
if (No LBA support)
 
Use CHS.
Code:
else if (the LBA Sector Address > 0x0FFFFFFF)
If (Drive doesn't Support LBA)
// Use CHSLBA48.
else (if the LBA Sector Address > 0x0FFFFFFF)
// The Sector We are going to read is above 128GB Boundary, Use LBA48.
else
// Use LBA28.
</pre>
 
 
Reading the buffer may be done by polling or DMA.
PIO: After sending the command [Readto read or Writewrite Sectors]sectors, we read Data Port [as words], or write to the Data Port [(as words]). thisThis is the same way of reading identification space.
DMA: After sending the command, you should wait for an IRQ, while you are waiting, Buffer is written directly to memory automatically.
 
We are going to use PIO as it isn'tis going to beless complex, and i want to be far from IRQs as they are very slower than Polling after PIO.
 
We can conclude also this table:
<syntaxhighlight lang="c">
 
<source lang="c">
/* ATA/ATAPI Read/Write Modes:
* ++++++++++++++++++++++++++++++++
* Addressing Modes:
* ================
* - LBA28 Mode. (+)
* - LBA48 Mode. (+)
* - CHS. (+)
* Reading Modes:
Line 545 ⟶ 487:
* ================
* - IRQs
* - Polling Status (+) // Suitable for Singletasking
*/
</syntaxhighlight>
</source>
 
There is something needed to be expressed here, I have told before that Task-File is like that:
* Register 0: [Word] Data Register. [Readable & Writable](Read-Write).
* Register 1: [Byte] Error Register. [Readable](Read).
* Register 1: [Byte] Features Register. [Writable](Write).
* Register 2: [Byte] SECCOUNT0 Register. [Readable & Writable](Read-Write).
* Register 3: [Byte] LBA0 Register. [Readable & Writable](Read-Write).
* Register 4: [Byte] LBA1 Register. [Readable & Writable](Read-Write).
* Register 5: [Byte] LBA2 Register. [Readable & Writable](Read-Write).
* Register 6: [Byte] HDDEVSEL Register. [Readable & Writable](Read-Write).
* Register 7: [Byte] Command Register. [Writable](Write).
* Register 7: [Byte] Status Register. [Readable](Read).
So each register between 2 to 5 should be 8-bits long. Really each of them are 16-bits long.
 
So each one of Registers from 2 to 5 should be 8-bits long. but really each one of them is 16-bit long.
 
* Register 2: [Bits 0-7] SECCOUNT0, [Bits 8-15] SECOUNT1
* Register 3: [Bits 0-7] LBA0, [Bits 8-15] LBA3
* Register 4: [Bits 0-7] LBA1, [Bits 8-15] LBA4
* Register 5: [Bits 0-7] LBA2, [Bits 8-15] LBA5
The word [(SECCOUNT1 << 8) | SECCOUNT0] expresses the number of sectors which can be read when you access by LBA48.
 
The word [(SECCOUNT1<<8) | SECCOUNT0] expresses number of sectors which can be read when you access by LBA48.
When you access in CHS or LBA28, SECCOUNT0 only expresses number of sectors.
* LBA0 makes up bits 0 : 7 of the LBA address when you read in LBA28 or LBA48; it can also be the sector number of CHS.
* LBA1 makes up bits 8 : 15 of the LBA address when you read in LBA28 or LBA48; it can also be the low byte of the cylinder number of CHS.
* LBA2 makes up bits 16 : 23 of the LBA address when you read in LBA28 or LBA48; it can also be the high byte of the cylinder number of CHS.
* LBA3 makes up bits 24 : 31 of the LBA48 address.
* LBA4 makes up bits 32 : 39 of the LBA48 address.
* LBA5 makes up bits 40 : 47 of LBA48 address.
Notice that the LBA0, 1 and 2 registers are 24 bits long in total, which is not enough for LBA28; the higher 4-bits can be written to the lower 4-bits of the HDDEVSEL register.
 
Also notice that if bit 6 of this register is set, we are going to use LBA, if not, we are going to use CHS. There is a mode which is called extended CHS.
* LBA0 is Bits[0-7] of LBA Address when you read in LBA28 or LBA48, it can be sector number of CHS.
* LBA1 is Bits[8-15] of LBA Address when you read in LBA28 or LBA48, it can be low 8 bits of cylinder number of CHS.
* LBA2 is Bits[16-23] of LBA Address when you read in LBA28 or LBA48, it can be high 8 bits of cylinder number of CHS.
* LBA3 is Bits[24-31] of LBA Address when you read in LBA48.
* LBA4 is Bits[32-39] of LBA Address when you read in LBA48.
* LBA5 is Bits[40-47] of LBA Address when you read in LBA48.
 
Notice that according to that, LBA0,1,2 registers [8-bits + 8-bits + 8-bits] are 24-bit long, which is not enough for LBA28, so the higher 4-bits can be written to the lower 4-bits of HDDEVSEL Register.
 
Also notice that if we set bit 6 of this register, we are going to use LBA, if not, we are going to use CHS.
notice that there is a mode which is called extended CHS, but i don't wanna be exposed to that.
 
 
Lets go into the code:
<syntaxhighlight lang="c">
 
<source lang="c">
unsigned char ide_ata_access(unsigned char direction, unsigned char drive, unsigned int lba,
unsigned char numsects, unsigned short selector, unsigned int edi) {
</syntaxhighlight>
</source>
This function reads/writes sectors from ATA-Drive. If direction is 0 we are reading, else we are writing.
 
* drive is the drive number which can be from 0 to 3.
This Function reads/writes sectors from ATA-Drive. if (direction = 0) so we are reading, else we are writing.
* drive,lba is drivethe numberLBA address which canallows us to beaccess fromdisks 0up to 32TB.
* numsects is the number of sectors to be read, it is a char, as reading more than 256 sector immediately may performance issues. If numsects is 0, the ATA controller will know that we want 256 sectors.
* lba, is the LBA Address which allows us to access disks up to 2TB.
* selector is the segment selector to read from, or write to.
* numsects, number of sectors to be read, it is a char, as reading more than 256 sector immediately may cause the OS to hang. notice that if numsects = 0, controller will know that we want 256 sectors.
* selector,edi is the offset in that segment. selector(the tomemory readaddress from,for orthe writedata to.buffer)
<syntaxhighlight lang="c">
* edi, offset in the segment.
 
<source lang="c">
unsigned char lba_mode /* 0: CHS, 1:LBA28, 2: LBA48 */, dma /* 0: No DMA, 1: DMA */, cmd;
unsigned char lba_io[6];
unsigned int channel = ide_devices[drive].channelChannel; // Read the Channel.
unsigned int slavebit = ide_devices[drive].driveDrive; // Read the Drive [Master/Slave]
unsigned int bus = channels[channel].baseBase; // Bus Base, like 0x1F0 which is also data port.
unsigned int words = 256; // ApproximatelyAlmost allevery ATA-Drives drive has a sector-size of 512-byte.
unsigned short cyl, i; unsigned char head, sect, err;
unsigned char head, sect, err;
</source>
</syntaxhighlight>
 
We don't need IRQs, so we should disable it to disallowprevent problems tofrom happen,happening. weWe said before that if bit 1 of the Control Register (Whichwhich is called nIEN bit), if it is set, so no IRQs will be invoked from any drives on this channel, either from Master Drivemaster or from Slave Driveslave.
<syntaxhighlight lang="c">
 
<source lang="c">
ide_write(channel, ATA_REG_CONTROL, channels[channel].nIEN = (ide_irq_invoked = 0x0) + 0x02);
</syntaxhighlight>
</source>
 
Now lets read the parameters:
<syntaxhighlight lang="c">
 
<source lang="c">
// (I) Select one from LBA28, LBA48 or CHS;
if (lba >= 0x10000000) { // Sure Drive should support LBA in this case, or you are
Line 622 ⟶ 550:
// LBA48:
lba_mode = 2;
lba_io[0] = (lba & 0x000000FF) >> 0;
lba_io[1] = (lba & 0x0000FF00) >> 8;
lba_io[2] = (lba & 0x00FF0000) >> 16;
lba_io[3] = (lba & 0xFF000000) >> 24;
lba_io[4] = 0; // We said that we lbaLBA28 is integer, so 32-bitbits are enough to access 2TB.
lba_io[5] = 0; // We said that we lbaLBA28 is integer, so 32-bitbits are enough to access 2TB.
head = 0; // Lower 4-bits of HDDEVSEL are not used here.
} else if (ide_devices[drive].capabilitiesCapabilities & 0x200) { // Drive supports LBA?
// LBA28:
lba_mode = 1;
lba_io[0] = (lba & 0x00000FF) >> 0;
lba_io[1] = (lba & 0x000FF00) >> 8;
lba_io[2] = (lba & 0x0FF0000) >> 16;
lba_io[3] = 0; // These Registers are not used here.
lba_io[4] = 0; // These Registers are not used here.
lba_io[5] = 0; // These Registers are not used here.
head = (lba & 0xF000000) >> 24;
} else {
// CHS:
lba_mode = 0;
sect = (lba % 63) + 1;
cyl = (lba + 1 - sect) / (16 * 63);
lba_io[0] = sect;
lba_io[1] = (cyl >> 0) & 0xFF;
lba_io[2] = (cyl >> 8) & 0xFF;
lba_io[3] = 0;
lba_io[4] = 0;
lba_io[5] = 0;
head = (lba + 1 - sect) % (16 * 63) / (63); // Head number is written to HDDEVSEL lower 4-bits.
}
</syntaxhighlight>
</source>
 
Now we are going to choose the way of reading the buffer [PIO or DMA]:
<syntaxhighlight lang="c">
 
// (II) See if drive supports DMA or not;
<source lang="c">
dma = 0; // (II)We Seedon't if Drive Supportssupport DMA or not;
</syntaxhighlight>
dma = 0; // Supports or doesn't, we don't support !!!
Lets poll the Status port while the channel is busy:
</source>
<syntaxhighlight lang="c">
 
Lets Poll the status port if the channel is busy:
 
<source lang="c">
// (III) Wait if the drive is busy;
while (ide_read(channel, ATA_REG_STATUS) & ATA_SR_BSY);{ // Wait if Busy.
</source>
} // Wait if busy.
 
</syntaxhighlight>
HDDDEVSEL Register now looks like this:
The HDDDEVSEL register now looks like this:
 
* Bits 0- : 3: Head Number for CHS.
* Bit 4: Slave Bit. (0: Selecting Master Drive, 1: Selecting Slave Drive).
* Bit 5: Obsolete and isn't used, but should be set.
* Bit 6: LBA (0: CHS, 1: LBA).
* Bit 7: Obsolete and isn't used, but should be set.
 
Lets write all these information to the register, while the obsolete bits are set (0xA0):
<syntaxhighlight lang="c">
 
<source lang="c">
// (IV) Select Drive from the controller;
if (lba_mode == 0)
if (lba_mode==0) ide_write(channel,ATA_REG_HDDEVSEL,0xA0|(slavebit<<4)|head); // Drive & CHS.
else ide_write(channel, ATA_REG_HDDEVSEL,0xE0 0xA0 | (slavebit << 4) | head); // Drive & LBACHS.
else
</source>
ide_write(channel, ATA_REG_HDDEVSEL, 0xE0 | (slavebit << 4) | head); // Drive & LBA
 
</syntaxhighlight>
Let's write the parameters to registers:
<syntaxhighlight lang="c">
 
<source lang="c">
// (V) Write Parameters;
if (lba_mode == 2) {
Line 698 ⟶ 620:
ide_write(channel, ATA_REG_LBA1, lba_io[1]);
ide_write(channel, ATA_REG_LBA2, lba_io[2]);
</syntaxhighlight>
</source>
If you are using LBA48 and want to write to the LBA0 and LBA3 registers, you should write LBA3 to Register 3, then write LBA0 to Register 3. ide_write function makes it quite simple, refer to the function and you will fully understand the code.
 
By this way, if you are using LBA48 and want to write to LBA0 Register [Register 3 in Task-File], and want to write to LBA3 Register [Register 3 also in Task-File], you should write LBA3 to Register 3, then write LBA0 to Register 3. ide_write function makes it quite simple, refer to the function and you will full-understand the code.
 
Now, we have a great set of commands described in ATA/ATAPI-8 Specification, we should choose the suitable command to execute:
<syntaxhighlight lang="c">
 
<source lang="c">
// (VI) Select the command and send it;
// Routine that is followed:
Line 713 ⟶ 633:
// If (!DMA & LBA28) DO_PIO_LBA;
// If (!DMA & !LBA#) DO_PIO_CHS;
</syntaxhighlight>
</source>
There isn't a command for doing CHS with DMA.
 
<syntaxhighlight lang="c">
There isn't a command for Doing in CHS with DMA.
 
<source lang="c">
if (lba_mode == 0 && dma == 0 && direction == 0) cmd = ATA_CMD_READ_PIO;
if (lba_mode == 1 && dma == 0 && direction == 0) cmd = ATA_CMD_READ_PIO;
Line 731 ⟶ 649:
if (lba_mode == 2 && dma == 1 && direction == 1) cmd = ATA_CMD_WRITE_DMA_EXT;
ide_write(channel, ATA_REG_COMMAND, cmd); // Send the Command.
</syntaxhighlight>
</source>
This ATA_CMD_READ_PIO command is used for reading in LBA28 or CHS, and the IDE controller refers to bit 6 of the HDDEVSEL register to find out the mode of reading (LBA or CHS).
 
This Command "ATA_CMD_READ_PIO" is right for reading in LBA28 or CHS, and controller refers to bit 6 of HDDEVSEL Register to know the mode of reading (LBA or CHS).
 
After sending the command, we should poll, then we read/write a sector then we should poll, then we read/write a sector, until we read/write all sectors needed, if an error is happened, we the function will return a specific error code.
 
After sending the command, we should poll, then we read/write a sector, then we should poll, then we read/write a sector, until we read/write all sectors needed, if an error has happened, the function will return a specific error code.
Notice that after writing, we should execute the CACHE FLUSH Command, and we should poll after it, but without checking for errors.
 
Notice that after writing, we should execute the CACHE FLUSH command, and we should poll after it, but without checking for errors.
<source lang="c">
<syntaxhighlight lang="c">
if (dma)
if (direction == 0);
// DMA Read.
else; // DMA Write.
// DMA Write.
else
if (direction == 0)
// PIO Read.
for (i = 0; i < numsects; i++) {
if (err = ide_polling(channel, 1)) return err; // Polling, set error and exit if there is.
return err; // Polling, set error and exit if there is.
asm("pushw %es");
asm("mov %%ax, %%es" : : "a"(selector));
asm("rep insw" : : "c"(words), "d"(bus), "D"(edi)); // Receive Data.
asm("popw %es");
edi += (words*2);
} else {
// PIO Write.
for (i = 0; i < numsects; i++) {
ide_polling(channel, 0); // Polling.
asm("pushw %ds");
asm("mov %%ax, %%ds"::"a"(selector));
asm("rep outsw"::"c"(words), "d"(bus), "S"(edi)); // Send Data
asm("popw %ds");
edi += (words*2);
}
ide_write(channel, ATA_REG_COMMAND, (char []) { ATA_CMD_CACHE_FLUSH,
ATA_CMD_CACHE_FLUSH,
ATA_CMD_CACHE_FLUSH_EXT}[lba_mode]);
ide_polling(channel, 0); // Polling.
}
 
return 0; // Easy, ... Isnisn't it?
}
</syntaxhighlight>
</source>
== Reading from an ATAPI Drive ==
Let's move to an easier part - reading from an ATAPI drive. I will not make the function that writes to an ATAPI drive, because writing to it is very complex and is outside of the scope of this tutorial.
 
An ATAPI drive is different from an ATA drive, as it uses the SCSI command set instead of the ATA command set. Parameters are sent as packets, therefore it's called the ATA Packet Interface [ATAPI].
===Read From ATAPI Drive===
Let's move to a part which is quite easier, it is to read from ATAPI Drive, i will not make the function write to ATAPI Drive, because the write Operation is very complex and it should done by third-party tools (like Nero in Windows, and Brasero in Linux).
 
Notice also that ATAPI drives always use IRQs and you can't disable them. We should create a function that waits for an IRQ:
ATAPI Drive is different from ATA Drives, as it doesn't use ATA Commands, but it use the SCSI-Command-Set. Parameters are sent into a Packet, so it is Called: ATA-Packet Interface [ATAPI].
<syntaxhighlight lang="c">
 
Notice also that ATAPI drives should always use IRQs, you can't disable them, so we should create a function which waits for an IRQ to be caused:
 
<source lang="c">
void ide_wait_irq() {
while (!ide_irq_invoked);
;
ide_irq_invoked = 0;
}
</syntaxhighlight>
</source>
When an IRQ happens, the following function should be executed by ISR:
 
<syntaxhighlight lang="c">
when an IRQ happens, the following function should be executed by ISR:
 
<source lang="c">
void ide_irq() {
ide_irq_invoked = 1;
}
</syntaxhighlight>
</source>
ide_wait_irq will go into a while loop, which waits for the variable ide_irq_invoked to be set, then clears it.
 
<syntaxhighlight lang="c">
by this way, ide_wait_irq() will go into a while loop, which waits for the variable ide_irq_invoked to be set, then clears it.
 
<source lang="c">
unsigned char ide_atapi_read(unsigned char drive, unsigned int lba, unsigned char numsects,
unsigned short selector, unsigned int edi) {
</syntaxhighlight>
</source>
* drive is the drive number, which is from 0 to 3.
 
* drive,lba is the driveLBA number, which is from 0 to 3address.
* numsects is the number of sectors. It should always be 1, and if you want to read more than one sector, re-execute this function with th updated LBA address.
* lba, the lba address.
* selector is the Segment Selector.
* numsects, number of sectors, it should always be 1, and if you wanna read more than one sector, re-execute this function with updated LBA address.
* edi is the offset in the selector.
* selector, Segment Selector.
* edi, offset in the selector.
 
Let's read the parameters of the drive:
<syntaxhighlight lang="c">
 
unsigned int channel = ide_devices[drive].Channel;
<source lang="c">
unsigned int channel slavebit = ide_devices[drive].channelDrive;
unsigned int slavebitbus = ide_deviceschannels[drivechannel].driveBase;
unsigned int buswords = 1024; =// channels[channel]Sector Size. ATAPI drives have a sector size of 2048 bytes.base;
unsigned char err;
unsigned int words = 1024; // Sector Size. ATAPI Drives has a sector size of 2048 bytes.
unsigned char err; int i;
</syntaxhighlight>
</source>
 
We need IRQs:
<syntaxhighlight lang="c">
 
<source lang="c">
// Enable IRQs:
ide_write(channel, ATA_REG_CONTROL, channels[channel].nIEN = ide_irq_invoked = 0x0);
</syntaxhighlight>
</source>
Let's setup the SCSI Packet, which is 6 words (12 bytes) long:
 
<syntaxhighlight lang="c">
Let's setup the SCSI Packet, Which is 6-Words long [12-Bytes]:
 
<source lang="c">
// (I): Setup SCSI Packet:
// ------------------------------------------------------------------
atapi_packet[ 0] = ATAPI_CMD_READ;
atapi_packet[ 1] = 0x0;
atapi_packet[ 2] = (lba >> 24) & 0xFF;
atapi_packet[ 3] = (lba >> 16) & 0xFF;
atapi_packet[ 4] = (lba >> 8) & 0xFF;
atapi_packet[ 5] = (lba >> 0) & 0xFF;
atapi_packet[ 6] = 0x0;
atapi_packet[ 7] = 0x0;
Line 843 ⟶ 750:
atapi_packet[10] = 0x0;
atapi_packet[11] = 0x0;
</syntaxhighlight>
</source>
 
Now we should select the drive:
<syntaxhighlight lang="c">
 
// (II): Select the drive:
<source lang="c">
// (II): Select the Drive:
// ------------------------------------------------------------------
ide_write(channel, ATA_REG_HDDEVSEL, slavebit << 4);
</syntaxhighlight>
</source>
 
400 nanoseconds delay after this select is a good idea:
<syntaxhighlight lang="c">
 
<source lang="c">
// (III): Delay 400 nanoseconds for select to complete:
// ------------------------------------------------------------------
for(int i = 0; i < 4; i++)
ide_read(channel, ATA_REG_ALTSTATUS); // Reading Alternate Status Port wastes 100ns.
ide_read(channel, ATA_REG_ALTSTATUS); // Reading the Alternate Status Portport wastes 100ns.
</syntaxhighlight>
ide_read(channel, ATA_REG_ALTSTATUS); // Reading Alternate Status Port wastes 100ns.
<syntaxhighlight lang="c">
ide_read(channel, ATA_REG_ALTSTATUS); // Reading Alternate Status Port wastes 100ns.
</source>
 
<source lang="c">
// (IV): Inform the Controller that we use PIO mode:
// ------------------------------------------------------------------
ide_write(channel, ATA_REG_FEATURES, 0); // PIO mode.
</syntaxhighlight>
</source>
Tell the controller the size of the buffer
 
<syntaxhighlight lang="c">
Controller wants to know what do we think of the size of buffer!, we will allow him to know that:
 
<source lang="c">
// (V): Tell the Controller the size of buffer:
// ------------------------------------------------------------------
ide_write(channel, ATA_REG_LBA1, (words * 2) & 0xFF); // Lower Byte of Sector Size.
ide_write(channel, ATA_REG_LBA2, (words * 2) >> 8); // Upper Byte of Sector Size.
</syntaxhighlight>
</source>
Now that we want to send the packet, we should first send the command "Packet":
 
<syntaxhighlight lang="c">
Now we want to send the packet, we should first send the command "Packet":
 
<source lang="c">
// (VI): Send the Packet Command:
// ------------------------------------------------------------------
ide_write(channel, ATA_REG_COMMAND, ATA_CMD_PACKET); // Send the Command.
</source>
 
// (VII): Waiting for the driver to finish or return an error code:
<source lang="c">
// (VII): Waiting for the driver to finish or invoke an error:
// ------------------------------------------------------------------
if (err = ide_polling(channel, 1)) return err; // Polling and return if error.
</source>
 
<source lang="c">
// (VIII): Sending the packet data:
// ------------------------------------------------------------------
asm("rep outsw" : : "c"(6), "d"(bus), "S"(atapi_packet)); // Send Packet Data
</syntaxhighlight>
</source>
Here we cannot poll. We should wait for an IRQ, then read the sectors. These two operations should be repeated for each sector.
 
<syntaxhighlight lang="c">
Here we cannot Poll, We should wait for an IRQ, then read the sectors. these two operations should be repeated as the number of sectors, but we are said before that numsects should be 1. But I have put a for loop, i don't know why.
 
<source lang="c">
// (IX): Receiving Data:
// ------------------------------------------------------------------
for (i = 0; i < numsects; i++) {
ide_wait_irq(); // Wait for an IRQ.
if (err = ide_polling(channel, 1)) return err; // Polling and return if error.
return err; // Polling and return if error.
asm("pushw %es");
asm("mov %%ax, %%es"::"a"(selector));
asm("rep insw"::"c"(words), "d"(bus), "D"(edi));// Receive Data.
asm("popw %es");
edi += (words * 2);
}
</syntaxhighlight>
</source>
Now we should wait for an IRQ and poll until the Busy and DRQ bits are clear:
 
<syntaxhighlight lang="c">
Now we should wait for an IRQ and Poll for Busy and DRQ bits to be clear:
 
<source lang="c">
// (X): Waiting for an IRQ:
// ------------------------------------------------------------------
Line 924 ⟶ 813:
// (XI): Waiting for BSY & DRQ to clear:
// ------------------------------------------------------------------
while (ide_read(channel, ATA_REG_STATUS) & (ATA_SR_BSY | ATA_SR_DRQ));
;
 
return 0; // Easy, ... Isn't it?
}
</syntaxhighlight>
</source>
== Reading from an ATA/ATAPI Drive ==
 
<syntaxhighlight lang="c">
===Standard Function For Reading from ATA/ATAPI Drive===
<source lang="c">
void ide_read_sectors(unsigned char drive, unsigned char numsects, unsigned int lba,
unsigned short es, unsigned int edi) {
Line 937 ⟶ 826:
// 1: Check if the drive presents:
// ==================================
if (drive > 3 || ide_devices[drive].reservedReserved == 0) package[0] = 0x1; // Drive Not Found!
 
// 2: Check if inputs are valid:
// ==================================
else if (((lba + numsects) > ide_devices[drive].sizeSize) && (ide_devices[drive].typeType == IDE_ATA))
package[0] = 0x2; // Seeking to invalid position.
 
Line 948 ⟶ 837:
else {
unsigned char err;
if (ide_devices[drive].typeType == IDE_ATA)
err = ide_ata_access(ATA_READ, drive, lba, numsects, es, edi);
else if (ide_devices[drive].typeType == IDE_ATAPI)
for (i = 0; i < numsects; i++)
err = ide_atapi_read(drive, lba + i, 1, es, edi + (i*2048));
Line 956 ⟶ 845:
}
}
// package[0] is an entry of an array,. thisIt entry specifiescontains the Error Code, you can replace that.
</syntaxhighlight>
</source>
== Writing to an ATA drive ==
 
<syntaxhighlight lang="c">
===Standard Function to write to ATA Drive===
<source lang="c">
void ide_write_sectors(unsigned char drive, unsigned char numsects, unsigned int lba,
unsigned short es, unsigned int edi) {
Line 966 ⟶ 854:
// 1: Check if the drive presents:
// ==================================
if (drive > 3 || ide_devices[drive].reservedReserved == 0) package[0] = 0x1; // Drive Not Found!
package[0] = 0x1; // Drive Not Found!
// 2: Check if inputs are valid:
// ==================================
else if (((lba + numsects) > ide_devices[drive].sizeSize) && (ide_devices[drive].typeType == IDE_ATA))
package[0] = 0x2; // Seeking to invalid position.
// 3: Read in PIO Mode through Polling & IRQs:
Line 975 ⟶ 864:
else {
unsigned char err;
if (ide_devices[drive].typeType == IDE_ATA)
err = ide_ata_access(ATA_WRITE, drive, lba, numsects, es, edi);
else if (ide_devices[drive].typeType == IDE_ATAPI)
err = 4; // Write-Protected.
package[0] = ide_print_error(drive, err);
}
}
</syntaxhighlight>
</source>
== Ejecting an ATAPI Drive ==
 
<syntaxhighlight lang="c">
===Standard Function to eject ATAPI Drive===
<source lang="c">
void ide_atapi_eject(unsigned char drive) {
unsigned int channel = ide_devices[drive].channelChannel;
unsigned int slavebit = ide_devices[drive].driveDrive;
unsigned int bus = channels[channel].baseBase;
unsigned int words = 2048 / 2; // Sector Size in Words.
unsigned char err = 0;
Line 996 ⟶ 884:
// 1: Check if the drive presents:
// ==================================
if (drive > 3 || ide_devices[drive].reservedReserved == 0) package[0] = 0x1; // Drive Not Found!
package[0] = 0x1; // Drive Not Found!
// 2: Check if drive isn't ATAPI:
// ==================================
else if (ide_devices[drive].typeType == IDE_ATA) package[0] = 20; // Command Aborted.
package[0] = 20; // Command Aborted.
// 3: Eject ATAPI Driver:
// ============================================
Line 1,023 ⟶ 913:
// (II): Select the Drive:
// ------------------------------------------------------------------
ide_write(channel, ATA_REG_HDDEVSEL, slavebit << 4);
 
// (III): Delay 400 nanosecond for select to complete:
// ------------------------------------------------------------------
for(int i = 0; i < 4; i++)
ide_read(channel, ATA_REG_ALTSTATUS); // Reading Alternate Status Port wastes 100ns.
ide_read(channel, ATA_REG_ALTSTATUS); // Reading Alternate Status Port wastes 100ns.
ide_read(channel, ATA_REG_ALTSTATUS); // Reading Alternate Status Port wastes 100ns.
ide_read(channel, ATA_REG_ALTSTATUS); // Reading Alternate Status Port wastes 100ns.
 
// (IV): Send the Packet Command:
Line 1,038 ⟶ 926:
// (V): Waiting for the driver to finish or invoke an error:
// ------------------------------------------------------------------
if (err = ide_polling(channel, 1)); // Polling and stop if error.
 
// (VI): Sending the packet data:
Line 1,049 ⟶ 937:
}
package[0] = ide_print_error(drive, err); // Return;
 
}
}
</syntaxhighlight>
</source>
When this method is invoked, the optical device on the given channel is ejected.
 
== See Also ==
Now you can have your ODD is ejected:
=== Wiki Pages ===
 
* [[MBR_(x86)|Master Boot Record (x86)]]
[[Image:ODD-Eject.jpg‎]]
* [[Partition_Table|Partition Table (x86)]]
 
==See= AlsoThreads ===
* [http://www.osdev.org/phpBB2/viewtopic.php?t=12268 How to w/r harddisk in pmode? (ASM Code from Dex)]
===Threads===
* [http://www.osdev.org/phpBB2/viewtopic.php?t=1226815314 HowATA toPIO w/rcode harddisk in pmode?library (ASM Codecode from DexXCHG)]
* [http://wwwforum.osdev.org/phpBB2/viewtopic.php?tf=153141&p=167798#p167798 ATA PIO codeIDE libraryTutorial (ASMC code from XCHG''mostafazizo'')]
=== External Links ===
*[http://forum.osdev.org/viewtopic.php?f=1&p=167798#p167798 IDE Tutorial (C code from ''mostafazizo'')]
* [http://www.t13.org T13] -- The group that creates the ATA standard
 
* [http://www.ata-atapi.com ATA-ATAPI] -- Public Domain C driver sources (including SATA, Busmatering DMA, ATAPI), fairly good.
===External Links===
* [http://wwwhddguru.t13.orgcom/content/en/documentation/ HDD Guru] -- T13,The actual ATA specs from the groupfirst one that createswas released in 1994 to the ATA7th standardone in 2003.
* [http://www.ranish.com/part/primer.htm Partitioning Primer] -- A .HTM file containing some information about partitioning.
* http://www.ata-atapi.com -- Public Domain C driver sourcecode, including SATA, Busmatering DMA, ATAPI -- not perfect, but good.
* [http://www.bswd.com/pciide.pdf PCI IDE Controller Specification] -- Specification containing information on "compatibility mode" and "PCI native mode" (and switching between them)
 
* [http://bswd.com/idems100.pdf Programming Interface for Bus Master IDE Controller] -- Bus Master IDE specification
[[Category:ATA]]
[[Category:Storage]]
[[de:AT Attachment]]
40

edits