TI TPS6586x regulator family

TPS6586x 필수 property와 supply

TPS6586x regulator 계열의 필수 `compatible`은 `ti,tps6586x`, `reg`는 I2C slave address, `interrupts`는 controller의 interrupt output입니다. `#gpio-cells`는 GPIO를 기술하는 cell 수이고 `gpio-controller`는 device를 GPIO controller로 표시합니다.

`regulators` node에는 regulator마다 subnode를 둡니다. 각 node는 이름 또는 deprecated `regulator-compatible` property로 식별하며 유효한 값은 `sys`, `sm[0-2]`, `ldo[0-9]`, `ldo_rtc`입니다. 내용은 `regulator.txt`의 표준 binding을 따릅니다.

`sys-supply`는 SYS, `vin-sm0-supply`·`vin-sm1-supply`·`vin-sm2-supply`는 각각 SM0·SM1·SM2의 input입니다. 원문에서 `vinldo01-supply`는 LDO1과 LDO2, `vinldo23-supply`는 LDO2와 LDO3의 input으로 설명합니다. `vinldo4-supply`는 LDO4, `vinldo678-supply`는 LDO6·7·8, `vinldo9-supply`는 LDO9의 input입니다.

System power와 내부 parent 관계

선택 property `ti,system-power-controller`는 이 PMIC가 system power를 제어하는지 나타냅니다. 각 regulator는 표준 regulator binding으로 정의합니다.

LDO5와 LDO_RTC는 내부적으로 SYS regulator에서 공급되며 driver가 올바른 parent-child 관계를 구성합니다.

TPS6586x 전체 rail 예제

I2C address 0x34의 예제는 interrupt, GPIO controller, system power controller와 모든 input supply를 설정합니다. `sys`, `sm0`~`sm2`, `ldo0`~`ldo9`를 선언하며 SYS와 세 SM은 boot-on·always-on입니다.

`sm0`과 `sm1`은 725,000~1,500,000 microvolt, `sm2`는 3,000,000~4,550,000 microvolt입니다. LDO별 범위와 `PCIE CLK` 이름은 아래 원문 예제에 그대로 보존합니다.

pmu: tps6586x@34 {
        compatible = "ti,tps6586x";
        reg = <0x34>;
        interrupts = <0 88 0x4>;

        #gpio-cells = <2>;
        gpio-controller;

        ti,system-power-controller;

        sys-supply = <&some_reg>;
        vin-sm0-supply = <&some_reg>;
        vin-sm1-supply = <&some_reg>;
        vin-sm2-supply = <&some_reg>;
        vinldo01-supply = <...>;
        vinldo23-supply = <...>;
        vinldo4-supply = <...>;
        vinldo678-supply = <...>;
        vinldo9-supply = <...>;

        regulators {
                sys_reg: sys {
                        regulator-name = "vdd_sys";
                        regulator-boot-on;
                        regulator-always-on;
                };

                sm0_reg: sm0 {
                        regulator-min-microvolt = < 725000>;
                        regulator-max-microvolt = <1500000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                sm1_reg: sm1 {
                        regulator-min-microvolt = < 725000>;
                        regulator-max-microvolt = <1500000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                sm2_reg: sm2 {
                        regulator-min-microvolt = <3000000>;
                        regulator-max-microvolt = <4550000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                ldo0_reg: ldo0 {
                        regulator-name = "PCIE CLK";
                        regulator-min-microvolt = <3300000>;
                        regulator-max-microvolt = <3300000>;
                };

                ldo1_reg: ldo1 {
                        regulator-min-microvolt = < 725000>;
                        regulator-max-microvolt = <1500000>;
                };

                ldo2_reg: ldo2 {
                        regulator-min-microvolt = < 725000>;
                        regulator-max-microvolt = <1500000>;
                };

                ldo3_reg: ldo3 {
                        regulator-min-microvolt = <1250000>;
                        regulator-max-microvolt = <3300000>;
                };

                ldo4_reg: ldo4 {
                        regulator-min-microvolt = <1700000>;
                        regulator-max-microvolt = <2475000>;
                };

                ldo5_reg: ldo5 {
                        regulator-min-microvolt = <1250000>;
                        regulator-max-microvolt = <3300000>;
                };

                ldo6_reg: ldo6 {
                        regulator-min-microvolt = <1250000>;
                        regulator-max-microvolt = <3300000>;
                };

                ldo7_reg: ldo7 {
                        regulator-min-microvolt = <1250000>;
                        regulator-max-microvolt = <3300000>;
                };

                ldo8_reg: ldo8 {
                        regulator-min-microvolt = <1250000>;
                        regulator-max-microvolt = <3300000>;
                };

                ldo9_reg: ldo9 {
                        regulator-min-microvolt = <1250000>;
                        regulator-max-microvolt = <3300000>;
                };
        };
};