xref: /freebsd-src/sys/contrib/device-tree/Bindings/clock/starfive,jh7110-pll.yaml (revision aa1a8ff2d6dbc51ef058f46f3db5a8bb77967145)
1*aa1a8ff2SEmmanuel Vadot# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2*aa1a8ff2SEmmanuel Vadot%YAML 1.2
3*aa1a8ff2SEmmanuel Vadot---
4*aa1a8ff2SEmmanuel Vadot$id: http://devicetree.org/schemas/clock/starfive,jh7110-pll.yaml#
5*aa1a8ff2SEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6*aa1a8ff2SEmmanuel Vadot
7*aa1a8ff2SEmmanuel Vadottitle: StarFive JH7110 PLL Clock Generator
8*aa1a8ff2SEmmanuel Vadot
9*aa1a8ff2SEmmanuel Vadotdescription:
10*aa1a8ff2SEmmanuel Vadot  These PLLs are high speed, low jitter frequency synthesizers in the JH7110.
11*aa1a8ff2SEmmanuel Vadot  Each PLL works in integer mode or fraction mode, with configuration
12*aa1a8ff2SEmmanuel Vadot  registers in the sys syscon. So the PLLs node should be a child of
13*aa1a8ff2SEmmanuel Vadot  SYS-SYSCON node.
14*aa1a8ff2SEmmanuel Vadot  The formula for calculating frequency is
15*aa1a8ff2SEmmanuel Vadot  Fvco = Fref * (NI + NF) / M / Q1
16*aa1a8ff2SEmmanuel Vadot
17*aa1a8ff2SEmmanuel Vadotmaintainers:
18*aa1a8ff2SEmmanuel Vadot  - Xingyu Wu <xingyu.wu@starfivetech.com>
19*aa1a8ff2SEmmanuel Vadot
20*aa1a8ff2SEmmanuel Vadotproperties:
21*aa1a8ff2SEmmanuel Vadot  compatible:
22*aa1a8ff2SEmmanuel Vadot    const: starfive,jh7110-pll
23*aa1a8ff2SEmmanuel Vadot
24*aa1a8ff2SEmmanuel Vadot  clocks:
25*aa1a8ff2SEmmanuel Vadot    maxItems: 1
26*aa1a8ff2SEmmanuel Vadot    description: Main Oscillator (24 MHz)
27*aa1a8ff2SEmmanuel Vadot
28*aa1a8ff2SEmmanuel Vadot  '#clock-cells':
29*aa1a8ff2SEmmanuel Vadot    const: 1
30*aa1a8ff2SEmmanuel Vadot    description:
31*aa1a8ff2SEmmanuel Vadot      See <dt-bindings/clock/starfive,jh7110-crg.h> for valid indices.
32*aa1a8ff2SEmmanuel Vadot
33*aa1a8ff2SEmmanuel Vadotrequired:
34*aa1a8ff2SEmmanuel Vadot  - compatible
35*aa1a8ff2SEmmanuel Vadot  - clocks
36*aa1a8ff2SEmmanuel Vadot  - '#clock-cells'
37*aa1a8ff2SEmmanuel Vadot
38*aa1a8ff2SEmmanuel VadotadditionalProperties: false
39*aa1a8ff2SEmmanuel Vadot
40*aa1a8ff2SEmmanuel Vadotexamples:
41*aa1a8ff2SEmmanuel Vadot  - |
42*aa1a8ff2SEmmanuel Vadot    clock-controller {
43*aa1a8ff2SEmmanuel Vadot      compatible = "starfive,jh7110-pll";
44*aa1a8ff2SEmmanuel Vadot      clocks = <&osc>;
45*aa1a8ff2SEmmanuel Vadot      #clock-cells = <1>;
46*aa1a8ff2SEmmanuel Vadot    };
47