media: dt-bindings: i2c: samsung,s5k5baf: convert to dtschema
authorKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Mon, 13 Mar 2023 14:49:11 +0000 (15:49 +0100)
committerMauro Carvalho Chehab <mchehab@kernel.org>
Mon, 20 Mar 2023 14:30:44 +0000 (15:30 +0100)
Convert the Samsung S5K5BAF image sensor bindings to DT schema.

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>
Documentation/devicetree/bindings/media/i2c/samsung,s5k5baf.yaml [new file with mode: 0644]
Documentation/devicetree/bindings/media/samsung-s5k5baf.txt [deleted file]

diff --git a/Documentation/devicetree/bindings/media/i2c/samsung,s5k5baf.yaml b/Documentation/devicetree/bindings/media/i2c/samsung,s5k5baf.yaml
new file mode 100644 (file)
index 0000000..c8f2955
--- /dev/null
@@ -0,0 +1,101 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/media/i2c/samsung,s5k5baf.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Samsung S5K5BAF UXGA 1/5" 2M CMOS Image Sensor with embedded SoC ISP
+
+maintainers:
+  - Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
+
+properties:
+  compatible:
+    const: samsung,s5k5baf
+
+  reg:
+    maxItems: 1
+
+  clocks:
+    maxItems: 1
+
+  clock-names:
+    items:
+      - const: mclk
+
+  clock-frequency:
+    default: 24000000
+    description: mclk clock frequency
+
+  rstn-gpios:
+    maxItems: 1
+    description: RSTN pin
+
+  stbyn-gpios:
+    maxItems: 1
+    description: STDBYN pin
+
+  vdda-supply:
+    description: Analog power supply 2.8V (2.6V to 3.0V)
+
+  vddio-supply:
+    description: I/O power supply 1.8V (1.65V to 1.95V) or 2.8V (2.5V to 3.1V)
+
+  vddreg-supply:
+    description:
+      Regulator input power supply 1.8V (1.7V to 1.9V) or 2.8V (2.6V to 3.0)
+
+  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
+
+required:
+  - compatible
+  - clocks
+  - clock-names
+  - rstn-gpios
+  - stbyn-gpios
+  - vdda-supply
+  - vddio-supply
+  - vddreg-supply
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/gpio/gpio.h>
+
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        sensor@2d {
+            compatible = "samsung,s5k5baf";
+            reg = <0x2d>;
+            clocks = <&camera 0>;
+            clock-names = "mclk";
+            clock-frequency = <24000000>;
+            rstn-gpios = <&gpl2 1 GPIO_ACTIVE_LOW>;
+            stbyn-gpios = <&gpl2 0 GPIO_ACTIVE_LOW>;
+            vdda-supply = <&cam_io_en_reg>;
+            vddio-supply = <&vtcam_reg>;
+            vddreg-supply = <&vt_core_15v_reg>;
+
+            port {
+                endpoint {
+                    remote-endpoint = <&csis1_ep>;
+                    data-lanes = <1>;
+                };
+            };
+        };
+    };
diff --git a/Documentation/devicetree/bindings/media/samsung-s5k5baf.txt b/Documentation/devicetree/bindings/media/samsung-s5k5baf.txt
deleted file mode 100644 (file)
index 1f51e04..0000000
+++ /dev/null
@@ -1,58 +0,0 @@
-Samsung S5K5BAF UXGA 1/5" 2M CMOS Image Sensor with embedded SoC ISP
---------------------------------------------------------------------
-
-Required properties:
-
-- compatible     : "samsung,s5k5baf";
-- reg            : I2C slave address of the sensor;
-- vdda-supply    : analog power supply 2.8V (2.6V to 3.0V);
-- vddreg-supply          : regulator input power supply 1.8V (1.7V to 1.9V)
-                   or 2.8V (2.6V to 3.0);
-- vddio-supply   : I/O power supply 1.8V (1.65V to 1.95V)
-                   or 2.8V (2.5V to 3.1V);
-- stbyn-gpios    : GPIO connected to STDBYN pin;
-- rstn-gpios     : GPIO connected to RSTN pin;
-- clocks         : list of phandle and clock specifier pairs
-                   according to common clock bindings for the
-                   clocks described in clock-names;
-- clock-names    : should include "mclk" for the sensor's master clock;
-
-Optional properties:
-
-- clock-frequency : the frequency at which the "mclk" clock should be
-                   configured to operate, in Hz; if this property is not
-                   specified default 24 MHz value will be used.
-
-The device node should contain one 'port' child node with one child 'endpoint'
-node, according to the bindings defined in Documentation/devicetree/bindings/
-media/video-interfaces.txt. The following are properties specific to those
-nodes.
-
-endpoint node
--------------
-
-- data-lanes : (optional) specifies MIPI CSI-2 data lanes as covered in
-              video-interfaces.txt. If present it should be <1> - the device
-              supports only one data lane without re-mapping.
-
-Example:
-
-s5k5bafx@2d {
-       compatible = "samsung,s5k5baf";
-       reg = <0x2d>;
-       vdda-supply = <&cam_io_en_reg>;
-       vddreg-supply = <&vt_core_15v_reg>;
-       vddio-supply = <&vtcam_reg>;
-       stbyn-gpios = <&gpl2 0 1>;
-       rstn-gpios = <&gpl2 1 1>;
-       clock-names = "mclk";
-       clocks = <&clock_cam 0>;
-       clock-frequency = <24000000>;
-
-       port {
-               s5k5bafx_ep: endpoint {
-                       remote-endpoint = <&csis1_ep>;
-                       data-lanes = <1>;
-               };
-       };
-};