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