blob: f5408fa2534aa9cc39edb34733973d733a003914 (
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
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
|
/* Copyright 2014 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.
*/
#include <stdbool.h>
#include "battery.h"
#include "battery_smart.h"
#include "charger.h"
#include "chipset.h"
#include "ec_ec_comm_master.h"
#include "ocpc.h"
#include "timer.h"
#ifndef __CROS_EC_CHARGE_STATE_V2_H
#define __CROS_EC_CHARGE_STATE_V2_H
/*
* The values exported by charge_get_state() and charge_get_flags() are used
* only to control the LEDs (with one not-quite-correct exception). For V2
* we use a different set of states internally.
*/
enum charge_state_v2 {
ST_IDLE = 0,
ST_DISCHARGE,
ST_CHARGE,
ST_PRECHARGE,
NUM_STATES_V2
};
struct charge_state_data {
timestamp_t ts;
int ac;
int batt_is_charging;
struct charger_params chg;
struct batt_params batt;
enum charge_state_v2 state;
int requested_voltage;
int requested_current;
int desired_input_current;
#ifdef CONFIG_CHARGER_OTG
int output_current;
#endif
#ifdef CONFIG_EC_EC_COMM_BATTERY_MASTER
int input_voltage;
#endif
#ifdef CONFIG_OCPC
struct ocpc_data ocpc;
#endif
};
/**
* Set the output current limit and voltage. This is used to provide power from
* the charger chip ("OTG" mode).
*
* @param ma Maximum current to provide in mA (0 to disable output).
* @param mv Voltage in mV (ignored if ma == 0).
* @return EC_SUCCESS or error
*/
int charge_set_output_current_limit(int ma, int mv);
/**
* Set the charge input current limit. This value is stored and sent every
* time AC is applied.
*
* @param ma New input current limit in mA
* @param mv Negotiated charge voltage in mV.
* @return EC_SUCCESS or error
*/
int charge_set_input_current_limit(int ma, int mv);
/*
* Expose charge/battery related state
*
* @param param command to get corresponding data
* @param value the corresponding data
* @return EC_SUCCESS or error
*/
#ifdef CONFIG_CHARGE_STATE_DEBUG
int charge_get_charge_state_debug(int param, uint32_t *value);
#endif /* CONFIG_CHARGE_STATE_DEBUG */
/**
* Set the desired manual charge current when in idle mode.
*
* @param curr_ma: Charge current in mA.
*/
void chgstate_set_manual_current(int curr_ma);
/**
* Set the desired manual charge voltage when in idle mode.
*
* @param volt_mv: Charge voltage in mV.
*/
void chgstate_set_manual_voltage(int volt_mv);
/**
* Board-specific routine to indicate if the base is connected.
*/
int board_is_base_connected(void);
/**
* Board-specific routine to enable power distribution between lid and base
* (current can flow both ways).
*/
void board_enable_base_power(int enable);
/**
* Board-specific routine to reset the base (in case it is unresponsive, e.g.
* if we told it to hibernate).
*/
void board_base_reset(void);
/**
* Callback with which boards determine action on critical low battery
*
* The default implementation is provided in charge_state_v2.c. Overwrite it
* to customize it.
*
* @param curr Pointer to struct charge_state_data
* @return Action to take.
*/
enum critical_shutdown board_critical_shutdown_check(
struct charge_state_data *curr);
/**
* Callback to set battery level for shutdown
*
* A board can implement this to customize shutdown battery level at runtime.
*
* @return battery level for shutdown
*/
uint8_t board_set_battery_level_shutdown(void);
/**
* Return system PLT power and battery's desired power.
*
* @return desired power in mW
*/
int charge_get_plt_plus_bat_desired_mw(void);
/**
* Get the stable battery charging current. The current will be
* CHARGE_CURRENT_UNINITIALIZED if not yet stable.
*
* @return stable battery charging current in mA
*/
int charge_get_stable_current(void);
/**
* Select which charger IC will actually be performing the charger switching.
*
* @param idx The index into the chg_chips table.
*/
void charge_set_active_chg_chip(int idx);
/**
* Retrieve which charger IC is the active charger IC performing the charger
* switching.
*/
int charge_get_active_chg_chip(void);
/**
* Set the stable current.
*
* @param ma: battery charging current in mA
*/
void charge_set_stable_current(int ma);
/**
* Reset stable current counter stable_ts. Calling this function would set
* stable_current to CHARGE_CURRENT_UNINITIALIZED.
*/
void charge_reset_stable_current(void);
/**
* Reset stable current counter stable_ts. Calling this function would set
* stable_current to CHARGE_CURRENT_UNINITIALIZED.
*
* @param us: sample stable current until us later.
*/
void charge_reset_stable_current_us(uint64_t us);
/**
* Check if the battery charging current is stable by examining the timestamp.
*
* @return true if stable timestamp expired, false otherwise.
*/
bool charge_is_current_stable(void);
#endif /* __CROS_EC_CHARGE_STATE_V2_H */
|
