xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/renesas,raa215300.yaml (revision cb14a3fe5122c879eae1fb480ed7ce82a699ddb6) 
1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/regulator/renesas,raa215300.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Renesas RAA215300 Power Management Integrated Circuit (PMIC)
8
9maintainers:
10  - Biju Das <biju.das.jz@bp.renesas.com>
11
12description: |
13  The RAA215300 is a high-performance, low-cost 9-channel PMIC designed for
14  32-bit and 64-bit MCU and MPU applications. It supports DDR3, DDR3L, DDR4,
15  and LPDDR4 memory power requirements. The internally compensated regulators,
16  built-in Real-Time Clock (RTC), 32kHz crystal oscillator, and coin cell
17  battery charger provide a highly integrated, small footprint power solution
18  ideal for System-On-Module (SOM) applications. A spread spectrum feature
19  provides an ease-of-use solution for noise-sensitive audio or RF applications.
20
21  This device exposes two devices via I2C. One for the integrated RTC IP, and
22  one for everything else.
23
24  Link to datasheet:
25  https://www.renesas.com/in/en/products/power-power-management/multi-channel-power-management-ics-pmics/ssdsoc-power-management-ics-pmic-and-pmus/raa215300-high-performance-9-channel-pmic-supporting-ddr-memory-built-charger-and-rtc
26
27properties:
28  compatible:
29    enum:
30      - renesas,raa215300
31
32  reg:
33    maxItems: 2
34
35  reg-names:
36    items:
37      - const: main
38      - const: rtc
39
40  interrupts:
41    maxItems: 1
42
43  clocks:
44    description: |
45      The clocks are optional. The RTC is disabled, if no clocks are
46      provided(either xin or clkin).
47    maxItems: 1
48
49  clock-names:
50    description: |
51      Use xin, if connected to an external crystal.
52      Use clkin, if connected to an external clock signal.
53    enum:
54      - xin
55      - clkin
56
57required:
58  - compatible
59  - reg
60  - reg-names
61
62additionalProperties: false
63
64examples:
65  - |
66    /* 32.768kHz crystal */
67    x2: x2-clock {
68        compatible = "fixed-clock";
69        #clock-cells = <0>;
70        clock-frequency = <32768>;
71    };
72
73    i2c {
74        #address-cells = <1>;
75        #size-cells = <0>;
76
77        raa215300: pmic@12 {
78            compatible = "renesas,raa215300";
79            reg = <0x12>, <0x6f>;
80            reg-names = "main", "rtc";
81
82            clocks = <&x2>;
83            clock-names = "xin";
84        };
85    };
86