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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
|
/* Copyright (c) 2012 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.
*
* Smart battery v1.0
* Smart battery charger v1.1
*/
#ifndef __CROS_EC_SMART_BATTERY_H
#define __CROS_EC_SMART_BATTERY_H
#include "common.h"
#include "i2c.h"
#include "smart_battery_stub.h"
/* Smart battery and charger I2C address */
#define BATTERY_ADDR 0x16
#define CHARGER_ADDR 0x12
/* Charger functions */
#define SB_CHARGER_SPEC_INFO 0x11
#define SB_CHARGE_MODE 0x12
#define SB_CHARGER_STATUS 0x13
#define SB_CHARGING_CURRENT 0x14
#define SB_CHARGING_VOLTAGE 0x15
#define SB_ALARM_WARNING 0x16
/* Battery functions */
#define SB_MANUFACTURER_ACCESS 0x00
#define SB_REMAINING_CAPACITY_ALARM 0x01
#define SB_REMAINING_TIME_ALARM 0x02
#define SB_BATTERY_MODE 0x03
#define SB_AT_RATE 0x04
#define SB_AT_RATE_TIME_TO_FULL 0x05
#define SB_AT_RATE_TIME_TO_EMPTY 0x06
#define SB_AT_RATE_OK 0x07
#define SB_TEMPERATURE 0x08
#define SB_VOLTAGE 0x09
#define SB_CURRENT 0x0a
#define SB_AVERAGE_CURRENT 0x0b
#define SB_MAX_ERROR 0x0c
#define SB_RELATIVE_STATE_OF_CHARGE 0x0d
#define SB_ABSOLUTE_STATE_OF_CHARGE 0x0e
#define SB_REMAINING_CAPACITY 0x0f
#define SB_FULL_CHARGE_CAPACITY 0x10
#define SB_RUN_TIME_TO_EMPTY 0x11
#define SB_AVERAGE_TIME_TO_EMPTY 0x12
#define SB_AVERAGE_TIME_TO_FULL 0x13
#define SB_CHARGING_CURRENT 0x14
#define SB_CHARGING_VOLTAGE 0x15
#define SB_BATTERY_STATUS 0x16
#define SB_CYCLE_COUNT 0x17
#define SB_DESIGN_CAPACITY 0x18
#define SB_DESIGN_VOLTAGE 0x19
#define SB_SPECIFICATION_INFO 0x1a
#define SB_MANUFACTURER_DATE 0x1b
#define SB_SERIAL_NUMBER 0x1c
#define SB_MANUFACTURER_NAME 0x20
#define SB_DEVICE_NAME 0x21
#define SB_DEVICE_CHEMISTRY 0x22
#define SB_MANUFACTURER_DATA 0x23
/* Battery mode */
#define MODE_CAPACITY (1 << 15)
#define MODE_CHARGER (1 << 14)
#define MODE_ALARM (1 << 13)
#define MODE_PRIMARY_BATTERY (1 << 9)
#define MODE_CHARGE_CONTROLLER_ENABLED (1 << 8)
#define MODE_CONDITION_CYCLE (1 << 7)
#define MODE_PRIMARY_BATTERY_SUPPORT (1 << 1)
#define MODE_INTERNAL_CHARGE_CONTROLLER (1 << 0)
/* Battery status */
#define STATUS_ERR_CODE_MASK 0xf
#define STATUS_CODE_OK 0
#define STATUS_CODE_BUSY 1
#define STATUS_CODE_RESERVED 2
#define STATUS_CODE_UNSUPPORTED 3
#define STATUS_CODE_ACCESS_DENIED 4
#define STATUS_CODE_OVERUNDERFLOW 5
#define STATUS_CODE_BADSIZE 6
#define STATUS_CODE_UNKNOWN_ERROR 7
#define STATUS_FULLY_DISCHARGED (1 << 4)
#define STATUS_FULLY_CHARGED (1 << 5)
#define STATUS_DISCHARGING (1 << 6)
#define STATUS_INITIALIZING (1 << 7)
#define STATUS_REMAINING_TIME_ALARM (1 << 8)
#define STATUS_REMAINING_CAPACITY_ALARM (1 << 9)
#define STATUS_TERMINATE_DISCHARGE_ALARM (1 << 11)
#define STATUS_OVERTEMP_ALARM (1 << 12)
#define STATUS_TERMINATE_CHARGE_ALARM (1 << 14)
#define STATUS_OVERCHARGED_ALARM (1 << 15)
/* Charger alarm warning */
#define ALARM_OVER_CHARGED 0x8000
#define ALARM_TERMINATE_CHARGE 0x4000
#define ALARM_RESERVED_2000 0x2000
#define ALARM_OVER_TEMP 0x1000
#define ALARM_TERMINATE_DISCHARGE 0x0800
#define ALARM_RESERVED_0400 0x0400
#define ALARM_REMAINING_CAPACITY 0x0200
#define ALARM_REMAINING_TIME 0x0100
#define ALARM_STATUS_INITIALIZE 0x0080
#define ALARM_STATUS_DISCHARGING 0x0040
#define ALARM_STATUS_FULLY_CHARGED 0x0020
#define ALARM_STATUS_FULLY_DISCHARGED 0x0010
/* Charge mode */
#define CHARGE_FLAG_INHIBIT_CHARGE (1 << 0)
#define CHARGE_FLAG_ENABLE_POLLING (1 << 1)
#define CHARGE_FLAG_POR_RESET (1 << 2)
#define CHARGE_FLAG_RESET_TO_ZERO (1 << 3)
/* Charger status */
#define CHARGER_CHARGE_INHIBITED (1 << 0)
#define CHARGER_POLLING_ENABLED (1 << 1)
#define CHARGER_VOLTAGE_NOTREG (1 << 2)
#define CHARGER_CURRENT_NOTREG (1 << 3)
#define CHARGER_LEVEL_2 (1 << 4)
#define CHARGER_LEVEL_3 (1 << 5)
#define CHARGER_CURRENT_OR (1 << 6)
#define CHARGER_VOLTAGE_OR (1 << 7)
#define CHARGER_RES_OR (1 << 8)
#define CHARGER_RES_COLD (1 << 9)
#define CHARGER_RES_HOT (1 << 10)
#define CHARGER_RES_UR (1 << 11)
#define CHARGER_ALARM_INHIBITED (1 << 12)
#define CHARGER_POWER_FAIL (1 << 13)
#define CHARGER_BATTERY_PRESENT (1 << 14)
#define CHARGER_AC_PRESENT (1 << 15)
/* Charger specification info */
#define INFO_CHARGER_SPEC(INFO) ((INFO) & 0xf)
#define INFO_SELECTOR_SUPPORT(INFO) (((INFO) >> 4) & 1)
/* Get/set battery mode */
static inline int battery_get_battery_mode(int *mode)
{ return sb_read(SB_BATTERY_MODE, mode); }
static inline int battery_set_battery_mode(int mode)
{ return sb_write(SB_BATTERY_MODE, mode); }
/* Read battery temperature
* unit: 0.1 K
*/
static inline int battery_temperature(int *deci_kelvin)
{ return sb_read(SB_TEMPERATURE, deci_kelvin); }
/* Read battery voltage
* unit: mV
*/
static inline int battery_voltage(int *voltage)
{ return sb_read(SB_VOLTAGE, voltage); }
/* Relative state of charge in percent */
static inline int battery_state_of_charge(int *percent)
{ return sb_read(SB_RELATIVE_STATE_OF_CHARGE, percent); }
/* Absolute state of charge in percent */
static inline int battery_state_of_charge_abs(int *percent)
{ return sb_read(SB_ABSOLUTE_STATE_OF_CHARGE, percent); }
/* Battery remaining capacity
* unit: mAh or 10mW, depends on battery mode
*/
static inline int battery_remaining_capacity(int *capacity)
{ return sb_read(SB_REMAINING_CAPACITY, capacity); }
/* Battery full charge capacity */
static inline int battery_full_charge_capacity(int *capacity)
{ return sb_read(SB_FULL_CHARGE_CAPACITY, capacity); }
/* Time in minutes left when discharging */
static inline int battery_time_to_empty(int *minutes)
{ return sb_read(SB_AVERAGE_TIME_TO_EMPTY, minutes); }
static inline int battery_run_time_to_empty(int *minutes)
{ return sb_read(SB_RUN_TIME_TO_EMPTY, minutes); }
/* Time in minutes to full when charging */
static inline int battery_time_to_full(int *minutes)
{ return sb_read(SB_AVERAGE_TIME_TO_FULL, minutes); }
/* The current battery desired to charge
* unit: mA
*/
static inline int battery_desired_current(int *current)
{ return sb_read(SB_CHARGING_CURRENT, current); }
/* The voltage battery desired to charge
* unit: mV
*/
static inline int battery_desired_voltage(int *voltage)
{ return sb_read(SB_CHARGING_VOLTAGE, voltage); }
/* Read battery status */
static inline int battery_status(int *status)
{ return sb_read(SB_BATTERY_STATUS, status); }
/* Battery charge cycle count */
static inline int battery_cycle_count(int *count)
{ return sb_read(SB_CYCLE_COUNT, count); }
/* Designed battery capacity
* unit: mAh or 10mW depends on battery mode
*/
static inline int battery_design_capacity(int *capacity)
{ return sb_read(SB_DESIGN_CAPACITY, capacity); }
/* Designed battery output voltage
* unit: mV
*/
static inline int battery_design_voltage(int *voltage)
{ return sb_read(SB_DESIGN_VOLTAGE, voltage); }
/* Read serial number */
static inline int battery_serial_number(int *serial)
{ return sb_read(SB_SERIAL_NUMBER, serial); }
/* Read manufacturer name */
int battery_manufacturer_name(char *manufacturer_name, int buf_size);
/* Read device name */
int battery_device_name(char *device_name, int buf_size);
/* Read battery type/chemistry */
int battery_device_chemistry(char *device_chemistry, int buf_size);
/* Read battery discharging current
* unit: mA
* negative value: charging
*/
int battery_current(int *current);
int battery_average_current(int *current);
/* Calculate battery time in minutes, under a charging rate
* rate > 0: charging, negative time to full
* rate < 0: discharging, positive time to empty
* rate == 0: invalid input, time = 0
*/
int battery_time_at_rate(int rate, int *minutes);
/* Read manufacturer date */
int battery_manufacturer_date(int *year, int *month, int *day);
#endif /* __CROS_EC_SMART_BATTERY_H */
|
