| # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) |
| %YAML 1.2 |
| --- |
| $id: http://devicetree.org/schemas/mfd/maxim,max77620.yaml# |
| $schema: http://devicetree.org/meta-schemas/core.yaml# |
| |
| title: MAX77620 Power management IC from Maxim Semiconductor |
| |
| maintainers: |
| - Svyatoslav Ryhel <clamor95@gmail.com> |
| |
| properties: |
| compatible: |
| enum: |
| - maxim,max20024 |
| - maxim,max77620 |
| - maxim,max77663 |
| |
| reg: |
| description: |
| Can contain an optional second I2C address pointing to the PMIC's |
| RTC device. If no RTC address is provided, a default address specific |
| to this PMIC will be used. |
| minItems: 1 |
| maxItems: 2 |
| |
| reg-names: |
| items: |
| - const: pmic |
| - const: rtc |
| |
| interrupts: |
| maxItems: 1 |
| |
| interrupt-controller: true |
| |
| "#interrupt-cells": |
| const: 2 |
| |
| gpio-controller: true |
| |
| "#gpio-cells": |
| const: 2 |
| description: |
| Device has 8 GPIO pins which can be configured as GPIO as well as |
| the special IO functions. The first cell is the pin number, and the |
| second cell is used to specify the gpio polarity (GPIO_ACTIVE_HIGH or |
| GPIO_ACTIVE_LOW). |
| |
| system-power-controller: true |
| |
| "#thermal-sensor-cells": |
| const: 0 |
| description: |
| Maxim Semiconductor MAX77620 supports alarm interrupts when its |
| die temperature crosses 120C and 140C. These threshold temperatures |
| are not configurable. Device does not provide the real temperature |
| of die other than just indicating whether temperature is above or |
| below threshold level. |
| |
| fps: |
| type: object |
| additionalProperties: false |
| description: | |
| The Flexible Power Sequencer (FPS) allows each regulator to power up |
| under hardware or software control. Additionally, each regulator can |
| power on independently or among a group of other regulators with an |
| adjustable power-up and power-down delays (sequencing). GPIO1, GPIO2, |
| and GPIO3 can be programmed to be part of a sequence allowing external |
| regulators to be sequenced along with internal regulators. 32KHz clock |
| can be programmed to be part of a sequence. |
| |
| The flexible sequencing structure consists of two hardware enable inputs |
| (EN0, EN1), and 3 master sequencing timers called FPS0, FPS1 and FPS2. |
| Each master sequencing timer is programmable through its configuration |
| register to have a hardware enable source (EN1 or EN2) or a software enable |
| source (SW). When enabled/disabled, the master sequencing timer generates |
| eight sequencing events on different time periods called slots. The time |
| period between each event is programmable within the configuration register. |
| Each regulator, GPIO1, GPIO2, GPIO3, and 32KHz clock has a flexible power |
| sequence slave register which allows its enable source to be specified as |
| a flexible power sequencer timer or a software bit. When a FPS source of |
| regulators, GPIOs and clocks specifies the enable source to be a flexible |
| power sequencer, the power up and power down delays can be specified in |
| the regulators, GPIOs and clocks flexible power sequencer configuration |
| registers. |
| |
| When FPS event cleared (set to LOW), regulators, GPIOs and 32KHz clock |
| are set into following state at the sequencing event that corresponds |
| to its flexible sequencer configuration register. |
| |
| Sleep state: In this state, regulators, GPIOs and 32KHz clock get disabled |
| at the sequencing event. |
| Global Low Power Mode (GLPM): In this state, regulators are set in low |
| power mode at the sequencing event. |
| |
| The configuration parameters of FPS is provided through sub-node "fps" |
| and their child for FPS specific. The child node name for FPS are "fps0", |
| "fps1", and "fps2" for FPS0, FPS1 and FPS2 respectively. |
| |
| The FPS configurations like FPS source, power up and power down slots for |
| regulators, GPIOs and 32kHz clocks are provided in their respective |
| configuration nodes which is explained in respective sub-system DT |
| binding document. |
| |
| There is need for different FPS configuration parameters based on system |
| state like when system state changed from active to suspend or active to |
| power off (shutdown). |
| |
| patternProperties: |
| "^fps[0-2]$": |
| type: object |
| additionalProperties: false |
| |
| properties: |
| maxim,fps-event-source: |
| $ref: /schemas/types.yaml#/definitions/uint32 |
| description: | |
| FPS event source like external hardware input to PMIC i.e. EN0, EN1 |
| or software (SW). |
| |
| The macros are defined on dt-bindings/mfd/max77620.h for different |
| control source. |
| - MAX77620_FPS_EVENT_SRC_EN0 for hardware input pin EN0. |
| - MAX77620_FPS_EVENT_SRC_EN1 for hardware input pin EN1. |
| - MAX77620_FPS_EVENT_SRC_SW for software control. |
| |
| maxim,shutdown-fps-time-period-us: |
| description: |
| FPS time period in microseconds when system enters in to shutdown state. |
| |
| maxim,suspend-fps-time-period-us: |
| description: |
| FPS time period in microseconds when system enters in to suspend state. |
| |
| maxim,device-state-on-disabled-event: |
| $ref: /schemas/types.yaml#/definitions/uint32 |
| description: | |
| Describe the PMIC state when FPS event cleared (set to LOW) whether it |
| should go to sleep state or low-power state. Following are valid values: |
| - MAX77620_FPS_INACTIVE_STATE_SLEEP to set the PMIC state to sleep. |
| - MAX77620_FPS_INACTIVE_STATE_LOW_POWER to set the PMIC state to low |
| power. |
| Absence of this property or other value will not change device state |
| when FPS event get cleared. |
| |
| maxim,power-ok-control: |
| $ref: /schemas/types.yaml#/definitions/uint32 |
| description: | |
| Configure map power ok bit |
| |
| 1: Enables POK(Power OK) to control nRST_IO and GPIO1 POK function. |
| 0: Disables POK control. |
| |
| If property missing, do not configure MPOK bit. If POK mapping is |
| enabled for GPIO1/nRST_IO then, GPIO1/nRST_IO pins are HIGH only if |
| all rails that have POK control enabled are HIGH. If any of the rails |
| goes down (which are enabled for POK control) then, GPIO1/nRST_IO |
| goes LOW. |
| enum: [0, 1] |
| |
| pinmux: |
| $ref: /schemas/pinctrl/maxim,max77620-pinctrl.yaml |
| |
| regulators: |
| $ref: /schemas/regulator/maxim,max77620-regulator.yaml |
| |
| allOf: |
| - if: |
| properties: |
| compatible: |
| contains: |
| enum: |
| - maxim,max20024 |
| - maxim,max77663 |
| then: |
| properties: |
| "#thermal-sensor-cells": false |
| fps: |
| patternProperties: |
| "^fps[0-2]$": |
| properties: |
| maxim,shutdown-fps-time-period-us: |
| enum: [20, 40, 80, 160, 320, 640, 1280, 2540] |
| maxim,suspend-fps-time-period-us: |
| enum: [20, 40, 80, 160, 320, 640, 1280, 2540] |
| maxim,power-ok-control: false |
| |
| - if: |
| properties: |
| compatible: |
| contains: |
| const: maxim,max77620 |
| then: |
| properties: |
| fps: |
| patternProperties: |
| "^fps[0-2]$": |
| properties: |
| maxim,shutdown-fps-time-period-us: |
| enum: [40, 80, 160, 320, 640, 1280, 2560, 5120] |
| maxim,suspend-fps-time-period-us: |
| enum: [40, 80, 160, 320, 640, 1280, 2560, 5120] |
| |
| - if: |
| properties: |
| compatible: |
| not: |
| contains: |
| const: maxim,max77663 |
| then: |
| properties: |
| reg-names: false |
| |
| required: |
| - compatible |
| - reg |
| |
| additionalProperties: false |
| |
| examples: |
| - | |
| #include <dt-bindings/interrupt-controller/irq.h> |
| #include <dt-bindings/mfd/max77620.h> |
| |
| i2c { |
| #address-cells = <1>; |
| #size-cells = <0>; |
| |
| pmic@3c { |
| compatible = "maxim,max77620"; |
| reg = <0x3c>; |
| |
| interrupt-parent = <&gpio>; |
| interrupts = <86 IRQ_TYPE_LEVEL_HIGH>; |
| |
| interrupt-controller; |
| #interrupt-cells = <2>; |
| |
| gpio-controller; |
| #gpio-cells = <2>; |
| |
| #thermal-sensor-cells = <0>; |
| |
| system-power-controller; |
| |
| pinctrl-names = "default"; |
| pinctrl-0 = <&max77620_default>; |
| |
| max77620_default: pinmux { |
| gpio0 { |
| pins = "gpio0"; |
| function = "gpio"; |
| }; |
| |
| gpio1 { |
| pins = "gpio1"; |
| function = "fps-out"; |
| maxim,active-fps-source = <MAX77620_FPS_SRC_0>; |
| }; |
| |
| gpio2 { |
| pins = "gpio2"; |
| function = "fps-out"; |
| maxim,active-fps-source = <MAX77620_FPS_SRC_1>; |
| }; |
| |
| gpio3 { |
| pins = "gpio3"; |
| function = "gpio"; |
| }; |
| |
| gpio4 { |
| pins = "gpio4"; |
| function = "32k-out1"; |
| }; |
| |
| gpio5-6 { |
| pins = "gpio5", "gpio6"; |
| function = "gpio"; |
| drive-push-pull = <1>; |
| }; |
| |
| gpio7 { |
| pins = "gpio7"; |
| function = "gpio"; |
| }; |
| }; |
| |
| fps { |
| fps0 { |
| maxim,shutdown-fps-time-period-us = <1280>; |
| maxim,fps-event-source = <MAX77620_FPS_EVENT_SRC_EN0>; |
| }; |
| |
| fps1 { |
| maxim,shutdown-fps-time-period-us = <1280>; |
| maxim,fps-event-source = <MAX77620_FPS_EVENT_SRC_EN1>; |
| }; |
| |
| fps2 { |
| maxim,shutdown-fps-time-period-us = <1280>; |
| maxim,fps-event-source = <MAX77620_FPS_EVENT_SRC_SW>; |
| }; |
| }; |
| |
| regulators { |
| in-sd0-supply = <&vdd_5v0_vbus>; |
| in-sd1-supply = <&vdd_5v0_vbus>; |
| in-sd2-supply = <&vdd_5v0_vbus>; |
| in-sd3-supply = <&vdd_5v0_vbus>; |
| |
| in-ldo0-1-supply = <&vdd_1v8_vio>; |
| in-ldo2-supply = <&vdd_3v3_vbat>; |
| in-ldo3-5-supply = <&vdd_3v3_vbat>; |
| in-ldo4-6-supply = <&vdd_3v3_vbat>; |
| in-ldo7-8-supply = <&vdd_1v8_vio>; |
| |
| sd0 { |
| regulator-name = "vdd_cpu"; |
| regulator-min-microvolt = <800000>; |
| regulator-max-microvolt = <1250000>; |
| regulator-always-on; |
| regulator-boot-on; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_NONE>; |
| }; |
| |
| sd1 { |
| regulator-name = "vdd_core"; |
| regulator-min-microvolt = <950000>; |
| regulator-max-microvolt = <1350000>; |
| regulator-always-on; |
| regulator-boot-on; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_1>; |
| }; |
| |
| vdd_1v8_vio: sd2 { |
| regulator-name = "vdd_1v8_gen"; |
| regulator-min-microvolt = <1800000>; |
| regulator-max-microvolt = <1800000>; |
| regulator-always-on; |
| regulator-boot-on; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_NONE>; |
| }; |
| |
| sd3 { |
| regulator-name = "vddio_ddr"; |
| regulator-min-microvolt = <1200000>; |
| regulator-max-microvolt = <1200000>; |
| regulator-always-on; |
| regulator-boot-on; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_NONE>; |
| }; |
| |
| ldo0 { |
| regulator-name = "avdd_pll"; |
| regulator-min-microvolt = <1200000>; |
| regulator-max-microvolt = <1200000>; |
| regulator-always-on; |
| regulator-boot-on; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_1>; |
| }; |
| |
| ldo1 { |
| regulator-name = "vdd_ddr_hs"; |
| regulator-min-microvolt = <1000000>; |
| regulator-max-microvolt = <1000000>; |
| regulator-always-on; |
| regulator-boot-on; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_NONE>; |
| }; |
| |
| ldo2 { |
| regulator-name = "avdd_usb"; |
| regulator-min-microvolt = <3300000>; |
| regulator-max-microvolt = <3300000>; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_NONE>; |
| }; |
| |
| ldo3 { |
| regulator-name = "vdd_sdmmc3"; |
| regulator-min-microvolt = <3000000>; |
| regulator-max-microvolt = <3000000>; |
| regulator-always-on; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_NONE>; |
| }; |
| |
| ldo4 { |
| regulator-name = "vdd_rtc"; |
| regulator-min-microvolt = <1200000>; |
| regulator-max-microvolt = <1200000>; |
| regulator-always-on; |
| regulator-boot-on; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_0>; |
| }; |
| |
| ldo5 { |
| regulator-name = "vdd_ddr_rx"; |
| regulator-min-microvolt = <2850000>; |
| regulator-max-microvolt = <2850000>; |
| regulator-always-on; |
| regulator-boot-on; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_0>; |
| }; |
| |
| ldo6 { |
| regulator-name = "avdd_osc"; |
| regulator-min-microvolt = <1800000>; |
| regulator-max-microvolt = <1800000>; |
| regulator-always-on; |
| regulator-boot-on; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_NONE>; |
| }; |
| |
| ldo7 { |
| regulator-name = "vdd_1v2_mhl"; |
| regulator-min-microvolt = <1050000>; |
| regulator-max-microvolt = <1250000>; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_NONE>; |
| }; |
| |
| ldo8 { |
| regulator-name = "avdd_dsi_csi"; |
| regulator-min-microvolt = <1200000>; |
| regulator-max-microvolt = <1200000>; |
| |
| maxim,active-fps-source = <MAX77620_FPS_SRC_NONE>; |
| }; |
| }; |
| }; |
| }; |
| ... |
