1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
/* Copyright 2017 The Chromium OS Authors. All rights reserved.
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*
* Battery driver for MAX17055.
*/
#ifndef __CROS_EC_MAX17055_H
#define __CROS_EC_MAX17055_H
#define MAX17055_ADDR__7bf 0x36
#define MAX17055_DEVICE_ID 0x4010
#define REG_STATUS 0x00
#define REG_AT_RATE 0x04
#define REG_REMAINING_CAPACITY 0x05
#define REG_STATE_OF_CHARGE 0x06
#define REG_TEMPERATURE 0x08
#define REG_VOLTAGE 0x09
#define REG_CURRENT 0x0a
#define REG_AVERAGE_CURRENT 0x0b
#define REG_FULL_CHARGE_CAPACITY 0x10
#define REG_TIME_TO_EMPTY 0x11
#define REG_QR_TABLE00 0x12
#define REG_CONFIG 0x1D
#define REG_AVERAGE_TEMPERATURE 0x16
#define REG_CYCLE_COUNT 0x17
#define REG_DESIGN_CAPACITY 0x18
#define REG_AVERAGE_VOLTAGE 0x19
#define REG_CHARGE_TERM_CURRENT 0x1e
#define REG_TIME_TO_FULL 0x20
#define REG_DEVICE_NAME 0x21
#define REG_QR_TABLE10 0x22
#define REG_LEARNCFG 0x28
#define REG_QR_TABLE20 0x32
#define REG_RCOMP0 0x38
#define REG_TEMPCO 0x39
#define REG_EMPTY_VOLTAGE 0x3a
#define REG_FSTAT 0x3d
#define REG_TIMER 0x3e
#define REG_QR_TABLE30 0x42
#define REG_DQACC 0x45
#define REG_DPACC 0x46
#define REG_STATUS2 0xb0
#define REG_HIBCFG 0xba
#define REG_CONFIG2 0xbb
#define REG_TIMERH 0xbe
#define REG_MODELCFG 0xdb
/* Status reg (0x00) flags */
#define STATUS_POR 0x0002
#define STATUS_BST 0x0008
/* Config reg (0x1d) flags */
#define CONF_TSEL 0x8000
/* FStat reg (0x3d) flags */
#define FSTAT_DNR 0x0001
#define FSTAT_FQ 0x0080
/* ModelCfg reg (0xdb) flags */
#define MODELCFG_REFRESH 0x8000
#define MODELCFG_VCHG 0x0400
/* Smart battery status bits (sbs reg 0x16) */
#define BATTERY_DISCHARGING 0x40
#define BATTERY_FULLY_CHARGED 0x20
/*
* Before we have the battery fully characterized, we use these macros to
* convert basic battery parameters to max17055 reg values for ez config.
*/
/* Convert design capacity in mAh to max17055 0x18 reg value */
#define MAX17055_DESIGNCAP_REG(bat_cap_mah) \
(bat_cap_mah * BATTERY_MAX17055_RSENSE / 5)
/* Convert charge termination current in mA to max17055 0x1e reg value */
#define MAX17055_ICHGTERM_REG(term_cur_ma) \
(((term_cur_ma * BATTERY_MAX17055_RSENSE) << 4) / 25)
/*
* This macro converts empty voltage target (VE) and recovery voltage (VR)
* in mV to max17055 0x3a reg value. max17055 declares 0% (empty battery) at
* VE. max17055 reenables empty detection when the cell voltage rises above VR.
* VE ranges from 0 to 5110mV, and VR ranges from 0 to 5080mV.
*/
#define MAX17055_VEMPTY_REG(ve_mv, vr_mv) \
(((ve_mv / 10) << 7) | (vr_mv / 40))
/*
* max17055 needs some special battery parameters for fuel gauge
* learning algorithm. Maxim can help characterize the battery pack
* to get a full parameter list. We create a data structure to store
* the battery parameters in the format of max17055 register values.
*/
struct max17055_batt_profile {
/* Design capacity of the cell (LSB = 5uVH / Rsense) */
uint16_t design_cap;
/* Charge termination current (LSB = 1.5625uV / Rsense) */
uint16_t ichg_term;
/* The combination of empty voltage target and recovery voltage */
uint16_t v_empty_detect;
/*
* The parameters below are used for advanced (non-EZ) config
* (dpacc, learn_cfg, tempco, qr_table00, qr_table10,
* qr_table20, and qr_table30)
*/
/* Change in battery SOC between relaxation points (LSB = pct / 16) */
uint16_t dpacc;
/* Magic cell tuning parameters */
uint16_t learn_cfg;
uint16_t rcomp0;
uint16_t tempco;
uint16_t qr_table00;
uint16_t qr_table10;
uint16_t qr_table20;
uint16_t qr_table30;
/*
* If is_ez_config is nonzero, we only use design_cap, ichg_term,
* and v_empty_detect to config max17055 (a.k.a. EZ-config).
*/
uint8_t is_ez_config;
};
/* Return the special battery parameters max17055 needs. */
const struct max17055_batt_profile *max17055_get_batt_profile(void);
#endif /* __CROS_EC_MAX17055_H */
|
