# 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@ti.com>
  - Bhargav Joshi <j.bhargav.u@gmail.com>

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>;
            };
        };
    };