TI TPS65217 regulator family | Linux 6.18.37

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

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. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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;
                };
        };
};