summaryrefslogtreecommitdiffstats
path: root/kernel/Documentation/devicetree/bindings/x86
diff options
context:
space:
mode:
Diffstat (limited to 'kernel/Documentation/devicetree/bindings/x86')
-rw-r--r--kernel/Documentation/devicetree/bindings/x86/ce4100.txt38
-rw-r--r--kernel/Documentation/devicetree/bindings/x86/interrupt.txt26
-rw-r--r--kernel/Documentation/devicetree/bindings/x86/timer.txt6
3 files changed, 70 insertions, 0 deletions
diff --git a/kernel/Documentation/devicetree/bindings/x86/ce4100.txt b/kernel/Documentation/devicetree/bindings/x86/ce4100.txt
new file mode 100644
index 000000000..b49ae593a
--- /dev/null
+++ b/kernel/Documentation/devicetree/bindings/x86/ce4100.txt
@@ -0,0 +1,38 @@
+CE4100 Device Tree Bindings
+---------------------------
+
+The CE4100 SoC uses for in core peripherals the following compatible
+format: <vendor>,<chip>-<device>.
+Many of the "generic" devices like HPET or IO APIC have the ce4100
+name in their compatible property because they first appeared in this
+SoC.
+
+The CPU node
+------------
+ cpu@0 {
+ device_type = "cpu";
+ compatible = "intel,ce4100";
+ reg = <0>;
+ lapic = <&lapic0>;
+ };
+
+The reg property describes the CPU number. The lapic property points to
+the local APIC timer.
+
+The SoC node
+------------
+
+This node describes the in-core peripherals. Required property:
+ compatible = "intel,ce4100-cp";
+
+The PCI node
+------------
+This node describes the PCI bus on the SoC. Its property should be
+ compatible = "intel,ce4100-pci", "pci";
+
+If the OS is using the IO-APIC for interrupt routing then the reported
+interrupt numbers for devices is no longer true. In order to obtain the
+correct interrupt number, the child node which represents the device has
+to contain the interrupt property. Besides the interrupt property it has
+to contain at least the reg property containing the PCI bus address and
+compatible property according to "PCI Bus Binding Revision 2.1".
diff --git a/kernel/Documentation/devicetree/bindings/x86/interrupt.txt b/kernel/Documentation/devicetree/bindings/x86/interrupt.txt
new file mode 100644
index 000000000..7d19f494f
--- /dev/null
+++ b/kernel/Documentation/devicetree/bindings/x86/interrupt.txt
@@ -0,0 +1,26 @@
+Interrupt chips
+---------------
+
+* Intel I/O Advanced Programmable Interrupt Controller (IO APIC)
+
+ Required properties:
+ --------------------
+ compatible = "intel,ce4100-ioapic";
+ #interrupt-cells = <2>;
+
+ Device's interrupt property:
+
+ interrupts = <P S>;
+
+ The first number (P) represents the interrupt pin which is wired to the
+ IO APIC. The second number (S) represents the sense of interrupt which
+ should be configured and can be one of:
+ 0 - Edge Rising
+ 1 - Level Low
+ 2 - Level High
+ 3 - Edge Falling
+
+* Local APIC
+ Required property:
+
+ compatible = "intel,ce4100-lapic";
diff --git a/kernel/Documentation/devicetree/bindings/x86/timer.txt b/kernel/Documentation/devicetree/bindings/x86/timer.txt
new file mode 100644
index 000000000..c688af58e
--- /dev/null
+++ b/kernel/Documentation/devicetree/bindings/x86/timer.txt
@@ -0,0 +1,6 @@
+Timers
+------
+
+* High Precision Event Timer (HPET)
+ Required property:
+ compatible = "intel,ce4100-hpet";