blob: ed3d2d70b4d9ee047c691d8b0e87181140ed527c (
plain)
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
|
/* Copyright 2018 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 fuel gauge parameters
*/
#ifndef __CROS_EC_BATTERY_FUEL_GAUGE_H
#define __CROS_EC_BATTERY_FUEL_GAUGE_H
#include "battery.h"
#include <stdbool.h>
/* Number of writes needed to invoke battery cutoff command */
#define SHIP_MODE_WRITES 2
/* When battery type is not initialized */
#define BATTERY_TYPE_UNINITIALIZED -1
struct ship_mode_info {
/*
* Write Block Support. If wb_support is true, then we use a i2c write
* block command instead of a 16-bit write. The effective difference is
* that the i2c transaction will prefix the length (2) when wb_support
* is enabled.
*/
const uint8_t wb_support;
const uint8_t reg_addr;
const uint16_t reg_data[SHIP_MODE_WRITES];
};
struct sleep_mode_info {
const bool sleep_supported;
const uint8_t reg_addr;
const uint16_t reg_data;
};
struct fet_info {
const int mfgacc_support;
const uint8_t reg_addr;
const uint16_t reg_mask;
const uint16_t disconnect_val;
const uint16_t cfet_mask; /* CHG FET status mask */
const uint16_t cfet_off_val;
};
struct fuel_gauge_info {
const char *manuf_name;
const char *device_name;
const uint8_t override_nil;
const struct ship_mode_info ship_mode;
const struct sleep_mode_info sleep_mode;
const struct fet_info fet;
#ifdef CONFIG_BATTERY_MEASURE_IMBALANCE
/* See battery_*_imbalance_mv() for functions which are suitable. */
int (*imbalance_mv)(void);
#endif
};
struct board_batt_params {
const struct fuel_gauge_info fuel_gauge;
const struct battery_info batt_info;
};
/* Forward declare board specific data used by common code */
extern const struct board_batt_params board_battery_info[];
extern const enum battery_type DEFAULT_BATTERY_TYPE;
#ifdef CONFIG_BATTERY_MEASURE_IMBALANCE
/**
* Report the absolute difference between the highest and lowest cell voltage in
* the battery pack, in millivolts. On error or unimplemented, returns '0'.
*/
int battery_default_imbalance_mv(void);
#ifdef CONFIG_BATTERY_BQ4050
int battery_bq4050_imbalance_mv(void);
#endif
#endif
#ifdef CONFIG_BATTERY_TYPE_NO_AUTO_DETECT
/*
* Set the battery type, when auto-detection cannot be used.
*
* @param type Battery type
*/
void battery_set_fixed_battery_type(int type);
#endif
/**
* Return the board-specific default battery type.
*
* @return a value of `enum battery_type`.
*/
__override_proto int board_get_default_battery_type(void);
/**
* Return 1 if CFET is disabled, 0 if enabled. -1 if an error was encountered.
* If the CFET mask is not defined, it will return 0.
*/
int battery_is_charge_fet_disabled(void);
/**
* Battery cut off command via SMBus write block.
*
* @param ship_mode Battery ship mode information
* @return non-zero if error
*/
int cut_off_battery_block_write(const struct ship_mode_info *ship_mode);
/**
* Battery cut off command via SMBus write word.
*
* @param ship_mode Battery ship mode information
* @return non-zero if error
*/
int cut_off_battery_sb_write(const struct ship_mode_info *ship_mode);
/**
* Send the fuel gauge sleep command through SMBus.
*
* @return 0 if successful, non-zero if error occurred
*/
enum ec_error_list battery_sleep_fuel_gauge(void);
#endif /* __CROS_EC_BATTERY_FUEL_GAUGE_H */
|
