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: | + 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 + + ports: + $ref: /schemas/graph.yaml#/properties/ports + + properties: + port@0: + $ref: /schemas/graph.yaml#/$defs/port-base + unevaluatedProperties: false + description: HDMI input from the transmitter. + + port@1: + $ref: /schemas/graph.yaml#/$defs/port-base + unevaluatedProperties: false + description: HDMI output to the connector. + + required: + - port@0 + - port@1 + +required: + - compatible + - ports + +additionalProperties: false + +examples: + - | + #include <dt-bindings/gpio/gpio.h> + + encoder1 { + 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 { + remote-endpoint = <&hdmi_out>; + }; + }; + + port@1 { + reg = <1>; + + tpd12s015_out: endpoint { + remote-endpoint = <&hdmi_connector_in>; + }; + }; + }; + }; + +... -- 2.43.0
