[PATCH] dt-bindings: media: i2c: ti,tvp514x: Convert to DT schema

From: Bhargav Joshi

Date: Sun Nov 08 2026 - 14:40:26 EST


Convert Texas Instruments TVP514x video decoder from text to DT schema.
The legacy text binding marked the port endpoint as required, but
in-tree DTS files omit it. Make the endpoint optional.

Signed-off-by: Bhargav Joshi <j.bhargav.u@xxxxxxxxx>
---
.../devicetree/bindings/media/i2c/ti,tvp514x.txt | 44 -------------
.../devicetree/bindings/media/i2c/ti,tvp514x.yaml | 72 ++++++++++++++++++++++
2 files changed, 72 insertions(+), 44 deletions(-)

diff --git a/Documentation/devicetree/bindings/media/i2c/ti,tvp514x.txt b/Documentation/devicetree/bindings/media/i2c/ti,tvp514x.txt
deleted file mode 100644
index 46752cc71f2eb..0000000000000
--- a/Documentation/devicetree/bindings/media/i2c/ti,tvp514x.txt
+++ /dev/null
@@ -1,44 +0,0 @@
-* Texas Instruments TVP514x video decoder
-
-The TVP5146/TVP5146m2/TVP5147/TVP5147m1 device is high quality, single-chip
-digital video decoder that digitizes and decodes all popular baseband analog
-video formats into digital video component. The tvp514x decoder supports analog-
-to-digital (A/D) conversion of component RGB and YPbPr signals as well as A/D
-conversion and decoding of NTSC, PAL and SECAM composite and S-video into
-component YCbCr.
-
-Required Properties :
-- compatible : value should be either one among the following
- (a) "ti,tvp5146" for tvp5146 decoder.
- (b) "ti,tvp5146m2" for tvp5146m2 decoder.
- (c) "ti,tvp5147" for tvp5147 decoder.
- (d) "ti,tvp5147m1" for tvp5147m1 decoder.
-
-- hsync-active: HSYNC Polarity configuration for endpoint.
-
-- vsync-active: VSYNC Polarity configuration for endpoint.
-
-- pclk-sample: Clock polarity of the endpoint.
-
-For further reading on port node refer to Documentation/devicetree/bindings/
-media/video-interfaces.txt.
-
-Example:
-
- i2c0@1c22000 {
- ...
- ...
- tvp514x@5c {
- compatible = "ti,tvp5146";
- reg = <0x5c>;
-
- port {
- tvp514x_1: endpoint {
- hsync-active = <1>;
- vsync-active = <1>;
- pclk-sample = <0>;
- };
- };
- };
- ...
- };
diff --git a/Documentation/devicetree/bindings/media/i2c/ti,tvp514x.yaml b/Documentation/devicetree/bindings/media/i2c/ti,tvp514x.yaml
new file mode 100644
index 0000000000000..d39dd6c37c073
--- /dev/null
+++ b/Documentation/devicetree/bindings/media/i2c/ti,tvp514x.yaml
@@ -0,0 +1,72 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/media/i2c/ti,tvp514x.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Texas Instruments TVP514x video decoders
+
+maintainers:
+ - Vaibhav Hiremath <hvaibhav@xxxxxx>
+ - Mauro Carvalho Chehab <mchehab@xxxxxxxxxx>
+
+description:
+ The TVP5146/TVP5146m2/TVP5147/TVP5147m1 device is high quality, single-chip
+ digital video decoder that digitizes and decodes all popular baseband analog
+ video formats into digital video component. The tvp514x decoder supports
+ analog- to-digital (A/D) conversion of component RGB and YPbPr signals as
+ well as A/D conversion and decoding of NTSC, PAL and SECAM composite and
+ S-video into component YCbCr.
+
+properties:
+ compatible:
+ enum:
+ - ti,tvp5146
+ - ti,tvp5146m2
+ - ti,tvp5147
+ - ti,tvp5147m1
+
+ reg:
+ maxItems: 1
+
+ port:
+ $ref: /schemas/graph.yaml#/$defs/port-base
+ unevaluatedProperties: false
+
+ properties:
+ endpoint:
+ $ref: /schemas/media/video-interfaces.yaml#
+ unevaluatedProperties: false
+ required:
+ - hsync-active
+ - vsync-active
+ - pclk-sample
+
+ required:
+ - endpoint
+
+required:
+ - compatible
+ - reg
+
+additionalProperties: false
+
+examples:
+ - |
+ i2c {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ video-decoder@5c {
+ compatible = "ti,tvp5146m2";
+ reg = <0x5c>;
+
+ port {
+ endpoint {
+ hsync-active = <1>;
+ vsync-active = <1>;
+ pclk-sample = <0>;
+ };
+ };
+ };
+ };

---
base-commit: fa4ad798f6f681031775266044ba1b0cf3c670bd
change-id: 20260731-ti-tvp514x-34c82c523162

Best regards,
--
Bhargav