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

* Samsung S5P6442/S5PC110/S5PV210 Clock Controller

Samsung S5P6442, S5PC110 and S5PV210 SoCs contain integrated clock

controller, which generates and supplies clock to various controllers

within the SoC.

Required Properties:

- compatible: should be one of following:

	- "samsung,s5pv210-clock" : for clock controller of Samsung

	  S5PC110/S5PV210 SoCs,

	- "samsung,s5p6442-clock" : for clock controller of Samsung

	  S5P6442 SoC.

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

  region.

- #clock-cells: should be 1.

All available clocks are defined as preprocessor macros in

dt-bindings/clock/s5pv210.h header and can be used in device tree sources.

External clocks:

There are several clocks that are generated outside the SoC. It is expected

that they are defined using standard clock bindings with following

clock-output-names:

 - "xxti": external crystal oscillator connected to XXTI and XXTO pins of

the SoC,

 - "xusbxti": external crystal oscillator connected to XUSBXTI and XUSBXTO

pins of the SoC,

A subset of above clocks available on given board shall be specified in

board device tree, including the system base clock, as selected by XOM[0]

pin of the SoC. Refer to generic fixed rate clock bindings

documentation[1] for more information how to specify these clocks.

[1] Documentation/devicetree/bindings/clock/fixed-clock.yaml

Example: Clock controller node:

	clock: clock-controller@7e00f000 {

		compatible = "samsung,s5pv210-clock";

		reg = <0x7e00f000 0x1000>;

		#clock-cells = <1>;

	};

Example: Required external clocks:

	xxti: clock-xxti {

		compatible = "fixed-clock";

		clock-output-names = "xxti";

		clock-frequency = <24000000>;

		#clock-cells = <0>;

	};

	xusbxti: clock-xusbxti {

		compatible = "fixed-clock";

		clock-output-names = "xusbxti";

		clock-frequency = <24000000>;

		#clock-cells = <0>;

	};

Example: 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" properties):

	uart0: serial@e2900000 {

		compatible = "samsung,s5pv210-uart";

		reg = <0xe2900000 0x400>;

		interrupt-parent = <&vic1>;

		interrupts = <10>;

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

				"clk_uart_baud1";

		clocks = <&clocks UART0>, <&clocks UART0>,

				<&clocks SCLK_UART0>;

	};

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

%YAML 1.2

---

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

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

title: Samsung S5P6442/S5PC110/S5PV210 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::

    - "xxti" - external crystal oscillator connected to XXTI and XXTO pins of

      the SoC,

    - "xusbxti" - external crystal oscillator connected to XUSBXTI and XUSBXTO

      pins of the SoC,

  All available clocks are defined as preprocessor macros in

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

properties:

  compatible:

    enum:

      - samsung,s5pv210-clock

      - samsung,s5p6442-clock

  clocks:

    items:

      - description: xxti clock

      - description: xusbxti clock

  clock-names:

    items:

      - const: xxti

      - const: xusbxti

  "#clock-cells":

    const: 1

  reg:

    maxItems: 1

required:

  - compatible

  - "#clock-cells"

  - reg

additionalProperties: false

examples:

  - |

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

    xxti: clock-0 {

        compatible = "fixed-clock";

        clock-frequency = <0>;

        clock-output-names = "xxti";

        #clock-cells = <0>;

    };

    xusbxti: clock-1 {

        compatible = "fixed-clock";

        clock-frequency = <0>;

        clock-output-names = "xusbxti";

        #clock-cells = <0>;

    };

    clock-controller@e0100000 {

        compatible = "samsung,s5pv210-clock";

        reg = <0xe0100000 0x10000>;

        clock-names = "xxti", "xusbxti";

        clocks = <&xxti>, <&xusbxti>;

        #clock-cells = <1>;

    };

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

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

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

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

F:	drivers/clk/samsung/

F:	include/dt-bindings/clock/exynos*.h

F:	include/dt-bindings/clock/s3c*.h