xref: /OK3568_Linux_fs/kernel/include/linux/mfd/rt5033-private.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-only */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * MFD core driver for Richtek RT5033
4*4882a593Smuzhiyun  *
5*4882a593Smuzhiyun  * Copyright (C) 2014 Samsung Electronics, Co., Ltd.
6*4882a593Smuzhiyun  * Author: Beomho Seo <beomho.seo@samsung.com>
7*4882a593Smuzhiyun  */
8*4882a593Smuzhiyun 
9*4882a593Smuzhiyun #ifndef __RT5033_PRIVATE_H__
10*4882a593Smuzhiyun #define __RT5033_PRIVATE_H__
11*4882a593Smuzhiyun 
12*4882a593Smuzhiyun enum rt5033_reg {
13*4882a593Smuzhiyun 	RT5033_REG_CHG_STAT		= 0x00,
14*4882a593Smuzhiyun 	RT5033_REG_CHG_CTRL1		= 0x01,
15*4882a593Smuzhiyun 	RT5033_REG_CHG_CTRL2		= 0x02,
16*4882a593Smuzhiyun 	RT5033_REG_DEVICE_ID		= 0x03,
17*4882a593Smuzhiyun 	RT5033_REG_CHG_CTRL3		= 0x04,
18*4882a593Smuzhiyun 	RT5033_REG_CHG_CTRL4		= 0x05,
19*4882a593Smuzhiyun 	RT5033_REG_CHG_CTRL5		= 0x06,
20*4882a593Smuzhiyun 	RT5033_REG_RT_CTRL0		= 0x07,
21*4882a593Smuzhiyun 	RT5033_REG_CHG_RESET		= 0x08,
22*4882a593Smuzhiyun 	/* Reserved 0x09~0x18 */
23*4882a593Smuzhiyun 	RT5033_REG_RT_CTRL1		= 0x19,
24*4882a593Smuzhiyun 	/* Reserved 0x1A~0x20 */
25*4882a593Smuzhiyun 	RT5033_REG_FLED_FUNCTION1	= 0x21,
26*4882a593Smuzhiyun 	RT5033_REG_FLED_FUNCTION2	= 0x22,
27*4882a593Smuzhiyun 	RT5033_REG_FLED_STROBE_CTRL1	= 0x23,
28*4882a593Smuzhiyun 	RT5033_REG_FLED_STROBE_CTRL2	= 0x24,
29*4882a593Smuzhiyun 	RT5033_REG_FLED_CTRL1		= 0x25,
30*4882a593Smuzhiyun 	RT5033_REG_FLED_CTRL2		= 0x26,
31*4882a593Smuzhiyun 	RT5033_REG_FLED_CTRL3		= 0x27,
32*4882a593Smuzhiyun 	RT5033_REG_FLED_CTRL4		= 0x28,
33*4882a593Smuzhiyun 	RT5033_REG_FLED_CTRL5		= 0x29,
34*4882a593Smuzhiyun 	/* Reserved 0x2A~0x40 */
35*4882a593Smuzhiyun 	RT5033_REG_CTRL			= 0x41,
36*4882a593Smuzhiyun 	RT5033_REG_BUCK_CTRL		= 0x42,
37*4882a593Smuzhiyun 	RT5033_REG_LDO_CTRL		= 0x43,
38*4882a593Smuzhiyun 	/* Reserved 0x44~0x46 */
39*4882a593Smuzhiyun 	RT5033_REG_MANUAL_RESET_CTRL	= 0x47,
40*4882a593Smuzhiyun 	/* Reserved 0x48~0x5F */
41*4882a593Smuzhiyun 	RT5033_REG_CHG_IRQ1		= 0x60,
42*4882a593Smuzhiyun 	RT5033_REG_CHG_IRQ2		= 0x61,
43*4882a593Smuzhiyun 	RT5033_REG_CHG_IRQ3		= 0x62,
44*4882a593Smuzhiyun 	RT5033_REG_CHG_IRQ1_CTRL	= 0x63,
45*4882a593Smuzhiyun 	RT5033_REG_CHG_IRQ2_CTRL	= 0x64,
46*4882a593Smuzhiyun 	RT5033_REG_CHG_IRQ3_CTRL	= 0x65,
47*4882a593Smuzhiyun 	RT5033_REG_LED_IRQ_STAT		= 0x66,
48*4882a593Smuzhiyun 	RT5033_REG_LED_IRQ_CTRL		= 0x67,
49*4882a593Smuzhiyun 	RT5033_REG_PMIC_IRQ_STAT	= 0x68,
50*4882a593Smuzhiyun 	RT5033_REG_PMIC_IRQ_CTRL	= 0x69,
51*4882a593Smuzhiyun 	RT5033_REG_SHDN_CTRL		= 0x6A,
52*4882a593Smuzhiyun 	RT5033_REG_OFF_EVENT		= 0x6B,
53*4882a593Smuzhiyun 
54*4882a593Smuzhiyun 	RT5033_REG_END,
55*4882a593Smuzhiyun };
56*4882a593Smuzhiyun 
57*4882a593Smuzhiyun /* RT5033 Charger state register */
58*4882a593Smuzhiyun #define RT5033_CHG_STAT_MASK		0x20
59*4882a593Smuzhiyun #define RT5033_CHG_STAT_DISCHARGING	0x00
60*4882a593Smuzhiyun #define RT5033_CHG_STAT_FULL		0x10
61*4882a593Smuzhiyun #define RT5033_CHG_STAT_CHARGING	0x20
62*4882a593Smuzhiyun #define RT5033_CHG_STAT_NOT_CHARGING	0x30
63*4882a593Smuzhiyun #define RT5033_CHG_STAT_TYPE_MASK	0x60
64*4882a593Smuzhiyun #define RT5033_CHG_STAT_TYPE_PRE	0x20
65*4882a593Smuzhiyun #define RT5033_CHG_STAT_TYPE_FAST	0x60
66*4882a593Smuzhiyun 
67*4882a593Smuzhiyun /* RT5033 CHGCTRL1 register */
68*4882a593Smuzhiyun #define RT5033_CHGCTRL1_IAICR_MASK	0xe0
69*4882a593Smuzhiyun #define RT5033_CHGCTRL1_MODE_MASK	0x01
70*4882a593Smuzhiyun 
71*4882a593Smuzhiyun /* RT5033 CHGCTRL2 register */
72*4882a593Smuzhiyun #define RT5033_CHGCTRL2_CV_MASK		0xfc
73*4882a593Smuzhiyun 
74*4882a593Smuzhiyun /* RT5033 CHGCTRL3 register */
75*4882a593Smuzhiyun #define RT5033_CHGCTRL3_CFO_EN_MASK	0x40
76*4882a593Smuzhiyun #define RT5033_CHGCTRL3_TIMER_MASK	0x38
77*4882a593Smuzhiyun #define RT5033_CHGCTRL3_TIMER_EN_MASK	0x01
78*4882a593Smuzhiyun 
79*4882a593Smuzhiyun /* RT5033 CHGCTRL4 register */
80*4882a593Smuzhiyun #define RT5033_CHGCTRL4_EOC_MASK	0x07
81*4882a593Smuzhiyun #define RT5033_CHGCTRL4_IPREC_MASK	0x18
82*4882a593Smuzhiyun 
83*4882a593Smuzhiyun /* RT5033 CHGCTRL5 register */
84*4882a593Smuzhiyun #define RT5033_CHGCTRL5_VPREC_MASK	0x0f
85*4882a593Smuzhiyun #define RT5033_CHGCTRL5_ICHG_MASK	0xf0
86*4882a593Smuzhiyun #define RT5033_CHGCTRL5_ICHG_SHIFT	0x04
87*4882a593Smuzhiyun #define RT5033_CHG_MAX_CURRENT		0x0d
88*4882a593Smuzhiyun 
89*4882a593Smuzhiyun /* RT5033 RT CTRL1 register */
90*4882a593Smuzhiyun #define RT5033_RT_CTRL1_UUG_MASK	0x02
91*4882a593Smuzhiyun #define RT5033_RT_HZ_MASK		0x01
92*4882a593Smuzhiyun 
93*4882a593Smuzhiyun /* RT5033 control register */
94*4882a593Smuzhiyun #define RT5033_CTRL_FCCM_BUCK_MASK		0x00
95*4882a593Smuzhiyun #define RT5033_CTRL_BUCKOMS_MASK		0x01
96*4882a593Smuzhiyun #define RT5033_CTRL_LDOOMS_MASK			0x02
97*4882a593Smuzhiyun #define RT5033_CTRL_SLDOOMS_MASK		0x03
98*4882a593Smuzhiyun #define RT5033_CTRL_EN_BUCK_MASK		0x04
99*4882a593Smuzhiyun #define RT5033_CTRL_EN_LDO_MASK			0x05
100*4882a593Smuzhiyun #define RT5033_CTRL_EN_SAFE_LDO_MASK		0x06
101*4882a593Smuzhiyun #define RT5033_CTRL_LDO_SLEEP_MASK		0x07
102*4882a593Smuzhiyun 
103*4882a593Smuzhiyun /* RT5033 BUCK control register */
104*4882a593Smuzhiyun #define RT5033_BUCK_CTRL_MASK			0x1f
105*4882a593Smuzhiyun 
106*4882a593Smuzhiyun /* RT5033 LDO control register */
107*4882a593Smuzhiyun #define RT5033_LDO_CTRL_MASK			0x1f
108*4882a593Smuzhiyun 
109*4882a593Smuzhiyun /* RT5033 charger property - model, manufacturer */
110*4882a593Smuzhiyun 
111*4882a593Smuzhiyun #define RT5033_CHARGER_MODEL	"RT5033WSC Charger"
112*4882a593Smuzhiyun #define RT5033_MANUFACTURER	"Richtek Technology Corporation"
113*4882a593Smuzhiyun 
114*4882a593Smuzhiyun /*
115*4882a593Smuzhiyun  * RT5033 charger fast-charge current lmits (as in CHGCTRL1 register),
116*4882a593Smuzhiyun  * AICR mode limits the input current for example,
117*4882a593Smuzhiyun  * the AIRC 100 mode limits the input current to 100 mA.
118*4882a593Smuzhiyun  */
119*4882a593Smuzhiyun #define RT5033_AICR_100_MODE			0x20
120*4882a593Smuzhiyun #define RT5033_AICR_500_MODE			0x40
121*4882a593Smuzhiyun #define RT5033_AICR_700_MODE			0x60
122*4882a593Smuzhiyun #define RT5033_AICR_900_MODE			0x80
123*4882a593Smuzhiyun #define RT5033_AICR_1500_MODE			0xc0
124*4882a593Smuzhiyun #define RT5033_AICR_2000_MODE			0xe0
125*4882a593Smuzhiyun #define RT5033_AICR_MODE_MASK			0xe0
126*4882a593Smuzhiyun 
127*4882a593Smuzhiyun /* RT5033 use internal timer need to set time */
128*4882a593Smuzhiyun #define RT5033_FAST_CHARGE_TIMER4		0x00
129*4882a593Smuzhiyun #define RT5033_FAST_CHARGE_TIMER6		0x01
130*4882a593Smuzhiyun #define RT5033_FAST_CHARGE_TIMER8		0x02
131*4882a593Smuzhiyun #define RT5033_FAST_CHARGE_TIMER9		0x03
132*4882a593Smuzhiyun #define RT5033_FAST_CHARGE_TIMER12		0x04
133*4882a593Smuzhiyun #define RT5033_FAST_CHARGE_TIMER14		0x05
134*4882a593Smuzhiyun #define RT5033_FAST_CHARGE_TIMER16		0x06
135*4882a593Smuzhiyun 
136*4882a593Smuzhiyun #define RT5033_INT_TIMER_ENABLE			0x01
137*4882a593Smuzhiyun 
138*4882a593Smuzhiyun /* RT5033 charger termination enable mask */
139*4882a593Smuzhiyun #define RT5033_TE_ENABLE_MASK			0x08
140*4882a593Smuzhiyun 
141*4882a593Smuzhiyun /*
142*4882a593Smuzhiyun  * RT5033 charger opa mode. RT50300 have two opa mode charger mode
143*4882a593Smuzhiyun  * and boost mode for OTG
144*4882a593Smuzhiyun  */
145*4882a593Smuzhiyun 
146*4882a593Smuzhiyun #define RT5033_CHARGER_MODE			0x00
147*4882a593Smuzhiyun #define RT5033_BOOST_MODE			0x01
148*4882a593Smuzhiyun 
149*4882a593Smuzhiyun /* RT5033 charger termination enable */
150*4882a593Smuzhiyun #define RT5033_TE_ENABLE			0x08
151*4882a593Smuzhiyun 
152*4882a593Smuzhiyun /* RT5033 charger CFO enable */
153*4882a593Smuzhiyun #define RT5033_CFO_ENABLE			0x40
154*4882a593Smuzhiyun 
155*4882a593Smuzhiyun /* RT5033 charger constant charge voltage (as in CHGCTRL2 register), uV */
156*4882a593Smuzhiyun #define RT5033_CHARGER_CONST_VOLTAGE_LIMIT_MIN	3650000U
157*4882a593Smuzhiyun #define RT5033_CHARGER_CONST_VOLTAGE_STEP_NUM   25000U
158*4882a593Smuzhiyun #define RT5033_CHARGER_CONST_VOLTAGE_LIMIT_MAX	4400000U
159*4882a593Smuzhiyun 
160*4882a593Smuzhiyun /* RT5033 charger pre-charge current limits (as in CHGCTRL4 register), uA */
161*4882a593Smuzhiyun #define RT5033_CHARGER_PRE_CURRENT_LIMIT_MIN	350000U
162*4882a593Smuzhiyun #define RT5033_CHARGER_PRE_CURRENT_STEP_NUM	100000U
163*4882a593Smuzhiyun #define RT5033_CHARGER_PRE_CURRENT_LIMIT_MAX	650000U
164*4882a593Smuzhiyun 
165*4882a593Smuzhiyun /* RT5033 charger fast-charge current (as in CHGCTRL5 register), uA */
166*4882a593Smuzhiyun #define RT5033_CHARGER_FAST_CURRENT_MIN		700000U
167*4882a593Smuzhiyun #define RT5033_CHARGER_FAST_CURRENT_STEP_NUM	100000U
168*4882a593Smuzhiyun #define RT5033_CHARGER_FAST_CURRENT_MAX		2000000U
169*4882a593Smuzhiyun 
170*4882a593Smuzhiyun /*
171*4882a593Smuzhiyun  * RT5033 charger const-charge end of charger current (
172*4882a593Smuzhiyun  * as in CHGCTRL4 register), uA
173*4882a593Smuzhiyun  */
174*4882a593Smuzhiyun #define RT5033_CHARGER_EOC_MIN			150000U
175*4882a593Smuzhiyun #define RT5033_CHARGER_EOC_REF			300000U
176*4882a593Smuzhiyun #define RT5033_CHARGER_EOC_STEP_NUM1		50000U
177*4882a593Smuzhiyun #define RT5033_CHARGER_EOC_STEP_NUM2		100000U
178*4882a593Smuzhiyun #define RT5033_CHARGER_EOC_MAX			600000U
179*4882a593Smuzhiyun 
180*4882a593Smuzhiyun /*
181*4882a593Smuzhiyun  * RT5033 charger pre-charge threshold volt limits
182*4882a593Smuzhiyun  * (as in CHGCTRL5 register), uV
183*4882a593Smuzhiyun  */
184*4882a593Smuzhiyun 
185*4882a593Smuzhiyun #define RT5033_CHARGER_PRE_THRESHOLD_LIMIT_MIN	2300000U
186*4882a593Smuzhiyun #define RT5033_CHARGER_PRE_THRESHOLD_STEP_NUM	100000U
187*4882a593Smuzhiyun #define RT5033_CHARGER_PRE_THRESHOLD_LIMIT_MAX	3800000U
188*4882a593Smuzhiyun 
189*4882a593Smuzhiyun /*
190*4882a593Smuzhiyun  * RT5033 charger enable UUG, If UUG enable MOS auto control by H/W charger
191*4882a593Smuzhiyun  * circuit.
192*4882a593Smuzhiyun  */
193*4882a593Smuzhiyun #define RT5033_CHARGER_UUG_ENABLE		0x02
194*4882a593Smuzhiyun 
195*4882a593Smuzhiyun /* RT5033 charger High impedance mode */
196*4882a593Smuzhiyun #define RT5033_CHARGER_HZ_DISABLE		0x00
197*4882a593Smuzhiyun #define RT5033_CHARGER_HZ_ENABLE		0x01
198*4882a593Smuzhiyun 
199*4882a593Smuzhiyun /* RT5033 regulator BUCK output voltage uV */
200*4882a593Smuzhiyun #define RT5033_REGULATOR_BUCK_VOLTAGE_MIN		1000000U
201*4882a593Smuzhiyun #define RT5033_REGULATOR_BUCK_VOLTAGE_MAX		3000000U
202*4882a593Smuzhiyun #define RT5033_REGULATOR_BUCK_VOLTAGE_STEP		100000U
203*4882a593Smuzhiyun #define RT5033_REGULATOR_BUCK_VOLTAGE_STEP_NUM		21
204*4882a593Smuzhiyun 
205*4882a593Smuzhiyun /* RT5033 regulator LDO output voltage uV */
206*4882a593Smuzhiyun #define RT5033_REGULATOR_LDO_VOLTAGE_MIN		1200000U
207*4882a593Smuzhiyun #define RT5033_REGULATOR_LDO_VOLTAGE_MAX		3000000U
208*4882a593Smuzhiyun #define RT5033_REGULATOR_LDO_VOLTAGE_STEP		100000U
209*4882a593Smuzhiyun #define RT5033_REGULATOR_LDO_VOLTAGE_STEP_NUM		19
210*4882a593Smuzhiyun 
211*4882a593Smuzhiyun /* RT5033 regulator SAFE LDO output voltage uV */
212*4882a593Smuzhiyun #define RT5033_REGULATOR_SAFE_LDO_VOLTAGE		4900000U
213*4882a593Smuzhiyun 
214*4882a593Smuzhiyun enum rt5033_fuel_reg {
215*4882a593Smuzhiyun 	RT5033_FUEL_REG_OCV_H		= 0x00,
216*4882a593Smuzhiyun 	RT5033_FUEL_REG_OCV_L		= 0x01,
217*4882a593Smuzhiyun 	RT5033_FUEL_REG_VBAT_H		= 0x02,
218*4882a593Smuzhiyun 	RT5033_FUEL_REG_VBAT_L		= 0x03,
219*4882a593Smuzhiyun 	RT5033_FUEL_REG_SOC_H		= 0x04,
220*4882a593Smuzhiyun 	RT5033_FUEL_REG_SOC_L		= 0x05,
221*4882a593Smuzhiyun 	RT5033_FUEL_REG_CTRL_H		= 0x06,
222*4882a593Smuzhiyun 	RT5033_FUEL_REG_CTRL_L		= 0x07,
223*4882a593Smuzhiyun 	RT5033_FUEL_REG_CRATE		= 0x08,
224*4882a593Smuzhiyun 	RT5033_FUEL_REG_DEVICE_ID	= 0x09,
225*4882a593Smuzhiyun 	RT5033_FUEL_REG_AVG_VOLT_H	= 0x0A,
226*4882a593Smuzhiyun 	RT5033_FUEL_REG_AVG_VOLT_L	= 0x0B,
227*4882a593Smuzhiyun 	RT5033_FUEL_REG_CONFIG_H	= 0x0C,
228*4882a593Smuzhiyun 	RT5033_FUEL_REG_CONFIG_L	= 0x0D,
229*4882a593Smuzhiyun 	/* Reserved 0x0E~0x0F */
230*4882a593Smuzhiyun 	RT5033_FUEL_REG_IRQ_CTRL	= 0x10,
231*4882a593Smuzhiyun 	RT5033_FUEL_REG_IRQ_FLAG	= 0x11,
232*4882a593Smuzhiyun 	RT5033_FUEL_VMIN		= 0x12,
233*4882a593Smuzhiyun 	RT5033_FUEL_SMIN		= 0x13,
234*4882a593Smuzhiyun 	/* Reserved 0x14~0x1F */
235*4882a593Smuzhiyun 	RT5033_FUEL_VGCOMP1		= 0x20,
236*4882a593Smuzhiyun 	RT5033_FUEL_VGCOMP2		= 0x21,
237*4882a593Smuzhiyun 	RT5033_FUEL_VGCOMP3		= 0x22,
238*4882a593Smuzhiyun 	RT5033_FUEL_VGCOMP4		= 0x23,
239*4882a593Smuzhiyun 	/* Reserved 0x24~0xFD */
240*4882a593Smuzhiyun 	RT5033_FUEL_MFA_H		= 0xFE,
241*4882a593Smuzhiyun 	RT5033_FUEL_MFA_L		= 0xFF,
242*4882a593Smuzhiyun 
243*4882a593Smuzhiyun 	RT5033_FUEL_REG_END,
244*4882a593Smuzhiyun };
245*4882a593Smuzhiyun 
246*4882a593Smuzhiyun /* RT5033 fuel gauge battery present property */
247*4882a593Smuzhiyun #define RT5033_FUEL_BAT_PRESENT		0x02
248*4882a593Smuzhiyun 
249*4882a593Smuzhiyun /* RT5033 PMIC interrupts */
250*4882a593Smuzhiyun #define RT5033_PMIC_IRQ_BUCKOCP		2
251*4882a593Smuzhiyun #define RT5033_PMIC_IRQ_BUCKLV		3
252*4882a593Smuzhiyun #define RT5033_PMIC_IRQ_SAFELDOLV	4
253*4882a593Smuzhiyun #define RT5033_PMIC_IRQ_LDOLV		5
254*4882a593Smuzhiyun #define RT5033_PMIC_IRQ_OT		6
255*4882a593Smuzhiyun #define RT5033_PMIC_IRQ_VDDA_UV		7
256*4882a593Smuzhiyun 
257*4882a593Smuzhiyun #endif /* __RT5033_PRIVATE_H__ */
258