| Svyatoslav Ryhel | aba052b | 2023-10-27 11:26:10 +0300 | [diff] [blame] | 1 | MAXIM, MAX77663 PMIC |
| 2 | |
| 3 | This device uses two drivers: |
| 4 | - drivers/power/pmic/max77663.c (for parent device) |
| 5 | - drivers/power/regulator/max77663_regulator.c (for child regulators) |
| 6 | |
| 7 | This chapter describes the binding info for the PMIC driver and regulators. |
| 8 | |
| 9 | Required properties for PMIC: |
| 10 | - compatible: "maxim,max77663" |
| 11 | - reg: usually 0x1c or 0x3c |
| 12 | |
| 13 | With those two properties, the pmic device can be used for read/write only. |
| 14 | To bind each regulator, the optional regulators subnode should exists. |
| 15 | |
| 16 | Optional subnode: |
| 17 | - name: regulators (subnode list of each device's regulator) |
| 18 | |
| 19 | Regulators subnode contains set on supported regulators. |
| 20 | |
| 21 | Required properties: |
| 22 | - regulator-name: used for regulator uclass platform data '.name', |
| 23 | |
| 24 | List of supported regulator nodes names for max77663: |
| 25 | - sd0, sd1, sd2, sd3, ldo0, ldo1, ldo2, ldo3, ldo4, ldo5, ldo6, ldo7, ldo8 |
| 26 | |
| 27 | Optional: |
| 28 | - regulator-min-microvolt: minimum allowed Voltage to set |
| 29 | - regulator-max-microvolt: minimum allowed Voltage to set |
| 30 | - regulator-always-on: regulator should be never disabled |
| 31 | - regulator-boot-on: regulator should be enabled by the bootloader |
| 32 | |
| 33 | Linux driver binding for this driver is compatible. |
| 34 | |
| 35 | Example: |
| 36 | |
| 37 | max77663@1c { |
| 38 | compatible = "maxim,max77663"; |
| 39 | reg = <0x1c>; |
| 40 | |
| 41 | regulators { |
| 42 | sd0 { |
| 43 | regulator-name = "vdd_cpu"; |
| 44 | regulator-min-microvolt = <800000>; |
| 45 | regulator-max-microvolt = <1250000>; |
| 46 | regulator-always-on; |
| 47 | regulator-boot-on; |
| 48 | }; |
| 49 | |
| 50 | ... |
| 51 | |
| 52 | ldo0 { |
| 53 | regulator-name = "avdd_pll"; |
| 54 | regulator-min-microvolt = <1200000>; |
| 55 | regulator-max-microvolt = <1200000>; |
| 56 | }; |
| 57 | |
| 58 | ... |
| 59 | |
| 60 | ldo2 { |
| 61 | regulator-name = "avdd_usb"; |
| 62 | regulator-min-microvolt = <3300000>; |
| 63 | regulator-max-microvolt = <3300000>; |
| 64 | regulator-always-on; |
| 65 | regulator-boot-on; |
| 66 | }; |
| 67 | |
| 68 | ldo3 { |
| 69 | regulator-name = "vdd_sdmmc3"; |
| 70 | regulator-min-microvolt = <3000000>; |
| 71 | regulator-max-microvolt = <3000000>; |
| 72 | regulator-always-on; |
| 73 | regulator-boot-on; |
| 74 | }; |
| 75 | |
| 76 | ... |
| 77 | |
| 78 | ldo8 { |
| 79 | regulator-name = "avdd_dsi_csi"; |
| 80 | regulator-min-microvolt = <1200000>; |
| 81 | regulator-max-microvolt = <1200000>; |
| 82 | }; |
| 83 | }; |
| 84 | }; |