Linear Technology LTC3589 regulator | Linux 6.18.37

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약과 해설

ltc3589.txt:1-99

필수 property와 chip별 rail 구성을 실제 device-tree 예제와 함께 설명합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기

1 Linear Technology LTC3589, LTC3589-1, and LTC3589-2 8-output regulators

3 Required properties:

4 - compatible: "lltc,ltc3589", "lltc,ltc3589-1" or "lltc,ltc3589-2"

5 - reg: I2C slave address

7 Required child node:

8 - regulators: Contains eight regulator child nodes sw1, sw2, sw3, bb-out,

9 ldo1, ldo2, ldo3, and ldo4, specifying the initialization data as

10 documented in Documentation/devicetree/bindings/regulator/regulator.txt.

12 Each regulator is defined using the standard binding for regulators. The

13 nodes for sw1, sw2, sw3, bb-out, ldo1, and ldo2 additionally need to specify

14 the resistor values of their external feedback voltage dividers:

16 Required properties (not on ldo3, ldo4):

17 - lltc,fb-voltage-divider: An array of two integers containing the resistor

18 values R1 and R2 of the feedback voltage divider in ohms.

20 Regulators sw1, sw2, sw3, and ldo2 can regulate the feedback reference from

21 0.3625 V to 0.75 V in 12.5 mV steps. The output voltage thus ranges between

22 0.3625 * (1 + R1/R2) V and 0.75 * (1 + R1/R2) V. Regulators bb-out and ldo1

23 have a fixed 0.8 V reference and thus output 0.8 * (1 + R1/R2) V. The ldo3

24 regulator is fixed to 1.8 V on LTC3589 and to 2.8 V on LTC3589-1,2. The ldo4

25 regulator can output between 1.8 V and 3.3 V on LTC3589 and between 1.2 V

26 and 3.2 V on LTC3589-1,2 in four steps. The ldo1 standby regulator can not

27 be disabled and thus should have the regulator-always-on property set.

29 Example:

31 ltc3589: pmic@34 {

32 compatible = "lltc,ltc3589-1";

33 reg = <0x34>;

35 regulators {

36 sw1_reg: sw1 {

37 regulator-min-microvolt = <591930>;

38 regulator-max-microvolt = <1224671>;

39 lltc,fb-voltage-divider = <100000 158000>;

40 regulator-ramp-delay = <7000>;

41 regulator-boot-on;

42 regulator-always-on;

43 };

45 sw2_reg: sw2 {

46 regulator-min-microvolt = <704123>;

47 regulator-max-microvolt = <1456803>;

48 lltc,fb-voltage-divider = <180000 191000>;

49 regulator-ramp-delay = <7000>;

50 regulator-boot-on;

51 regulator-always-on;

52 };

54 sw3_reg: sw3 {

55 regulator-min-microvolt = <1341250>;

56 regulator-max-microvolt = <2775000>;

57 lltc,fb-voltage-divider = <270000 100000>;

58 regulator-ramp-delay = <7000>;

59 regulator-boot-on;

60 regulator-always-on;

61 };

63 bb_out_reg: bb-out {

64 regulator-min-microvolt = <3387341>;

65 regulator-max-microvolt = <3387341>;

66 lltc,fb-voltage-divider = <511000 158000>;

67 regulator-boot-on;

68 regulator-always-on;

69 };

71 ldo1_reg: ldo1 {

72 regulator-min-microvolt = <1306329>;

73 regulator-max-microvolt = <1306329>;

74 lltc,fb-voltage-divider = <100000 158000>;

75 regulator-boot-on;

76 regulator-always-on;

77 };

79 ldo2_reg: ldo2 {

80 regulator-min-microvolt = <704123>;

81 regulator-max-microvolt = <1456806>;

82 lltc,fb-voltage-divider = <180000 191000>;

83 regulator-ramp-delay = <7000>;

84 regulator-boot-on;

85 regulator-always-on;

86 };

88 ldo3_reg: ldo3 {

89 regulator-min-microvolt = <2800000>;

90 regulator-max-microvolt = <2800000>;

91 regulator-boot-on;

92 };

94 ldo4_reg: ldo4 {

95 regulator-min-microvolt = <1200000>;

96 regulator-max-microvolt = <3200000>;

97 };

98 };

99 };

100

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

LTC3589 필수 property

1-6

Linear Technology LTC3589, LTC3589-1, LTC3589-2는 8-output regulator입니다. `compatible`은 `lltc,ltc3589`, `lltc,ltc3589-1`, `lltc,ltc3589-2` 중 하나이며 `reg`는 I2C slave address입니다.

8개 regulator child

7-10

필수 `regulators` node에는 `sw1`, `sw2`, `sw3`, `bb-out`, `ldo1`, `ldo2`, `ldo3`, `ldo4`의 8개 child를 두고 `Documentation/devicetree/bindings/regulator/regulator.txt`에 따른 initialization data를 지정합니다.

Feedback voltage divider

11-19

각 regulator는 standard binding을 사용합니다. `sw1`, `sw2`, `sw3`, `bb-out`, `ldo1`, `ldo2`는 추가로 external feedback voltage divider의 저항값을 지정해야 합니다. 필수 `lltc,fb-voltage-divider`는 ohm 단위 R1과 R2 두 정수의 배열이며 `ldo3`, `ldo4`에는 적용하지 않습니다.

Reference와 output voltage 범위

20-28

`sw1`, `sw2`, `sw3`, `ldo2`의 feedback reference는 0.3625~0.75 V를 12.5 mV step으로 조절하며 output은 `0.3625 * (1 + R1/R2)`~`0.75 * (1 + R1/R2)` V입니다. `bb-out`, `ldo1`은 0.8 V 고정 reference이므로 output은 `0.8 * (1 + R1/R2)` V입니다.

`ldo3`은 LTC3589에서 1.8 V, LTC3589-1·2에서 2.8 V로 고정됩니다. `ldo4`는 LTC3589에서 1.8~3.3 V, LTC3589-1·2에서 1.2~3.2 V를 네 step으로 출력합니다. Standby regulator `ldo1`은 disable할 수 없으므로 `regulator-always-on`을 설정해야 합니다.

LTC3589-1 예제

29-99

I2C address 0x34의 LTC3589-1 예제는 8개 rail의 voltage constraint, divider R1·R2, ramp delay와 boot/always-on 상태를 모두 선언합니다.

ltc3589: pmic@34 {
        compatible = "lltc,ltc3589-1";
        reg = <0x34>;

        regulators {
                sw1_reg: sw1 {
                        regulator-min-microvolt = <591930>;
                        regulator-max-microvolt = <1224671>;
                        lltc,fb-voltage-divider = <100000 158000>;
                        regulator-ramp-delay = <7000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                sw2_reg: sw2 {
                        regulator-min-microvolt = <704123>;
                        regulator-max-microvolt = <1456803>;
                        lltc,fb-voltage-divider = <180000 191000>;
                        regulator-ramp-delay = <7000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                sw3_reg: sw3 {
                        regulator-min-microvolt = <1341250>;
                        regulator-max-microvolt = <2775000>;
                        lltc,fb-voltage-divider = <270000 100000>;
                        regulator-ramp-delay = <7000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                bb_out_reg: bb-out {
                        regulator-min-microvolt = <3387341>;
                        regulator-max-microvolt = <3387341>;
                        lltc,fb-voltage-divider = <511000 158000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                ldo1_reg: ldo1 {
                        regulator-min-microvolt = <1306329>;
                        regulator-max-microvolt = <1306329>;
                        lltc,fb-voltage-divider = <100000 158000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                ldo2_reg: ldo2 {
                        regulator-min-microvolt = <704123>;
                        regulator-max-microvolt = <1456806>;
                        lltc,fb-voltage-divider = <180000 191000>;
                        regulator-ramp-delay = <7000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                ldo3_reg: ldo3 {
                        regulator-min-microvolt = <2800000>;
                        regulator-max-microvolt = <2800000>;
                        regulator-boot-on;
                };

                ldo4_reg: ldo4 {
                        regulator-min-microvolt = <1200000>;
                        regulator-max-microvolt = <3200000>;
                };
        };
};