mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-12-06 02:24:14 +08:00
dt-bindings: mfd: Convert stm32 timers bindings to json-schema
Convert the STM32 timers binding to DT schema format using json-schema Signed-off-by: Benjamin Gaignard <benjamin.gaignard@st.com> Signed-off-by: Rob Herring <robh@kernel.org>
This commit is contained in:
parent
93512dad33
commit
56fb34d86e
@ -1,31 +0,0 @@
|
||||
STMicroelectronics STM32 Timer quadrature encoder
|
||||
|
||||
STM32 Timer provides quadrature encoder to detect
|
||||
angular position and direction of rotary elements,
|
||||
from IN1 and IN2 input signals.
|
||||
|
||||
Must be a sub-node of an STM32 Timer device tree node.
|
||||
See ../mfd/stm32-timers.txt for details about the parent node.
|
||||
|
||||
Required properties:
|
||||
- compatible: Must be "st,stm32-timer-counter".
|
||||
- pinctrl-names: Set to "default".
|
||||
- pinctrl-0: List of phandles pointing to pin configuration nodes,
|
||||
to set CH1/CH2 pins in mode of operation for STM32
|
||||
Timer input on external pin.
|
||||
|
||||
Example:
|
||||
timers@40010000 {
|
||||
#address-cells = <1>;
|
||||
#size-cells = <0>;
|
||||
compatible = "st,stm32-timers";
|
||||
reg = <0x40010000 0x400>;
|
||||
clocks = <&rcc 0 160>;
|
||||
clock-names = "int";
|
||||
|
||||
counter {
|
||||
compatible = "st,stm32-timer-counter";
|
||||
pinctrl-names = "default";
|
||||
pinctrl-0 = <&tim1_in_pins>;
|
||||
};
|
||||
};
|
@ -1,25 +0,0 @@
|
||||
STMicroelectronics STM32 Timers IIO timer bindings
|
||||
|
||||
Must be a sub-node of an STM32 Timers device tree node.
|
||||
See ../mfd/stm32-timers.txt for details about the parent node.
|
||||
|
||||
Required parameters:
|
||||
- compatible: Must be one of:
|
||||
"st,stm32-timer-trigger"
|
||||
"st,stm32h7-timer-trigger"
|
||||
- reg: Identify trigger hardware block.
|
||||
|
||||
Example:
|
||||
timers@40010000 {
|
||||
#address-cells = <1>;
|
||||
#size-cells = <0>;
|
||||
compatible = "st,stm32-timers";
|
||||
reg = <0x40010000 0x400>;
|
||||
clocks = <&rcc 0 160>;
|
||||
clock-names = "int";
|
||||
|
||||
timer@0 {
|
||||
compatible = "st,stm32-timer-trigger";
|
||||
reg = <0>;
|
||||
};
|
||||
};
|
162
Documentation/devicetree/bindings/mfd/st,stm32-timers.yaml
Normal file
162
Documentation/devicetree/bindings/mfd/st,stm32-timers.yaml
Normal file
@ -0,0 +1,162 @@
|
||||
# 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.
|
||||
allOf:
|
||||
- $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";
|
||||
};
|
||||
};
|
||||
|
||||
...
|
@ -1,73 +0,0 @@
|
||||
STM32 Timers driver bindings
|
||||
|
||||
This IP 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 ouputs 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.
|
||||
|
||||
Required parameters:
|
||||
- compatible: must be "st,stm32-timers"
|
||||
|
||||
- reg: Physical base address and length of the controller's
|
||||
registers.
|
||||
- clock-names: Set to "int".
|
||||
- clocks: Phandle to the clock used by the timer module.
|
||||
For Clk properties, please refer to ../clock/clock-bindings.txt
|
||||
|
||||
Optional parameters:
|
||||
- resets: Phandle to the parent reset controller.
|
||||
See ../reset/st,stm32-rcc.txt
|
||||
- dmas: List of phandle to dma channels that can be used for
|
||||
this timer instance. There may be up to 7 dma channels.
|
||||
- dma-names: List of dma names. Must match 'dmas' property. Valid
|
||||
names are: "ch1", "ch2", "ch3", "ch4", "up", "trig",
|
||||
"com".
|
||||
|
||||
Optional subnodes:
|
||||
- pwm: See ../pwm/pwm-stm32.txt
|
||||
- timer: See ../iio/timer/stm32-timer-trigger.txt
|
||||
- counter: See ../counter/stm32-timer-cnt.txt
|
||||
|
||||
Example:
|
||||
timers@40010000 {
|
||||
#address-cells = <1>;
|
||||
#size-cells = <0>;
|
||||
compatible = "st,stm32-timers";
|
||||
reg = <0x40010000 0x400>;
|
||||
clocks = <&rcc 0 160>;
|
||||
clock-names = "int";
|
||||
|
||||
pwm {
|
||||
compatible = "st,stm32-pwm";
|
||||
pinctrl-0 = <&pwm1_pins>;
|
||||
pinctrl-names = "default";
|
||||
};
|
||||
|
||||
timer@0 {
|
||||
compatible = "st,stm32-timer-trigger";
|
||||
reg = <0>;
|
||||
};
|
||||
|
||||
counter {
|
||||
compatible = "st,stm32-timer-counter";
|
||||
pinctrl-names = "default";
|
||||
pinctrl-0 = <&tim1_in_pins>;
|
||||
};
|
||||
};
|
||||
|
||||
Example with all dmas:
|
||||
timer@40010000 {
|
||||
...
|
||||
dmas = <&dmamux1 11 0x400 0x0>,
|
||||
<&dmamux1 12 0x400 0x0>,
|
||||
<&dmamux1 13 0x400 0x0>,
|
||||
<&dmamux1 14 0x400 0x0>,
|
||||
<&dmamux1 15 0x400 0x0>,
|
||||
<&dmamux1 16 0x400 0x0>,
|
||||
<&dmamux1 17 0x400 0x0>;
|
||||
dma-names = "ch1", "ch2", "ch3", "ch4", "up", "trig", "com";
|
||||
...
|
||||
child nodes...
|
||||
};
|
@ -1,38 +0,0 @@
|
||||
STMicroelectronics STM32 Timers PWM bindings
|
||||
|
||||
Must be a sub-node of an STM32 Timers device tree node.
|
||||
See ../mfd/stm32-timers.txt for details about the parent node.
|
||||
|
||||
Required parameters:
|
||||
- compatible: Must be "st,stm32-pwm".
|
||||
- pinctrl-names: Set to "default".
|
||||
- pinctrl-0: List of phandles pointing to pin configuration nodes for PWM module.
|
||||
For Pinctrl properties see ../pinctrl/pinctrl-bindings.txt
|
||||
- #pwm-cells: Should be set to 3. This PWM chip uses the default 3 cells
|
||||
bindings defined in pwm.txt.
|
||||
|
||||
Optional parameters:
|
||||
- st,breakinput: One or two <index level filter> to describe break input configurations.
|
||||
"index" indicates on which break input (0 or 1) the configuration
|
||||
should be applied.
|
||||
"level" gives the active level (0=low or 1=high) of the input signal
|
||||
for this configuration.
|
||||
"filter" gives the filtering value to be applied.
|
||||
|
||||
Example:
|
||||
timers@40010000 {
|
||||
#address-cells = <1>;
|
||||
#size-cells = <0>;
|
||||
compatible = "st,stm32-timers";
|
||||
reg = <0x40010000 0x400>;
|
||||
clocks = <&rcc 0 160>;
|
||||
clock-names = "int";
|
||||
|
||||
pwm {
|
||||
compatible = "st,stm32-pwm";
|
||||
#pwm-cells = <3>;
|
||||
pinctrl-0 = <&pwm1_pins>;
|
||||
pinctrl-names = "default";
|
||||
st,breakinput = <0 1 5>;
|
||||
};
|
||||
};
|
Loading…
Reference in New Issue
Block a user