TI LP872x regulator

LP872x 필수 property

TI/National Semiconductor LP872x driver binding입니다. `compatible`은 `ti,lp8720` 또는 `ti,lp8725`이고 `reg`는 I2C slave address입니다. LP8720은 0x7d, LP8725는 0x7a를 사용합니다.

LP8720 general configuration

선택 `ti,general-config`는 8-bit `LP872X_GENERAL_CFG` register 값을 지정합니다. LP8720에서 bit[2]는 BUCK output voltage 제어를 고르며 1은 external DVS pin, 0은 register 08h의 bit7입니다. bit[1]은 sleep 제어로 1은 external DVS pin, 0은 register 08h의 bit6입니다. bit[0]은 microsecond 단위 time step이며 1은 25, 0은 50입니다.

LP8725 general configuration

LP8725에서 bit[7:6]은 time step 단위이며 00=32, 01=64, 10=128, 11=256 microsecond입니다. bit[4]는 BUCK2 enable로 1은 enable, 0은 disable입니다. bit[3]은 BUCK2 output voltage register address로 1은 0Ah, 0은 0Bh입니다.

bit[2]는 BUCK1 output voltage 제어로 1은 register 08h, 0은 DVS입니다. bit[1]은 LDO sleep 제어로 1은 sleep mode, 0은 normal입니다. bit[0]은 BUCK1 enable이며 1은 enable, 0은 disable입니다. 자세한 동작은 datasheet를 참조합니다.

Update, DVS와 enable GPIO

`LP872X_GENERAL_CFG` register를 실제로 설정해야 할 때 `ti,update-config`를 선언합니다. `ti,dvs-gpio`는 external DVS pin의 GPIO specifier, `ti,dvs-vsel`은 DVS selector로 0=`SEL_V1`, 1=`SEL_V2`, `ti,dvs-state`는 초기 pin 상태로 0=`DVS_LOW`, 1=`DVS_HIGH`입니다. `enable-gpios`는 EN pin 제어용 GPIO specifier입니다.

Regulator child와 datasheet

LP8720은 최대 6개 child `ldo1`~`ldo5`, `buck`을 지원합니다. LP8725는 최대 9개 child `ldo1`~`ldo5`, `lilo1`, `lilo2`, `buck1`, `buck2`를 지원합니다. 초기화 데이터는 `Documentation/devicetree/bindings/regulator/regulator.txt`를 따릅니다.

Datasheet는 LP8720의 `https://www.ti.com/lit/ds/symlink/lp8720.pdf`와 LP8725의 `https://www.ti.com/lit/ds/symlink/lp8725.pdf`입니다.

예제 1: LP8720

LP8720 예제는 external DVS pin과 25 microsecond time step을 선택하는 `ti,general-config = 0x03`을 적용합니다. OMAP4 GPIO134에 해당하는 GPIO5_6을 DVS로 사용하고 `SEL_V2`, `DVS_HIGH`로 초기화합니다. LDO1~5와 BUCK의 전압 constraint도 함께 선언합니다.

lp8720@7d {
        compatible = "ti,lp8720";
        reg = <0x7d>;

        /* external DVS pin used, timestep is 25usec */
        ti,general-config = /bits/ 8 <0x03>;
        ti,update-config;

        /*
         * The dvs-gpio depends on the processor environment.
         * For example, following GPIO specifier means GPIO134 in OMAP4.
         */
        ti,dvs-gpio = <&gpio5 6 0>;
        ti,dvs-vsel = /bits/ 8 <1>;                /* SEL_V2 */
        ti,dvs-state = /bits/ 8 <1>;                /* DVS_HIGH */

        vaf: ldo1 {
                regulator-min-microvolt = <1200000>;
                regulator-max-microvolt = <3300000>;
        };

        vmmc: ldo2 {
                regulator-min-microvolt = <1200000>;
                regulator-max-microvolt = <3300000>;
        };

        vcam_io: ldo3 {
                regulator-min-microvolt = <1200000>;
                regulator-max-microvolt = <3300000>;
                regulator-boot-on;
        };

        vcam_core: ldo4 {
                regulator-min-microvolt = <800000>;
                regulator-max-microvolt = <2850000>;
                regulator-boot-on;
        };

        vcam: ldo5 {
                regulator-min-microvolt = <1200000>;
                regulator-max-microvolt = <3300000>;
        };

        vcc: buck {
                regulator-name = "VBUCK";
                regulator-min-microvolt = <800000>;
                regulator-max-microvolt = <2300000>;
        };
};

예제 2: LP8725

LP8725 예제의 `ti,general-config = 0xdd`는 BUCK1·BUCK2 enable, DVS 미사용, LDO normal mode, 256 microsecond time step을 설정합니다. LDO1~5, LILO1~2와 두 BUCK을 선언하며 BUCK1·2는 800,000~3,000,000 microvolt, 460,000~1,370,000 microamp 범위와 boot-on 상태를 사용합니다.

lp8725@7a {
        compatible = "ti,lp8725";
        reg = <0x7a>;

        /* Enable BUCK1,2, no DVS, normal LDO mode, timestep is 256usec */
        ti,general-config = /bits/ 8 <0xdd>;
        ti,update-config;

        vcam_io: ldo1 {
                regulator-min-microvolt = <1200000>;
                regulator-max-microvolt = <3300000>;
        };

        vcam_core: ldo2 {
                regulator-min-microvolt = <1200000>;
                regulator-max-microvolt = <3300000>;
        };

        vcam: ldo3 {
                regulator-min-microvolt = <1200000>;
                regulator-max-microvolt = <3300000>;
        };

        vcmmb_io: ldo4 {
                regulator-min-microvolt = <1200000>;
                regulator-max-microvolt = <3300000>;
                regulator-boot-on;
        };

        vcmmb_core: ldo5 {
                regulator-min-microvolt = <1200000>;
                regulator-max-microvolt = <3300000>;
                regulator-boot-on;
        };

        vaux1: lilo1 {
                regulator-name = "VAUX1";
                regulator-min-microvolt = <800000>;
                regulator-max-microvolt = <3300000>;
        };

        vaux2: lilo2 {
                regulator-name = "VAUX2";
                regulator-min-microvolt = <800000>;
                regulator-max-microvolt = <3300000>;
        };

        vcc1: buck1 {
                regulator-name = "VBUCK1";
                regulator-min-microvolt = <800000>;
                regulator-max-microvolt = <3000000>;
                regulator-min-microamp  = <460000>;
                regulator-max-microamp  = <1370000>;
                regulator-boot-on;
        };

        vcc2: buck2 {
                regulator-name = "VBUCK2";
                regulator-min-microvolt = <800000>;
                regulator-max-microvolt = <3000000>;
                regulator-min-microamp  = <460000>;
                regulator-max-microamp  = <1370000>;
                regulator-boot-on;
        };
};