2b822f4746
The DT bindings for X86 local APIC (lapic) and I/O APIC (ioapic) are outdated. Rework them: - Convert the bindings for lapic and ioapic from text to YAML schema. - Separate lapic & ioapic schemas. - Add missing but required standard properties - Add missing descriptions Suggested-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com> Signed-off-by: Rahul Tanwar <rtanwar@maxlinear.com> Signed-off-by: Thomas Gleixner <tglx@linutronix.de> Reviewed-by: Rob Herring <robh@kernel.org> Link: https://lore.kernel.org/r/20221124084143.21841-2-rtanwar@maxlinear.com
61 lines
1.6 KiB
YAML
61 lines
1.6 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: "http://devicetree.org/schemas/interrupt-controller/intel,ce4100-ioapic.yaml#"
|
|
$schema: "http://devicetree.org/meta-schemas/core.yaml#"
|
|
|
|
title: Intel I/O Advanced Programmable Interrupt Controller (IO APIC)
|
|
|
|
maintainers:
|
|
- Rahul Tanwar <rtanwar@maxlinear.com>
|
|
|
|
description: |
|
|
Intel's Advanced Programmable Interrupt Controller (APIC) is a
|
|
family of interrupt controllers. The APIC is a split
|
|
architecture design, with a local component (LAPIC) integrated
|
|
into the processor itself and an external I/O APIC. Local APIC
|
|
(lapic) receives interrupts from the processor's interrupt pins,
|
|
from internal sources and from an external I/O APIC (ioapic).
|
|
And it sends these to the processor core for handling.
|
|
See [1] Chapter 8 for more details.
|
|
|
|
Many of the Intel's generic devices like hpet, ioapic, lapic have
|
|
the ce4100 name in their compatible property names because they
|
|
first appeared in CE4100 SoC.
|
|
|
|
This schema defines bindings for I/O APIC interrupt controller.
|
|
|
|
[1] https://pdos.csail.mit.edu/6.828/2008/readings/ia32/IA32-3A.pdf
|
|
|
|
properties:
|
|
compatible:
|
|
const: intel,ce4100-ioapic
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
interrupt-controller: true
|
|
|
|
'#interrupt-cells':
|
|
const: 2
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- interrupt-controller
|
|
- '#interrupt-cells'
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
ioapic1: interrupt-controller@fec00000 {
|
|
compatible = "intel,ce4100-ioapic";
|
|
reg = <0xfec00000 0x1000>;
|
|
interrupt-controller;
|
|
#interrupt-cells = <2>;
|
|
};
|