* [PATCH 0/2] Convert STM32 UART bindings to yaml @ 2020-01-14 12:33 ` Benjamin Gaignard 0 siblings, 0 replies; 10+ messages in thread From: Benjamin Gaignard @ 2020-01-14 12:33 UTC (permalink / raw) To: gregkh, robh+dt, mark.rutland, mcoquelin.stm32, alexandre.torgue Cc: linux-serial, devicetree, linux-kernel, linux-stm32, linux-arm-kernel, fabrice.gasnier, erwan.leray, Benjamin Gaignard The goal of this series is to convert STM32 UART bindings to json-schema. Since STM32 UART bindings use rs485 bindings it is also the opportunity to convert them to json-schema. Benjamin Gaignard (2): dt-bindings: serial: Convert rs485 bindings to json-schema dt-bindings: serial: Convert STM32 UART to json-schema Documentation/devicetree/bindings/serial/rs485.txt | 32 +-------- .../devicetree/bindings/serial/rs485.yaml | 45 ++++++++++++ .../devicetree/bindings/serial/st,stm32-uart.yaml | 80 ++++++++++++++++++++++ .../devicetree/bindings/serial/st,stm32-usart.txt | 57 --------------- 4 files changed, 126 insertions(+), 88 deletions(-) create mode 100644 Documentation/devicetree/bindings/serial/rs485.yaml create mode 100644 Documentation/devicetree/bindings/serial/st,stm32-uart.yaml delete mode 100644 Documentation/devicetree/bindings/serial/st,stm32-usart.txt -- 2.15.0 ^ permalink raw reply [flat|nested] 10+ messages in thread
* [PATCH 0/2] Convert STM32 UART bindings to yaml @ 2020-01-14 12:33 ` Benjamin Gaignard 0 siblings, 0 replies; 10+ messages in thread From: Benjamin Gaignard @ 2020-01-14 12:33 UTC (permalink / raw) To: gregkh, robh+dt, mark.rutland, mcoquelin.stm32, alexandre.torgue Cc: devicetree, Benjamin Gaignard, linux-kernel, erwan.leray, linux-serial, fabrice.gasnier, linux-stm32, linux-arm-kernel The goal of this series is to convert STM32 UART bindings to json-schema. Since STM32 UART bindings use rs485 bindings it is also the opportunity to convert them to json-schema. Benjamin Gaignard (2): dt-bindings: serial: Convert rs485 bindings to json-schema dt-bindings: serial: Convert STM32 UART to json-schema Documentation/devicetree/bindings/serial/rs485.txt | 32 +-------- .../devicetree/bindings/serial/rs485.yaml | 45 ++++++++++++ .../devicetree/bindings/serial/st,stm32-uart.yaml | 80 ++++++++++++++++++++++ .../devicetree/bindings/serial/st,stm32-usart.txt | 57 --------------- 4 files changed, 126 insertions(+), 88 deletions(-) create mode 100644 Documentation/devicetree/bindings/serial/rs485.yaml create mode 100644 Documentation/devicetree/bindings/serial/st,stm32-uart.yaml delete mode 100644 Documentation/devicetree/bindings/serial/st,stm32-usart.txt -- 2.15.0 _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel ^ permalink raw reply [flat|nested] 10+ messages in thread
* [PATCH 1/2] dt-bindings: serial: Convert rs485 bindings to json-schema 2020-01-14 12:33 ` Benjamin Gaignard @ 2020-01-14 12:33 ` Benjamin Gaignard -1 siblings, 0 replies; 10+ messages in thread From: Benjamin Gaignard @ 2020-01-14 12:33 UTC (permalink / raw) To: gregkh, robh+dt, mark.rutland, mcoquelin.stm32, alexandre.torgue Cc: linux-serial, devicetree, linux-kernel, linux-stm32, linux-arm-kernel, fabrice.gasnier, erwan.leray, Benjamin Gaignard Convert rs485 binding to yaml style file. Signed-off-by: Benjamin Gaignard <benjamin.gaignard@st.com> --- Documentation/devicetree/bindings/serial/rs485.txt | 32 +-------------- .../devicetree/bindings/serial/rs485.yaml | 45 ++++++++++++++++++++++ 2 files changed, 46 insertions(+), 31 deletions(-) create mode 100644 Documentation/devicetree/bindings/serial/rs485.yaml diff --git a/Documentation/devicetree/bindings/serial/rs485.txt b/Documentation/devicetree/bindings/serial/rs485.txt index b92592dff6dd..a7fe93efc4a5 100644 --- a/Documentation/devicetree/bindings/serial/rs485.txt +++ b/Documentation/devicetree/bindings/serial/rs485.txt @@ -1,31 +1 @@ -* RS485 serial communications - -The RTS signal is capable of automatically controlling line direction for -the built-in half-duplex mode. -The properties described hereafter shall be given to a half-duplex capable -UART node. - -Optional properties: -- rs485-rts-delay: prop-encoded-array <a b> where: - * a is the delay between rts signal and beginning of data sent in milliseconds. - it corresponds to the delay before sending data. - * b is the delay between end of data sent and rts signal in milliseconds - it corresponds to the delay after sending data and actual release of the line. - If this property is not specified, <0 0> is assumed. -- rs485-rts-active-low: drive RTS low when sending (default is high). -- linux,rs485-enabled-at-boot-time: empty property telling to enable the rs485 - feature at boot time. It can be disabled later with proper ioctl. -- rs485-rx-during-tx: empty property that enables the receiving of data even - while sending data. - -RS485 example for Atmel USART: - usart0: serial@fff8c000 { - compatible = "atmel,at91sam9260-usart"; - reg = <0xfff8c000 0x4000>; - interrupts = <7>; - atmel,use-dma-rx; - atmel,use-dma-tx; - linux,rs485-enabled-at-boot-time; - rs485-rts-delay = <0 200>; // in milliseconds - }; - +See rs485.yaml diff --git a/Documentation/devicetree/bindings/serial/rs485.yaml b/Documentation/devicetree/bindings/serial/rs485.yaml new file mode 100644 index 000000000000..65c6a98969a8 --- /dev/null +++ b/Documentation/devicetree/bindings/serial/rs485.yaml @@ -0,0 +1,45 @@ +# SPDX-License-Identifier: GPL-2.0 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/serial/rs485.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: RS485 serial communications Bindings + +description: The RTS signal is capable of automatically controlling + line direction for the built-in half-duplex mode. + The properties described hereafter shall be given to a + half-duplex capable UART node. + +maintainers: + - Rob Herring <robh@kernel.org> + +properties: + rs485-rts-delay: + description: prop-encoded-array <a b> + allOf: + - $ref: /schemas/types.yaml#/definitions/uint32-matrix + - items: + items: + - description: + Delay between rts signal and beginning of data sent in milliseconds. + It corresponds to the delay before sending data. + $ref: "/schemas/types.yaml#/definitions/uint32" + default: 0 + - description: + Delay between end of data sent and rts signal in milliseconds. + It corresponds to the delay after sending data and actual release of the line. + $ref: "/schemas/types.yaml#/definitions/uint32" + default: 0 + + rs485-rts-active-low: + description: drive RTS low when sending (default is high). + $ref: /schemas/types.yaml#/definitions/flag + + linux,rs485-enabled-at-boot-time: + description: enables the rs485 feature at boot time. It can be disabled later with proper ioctl. + $ref: /schemas/types.yaml#/definitions/flag + + rs485-rx-during-tx: + description: enables the receiving of data even while sending data. + $ref: /schemas/types.yaml#/definitions/flag -- 2.15.0 ^ permalink raw reply related [flat|nested] 10+ messages in thread
* [PATCH 1/2] dt-bindings: serial: Convert rs485 bindings to json-schema @ 2020-01-14 12:33 ` Benjamin Gaignard 0 siblings, 0 replies; 10+ messages in thread From: Benjamin Gaignard @ 2020-01-14 12:33 UTC (permalink / raw) To: gregkh, robh+dt, mark.rutland, mcoquelin.stm32, alexandre.torgue Cc: devicetree, Benjamin Gaignard, linux-kernel, erwan.leray, linux-serial, fabrice.gasnier, linux-stm32, linux-arm-kernel Convert rs485 binding to yaml style file. Signed-off-by: Benjamin Gaignard <benjamin.gaignard@st.com> --- Documentation/devicetree/bindings/serial/rs485.txt | 32 +-------------- .../devicetree/bindings/serial/rs485.yaml | 45 ++++++++++++++++++++++ 2 files changed, 46 insertions(+), 31 deletions(-) create mode 100644 Documentation/devicetree/bindings/serial/rs485.yaml diff --git a/Documentation/devicetree/bindings/serial/rs485.txt b/Documentation/devicetree/bindings/serial/rs485.txt index b92592dff6dd..a7fe93efc4a5 100644 --- a/Documentation/devicetree/bindings/serial/rs485.txt +++ b/Documentation/devicetree/bindings/serial/rs485.txt @@ -1,31 +1 @@ -* RS485 serial communications - -The RTS signal is capable of automatically controlling line direction for -the built-in half-duplex mode. -The properties described hereafter shall be given to a half-duplex capable -UART node. - -Optional properties: -- rs485-rts-delay: prop-encoded-array <a b> where: - * a is the delay between rts signal and beginning of data sent in milliseconds. - it corresponds to the delay before sending data. - * b is the delay between end of data sent and rts signal in milliseconds - it corresponds to the delay after sending data and actual release of the line. - If this property is not specified, <0 0> is assumed. -- rs485-rts-active-low: drive RTS low when sending (default is high). -- linux,rs485-enabled-at-boot-time: empty property telling to enable the rs485 - feature at boot time. It can be disabled later with proper ioctl. -- rs485-rx-during-tx: empty property that enables the receiving of data even - while sending data. - -RS485 example for Atmel USART: - usart0: serial@fff8c000 { - compatible = "atmel,at91sam9260-usart"; - reg = <0xfff8c000 0x4000>; - interrupts = <7>; - atmel,use-dma-rx; - atmel,use-dma-tx; - linux,rs485-enabled-at-boot-time; - rs485-rts-delay = <0 200>; // in milliseconds - }; - +See rs485.yaml diff --git a/Documentation/devicetree/bindings/serial/rs485.yaml b/Documentation/devicetree/bindings/serial/rs485.yaml new file mode 100644 index 000000000000..65c6a98969a8 --- /dev/null +++ b/Documentation/devicetree/bindings/serial/rs485.yaml @@ -0,0 +1,45 @@ +# SPDX-License-Identifier: GPL-2.0 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/serial/rs485.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: RS485 serial communications Bindings + +description: The RTS signal is capable of automatically controlling + line direction for the built-in half-duplex mode. + The properties described hereafter shall be given to a + half-duplex capable UART node. + +maintainers: + - Rob Herring <robh@kernel.org> + +properties: + rs485-rts-delay: + description: prop-encoded-array <a b> + allOf: + - $ref: /schemas/types.yaml#/definitions/uint32-matrix + - items: + items: + - description: + Delay between rts signal and beginning of data sent in milliseconds. + It corresponds to the delay before sending data. + $ref: "/schemas/types.yaml#/definitions/uint32" + default: 0 + - description: + Delay between end of data sent and rts signal in milliseconds. + It corresponds to the delay after sending data and actual release of the line. + $ref: "/schemas/types.yaml#/definitions/uint32" + default: 0 + + rs485-rts-active-low: + description: drive RTS low when sending (default is high). + $ref: /schemas/types.yaml#/definitions/flag + + linux,rs485-enabled-at-boot-time: + description: enables the rs485 feature at boot time. It can be disabled later with proper ioctl. + $ref: /schemas/types.yaml#/definitions/flag + + rs485-rx-during-tx: + description: enables the receiving of data even while sending data. + $ref: /schemas/types.yaml#/definitions/flag -- 2.15.0 _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel ^ permalink raw reply related [flat|nested] 10+ messages in thread
* Re: [PATCH 1/2] dt-bindings: serial: Convert rs485 bindings to json-schema 2020-01-14 12:33 ` Benjamin Gaignard @ 2020-01-21 22:20 ` Rob Herring -1 siblings, 0 replies; 10+ messages in thread From: Rob Herring @ 2020-01-21 22:20 UTC (permalink / raw) To: Benjamin Gaignard Cc: gregkh, mark.rutland, mcoquelin.stm32, alexandre.torgue, linux-serial, devicetree, linux-kernel, linux-stm32, linux-arm-kernel, fabrice.gasnier, erwan.leray On Tue, Jan 14, 2020 at 01:33:28PM +0100, Benjamin Gaignard wrote: > Convert rs485 binding to yaml style file. > > Signed-off-by: Benjamin Gaignard <benjamin.gaignard@st.com> > --- > Documentation/devicetree/bindings/serial/rs485.txt | 32 +-------------- > .../devicetree/bindings/serial/rs485.yaml | 45 ++++++++++++++++++++++ > 2 files changed, 46 insertions(+), 31 deletions(-) > create mode 100644 Documentation/devicetree/bindings/serial/rs485.yaml > > diff --git a/Documentation/devicetree/bindings/serial/rs485.txt b/Documentation/devicetree/bindings/serial/rs485.txt > index b92592dff6dd..a7fe93efc4a5 100644 > --- a/Documentation/devicetree/bindings/serial/rs485.txt > +++ b/Documentation/devicetree/bindings/serial/rs485.txt > @@ -1,31 +1 @@ > -* RS485 serial communications > - > -The RTS signal is capable of automatically controlling line direction for > -the built-in half-duplex mode. > -The properties described hereafter shall be given to a half-duplex capable > -UART node. > - > -Optional properties: > -- rs485-rts-delay: prop-encoded-array <a b> where: > - * a is the delay between rts signal and beginning of data sent in milliseconds. > - it corresponds to the delay before sending data. > - * b is the delay between end of data sent and rts signal in milliseconds > - it corresponds to the delay after sending data and actual release of the line. > - If this property is not specified, <0 0> is assumed. > -- rs485-rts-active-low: drive RTS low when sending (default is high). > -- linux,rs485-enabled-at-boot-time: empty property telling to enable the rs485 > - feature at boot time. It can be disabled later with proper ioctl. > -- rs485-rx-during-tx: empty property that enables the receiving of data even > - while sending data. > - > -RS485 example for Atmel USART: > - usart0: serial@fff8c000 { > - compatible = "atmel,at91sam9260-usart"; > - reg = <0xfff8c000 0x4000>; > - interrupts = <7>; > - atmel,use-dma-rx; > - atmel,use-dma-tx; > - linux,rs485-enabled-at-boot-time; > - rs485-rts-delay = <0 200>; // in milliseconds > - }; > - > +See rs485.yaml > diff --git a/Documentation/devicetree/bindings/serial/rs485.yaml b/Documentation/devicetree/bindings/serial/rs485.yaml > new file mode 100644 > index 000000000000..65c6a98969a8 > --- /dev/null > +++ b/Documentation/devicetree/bindings/serial/rs485.yaml > @@ -0,0 +1,45 @@ > +# SPDX-License-Identifier: GPL-2.0 > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/serial/rs485.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: RS485 serial communications Bindings > + > +description: The RTS signal is capable of automatically controlling > + line direction for the built-in half-duplex mode. > + The properties described hereafter shall be given to a > + half-duplex capable UART node. > + > +maintainers: > + - Rob Herring <robh@kernel.org> > + > +properties: > + rs485-rts-delay: > + description: prop-encoded-array <a b> > + allOf: > + - $ref: /schemas/types.yaml#/definitions/uint32-matrix > + - items: > + items: > + - description: > + Delay between rts signal and beginning of data sent in milliseconds. > + It corresponds to the delay before sending data. > + $ref: "/schemas/types.yaml#/definitions/uint32" This is not correct. The types only apply to whole properties. Is there a maximum? Seems like 1 sec would be more than anyone would ever want? > + default: 0 > + - description: > + Delay between end of data sent and rts signal in milliseconds. > + It corresponds to the delay after sending data and actual release of the line. > + $ref: "/schemas/types.yaml#/definitions/uint32" > + default: 0 > + > + rs485-rts-active-low: > + description: drive RTS low when sending (default is high). > + $ref: /schemas/types.yaml#/definitions/flag > + > + linux,rs485-enabled-at-boot-time: > + description: enables the rs485 feature at boot time. It can be disabled later with proper ioctl. > + $ref: /schemas/types.yaml#/definitions/flag > + > + rs485-rx-during-tx: > + description: enables the receiving of data even while sending data. > + $ref: /schemas/types.yaml#/definitions/flag > -- > 2.15.0 > ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH 1/2] dt-bindings: serial: Convert rs485 bindings to json-schema @ 2020-01-21 22:20 ` Rob Herring 0 siblings, 0 replies; 10+ messages in thread From: Rob Herring @ 2020-01-21 22:20 UTC (permalink / raw) To: Benjamin Gaignard Cc: mark.rutland, devicetree, alexandre.torgue, gregkh, linux-kernel, erwan.leray, mcoquelin.stm32, linux-serial, fabrice.gasnier, linux-stm32, linux-arm-kernel On Tue, Jan 14, 2020 at 01:33:28PM +0100, Benjamin Gaignard wrote: > Convert rs485 binding to yaml style file. > > Signed-off-by: Benjamin Gaignard <benjamin.gaignard@st.com> > --- > Documentation/devicetree/bindings/serial/rs485.txt | 32 +-------------- > .../devicetree/bindings/serial/rs485.yaml | 45 ++++++++++++++++++++++ > 2 files changed, 46 insertions(+), 31 deletions(-) > create mode 100644 Documentation/devicetree/bindings/serial/rs485.yaml > > diff --git a/Documentation/devicetree/bindings/serial/rs485.txt b/Documentation/devicetree/bindings/serial/rs485.txt > index b92592dff6dd..a7fe93efc4a5 100644 > --- a/Documentation/devicetree/bindings/serial/rs485.txt > +++ b/Documentation/devicetree/bindings/serial/rs485.txt > @@ -1,31 +1 @@ > -* RS485 serial communications > - > -The RTS signal is capable of automatically controlling line direction for > -the built-in half-duplex mode. > -The properties described hereafter shall be given to a half-duplex capable > -UART node. > - > -Optional properties: > -- rs485-rts-delay: prop-encoded-array <a b> where: > - * a is the delay between rts signal and beginning of data sent in milliseconds. > - it corresponds to the delay before sending data. > - * b is the delay between end of data sent and rts signal in milliseconds > - it corresponds to the delay after sending data and actual release of the line. > - If this property is not specified, <0 0> is assumed. > -- rs485-rts-active-low: drive RTS low when sending (default is high). > -- linux,rs485-enabled-at-boot-time: empty property telling to enable the rs485 > - feature at boot time. It can be disabled later with proper ioctl. > -- rs485-rx-during-tx: empty property that enables the receiving of data even > - while sending data. > - > -RS485 example for Atmel USART: > - usart0: serial@fff8c000 { > - compatible = "atmel,at91sam9260-usart"; > - reg = <0xfff8c000 0x4000>; > - interrupts = <7>; > - atmel,use-dma-rx; > - atmel,use-dma-tx; > - linux,rs485-enabled-at-boot-time; > - rs485-rts-delay = <0 200>; // in milliseconds > - }; > - > +See rs485.yaml > diff --git a/Documentation/devicetree/bindings/serial/rs485.yaml b/Documentation/devicetree/bindings/serial/rs485.yaml > new file mode 100644 > index 000000000000..65c6a98969a8 > --- /dev/null > +++ b/Documentation/devicetree/bindings/serial/rs485.yaml > @@ -0,0 +1,45 @@ > +# SPDX-License-Identifier: GPL-2.0 > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/serial/rs485.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: RS485 serial communications Bindings > + > +description: The RTS signal is capable of automatically controlling > + line direction for the built-in half-duplex mode. > + The properties described hereafter shall be given to a > + half-duplex capable UART node. > + > +maintainers: > + - Rob Herring <robh@kernel.org> > + > +properties: > + rs485-rts-delay: > + description: prop-encoded-array <a b> > + allOf: > + - $ref: /schemas/types.yaml#/definitions/uint32-matrix > + - items: > + items: > + - description: > + Delay between rts signal and beginning of data sent in milliseconds. > + It corresponds to the delay before sending data. > + $ref: "/schemas/types.yaml#/definitions/uint32" This is not correct. The types only apply to whole properties. Is there a maximum? Seems like 1 sec would be more than anyone would ever want? > + default: 0 > + - description: > + Delay between end of data sent and rts signal in milliseconds. > + It corresponds to the delay after sending data and actual release of the line. > + $ref: "/schemas/types.yaml#/definitions/uint32" > + default: 0 > + > + rs485-rts-active-low: > + description: drive RTS low when sending (default is high). > + $ref: /schemas/types.yaml#/definitions/flag > + > + linux,rs485-enabled-at-boot-time: > + description: enables the rs485 feature at boot time. It can be disabled later with proper ioctl. > + $ref: /schemas/types.yaml#/definitions/flag > + > + rs485-rx-during-tx: > + description: enables the receiving of data even while sending data. > + $ref: /schemas/types.yaml#/definitions/flag > -- > 2.15.0 > _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel ^ permalink raw reply [flat|nested] 10+ messages in thread
* [PATCH 2/2] dt-bindings: serial: Convert STM32 UART to json-schema 2020-01-14 12:33 ` Benjamin Gaignard @ 2020-01-14 12:33 ` Benjamin Gaignard -1 siblings, 0 replies; 10+ messages in thread From: Benjamin Gaignard @ 2020-01-14 12:33 UTC (permalink / raw) To: gregkh, robh+dt, mark.rutland, mcoquelin.stm32, alexandre.torgue Cc: linux-serial, devicetree, linux-kernel, linux-stm32, linux-arm-kernel, fabrice.gasnier, erwan.leray, Benjamin Gaignard Convert STM32 UART bindings to json-schema. Signed-off-by: Benjamin Gaignard <benjamin.gaignard@st.com> --- .../devicetree/bindings/serial/st,stm32-uart.yaml | 80 ++++++++++++++++++++++ .../devicetree/bindings/serial/st,stm32-usart.txt | 57 --------------- 2 files changed, 80 insertions(+), 57 deletions(-) create mode 100644 Documentation/devicetree/bindings/serial/st,stm32-uart.yaml delete mode 100644 Documentation/devicetree/bindings/serial/st,stm32-usart.txt diff --git a/Documentation/devicetree/bindings/serial/st,stm32-uart.yaml b/Documentation/devicetree/bindings/serial/st,stm32-uart.yaml new file mode 100644 index 000000000000..238c44192d31 --- /dev/null +++ b/Documentation/devicetree/bindings/serial/st,stm32-uart.yaml @@ -0,0 +1,80 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/serial/st,stm32-uart.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +maintainers: + - Erwan Le Ray <erwan.leray@st.com> + +title: STMicroelectronics STM32 USART bindings + +allOf: + - $ref: rs485.yaml + +properties: + compatible: + enum: + - st,stm32-uart + - st,stm32f7-uart + - st,stm32h7-uart + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + clocks: + maxItems: 1 + + resets: + maxItems: 1 + + label: + description: label associated with this uart + + st,hw-flow-ctrl: + description: enable hardware flow control + $ref: /schemas/types.yaml#/definitions/flag + + dmas: + minItems: 1 + maxItems: 2 + + dma-names: + items: + enum: [ rx, tx ] + minItems: 1 + maxItems: 2 + + wakeup-source: true + + rs485-rts-delay: true + rs485-rts-active-low: true + linux,rs485-enabled-at-boot-time: true + rs485-rx-during-tx: true + +required: + - compatible + - reg + - interrupts + - clocks + +additionalProperties: false + +examples: + - | + #include <dt-bindings/clock/stm32mp1-clks.h> + usart1: serial@40011000 { + compatible = "st,stm32-uart"; + reg = <0x40011000 0x400>; + interrupts = <37>; + clocks = <&rcc 0 164>; + dmas = <&dma2 2 4 0x414 0x0>, + <&dma2 7 4 0x414 0x0>; + dma-names = "rx", "tx"; + rs485-rts-active-low; + }; + +... diff --git a/Documentation/devicetree/bindings/serial/st,stm32-usart.txt b/Documentation/devicetree/bindings/serial/st,stm32-usart.txt deleted file mode 100644 index 8620f7fcbd50..000000000000 --- a/Documentation/devicetree/bindings/serial/st,stm32-usart.txt +++ /dev/null @@ -1,57 +0,0 @@ -* STMicroelectronics STM32 USART - -Required properties: -- compatible: can be either: - - "st,stm32-uart", - - "st,stm32f7-uart", - - "st,stm32h7-uart". - depending is compatible with stm32(f4), stm32f7 or stm32h7. -- reg: The address and length of the peripheral registers space -- interrupts: - - The interrupt line for the USART instance, - - An optional wake-up interrupt. -- clocks: The input clock of the USART instance - -Optional properties: -- resets: Must contain the phandle to the reset controller. -- pinctrl: The reference on the pins configuration -- st,hw-flow-ctrl: bool flag to enable hardware flow control. -- rs485-rts-delay, rs485-rx-during-tx, rs485-rts-active-low, - linux,rs485-enabled-at-boot-time: see rs485.txt. -- dmas: phandle(s) to DMA controller node(s). Refer to stm32-dma.txt -- dma-names: "rx" and/or "tx" -- wakeup-source: bool flag to indicate this device has wakeup capabilities -- interrupt-names, if optional wake-up interrupt is used, should be: - - "event": the name for the interrupt line of the USART instance - - "wakeup" the name for the optional wake-up interrupt - - -Examples: -usart4: serial@40004c00 { - compatible = "st,stm32-uart"; - reg = <0x40004c00 0x400>; - interrupts = <52>; - clocks = <&clk_pclk1>; - pinctrl-names = "default"; - pinctrl-0 = <&pinctrl_usart4>; -}; - -usart2: serial@40004400 { - compatible = "st,stm32-uart"; - reg = <0x40004400 0x400>; - interrupts = <38>; - clocks = <&clk_pclk1>; - st,hw-flow-ctrl; - pinctrl-names = "default"; - pinctrl-0 = <&pinctrl_usart2 &pinctrl_usart2_rtscts>; -}; - -usart1: serial@40011000 { - compatible = "st,stm32-uart"; - reg = <0x40011000 0x400>; - interrupts = <37>; - clocks = <&rcc 0 164>; - dmas = <&dma2 2 4 0x414 0x0>, - <&dma2 7 4 0x414 0x0>; - dma-names = "rx", "tx"; -}; -- 2.15.0 ^ permalink raw reply related [flat|nested] 10+ messages in thread
* [PATCH 2/2] dt-bindings: serial: Convert STM32 UART to json-schema @ 2020-01-14 12:33 ` Benjamin Gaignard 0 siblings, 0 replies; 10+ messages in thread From: Benjamin Gaignard @ 2020-01-14 12:33 UTC (permalink / raw) To: gregkh, robh+dt, mark.rutland, mcoquelin.stm32, alexandre.torgue Cc: devicetree, Benjamin Gaignard, linux-kernel, erwan.leray, linux-serial, fabrice.gasnier, linux-stm32, linux-arm-kernel Convert STM32 UART bindings to json-schema. Signed-off-by: Benjamin Gaignard <benjamin.gaignard@st.com> --- .../devicetree/bindings/serial/st,stm32-uart.yaml | 80 ++++++++++++++++++++++ .../devicetree/bindings/serial/st,stm32-usart.txt | 57 --------------- 2 files changed, 80 insertions(+), 57 deletions(-) create mode 100644 Documentation/devicetree/bindings/serial/st,stm32-uart.yaml delete mode 100644 Documentation/devicetree/bindings/serial/st,stm32-usart.txt diff --git a/Documentation/devicetree/bindings/serial/st,stm32-uart.yaml b/Documentation/devicetree/bindings/serial/st,stm32-uart.yaml new file mode 100644 index 000000000000..238c44192d31 --- /dev/null +++ b/Documentation/devicetree/bindings/serial/st,stm32-uart.yaml @@ -0,0 +1,80 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/serial/st,stm32-uart.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +maintainers: + - Erwan Le Ray <erwan.leray@st.com> + +title: STMicroelectronics STM32 USART bindings + +allOf: + - $ref: rs485.yaml + +properties: + compatible: + enum: + - st,stm32-uart + - st,stm32f7-uart + - st,stm32h7-uart + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + clocks: + maxItems: 1 + + resets: + maxItems: 1 + + label: + description: label associated with this uart + + st,hw-flow-ctrl: + description: enable hardware flow control + $ref: /schemas/types.yaml#/definitions/flag + + dmas: + minItems: 1 + maxItems: 2 + + dma-names: + items: + enum: [ rx, tx ] + minItems: 1 + maxItems: 2 + + wakeup-source: true + + rs485-rts-delay: true + rs485-rts-active-low: true + linux,rs485-enabled-at-boot-time: true + rs485-rx-during-tx: true + +required: + - compatible + - reg + - interrupts + - clocks + +additionalProperties: false + +examples: + - | + #include <dt-bindings/clock/stm32mp1-clks.h> + usart1: serial@40011000 { + compatible = "st,stm32-uart"; + reg = <0x40011000 0x400>; + interrupts = <37>; + clocks = <&rcc 0 164>; + dmas = <&dma2 2 4 0x414 0x0>, + <&dma2 7 4 0x414 0x0>; + dma-names = "rx", "tx"; + rs485-rts-active-low; + }; + +... diff --git a/Documentation/devicetree/bindings/serial/st,stm32-usart.txt b/Documentation/devicetree/bindings/serial/st,stm32-usart.txt deleted file mode 100644 index 8620f7fcbd50..000000000000 --- a/Documentation/devicetree/bindings/serial/st,stm32-usart.txt +++ /dev/null @@ -1,57 +0,0 @@ -* STMicroelectronics STM32 USART - -Required properties: -- compatible: can be either: - - "st,stm32-uart", - - "st,stm32f7-uart", - - "st,stm32h7-uart". - depending is compatible with stm32(f4), stm32f7 or stm32h7. -- reg: The address and length of the peripheral registers space -- interrupts: - - The interrupt line for the USART instance, - - An optional wake-up interrupt. -- clocks: The input clock of the USART instance - -Optional properties: -- resets: Must contain the phandle to the reset controller. -- pinctrl: The reference on the pins configuration -- st,hw-flow-ctrl: bool flag to enable hardware flow control. -- rs485-rts-delay, rs485-rx-during-tx, rs485-rts-active-low, - linux,rs485-enabled-at-boot-time: see rs485.txt. -- dmas: phandle(s) to DMA controller node(s). Refer to stm32-dma.txt -- dma-names: "rx" and/or "tx" -- wakeup-source: bool flag to indicate this device has wakeup capabilities -- interrupt-names, if optional wake-up interrupt is used, should be: - - "event": the name for the interrupt line of the USART instance - - "wakeup" the name for the optional wake-up interrupt - - -Examples: -usart4: serial@40004c00 { - compatible = "st,stm32-uart"; - reg = <0x40004c00 0x400>; - interrupts = <52>; - clocks = <&clk_pclk1>; - pinctrl-names = "default"; - pinctrl-0 = <&pinctrl_usart4>; -}; - -usart2: serial@40004400 { - compatible = "st,stm32-uart"; - reg = <0x40004400 0x400>; - interrupts = <38>; - clocks = <&clk_pclk1>; - st,hw-flow-ctrl; - pinctrl-names = "default"; - pinctrl-0 = <&pinctrl_usart2 &pinctrl_usart2_rtscts>; -}; - -usart1: serial@40011000 { - compatible = "st,stm32-uart"; - reg = <0x40011000 0x400>; - interrupts = <37>; - clocks = <&rcc 0 164>; - dmas = <&dma2 2 4 0x414 0x0>, - <&dma2 7 4 0x414 0x0>; - dma-names = "rx", "tx"; -}; -- 2.15.0 _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel ^ permalink raw reply related [flat|nested] 10+ messages in thread
* Re: [PATCH 2/2] dt-bindings: serial: Convert STM32 UART to json-schema 2020-01-14 12:33 ` Benjamin Gaignard @ 2020-01-21 22:22 ` Rob Herring -1 siblings, 0 replies; 10+ messages in thread From: Rob Herring @ 2020-01-21 22:22 UTC (permalink / raw) To: Benjamin Gaignard Cc: gregkh, mark.rutland, mcoquelin.stm32, alexandre.torgue, linux-serial, devicetree, linux-kernel, linux-stm32, linux-arm-kernel, fabrice.gasnier, erwan.leray On Tue, Jan 14, 2020 at 01:33:29PM +0100, Benjamin Gaignard wrote: > Convert STM32 UART bindings to json-schema. > > Signed-off-by: Benjamin Gaignard <benjamin.gaignard@st.com> > --- > .../devicetree/bindings/serial/st,stm32-uart.yaml | 80 ++++++++++++++++++++++ > .../devicetree/bindings/serial/st,stm32-usart.txt | 57 --------------- > 2 files changed, 80 insertions(+), 57 deletions(-) > create mode 100644 Documentation/devicetree/bindings/serial/st,stm32-uart.yaml > delete mode 100644 Documentation/devicetree/bindings/serial/st,stm32-usart.txt Looks fine. Will pick up when you respin patch 1. Rob ^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [PATCH 2/2] dt-bindings: serial: Convert STM32 UART to json-schema @ 2020-01-21 22:22 ` Rob Herring 0 siblings, 0 replies; 10+ messages in thread From: Rob Herring @ 2020-01-21 22:22 UTC (permalink / raw) To: Benjamin Gaignard Cc: mark.rutland, devicetree, alexandre.torgue, gregkh, linux-kernel, erwan.leray, mcoquelin.stm32, linux-serial, fabrice.gasnier, linux-stm32, linux-arm-kernel On Tue, Jan 14, 2020 at 01:33:29PM +0100, Benjamin Gaignard wrote: > Convert STM32 UART bindings to json-schema. > > Signed-off-by: Benjamin Gaignard <benjamin.gaignard@st.com> > --- > .../devicetree/bindings/serial/st,stm32-uart.yaml | 80 ++++++++++++++++++++++ > .../devicetree/bindings/serial/st,stm32-usart.txt | 57 --------------- > 2 files changed, 80 insertions(+), 57 deletions(-) > create mode 100644 Documentation/devicetree/bindings/serial/st,stm32-uart.yaml > delete mode 100644 Documentation/devicetree/bindings/serial/st,stm32-usart.txt Looks fine. Will pick up when you respin patch 1. Rob _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel ^ permalink raw reply [flat|nested] 10+ messages in thread
end of thread, other threads:[~2020-01-21 22:22 UTC | newest] Thread overview: 10+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2020-01-14 12:33 [PATCH 0/2] Convert STM32 UART bindings to yaml Benjamin Gaignard 2020-01-14 12:33 ` Benjamin Gaignard 2020-01-14 12:33 ` [PATCH 1/2] dt-bindings: serial: Convert rs485 bindings to json-schema Benjamin Gaignard 2020-01-14 12:33 ` Benjamin Gaignard 2020-01-21 22:20 ` Rob Herring 2020-01-21 22:20 ` Rob Herring 2020-01-14 12:33 ` [PATCH 2/2] dt-bindings: serial: Convert STM32 UART " Benjamin Gaignard 2020-01-14 12:33 ` Benjamin Gaignard 2020-01-21 22:22 ` Rob Herring 2020-01-21 22:22 ` Rob Herring
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.