readwrite.c File Reference

#include "i8042prt.h"
#include <debug.h>

Include dependency graph for readwrite.c:

Go to the source code of this file.

Functions
VOID	i8042Flush (IN PPORT_DEVICE_EXTENSION DeviceExtension)
BOOLEAN	i8042IsrWritePort (IN PPORT_DEVICE_EXTENSION DeviceExtension, IN UCHAR Value, IN UCHAR SelectCmd OPTIONAL)
NTSTATUS	i8042ReadData (IN PPORT_DEVICE_EXTENSION DeviceExtension, IN UCHAR StatusFlags, OUT PUCHAR Data)
NTSTATUS	i8042ReadStatus (IN PPORT_DEVICE_EXTENSION DeviceExtension, OUT PUCHAR Status)
NTSTATUS	i8042ReadDataWait (IN PPORT_DEVICE_EXTENSION DeviceExtension, OUT PUCHAR Data)
NTSTATUS NTAPI	i8042SynchReadPort (IN PVOID Context, OUT PUCHAR Value, IN BOOLEAN WaitForAck)
NTSTATUS NTAPI	i8042SynchWritePort (IN PPORT_DEVICE_EXTENSION DeviceExtension, IN UCHAR Port, IN UCHAR Value, IN BOOLEAN WaitForAck)
BOOLEAN	i8042Write (IN PPORT_DEVICE_EXTENSION DeviceExtension, IN PUCHAR addr, IN UCHAR data)

Function Documentation

i8042Flush()

VOID i8042Flush

(

IN PPORT_DEVICE_EXTENSION

DeviceExtension

)

Definition at line 21 of file readwrite.c.

{
    UCHAR Ignore;
 
    /* Flush output buffer */
    while (NT_SUCCESS(i8042ReadData(DeviceExtension, KBD_OBF /* | MOU_OBF*/, &Ignore))) {
        KeStallExecutionProcessor(50);
        TRACE_(I8042PRT, "Output data flushed\n");
    }
 
    /* Flush input buffer */
    while (NT_SUCCESS(i8042ReadData(DeviceExtension, KBD_IBF, &Ignore))) {
        KeStallExecutionProcessor(50);
        TRACE_(I8042PRT, "Input data flushed\n");
    }
}

Referenced by EnableInterrupts(), i8042BasicDetect(), and i8042DetectMouse().

i8042IsrWritePort()

BOOLEAN i8042IsrWritePort	(	IN PPORT_DEVICE_EXTENSION	DeviceExtension,
		IN UCHAR	Value,
		IN UCHAR SelectCmd	OPTIONAL
	)

Definition at line 40 of file readwrite.c.

{
    if (SelectCmd)
        if (!i8042Write(DeviceExtension, DeviceExtension->ControlPort, SelectCmd))
            return FALSE;
 
    return i8042Write(DeviceExtension, DeviceExtension->DataPort, Value);
}

Referenced by i8042DetectMouse(), i8042MouInitialize(), i8042MouIsrWritePort(), and StartProcedure().

i8042ReadData()

NTSTATUS i8042ReadData	(	IN PPORT_DEVICE_EXTENSION	DeviceExtension,
		IN UCHAR	StatusFlags,
		OUT PUCHAR	Data
	)

Definition at line 56 of file readwrite.c.

{
    UCHAR PortStatus;
    NTSTATUS Status;
 
    Status = i8042ReadStatus(DeviceExtension, &PortStatus);
    if (!NT_SUCCESS(Status))
        return Status;
 
    // If data is available
    if (PortStatus & StatusFlags)
    {
        *Data = READ_PORT_UCHAR(DeviceExtension->DataPort);
        INFO_(I8042PRT, "Read: 0x%02x (status: 0x%x)\n", Data[0], PortStatus);
 
        // If the data is valid (not timeout, not parity error)
        if ((PortStatus & KBD_PERR) == 0)
            return STATUS_SUCCESS;
    }
    return STATUS_UNSUCCESSFUL;
}

Referenced by i8042Flush().

i8042ReadDataWait()

NTSTATUS i8042ReadDataWait	(	IN PPORT_DEVICE_EXTENSION	DeviceExtension,
		OUT PUCHAR	Data
	)

Definition at line 95 of file readwrite.c.

{
    ULONG Counter;
    NTSTATUS Status;
 
    Counter = DeviceExtension->Settings.PollingIterations;
 
    while (Counter--)
    {
        Status = i8042ReadKeyboardData(DeviceExtension, Data);
 
        if (NT_SUCCESS(Status))
            return Status;
 
        KeStallExecutionProcessor(50);
    }
 
    /* Timed out */
    return STATUS_IO_TIMEOUT;
}

Referenced by i8042BasicDetect(), i8042ChangeMode(), i8042DetectMouse(), i8042MouInitialize(), i8042SynchReadPort(), and i8042SynchWritePort().

i8042ReadStatus()

NTSTATUS i8042ReadStatus	(	IN PPORT_DEVICE_EXTENSION	DeviceExtension,
		OUT PUCHAR	Status
	)

Definition at line 82 of file readwrite.c.

{
    ASSERT(DeviceExtension->ControlPort != NULL);
    *Status = READ_PORT_UCHAR(DeviceExtension->ControlPort);
    return STATUS_SUCCESS;
}

Referenced by i8042KbdInterruptService(), i8042MouInterruptService(), and i8042ReadData().

i8042SynchReadPort()

NTSTATUS NTAPI i8042SynchReadPort	(	IN PVOID	Context,
		OUT PUCHAR	Value,
		IN BOOLEAN	WaitForAck
	)

Definition at line 125 of file readwrite.c.

{
    PPORT_DEVICE_EXTENSION DeviceExtension;
 
    UNREFERENCED_PARAMETER(WaitForAck);
 
    DeviceExtension = (PPORT_DEVICE_EXTENSION)Context;
 
    return i8042ReadDataWait(DeviceExtension, Value);
}

Referenced by i8042SendHookWorkItem().

i8042SynchWritePort()

NTSTATUS NTAPI i8042SynchWritePort	(	IN PPORT_DEVICE_EXTENSION	DeviceExtension,
		IN UCHAR	Port,
		IN UCHAR	Value,
		IN BOOLEAN	WaitForAck
	)

Definition at line 144 of file readwrite.c.

{
    NTSTATUS Status;
    UCHAR Ack;
    ULONG ResendIterations;
 
    ResendIterations = DeviceExtension->Settings.ResendIterations + 1;
 
    do
    {
        if (Port)
            if (!i8042Write(DeviceExtension, DeviceExtension->DataPort, Port))
            {
                WARN_(I8042PRT, "Failed to write Port\n");
                return STATUS_IO_TIMEOUT;
            }
 
        if (!i8042Write(DeviceExtension, DeviceExtension->DataPort, Value))
        {
            WARN_(I8042PRT, "Failed to write Value\n");
            return STATUS_IO_TIMEOUT;
        }
 
        if (WaitForAck)
        {
            Status = i8042ReadDataWait(DeviceExtension, &Ack);
            if (!NT_SUCCESS(Status))
            {
                WARN_(I8042PRT, "Failed to read Ack\n");
                return Status;
            }
            if (Ack == KBD_ACK)
                return STATUS_SUCCESS;
            else if (Ack == KBD_RESEND)
                INFO_(I8042PRT, "i8042 asks for a data resend\n");
        }
        else
        {
            return STATUS_SUCCESS;
        }
        TRACE_(I8042PRT, "Reiterating\n");
        ResendIterations--;
    } while (ResendIterations);
 
    return STATUS_IO_TIMEOUT;
}

Referenced by i8042DetectKeyboard(), and i8042SynchWritePortKbd().

i8042Write()

BOOLEAN i8042Write	(	IN PPORT_DEVICE_EXTENSION	DeviceExtension,
		IN PUCHAR	addr,
		IN UCHAR	data
	)

Definition at line 199 of file readwrite.c.

{
    ULONG Counter;
 
    ASSERT(addr);
    ASSERT(DeviceExtension->ControlPort != NULL);
 
    Counter = DeviceExtension->Settings.PollingIterations;
 
    while ((KBD_IBF & READ_PORT_UCHAR(DeviceExtension->ControlPort)) &&
           (Counter--))
    {
        KeStallExecutionProcessor(50);
    }
 
    if (Counter)
    {
        WRITE_PORT_UCHAR(addr, data);
        INFO_(I8042PRT, "Sent 0x%x to port %p\n", data, addr);
        return TRUE;
    }
    return FALSE;
}

Referenced by i8042BasicDetect(), i8042ChangeMode(), i8042ConnectKeyboardInterrupt(), i8042DetectMouse(), i8042IsrWritePort(), i8042MouInitialize(), i8042PacketWrite(), and i8042SynchWritePort().