요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
TPS6507x Power Management Integrated Circuit
Required properties:
- compatible: "ti,tps6507x"
- reg: I2C slave address
- regulators: This is the list of child nodes that specify the regulator
initialization data for defined regulators. Not all regulators for the
given device need to be present. The definition for each of these nodes
is defined using the standard binding for regulators found at
Documentation/devicetree/bindings/regulator/regulator.txt.
The regulator is matched with the regulator-compatible.
The valid regulator-compatible values are:
tps6507x: vdcdc1, vdcdc2, vdcdc3, vldo1, vldo2
- xxx-supply: Input voltage supply regulator.
These entries are required if regulators are enabled for a device.
Missing of these properties can cause the regulator registration
fails.
If some of input supply is powered through battery or always-on
supply then also it is require to have these parameters with proper
node handle of always on power supply.
tps6507x:
vindcdc1_2-supply: VDCDC1 and VDCDC2 input.
vindcdc3-supply : VDCDC3 input.
vldo1_2-supply : VLDO1 and VLDO2 input.
Regulator Optional properties:
- defdcdc_default: It's property of DCDC2 and DCDC3 regulators.
0: If defdcdc pin of DCDC2/DCDC3 is pulled to GND.
1: If defdcdc pin of DCDC2/DCDC3 is driven HIGH.
If this property is not defined, it defaults to 0 (not enabled).
Example:
pmu: tps6507x@48 {
compatible = "ti,tps6507x";
reg = <0x48>;
vindcdc1_2-supply = <&vbat>;
vindcdc3-supply = <...>;
vinldo1_2-supply = <...>;
regulators {
#address-cells = <1>;
#size-cells = <0>;
vdcdc1_reg: regulator@0 {
regulator-compatible = "VDCDC1";
reg = <0>;
regulator-min-microvolt = <3150000>;
regulator-max-microvolt = <3450000>;
regulator-always-on;
regulator-boot-on;
};
vdcdc2_reg: regulator@1 {
regulator-compatible = "VDCDC2";
reg = <1>;
regulator-min-microvolt = <1710000>;
regulator-max-microvolt = <3450000>;
regulator-always-on;
regulator-boot-on;
defdcdc_default = <1>;
};
vdcdc3_reg: regulator@2 {
regulator-compatible = "VDCDC3";
reg = <2>;
regulator-min-microvolt = <950000>
regulator-max-microvolt = <1350000>;
regulator-always-on;
regulator-boot-on;
defdcdc_default = <1>;
};
ldo1_reg: regulator@3 {
regulator-compatible = "LDO1";
reg = <3>;
regulator-min-microvolt = <1710000>;
regulator-max-microvolt = <1890000>;
regulator-always-on;
regulator-boot-on;
};
ldo2_reg: regulator@4 {
regulator-compatible = "LDO2";
reg = <4>;
regulator-min-microvolt = <1140000>;
regulator-max-microvolt = <1320000>;
regulator-always-on;
regulator-boot-on;
};
};
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
TPS6507x 필수 속성과 regulator 자식
1-12TPS6507x Power Management Integrated Circuit의 `compatible`은 `ti,tps6507x`, `reg`는 I2C slave address입니다.
`regulators`는 정의된 regulator의 초기화 데이터를 지정하는 자식 목록이며 장치의 모든 regulator가 반드시 존재할 필요는 없습니다. 각 자식은 `Documentation/devicetree/bindings/regulator/regulator.txt`의 표준 regulator 바인딩으로 정의하고 `regulator-compatible`로 대응시킵니다.
Regulator 이름과 입력 전원
13-26유효한 `regulator-compatible` 값은 `vdcdc1`, `vdcdc2`, `vdcdc3`, `vldo1`, `vldo2`입니다.
`xxx-supply`는 입력 전압을 공급하는 regulator입니다. 장치에서 regulator를 활성화하면 이 항목들이 필요하며 빠지면 regulator 등록이 실패할 수 있습니다. 배터리나 always-on supply로 직접 공급되는 입력도 올바른 always-on power-supply node handle을 속성에 지정해야 합니다.
각 supply 속성이 담당하는 regulator 입력입니다.
DCDC2·DCDC3 defdcdc 기본값
27-32선택 속성 `defdcdc_default`는 DCDC2와 DCDC3 regulator에 사용합니다. 값 0은 DCDC2/DCDC3의 `defdcdc` pin이 GND로 pull-down된 경우이고, 값 1은 pin이 HIGH로 구동되는 경우입니다. 속성을 정의하지 않으면 0, 즉 비활성 상태가 기본입니다.
DCDC2·DCDC3 설정과 외부 pin 상태의 대응입니다.
다섯 regulator 예제
33-91예제는 I2C 주소 `0x48`에서 VDCDC1·2 공동 입력, VDCDC3 입력, VLDO1·2 공동 입력을 연결합니다. 설명의 `vldo1_2-supply`와 달리 예제는 `vinldo1_2-supply`를 사용하는 원문 표기 차이를 보존합니다.
VDCDC1은 3.15~3.45V, VDCDC2는 1.71~3.45V, VDCDC3은 0.95~1.35V이며 모두 always-on·boot-on입니다. VDCDC2와 VDCDC3은 `defdcdc_default = <1>`입니다. LDO1은 1.71~1.89V, LDO2는 1.14~1.32V이고 둘 다 always-on·boot-on입니다. VDCDC3 minimum 줄에 세미콜론이 없는 원문도 그대로 보존합니다.
pmu: tps6507x@48 {
compatible = "ti,tps6507x";
reg = <0x48>;
vindcdc1_2-supply = <&vbat>;
vindcdc3-supply = <...>;
vinldo1_2-supply = <...>;
regulators {
#address-cells = <1>;
#size-cells = <0>;
vdcdc1_reg: regulator@0 {
regulator-compatible = "VDCDC1";
reg = <0>;
regulator-min-microvolt = <3150000>;
regulator-max-microvolt = <3450000>;
regulator-always-on;
regulator-boot-on;
};
vdcdc2_reg: regulator@1 {
regulator-compatible = "VDCDC2";
reg = <1>;
regulator-min-microvolt = <1710000>;
regulator-max-microvolt = <3450000>;
regulator-always-on;
regulator-boot-on;
defdcdc_default = <1>;
};
vdcdc3_reg: regulator@2 {
regulator-compatible = "VDCDC3";
reg = <2>;
regulator-min-microvolt = <950000>
regulator-max-microvolt = <1350000>;
regulator-always-on;
regulator-boot-on;
defdcdc_default = <1>;
};
ldo1_reg: regulator@3 {
regulator-compatible = "LDO1";
reg = <3>;
regulator-min-microvolt = <1710000>;
regulator-max-microvolt = <1890000>;
regulator-always-on;
regulator-boot-on;
};
ldo2_reg: regulator@4 {
regulator-compatible = "LDO2";
reg = <4>;
regulator-min-microvolt = <1140000>;
regulator-max-microvolt = <1320000>;
regulator-always-on;
regulator-boot-on;
};
};
};
요약과 해설
tps6507x.txt:1-91VDCDC1~3·LDO1~2의 전원 입력, 전압 범위와 `defdcdc_default` 동작을 설명합니다.