xref: /linux/Documentation/devicetree/bindings/clock/sifive/fu540-prci.yaml (revision 9a87ffc99ec8eb8d35eed7c4f816d75f5cc9662e)
1*406171bfSSagar Kadam# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2*406171bfSSagar Kadam# Copyright (C) 2020 SiFive, Inc.
3*406171bfSSagar Kadam%YAML 1.2
4*406171bfSSagar Kadam---
5*406171bfSSagar Kadam$id: http://devicetree.org/schemas/clock/sifive/fu540-prci.yaml#
6*406171bfSSagar Kadam$schema: http://devicetree.org/meta-schemas/core.yaml#
7*406171bfSSagar Kadam
8*406171bfSSagar Kadamtitle: SiFive FU540 Power Reset Clock Interrupt Controller (PRCI)
9*406171bfSSagar Kadam
10*406171bfSSagar Kadammaintainers:
11*406171bfSSagar Kadam  - Paul Walmsley  <paul.walmsley@sifive.com>
12*406171bfSSagar Kadam
13*406171bfSSagar Kadamdescription:
14*406171bfSSagar Kadam  On the FU540 family of SoCs, most system-wide clock and reset integration
15*406171bfSSagar Kadam  is via the PRCI IP block.
16*406171bfSSagar Kadam  The clock consumer should specify the desired clock via the clock ID
17*406171bfSSagar Kadam  macros defined in include/dt-bindings/clock/sifive-fu540-prci.h.
18*406171bfSSagar Kadam  These macros begin with PRCI_CLK_.
19*406171bfSSagar Kadam
20*406171bfSSagar Kadam  The hfclk and rtcclk nodes are required, and represent physical
21*406171bfSSagar Kadam  crystals or resonators located on the PCB.  These nodes should be present
22*406171bfSSagar Kadam  underneath /, rather than /soc.
23*406171bfSSagar Kadam
24*406171bfSSagar Kadamproperties:
25*406171bfSSagar Kadam  compatible:
26*406171bfSSagar Kadam    const: sifive,fu540-c000-prci
27*406171bfSSagar Kadam
28*406171bfSSagar Kadam  reg:
29*406171bfSSagar Kadam    maxItems: 1
30*406171bfSSagar Kadam
31*406171bfSSagar Kadam  clocks:
32*406171bfSSagar Kadam    items:
33*406171bfSSagar Kadam      - description: high frequency clock.
34*406171bfSSagar Kadam      - description: RTL clock.
35*406171bfSSagar Kadam
36*406171bfSSagar Kadam  clock-names:
37*406171bfSSagar Kadam    items:
38*406171bfSSagar Kadam      - const: hfclk
39*406171bfSSagar Kadam      - const: rtcclk
40*406171bfSSagar Kadam
41*406171bfSSagar Kadam  "#clock-cells":
42*406171bfSSagar Kadam    const: 1
43*406171bfSSagar Kadam
44*406171bfSSagar Kadamrequired:
45*406171bfSSagar Kadam  - compatible
46*406171bfSSagar Kadam  - reg
47*406171bfSSagar Kadam  - clocks
48*406171bfSSagar Kadam  - "#clock-cells"
49*406171bfSSagar Kadam
50*406171bfSSagar KadamadditionalProperties: false
51*406171bfSSagar Kadam
52*406171bfSSagar Kadamexamples:
53*406171bfSSagar Kadam  - |
54*406171bfSSagar Kadam    prci: clock-controller@10000000 {
55*406171bfSSagar Kadam      compatible = "sifive,fu540-c000-prci";
56*406171bfSSagar Kadam      reg = <0x10000000 0x1000>;
57*406171bfSSagar Kadam      clocks = <&hfclk>, <&rtcclk>;
58*406171bfSSagar Kadam      #clock-cells = <1>;
59*406171bfSSagar Kadam    };
60