#include <hal.h>
#include <acpi.h>
#include <smp.h>
#include <debug.h>

Include dependency graph for madt.c:

Macros
#define	NDEBUG

Functions
static VOID	HalpMadtAddProcessor (_In_ ULONG ApicId, _In_ ULONG ProcessorId, _In_ ULONG Flags)
	Adds the processor of a local APIC or local x2APIC entry.

static VOID	HalpMadtAddIoApic (_In_ ACPI_MADT_IO_APIC *IoApic)
	Records the I/O APIC of an I/O APIC entry.

static VOID	HalpMadtAddInterruptOverride (_In_ ACPI_MADT_INTERRUPT_OVERRIDE *Override)
	Records the routing and polarity of an interrupt source override entry.

static VOID	HalpMadtParseEntries (_In_ ACPI_TABLE_MADT *MadtTable)
	Walks the interrupt controller entries of the MADT.

static VOID	HalpMadtPlaceBootProcessor (VOID)
	Moves the boot processor to the first entry, since NT processor numbers follow the entry order.

VOID	HalpParseApicTables (_In_ PLOADER_PARAMETER_BLOCK LoaderBlock)

VOID	HalpPrintApicTables (VOID)

Variables
HALP_APIC_INFO_TABLE	HalpApicInfoTable

PROCESSOR_IDENTITY	HalpProcessorIdentity [MAXIMUM_PROCESSORS]

ULONG	HalpPicVectorRedirect [HALP_ISA_IRQ_COUNT]

static ULONG	HalpMadtIgnoredEntries

static BOOLEAN	HalpMadtTruncated

Macro Definition Documentation

◆ NDEBUG

#define NDEBUG

Definition at line 17 of file madt.c.

Function Documentation

◆ HalpMadtAddInterruptOverride()

static VOID HalpMadtAddInterruptOverride ( _In_ ACPI_MADT_INTERRUPT_OVERRIDE * Override )

static

Records the routing and polarity of an interrupt source override entry.

Parameters

[in] Override The interrupt source override entry.

Definition at line 122 of file madt.c.

{
    ULONG Irq = Override->SourceIrq;
 
    /* Overrides only exist for ISA IRQs */
    if ((Override->Bus != 0) || (Irq >= HALP_ISA_IRQ_COUNT))
    {
        HalpMadtIgnoredEntries++;
        return;
    }
 
    HalpPicVectorRedirect[Irq] = Override->GlobalIrq;
    HalpApicInfoTable.IsaIrqGsi[Irq] = Override->GlobalIrq;
 
    switch (Override->IntiFlags & ACPI_MADT_POLARITY_MASK)
    {
        case ACPI_MADT_POLARITY_ACTIVE_HIGH:
            HalpApicInfoTable.IsaIrqPolarity[Irq] = InterruptActiveHigh;
            break;
 
        case ACPI_MADT_POLARITY_ACTIVE_LOW:
            HalpApicInfoTable.IsaIrqPolarity[Irq] = InterruptActiveLow;
            break;
 
        default:
            HalpApicInfoTable.IsaIrqPolarity[Irq] = InterruptPolarityUnknown;
            break;
    }
}

Referenced by HalpMadtParseEntries().

◆ HalpMadtAddIoApic()

static VOID HalpMadtAddIoApic ( _In_ ACPI_MADT_IO_APIC * IoApic )

static

Records the I/O APIC of an I/O APIC entry.

Parameters

[in] IoApic The I/O APIC entry.

Definition at line 95 of file madt.c.

{
    C_ASSERT(RTL_FIELD_SIZE(ACPI_MADT_IO_APIC, Id) == 1 &&
             RTL_NUMBER_OF_FIELD(HALP_APIC_INFO_TABLE, IoApicPA) >= 256);
 
    /* Keep the first unit when an ID is duplicated, because apparently this happens on Dell PowerEdge's sometimes. */
    if ((IoApic->Address == 0) || (HalpApicInfoTable.IoApicPA[IoApic->Id] != 0))
    {
        HalpMadtIgnoredEntries++;
        return;
    }
 
    HalpApicInfoTable.IoApicPA[IoApic->Id] = IoApic->Address;
    HalpApicInfoTable.IoApicIrqBase[IoApic->Id] = IoApic->GlobalIrqBase;
    HalpApicInfoTable.IOAPICCount++;
}

Referenced by HalpMadtParseEntries().

◆ HalpMadtAddProcessor()

static VOID HalpMadtAddProcessor	(	_In_ ULONG	ApicId,
		_In_ ULONG	ProcessorId,
		_In_ ULONG	Flags
	)

static

Adds the processor of a local APIC or local x2APIC entry.

Parameters

[in]	ApicId	Local APIC ID of the processor.
[in]	ProcessorId	ACPI processor ID of the processor.
[in]	Flags	Local APIC flags of the entry.

Definition at line 50 of file madt.c.

{
    ULONG Index;
 
    if (!(Flags & ACPI_MADT_ENABLED))
        return;
 
    /* TODO: LapicId holds 8 bits, and 0xFF is the broadcast ID, we eventually want to support x2APIC however. */
    if (ApicId >= 0xFF)
    {
        HalpMadtIgnoredEntries++;
        return;
    }
 
    /* Firmware can describe a processor with both a local APIC and a local x2APIC entry */
    for (Index = 0; Index < HalpApicInfoTable.ProcessorCount; Index++)
    {
        if (HalpProcessorIdentity[Index].LapicId == ApicId)
            return;
    }
 
    if (Index >= RTL_NUMBER_OF(HalpProcessorIdentity))
    {
        HalpMadtIgnoredEntries++;
        return;
    }
 
    /* FIXME: Only extend tracking when we get x2APIC support */
    HalpProcessorIdentity[Index].ProcessorId = ProcessorId;
    HalpProcessorIdentity[Index].LapicId = ApicId;
    HalpApicInfoTable.ProcessorCount++;
}

Referenced by HalpMadtParseEntries().

◆ HalpMadtParseEntries()

static VOID HalpMadtParseEntries ( _In_ ACPI_TABLE_MADT * MadtTable )

static

Walks the interrupt controller entries of the MADT.

Parameters

[in] MadtTable The MADT, with a header already validated.

Definition at line 162 of file madt.c.

{
    ACPI_SUBTABLE_HEADER *Entry;
    ULONG_PTR TableEnd;
 
    TableEnd = (ULONG_PTR)MadtTable + MadtTable->Header.Length;
    Entry = (ACPI_SUBTABLE_HEADER *)(MadtTable + 1);
 
    while ((ULONG_PTR)Entry < TableEnd)
    {
        if (((ULONG_PTR)(Entry + 1) > TableEnd) ||
            (Entry->Length < sizeof(*Entry)) ||
            ((ULONG_PTR)Entry + Entry->Length > TableEnd))
        {
            HalpMadtTruncated = TRUE;
            return;
        }
 
        switch (Entry->Type)
        {
            case ACPI_MADT_TYPE_LOCAL_APIC:
            {
                ACPI_MADT_LOCAL_APIC *LocalApic = (ACPI_MADT_LOCAL_APIC *)Entry;
 
                if (Entry->Length < sizeof(*LocalApic))
                {
                    HalpMadtIgnoredEntries++;
                    break;
                }
 
                HalpMadtAddProcessor(LocalApic->Id,
                                     LocalApic->ProcessorId,
                                     LocalApic->LapicFlags);
                break;
            }
 
            case ACPI_MADT_TYPE_LOCAL_X2APIC:
            {
                ACPI_MADT_LOCAL_X2APIC *LocalX2Apic = (ACPI_MADT_LOCAL_X2APIC *)Entry;
 
                if (Entry->Length < sizeof(*LocalX2Apic))
                {
                    HalpMadtIgnoredEntries++;
                    break;
                }
 
                HalpMadtAddProcessor(LocalX2Apic->LocalApicId,
                                     LocalX2Apic->Uid,
                                     LocalX2Apic->LapicFlags);
                break;
            }
 
            case ACPI_MADT_TYPE_IO_APIC:
            {
                if (Entry->Length < sizeof(ACPI_MADT_IO_APIC))
                {
                    HalpMadtIgnoredEntries++;
                    break;
                }
 
                HalpMadtAddIoApic((ACPI_MADT_IO_APIC *)Entry);
                break;
            }
 
            case ACPI_MADT_TYPE_INTERRUPT_OVERRIDE:
            {
                if (Entry->Length < sizeof(ACPI_MADT_INTERRUPT_OVERRIDE))
                {
                    HalpMadtIgnoredEntries++;
                    break;
                }
 
                HalpMadtAddInterruptOverride((ACPI_MADT_INTERRUPT_OVERRIDE *)Entry);
                break;
            }
 
            /* Other types, including reserved and OEM ones, are skipped */
            default:
                break;
        }
 
        Entry = (ACPI_SUBTABLE_HEADER *)((ULONG_PTR)Entry + Entry->Length);
    }
}

Referenced by HalpParseApicTables().

◆ HalpMadtPlaceBootProcessor()

static VOID HalpMadtPlaceBootProcessor ( VOID )

static

Moves the boot processor to the first entry, since NT processor numbers follow the entry order.

Remarks: When the MADT does not describe the boot processor, only the boot processor is kept so that no other processor is started.

Definition at line 259 of file madt.c.

{
    PROCESSOR_IDENTITY BootProcessor;
    ULONG Index;
    UCHAR BootApicId;
 
    /* The kernel fills this from CPUID before initializing the processor with the HAL */
    BootApicId = (UCHAR)KeGetCurrentPrcb()->InitialApicId;
 
    for (Index = 0; Index < HalpApicInfoTable.ProcessorCount; Index++)
    {
        if (HalpProcessorIdentity[Index].LapicId == BootApicId)
            break;
    }
 
    if (Index == HalpApicInfoTable.ProcessorCount)
    {
        /* The MADT is missing the boot processor, so we can't trust it and only run the boot processor */
        RtlZeroMemory(&BootProcessor, sizeof(BootProcessor));
        BootProcessor.LapicId = BootApicId;
        HalpApicInfoTable.ProcessorCount = 1;
    }
    else
    {
        /* A conforming MADT lists the boot processor first, so this only moves entries on non-conforming ones */
        BootProcessor = HalpProcessorIdentity[Index];
        RtlMoveMemory(&HalpProcessorIdentity[1],
                      &HalpProcessorIdentity[0],
                      Index * sizeof(BootProcessor));
    }
 
    BootProcessor.BSPCheck = TRUE;
    HalpProcessorIdentity[0] = BootProcessor;
}

Referenced by HalpParseApicTables().

◆ HalpParseApicTables()

VOID HalpParseApicTables ( _In_ PLOADER_PARAMETER_BLOCK LoaderBlock )

Definition at line 295 of file madt.c.

{
    ACPI_TABLE_MADT *MadtTable;
 
    MadtTable = HalAcpiGetTable(LoaderBlock, APIC_SIGNATURE);
    if (MadtTable && (MadtTable->Header.Length >= sizeof(*MadtTable)))
    {
        HalpApicInfoTable.LocalApicPA = MadtTable->Address;
        HalpMadtParseEntries(MadtTable);
    }
    else
    {
        HalpMadtTruncated = TRUE;
    }
 
    HalpMadtPlaceBootProcessor();
}

Referenced by HalpInitProcessor().

◆ HalpPrintApicTables()

VOID HalpPrintApicTables ( VOID )

Definition at line 315 of file madt.c.

{
#if DBG
    ULONG i;
 
    DPRINT1("Physical processor count: %lu\n", HalpApicInfoTable.ProcessorCount);
    for (i = 0; i < HalpApicInfoTable.ProcessorCount; i++)
    {
        DPRINT1(" Processor %lu: ProcessorId %u, LapicId %u, ProcessorStarted %u, BSPCheck %u, ProcessorPrcb %p\n",
                i,
                HalpProcessorIdentity[i].ProcessorId,
                HalpProcessorIdentity[i].LapicId,
                HalpProcessorIdentity[i].ProcessorStarted,
                HalpProcessorIdentity[i].BSPCheck,
                HalpProcessorIdentity[i].ProcessorPrcb);
    }
 
    for (i = 0; i < HALP_APIC_INFO_TABLE_IOAPIC_NUMBER; i++)
    {
        if (HalpApicInfoTable.IoApicPA[i] != 0)
        {
            DPRINT1(" I/O APIC %lu: Address 0x%08lx, GlobalIrqBase %lu\n",
                    i,
                    HalpApicInfoTable.IoApicPA[i],
                    HalpApicInfoTable.IoApicIrqBase[i]);
        }
    }
 
    if (HalpMadtTruncated || (HalpMadtIgnoredEntries != 0))
    {
        DPRINT1("MADT missing or malformed: %u, entries ignored: %lu\n",
                HalpMadtTruncated,
                HalpMadtIgnoredEntries);
    }
#endif
}