Back to home page

OSCL-LXR

 
 

    


0001 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
0002 %YAML 1.2
0003 ---
0004 $id: http://devicetree.org/schemas/mfd/rohm,bd71837-pmic.yaml#
0005 $schema: http://devicetree.org/meta-schemas/core.yaml#
0006 
0007 title: ROHM BD71837 Power Management Integrated Circuit bindings
0008 
0009 maintainers:
0010   - Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com>
0011 
0012 description: |
0013   BD71837MWV is programmable Power Management ICs for powering single-core,
0014   dual-core, and quad-core SoCs such as NXP-i.MX 8M. It is optimized for low
0015   BOM cost and compact solution footprint. BD71837MWV  integrates 8 Buck
0016   regulators and 7 LDOs.
0017   Datasheet for BD71837 is available at
0018   https://www.rohm.com/products/power-management/power-management-ic-for-system/industrial-consumer-applications/nxp-imx/bd71837amwv-product
0019 
0020 properties:
0021   compatible:
0022     const: rohm,bd71837
0023 
0024   reg:
0025     description:
0026       I2C slave address.
0027     maxItems: 1
0028 
0029   interrupts:
0030     maxItems: 1
0031 
0032   clocks:
0033     maxItems: 1
0034 
0035   clock-names:
0036     const: osc
0037 
0038   "#clock-cells":
0039     const: 0
0040 
0041   clock-output-names:
0042     const: pmic_clk
0043 
0044 # The BD718x7 supports two different HW states as reset target states. States
0045 # are called as SNVS and READY. At READY state all the PMIC power outputs go
0046 # down and OTP is reload. At the SNVS state all other logic and external
0047 # devices apart from the SNVS power domain are shut off. Please refer to NXP
0048 # i.MX8 documentation for further information regarding SNVS state. When a
0049 # reset is done via SNVS state the PMIC OTP data is not reload. This causes
0050 # power outputs that have been under SW control to stay down when reset has
0051 # switched power state to SNVS. If reset is done via READY state the power
0052 # outputs will be returned to HW control by OTP loading. Thus the reset
0053 # target state is set to READY by default. If SNVS state is used the boot
0054 # crucial regulators must have the regulator-always-on and regulator-boot-on
0055 # properties set in regulator node.
0056 
0057   rohm,reset-snvs-powered:
0058     description: |
0059       Transfer PMIC to SNVS state at reset
0060     type: boolean
0061 
0062 # Configure the "short press" and "long press" timers for the power button.
0063 # Values are rounded to what hardware supports
0064 # Short-press:
0065 #   Shortest being 10ms, next 500ms and then multiple of 500ms up to 7,5s
0066 # Long-press:
0067 #   Shortest being 10ms, next 1000ms and then multiple of 1000ms up to 15s
0068 # If these properties are not present the existing configuration (from
0069 # bootloader or OTP) is not touched.
0070 
0071   rohm,short-press-ms:
0072     description:
0073       Short press duration in milliseconds
0074     enum:
0075       - 10
0076       - 500
0077       - 1000
0078       - 1500
0079       - 2000
0080       - 2500
0081       - 3000
0082       - 3500
0083       - 4000
0084       - 4500
0085       - 5000
0086       - 5500
0087       - 6000
0088       - 6500
0089       - 7000
0090 
0091   rohm,long-press-ms:
0092     description:
0093       Long press duration in milliseconds
0094     enum:
0095       - 10
0096       - 1000
0097       - 2000
0098       - 3000
0099       - 4000
0100       - 5000
0101       - 6000
0102       - 7000
0103       - 8000
0104       - 9000
0105       - 10000
0106       - 11000
0107       - 12000
0108       - 13000
0109       - 14000
0110 
0111   regulators:
0112     $ref: ../regulator/rohm,bd71837-regulator.yaml
0113     description:
0114       List of child nodes that specify the regulators.
0115 
0116 required:
0117   - compatible
0118   - reg
0119   - interrupts
0120   - clocks
0121   - "#clock-cells"
0122   - regulators
0123 
0124 additionalProperties: false
0125 
0126 examples:
0127   - |
0128     #include <dt-bindings/interrupt-controller/irq.h>
0129     #include <dt-bindings/leds/common.h>
0130 
0131     i2c {
0132         #address-cells = <1>;
0133         #size-cells = <0>;
0134         pmic: pmic@4b {
0135             compatible = "rohm,bd71837";
0136             reg = <0x4b>;
0137             interrupt-parent = <&gpio1>;
0138             interrupts = <29 IRQ_TYPE_LEVEL_LOW>;
0139             #clock-cells = <0>;
0140             clocks = <&osc 0>;
0141             rohm,reset-snvs-powered;
0142             rohm,short-press-ms = <10>;
0143             rohm,long-press-ms = <2000>;
0144 
0145             regulators {
0146                 buck1: BUCK1 {
0147                     regulator-name = "buck1";
0148                     regulator-min-microvolt = <700000>;
0149                     regulator-max-microvolt = <1300000>;
0150                     regulator-boot-on;
0151                     regulator-always-on;
0152                     regulator-ramp-delay = <1250>;
0153                     rohm,dvs-run-voltage = <900000>;
0154                     rohm,dvs-idle-voltage = <850000>;
0155                     rohm,dvs-suspend-voltage = <800000>;
0156                 };
0157                 buck2: BUCK2 {
0158                     regulator-name = "buck2";
0159                     regulator-min-microvolt = <700000>;
0160                     regulator-max-microvolt = <1300000>;
0161                     regulator-boot-on;
0162                     regulator-always-on;
0163                     regulator-ramp-delay = <1250>;
0164                     rohm,dvs-run-voltage = <1000000>;
0165                     rohm,dvs-idle-voltage = <900000>;
0166                 };
0167                 buck3: BUCK3 {
0168                     regulator-name = "buck3";
0169                     regulator-min-microvolt = <700000>;
0170                     regulator-max-microvolt = <1300000>;
0171                     regulator-boot-on;
0172                     rohm,dvs-run-voltage = <1000000>;
0173                 };
0174                 buck4: BUCK4 {
0175                     regulator-name = "buck4";
0176                     regulator-min-microvolt = <700000>;
0177                     regulator-max-microvolt = <1300000>;
0178                     regulator-boot-on;
0179                     rohm,dvs-run-voltage = <1000000>;
0180                 };
0181                 buck5: BUCK5 {
0182                     regulator-name = "buck5";
0183                     regulator-min-microvolt = <700000>;
0184                     regulator-max-microvolt = <1350000>;
0185                     regulator-boot-on;
0186                 };
0187                 buck6: BUCK6 {
0188                     regulator-name = "buck6";
0189                     regulator-min-microvolt = <3000000>;
0190                     regulator-max-microvolt = <3300000>;
0191                     regulator-boot-on;
0192                 };
0193                 buck7: BUCK7 {
0194                     regulator-name = "buck7";
0195                     regulator-min-microvolt = <1605000>;
0196                     regulator-max-microvolt = <1995000>;
0197                     regulator-boot-on;
0198                 };
0199                 buck8: BUCK8 {
0200                     regulator-name = "buck8";
0201                     regulator-min-microvolt = <800000>;
0202                     regulator-max-microvolt = <1400000>;
0203                 };
0204 
0205                 ldo1: LDO1 {
0206                     regulator-name = "ldo1";
0207                     regulator-min-microvolt = <3000000>;
0208                     regulator-max-microvolt = <3300000>;
0209                     regulator-boot-on;
0210                 };
0211                 ldo2: LDO2 {
0212                     regulator-name = "ldo2";
0213                     regulator-min-microvolt = <900000>;
0214                     regulator-max-microvolt = <900000>;
0215                     regulator-boot-on;
0216                 };
0217                 ldo3: LDO3 {
0218                     regulator-name = "ldo3";
0219                     regulator-min-microvolt = <1800000>;
0220                     regulator-max-microvolt = <3300000>;
0221                 };
0222                 ldo4: LDO4 {
0223                     regulator-name = "ldo4";
0224                     regulator-min-microvolt = <900000>;
0225                     regulator-max-microvolt = <1800000>;
0226                 };
0227                 ldo5: LDO5 {
0228                     regulator-name = "ldo5";
0229                     regulator-min-microvolt = <1800000>;
0230                     regulator-max-microvolt = <3300000>;
0231                 };
0232                 ldo6: LDO6 {
0233                     regulator-name = "ldo6";
0234                     regulator-min-microvolt = <900000>;
0235                     regulator-max-microvolt = <1800000>;
0236                 };
0237                 ldo7_reg: LDO7 {
0238                     regulator-name = "ldo7";
0239                     regulator-min-microvolt = <1800000>;
0240                     regulator-max-microvolt = <3300000>;
0241                 };
0242             };
0243         };
0244     };