1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * Marvell 88PM860x Interface
4 *
5 * Copyright (C) 2009 Marvell International Ltd.
6 * Haojian Zhuang <haojian.zhuang@marvell.com>
7 */
8
9#ifndef __LINUX_MFD_88PM860X_H
10#define __LINUX_MFD_88PM860X_H
11
12#include <linux/interrupt.h>
13
14#define MFD_NAME_SIZE (40)
15
16enum {
17 CHIP_INVALID = 0,
18 CHIP_PM8606,
19 CHIP_PM8607,
20 CHIP_MAX,
21};
22
23enum {
24 PM8606_ID_INVALID,
25 PM8606_ID_BACKLIGHT,
26 PM8606_ID_LED,
27 PM8606_ID_VIBRATOR,
28 PM8606_ID_TOUCH,
29 PM8606_ID_SOUND,
30 PM8606_ID_CHARGER,
31 PM8606_ID_MAX,
32};
33
34
35/* 8606 Registers */
36#define PM8606_DCM_BOOST (0x00)
37#define PM8606_PWM (0x01)
38
39#define PM8607_MISC2 (0x42)
40
41/* Power Up Log Register */
42#define PM8607_POWER_UP_LOG (0x3F)
43
44/* Charger Control Registers */
45#define PM8607_CCNT (0x47)
46#define PM8607_CHG_CTRL1 (0x48)
47#define PM8607_CHG_CTRL2 (0x49)
48#define PM8607_CHG_CTRL3 (0x4A)
49#define PM8607_CHG_CTRL4 (0x4B)
50#define PM8607_CHG_CTRL5 (0x4C)
51#define PM8607_CHG_CTRL6 (0x4D)
52#define PM8607_CHG_CTRL7 (0x4E)
53
54/* Backlight Registers */
55#define PM8606_WLED1A (0x02)
56#define PM8606_WLED1B (0x03)
57#define PM8606_WLED2A (0x04)
58#define PM8606_WLED2B (0x05)
59#define PM8606_WLED3A (0x06)
60#define PM8606_WLED3B (0x07)
61
62/* LED Registers */
63#define PM8606_RGB2A (0x08)
64#define PM8606_RGB2B (0x09)
65#define PM8606_RGB2C (0x0A)
66#define PM8606_RGB2D (0x0B)
67#define PM8606_RGB1A (0x0C)
68#define PM8606_RGB1B (0x0D)
69#define PM8606_RGB1C (0x0E)
70#define PM8606_RGB1D (0x0F)
71
72#define PM8606_PREREGULATORA (0x10)
73#define PM8606_PREREGULATORB (0x11)
74#define PM8606_VIBRATORA (0x12)
75#define PM8606_VIBRATORB (0x13)
76#define PM8606_VCHG (0x14)
77#define PM8606_VSYS (0x15)
78#define PM8606_MISC (0x16)
79#define PM8606_CHIP_ID (0x17)
80#define PM8606_STATUS (0x18)
81#define PM8606_FLAGS (0x19)
82#define PM8606_PROTECTA (0x1A)
83#define PM8606_PROTECTB (0x1B)
84#define PM8606_PROTECTC (0x1C)
85
86/* Bit definitions of PM8606 registers */
87#define PM8606_DCM_500MA (0x0) /* current limit */
88#define PM8606_DCM_750MA (0x1)
89#define PM8606_DCM_1000MA (0x2)
90#define PM8606_DCM_1250MA (0x3)
91#define PM8606_DCM_250MV (0x0 << 2)
92#define PM8606_DCM_300MV (0x1 << 2)
93#define PM8606_DCM_350MV (0x2 << 2)
94#define PM8606_DCM_400MV (0x3 << 2)
95
96#define PM8606_PWM_31200HZ (0x0)
97#define PM8606_PWM_15600HZ (0x1)
98#define PM8606_PWM_7800HZ (0x2)
99#define PM8606_PWM_3900HZ (0x3)
100#define PM8606_PWM_1950HZ (0x4)
101#define PM8606_PWM_976HZ (0x5)
102#define PM8606_PWM_488HZ (0x6)
103#define PM8606_PWM_244HZ (0x7)
104#define PM8606_PWM_FREQ_MASK (0x7)
105
106#define PM8606_WLED_ON (1 << 0)
107#define PM8606_WLED_CURRENT(x) ((x & 0x1F) << 1)
108
109#define PM8606_LED_CURRENT(x) (((x >> 2) & 0x07) << 5)
110
111#define PM8606_VSYS_EN (1 << 1)
112
113#define PM8606_MISC_OSC_EN (1 << 4)
114
115enum {
116 PM8607_ID_BUCK1 = 0,
117 PM8607_ID_BUCK2,
118 PM8607_ID_BUCK3,
119
120 PM8607_ID_LDO1,
121 PM8607_ID_LDO2,
122 PM8607_ID_LDO3,
123 PM8607_ID_LDO4,
124 PM8607_ID_LDO5,
125 PM8607_ID_LDO6,
126 PM8607_ID_LDO7,
127 PM8607_ID_LDO8,
128 PM8607_ID_LDO9,
129 PM8607_ID_LDO10,
130 PM8607_ID_LDO11,
131 PM8607_ID_LDO12,
132 PM8607_ID_LDO13,
133 PM8607_ID_LDO14,
134 PM8607_ID_LDO15,
135 PM8606_ID_PREG,
136
137 PM8607_ID_RG_MAX,
138};
139
140/* 8607 chip ID is 0x40 or 0x50 */
141#define PM8607_VERSION_MASK (0xF0) /* 8607 chip ID mask */
142
143/* Interrupt Registers */
144#define PM8607_STATUS_1 (0x01)
145#define PM8607_STATUS_2 (0x02)
146#define PM8607_INT_STATUS1 (0x03)
147#define PM8607_INT_STATUS2 (0x04)
148#define PM8607_INT_STATUS3 (0x05)
149#define PM8607_INT_MASK_1 (0x06)
150#define PM8607_INT_MASK_2 (0x07)
151#define PM8607_INT_MASK_3 (0x08)
152
153/* Regulator Control Registers */
154#define PM8607_LDO1 (0x10)
155#define PM8607_LDO2 (0x11)
156#define PM8607_LDO3 (0x12)
157#define PM8607_LDO4 (0x13)
158#define PM8607_LDO5 (0x14)
159#define PM8607_LDO6 (0x15)
160#define PM8607_LDO7 (0x16)
161#define PM8607_LDO8 (0x17)
162#define PM8607_LDO9 (0x18)
163#define PM8607_LDO10 (0x19)
164#define PM8607_LDO12 (0x1A)
165#define PM8607_LDO14 (0x1B)
166#define PM8607_SLEEP_MODE1 (0x1C)
167#define PM8607_SLEEP_MODE2 (0x1D)
168#define PM8607_SLEEP_MODE3 (0x1E)
169#define PM8607_SLEEP_MODE4 (0x1F)
170#define PM8607_GO (0x20)
171#define PM8607_SLEEP_BUCK1 (0x21)
172#define PM8607_SLEEP_BUCK2 (0x22)
173#define PM8607_SLEEP_BUCK3 (0x23)
174#define PM8607_BUCK1 (0x24)
175#define PM8607_BUCK2 (0x25)
176#define PM8607_BUCK3 (0x26)
177#define PM8607_BUCK_CONTROLS (0x27)
178#define PM8607_SUPPLIES_EN11 (0x2B)
179#define PM8607_SUPPLIES_EN12 (0x2C)
180#define PM8607_GROUP1 (0x2D)
181#define PM8607_GROUP2 (0x2E)
182#define PM8607_GROUP3 (0x2F)
183#define PM8607_GROUP4 (0x30)
184#define PM8607_GROUP5 (0x31)
185#define PM8607_GROUP6 (0x32)
186#define PM8607_SUPPLIES_EN21 (0x33)
187#define PM8607_SUPPLIES_EN22 (0x34)
188
189/* Vibrator Control Registers */
190#define PM8607_VIBRATOR_SET (0x28)
191#define PM8607_VIBRATOR_PWM (0x29)
192
193/* GPADC Registers */
194#define PM8607_GP_BIAS1 (0x4F)
195#define PM8607_MEAS_EN1 (0x50)
196#define PM8607_MEAS_EN2 (0x51)
197#define PM8607_MEAS_EN3 (0x52)
198#define PM8607_MEAS_OFF_TIME1 (0x53)
199#define PM8607_MEAS_OFF_TIME2 (0x54)
200#define PM8607_TSI_PREBIAS (0x55) /* prebias time */
201#define PM8607_PD_PREBIAS (0x56) /* prebias time */
202#define PM8607_GPADC_MISC1 (0x57)
203
204/* bit definitions of MEAS_EN1*/
205#define PM8607_MEAS_EN1_VBAT (1 << 0)
206#define PM8607_MEAS_EN1_VCHG (1 << 1)
207#define PM8607_MEAS_EN1_VSYS (1 << 2)
208#define PM8607_MEAS_EN1_TINT (1 << 3)
209#define PM8607_MEAS_EN1_RFTMP (1 << 4)
210#define PM8607_MEAS_EN1_TBAT (1 << 5)
211#define PM8607_MEAS_EN1_GPADC2 (1 << 6)
212#define PM8607_MEAS_EN1_GPADC3 (1 << 7)
213
214/* Battery Monitor Registers */
215#define PM8607_GP_BIAS2 (0x5A)
216#define PM8607_VBAT_LOWTH (0x5B)
217#define PM8607_VCHG_LOWTH (0x5C)
218#define PM8607_VSYS_LOWTH (0x5D)
219#define PM8607_TINT_LOWTH (0x5E)
220#define PM8607_GPADC0_LOWTH (0x5F)
221#define PM8607_GPADC1_LOWTH (0x60)
222#define PM8607_GPADC2_LOWTH (0x61)
223#define PM8607_GPADC3_LOWTH (0x62)
224#define PM8607_VBAT_HIGHTH (0x63)
225#define PM8607_VCHG_HIGHTH (0x64)
226#define PM8607_VSYS_HIGHTH (0x65)
227#define PM8607_TINT_HIGHTH (0x66)
228#define PM8607_GPADC0_HIGHTH (0x67)
229#define PM8607_GPADC1_HIGHTH (0x68)
230#define PM8607_GPADC2_HIGHTH (0x69)
231#define PM8607_GPADC3_HIGHTH (0x6A)
232#define PM8607_IBAT_MEAS1 (0x6B)
233#define PM8607_IBAT_MEAS2 (0x6C)
234#define PM8607_VBAT_MEAS1 (0x6D)
235#define PM8607_VBAT_MEAS2 (0x6E)
236#define PM8607_VCHG_MEAS1 (0x6F)
237#define PM8607_VCHG_MEAS2 (0x70)
238#define PM8607_VSYS_MEAS1 (0x71)
239#define PM8607_VSYS_MEAS2 (0x72)
240#define PM8607_TINT_MEAS1 (0x73)
241#define PM8607_TINT_MEAS2 (0x74)
242#define PM8607_GPADC0_MEAS1 (0x75)
243#define PM8607_GPADC0_MEAS2 (0x76)
244#define PM8607_GPADC1_MEAS1 (0x77)
245#define PM8607_GPADC1_MEAS2 (0x78)
246#define PM8607_GPADC2_MEAS1 (0x79)
247#define PM8607_GPADC2_MEAS2 (0x7A)
248#define PM8607_GPADC3_MEAS1 (0x7B)
249#define PM8607_GPADC3_MEAS2 (0x7C)
250#define PM8607_CCNT_MEAS1 (0x95)
251#define PM8607_CCNT_MEAS2 (0x96)
252#define PM8607_VBAT_AVG (0x97)
253#define PM8607_VCHG_AVG (0x98)
254#define PM8607_VSYS_AVG (0x99)
255#define PM8607_VBAT_MIN (0x9A)
256#define PM8607_VCHG_MIN (0x9B)
257#define PM8607_VSYS_MIN (0x9C)
258#define PM8607_VBAT_MAX (0x9D)
259#define PM8607_VCHG_MAX (0x9E)
260#define PM8607_VSYS_MAX (0x9F)
261
262#define PM8607_GPADC_MISC2 (0x59)
263#define PM8607_GPADC0_GP_BIAS_A0 (1 << 0)
264#define PM8607_GPADC1_GP_BIAS_A1 (1 << 1)
265#define PM8607_GPADC2_GP_BIAS_A2 (1 << 2)
266#define PM8607_GPADC3_GP_BIAS_A3 (1 << 3)
267#define PM8607_GPADC2_GP_BIAS_OUT2 (1 << 6)
268
269/* RTC Control Registers */
270#define PM8607_RTC1 (0xA0)
271#define PM8607_RTC_COUNTER1 (0xA1)
272#define PM8607_RTC_COUNTER2 (0xA2)
273#define PM8607_RTC_COUNTER3 (0xA3)
274#define PM8607_RTC_COUNTER4 (0xA4)
275#define PM8607_RTC_EXPIRE1 (0xA5)
276#define PM8607_RTC_EXPIRE2 (0xA6)
277#define PM8607_RTC_EXPIRE3 (0xA7)
278#define PM8607_RTC_EXPIRE4 (0xA8)
279#define PM8607_RTC_TRIM1 (0xA9)
280#define PM8607_RTC_TRIM2 (0xAA)
281#define PM8607_RTC_TRIM3 (0xAB)
282#define PM8607_RTC_TRIM4 (0xAC)
283#define PM8607_RTC_MISC1 (0xAD)
284#define PM8607_RTC_MISC2 (0xAE)
285#define PM8607_RTC_MISC3 (0xAF)
286
287/* Misc Registers */
288#define PM8607_CHIP_ID (0x00)
289#define PM8607_B0_MISC1 (0x0C)
290#define PM8607_LDO1 (0x10)
291#define PM8607_DVC3 (0x26)
292#define PM8607_A1_MISC1 (0x40)
293
294/* bit definitions of Status Query Interface */
295#define PM8607_STATUS_CC (1 << 3)
296#define PM8607_STATUS_PEN (1 << 4)
297#define PM8607_STATUS_HEADSET (1 << 5)
298#define PM8607_STATUS_HOOK (1 << 6)
299#define PM8607_STATUS_MICIN (1 << 7)
300#define PM8607_STATUS_ONKEY (1 << 8)
301#define PM8607_STATUS_EXTON (1 << 9)
302#define PM8607_STATUS_CHG (1 << 10)
303#define PM8607_STATUS_BAT (1 << 11)
304#define PM8607_STATUS_VBUS (1 << 12)
305#define PM8607_STATUS_OV (1 << 13)
306
307/* bit definitions of BUCK3 */
308#define PM8607_BUCK3_DOUBLE (1 << 6)
309
310/* bit definitions of Misc1 */
311#define PM8607_A1_MISC1_PI2C (1 << 0)
312#define PM8607_B0_MISC1_INV_INT (1 << 0)
313#define PM8607_B0_MISC1_INT_CLEAR (1 << 1)
314#define PM8607_B0_MISC1_INT_MASK (1 << 2)
315#define PM8607_B0_MISC1_PI2C (1 << 3)
316#define PM8607_B0_MISC1_RESET (1 << 6)
317
318/* bits definitions of GPADC */
319#define PM8607_GPADC_EN (1 << 0)
320#define PM8607_GPADC_PREBIAS_MASK (3 << 1)
321#define PM8607_GPADC_SLOT_CYCLE_MASK (3 << 3) /* slow mode */
322#define PM8607_GPADC_OFF_SCALE_MASK (3 << 5) /* GP sleep mode */
323#define PM8607_GPADC_SW_CAL_MASK (1 << 7)
324
325#define PM8607_PD_PREBIAS_MASK (0x1F << 0)
326#define PM8607_PD_PRECHG_MASK (7 << 5)
327
328#define PM8606_REF_GP_OSC_OFF 0
329#define PM8606_REF_GP_OSC_ON 1
330#define PM8606_REF_GP_OSC_UNKNOWN 2
331
332/* Clients of reference group and 8MHz oscillator in 88PM8606 */
333enum pm8606_ref_gp_and_osc_clients {
334 REF_GP_NO_CLIENTS = 0,
335 WLED1_DUTY = (1<<0), /*PF 0x02.7:0*/
336 WLED2_DUTY = (1<<1), /*PF 0x04.7:0*/
337 WLED3_DUTY = (1<<2), /*PF 0x06.7:0*/
338 RGB1_ENABLE = (1<<3), /*PF 0x07.1*/
339 RGB2_ENABLE = (1<<4), /*PF 0x07.2*/
340 LDO_VBR_EN = (1<<5), /*PF 0x12.0*/
341 REF_GP_MAX_CLIENT = 0xFFFF
342};
343
344/* Interrupt Number in 88PM8607 */
345enum {
346 PM8607_IRQ_ONKEY,
347 PM8607_IRQ_EXTON,
348 PM8607_IRQ_CHG,
349 PM8607_IRQ_BAT,
350 PM8607_IRQ_RTC,
351 PM8607_IRQ_CC,
352 PM8607_IRQ_VBAT,
353 PM8607_IRQ_VCHG,
354 PM8607_IRQ_VSYS,
355 PM8607_IRQ_TINT,
356 PM8607_IRQ_GPADC0,
357 PM8607_IRQ_GPADC1,
358 PM8607_IRQ_GPADC2,
359 PM8607_IRQ_GPADC3,
360 PM8607_IRQ_AUDIO_SHORT,
361 PM8607_IRQ_PEN,
362 PM8607_IRQ_HEADSET,
363 PM8607_IRQ_HOOK,
364 PM8607_IRQ_MICIN,
365 PM8607_IRQ_CHG_FAIL,
366 PM8607_IRQ_CHG_DONE,
367 PM8607_IRQ_CHG_FAULT,
368};
369
370enum {
371 PM8607_CHIP_A0 = 0x40,
372 PM8607_CHIP_A1 = 0x41,
373 PM8607_CHIP_B0 = 0x48,
374};
375
376struct pm860x_chip {
377 struct device *dev;
378 struct mutex irq_lock;
379 struct mutex osc_lock;
380 struct i2c_client *client;
381 struct i2c_client *companion; /* companion chip client */
382 struct regmap *regmap;
383 struct regmap *regmap_companion;
384
385 int buck3_double; /* DVC ramp slope double */
386 int companion_addr;
387 unsigned short osc_vote;
388 int id;
389 int irq_mode;
390 int irq_base;
391 int core_irq;
392 unsigned char chip_version;
393 unsigned char osc_status;
394
395 unsigned int wakeup_flag;
396};
397
398enum {
399 GI2C_PORT = 0,
400 PI2C_PORT,
401};
402
403struct pm860x_backlight_pdata {
404 int pwm;
405 int iset;
406};
407
408struct pm860x_led_pdata {
409 int iset;
410};
411
412struct pm860x_rtc_pdata {
413 int (*sync)(unsigned int ticks);
414 int vrtc;
415};
416
417struct pm860x_touch_pdata {
418 int gpadc_prebias;
419 int slot_cycle;
420 int off_scale;
421 int sw_cal;
422 int tsi_prebias; /* time, slot */
423 int pen_prebias; /* time, slot */
424 int pen_prechg; /* time, slot */
425 int res_x; /* resistor of Xplate */
426 unsigned long flags;
427};
428
429struct pm860x_power_pdata {
430 int max_capacity;
431 int resistor;
432};
433
434struct pm860x_platform_data {
435 struct pm860x_backlight_pdata *backlight;
436 struct pm860x_led_pdata *led;
437 struct pm860x_rtc_pdata *rtc;
438 struct pm860x_touch_pdata *touch;
439 struct pm860x_power_pdata *power;
440 struct regulator_init_data *buck1;
441 struct regulator_init_data *buck2;
442 struct regulator_init_data *buck3;
443 struct regulator_init_data *ldo1;
444 struct regulator_init_data *ldo2;
445 struct regulator_init_data *ldo3;
446 struct regulator_init_data *ldo4;
447 struct regulator_init_data *ldo5;
448 struct regulator_init_data *ldo6;
449 struct regulator_init_data *ldo7;
450 struct regulator_init_data *ldo8;
451 struct regulator_init_data *ldo9;
452 struct regulator_init_data *ldo10;
453 struct regulator_init_data *ldo12;
454 struct regulator_init_data *ldo_vibrator;
455 struct regulator_init_data *ldo14;
456 struct charger_desc *chg_desc;
457
458 int companion_addr; /* I2C address of companion chip */
459 int i2c_port; /* Controlled by GI2C or PI2C */
460 int irq_mode; /* Clear interrupt by read/write(0/1) */
461 int irq_base; /* IRQ base number of 88pm860x */
462 int num_leds;
463 int num_backlights;
464};
465
466extern int pm8606_osc_enable(struct pm860x_chip *, unsigned short);
467extern int pm8606_osc_disable(struct pm860x_chip *, unsigned short);
468
469extern int pm860x_reg_read(struct i2c_client *, int);
470extern int pm860x_reg_write(struct i2c_client *, int, unsigned char);
471extern int pm860x_bulk_read(struct i2c_client *, int, int, unsigned char *);
472extern int pm860x_bulk_write(struct i2c_client *, int, int, unsigned char *);
473extern int pm860x_set_bits(struct i2c_client *, int, unsigned char,
474 unsigned char);
475extern int pm860x_page_reg_write(struct i2c_client *, int, unsigned char);
476extern int pm860x_page_bulk_read(struct i2c_client *, int, int,
477 unsigned char *);
478#endif /* __LINUX_MFD_88PM860X_H */
479

source code of linux/include/linux/mfd/88pm860x.h