ams AS3722 PMIC

ams AS3722 전원 관리 IC

AS3722는 ams의 전원 관리 IC로 regulator, RTC, GPIO와 외부 입력의 인터럽트를 통합합니다.

필수 상위 속성

`compatible`은 `ams,as3722`, `reg`는 I2C 장치 주소입니다. `interrupt-controller`는 AS3722가 RTC, regulator, GPIO 같은 내부 sub-block과 외부 입력의 요청을 받는 내부 interrupt controller임을 표시합니다.

`#interrupt-cells`는 IRQ 번호와 flag를 위해 2입니다. 첫 cell은 `dt-bindings/mfd/as3722.h`에 정의된 AS3722 interrupt source의 IRQ 번호입니다. 둘째 cell은 `dt-bindings/irq`를 사용해 `interrupts.txt`의 trigger mask로 인코딩한 flag입니다.

내부 pull-up과 AC_OK 기동

불리언 `ams,enable-internal-int-pullup`은 interrupt pin의 내부 pull-up을 켭니다. 없으면 INT pin pull-up을 끕니다. `ams,enable-internal-i2c-pullup`은 I2C SCL/SDA 내부 pull-up을 켜며 없으면 두 선의 pull-up을 끕니다.

`ams,enable-ac-ok-power-on`은 power-off mode에서 AC_OK pin을 활성화해 그 pin으로 power-off mode를 빠져나오도록 합니다.

Pinmux와 GPIO 개요

AS3722의 GPIO pin 8개는 일반 GPIO 또는 special I/O function으로 구성할 수 있습니다. 클라이언트 장치가 쓰는 공통 pinctrl 바인딩과 `pin configuration node`의 의미는 이 디렉터리의 `pinctrl-bindings.txt`를 참조합니다.

GPIO controller와 pin 설정

GPIO 및 pinmux 기능이 필요하면 `gpio-controller`와 `#gpio-cells`가 필수입니다. GPIO cell 형식은 `gpio/gpio.txt`를 따릅니다. 부팅 때 pin control 설정이 필요하면 `pinctrl-names`에 `default` 상태를 정의하고 `pinctrl[0...n]`에 상태 0부터 n까지 각 설정 노드의 phandle을 넣습니다.

각 설정 노드는 pin 목록별 subnode를 가지며 mux function과 pull-up, open-drain 같은 구성을 지정합니다. subnode의 필수 `pins`에는 `gpio0`부터 `gpio7`까지를 사용할 수 있습니다. 선택 속성은 `function`, `bias-disable`, `bias-pull-up`, `bias-pull-down`, `bias-high-impedance`, `drive-open-drain`입니다.

Regulator supply와 외부 제어

장치에는 여러 DCDC와 LDO가 있습니다. regulator 기능이 필요하면 `regulators` 노드가 필요합니다. regulator 입력 전원은 regulator 노드의 선택 속성입니다.

regulator subnode 이름은 `sd[0-6]`, `ldo[0-7]`, `ldo[9-11]` 중 하나여야 합니다. 각 노드는 해당 regulator의 constraint와 초기화 정보를 담으며 표준 속성은 `regulator.txt`를 따릅니다.

`ams,ext-control`은 rail을 제어하는 외부 입력을 선택합니다. 0은 외부 제어 없음, 1은 ENABLE1, 2는 ENABLE2, 3은 ENABLE3 pin입니다. 생략하면 외부 제어가 없다고 간주하며 매크로는 `dt-bindings/mfd/as3722.h`에 있습니다. `ams,enable-tracking`은 SD1 tracking을 켜며 LDO3에서만 지원됩니다.

System power-off

AS3722는 모든 rail을 꺼 시스템 전원을 차단할 수 있습니다. 장치 노드에 불리언 `ams,system-power-controller`를 두면 이 장치를 통한 power-off 기능을 활성화합니다.

Pinmux와 regulator 예제

예제는 헤더 `dt-bindings/mfd/as3722.h`를 포함하고 I2C 주소 `0x48`, system power controller, 두 interrupt cell과 두 GPIO cell을 지정합니다. GPIO0은 pull-down GPIO, GPIO1·2·4·7은 pull-up GPIO, GPIO5는 32kHz clock output입니다.

regulator 예제에서 SD0은 ENABLE2, SD1은 ENABLE1 외부 입력으로 제어됩니다. SD0·SD1은 0.7~1.4V, SD2는 1.35V, SD4는 1.05V, SD5는 1.8V로 항상 켜집니다. 원문의 `...`와 `....` 생략 표기는 그대로 보존합니다.

#include <dt-bindings/mfd/as3722.h>
...
ams3722 {
        compatible = "ams,as3722";
        reg = <0x48>;

        ams,system-power-controller;

        interrupt-parent = <&intc>;
        interrupt-controller;
        #interrupt-cells = <2>;

        gpio-controller;
        #gpio-cells = <2>;

        pinctrl-names = "default";
        pinctrl-0 = <&as3722_default>;

        as3722_default: pinmux {
                        gpio0 {
                                pins = "gpio0";
                                function = "gpio";
                                bias-pull-down;
                        };

                        gpio1_2_4_7 {
                                pins = "gpio1", "gpio2", "gpio4", "gpio7";
                                function = "gpio";
                                bias-pull-up;
                        };

                        gpio5 {
                                pins = "gpio5";
                                function = "clk32k_out";
                        };
        }

        regulators {
                        vsup-sd2-supply = <...>;
                        ...

                        sd0 {
                                regulator-name = "vdd_cpu";
                                regulator-min-microvolt = <700000>;
                                regulator-max-microvolt = <1400000>;
                                regulator-always-on;
                                ams,ext-control = <2>;
                        };

                        sd1 {
                                regulator-name = "vdd_core";
                                regulator-min-microvolt = <700000>;
                                regulator-max-microvolt = <1400000>;
                                regulator-always-on;
                                ams,ext-control = <1>;
                        };

                        sd2 {
                                regulator-name = "vddio_ddr";
                                regulator-min-microvolt = <1350000>;
                                regulator-max-microvolt = <1350000>;
                                regulator-always-on;
                        };

                        sd4 {
                                regulator-name = "avdd-hdmi-pex";
                                regulator-min-microvolt = <1050000>;
                                regulator-max-microvolt = <1050000>;
                                regulator-always-on;
                        };

                        sd5 {
                                regulator-name = "vdd-1v8";
                                regulator-min-microvolt = <1800000>;
                                regulator-max-microvolt = <1800000>;
                                regulator-always-on;
                        };
                        ....
        };
};