Descrição

Esta página descreve a interface IdeController que fornece serviços de um controlador IDE.

Estruturas

typedef struct {
    unsigned char port;
    unsigned char data;
} IdeController_RequestPort;

typedef struct {
    unsigned int version;
    unsigned int interface;
    unsigned int drive;
    unsigned int timeout;
    int flags;
    unsigned int numIOs;
    unsigned char status;
    unsigned char error;
    IdeController_RequestPort IOs[1];
} IdeController_Request;

Onde version é a versão da estrutura (versão 1), interface é a interface, drive o drive, timeout a quantidade de segundos antes de desistir do pedido, flags controlam o pedido e pode ser 0 ou a soma de:

• IdeController_PROBE_MODE - É um pedido feito para um drive que pode não existir
• IdeController_START_MULTISECTOR - É o começo de um pedido multisetor
• IdeController_ONE_SECTOR - É um pedido de um setor apenas
• IdeController_CONT_MULTISECTOR - Continuação de um pedido multisetor
• IdeController_END_MULTISECTOR - Término de um pedido multisetor

status e error conterão o byte de status e error respectivamente no retorno.

numIOs é o tamanho do array IO que contém as portas de IO e os dados a serem escritos nessas portas.

As portas de IO presentes em IO serão escritas de IO[0] até IO[numIOs-1] nessa ordem.

port tem que conter um dos seguintes valores:

• IdeController_FEATURE_PORT - Porta de feature
• IdeController_SECTOR_COUNT_PORT - Porta do contador de setores
• IdeController_SECTOR_NUMBER_PORT - Porta do número do setor
• IdeController_LOW_CYL_PORT - Porta do n&umero do cilindro (parte baixa)
• IdeController_HIGH_CYL_PORT - Porta do n&umero do cilindro (parte alta)
• IdeController_DRIVE_PORT - Porta do drive/cabeça. Os dados só devem conter a informação sobre a cabeça. Os outros bits serão definidos pelo IdeController.
• IdeController_COMMAND_PORT - Porta do comando

typedef struct {
    unsigned int version;
    unsigned int interface;
    unsigned int drive;
    int flags;
} IdeController_Setup;

Onde version é a versão da estrutura (versão 1), interface é a interface, drive o drive e flags tem que ser 0 ou a soma de:

• IdeController_SETUP_LBA - indica se LBA está ativo para o drive.

Estas funções são de uso exclusivo dos módulos do sistema.

0x00 - GetDrive

Sintaxe

int IdeController_GetDrive(unsigned int interface, unsigned int drive);

Propriedades

• Do sistema
• Fase 1

Descrição

Esta função obtém drive da interface para uso exclusivo do módulo chamador.

drive e interface começam em zero.

Para liberar drive use PutDrive.

Valor de retorno

• E_OK - Sucesso
• E_BUG - A especificação da interface não foi atendida
• E_BUSY - Drive já está sendo usado por um módulo
• E_NO_SUCH_INTERFACE - A interface não existe
• E_NO_SUCH_DRIVE - O drive não existe

0x01 - LockInterface

Sintaxe

int IdeController_LockInterface(unsigned int interface);

Propriedades

• Do sistema
• Fase 1

Descrição

Esta função trava interface para uso exclusivo pelo módulo.

A linha de execução chamadora fica bloqueada até obter o uso exclusivo.

interface começa em zero.

Antes de uma interface IDE ser usada em qualquer função da IdeController ela tem que ser travada para uso exclusivo via LockInterface.

Para destravar use UnlockInterface.

Valor de retorno

• E_OK - Sucesso
• E_BUG - A especificação da interface não foi atendida
• E_NO_SUCH_INTERFACE - A interface não existe
• E_INTERRUPTED - Operação interrompida

0x02 - PutDrive

Sintaxe

int IdeController_PutDrive(unsigned int interface, unsigned int drive);

Propriedades

• Do sistema
• Fase 1

Descrição

Esta função libera drive da interface.

drive e interface começam em zero.

Se drive não tiver sido obtido nada acontece e a função retorna sucesso.

Valor de retorno

• E_OK - Sucesso
• E_BUG - A especificação da interface não foi atendida
• E_NO_SUCH_INTERFACE - A interface não existe
• E_NO_SUCH_DRIVE - O drive não existe

0x03 - ReadData

Sintaxe

int IdeController_ReadData(unsigned int interface, void *buf, unsigned int size);

Propriedades

• Do sistema
• Fase 1

Descrição

Esta função lê size bytes da interface e os coloca em buf.

interface começa em zero.

Valor de retorno

• E_OK - Sucesso
• E_BUG - A especificação da interface não foi atendida
• E_NO_SUCH_INTERFACE - A interface não existe

0x04 - SendRequest

Sintaxe

int IdeController_SendRequest(IdeController_Request *rq);

Propriedades

• Do sistema
• Fase 1

Descrição

Esta função processa o pedido rq.

Valor de retorno

• E_OK - Sucesso
• E_BUG - A especificação da interface não foi atendida
• E_NO_SUCH_INTERFACE - A interface não existe
• E_NO_SUCH_DRIVE - O drive não existe
• E_TIMED_OUT - Tempo limite atingido
• E_INVALID_VERSION - Versão da estrutura não suportada
• E_PROBE_FAILED - IdeController_PROBE_MODE foi usado e o teste falhou
• E_IO_ERROR - Erro indefinido de entrada/saída

0x05 - SetupDrive

Sintaxe

int IdeController_SetupDrive(const IdeController_Setup *set);

Propriedades

• Do sistema
• Fase 1

Descrição

Esta função configura o drive de acordo com set.

Valor de retorno

• E_OK - Sucesso
• E_BUG - A especificação da interface não foi atendida
• E_NO_SUCH_INTERFACE - A interface não existe
• E_NO_SUCH_DRIVE - O drive não existe
• E_INVALID_VERSION - Versão da estrutura não suportada

0x06 - UnlockInterface

Sintaxe

int IdeController_UnlockInterface(unsigned int interface);

Propriedades

• Do sistema
• Fase 1

Descrição

Esta função destrava interface.

interface começa em zero.

Valor de retorno

• E_OK - Sucesso
• E_BUG - A especificação da interface não foi atendida
• E_NO_SUCH_INTERFACE - A interface não existe

0x07 - WriteData

Sintaxe

int IdeController_WriteData(unsigned int interface, const void *buf, unsigned int size);

Propriedades

• Do sistema
• Fase 1

Descrição

Esta função escreve size bytes de buf na interface.

interface começa em zero.

Valor de retorno

• E_OK - Sucesso
• E_BUG - A especificação da interface não foi atendida
• E_NO_SUCH_INTERFACE - A interface não existe