dt-bindings: clock: samsung,s2mps11: convert to dtschema

Binding for Samsung S2M and S5M family clock generator block

============================================================

This is a part of device tree bindings for S2M and S5M family multi-function

devices.

More information can be found in bindings/mfd/sec-core.txt file.

The S2MPS11/13/15 and S5M8767 provide three(AP/CP/BT) buffered 32.768 kHz

outputs. The S2MPS14 provides two (AP/BT) buffered 32.768 KHz outputs.

To register these as clocks with common clock framework instantiate under

main device node a sub-node named "clocks".

It uses the common clock binding documented in:

 - Documentation/devicetree/bindings/clock/clock-bindings.txt

Required properties of the "clocks" sub-node:

 - #clock-cells: should be 1.

 - compatible: Should be one of: "samsung,s2mps11-clk", "samsung,s2mps13-clk",

               "samsung,s2mps14-clk", "samsung,s5m8767-clk"

   The S2MPS15 uses the same compatible as S2MPS13, as both provides similar

   clocks.

Each clock is assigned an identifier and client nodes use this identifier

to specify the clock which they consume.

    Clock               ID           Devices

    ----------------------------------------------------------

    32KhzAP		0            S2MPS11/13/14/15, S5M8767

    32KhzCP		1            S2MPS11/13/15, S5M8767

    32KhzBT		2            S2MPS11/13/14/15, S5M8767

Include dt-bindings/clock/samsung,s2mps11.h file to use preprocessor defines

in device tree sources.

Example:

	s2mps11_pmic@66 {

		compatible = "samsung,s2mps11-pmic";

		reg = <0x66>;

		s2m_osc: clocks {

			compatible = "samsung,s2mps11-clk";

			#clock-cells = <1>;

			clock-output-names = "xx", "yy", "zz";

		};

	};

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

%YAML 1.2

---

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

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

title: Samsung S2M and S5M family clock generator block

maintainers:

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

description: |

  This is a part of device tree bindings for S2M and S5M family of Power

  Management IC (PMIC).

  The S2MPS11/13/15 and S5M8767 provide three(AP/CP/BT) buffered 32.768 kHz

  outputs. The S2MPS14 provides two (AP/BT) buffered 32.768 KHz outputs.

  All available clocks are defined as preprocessor macros in

  dt-bindings/clock/samsung,s2mps11.h header.

  See also Documentation/devicetree/bindings/mfd/samsung,s2mps11.yaml for

  additional information and example.

properties:

  compatible:

    enum:

      - samsung,s2mps11-clk

      - samsung,s2mps13-clk # S2MPS13 and S2MPS15

      - samsung,s2mps14-clk

      - samsung,s5m8767-clk

  "#clock-cells":

    const: 1

  clock-output-names:

    minItems: 3

    maxItems: 3

    description: Names for AP, CP and BT clocks.

required:

  - compatible

  - "#clock-cells"

additionalProperties: false

L:	linux-kernel@vger.kernel.org

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

S:	Supported

F:	Documentation/devicetree/bindings/clock/samsung,s2mps11.txt

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

F:	Documentation/devicetree/bindings/mfd/samsung,sec-core.txt

F:	Documentation/devicetree/bindings/regulator/samsung,s2m*.txt

F:	Documentation/devicetree/bindings/regulator/samsung,s5m*.txt