← Documents Documentation/devicetree/bindings/regulator/tps65090.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

TI TPS65090 regulators

TPS65090의 DCDC·FET·LDO supply, 외부 GPIO 제어와 overcurrent wait를 설명합니다.

Source pathDocumentation/devicetree/bindings/regulator/tps65090.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

tps65090.txt:1-126

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

2. 영어 원문 전체

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

원문 전체 펼치기
1 TPS65090 regulators
2
3 Required properties:
4 - compatible: "ti,tps65090"
5 - reg: I2C slave address
6 - interrupts: the interrupt outputs of the controller
7 - regulators: A node that houses a sub-node for each regulator within the
8 device. Each sub-node is identified using the node's name, with valid
9 values listed below. The content of each sub-node is defined by the
10 standard binding for regulators; see regulator.txt.
11 dcdc[1-3], fet[1-7] and ldo[1-2] respectively.
12 - vsys[1-3]-supply: The input supply for DCDC[1-3] respectively.
13 - infet[1-7]-supply: The input supply for FET[1-7] respectively.
14 - vsys-l[1-2]-supply: The input supply for LDO[1-2] respectively.
15
16 Optional properties:
17 - ti,enable-ext-control: This is applicable for DCDC1, DCDC2 and DCDC3.
18 If DCDCs are externally controlled then this property should be there.
19 - dcdc-ext-control-gpios: This is applicable for DCDC1, DCDC2 and DCDC3.
20 If DCDCs are externally controlled and if it is from GPIO then GPIO
21 number should be provided. If it is externally controlled and no GPIO
22 entry then driver will just configure this rails as external control
23 and will not provide any enable/disable APIs.
24 - ti,overcurrent-wait: This is applicable to FET registers, which have a
25 poorly defined "overcurrent wait" field. If this property is present it
26 should be between 0 - 3. If this property isn't present we won't touch the
27 "overcurrent wait" field and we'll leave it to the BIOS/EC to deal with.
28
29 Each regulator is defined using the standard binding for regulators.
30
31 Example:
32
33 tps65090@48 {
34 compatible = "ti,tps65090";
35 reg = <0x48>;
36 interrupts = <0 88 0x4>;
37
38 vsys1-supply = <&some_reg>;
39 vsys2-supply = <&some_reg>;
40 vsys3-supply = <&some_reg>;
41 infet1-supply = <&some_reg>;
42 infet2-supply = <&some_reg>;
43 infet3-supply = <&some_reg>;
44 infet4-supply = <&some_reg>;
45 infet5-supply = <&some_reg>;
46 infet6-supply = <&some_reg>;
47 infet7-supply = <&some_reg>;
48 vsys-l1-supply = <&some_reg>;
49 vsys-l2-supply = <&some_reg>;
50
51 regulators {
52 dcdc1 {
53 regulator-name = "dcdc1";
54 regulator-boot-on;
55 regulator-always-on;
56 ti,enable-ext-control;
57 dcdc-ext-control-gpios = <&gpio 10 0>;
58 };
59
60 dcdc2 {
61 regulator-name = "dcdc2";
62 regulator-boot-on;
63 regulator-always-on;
64 };
65
66 dcdc3 {
67 regulator-name = "dcdc3";
68 regulator-boot-on;
69 regulator-always-on;
70 };
71
72 fet1 {
73 regulator-name = "fet1";
74 regulator-boot-on;
75 regulator-always-on;
76 };
77
78 fet2 {
79 regulator-name = "fet2";
80 regulator-boot-on;
81 regulator-always-on;
82 };
83
84 fet3 {
85 regulator-name = "fet3";
86 regulator-boot-on;
87 regulator-always-on;
88 };
89
90 fet4 {
91 regulator-name = "fet4";
92 regulator-boot-on;
93 regulator-always-on;
94 };
95
96 fet5 {
97 regulator-name = "fet5";
98 regulator-boot-on;
99 regulator-always-on;
100 };
101
102 fet6 {
103 regulator-name = "fet6";
104 regulator-boot-on;
105 regulator-always-on;
106 };
107
108 fet7 {
109 regulator-name = "fet7";
110 regulator-boot-on;
111 regulator-always-on;
112 };
113
114 ldo1 {
115 regulator-name = "ldo1";
116 regulator-boot-on;
117 regulator-always-on;
118 };
119
120 ldo2 {
121 regulator-name = "ldo2";
122 regulator-boot-on;
123 regulator-always-on;
124 };
125 };
126 };
127

3. 한국어 전문 번역

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

TPS65090 필수 property와 supply

1-15

TPS65090 regulator의 필수 `compatible`은 `ti,tps65090`, `reg`는 I2C slave address, `interrupts`는 controller의 interrupt output입니다.

`regulators` node에는 device의 각 regulator를 subnode로 둡니다. 유효한 이름은 `dcdc[1-3]`, `fet[1-7]`, `ldo[1-2]`이며 각 내용은 `regulator.txt`의 표준 binding으로 정의합니다.

`vsys[1-3]-supply`는 각각 DCDC1~3의 input supply, `infet[1-7]-supply`는 각각 FET1~7의 input supply, `vsys-l[1-2]-supply`는 각각 LDO1~2의 input supply입니다.

외부 제어와 overcurrent wait

16-30

`ti,enable-ext-control`은 DCDC1·DCDC2·DCDC3이 외부에서 제어될 때 지정합니다. 외부 제어가 GPIO를 통해 이뤄지면 `dcdc-ext-control-gpios`에 GPIO 번호를 제공합니다. 외부 제어이지만 GPIO 항목이 없으면 driver는 rail을 external control로만 구성하고 enable/disable API를 제공하지 않습니다.

`ti,overcurrent-wait`는 정의가 불명확한 `overcurrent wait` field가 있는 FET register에 적용하며 값은 0~3이어야 합니다. Property가 없으면 driver가 field를 건드리지 않고 BIOS/EC가 처리하도록 둡니다. 각 regulator는 표준 regulator binding으로 정의합니다.

TPS65090 전체 rail 예제

31-126

I2C address 0x48의 예제는 DCDC 3개, FET 7개, LDO 2개의 모든 input supply를 `some_reg`에 연결합니다. 모든 rail은 boot-on·always-on이며, `dcdc1`만 `ti,enable-ext-control`과 GPIO 10을 사용합니다.

tps65090@48 {
        compatible = "ti,tps65090";
        reg = <0x48>;
        interrupts = <0 88 0x4>;

        vsys1-supply = <&some_reg>;
        vsys2-supply = <&some_reg>;
        vsys3-supply = <&some_reg>;
        infet1-supply = <&some_reg>;
        infet2-supply = <&some_reg>;
        infet3-supply = <&some_reg>;
        infet4-supply = <&some_reg>;
        infet5-supply = <&some_reg>;
        infet6-supply = <&some_reg>;
        infet7-supply = <&some_reg>;
        vsys-l1-supply = <&some_reg>;
        vsys-l2-supply = <&some_reg>;

        regulators {
                dcdc1 {
                        regulator-name = "dcdc1";
                        regulator-boot-on;
                        regulator-always-on;
                        ti,enable-ext-control;
                        dcdc-ext-control-gpios = <&gpio 10 0>;
                };

                dcdc2 {
                        regulator-name = "dcdc2";
                        regulator-boot-on;
                        regulator-always-on;
                };

                dcdc3 {
                        regulator-name = "dcdc3";
                        regulator-boot-on;
                        regulator-always-on;
                };

                fet1 {
                        regulator-name = "fet1";
                        regulator-boot-on;
                        regulator-always-on;
                };

                fet2 {
                        regulator-name = "fet2";
                        regulator-boot-on;
                        regulator-always-on;
                };

                fet3 {
                        regulator-name = "fet3";
                        regulator-boot-on;
                        regulator-always-on;
                };

                fet4 {
                        regulator-name = "fet4";
                        regulator-boot-on;
                        regulator-always-on;
                };

                fet5 {
                        regulator-name = "fet5";
                        regulator-boot-on;
                        regulator-always-on;
                };

                fet6 {
                        regulator-name = "fet6";
                        regulator-boot-on;
                        regulator-always-on;
                };

                fet7 {
                        regulator-name = "fet7";
                        regulator-boot-on;
                        regulator-always-on;
                };

                ldo1 {
                        regulator-name = "ldo1";
                        regulator-boot-on;
                        regulator-always-on;
                };

                ldo2 {
                        regulator-name = "ldo2";
                        regulator-boot-on;
                        regulator-always-on;
                };
        };
};