Commit b53ad425 authored by Krzysztof Kozlowski's avatar Krzysztof Kozlowski Committed by Mauro Carvalho Chehab
Browse files

media: dt-bindings: media: samsung,exynos5250-gsc: convert to dtschema 

Convert the Samsung Exynos SoC G-Scaler bindings to DT schema.

Changes done during conversion:
1. A typical (already used) properties like clocks, iommus and
   power-domains.
2. Require clocks, because they are essential for the block to operate.
3. Describe the differences in clocks between the Exynos5250/5420 and
   the Exynos5433 G-Scalers.  This includes the fifth Exynos5433 clock
   "gsd" (GSCL Smart Deck) which was added to the DTS, but not to the
   bindings and Linux driver.  Similarly to Exynos5433 DECON change [1],
   the clock should be used.

[1] https://lore.kernel.org/all/6270db2d-667d-8d6f-9289-be92da486c25@samsung.com/



Signed-off-by: default avatarKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Signed-off-by: default avatarSakari Ailus <sakari.ailus@linux.intel.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@kernel.org>
parent 2a96b40f

Documentation/devicetree/bindings/media/exynos5-gsc.txt

deleted100644 → 0
+0 −38
Original line number Diff line number Diff line 
* Samsung Exynos5 G-Scaler device



G-Scaler is used for scaling and color space conversion on Exynos5 SoCs.



Required properties:

- compatible: should be one of

	      "samsung,exynos5250-gsc"

	      "samsung,exynos5420-gsc"

	      "samsung,exynos5433-gsc"

	      "samsung,exynos5-gsc" (deprecated)

- reg: should contain G-Scaler physical address location and length.

- interrupts: should contain G-Scaler interrupt number



Optional properties:

- samsung,sysreg: handle to syscon used to control the system registers to

  set writeback input and destination



Example:



gsc_0:  gsc@13e00000 {

	compatible = "samsung,exynos5250-gsc";

	reg = <0x13e00000 0x1000>;

	interrupts = <0 85 0>;

};



Aliases:

Each G-Scaler node should have a numbered alias in the aliases node,

in the form of gscN, N = 0...3. G-Scaler driver uses these aliases

to retrieve the device IDs using "of_alias_get_id()" call.



Example:



aliases {

	gsc0 =&gsc_0;

	gsc1 =&gsc_1;

	gsc2 =&gsc_2;

	gsc3 =&gsc_3;

};

Documentation/devicetree/bindings/media/samsung,exynos5250-gsc.yaml

0 → 100644
+109 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause

%YAML 1.2

---

$id: http://devicetree.org/schemas/media/samsung,exynos5250-gsc.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Samsung Exynos SoC G-Scaler



maintainers:

  - Inki Dae <inki.dae@samsung.com>

  - Krzysztof Kozlowski <krzk@kernel.org>

  - Seung-Woo Kim <sw0312.kim@samsung.com



description:

  G-Scaler is used for scaling and color space conversion on Samsung Exynos

  SoCs.



  Each G-Scaler node should have a numbered alias in the aliases node, in the

  form of gscN, N = 0...3.



properties:

  compatible:

    oneOf:

      - items:

          - enum:

              - samsung,exynos5250-gsc

              - samsung,exynos5420-gsc

          - const: samsung,exynos5-gsc

      - enum:

          - samsung,exynos5433-gsc

      - const: samsung,exynos5-gsc

        deprecated: True



  clocks:

    minItems: 1

    maxItems: 5



  clock-names:

    minItems: 1

    maxItems: 5



  interrupts:

    maxItems: 1



  iommus:

    maxItems: 1



  power-domains:

    maxItems: 1



  reg:

    maxItems: 1



  samsung,sysreg:

    $ref: /schemas/types.yaml#/definitions/phandle

    description:

      Syscon used to control the system registers to set writeback input and destination.



required:

  - compatible

  - clocks

  - clock-names

  - interrupts

  - reg



allOf:

  - if:

      properties:

        compatible:

          contains:

            enum:

              - samsung,exynos5-gsc

              - samsung,exynos5250-gsc

              - samsung,exynos5420-gsc

    then:

      properties:

        clocks:

          maxItems: 1

        clock-names:

          items:

            - const: gscl

    else:

      properties:

        clocks:

          minItems: 5

        clock-names:

          items:

            - const: pclk

            - const: aclk

            - const: aclk_xiu

            - const: aclk_gsclbend

            - const: gsd



additionalProperties: false



examples:

  - |

    #include <dt-bindings/clock/exynos5250.h>

    #include <dt-bindings/interrupt-controller/arm-gic.h>



    video-scaler@13e00000 {

        compatible = "samsung,exynos5250-gsc", "samsung,exynos5-gsc";

        reg = <0x13e00000 0x1000>;

        interrupts = <GIC_SPI 85 IRQ_TYPE_LEVEL_HIGH>;

        power-domains = <&pd_gsc>;

        clocks = <&clock CLK_GSCL0>;

        clock-names = "gscl";

        iommus = <&sysmmu_gsc0>;

    };