linux/include/linux/mfd/lp87565.h
<<
>>
Prefs
   1/* SPDX-License-Identifier: GPL-2.0-only */
   2/*
   3 * Functions to access LP87565 power management chip.
   4 *
   5 * Copyright (C) 2017 Texas Instruments Incorporated - https://www.ti.com/
   6 */
   7
   8#ifndef __LINUX_MFD_LP87565_H
   9#define __LINUX_MFD_LP87565_H
  10
  11#include <linux/i2c.h>
  12#include <linux/regulator/driver.h>
  13#include <linux/regulator/machine.h>
  14
  15enum lp87565_device_type {
  16        LP87565_DEVICE_TYPE_UNKNOWN     = 0,
  17        LP87565_DEVICE_TYPE_LP87524_Q1,
  18        LP87565_DEVICE_TYPE_LP87561_Q1,
  19        LP87565_DEVICE_TYPE_LP87565_Q1,
  20};
  21
  22/* All register addresses */
  23#define LP87565_REG_DEV_REV             0X00
  24#define LP87565_REG_OTP_REV             0X01
  25#define LP87565_REG_BUCK0_CTRL_1                0X02
  26#define LP87565_REG_BUCK0_CTRL_2                0X03
  27
  28#define LP87565_REG_BUCK1_CTRL_1                0X04
  29#define LP87565_REG_BUCK1_CTRL_2                0X05
  30
  31#define LP87565_REG_BUCK2_CTRL_1                0X06
  32#define LP87565_REG_BUCK2_CTRL_2                0X07
  33
  34#define LP87565_REG_BUCK3_CTRL_1                0X08
  35#define LP87565_REG_BUCK3_CTRL_2                0X09
  36
  37#define LP87565_REG_BUCK0_VOUT                  0X0A
  38#define LP87565_REG_BUCK0_FLOOR_VOUT            0X0B
  39
  40#define LP87565_REG_BUCK1_VOUT                  0X0C
  41#define LP87565_REG_BUCK1_FLOOR_VOUT            0X0D
  42
  43#define LP87565_REG_BUCK2_VOUT                  0X0E
  44#define LP87565_REG_BUCK2_FLOOR_VOUT            0X0F
  45
  46#define LP87565_REG_BUCK3_VOUT                  0X10
  47#define LP87565_REG_BUCK3_FLOOR_VOUT            0X11
  48
  49#define LP87565_REG_BUCK0_DELAY                 0X12
  50#define LP87565_REG_BUCK1_DELAY                 0X13
  51
  52#define LP87565_REG_BUCK2_DELAY                 0X14
  53#define LP87565_REG_BUCK3_DELAY                 0X15
  54
  55#define LP87565_REG_GPO2_DELAY                  0X16
  56#define LP87565_REG_GPO3_DELAY                  0X17
  57#define LP87565_REG_RESET                       0X18
  58#define LP87565_REG_CONFIG                      0X19
  59
  60#define LP87565_REG_INT_TOP_1                   0X1A
  61#define LP87565_REG_INT_TOP_2                   0X1B
  62
  63#define LP87565_REG_INT_BUCK_0_1                0X1C
  64#define LP87565_REG_INT_BUCK_2_3                0X1D
  65#define LP87565_REG_TOP_STAT                    0X1E
  66#define LP87565_REG_BUCK_0_1_STAT               0X1F
  67#define LP87565_REG_BUCK_2_3_STAT               0x20
  68
  69#define LP87565_REG_TOP_MASK_1                  0x21
  70#define LP87565_REG_TOP_MASK_2                  0x22
  71
  72#define LP87565_REG_BUCK_0_1_MASK               0x23
  73#define LP87565_REG_BUCK_2_3_MASK               0x24
  74#define LP87565_REG_SEL_I_LOAD                  0x25
  75
  76#define LP87565_REG_I_LOAD_2                    0x26
  77#define LP87565_REG_I_LOAD_1                    0x27
  78
  79#define LP87565_REG_PGOOD_CTRL1                 0x28
  80#define LP87565_REG_PGOOD_CTRL2                 0x29
  81#define LP87565_REG_PGOOD_FLT                   0x2A
  82#define LP87565_REG_PLL_CTRL                    0x2B
  83#define LP87565_REG_PIN_FUNCTION                0x2C
  84#define LP87565_REG_GPIO_CONFIG                 0x2D
  85#define LP87565_REG_GPIO_IN                     0x2E
  86#define LP87565_REG_GPIO_OUT                    0x2F
  87
  88#define LP87565_REG_MAX                 LP87565_REG_GPIO_OUT
  89
  90/* Register field definitions */
  91#define LP87565_DEV_REV_DEV_ID                  0xC0
  92#define LP87565_DEV_REV_ALL_LAYER               0x30
  93#define LP87565_DEV_REV_METAL_LAYER             0x0F
  94
  95#define LP87565_OTP_REV_OTP_ID                  0xFF
  96
  97#define LP87565_BUCK_CTRL_1_EN                  BIT(7)
  98#define LP87565_BUCK_CTRL_1_EN_PIN_CTRL         BIT(6)
  99#define LP87565_BUCK_CTRL_1_PIN_SELECT_EN       0x30
 100
 101#define LP87565_BUCK_CTRL_1_ROOF_FLOOR_EN       BIT(3)
 102#define LP87565_BUCK_CTRL_1_RDIS_EN             BIT(2)
 103#define LP87565_BUCK_CTRL_1_FPWM                BIT(1)
 104/* Bit0 is reserved for BUCK1 and BUCK3 and valid only for BUCK0 and BUCK2 */
 105#define LP87565_BUCK_CTRL_1_FPWM_MP_0_2         BIT(0)
 106
 107#define LP87565_BUCK_CTRL_2_ILIM                0x38
 108#define LP87565_BUCK_CTRL_2_SLEW_RATE           0x07
 109
 110#define LP87565_BUCK_VSET                       0xFF
 111#define LP87565_BUCK_FLOOR_VSET                 0xFF
 112
 113#define LP87565_BUCK_SHUTDOWN_DELAY             0xF0
 114#define LP87565_BUCK_STARTUP_DELAY              0x0F
 115
 116#define LP87565_GPIO_SHUTDOWN_DELAY             0xF0
 117#define LP87565_GPIO_STARTUP_DELAY              0x0F
 118
 119#define LP87565_RESET_SW_RESET                  BIT(0)
 120
 121#define LP87565_CONFIG_DOUBLE_DELAY             BIT(7)
 122#define LP87565_CONFIG_CLKIN_PD                 BIT(6)
 123#define LP87565_CONFIG_EN4_PD                   BIT(5)
 124#define LP87565_CONFIG_EN3_PD                   BIT(4)
 125#define LP87565_CONFIG_TDIE_WARN_LEVEL          BIT(3)
 126#define LP87565_CONFIG_EN2_PD                   BIT(2)
 127#define LP87565_CONFIG_EN1_PD                   BIT(1)
 128
 129#define LP87565_INT_GPIO                        BIT(7)
 130#define LP87565_INT_BUCK23                      BIT(6)
 131#define LP87565_INT_BUCK01                      BIT(5)
 132#define LP87565_NO_SYNC_CLK                     BIT(4)
 133#define LP87565_TDIE_SD                         BIT(3)
 134#define LP87565_TDIE_WARN                       BIT(2)
 135#define LP87565_INT_OVP                         BIT(1)
 136#define LP87565_I_LOAD_READY                    BIT(0)
 137
 138#define LP87565_INT_TOP2_RESET_REG              BIT(0)
 139
 140#define LP87565_BUCK1_PG_INT                    BIT(6)
 141#define LP87565_BUCK1_SC_INT                    BIT(5)
 142#define LP87565_BUCK1_ILIM_INT                  BIT(4)
 143#define LP87565_BUCK0_PG_INT                    BIT(2)
 144#define LP87565_BUCK0_SC_INT                    BIT(1)
 145#define LP87565_BUCK0_ILIM_INT                  BIT(0)
 146
 147#define LP87565_BUCK3_PG_INT                    BIT(6)
 148#define LP87565_BUCK3_SC_INT                    BIT(5)
 149#define LP87565_BUCK3_ILIM_INT                  BIT(4)
 150#define LP87565_BUCK2_PG_INT                    BIT(2)
 151#define LP87565_BUCK2_SC_INT                    BIT(1)
 152#define LP87565_BUCK2_ILIM_INT                  BIT(0)
 153
 154#define LP87565_SYNC_CLK_STAT                   BIT(4)
 155#define LP87565_TDIE_SD_STAT                    BIT(3)
 156#define LP87565_TDIE_WARN_STAT                  BIT(2)
 157#define LP87565_OVP_STAT                        BIT(1)
 158
 159#define LP87565_BUCK1_STAT                      BIT(7)
 160#define LP87565_BUCK1_PG_STAT                   BIT(6)
 161#define LP87565_BUCK1_ILIM_STAT                 BIT(4)
 162#define LP87565_BUCK0_STAT                      BIT(3)
 163#define LP87565_BUCK0_PG_STAT                   BIT(2)
 164#define LP87565_BUCK0_ILIM_STAT                 BIT(0)
 165
 166#define LP87565_BUCK3_STAT                      BIT(7)
 167#define LP87565_BUCK3_PG_STAT                   BIT(6)
 168#define LP87565_BUCK3_ILIM_STAT                 BIT(4)
 169#define LP87565_BUCK2_STAT                      BIT(3)
 170#define LP87565_BUCK2_PG_STAT                   BIT(2)
 171#define LP87565_BUCK2_ILIM_STAT                 BIT(0)
 172
 173#define LPL87565_GPIO_MASK                      BIT(7)
 174#define LPL87565_SYNC_CLK_MASK                  BIT(4)
 175#define LPL87565_TDIE_WARN_MASK                 BIT(2)
 176#define LPL87565_I_LOAD_READY_MASK              BIT(0)
 177
 178#define LPL87565_RESET_REG_MASK                 BIT(0)
 179
 180#define LPL87565_BUCK1_PG_MASK                  BIT(6)
 181#define LPL87565_BUCK1_ILIM_MASK                BIT(4)
 182#define LPL87565_BUCK0_PG_MASK                  BIT(2)
 183#define LPL87565_BUCK0_ILIM_MASK                BIT(0)
 184
 185#define LPL87565_BUCK3_PG_MASK                  BIT(6)
 186#define LPL87565_BUCK3_ILIM_MASK                BIT(4)
 187#define LPL87565_BUCK2_PG_MASK                  BIT(2)
 188#define LPL87565_BUCK2_ILIM_MASK                BIT(0)
 189
 190#define LP87565_LOAD_CURRENT_BUCK_SELECT        0x3
 191
 192#define LP87565_I_LOAD2_BUCK_LOAD_CURRENT       0x3
 193#define LP87565_I_LOAD1_BUCK_LOAD_CURRENT       0xFF
 194
 195#define LP87565_PG3_SEL                         0xC0
 196#define LP87565_PG2_SEL                         0x30
 197#define LP87565_PG1_SEL                         0x0C
 198#define LP87565_PG0_SEL                         0x03
 199
 200#define LP87565_HALF_DAY                        BIT(7)
 201#define LP87565_EN_PG0_NINT                     BIT(6)
 202#define LP87565_PGOOD_SET_DELAY                 BIT(5)
 203#define LP87565_EN_PGFLT_STAT                   BIT(4)
 204#define LP87565_PGOOD_WINDOW                    BIT(2)
 205#define LP87565_PGOOD_OD                        BIT(1)
 206#define LP87565_PGOOD_POL                       BIT(0)
 207
 208#define LP87565_PG3_FLT                         BIT(3)
 209#define LP87565_PG2_FLT                         BIT(2)
 210#define LP87565_PG1_FLT                         BIT(1)
 211#define LP87565_PG0_FLT                         BIT(0)
 212
 213#define LP87565_PLL_MODE                        0xC0
 214#define LP87565_EXT_CLK_FREQ                    0x1F
 215
 216#define LP87565_EN_SPREAD_SPEC                  BIT(7)
 217#define LP87565_EN_PIN_CTRL_GPIO3               BIT(6)
 218#define LP87565_EN_PIN_SELECT_GPIO3             BIT(5)
 219#define LP87565_EN_PIN_CTRL_GPIO2               BIT(4)
 220#define LP87565_EN_PIN_SELECT_GPIO2             BIT(3)
 221#define LP87565_GPIO3_SEL                       BIT(2)
 222#define LP87565_GPIO2_SEL                       BIT(1)
 223#define LP87565_GPIO1_SEL                       BIT(0)
 224
 225#define LP87565_GPIO3_OD                        BIT(6)
 226#define LP87565_GPIO2_OD                        BIT(5)
 227#define LP87565_GPIO1_OD                        BIT(4)
 228#define LP87565_GPIO3_DIR                       BIT(2)
 229#define LP87565_GPIO2_DIR                       BIT(1)
 230#define LP87565_GPIO1_DIR                       BIT(0)
 231
 232#define LP87565_GPIO3_IN                        BIT(2)
 233#define LP87565_GPIO2_IN                        BIT(1)
 234#define LP87565_GPIO1_IN                        BIT(0)
 235
 236#define LP87565_GPIO3_OUT                       BIT(2)
 237#define LP87565_GPIO2_OUT                       BIT(1)
 238#define LP87565_GPIO1_OUT                       BIT(0)
 239
 240/**
 241 * struct LP87565 - state holder for the LP87565 driver
 242 * @dev: struct device pointer for MFD device
 243 * @rev: revision of the LP87565
 244 * @dev_type: The device type for example lp87565-q1
 245 * @lock: lock guarding the data structure
 246 * @regmap: register map of the LP87565 PMIC
 247 *
 248 * Device data may be used to access the LP87565 chip
 249 */
 250struct lp87565 {
 251        struct device *dev;
 252        u8 rev;
 253        u8 dev_type;
 254        struct regmap *regmap;
 255        struct gpio_desc *reset_gpio;
 256};
 257#endif /* __LINUX_MFD_LP87565_H */
 258