| Svyatoslav Ryhel | 8f0fa2b | 2023-10-27 11:26:12 +0300 | [diff] [blame] | 1 | Texas Instruments, TPS80031/TPS80032 PMIC |
| 2 | |
| 3 | This device uses two drivers: |
| 4 | - drivers/power/pmic/tps80031.c (for parent device) |
| 5 | - drivers/power/regulator/tps80031_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: "ti,tps80031" or "ti,tps80032" |
| 11 | - reg: 0x48 |
| 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 tps80031/tps80032: |
| 25 | - smps1, smps2, smps3, smps4, smps5 |
| 26 | - ldo1, ldo2, ldo3, ldo4, ldo5, ldo6, ldo7, ldoln, ldousb |
| 27 | |
| 28 | SMPS5 in Linux 3.1.10 is referred as vio, but datasheet clearly names it SMPS5. |
| 29 | |
| 30 | Optional: |
| 31 | - regulator-min-microvolt: minimum allowed Voltage to set |
| 32 | - regulator-max-microvolt: minimum allowed Voltage to set |
| 33 | - regulator-always-on: regulator should be never disabled |
| 34 | - regulator-boot-on: regulator should be enabled by the bootloader |
| 35 | |
| 36 | Example: |
| 37 | |
| 38 | tps80032@48 { |
| 39 | compatible = "ti,tps80032"; |
| 40 | reg = <0x48>; |
| 41 | |
| 42 | regulators { |
| 43 | smps1 { |
| 44 | regulator-name = "vdd_cpu"; |
| 45 | regulator-min-microvolt = <800000>; |
| 46 | regulator-max-microvolt = <1250000>; |
| 47 | regulator-always-on; |
| 48 | regulator-boot-on; |
| 49 | }; |
| 50 | |
| 51 | ... |
| 52 | |
| 53 | smps5 { |
| 54 | regulator-name = "vdd_1v8_gen"; |
| 55 | regulator-min-microvolt = <1800000>; |
| 56 | regulator-max-microvolt = <1800000>; |
| 57 | regulator-always-on; |
| 58 | regulator-boot-on; |
| 59 | }; |
| 60 | |
| 61 | ldo1 { |
| 62 | regulator-name = "avdd_dsi_csi"; |
| 63 | regulator-min-microvolt = <1200000>; |
| 64 | regulator-max-microvolt = <1200000>; |
| 65 | regulator-boot-on; |
| 66 | }; |
| 67 | |
| 68 | ... |
| 69 | |
| 70 | ldousb { |
| 71 | regulator-name = "avdd_usb"; |
| 72 | regulator-min-microvolt = <3300000>; |
| 73 | regulator-max-microvolt = <3300000>; |
| 74 | }; |
| 75 | }; |
| 76 | }; |