Re: [PATCH v5 6/8] dt-bindings: counter: Document stm32 quadrature encoder
From: Jonathan Cameron
Date: Sat Mar 24 2018 - 13:24:00 EST
On Fri, 9 Mar 2018 13:43:32 -0500
William Breathitt Gray <vilhelm.gray@xxxxxxxxx> wrote:
> From: Benjamin Gaignard <benjamin.gaignard@xxxxxx>
>
> Add bindings for STM32 Timer quadrature encoder.
> It is a sub-node of STM32 Timer which implement the
> counter part of the hardware.
>
> Signed-off-by: Benjamin Gaignard <benjamin.gaignard@xxxxxx>
> Signed-off-by: William Breathitt Gray <vilhelm.gray@xxxxxxxxx>
You are missing the device tree list and maintainers +CC
looks fine to me.
Jonathan
> ---
> .../bindings/counter/stm32-timer-cnt.txt | 26 ++++++++++++++++++++++
> .../devicetree/bindings/mfd/stm32-timers.txt | 7 ++++++
> 2 files changed, 33 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/counter/stm32-timer-cnt.txt
>
> diff --git a/Documentation/devicetree/bindings/counter/stm32-timer-cnt.txt b/Documentation/devicetree/bindings/counter/stm32-timer-cnt.txt
> new file mode 100644
> index 000000000000..377728128bef
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/counter/stm32-timer-cnt.txt
> @@ -0,0 +1,26 @@
> +STMicroelectronics STM32 Timer quadrature encoder
> +
> +STM32 Timer provides quadrature encoder counter mode 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 IN1/IN2 pins in mode of operation for Low-Power
> + Timer input on external pin.
> +
> +Example:
> + timers@40010000 {
> + compatible = "st,stm32-timers";
> + ...
> + counter {
> + compatible = "st,stm32-timer-counter";
> + pinctrl-names = "default";
> + pinctrl-0 = <&tim1_in_pins>;
> + };
> + };
> diff --git a/Documentation/devicetree/bindings/mfd/stm32-timers.txt b/Documentation/devicetree/bindings/mfd/stm32-timers.txt
> index 1db6e0057a63..ff9c14ada30b 100644
> --- a/Documentation/devicetree/bindings/mfd/stm32-timers.txt
> +++ b/Documentation/devicetree/bindings/mfd/stm32-timers.txt
> @@ -23,6 +23,7 @@ Optional parameters:
> 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 {
> @@ -43,4 +44,10 @@ Example:
> compatible = "st,stm32-timer-trigger";
> reg = <0>;
> };
> +
> + counter {
> + compatible = "st,stm32-timer-counter";
> + pinctrl-names = "default";
> + pinctrl-0 = <&tim1_in_pins>;
> + };
> };