# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/media/i2c/samsung,s5kjn5.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Samsung S5KJN5 Image Sensor

description:
  Samsung S5KJN5 is a 50MP 10-bit RAW MIPI CSI-2 image sensor.
  The sensor is controlled over I2C. The full resolution pixel array is
  8192x6144, data output format is RAW10 transferred over 4-lane MIPI
  D-PHY interface.

maintainers:
  - Wenmeng Liu <wenmeng.liu@oss.qualcomm.com>

allOf:
  - $ref: /schemas/media/video-interface-devices.yaml#

properties:
  compatible:
    const: samsung,s5kjn5

  reg:
    maxItems: 1

  clocks:
    description: MCLK/XVCLK input clock.
    maxItems: 1

  reset-gpios:
    description: Active low GPIO connected to RESET pad of the sensor.
    maxItems: 1

  vddio-supply:
    description:
      1.8 volt I/O voltage supply (VDD18). Required for both 1.8 and 1.2 volt
      I/O operation.

  vddd-supply:
    description: Digital core voltage supply, 1.0 volts.

  vddm-supply:
    description: MIPI voltage supply, 1.0 volts.

  vdda-supply:
    description: Analogue voltage supply, 2.2 volts.

  vddio1p2-supply:
    description:
      1.2 volt I/O voltage supply (VDDIO12). Required only for 1.2 volt I/O
      operation.

  afvdd-supply:
    description: Autofocus actuator voltage supply, 2.8-3.0 volts.

  port:
    $ref: /schemas/graph.yaml#/$defs/port-base
    additionalProperties: false

    properties:
      endpoint:
        $ref: /schemas/media/video-interfaces.yaml#
        unevaluatedProperties: false

        properties:
          data-lanes:
            items:
              - const: 1
              - const: 2
              - const: 3
              - const: 4

        required:
          - link-frequencies

required:
  - compatible
  - reg
  - clocks
  - port

unevaluatedProperties: false

examples:
  - |
      #include <dt-bindings/gpio/gpio.h>

      i2c {
          #address-cells = <1>;
          #size-cells = <0>;

          camera@10 {
              compatible = "samsung,s5kjn5";
              reg = <0x10>;
              clocks = <&camera_mclk 0>;
              assigned-clocks = <&camera_mclk 0>;
              assigned-clock-rates = <19200000>;
              reset-gpios = <&gpio1 10 GPIO_ACTIVE_LOW>;
              vddio-supply = <&vreg_1p8>;
              vddd-supply = <&vreg_1p0>;
              vddm-supply = <&vreg_1p0>;
              vdda-supply = <&vreg_2p2>;
              vddio1p2-supply = <&vreg_1p2>;
              afvdd-supply = <&vreg_2p8>;

              port {
                  endpoint {
                      link-frequencies = /bits/ 64 <1248000000>;
                      data-lanes = <1 2 3 4>;
                      remote-endpoint = <&mipi_csi2_ep>;
                  };
              };
          };
      };
...