mirror of https://github.com/acidanthera/audk.git
Add legacy8259 module for PcAt.
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5090 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
klu2
parent
d55eb54dab
commit
1166d06825
|
|
@ -0,0 +1,658 @@
|
|||
/**@file
|
||||
This contains the installation function for the driver.
|
||||
|
||||
Copyright (c) 2005 - 2007, Intel Corporation
|
||||
All rights reserved. This program and the accompanying materials
|
||||
are licensed and made available under the terms and conditions of the BSD License
|
||||
which accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
|
||||
**/
|
||||
|
||||
#include "8259.h"
|
||||
|
||||
//
|
||||
// Global for the CPU I/O Protocol that is consumed by this driver
|
||||
//
|
||||
EFI_CPU_IO_PROTOCOL *mCpuIo;
|
||||
|
||||
//
|
||||
// Global for the Legacy 8259 Protocol that is prodiced by this driver
|
||||
//
|
||||
EFI_LEGACY_8259_PROTOCOL m8259 = {
|
||||
Interrupt8259SetVectorBase,
|
||||
Interrupt8259GetMask,
|
||||
Interrupt8259SetMask,
|
||||
Interrupt8259SetMode,
|
||||
Interrupt8259GetVector,
|
||||
Interrupt8259EnableIrq,
|
||||
Interrupt8259DisableIrq,
|
||||
Interrupt8259GetInterruptLine,
|
||||
Interrupt8259EndOfInterrupt
|
||||
};
|
||||
|
||||
//
|
||||
// Global for the handle that the Legacy 8259 Protocol is installed
|
||||
//
|
||||
EFI_HANDLE m8259Handle = NULL;
|
||||
|
||||
UINT8 mMasterBase = 0xff;
|
||||
UINT8 mSlaveBase = 0xff;
|
||||
EFI_8259_MODE mMode = Efi8259ProtectedMode;
|
||||
UINT16 mProtectedModeMask = 0xffff;
|
||||
UINT16 mLegacyModeMask = 0x06b8;
|
||||
UINT16 mProtectedModeEdgeLevel = 0x0000;
|
||||
UINT16 mLegacyModeEdgeLevel = 0x0000;
|
||||
|
||||
//
|
||||
// Worker Functions
|
||||
//
|
||||
VOID
|
||||
IoWrite8 (
|
||||
IN UINT16 Port,
|
||||
IN UINT8 Value
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
Writes an I/O port using the CPU I/O Protocol
|
||||
|
||||
Arguments:
|
||||
Register - I/O Port to write
|
||||
Value - The 8 bit value to write to Port
|
||||
|
||||
Returns:
|
||||
None
|
||||
|
||||
**/
|
||||
{
|
||||
mCpuIo->Io.Write (mCpuIo, EfiCpuIoWidthUint8, Port, 1, &Value);
|
||||
}
|
||||
|
||||
UINT8
|
||||
IoRead8 (
|
||||
IN UINT16 Port
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
Writes an I/O port using the CPU I/O Protocol
|
||||
|
||||
Arguments:
|
||||
Register - I/O Port to write
|
||||
Value - The 8 bit value to write to Port
|
||||
|
||||
Returns:
|
||||
None
|
||||
|
||||
**/
|
||||
{
|
||||
UINT8 Value;
|
||||
|
||||
mCpuIo->Io.Read (mCpuIo, EfiCpuIoWidthUint8, Port, 1, &Value);
|
||||
return Value;
|
||||
}
|
||||
|
||||
VOID
|
||||
Interrupt8259WriteMask (
|
||||
IN UINT16 Mask,
|
||||
IN UINT16 EdgeLevel
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
Sets the 8250 mask to the valud specified by Mask
|
||||
|
||||
Arguments:
|
||||
Mask - A 16 bit valute that represents the master and slave mask values
|
||||
|
||||
Returns:
|
||||
None
|
||||
|
||||
**/
|
||||
// TODO: EdgeLevel - add argument and description to function comment
|
||||
{
|
||||
IoWrite8 (LEGACY_8259_MASK_REGISTER_MASTER, (UINT8) Mask);
|
||||
IoWrite8 (LEGACY_8259_MASK_REGISTER_SLAVE, (UINT8) (Mask >> 8));
|
||||
IoWrite8 (LEGACY_8259_EDGE_LEVEL_TRIGGERED_REGISTER_MASTER, (UINT8) EdgeLevel);
|
||||
IoWrite8 (LEGACY_8259_EDGE_LEVEL_TRIGGERED_REGISTER_SLAVE, (UINT8) (EdgeLevel >> 8));
|
||||
}
|
||||
|
||||
VOID
|
||||
Interrupt8259ReadMask (
|
||||
IN UINT16 *Mask,
|
||||
IN UINT16 *EdgeLevel
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
Sets the 8250 mask to the valud specified by Mask
|
||||
|
||||
Arguments:
|
||||
Mask - A 16 bit valute that represents the master and slave mask values
|
||||
|
||||
Returns:
|
||||
None
|
||||
|
||||
**/
|
||||
// TODO: EdgeLevel - add argument and description to function comment
|
||||
{
|
||||
if (Mask != NULL) {
|
||||
*Mask = (UINT16) (IoRead8 (LEGACY_8259_MASK_REGISTER_MASTER) | (IoRead8 (LEGACY_8259_MASK_REGISTER_SLAVE) << 8));
|
||||
}
|
||||
|
||||
if (EdgeLevel != NULL) {
|
||||
*EdgeLevel = (UINT16)
|
||||
(
|
||||
IoRead8 (LEGACY_8259_EDGE_LEVEL_TRIGGERED_REGISTER_MASTER) |
|
||||
(IoRead8 (LEGACY_8259_EDGE_LEVEL_TRIGGERED_REGISTER_SLAVE) << 8)
|
||||
);
|
||||
}
|
||||
}
|
||||
//
|
||||
// Legacy 8259 Protocol Interface Function
|
||||
//
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259SetVectorBase (
|
||||
IN EFI_LEGACY_8259_PROTOCOL *This,
|
||||
IN UINT8 MasterBase,
|
||||
IN UINT8 SlaveBase
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
Sets the base vector for the 8250 Master and Slave interrupt controllers
|
||||
|
||||
Arguments:
|
||||
This - Protocol instance pointer.
|
||||
MasterBase - Base vector of the 8259 Master
|
||||
SlaveBase - Base vector of the 8259 Slave
|
||||
|
||||
Returns:
|
||||
EFI_SUCCESS - 8259 programmed
|
||||
|
||||
**/
|
||||
{
|
||||
UINT8 Mask;
|
||||
|
||||
if (SlaveBase != mSlaveBase) {
|
||||
mSlaveBase = SlaveBase;
|
||||
|
||||
//
|
||||
// Initialize Slave interrupt controller.
|
||||
//
|
||||
Mask = IoRead8 (LEGACY_8259_MASK_REGISTER_SLAVE);
|
||||
IoWrite8 (LEGACY_8259_CONTROL_REGISTER_SLAVE, 0x11);
|
||||
IoWrite8 (LEGACY_8259_MASK_REGISTER_SLAVE, mSlaveBase);
|
||||
IoWrite8 (LEGACY_8259_MASK_REGISTER_SLAVE, 0x02);
|
||||
IoWrite8 (LEGACY_8259_MASK_REGISTER_SLAVE, 0x01);
|
||||
IoWrite8 (LEGACY_8259_MASK_REGISTER_SLAVE, Mask);
|
||||
}
|
||||
|
||||
if (MasterBase != mMasterBase) {
|
||||
mMasterBase = MasterBase;
|
||||
|
||||
//
|
||||
// Initialize Master interrupt controller.
|
||||
//
|
||||
Mask = IoRead8 (LEGACY_8259_MASK_REGISTER_MASTER);
|
||||
IoWrite8 (LEGACY_8259_CONTROL_REGISTER_MASTER, 0x11);
|
||||
IoWrite8 (LEGACY_8259_MASK_REGISTER_MASTER, mMasterBase);
|
||||
IoWrite8 (LEGACY_8259_MASK_REGISTER_MASTER, 0x04);
|
||||
IoWrite8 (LEGACY_8259_MASK_REGISTER_MASTER, 0x01);
|
||||
IoWrite8 (LEGACY_8259_MASK_REGISTER_MASTER, Mask);
|
||||
}
|
||||
|
||||
IoWrite8 (LEGACY_8259_CONTROL_REGISTER_SLAVE, 0x20);
|
||||
IoWrite8 (LEGACY_8259_CONTROL_REGISTER_MASTER, 0x20);
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259GetMask (
|
||||
IN EFI_LEGACY_8259_PROTOCOL * This,
|
||||
OUT UINT16 *LegacyMask, OPTIONAL
|
||||
OUT UINT16 *LegacyEdgeLevel, OPTIONAL
|
||||
OUT UINT16 *ProtectedMask, OPTIONAL
|
||||
OUT UINT16 *ProtectedEdgeLevel OPTIONAL
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
Get the 8259 master and slave address that maps IRQ to processor interrupt
|
||||
vector number. Get the Context of the device including the state of the
|
||||
interrupt mask.
|
||||
|
||||
Arguments:
|
||||
This - Protocol instance pointer.
|
||||
|
||||
Returns:
|
||||
EFI_SUCCESS - 8259 programmed
|
||||
EFI_DEVICE_ERROR - Error writting to 8259
|
||||
|
||||
**/
|
||||
// TODO: LegacyMask - add argument and description to function comment
|
||||
// TODO: LegacyEdgeLevel - add argument and description to function comment
|
||||
// TODO: ProtectedMask - add argument and description to function comment
|
||||
// TODO: ProtectedEdgeLevel - add argument and description to function comment
|
||||
{
|
||||
if (LegacyMask != NULL) {
|
||||
*LegacyMask = mLegacyModeMask;
|
||||
}
|
||||
|
||||
if (LegacyEdgeLevel != NULL) {
|
||||
*LegacyEdgeLevel = mLegacyModeEdgeLevel;
|
||||
}
|
||||
|
||||
if (ProtectedMask != NULL) {
|
||||
*ProtectedMask = mProtectedModeMask;
|
||||
}
|
||||
|
||||
if (ProtectedEdgeLevel != NULL) {
|
||||
*ProtectedEdgeLevel = mProtectedModeEdgeLevel;
|
||||
}
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259SetMask (
|
||||
IN EFI_LEGACY_8259_PROTOCOL * This,
|
||||
IN UINT16 *LegacyMask, OPTIONAL
|
||||
IN UINT16 *LegacyEdgeLevel, OPTIONAL
|
||||
IN UINT16 *ProtectedMask, OPTIONAL
|
||||
IN UINT16 *ProtectedEdgeLevel OPTIONAL
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
Set the 8259 interrupt and edge/level masks for legacy and/or protected
|
||||
mode operation. This routine does not touch the hardware but only the
|
||||
RAM copies of the masks.
|
||||
|
||||
Arguments:
|
||||
This - Protocol instance pointer.
|
||||
|
||||
Returns:
|
||||
EFI_SUCCESS - 8259 masks updated
|
||||
|
||||
**/
|
||||
// TODO: LegacyMask - add argument and description to function comment
|
||||
// TODO: LegacyEdgeLevel - add argument and description to function comment
|
||||
// TODO: ProtectedMask - add argument and description to function comment
|
||||
// TODO: ProtectedEdgeLevel - add argument and description to function comment
|
||||
{
|
||||
if (LegacyMask != NULL) {
|
||||
mLegacyModeMask = *LegacyMask;
|
||||
}
|
||||
|
||||
if (LegacyEdgeLevel != NULL) {
|
||||
mLegacyModeEdgeLevel = *LegacyEdgeLevel;
|
||||
}
|
||||
|
||||
if (ProtectedMask != NULL) {
|
||||
mProtectedModeMask = *ProtectedMask;
|
||||
}
|
||||
|
||||
if (ProtectedEdgeLevel != NULL) {
|
||||
mProtectedModeEdgeLevel = *ProtectedEdgeLevel;
|
||||
}
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259SetMode (
|
||||
IN EFI_LEGACY_8259_PROTOCOL * This,
|
||||
IN EFI_8259_MODE Mode,
|
||||
IN UINT16 *Mask, OPTIONAL
|
||||
IN UINT16 *EdgeLevel OPTIONAL
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
Set the 8259 master and slave address that maps IRQ to processor interrupt
|
||||
vector number. Restore the Context of the device, so that the interrupt
|
||||
mask is put back in it's previous mode.
|
||||
|
||||
Arguments:
|
||||
This - Protocol instance pointer.
|
||||
Mode -
|
||||
Mask -
|
||||
|
||||
Returns:
|
||||
EFI_SUCCESS - 8259 programmed
|
||||
EFI_DEVICE_ERROR - Error writting to 8259
|
||||
|
||||
**/
|
||||
// TODO: EdgeLevel - add argument and description to function comment
|
||||
// TODO: EFI_INVALID_PARAMETER - add return value to function comment
|
||||
{
|
||||
if (Mode == mMode) {
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
if (Mode == Efi8259LegacyMode) {
|
||||
//
|
||||
// Save the protected mode mask
|
||||
//
|
||||
Interrupt8259ReadMask (&mProtectedModeMask, &mProtectedModeEdgeLevel);
|
||||
|
||||
if (Mask != NULL) {
|
||||
//
|
||||
// Update the Mask for the new mode
|
||||
//
|
||||
mLegacyModeMask = *Mask;
|
||||
}
|
||||
|
||||
if (EdgeLevel != NULL) {
|
||||
//
|
||||
// Update the Edge/Level triggered mask for the new mode
|
||||
//
|
||||
mLegacyModeEdgeLevel = *EdgeLevel;
|
||||
}
|
||||
|
||||
mMode = Mode;
|
||||
|
||||
//
|
||||
// Set 8259 Vector Base
|
||||
//
|
||||
//
|
||||
Interrupt8259SetVectorBase (This, LEGACY_MODE_BASE_VECTOR_MASTER, LEGACY_MODE_BASE_VECTOR_SLAVE);
|
||||
|
||||
//
|
||||
// Enable Interrupts
|
||||
//
|
||||
Interrupt8259WriteMask (mLegacyModeMask, mLegacyModeEdgeLevel);
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
if (Mode == Efi8259ProtectedMode) {
|
||||
//
|
||||
// Save the legacy mode mask
|
||||
//
|
||||
Interrupt8259ReadMask (&mLegacyModeMask, &mLegacyModeEdgeLevel);
|
||||
//
|
||||
// Always force Timer to be enabled after return from 16-bit code.
|
||||
// This always insures that on next entry, timer is counting.
|
||||
//
|
||||
mLegacyModeMask &= 0xFFFE;
|
||||
|
||||
if (Mask != NULL) {
|
||||
//
|
||||
// Update the Mask for the new mode
|
||||
//
|
||||
mProtectedModeMask = *Mask;
|
||||
}
|
||||
|
||||
if (EdgeLevel != NULL) {
|
||||
//
|
||||
// Update the Edge/Level triggered mask for the new mode
|
||||
//
|
||||
mProtectedModeEdgeLevel = *EdgeLevel;
|
||||
}
|
||||
|
||||
mMode = Mode;
|
||||
|
||||
//
|
||||
// Set 8259 Vector Base
|
||||
//
|
||||
//
|
||||
Interrupt8259SetVectorBase (This, PROTECTED_MODE_BASE_VECTOR_MASTER, PROTECTED_MODE_BASE_VECTOR_SLAVE);
|
||||
|
||||
//
|
||||
// Enable Interrupts
|
||||
//
|
||||
Interrupt8259WriteMask (mProtectedModeMask, mProtectedModeEdgeLevel);
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
return EFI_INVALID_PARAMETER;
|
||||
}
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259GetVector (
|
||||
IN EFI_LEGACY_8259_PROTOCOL *This,
|
||||
IN EFI_8259_IRQ Irq,
|
||||
OUT UINT8 *Vector
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
Convert from IRQ to processor interrupt vector number.
|
||||
|
||||
Arguments:
|
||||
This - Protocol instance pointer.
|
||||
Irq - 8259 IRQ0 - IRQ15
|
||||
Vector - Processor vector number that matches Irq
|
||||
|
||||
Returns:
|
||||
EFI_SUCCESS - The Vector matching Irq is returned
|
||||
EFI_INVALID_PARAMETER - Irq not valid
|
||||
|
||||
**/
|
||||
{
|
||||
if (Irq < Efi8259Irq0 || Irq > Efi8259Irq15) {
|
||||
return EFI_INVALID_PARAMETER;
|
||||
}
|
||||
|
||||
if (Irq <= Efi8259Irq7) {
|
||||
*Vector = (UINT8) (mMasterBase + Irq);
|
||||
} else {
|
||||
*Vector = (UINT8) (mSlaveBase + (Irq - Efi8259Irq8));
|
||||
}
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259EnableIrq (
|
||||
IN EFI_LEGACY_8259_PROTOCOL *This,
|
||||
IN EFI_8259_IRQ Irq,
|
||||
IN BOOLEAN LevelTriggered
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
Enable Irq by unmasking interrupt in 8259
|
||||
|
||||
Arguments:
|
||||
This - Protocol instance pointer.
|
||||
Irq - 8259 IRQ0 - IRQ15
|
||||
|
||||
Returns:
|
||||
EFI_SUCCESS - Irq enabled on 8259
|
||||
EFI_INVALID_PARAMETER - Irq not valid
|
||||
|
||||
**/
|
||||
// TODO: LevelTriggered - add argument and description to function comment
|
||||
{
|
||||
if (Irq < Efi8259Irq0 || Irq > Efi8259Irq15) {
|
||||
return EFI_INVALID_PARAMETER;
|
||||
}
|
||||
|
||||
mProtectedModeMask &= ~(1 << Irq);
|
||||
if (LevelTriggered) {
|
||||
mProtectedModeEdgeLevel |= (1 << Irq);
|
||||
} else {
|
||||
mProtectedModeEdgeLevel &= ~(1 << Irq);
|
||||
}
|
||||
|
||||
Interrupt8259WriteMask (mProtectedModeMask, mProtectedModeEdgeLevel);
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259DisableIrq (
|
||||
IN EFI_LEGACY_8259_PROTOCOL *This,
|
||||
IN EFI_8259_IRQ Irq
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
Disable Irq by masking interrupt in 8259
|
||||
|
||||
Arguments:
|
||||
This - Protocol instance pointer.
|
||||
Irq - 8259 IRQ0 - IRQ15
|
||||
|
||||
Returns:
|
||||
EFI_SUCCESS - Irq disabled on 8259
|
||||
EFI_INVALID_PARAMETER - Irq not valid
|
||||
|
||||
**/
|
||||
{
|
||||
if (Irq < Efi8259Irq0 || Irq > Efi8259Irq15) {
|
||||
return EFI_INVALID_PARAMETER;
|
||||
}
|
||||
|
||||
mProtectedModeMask |= (1 << Irq);
|
||||
mProtectedModeEdgeLevel &= ~(1 << Irq);
|
||||
|
||||
Interrupt8259WriteMask (mProtectedModeMask, mProtectedModeEdgeLevel);
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259GetInterruptLine (
|
||||
IN EFI_LEGACY_8259_PROTOCOL *This,
|
||||
IN EFI_HANDLE PciHandle,
|
||||
OUT UINT8 *Vector
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
PciHandle represents a PCI config space of a PCI function. Vector
|
||||
represents Interrupt Pin (from PCI config space) and it is the data
|
||||
that is programmed into the Interrupt Line (from the PCI config space)
|
||||
register.
|
||||
|
||||
Arguments:
|
||||
This - Protocol instance pointer.
|
||||
PciHandle - PCI function to return vector for
|
||||
Vector - Vector for fucntion that matches
|
||||
|
||||
Returns:
|
||||
EFI_SUCCESS - A valid Vector is returned
|
||||
EFI_INVALID_PARAMETER - PciHandle not valid
|
||||
|
||||
**/
|
||||
{
|
||||
return EFI_UNSUPPORTED;
|
||||
}
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259EndOfInterrupt (
|
||||
IN EFI_LEGACY_8259_PROTOCOL *This,
|
||||
IN EFI_8259_IRQ Irq
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
Send an EOI to 8259
|
||||
|
||||
Arguments:
|
||||
This - Protocol instance pointer.
|
||||
Irq - 8259 IRQ0 - IRQ15
|
||||
|
||||
Returns:
|
||||
EFI_SUCCESS - EOI successfully sent to 8259
|
||||
EFI_INVALID_PARAMETER - Irq not valid
|
||||
|
||||
**/
|
||||
{
|
||||
if (Irq < Efi8259Irq0 || Irq > Efi8259Irq15) {
|
||||
return EFI_INVALID_PARAMETER;
|
||||
}
|
||||
|
||||
if (Irq >= Efi8259Irq8) {
|
||||
IoWrite8 (LEGACY_8259_CONTROL_REGISTER_SLAVE, LEGACY_8259_EOI);
|
||||
}
|
||||
|
||||
IoWrite8 (LEGACY_8259_CONTROL_REGISTER_MASTER, LEGACY_8259_EOI);
|
||||
|
||||
return EFI_SUCCESS;
|
||||
}
|
||||
|
||||
//
|
||||
// Legacy 8259 Driver Entry Point
|
||||
//
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Install8259 (
|
||||
IN EFI_HANDLE ImageHandle,
|
||||
IN EFI_SYSTEM_TABLE *SystemTable
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
|
||||
|
||||
Arguments:
|
||||
|
||||
(Standard EFI Image entry - EFI_IMAGE_ENTRY_POINT)
|
||||
|
||||
Returns:
|
||||
|
||||
EFI_SUCCESS - Legacy 8259 Protocol Installed
|
||||
|
||||
**/
|
||||
// TODO: ImageHandle - add argument and description to function comment
|
||||
// TODO: SystemTable - add argument and description to function comment
|
||||
{
|
||||
EFI_STATUS Status;
|
||||
EFI_8259_IRQ Irq;
|
||||
|
||||
//
|
||||
// Find the CPU I/O Protocol
|
||||
//
|
||||
Status = gBS->LocateProtocol (&gEfiCpuIoProtocolGuid, NULL, (VOID **) &mCpuIo);
|
||||
ASSERT_EFI_ERROR (Status);
|
||||
|
||||
//
|
||||
// Clear all pending interrupt
|
||||
//
|
||||
for (Irq = Efi8259Irq0; Irq <= Efi8259Irq15; Irq++) {
|
||||
Interrupt8259EndOfInterrupt (&m8259, Irq);
|
||||
}
|
||||
|
||||
//
|
||||
// Set the 8259 Master base to 0x68 and the 8259 Slave base to 0x70
|
||||
//
|
||||
Status = Interrupt8259SetVectorBase (&m8259, PROTECTED_MODE_BASE_VECTOR_MASTER, PROTECTED_MODE_BASE_VECTOR_SLAVE);
|
||||
|
||||
//
|
||||
// Set all 8259 interrupts to edge triggered and disabled
|
||||
//
|
||||
Interrupt8259WriteMask (mProtectedModeMask, mProtectedModeEdgeLevel);
|
||||
|
||||
//
|
||||
// Install 8259 Protocol onto a new handle
|
||||
//
|
||||
Status = gBS->InstallProtocolInterface (
|
||||
&m8259Handle,
|
||||
&gEfiLegacy8259ProtocolGuid,
|
||||
EFI_NATIVE_INTERFACE,
|
||||
&m8259
|
||||
);
|
||||
|
||||
return Status;
|
||||
}
|
||||
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
/*++
|
||||
|
||||
Copyright (c) 2005, Intel Corporation
|
||||
All rights reserved. This program and the accompanying materials
|
||||
are licensed and made available under the terms and conditions of the BSD License
|
||||
which accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
|
||||
Module Name:
|
||||
|
||||
8259.dxs
|
||||
|
||||
Abstract:
|
||||
Dependency expression source file.
|
||||
|
||||
--*/
|
||||
|
||||
#include "EfiDepex.h"
|
||||
|
||||
#include EFI_PROTOCOL_DEFINITION (CpuIo)
|
||||
|
||||
DEPENDENCY_START
|
||||
EFI_CPU_IO_PROTOCOL_GUID
|
||||
DEPENDENCY_END
|
||||
|
||||
|
|
@ -0,0 +1,293 @@
|
|||
/**
|
||||
|
||||
Copyright (c) 2005, Intel Corporation
|
||||
All rights reserved. This program and the accompanying materials
|
||||
are licensed and made available under the terms and conditions of the BSD License
|
||||
which accompanies this distribution. The full text of the license may be found at
|
||||
http://opensource.org/licenses/bsd-license.php
|
||||
|
||||
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
|
||||
Module Name:
|
||||
8259.h
|
||||
|
||||
Abstract:
|
||||
|
||||
Driver implementing the Tiano Legacy 8259 Protocol
|
||||
|
||||
**/
|
||||
|
||||
#ifndef _8259_H__
|
||||
#define _8259_H__
|
||||
|
||||
#include <FrameworkDxe.h>
|
||||
|
||||
#include <Protocol/CpuIo.h>
|
||||
#include <Protocol/Legacy8259.h>
|
||||
|
||||
#include <Library/UefiBootServicesTableLib.h>
|
||||
#include <Library/DebugLib.h>
|
||||
|
||||
//
|
||||
// 8259 Hardware definitions
|
||||
//
|
||||
#define LEGACY_MODE_BASE_VECTOR_MASTER 0x08
|
||||
#define LEGACY_MODE_BASE_VECTOR_SLAVE 0x70
|
||||
|
||||
#define PROTECTED_MODE_BASE_VECTOR_MASTER 0x68
|
||||
#define PROTECTED_MODE_BASE_VECTOR_SLAVE 0x70
|
||||
|
||||
#define LEGACY_8259_CONTROL_REGISTER_MASTER 0x20
|
||||
#define LEGACY_8259_MASK_REGISTER_MASTER 0x21
|
||||
#define LEGACY_8259_CONTROL_REGISTER_SLAVE 0xA0
|
||||
#define LEGACY_8259_MASK_REGISTER_SLAVE 0xA1
|
||||
#define LEGACY_8259_EDGE_LEVEL_TRIGGERED_REGISTER_MASTER 0x4D0
|
||||
#define LEGACY_8259_EDGE_LEVEL_TRIGGERED_REGISTER_SLAVE 0x4D1
|
||||
|
||||
#define LEGACY_8259_EOI 0x20
|
||||
|
||||
//
|
||||
// Protocol Function Prototypes
|
||||
//
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259SetVectorBase (
|
||||
IN EFI_LEGACY_8259_PROTOCOL *This,
|
||||
IN UINT8 MasterBase,
|
||||
IN UINT8 SlaveBase
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
|
||||
TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
This - TODO: add argument description
|
||||
MasterBase - TODO: add argument description
|
||||
SlaveBase - TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
TODO: add return values
|
||||
|
||||
**/
|
||||
;
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259GetMask (
|
||||
IN EFI_LEGACY_8259_PROTOCOL * This,
|
||||
OUT UINT16 *LegacyMask, OPTIONAL
|
||||
OUT UINT16 *LegacyEdgeLevel, OPTIONAL
|
||||
OUT UINT16 *ProtectedMask, OPTIONAL
|
||||
OUT UINT16 *ProtectedEdgeLevel OPTIONAL
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
|
||||
TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
This - TODO: add argument description
|
||||
LegacyMask - TODO: add argument description
|
||||
LegacyEdgeLevel - TODO: add argument description
|
||||
ProtectedMask - TODO: add argument description
|
||||
ProtectedEdgeLevel - TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
TODO: add return values
|
||||
|
||||
**/
|
||||
;
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259SetMask (
|
||||
IN EFI_LEGACY_8259_PROTOCOL * This,
|
||||
IN UINT16 *LegacyMask, OPTIONAL
|
||||
IN UINT16 *LegacyEdgeLevel, OPTIONAL
|
||||
IN UINT16 *ProtectedMask, OPTIONAL
|
||||
IN UINT16 *ProtectedEdgeLevel OPTIONAL
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
|
||||
TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
This - TODO: add argument description
|
||||
LegacyMask - TODO: add argument description
|
||||
LegacyEdgeLevel - TODO: add argument description
|
||||
ProtectedMask - TODO: add argument description
|
||||
ProtectedEdgeLevel - TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
TODO: add return values
|
||||
|
||||
**/
|
||||
;
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259SetMode (
|
||||
IN EFI_LEGACY_8259_PROTOCOL * This,
|
||||
IN EFI_8259_MODE Mode,
|
||||
IN UINT16 *Mask, OPTIONAL
|
||||
IN UINT16 *EdgeLevel OPTIONAL
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
|
||||
TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
This - TODO: add argument description
|
||||
Mode - TODO: add argument description
|
||||
Mask - TODO: add argument description
|
||||
EdgeLevel - TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
TODO: add return values
|
||||
|
||||
**/
|
||||
;
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259GetVector (
|
||||
IN EFI_LEGACY_8259_PROTOCOL *This,
|
||||
IN EFI_8259_IRQ Irq,
|
||||
OUT UINT8 *Vector
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
|
||||
TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
This - TODO: add argument description
|
||||
Irq - TODO: add argument description
|
||||
Vector - TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
TODO: add return values
|
||||
|
||||
**/
|
||||
;
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259EnableIrq (
|
||||
IN EFI_LEGACY_8259_PROTOCOL *This,
|
||||
IN EFI_8259_IRQ Irq,
|
||||
IN BOOLEAN LevelTriggered
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
|
||||
TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
This - TODO: add argument description
|
||||
Irq - TODO: add argument description
|
||||
LevelTriggered - TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
TODO: add return values
|
||||
|
||||
**/
|
||||
;
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259DisableIrq (
|
||||
IN EFI_LEGACY_8259_PROTOCOL *This,
|
||||
IN EFI_8259_IRQ Irq
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
|
||||
TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
This - TODO: add argument description
|
||||
Irq - TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
TODO: add return values
|
||||
|
||||
**/
|
||||
;
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259GetInterruptLine (
|
||||
IN EFI_LEGACY_8259_PROTOCOL *This,
|
||||
IN EFI_HANDLE PciHandle,
|
||||
OUT UINT8 *Vector
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
|
||||
TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
This - TODO: add argument description
|
||||
PciHandle - TODO: add argument description
|
||||
Vector - TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
TODO: add return values
|
||||
|
||||
**/
|
||||
;
|
||||
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
Interrupt8259EndOfInterrupt (
|
||||
IN EFI_LEGACY_8259_PROTOCOL *This,
|
||||
IN EFI_8259_IRQ Irq
|
||||
)
|
||||
/**
|
||||
|
||||
Routine Description:
|
||||
|
||||
TODO: Add function description
|
||||
|
||||
Arguments:
|
||||
|
||||
This - TODO: add argument description
|
||||
Irq - TODO: add argument description
|
||||
|
||||
Returns:
|
||||
|
||||
TODO: add return values
|
||||
|
||||
**/
|
||||
;
|
||||
|
||||
#endif
|
||||
|
|
@ -0,0 +1,50 @@
|
|||
#/*++
|
||||
#
|
||||
# Copyright (c) 2005, Intel Corporation
|
||||
# All rights reserved. This program and the accompanying materials
|
||||
# are licensed and made available under the terms and conditions of the BSD License
|
||||
# which accompanies this distribution. The full text of the license may be found at
|
||||
# http://opensource.org/licenses/bsd-license.php
|
||||
#
|
||||
# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
||||
# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
||||
#
|
||||
# Module Name:
|
||||
#
|
||||
# 8259.inf
|
||||
#
|
||||
# Abstract:
|
||||
#
|
||||
#--*/
|
||||
|
||||
[Defines]
|
||||
INF_VERSION = 0x00010005
|
||||
BASE_NAME = Legacy8259
|
||||
FILE_GUID = 79CA4208-BBA1-4a9a-8456-E1E66A81484E
|
||||
MODULE_TYPE = DXE_DRIVER
|
||||
VERSION_STRING = 1.0
|
||||
EDK_RELEASE_VERSION = 0x00020000
|
||||
EFI_SPECIFICATION_VERSION = 0x00020000
|
||||
|
||||
ENTRY_POINT = Install8259
|
||||
|
||||
[Packages]
|
||||
MdePkg/MdePkg.dec
|
||||
IntelFrameworkPkg/IntelFrameworkPkg.dec
|
||||
IntelFrameworkModulePkg/IntelFrameworkModulePkg.dec
|
||||
|
||||
[LibraryClasses]
|
||||
UefiBootServicesTableLib
|
||||
DebugLib
|
||||
UefiDriverEntryPoint
|
||||
|
||||
[Sources.common]
|
||||
8259.c
|
||||
8259.h
|
||||
|
||||
[Protocols]
|
||||
gEfiLegacy8259ProtocolGuid
|
||||
gEfiCpuIoProtocolGuid
|
||||
|
||||
[Depex]
|
||||
gEfiCpuIoProtocolGuid
|
||||
Loading…
Reference in New Issue