Documentation/devicetree/bindings/clock/samsung,s5pv210-clock.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/clock/samsung,s5pv210-clock.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Samsung S5P6442/S5PC110/S5PV210 SoC clock controller
   8
   9 maintainers:
  10   - Chanwoo Choi <cw00.choi@samsung.com>
  11   - Krzysztof Kozlowski <krzk@kernel.org>
  12   - Sylwester Nawrocki <s.nawrocki@samsung.com>
  13   - Tomasz Figa <tomasz.figa@gmail.com>
  14
  15 description: |
  16   Expected external clocks, defined in DTS as fixed-rate clocks with a matching
  17   name::
  18     - "xxti" - external crystal oscillator connected to XXTI and XXTO pins of
  19       the SoC,
  20     - "xusbxti" - external crystal oscillator connected to XUSBXTI and XUSBXTO
  21       pins of the SoC,
  22
  23   All available clocks are defined as preprocessor macros in
  24   include/dt-bindings/clock/s5pv210.h header.
  25
  26 properties:
  27   compatible:
  28     enum:
  29       - samsung,s5pv210-clock
  30       - samsung,s5p6442-clock
  31
  32   clocks:
  33     items:
  34       - description: xxti clock
  35       - description: xusbxti clock
  36
  37   clock-names:
  38     items:
  39       - const: xxti
  40       - const: xusbxti
  41
  42   "#clock-cells":
  43     const: 1
  44
  45   reg:
  46     maxItems: 1
  47
  48 required:
  49   - compatible
  50   - "#clock-cells"
  51   - reg
  52
  53 additionalProperties: false
  54
  55 examples:
  56   - |
  57     #include <dt-bindings/clock/s5pv210.h>
  58
  59     xxti: clock-0 {
  60         compatible = "fixed-clock";
  61         clock-frequency = <0>;
  62         clock-output-names = "xxti";
  63         #clock-cells = <0>;
  64     };
  65
  66     xusbxti: clock-1 {
  67         compatible = "fixed-clock";
  68         clock-frequency = <0>;
  69         clock-output-names = "xusbxti";
  70         #clock-cells = <0>;
  71     };
  72
  73     clock-controller@e0100000 {
  74         compatible = "samsung,s5pv210-clock";
  75         reg = <0xe0100000 0x10000>;
  76         clock-names = "xxti", "xusbxti";
  77         clocks = <&xxti>, <&xusbxti>;
  78         #clock-cells = <1>;
  79     };