Documentation/devicetree/bindings/regulator/renesas,raa215300.yaml

   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
   7 title: Renesas RAA215300 Power Management Integrated Circuit (PMIC)
   8
   9 maintainers:
  10   - Biju Das <biju.das.jz@bp.renesas.com>
  11
  12 description: |
  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
  27 properties:
  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
  57 required:
  58   - compatible
  59   - reg
  60   - reg-names
  61
  62 additionalProperties: false
  63
  64 examples:
  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     };