Maxim MAX77620 Power Management IC

Maxim MAX77620 계열 PMIC

이 바인딩은 Maxim Semiconductor의 MAX77620 계열 전원 관리 IC를 설명합니다.

필수 칩과 I2C 주소

`compatible`은 `maxim,max77620`, `maxim,max20024`, `maxim,max77663` 중 하나이고 `reg`는 I2C 장치 주소입니다.

상위 IRQ와 system power

선택적인 `interrupts`는 연결된 상위 controller의 인터럽트입니다. `interrupt-controller`는 이 노드를 컨트롤러로 표시합니다. `#interrupt-cells`는 2이며 `../interrupt-controller/interrupts.txt`의 두 cell 변형을 따릅니다. interrupt source 번호는 `dt-bindings/mfd/max77620.h`에 정의됩니다.

`system-power-controller`는 이 PMIC가 system power를 제어함을 나타냅니다. 자세한 내용은 `Documentation/devicetree/bindings/power/power-controller.txt`를 봅니다.

Flexible Power Sequencer 기능

Flexible Power Sequencer(FPS)는 각 regulator를 hardware 또는 software control로 기동합니다. regulator는 독립적으로 또는 다른 regulator 그룹과 함께 조정 가능한 power-up·power-down delay로 순차 기동할 수 있습니다.

GPIO1·GPIO2·GPIO3를 sequence에 넣어 외부 regulator를 내부 regulator와 함께 제어할 수 있고 32kHz clock도 sequence에 포함할 수 있습니다.

Master timer·slot·inactive 상태

sequencing 구조에는 두 hardware enable input EN0·EN1과 세 master timer FPS0·FPS1·FPS2가 있습니다. 각 timer는 configuration register로 EN1 또는 EN2 hardware source나 SW source를 선택합니다. 활성화·비활성화될 때 서로 다른 시간 구간의 slot event 여덟 개를 만들며 event 사이 시간도 설정할 수 있습니다. 원문은 앞에서 EN0·EN1이라 하고 여기서 EN1·EN2라 쓰는 불일치를 그대로 설명에 보존합니다.

각 regulator, GPIO1~3, 32kHz clock은 enable source를 FPS timer 또는 software bit로 지정하는 slave register를 가집니다. FPS를 source로 선택하면 각 구성 register에서 power-up과 power-down delay를 설정합니다.

FPS event가 LOW로 clear되면 대응 slot에서 sleep state 또는 Global Low Power Mode(GLPM)로 전환할 수 있습니다. sleep에서는 regulator·GPIO·32kHz clock을 끄고, GLPM에서는 regulator를 low-power mode로 설정합니다.

FPS 노드와 system state별 구성

FPS parameter는 `fps` subnode와 `fps0`, `fps1`, `fps2` 자식으로 제공합니다. regulator, GPIO, 32kHz clock의 FPS source 및 power-up/down slot은 각 subsystem 바인딩의 해당 구성 노드에 둡니다. active에서 suspend 또는 shutdown으로 바뀌는 system state에 따라 서로 다른 FPS parameter가 필요합니다.

FPS source·주기·inactive state

`maxim,fps-event-source`는 EN0, EN1 또는 SW 중 event source를 선택하는 `u32`입니다. 매크로 `MAX77620_FPS_EVENT_SRC_EN0`, `MAX77620_FPS_EVENT_SRC_EN1`, `MAX77620_FPS_EVENT_SRC_SW`는 `dt-bindings/mfd/max77620.h`에 정의됩니다.

`maxim,shutdown-fps-time-period-us`와 `maxim,suspend-fps-time-period-us`는 각각 shutdown과 suspend 상태의 FPS 주기를 마이크로초로 지정합니다.

`maxim,device-state-on-disabled-event`는 FPS event가 LOW로 clear될 때 PMIC가 sleep 또는 low-power 상태로 갈지 지정합니다. `MAX77620_FPS_INACTIVE_STATE_SLEEP`은 sleep, `MAX77620_FPS_INACTIVE_STATE_LOW_POWER`는 low power입니다. 속성이 없거나 다른 값이면 clear 시 장치 상태를 바꾸지 않습니다.

지원 FPS 주기와 MAX20024 POK

`maxim,power-ok-control`은 MAX20024에서만 유효한 map power-ok bit 설정입니다. 값 1은 POK가 `nRST_IO`와 GPIO1 POK 기능을 제어하게 하고 0은 제어를 끕니다. 속성이 없으면 MPOK bit를 구성하지 않습니다.

GPIO1/`nRST_IO`에 POK mapping을 켜면 POK 제어가 활성화된 모든 rail이 HIGH일 때만 두 pin이 HIGH입니다. 그중 어느 rail이라도 내려가면 GPIO1/`nRST_IO`도 LOW가 됩니다.

Subsystem 문서와 FPS 예제

GPIO, pincontrol, regulator, power 같은 각 submodule의 세부 사항은 해당 subsystem 디렉터리의 장치 트리 바인딩을 따릅니다.

예제 MAX77620은 I2C 주소 `0x3c`, 상위 interrupt 86과 두 cell IRQ domain을 사용합니다. FPS0은 EN1, FPS1은 EN0, FPS2는 software source이며 세 timer 모두 shutdown period 1280us입니다.

#include <dt-bindings/mfd/max77620.h>

max77620@3c {
        compatible = "maxim,max77620";
        reg = <0x3c>;

        interrupt-parent = <&intc>;
        interrupts = <0 86 IRQ_TYPE_NONE>;

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

        fps {
                fps0 {
                        maxim,shutdown-fps-time-period-us = <1280>;
                        maxim,fps-event-source = <MAX77620_FPS_EVENT_SRC_EN1>;
                };

                fps1 {
                        maxim,shutdown-fps-time-period-us = <1280>;
                        maxim,fps-event-source = <MAX77620_FPS_EVENT_SRC_EN0>;
                };

                fps2 {
                        maxim,shutdown-fps-time-period-us = <1280>;
                        maxim,fps-event-source = <MAX77620_FPS_EVENT_SRC_SW>;
                };
        };
};