mirror of
https://github.com/torvalds/linux.git
synced 2024-12-29 06:12:08 +00:00
7f464532b0
Setting 'additionalProperties: false' is frequently omitted, but is important in order to check that there aren't extra undocumented properties in a binding. Ideally, we'd just add this automatically and make this the default, but there's some cases where it doesn't work. For example, if a common schema is referenced, then properties in the common schema aren't part of what's considered for 'additionalProperties'. Also, sometimes there are bus specific properties such as 'spi-max-frequency' that go into bus child nodes, but aren't defined in the child node's schema. So let's stick with the json-schema defined default and add 'additionalProperties: false' where needed. This will be a continual review comment and game of wack-a-mole. Signed-off-by: Rob Herring <robh@kernel.org> Reviewed-by: Neil Armstrong <narmstrong@baylibre.com> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> Acked-by: Alexandru Ardelean <alexandru.ardelean@analog.com> Reviewed-by: Benjamin Gaignard <benjamin.gaignard@st.com> Acked-by: Stephen Boyd <sboyd@kernel.org> # clock Acked-by: Lee Jones <lee.jones@linaro.org>
127 lines
4.5 KiB
YAML
127 lines
4.5 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/timer/samsung,exynos4210-mct.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Samsung Exynos SoC Multi Core Timer (MCT)
|
|
|
|
maintainers:
|
|
- Krzysztof Kozlowski <krzk@kernel.org>
|
|
|
|
description: |+
|
|
The Samsung's Multi Core Timer (MCT) module includes two main blocks, the
|
|
global timer and CPU local timers. The global timer is a 64-bit free running
|
|
up-counter and can generate 4 interrupts when the counter reaches one of the
|
|
four preset counter values. The CPU local timers are 32-bit free running
|
|
down-counters and generate an interrupt when the counter expires. There is
|
|
one CPU local timer instantiated in MCT for every CPU in the system.
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- samsung,exynos4210-mct
|
|
- samsung,exynos4412-mct
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
interrupts:
|
|
description: |
|
|
Interrupts should be put in specific order. This is, the local timer
|
|
interrupts should be specified after the four global timer interrupts
|
|
have been specified:
|
|
0: Global Timer Interrupt 0
|
|
1: Global Timer Interrupt 1
|
|
2: Global Timer Interrupt 2
|
|
3: Global Timer Interrupt 3
|
|
4: Local Timer Interrupt 0
|
|
5: Local Timer Interrupt 1
|
|
6: ..
|
|
7: ..
|
|
i: Local Timer Interrupt n
|
|
For MCT block that uses a per-processor interrupt for local timers, such
|
|
as ones compatible with "samsung,exynos4412-mct", only one local timer
|
|
interrupt might be specified, meaning that all local timers use the same
|
|
per processor interrupt.
|
|
minItems: 5 # 4 Global + 1 local
|
|
maxItems: 20 # 4 Global + 16 local
|
|
|
|
required:
|
|
- compatible
|
|
- interrupts
|
|
- reg
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
// In this example, the IP contains two local timers, using separate
|
|
// interrupts, so two local timer interrupts have been specified,
|
|
// in addition to four global timer interrupts.
|
|
#include <dt-bindings/interrupt-controller/arm-gic.h>
|
|
|
|
timer@10050000 {
|
|
compatible = "samsung,exynos4210-mct";
|
|
reg = <0x10050000 0x800>;
|
|
interrupts = <GIC_SPI 57 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 69 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 70 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 71 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 42 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 48 IRQ_TYPE_LEVEL_HIGH>;
|
|
};
|
|
|
|
- |
|
|
// In this example, the timer interrupts are connected to two separate
|
|
// interrupt controllers. Hence, an interrupts-extended is needed.
|
|
#include <dt-bindings/interrupt-controller/arm-gic.h>
|
|
|
|
timer@101c0000 {
|
|
compatible = "samsung,exynos4210-mct";
|
|
reg = <0x101C0000 0x800>;
|
|
interrupts-extended = <&gic GIC_SPI 57 IRQ_TYPE_LEVEL_HIGH>,
|
|
<&gic GIC_SPI 69 IRQ_TYPE_LEVEL_HIGH>,
|
|
<&combiner 12 6>,
|
|
<&combiner 12 7>,
|
|
<&gic GIC_SPI 42 IRQ_TYPE_LEVEL_HIGH>,
|
|
<&gic GIC_SPI 48 IRQ_TYPE_LEVEL_HIGH>;
|
|
};
|
|
|
|
- |
|
|
// In this example, the IP contains four local timers, but using
|
|
// a per-processor interrupt to handle them. Only one first local
|
|
// interrupt is specified.
|
|
#include <dt-bindings/interrupt-controller/arm-gic.h>
|
|
|
|
timer@10050000 {
|
|
compatible = "samsung,exynos4412-mct";
|
|
reg = <0x10050000 0x800>;
|
|
|
|
interrupts = <GIC_SPI 57 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 69 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 70 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 71 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_PPI 42 IRQ_TYPE_LEVEL_HIGH>;
|
|
};
|
|
|
|
- |
|
|
// In this example, the IP contains four local timers, but using
|
|
// a per-processor interrupt to handle them. All the local timer
|
|
// interrupts are specified.
|
|
#include <dt-bindings/interrupt-controller/arm-gic.h>
|
|
|
|
timer@10050000 {
|
|
compatible = "samsung,exynos4412-mct";
|
|
reg = <0x10050000 0x800>;
|
|
|
|
interrupts = <GIC_SPI 57 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 69 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 70 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_SPI 71 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_PPI 42 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_PPI 42 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_PPI 42 IRQ_TYPE_LEVEL_HIGH>,
|
|
<GIC_PPI 42 IRQ_TYPE_LEVEL_HIGH>;
|
|
};
|