요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Cirrus Logic/Wolfson Microelectronics wm831x PMICs
System PMICs with a wide range of additional features.
Required properties:
- compatible : One of the following chip-specific strings:
"wlf,wm8310"
"wlf,wm8311"
"wlf,wm8312"
"wlf,wm8320"
"wlf,wm8321"
"wlf,wm8325"
"wlf,wm8326"
- reg : I2C slave address when connected using I2C, chip select number
when using SPI.
- gpio-controller : Indicates this device is a GPIO controller.
- #gpio-cells : Must be 2. The first cell is the pin number and the
second cell is used to specify optional parameters (currently unused).
- interrupts : The interrupt line the IRQ signal for the device is
connected to.
- interrupt-controller : wm831x devices contain interrupt controllers and
may provide interrupt services to other devices.
- #interrupt-cells: Must be 2. The first cell is the IRQ number, and the
second cell is the flags, encoded as the trigger masks from
../interrupt-controller/interrupts.txt
Optional sub-nodes:
- phys : Contains a phandle to the USB PHY.
- regulators : Contains sub-nodes for each of the regulators supplied by
the device. The regulators are bound using their names listed below:
dcdc1 : DCDC1
dcdc2 : DCDC2
dcdc3 : DCDC3
dcdc4 : DCDC3
isink1 : ISINK1
isink2 : ISINK2
ldo1 : LDO1
ldo2 : LDO2
ldo3 : LDO3
ldo4 : LDO4
ldo5 : LDO5
ldo7 : LDO7
ldo11 : LDO11
The bindings details of each regulator can be found in:
../regulator/regulator.txt
Example:
wm8310: pmic@36 {
compatible = "wlf,wm8310";
reg = <0x36>;
gpio-controller;
#gpio-cells = <2>;
interrupts = <347>;
interrupt-parent = <&gic>;
interrupt-controller;
#interrupt-cells = <2>;
regulators {
dcdc1: dcdc1 {
regulator-name = "DCDC1";
regulator-min-microvolt = <600000>;
regulator-max-microvolt = <600000>;
};
ldo1: ldo1 {
regulator-name = "LDO1";
regulator-min-microvolt = <1700000>;
regulator-max-microvolt = <1700000>;
};
};
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Cirrus Logic·Wolfson WM831x PMIC
1-4WM831x는 폭넓은 부가 기능을 갖춘 Cirrus Logic/Wolfson Microelectronics system PMIC 계열입니다.
호환 문자열과 GPIO·IRQ controller
5-30필수 `compatible`은 `wlf,wm8310`, `wlf,wm8311`, `wlf,wm8312`, `wlf,wm8320`, `wlf,wm8321`, `wlf,wm8325`, `wlf,wm8326` 중 하나입니다. `reg`는 I2C 연결에서는 slave address, SPI에서는 chip-select 번호입니다.
`gpio-controller`는 장치를 GPIO controller로 표시합니다. `#gpio-cells`는 2이며 첫 cell은 pin 번호, 둘째 cell은 현재 사용하지 않는 선택 parameter입니다.
`interrupts`는 장치 IRQ signal이 연결된 interrupt line입니다. WM831x는 다른 장치에 interrupt service를 제공할 수 있으므로 `interrupt-controller`를 선언합니다. `#interrupt-cells`는 2이며 첫 cell은 IRQ 번호, 둘째 cell은 `../interrupt-controller/interrupts.txt`의 trigger mask로 인코딩한 flags입니다.
GPIO와 IRQ specifier의 두 cell을 비교합니다.
USB PHY와 regulator 자식
31-53선택 `phys` 자식은 USB PHY phandle을 담습니다. 선택 `regulators`는 장치가 공급하는 regulator마다 자식을 두며 세부 속성은 `../regulator/regulator.txt`를 따릅니다.
원문에 제시된 자식 이름과 대응 regulator입니다. `dcdc4`가 `DCDC3`에 대응한다고 적힌 원문을 그대로 보존합니다.
WM8310 DCDC1·LDO1 예제
54-81예제는 I2C 주소 `0x36`, 두 cell GPIO controller, GIC interrupt 347, 두 cell interrupt controller를 구성합니다. DCDC1은 0.6V 고정, LDO1은 1.7V 고정 regulator입니다.
wm8310: pmic@36 {
compatible = "wlf,wm8310";
reg = <0x36>;
gpio-controller;
#gpio-cells = <2>;
interrupts = <347>;
interrupt-parent = <&gic>;
interrupt-controller;
#interrupt-cells = <2>;
regulators {
dcdc1: dcdc1 {
regulator-name = "DCDC1";
regulator-min-microvolt = <600000>;
regulator-max-microvolt = <600000>;
};
ldo1: ldo1 {
regulator-name = "LDO1";
regulator-min-microvolt = <1700000>;
regulator-max-microvolt = <1700000>;
};
};
};
요약과 해설
wm831x.txt:1-817개 호환 칩, 두 cell controller, USB PHY와 DCDC·ISINK·LDO 자식을 설명합니다.