Documentation/devicetree/bindings/mfd/da9055.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

Dialog DA9055 PMIC

DA9055 PMIC의 자체 IRQ domain, 여섯 하위 기능과 regulator 바인딩입니다.

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

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

1. 요약·해설

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

요약과 해설

da9055.txt:1-70

별도 I2C CODEC과 BUCK·LDO 전압 예제를 설명합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 * Dialog DA9055 Power Management Integrated Circuit (PMIC)
2
3 DA9055 consists of a large and varied group of sub-devices (I2C Only):
4
5 Device Supply Names Description
6 ------ ------------ -----------
7 da9055-gpio : : GPIOs
8 da9055-regulator : : Regulators
9 da9055-onkey : : On key
10 da9055-rtc : : RTC
11 da9055-hwmon : : ADC
12 da9055-watchdog : : Watchdog
13
14 The CODEC device in DA9055 has a separate, configurable I2C address and so
15 is instantiated separately from the PMIC.
16
17 For details on accompanying CODEC I2C device, see the following:
18 Documentation/devicetree/bindings/sound/da9055.txt
19
20 ======
21
22 Required properties:
23 - compatible : Should be "dlg,da9055-pmic"
24 - reg: Specifies the I2C slave address (defaults to 0x5a but can be modified)
25 - interrupts: IRQ line info for da9055 chip.
26 - interrupt-controller: da9055 has internal IRQs (has own IRQ domain).
27 - #interrupt-cells: Should be 1, is the local IRQ number for da9055.
28
29 Sub-nodes:
30 - regulators : Contain the regulator nodes. The DA9055 regulators are
31 bound using their names as listed below:
32
33 buck1 : regulator BUCK1
34 buck2 : regulator BUCK2
35 ldo1 : regulator LDO1
36 ldo2 : regulator LDO2
37 ldo3 : regulator LDO3
38 ldo4 : regulator LDO4
39 ldo5 : regulator LDO5
40 ldo6 : regulator LDO6
41
42 The bindings details of individual regulator device can be found in:
43 Documentation/devicetree/bindings/regulator/regulator.txt
44
45
46 Example:
47
48 pmic: da9055-pmic@5a {
49 compatible = "dlg,da9055-pmic";
50 reg = <0x5a>;
51 interrupt-parent = <&intc>;
52 interrupts = <5 IRQ_TYPE_LEVEL_LOW>;
53 interrupt-controller;
54 #interrupt-cells = <1>;
55
56 regulators {
57 buck1: BUCK1 {
58 regulator-min-microvolt = <725000>;
59 regulator-max-microvolt = <2075000>;
60 };
61 buck2: BUCK2 {
62 regulator-min-microvolt = <925000>;
63 regulator-max-microvolt = <2500000>;
64 };
65 ldo1: LDO1 {
66 regulator-min-microvolt = <900000>;
67 regulator-max-microvolt = <3300000>;
68 };
69 };
70 };
71

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

DA9055 PMIC와 하위 장치

1-21

DA9055는 I2C로 접근하는 GPIO, regulator, on-key, RTC, ADC, watchdog 하위 장치로 구성됩니다. CODEC은 별도로 구성 가능한 I2C 주소를 가지므로 PMIC와 별도 장치로 인스턴스화합니다. CODEC 바인딩은 `Documentation/devicetree/bindings/sound/da9055.txt`를 봅니다.

DA9055 하위 장치
Device설명
da9055-gpioGPIOs
da9055-regulatorRegulators
da9055-onkeyOn key
da9055-rtcRTC
da9055-hwmonADC
da9055-watchdogWatchdog
DA9055 CODEC별도 I2C 장치

PMIC에 포함된 여섯 기능과 별도 I2C CODEC을 구분했습니다.

필수 I2C·IRQ 속성

22-28

`compatible`은 `dlg,da9055-pmic`입니다. `reg`는 기본값 `0x5a`이지만 변경 가능한 I2C slave address이고 `interrupts`는 칩의 IRQ 선 정보입니다. `interrupt-controller`는 자체 IRQ domain을 표시하며 `#interrupt-cells`는 1로 DA9055 local IRQ 번호를 담습니다.

Regulator 자식

29-45

`regulators`에는 `buck1`, `buck2`, `ldo1`부터 `ldo6`까지의 regulator 노드를 넣습니다. 개별 장치의 표준 속성은 `Documentation/devicetree/bindings/regulator/regulator.txt`에 있습니다.

BUCK와 LDO 전압 예제

46-70

예제는 I2C 주소 `0x5a`, active-low level interrupt 5와 한 cell IRQ domain을 사용합니다. BUCK1은 0.725~2.075V, BUCK2는 0.925~2.5V, LDO1은 0.9~3.3V 범위입니다.

pmic: da9055-pmic@5a {
        compatible = "dlg,da9055-pmic";
        reg = <0x5a>;
        interrupt-parent = <&intc>;
        interrupts = <5 IRQ_TYPE_LEVEL_LOW>;
        interrupt-controller;
        #interrupt-cells = <1>;

        regulators {
                buck1: BUCK1 {
                        regulator-min-microvolt = <725000>;
                        regulator-max-microvolt = <2075000>;
                };
                buck2: BUCK2 {
                        regulator-min-microvolt = <925000>;
                        regulator-max-microvolt = <2500000>;
                };
                ldo1: LDO1 {
                        regulator-min-microvolt = <900000>;
                        regulator-max-microvolt = <3300000>;
                };
        };
};