3d21a46093
json-schema versions draft7 and earlier have a weird behavior in that any keywords combined with a '$ref' are ignored (silently). The correct form was to put a '$ref' under an 'allOf'. This behavior is now changed in the 2019-09 json-schema spec and '$ref' can be mixed with other keywords. The json-schema library doesn't yet support this, but the tooling now does a fixup for this and either way works. This has been a constant source of review comments, so let's change this treewide so everyone copies the simpler syntax. Scripted with ruamel.yaml with some manual fixups. Some minor whitespace changes from the script. Signed-off-by: Rob Herring <robh@kernel.org> Acked-by: Maxime Ripard <mripard@kernel.org> Acked-by: Lee Jones <lee.jones@linaro.org> Acked-By: Vinod Koul <vkoul@kernel.org> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com> Acked-by: Wolfram Sang <wsa@the-dreams.de> # for I2C Reviewed-by: Linus Walleij <linus.walleij@linaro.org> Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for-iio Reviewed-by: Stephen Boyd <sboyd@kernel.org> # clock Signed-off-by: Rob Herring <robh@kernel.org>
162 lines
3.5 KiB
YAML
162 lines
3.5 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/mfd/st,stm32-timers.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: STMicroelectronics STM32 Timers bindings
|
|
|
|
description: |
|
|
This hardware block provides 3 types of timer along with PWM functionality:
|
|
- advanced-control timers consist of a 16-bit auto-reload counter driven
|
|
by a programmable prescaler, break input feature, PWM outputs and
|
|
complementary PWM outputs channels.
|
|
- general-purpose timers consist of a 16-bit or 32-bit auto-reload counter
|
|
driven by a programmable prescaler and PWM outputs.
|
|
- basic timers consist of a 16-bit auto-reload counter driven by a
|
|
programmable prescaler.
|
|
|
|
maintainers:
|
|
- Benjamin Gaignard <benjamin.gaignard@st.com>
|
|
- Fabrice Gasnier <fabrice.gasnier@st.com>
|
|
|
|
properties:
|
|
compatible:
|
|
const: st,stm32-timers
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
clocks:
|
|
maxItems: 1
|
|
|
|
clock-names:
|
|
items:
|
|
- const: int
|
|
|
|
reset:
|
|
maxItems: 1
|
|
|
|
dmas:
|
|
minItems: 1
|
|
maxItems: 7
|
|
|
|
dma-names:
|
|
items:
|
|
enum: [ ch1, ch2, ch3, ch4, up, trig, com ]
|
|
minItems: 1
|
|
maxItems: 7
|
|
|
|
"#address-cells":
|
|
const: 1
|
|
|
|
"#size-cells":
|
|
const: 0
|
|
|
|
pwm:
|
|
type: object
|
|
|
|
properties:
|
|
compatible:
|
|
const: st,stm32-pwm
|
|
|
|
"#pwm-cells":
|
|
const: 3
|
|
|
|
st,breakinput:
|
|
description:
|
|
One or two <index level filter> to describe break input
|
|
configurations.
|
|
$ref: /schemas/types.yaml#/definitions/uint32-matrix
|
|
items:
|
|
items:
|
|
- description: |
|
|
"index" indicates on which break input (0 or 1) the
|
|
configuration should be applied.
|
|
enum: [0, 1]
|
|
- description: |
|
|
"level" gives the active level (0=low or 1=high) of the
|
|
input signal for this configuration
|
|
enum: [0, 1]
|
|
- description: |
|
|
"filter" gives the filtering value (up to 15) to be applied.
|
|
maximum: 15
|
|
minItems: 1
|
|
maxItems: 2
|
|
|
|
required:
|
|
- "#pwm-cells"
|
|
- compatible
|
|
|
|
patternProperties:
|
|
"^timer@[0-9]+$":
|
|
type: object
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- st,stm32-timer-trigger
|
|
- st,stm32h7-timer-trigger
|
|
|
|
reg:
|
|
description: Identify trigger hardware block.
|
|
items:
|
|
minimum: 0
|
|
maximum: 16
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
|
|
counter:
|
|
type: object
|
|
|
|
properties:
|
|
compatible:
|
|
const: st,stm32-timer-counter
|
|
|
|
required:
|
|
- compatible
|
|
|
|
required:
|
|
- "#address-cells"
|
|
- "#size-cells"
|
|
- compatible
|
|
- reg
|
|
- clocks
|
|
- clock-names
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/clock/stm32mp1-clks.h>
|
|
timers2: timers@40000000 {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
compatible = "st,stm32-timers";
|
|
reg = <0x40000000 0x400>;
|
|
clocks = <&rcc TIM2_K>;
|
|
clock-names = "int";
|
|
dmas = <&dmamux1 18 0x400 0x1>,
|
|
<&dmamux1 19 0x400 0x1>,
|
|
<&dmamux1 20 0x400 0x1>,
|
|
<&dmamux1 21 0x400 0x1>,
|
|
<&dmamux1 22 0x400 0x1>;
|
|
dma-names = "ch1", "ch2", "ch3", "ch4", "up";
|
|
pwm {
|
|
compatible = "st,stm32-pwm";
|
|
#pwm-cells = <3>;
|
|
st,breakinput = <0 1 5>;
|
|
};
|
|
timer@0 {
|
|
compatible = "st,stm32-timer-trigger";
|
|
reg = <0>;
|
|
};
|
|
counter {
|
|
compatible = "st,stm32-timer-counter";
|
|
};
|
|
};
|
|
|
|
...
|