github-mirror/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2026-05-12 16:18:45 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity
25c456dab5
linux/Documentation/devicetree/bindings/mfd/maxim,max77620.yaml
Svyatoslav Ryhel 3cef6765b7 dt-bindings: mfd: max77620: Document optional RTC address for MAX77663 
Document an optional second I2C address for the MAX77663 PMIC's RTC
device, to be used if the MAX77663 RTC is located at a non-default I2C
address.

Signed-off-by: Svyatoslav Ryhel <clamor95@gmail.com>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://patch.msgid.link/20260312085258.11431-5-clamor95@gmail.com
Signed-off-by: Lee Jones <lee@kernel.org>
2026-03-25 12:46:21 +00:00

445 lines
15 KiB
YAML
Raw Blame History

# 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>;
};
};
};
};
...
Reference in New Issue View Git Blame Copy Permalink