1*4882a593Smuzhiyun# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause 2*4882a593Smuzhiyun%YAML 1.2 3*4882a593Smuzhiyun--- 4*4882a593Smuzhiyun$id: http://devicetree.org/schemas/regulator/rohm,bd71837-regulator.yaml# 5*4882a593Smuzhiyun$schema: http://devicetree.org/meta-schemas/core.yaml# 6*4882a593Smuzhiyun 7*4882a593Smuzhiyuntitle: ROHM BD71837 Power Management Integrated Circuit regulators 8*4882a593Smuzhiyun 9*4882a593Smuzhiyunmaintainers: 10*4882a593Smuzhiyun - Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com> 11*4882a593Smuzhiyun 12*4882a593Smuzhiyundescription: | 13*4882a593Smuzhiyun List of regulators provided by this controller. BD71837 regulators node 14*4882a593Smuzhiyun should be sub node of the BD71837 MFD node. See BD71837 MFD bindings at 15*4882a593Smuzhiyun Documentation/devicetree/bindings/mfd/rohm,bd71837-pmic.yaml 16*4882a593Smuzhiyun Regulator nodes should be named to BUCK_<number> and LDO_<number>. The 17*4882a593Smuzhiyun definition for each of these nodes is defined using the standard 18*4882a593Smuzhiyun binding for regulators at 19*4882a593Smuzhiyun Documentation/devicetree/bindings/regulator/regulator.txt. 20*4882a593Smuzhiyun Note that if BD71837 starts at RUN state you probably want to use 21*4882a593Smuzhiyun regulator-boot-on at least for BUCK6 and BUCK7 so that those are not 22*4882a593Smuzhiyun disabled by driver at startup. LDO5 and LDO6 are supplied by those and 23*4882a593Smuzhiyun if they are disabled at startup the voltage monitoring for LDO5/LDO6 will 24*4882a593Smuzhiyun cause PMIC to reset. 25*4882a593Smuzhiyun 26*4882a593Smuzhiyun#The valid names for BD71837 regulator nodes are: 27*4882a593Smuzhiyun#BUCK1, BUCK2, BUCK3, BUCK4, BUCK5, BUCK6, BUCK7, BUCK8 28*4882a593Smuzhiyun#LDO1, LDO2, LDO3, LDO4, LDO5, LDO6, LDO7 29*4882a593Smuzhiyun 30*4882a593SmuzhiyunpatternProperties: 31*4882a593Smuzhiyun "^LDO[1-7]$": 32*4882a593Smuzhiyun type: object 33*4882a593Smuzhiyun $ref: regulator.yaml# 34*4882a593Smuzhiyun description: 35*4882a593Smuzhiyun Properties for single LDO regulator. 36*4882a593Smuzhiyun 37*4882a593Smuzhiyun properties: 38*4882a593Smuzhiyun regulator-name: 39*4882a593Smuzhiyun pattern: "^ldo[1-7]$" 40*4882a593Smuzhiyun description: 41*4882a593Smuzhiyun should be "ldo1", ..., "ldo7" 42*4882a593Smuzhiyun 43*4882a593Smuzhiyun unevaluatedProperties: false 44*4882a593Smuzhiyun 45*4882a593Smuzhiyun "^BUCK[1-8]$": 46*4882a593Smuzhiyun type: object 47*4882a593Smuzhiyun $ref: regulator.yaml# 48*4882a593Smuzhiyun description: 49*4882a593Smuzhiyun Properties for single BUCK regulator. 50*4882a593Smuzhiyun 51*4882a593Smuzhiyun properties: 52*4882a593Smuzhiyun regulator-name: 53*4882a593Smuzhiyun pattern: "^buck[1-8]$" 54*4882a593Smuzhiyun description: 55*4882a593Smuzhiyun should be "buck1", ..., "buck8" 56*4882a593Smuzhiyun 57*4882a593Smuzhiyun rohm,dvs-run-voltage: 58*4882a593Smuzhiyun $ref: "/schemas/types.yaml#/definitions/uint32" 59*4882a593Smuzhiyun minimum: 0 60*4882a593Smuzhiyun maximum: 1300000 61*4882a593Smuzhiyun description: 62*4882a593Smuzhiyun PMIC default "RUN" state voltage in uV. See below table for 63*4882a593Smuzhiyun bucks which support this. 0 means disabled. 64*4882a593Smuzhiyun 65*4882a593Smuzhiyun rohm,dvs-idle-voltage: 66*4882a593Smuzhiyun $ref: "/schemas/types.yaml#/definitions/uint32" 67*4882a593Smuzhiyun minimum: 0 68*4882a593Smuzhiyun maximum: 1300000 69*4882a593Smuzhiyun description: 70*4882a593Smuzhiyun PMIC default "IDLE" state voltage in uV. See below table for 71*4882a593Smuzhiyun bucks which support this. 0 means disabled. 72*4882a593Smuzhiyun 73*4882a593Smuzhiyun rohm,dvs-suspend-voltage: 74*4882a593Smuzhiyun $ref: "/schemas/types.yaml#/definitions/uint32" 75*4882a593Smuzhiyun minimum: 0 76*4882a593Smuzhiyun maximum: 1300000 77*4882a593Smuzhiyun description: 78*4882a593Smuzhiyun PMIC default "SUSPEND" state voltage in uV. See below table for 79*4882a593Smuzhiyun bucks which support this. 0 means disabled. 80*4882a593Smuzhiyun 81*4882a593Smuzhiyun # Supported default DVS states: 82*4882a593Smuzhiyun # 83*4882a593Smuzhiyun # BD71837: 84*4882a593Smuzhiyun # buck | dvs-run-voltage | dvs-idle-voltage | dvs-suspend-voltage 85*4882a593Smuzhiyun # ---------------------------------------------------------------- 86*4882a593Smuzhiyun # 1 | supported | supported | supported 87*4882a593Smuzhiyun # ---------------------------------------------------------------- 88*4882a593Smuzhiyun # 2 | supported | supported | not supported 89*4882a593Smuzhiyun # ---------------------------------------------------------------- 90*4882a593Smuzhiyun # 3 | supported | not supported | not supported 91*4882a593Smuzhiyun # ---------------------------------------------------------------- 92*4882a593Smuzhiyun # 4 | supported | not supported | not supported 93*4882a593Smuzhiyun # ---------------------------------------------------------------- 94*4882a593Smuzhiyun # rest | not supported | not supported | not supported 95*4882a593Smuzhiyun 96*4882a593Smuzhiyun # BD71837 power outputs can either be controlled by the PMIC internal 97*4882a593Smuzhiyun # hardware state machine or by software. If you need regulators to be 98*4882a593Smuzhiyun # turned ON/OFF for example based on PMIC_STBY_REQ line (which toggles 99*4882a593Smuzhiyun # PMIC HW state machine) - then you should set this property. 100*4882a593Smuzhiyun # Tradeoff is that then SW can't control the ON/OFF state for this 101*4882a593Smuzhiyun # regulator (other than invoking a PMIC state change). 102*4882a593Smuzhiyun rohm,no-regulator-enable-control: 103*4882a593Smuzhiyun description: | 104*4882a593Smuzhiyun Enable/Disable control of this regulator must be left to the 105*4882a593Smuzhiyun PMIC hardware state machine. 106*4882a593Smuzhiyun type: boolean 107*4882a593Smuzhiyun 108*4882a593Smuzhiyun required: 109*4882a593Smuzhiyun - regulator-name 110*4882a593Smuzhiyun 111*4882a593Smuzhiyun unevaluatedProperties: false 112*4882a593Smuzhiyun 113*4882a593SmuzhiyunadditionalProperties: false 114