hwvalid.c File Reference

#include "acpi.h"
#include "accommon.h"

Include dependency graph for hwvalid.c:

Go to the source code of this file.

Macros
#define	_COMPONENT   ACPI_HARDWARE
#define	ACPI_PORT_INFO_ENTRIES   ACPI_ARRAY_LENGTH (AcpiProtectedPorts)

Functions
static ACPI_STATUS	AcpiHwValidateIoRequest (ACPI_IO_ADDRESS Address, UINT32 BitWidth)
ACPI_STATUS	AcpiHwReadPort (ACPI_IO_ADDRESS Address, UINT32 *Value, UINT32 Width)
ACPI_STATUS	AcpiHwWritePort (ACPI_IO_ADDRESS Address, UINT32 Value, UINT32 Width)

Variables
static const ACPI_PORT_INFO	AcpiProtectedPorts []

Macro Definition Documentation

_COMPONENT

#define _COMPONENT   ACPI_HARDWARE

Definition at line 47 of file hwvalid.c.

ACPI_PORT_INFO_ENTRIES

#define ACPI_PORT_INFO_ENTRIES   ACPI_ARRAY_LENGTH (AcpiProtectedPorts)

Definition at line 110 of file hwvalid.c.

Function Documentation

AcpiHwReadPort()

ACPI_STATUS AcpiHwReadPort	(	ACPI_IO_ADDRESS	Address,
		UINT32 *	Value,
		UINT32	Width
	)

Definition at line 237 of file hwvalid.c.

{
    ACPI_STATUS             Status;
    UINT32                  OneByte;
    UINT32                  i;
 
 
    /* Truncate address to 16 bits if requested */
 
    if (AcpiGbl_TruncateIoAddresses)
    {
        Address &= ACPI_UINT16_MAX;
    }
 
    /* Validate the entire request and perform the I/O */
 
    Status = AcpiHwValidateIoRequest (Address, Width);
    if (ACPI_SUCCESS (Status))
    {
        Status = AcpiOsReadPort (Address, Value, Width);
        return (Status);
    }
 
    if (Status != AE_AML_ILLEGAL_ADDRESS)
    {
        return (Status);
    }
 
    /*
     * There has been a protection violation within the request. Fall
     * back to byte granularity port I/O and ignore the failing bytes.
     * This provides compatibility with other ACPI implementations.
     */
    for (i = 0, *Value = 0; i < Width; i += 8)
    {
        /* Validate and read one byte */
 
        if (AcpiHwValidateIoRequest (Address, 8) == AE_OK)
        {
            Status = AcpiOsReadPort (Address, &OneByte, 8);
            if (ACPI_FAILURE (Status))
            {
                return (Status);
            }
 
            *Value |= (OneByte << i);
        }
 
        Address++;
    }
 
    return (AE_OK);
}

Referenced by AcpiExSystemIoSpaceHandler(), AcpiHwRead(), and AcpiHwRegisterRead().

AcpiHwValidateIoRequest()

static ACPI_STATUS AcpiHwValidateIoRequest ( ACPI_IO_ADDRESS  Address, UINT32  BitWidth  )

static

Definition at line 130 of file hwvalid.c.

{
    UINT32                  i;
    UINT32                  ByteWidth;
    ACPI_IO_ADDRESS         LastAddress;
    const ACPI_PORT_INFO    *PortInfo;
 
 
    ACPI_FUNCTION_TRACE (HwValidateIoRequest);
 
 
    /* Supported widths are 8/16/32 */
 
    if ((BitWidth != 8) &&
        (BitWidth != 16) &&
        (BitWidth != 32))
    {
        ACPI_ERROR ((AE_INFO,
            "Bad BitWidth parameter: %8.8X", BitWidth));
        return_ACPI_STATUS (AE_BAD_PARAMETER);
    }
 
    PortInfo = AcpiProtectedPorts;
    ByteWidth = ACPI_DIV_8 (BitWidth);
    LastAddress = Address + ByteWidth - 1;
 
    ACPI_DEBUG_PRINT ((ACPI_DB_IO,
        "Address %8.8X%8.8X LastAddress %8.8X%8.8X Length %X",
        ACPI_FORMAT_UINT64 (Address), ACPI_FORMAT_UINT64 (LastAddress),
        ByteWidth));
 
    /* Maximum 16-bit address in I/O space */
 
    if (LastAddress > ACPI_UINT16_MAX)
    {
        ACPI_ERROR ((AE_INFO,
            "Illegal I/O port address/length above 64K: %8.8X%8.8X/0x%X",
            ACPI_FORMAT_UINT64 (Address), ByteWidth));
        return_ACPI_STATUS (AE_LIMIT);
    }
 
    /* Exit if requested address is not within the protected port table */
 
    if (Address > AcpiProtectedPorts[ACPI_PORT_INFO_ENTRIES - 1].End)
    {
        return_ACPI_STATUS (AE_OK);
    }
 
    /* Check request against the list of protected I/O ports */
 
    for (i = 0; i < ACPI_PORT_INFO_ENTRIES; i++, PortInfo++)
    {
        /*
         * Check if the requested address range will write to a reserved
         * port. There are four cases to consider:
         *
         * 1) Address range is contained completely in the port address range
         * 2) Address range overlaps port range at the port range start
         * 3) Address range overlaps port range at the port range end
         * 4) Address range completely encompasses the port range
         */
        if ((Address <= PortInfo->End) && (LastAddress >= PortInfo->Start))
        {
            /* Port illegality may depend on the _OSI calls made by the BIOS */
 
            if (AcpiGbl_OsiData >= PortInfo->OsiDependency)
            {
                ACPI_DEBUG_PRINT ((ACPI_DB_VALUES,
                    "Denied AML access to port 0x%8.8X%8.8X/%X (%s 0x%.4X-0x%.4X)\n",
                    ACPI_FORMAT_UINT64 (Address), ByteWidth, PortInfo->Name,
                    PortInfo->Start, PortInfo->End));
 
                return_ACPI_STATUS (AE_AML_ILLEGAL_ADDRESS);
            }
        }
 
        /* Finished if address range ends before the end of this port */
 
        if (LastAddress <= PortInfo->End)
        {
            break;
        }
    }
 
    return_ACPI_STATUS (AE_OK);
}

Referenced by AcpiHwReadPort(), and AcpiHwWritePort().

AcpiHwWritePort()

ACPI_STATUS AcpiHwWritePort	(	ACPI_IO_ADDRESS	Address,
		UINT32	Value,
		UINT32	Width
	)

Definition at line 312 of file hwvalid.c.

{
    ACPI_STATUS             Status;
    UINT32                  i;
 
 
    /* Truncate address to 16 bits if requested */
 
    if (AcpiGbl_TruncateIoAddresses)
    {
        Address &= ACPI_UINT16_MAX;
    }
 
    /* Validate the entire request and perform the I/O */
 
    Status = AcpiHwValidateIoRequest (Address, Width);
    if (ACPI_SUCCESS (Status))
    {
        Status = AcpiOsWritePort (Address, Value, Width);
        return (Status);
    }
 
    if (Status != AE_AML_ILLEGAL_ADDRESS)
    {
        return (Status);
    }
 
    /*
     * There has been a protection violation within the request. Fall
     * back to byte granularity port I/O and ignore the failing bytes.
     * This provides compatibility with other ACPI implementations.
     */
    for (i = 0; i < Width; i += 8)
    {
        /* Validate and write one byte */
 
        if (AcpiHwValidateIoRequest (Address, 8) == AE_OK)
        {
            Status = AcpiOsWritePort (Address, (Value >> i) & 0xFF, 8);
            if (ACPI_FAILURE (Status))
            {
                return (Status);
            }
        }
 
        Address++;
    }
 
    return (AE_OK);
}

Referenced by AcpiEnterSleepStateS4bios(), AcpiExSystemIoSpaceHandler(), AcpiHwRegisterWrite(), AcpiHwSetMode(), and AcpiHwWrite().

Variable Documentation

AcpiProtectedPorts

const ACPI_PORT_INFO AcpiProtectedPorts[]

static

Initial value:

=
{
    {"DMA",     0x0000, 0x000F, ACPI_OSI_WIN_XP},
    {"PIC0",    0x0020, 0x0021, ACPI_ALWAYS_ILLEGAL},
    {"PIT1",    0x0040, 0x0043, ACPI_OSI_WIN_XP},
    {"PIT2",    0x0048, 0x004B, ACPI_OSI_WIN_XP},
    {"RTC",     0x0070, 0x0071, ACPI_OSI_WIN_XP},
    {"CMOS",    0x0074, 0x0076, ACPI_OSI_WIN_XP},
    {"DMA1",    0x0081, 0x0083, ACPI_OSI_WIN_XP},
    {"DMA1L",   0x0087, 0x0087, ACPI_OSI_WIN_XP},
    {"DMA2",    0x0089, 0x008B, ACPI_OSI_WIN_XP},
    {"DMA2L",   0x008F, 0x008F, ACPI_OSI_WIN_XP},
    {"ARBC",    0x0090, 0x0091, ACPI_OSI_WIN_XP},
    {"SETUP",   0x0093, 0x0094, ACPI_OSI_WIN_XP},
    {"POS",     0x0096, 0x0097, ACPI_OSI_WIN_XP},
    {"PIC1",    0x00A0, 0x00A1, ACPI_ALWAYS_ILLEGAL},
    {"IDMA",    0x00C0, 0x00DF, ACPI_OSI_WIN_XP},
    {"ELCR",    0x04D0, 0x04D1, ACPI_ALWAYS_ILLEGAL},
    {"PCI",     0x0CF8, 0x0CFF, ACPI_OSI_WIN_XP}
}

Definition at line 89 of file hwvalid.c.

Referenced by AcpiHwValidateIoRequest().