On Fri, Oct 09, 2026 at 06:55:59PM +0800, Quchaosheng wrote: > From: Chaosheng Qu <[email protected]> > > Convert the TPD12S015 HDMI level shifter binding to DT schema. > > The TI TPD12S015 is an HDMI companion chip that combines a level shifter > and ESD protection circuitry. Document the two ports it exposes between > the HDMI transmitter and the connector. > > The tpd12s016 is software compatible with the tpd12s015 and is listed as > a fallback compatible by am57xx-idk-common.dtsi, so accept it as a > fallback of "ti,tpd12s015". The driver matches on "ti,tpd12s015" only, so > a board using the tpd12s016 must list both compatibles. > > Assisted-by: LLM > Signed-off-by: Chaosheng Qu <[email protected]> > --- > .../bindings/display/ti/ti,tpd12s015.txt | 44 --------- > .../bindings/display/ti/ti,tpd12s015.yaml | 90 +++++++++++++++++++ > 2 files changed, 90 insertions(+), 44 deletions(-) > delete mode 100644 > Documentation/devicetree/bindings/display/ti/ti,tpd12s015.txt > create mode 100644 > Documentation/devicetree/bindings/display/ti/ti,tpd12s015.yaml > > diff --git a/Documentation/devicetree/bindings/display/ti/ti,tpd12s015.txt > b/Documentation/devicetree/bindings/display/ti/ti,tpd12s015.txt > deleted file mode 100644 > index 26e6d32e3f20..000000000000 > --- a/Documentation/devicetree/bindings/display/ti/ti,tpd12s015.txt > +++ /dev/null > @@ -1,44 +0,0 @@ > -TPD12S015 HDMI level shifter and ESD protection chip > -==================================================== > - > -Required properties: > -- compatible: "ti,tpd12s015" > - > -Optional properties: > -- gpios: CT CP HPD, LS OE and HPD gpios > - > -Required nodes: > -- Video port 0 for HDMI input > -- Video port 1 for HDMI output > - > -Example > -------- > - > -tpd12s015: encoder@1 { > - compatible = "ti,tpd12s015"; > - > - gpios = <&gpio2 28 GPIO_ACTIVE_HIGH>, /* 60, CT CP HPD */ > - <&gpio2 9 GPIO_ACTIVE_HIGH>, /* 41, LS OE */ > - <&gpio2 31 GPIO_ACTIVE_HIGH>; /* 63, HPD */ > - > - ports { > - #address-cells = <1>; > - #size-cells = <0>; > - > - port@0 { > - reg = <0>; > - > - tpd12s015_in: endpoint@0 { > - remote-endpoint = <&hdmi_out>; > - }; > - }; > - > - port@1 { > - reg = <1>; > - > - tpd12s015_out: endpoint@0 { > - remote-endpoint = <&hdmi_connector_in>; > - }; > - }; > - }; > -}; > diff --git a/Documentation/devicetree/bindings/display/ti/ti,tpd12s015.yaml > b/Documentation/devicetree/bindings/display/ti/ti,tpd12s015.yaml > new file mode 100644 > index 000000000000..1927da3bd736 > --- /dev/null > +++ b/Documentation/devicetree/bindings/display/ti/ti,tpd12s015.yaml > @@ -0,0 +1,90 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/display/ti/ti,tpd12s015.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: TI TPD12S015 HDMI level shifter and ESD protection chip > + > +maintainers: > + - Tomi Valkeinen <[email protected]> > + > +description: |
Don't need '|'. > + The TPD12S015 is an HDMI companion chip that combines a level shifter and > + ESD protection circuitry. It sits between an HDMI transmitter and the HDMI > + connector, and provides control over the level shifter enable and the > + hot-plug detect signals. > + > +properties: > + compatible: > + oneOf: > + - const: ti,tpd12s015 > + - items: > + - const: ti,tpd12s016 > + - const: ti,tpd12s015 > + > + gpios: > + description: > + The CT CP HPD, LS OE and HPD GPIOs, in that order. The first controls > + the level shifter, the second enables the level shifter outputs and > + the third reads the hot-plug detect line. > + maxItems: 3 Use this form instead: items: - description: ... - description: ... - description: ... > + > + ports: > + $ref: /schemas/graph.yaml#/properties/ports > + > + properties: > + port@0: > + $ref: /schemas/graph.yaml#/$defs/port-base > + unevaluatedProperties: false No extra properties, so use: $ref: /schemas/graph.yaml#/properties/port (and no need for unevaluatedProperties) > + description: HDMI input from the transmitter. > + > + port@1: > + $ref: /schemas/graph.yaml#/$defs/port-base > + unevaluatedProperties: false > + description: HDMI output to the connector. Same here. Rob
