[PATCH] dt-bindings: media: ti,am437x-vpfe: Convert to DT schema

From: Bhargav Joshi

Date: Sun Jul 19 2026 - 17:14:16 EST


Convert Texas Instruments AM437x CAMERA Video Processing Front End
(VPFE) from legacy text to DT schema.

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

diff --git a/Documentation/devicetree/bindings/media/ti,am437x-vpfe.yaml b/Documentation/devicetree/bindings/media/ti,am437x-vpfe.yaml
new file mode 100644
index 000000000000..983e705ab1e8
--- /dev/null
+++ b/Documentation/devicetree/bindings/media/ti,am437x-vpfe.yaml
@@ -0,0 +1,93 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/media/ti,am437x-vpfe.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Texas Instruments AM437x CAMERA Video Processing Front End (VPFE)
+
+maintainers:
+ - Benoit Parrot <bparrot@xxxxxx>
+ - Bhargav Joshi <j.bhargav.u@xxxxxxxxx>
+
+description:
+ The Video Processing Front End (VPFE) is a key component for image capture
+ applications. The capture module provides the system interface and the
+ processing capability to connect RAW image-sensor modules and video decoders
+ to the AM437x device.
+
+properties:
+ compatible:
+ const: ti,am437x-vpfe
+
+ reg:
+ maxItems: 1
+
+ interrupts:
+ maxItems: 1
+
+ port:
+ $ref: /schemas/graph.yaml#/$defs/port-base
+ unevaluatedProperties: false
+ description:
+ A single parallel input port connecting to an external image sensor or
+ video decoder. The VPFE supports only one input port per instance.
+
+ properties:
+ endpoint:
+ $ref: video-interfaces.yaml#
+ unevaluatedProperties: false
+
+ properties:
+ ti,am437x-vpfe-interface:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ enum: [0, 1, 2, 3, 4]
+ description:
+ Selects the VPFE input interface type can be one of following
+ 0 - Raw Bayer (VPFE_RAW_BAYER)
+ 1 - BT.656 8-bit (VPFE_BT656)
+ 2 - BT.656 10-bit (VPFE_BT656_10BIT)
+ 3 - YCbCr 8-bit sync (VPFE_YCBCR_SYNC_8)
+ 4 - YCbCr 16-bit sync (VPFE_YCBCR_SYNC_16)
+
+ bus-width:
+ minimum: 8
+ maximum: 16
+
+ required:
+ - remote-endpoint
+ - ti,am437x-vpfe-interface
+ - bus-width
+
+required:
+ - compatible
+ - reg
+ - interrupts
+ - port
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/arm-gic.h>
+ #include <dt-bindings/interrupt-controller/irq.h>
+
+ vpfe@48328000{
+ compatible = "ti,am437x-vpfe";
+ reg = <0x48328000 0x2000>;
+ interrupts = <GIC_SPI 50 IRQ_TYPE_LEVEL_HIGH>;
+
+ pinctrl-names = "default", "sleep";
+ pinctrl-0 = <&vpfe_pins_default>;
+ pinctrl-1 = <&vpfe_pins_sleep>;
+
+ port {
+ vpfe0_ep: endpoint {
+ remote-endpoint = <&ov2659_1>;
+ ti,am437x-vpfe-interface = <0>;
+ bus-width = <8>;
+ hsync-active = <0>;
+ vsync-active = <0>;
+ };
+ };
+ };
diff --git a/Documentation/devicetree/bindings/media/ti-am437x-vpfe.txt b/Documentation/devicetree/bindings/media/ti-am437x-vpfe.txt
deleted file mode 100644
index 3932e766553a..000000000000
--- a/Documentation/devicetree/bindings/media/ti-am437x-vpfe.txt
+++ /dev/null
@@ -1,61 +0,0 @@
-Texas Instruments AM437x CAMERA (VPFE)
---------------------------------------
-
-The Video Processing Front End (VPFE) is a key component for image capture
-applications. The capture module provides the system interface and the
-processing capability to connect RAW image-sensor modules and video decoders
-to the AM437x device.
-
-Required properties:
-- compatible: must be "ti,am437x-vpfe"
-- reg: physical base address and length of the registers set for the device;
-- interrupts: should contain IRQ line for the VPFE;
-- ti,am437x-vpfe-interface: can be one of the following,
- 0 - Raw Bayer Interface.
- 1 - 8 Bit BT656 Interface.
- 2 - 10 Bit BT656 Interface.
- 3 - YCbCr 8 Bit Interface.
- 4 - YCbCr 16 Bit Interface.
-
-VPFE supports a single port node with parallel bus. It should contain one
-'port' child node with child 'endpoint' node. Please refer to the bindings
-defined in Documentation/devicetree/bindings/media/video-interfaces.txt.
-
-Example:
- vpfe: vpfe@f0034000 {
- compatible = "ti,am437x-vpfe";
- reg = <0x48328000 0x2000>;
- interrupts = <GIC_SPI 50 IRQ_TYPE_LEVEL_HIGH>;
-
- pinctrl-names = "default", "sleep";
- pinctrl-0 = <&vpfe_pins_default>;
- pinctrl-1 = <&vpfe_pins_sleep>;
-
- port {
- #address-cells = <1>;
- #size-cells = <0>;
-
- vpfe0_ep: endpoint {
- remote-endpoint = <&ov2659_1>;
- ti,am437x-vpfe-interface = <0>;
- bus-width = <8>;
- hsync-active = <0>;
- vsync-active = <0>;
- };
- };
- };
-
- i2c1: i2c@4802a000 {
-
- ov2659@30 {
- compatible = "ti,ov2659";
- reg = <0x30>;
-
- port {
- ov2659_1: endpoint {
- remote-endpoint = <&vpfe0_ep>;
- bus-width = <8>;
- mclk-frequency = <12000000>;
- };
- };
- };

---
base-commit: c6859eed755df351a3978b33cb92365f9b3e8f06
change-id: 20260720-ti-am437x-vpfe-739861b135ea

Best regards,
--
Bhargav