TI TPS65217 regulator family | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

tps65217.txt:1-78

칩별 supply와 regulator 이름, 확장 property, 예제 수치를 영어 원문 전체 및 줄 좌표별 한국어 전문과 함께 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 TPS65217 family of regulators

3 Required properties:

4 - compatible: "ti,tps65217"

5 - reg: I2C slave address

6 - regulators: list of regulators provided by this controller, must be named

7 after their hardware counterparts: dcdc[1-3] and ldo[1-4]

8 - regulators: This is the list of child nodes that specify the regulator

9 initialization data for defined regulators. Not all regulators for the given

10 device need to be present. The definition for each of these nodes is defined

11 using the standard binding for regulators found at

12 Documentation/devicetree/bindings/regulator/regulator.txt.

14 Optional properties:

15 - ti,pmic-shutdown-controller: Telling the PMIC to shutdown on PWR_EN toggle.

17 The valid names for regulators are:

18 tps65217: dcdc1, dcdc2, dcdc3, ldo1, ldo2, ldo3 and ldo4

20 Each regulator is defined using the standard binding for regulators.

22 Example:

24 tps: tps@24 {

25 compatible = "ti,tps65217";

26 ti,pmic-shutdown-controller;

28 regulators {

29 dcdc1_reg: dcdc1 {

30 regulator-min-microvolt = <900000>;

31 regulator-max-microvolt = <1800000>;

32 regulator-boot-on;

33 regulator-always-on;

34 };

36 dcdc2_reg: dcdc2 {

37 regulator-min-microvolt = <900000>;

38 regulator-max-microvolt = <3300000>;

39 regulator-boot-on;

40 regulator-always-on;

41 };

43 dcdc3_reg: dcc3 {

44 regulator-min-microvolt = <900000>;

45 regulator-max-microvolt = <1500000>;

46 regulator-boot-on;

47 regulator-always-on;

48 };

50 ldo1_reg: ldo1 {

51 regulator-min-microvolt = <1000000>;

52 regulator-max-microvolt = <3300000>;

53 regulator-boot-on;

54 regulator-always-on;

55 };

57 ldo2_reg: ldo2 {

58 regulator-min-microvolt = <900000>;

59 regulator-max-microvolt = <3300000>;

60 regulator-boot-on;

61 regulator-always-on;

62 };

64 ldo3_reg: ldo3 {

65 regulator-min-microvolt = <1800000>;

66 regulator-max-microvolt = <3300000>;

67 regulator-boot-on;

68 regulator-always-on;

69 };

71 ldo4_reg: ldo4 {

72 regulator-min-microvolt = <1800000>;

73 regulator-max-microvolt = <3300000>;

74 regulator-boot-on;

75 regulator-always-on;

76 };

77 };

78 };

3. 한국어 전문 번역

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

TPS65217 필수 property

1-13

TPS65217 regulator 계열의 필수 `compatible`은 `ti,tps65217`, `reg`는 I2C slave address입니다. `regulators` node에는 hardware 이름에 맞춰 `dcdc[1-3]`과 `ldo[1-4]` child node를 둡니다.

Device가 제공하는 모든 regulator를 반드시 넣을 필요는 없습니다. 각 node의 초기화 data와 정의는 `Documentation/devicetree/bindings/regulator/regulator.txt`의 표준 regulator binding을 따릅니다.

Shutdown controller와 유효 이름

14-21

선택 property `ti,pmic-shutdown-controller`는 PWR_EN toggle 때 PMIC가 shutdown하도록 지시합니다. 유효한 TPS65217 regulator 이름은 `dcdc1`, `dcdc2`, `dcdc3`, `ldo1`, `ldo2`, `ldo3`, `ldo4`이며 각 regulator는 표준 binding으로 정의합니다.

TPS65217 일곱 rail 예제

22-78

예제는 PMIC shutdown controller를 enable하고 세 DCDC와 네 LDO를 모두 boot-on·always-on으로 선언합니다. 전압 범위는 `dcdc1` 900,000~1,800,000, `dcdc2` 900,000~3,300,000, `dcdc3` 900,000~1,500,000 microvolt입니다.

`ldo1`은 1,000,000~3,300,000, `ldo2`는 900,000~3,300,000, `ldo3`과 `ldo4`는 1,800,000~3,300,000 microvolt입니다. 원문 예제의 `dcdc3_reg` node 이름은 `dcc3`로 적혀 있습니다.

tps: tps@24 {
        compatible = "ti,tps65217";
        ti,pmic-shutdown-controller;

        regulators {
                dcdc1_reg: dcdc1 {
                        regulator-min-microvolt = <900000>;
                        regulator-max-microvolt = <1800000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                dcdc2_reg: dcdc2 {
                        regulator-min-microvolt = <900000>;
                        regulator-max-microvolt = <3300000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                dcdc3_reg: dcc3 {
                        regulator-min-microvolt = <900000>;
                        regulator-max-microvolt = <1500000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                ldo1_reg: ldo1 {
                        regulator-min-microvolt = <1000000>;
                        regulator-max-microvolt = <3300000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

                ldo2_reg: ldo2 {
                        regulator-min-microvolt = <900000>;
                        regulator-max-microvolt = <3300000>;
                        regulator-boot-on;
                        regulator-always-on;
                };

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

                ldo4_reg: ldo4 {
                        regulator-min-microvolt = <1800000>;
                        regulator-max-microvolt = <3300000>;
                        regulator-boot-on;
                        regulator-always-on;
                };
        };
};