linux-imx

// SPDX-License-Identifier: GPL-2.0

//

// MCP16502 PMIC driver

//

// Copyright (C) 2018 Microchip Technology Inc. and its subsidiaries

//

// Author: Andrei Stefanescu <andrei.stefanescu@microchip.com>

//

// Inspired from tps65086-regulator.c

​

#include <linux/gpio.h>

#include <linux/i2c.h>

#include <linux/init.h>

#include <linux/kernel.h>

#include <linux/module.h>

#include <linux/of.h>

#include <linux/regmap.h>

#include <linux/regulator/driver.h>

#include <linux/suspend.h>

#include <linux/gpio/consumer.h>

​

#define VDD_LOW_SEL 0x0D

#define VDD_HIGH_SEL 0x3F

​

#define MCP16502_FLT BIT(7)

#define MCP16502_ENS BIT(0)

​

/*

 * The PMIC has four sets of registers corresponding to four power modes:

 * Performance, Active, Low-power, Hibernate.

 *

 * Registers:

 * Each regulator has a register for each power mode. To access a register

 * for a specific regulator and mode BASE_* and OFFSET_* need to be added.

 *

 * Operating modes:

 * In order for the PMIC to transition to operating modes it has to be

 * controlled via GPIO lines called LPM and HPM.

 *

 * The registers are fully configurable such that you can put all regulators in

 * a low-power state while the PMIC is in Active mode. They are supposed to be

 * configured at startup and then simply transition to/from a global low-power

 * state by setting the GPIO lpm pin high/low.

 *

 * This driver keeps the PMIC in Active mode, Low-power state is set for the

 * regulators by enabling/disabling operating mode (FPWM or Auto PFM).

 *

 * The PMIC's Low-power and Hibernate modes are used during standby/suspend.

 * To enter standby/suspend the PMIC will go to Low-power mode. From there, it

 * will transition to Hibernate when the PWRHLD line is set to low by the MPU.

 */

​

/*

 * This function is useful for iterating over all regulators and accessing their

 * registers in a generic way or accessing a regulator device by its id.

 */

#define MCP16502_BASE(i) (((i) + 1) << 4)

#define MCP16502_STAT_BASE(i) ((i) + 5)

​

#define MCP16502_OFFSET_MODE_A 0

#define MCP16502_OFFSET_MODE_LPM 1

#define MCP16502_OFFSET_MODE_HIB 2

​