dt-bindings: clock: samsung: convert Exynos5410 to dtschema

* Samsung Exynos5410 Clock Controller

The Exynos5410 clock controller generates and supplies clock to various

controllers within the Exynos5410 SoC.

Required Properties:

- compatible: should be "samsung,exynos5410-clock"

- reg: physical base address of the controller and length of memory mapped

  region.

- #clock-cells: should be 1.

- clocks: should contain an entry specifying the root clock from external

  oscillator supplied through XXTI or XusbXTI pin.  This clock should be

  defined using standard clock bindings with "fin_pll" clock-output-name.

  That clock is being passed internally to the 9 PLLs.

All available clocks are defined as preprocessor macros in

dt-bindings/clock/exynos5410.h header and can be used in device

tree sources.

Example 1: An example of a clock controller node is listed below.

	fin_pll: xxti {

		compatible = "fixed-clock";

		clock-frequency = <24000000>;

		clock-output-names = "fin_pll";

		#clock-cells = <0>;

	};

	clock: clock-controller@10010000 {

		compatible = "samsung,exynos5410-clock";

		reg = <0x10010000 0x30000>;

		#clock-cells = <1>;

		clocks = <&fin_pll>;

	};

Example 2: UART controller node that consumes the clock generated by the clock

	   controller. Refer to the standard clock bindings for information

	   about 'clocks' and 'clock-names' property.

	serial@12c20000 {

		compatible = "samsung,exynos4210-uart";

		reg = <0x12C00000 0x100>;

		interrupts = <0 51 0>;

		clocks = <&clock CLK_UART0>, <&clock CLK_SCLK_UART0>;

		clock-names = "uart", "clk_uart_baud0";

	};

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/clock/samsung,exynos5410-clock.yaml#

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

title: Samsung Exynos5410 SoC clock controller

maintainers:

  - Chanwoo Choi <cw00.choi@samsung.com>

  - Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com>

  - Sylwester Nawrocki <s.nawrocki@samsung.com>

  - Tomasz Figa <tomasz.figa@gmail.com>

description: |

  Expected external clocks, defined in DTS as fixed-rate clocks with a matching

  name::

    - "fin_pll" - PLL input clock from XXTI

  All available clocks are defined as preprocessor macros in

  include/dt-bindings/clock/exynos5410.h header.

properties:

  compatible:

    oneOf:

      - enum:

          - samsung,exynos5410-clock

  clocks:

    description:

      Should contain an entry specifying the root clock from external

      oscillator supplied through XXTI or XusbXTI pin.  This clock should be

      defined using standard clock bindings with "fin_pll" clock-output-name.

      That clock is being passed internally to the 9 PLLs.

    maxItems: 1

  "#clock-cells":

    const: 1

  reg:

    maxItems: 1

required:

  - compatible

  - "#clock-cells"

  - reg

additionalProperties: false

examples:

  - |

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

    fin_pll: osc-clock {

        compatible = "fixed-clock";

        clock-frequency = <24000000>;

        clock-output-names = "fin_pll";

        #clock-cells = <0>;

    };

    clock-controller@10010000 {

        compatible = "samsung,exynos5410-clock";

        reg = <0x10010000 0x30000>;

        #clock-cells = <1>;

        clocks = <&fin_pll>;

    };

L:	linux-samsung-soc@vger.kernel.org

S:	Supported

T:	git git://git.kernel.org/pub/scm/linux/kernel/git/snawrocki/clk.git

F:	Documentation/devicetree/bindings/clock/exynos*.txt

F:	Documentation/devicetree/bindings/clock/samsung,*.yaml

F:	Documentation/devicetree/bindings/clock/samsung,s3c*

F:	Documentation/devicetree/bindings/clock/samsung,s5p*