xref: /linux/include/linux/power/max17042_battery.h (revision 03ab8e6297acd1bc0eedaa050e2a1635c576fd11)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * Fuel gauge driver for Maxim 17042 / 8966 / 8997
4  *  Note that Maxim 8966 and 8997 are mfd and this is its subdevice.
5  *
6  * Copyright (C) 2011 Samsung Electronics
7  * MyungJoo Ham <myungjoo.ham@samsung.com>
8  */
9 
10 #ifndef __MAX17042_BATTERY_H_
11 #define __MAX17042_BATTERY_H_
12 
13 #define MAX17042_STATUS_BattAbsent	(1 << 3)
14 #define MAX17042_BATTERY_FULL		(95)   /* Recommend. FullSOCThr value */
15 #define MAX17042_DEFAULT_SNS_RESISTOR	(10000)
16 #define MAX17042_DEFAULT_VMIN		(3000)
17 #define MAX17042_DEFAULT_VMAX		(4500) /* LiHV cell max */
18 #define MAX17042_DEFAULT_TEMP_MIN	(0)    /* For sys without temp sensor */
19 #define MAX17042_DEFAULT_TEMP_MAX	(700)  /* 70 degrees Celcius */
20 
21 /* Consider RepCap which is less then 10 units below FullCAP full */
22 #define MAX17042_FULL_THRESHOLD		10
23 
24 #define MAX17042_CHARACTERIZATION_DATA_SIZE 48
25 
26 enum max17042_register {
27 	MAX17042_STATUS		= 0x00,
28 	MAX17042_VALRT_Th	= 0x01,
29 	MAX17042_TALRT_Th	= 0x02,
30 	MAX17042_SALRT_Th	= 0x03,
31 	MAX17042_AtRate		= 0x04,
32 	MAX17042_RepCap		= 0x05,
33 	MAX17042_RepSOC		= 0x06,
34 	MAX17042_Age		= 0x07,
35 	MAX17042_TEMP		= 0x08,
36 	MAX17042_VCELL		= 0x09,
37 	MAX17042_Current	= 0x0A,
38 	MAX17042_AvgCurrent	= 0x0B,
39 
40 	MAX17042_SOC		= 0x0D,
41 	MAX17042_AvSOC		= 0x0E,
42 	MAX17042_RemCap		= 0x0F,
43 	MAX17042_FullCAP	= 0x10,
44 	MAX17042_TTE		= 0x11,
45 	MAX17042_V_empty	= 0x12,
46 
47 	MAX17042_RSLOW		= 0x14,
48 
49 	MAX17042_AvgTA		= 0x16,
50 	MAX17042_Cycles		= 0x17,
51 	MAX17042_DesignCap	= 0x18,
52 	MAX17042_AvgVCELL	= 0x19,
53 	MAX17042_MinMaxTemp	= 0x1A,
54 	MAX17042_MinMaxVolt	= 0x1B,
55 	MAX17042_MinMaxCurr	= 0x1C,
56 	MAX17042_CONFIG		= 0x1D,
57 	MAX17042_ICHGTerm	= 0x1E,
58 	MAX17042_AvCap		= 0x1F,
59 	MAX17042_ManName	= 0x20,
60 	MAX17042_DevName	= 0x21,
61 
62 	MAX17042_FullCAPNom	= 0x23,
63 	MAX17042_TempNom	= 0x24,
64 	MAX17042_TempLim	= 0x25,
65 	MAX17042_TempHot	= 0x26,
66 	MAX17042_AIN		= 0x27,
67 	MAX17042_LearnCFG	= 0x28,
68 	MAX17042_FilterCFG	= 0x29,
69 	MAX17042_RelaxCFG	= 0x2A,
70 	MAX17042_MiscCFG	= 0x2B,
71 	MAX17042_TGAIN		= 0x2C,
72 	MAX17042_TOFF		= 0x2D,
73 	MAX17042_CGAIN		= 0x2E,
74 	MAX17042_COFF		= 0x2F,
75 
76 	MAX17042_MaskSOC	= 0x32,
77 	MAX17042_SOC_empty	= 0x33,
78 	MAX17042_T_empty	= 0x34,
79 
80 	MAX17042_FullCAP0       = 0x35,
81 	MAX17042_IAvg_empty	= 0x36,
82 	MAX17042_FCTC		= 0x37,
83 	MAX17042_RCOMP0		= 0x38,
84 	MAX17042_TempCo		= 0x39,
85 	MAX17042_EmptyTempCo	= 0x3A,
86 	MAX17042_K_empty0	= 0x3B,
87 	MAX17042_TaskPeriod	= 0x3C,
88 	MAX17042_FSTAT		= 0x3D,
89 
90 	MAX17042_SHDNTIMER	= 0x3F,
91 
92 	MAX17042_dQacc		= 0x45,
93 	MAX17042_dPacc		= 0x46,
94 
95 	MAX17042_VFSOC0		= 0x48,
96 
97 	MAX17042_QH		= 0x4D,
98 	MAX17042_QL		= 0x4E,
99 
100 	MAX17042_VFSOC0Enable	= 0x60,
101 	MAX17042_MLOCKReg1	= 0x62,
102 	MAX17042_MLOCKReg2	= 0x63,
103 
104 	MAX17042_MODELChrTbl	= 0x80,
105 
106 	MAX17042_OCV		= 0xEE,
107 
108 	MAX17042_OCVInternal	= 0xFB,  /* MAX17055 VFOCV */
109 
110 	MAX17042_VFSOC		= 0xFF,
111 };
112 
113 /* Registers specific to max17055 only */
114 enum max17055_register {
115 	MAX17055_QRes		= 0x0C,
116 	MAX17055_RCell		= 0x14,
117 	MAX17055_TTF		= 0x20,
118 	MAX17055_DieTemp	= 0x34,
119 	MAX17055_USER_MEM	= 0x40,
120 	MAX17055_RGAIN		= 0x43,
121 
122 	MAX17055_ConvgCfg	= 0x49,
123 	MAX17055_VFRemCap	= 0x4A,
124 
125 	MAX17055_STATUS2	= 0xB0,
126 	MAX17055_POWER		= 0xB1,
127 	MAX17055_ID		= 0xB2,
128 	MAX17055_AvgPower	= 0xB3,
129 	MAX17055_IAlrtTh	= 0xB4,
130 	MAX17055_TTFCfg		= 0xB5,
131 	MAX17055_CVMixCap	= 0xB6,
132 	MAX17055_CVHalfTime	= 0xB7,
133 	MAX17055_CGTempCo	= 0xB8,
134 	MAX17055_Curve		= 0xB9,
135 	MAX17055_HibCfg		= 0xBA,
136 	MAX17055_Config2	= 0xBB,
137 	MAX17055_VRipple	= 0xBC,
138 	MAX17055_RippleCfg	= 0xBD,
139 	MAX17055_TimerH		= 0xBE,
140 
141 	MAX17055_RSense		= 0xD0,
142 	MAX17055_ScOcvLim	= 0xD1,
143 
144 	MAX17055_SOCHold	= 0xD3,
145 	MAX17055_MaxPeakPwr	= 0xD4,
146 	MAX17055_SusPeakPwr	= 0xD5,
147 	MAX17055_PackResistance	= 0xD6,
148 	MAX17055_SysResistance	= 0xD7,
149 	MAX17055_MinSysV	= 0xD8,
150 	MAX17055_MPPCurrent	= 0xD9,
151 	MAX17055_SPPCurrent	= 0xDA,
152 	MAX17055_ModelCfg	= 0xDB,
153 	MAX17055_AtQResidual	= 0xDC,
154 	MAX17055_AtTTE		= 0xDD,
155 	MAX17055_AtAvSOC	= 0xDE,
156 	MAX17055_AtAvCap	= 0xDF,
157 };
158 
159 /* Registers specific to max17047/50/55 */
160 enum max17047_register {
161 	MAX17047_QRTbl00	= 0x12,
162 	MAX17047_FullSOCThr	= 0x13,
163 	MAX17047_QRTbl10	= 0x22,
164 	MAX17047_QRTbl20	= 0x32,
165 	MAX17047_V_empty	= 0x3A,
166 	MAX17047_TIMER		= 0x3E,
167 	MAX17047_QRTbl30	= 0x42,
168 };
169 
170 enum max170xx_chip_type {
171 	MAXIM_DEVICE_TYPE_UNKNOWN	= 0,
172 	MAXIM_DEVICE_TYPE_MAX17042,
173 	MAXIM_DEVICE_TYPE_MAX17047,
174 	MAXIM_DEVICE_TYPE_MAX17050,
175 	MAXIM_DEVICE_TYPE_MAX17055,
176 
177 	MAXIM_DEVICE_TYPE_NUM
178 };
179 
180 /*
181  * used for setting a register to a desired value
182  * addr : address for a register
183  * data : setting value for the register
184  */
185 struct max17042_reg_data {
186 	u8 addr;
187 	u16 data;
188 };
189 
190 struct max17042_config_data {
191 	/* External current sense resistor value in milli-ohms */
192 	u32	cur_sense_val;
193 
194 	/* A/D measurement */
195 	u16	tgain;		/* 0x2C */
196 	u16	toff;		/* 0x2D */
197 	u16	cgain;		/* 0x2E */
198 	u16	coff;		/* 0x2F */
199 
200 	/* Alert / Status */
201 	u16	valrt_thresh;	/* 0x01 */
202 	u16	talrt_thresh;	/* 0x02 */
203 	u16	soc_alrt_thresh;	/* 0x03 */
204 	u16	config;		/* 0x01D */
205 	u16	shdntimer;	/* 0x03F */
206 
207 	/* App data */
208 	u16	full_soc_thresh;	/* 0x13 */
209 	u16	design_cap;	/* 0x18 */
210 	u16	ichgt_term;	/* 0x1E */
211 
212 	/* MG3 config */
213 	u16	at_rate;	/* 0x04 */
214 	u16	learn_cfg;	/* 0x28 */
215 	u16	filter_cfg;	/* 0x29 */
216 	u16	relax_cfg;	/* 0x2A */
217 	u16	misc_cfg;	/* 0x2B */
218 	u16	masksoc;	/* 0x32 */
219 
220 	/* MG3 save and restore */
221 	u16	fullcap;	/* 0x10 */
222 	u16	fullcapnom;	/* 0x23 */
223 	u16	socempty;	/* 0x33 */
224 	u16	iavg_empty;	/* 0x36 */
225 	u16	dqacc;		/* 0x45 */
226 	u16	dpacc;		/* 0x46 */
227 	u16	qrtbl00;	/* 0x12 */
228 	u16	qrtbl10;	/* 0x22 */
229 	u16	qrtbl20;	/* 0x32 */
230 	u16	qrtbl30;	/* 0x42 */
231 
232 	/* Cell technology from power_supply.h */
233 	u16	cell_technology;
234 
235 	/* Cell Data */
236 	u16	vempty;		/* 0x12 */
237 	u16	temp_nom;	/* 0x24 */
238 	u16	temp_lim;	/* 0x25 */
239 	u16	fctc;		/* 0x37 */
240 	u16	rcomp0;		/* 0x38 */
241 	u16	tcompc0;	/* 0x39 */
242 	u16	empty_tempco;	/* 0x3A */
243 	u16	kempty0;	/* 0x3B */
244 	u16	cell_char_tbl[MAX17042_CHARACTERIZATION_DATA_SIZE];
245 } __packed;
246 
247 struct max17042_platform_data {
248 	struct max17042_reg_data *init_data;
249 	struct max17042_config_data *config_data;
250 	int num_init_data; /* Number of enties in init_data array */
251 	bool enable_current_sense;
252 	bool enable_por_init; /* Use POR init from Maxim appnote */
253 
254 	/*
255 	 * R_sns in micro-ohms.
256 	 * default 10000 (if r_sns = 0) as it is the recommended value by
257 	 * the datasheet although it can be changed by board designers.
258 	 */
259 	unsigned int r_sns;
260 	int         vmin;	/* in millivolts */
261 	int         vmax;	/* in millivolts */
262 	int         temp_min;	/* in tenths of degree Celsius */
263 	int         temp_max;	/* in tenths of degree Celsius */
264 };
265 
266 #endif /* __MAX17042_BATTERY_H_ */
267