diff options
author | Victor Prupis <vprupis@google.com> | 2016-08-12 14:15:01 -0700 |
---|---|---|
committer | chrome-bot <chrome-bot@chromium.org> | 2016-08-19 14:21:17 -0700 |
commit | a56aabfc650ebd562d768a9b2fb528ac46f4e540 (patch) | |
tree | bf5387a40bb2486123988a7934b0307b88769416 /board/samus/battery.c | |
parent | 1fd2427b3c9e6914a3a1764f69b6bdff7e5559f1 (diff) | |
download | chrome-ec-a56aabfc650ebd562d768a9b2fb528ac46f4e540.tar.gz |
Standard locations for board specific battery code
Moved battery code for samus and ryu from driver tree to board tree.
BUG=chrome-os-partner:42486
BRANCH=master
TEST=none
Change-Id: Iaad1456323f85e5852d8aa8e3e2d453b26e2d452
Signed-off-by: Victor Prupis <vprupis@google.com>
Reviewed-on: https://chromium-review.googlesource.com/371402
Reviewed-by: Stefan Reinauer <reinauer@google.com>
Diffstat (limited to 'board/samus/battery.c')
-rw-r--r-- | board/samus/battery.c | 310 |
1 files changed, 310 insertions, 0 deletions
diff --git a/board/samus/battery.c b/board/samus/battery.c new file mode 100644 index 0000000000..bd334d08c8 --- /dev/null +++ b/board/samus/battery.c @@ -0,0 +1,310 @@ +/* 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. + * + * Battery pack vendor provided charging profile + */ + +#include "battery_smart.h" +#include "charge_state.h" +#include "console.h" +#include "ec_commands.h" +#include "extpower.h" +#include "i2c.h" +#include "util.h" + +static const struct battery_info info = { + /* + * Design voltage + * max = 8.4V + * normal = 7.4V + * min = 6.0V + */ + .voltage_max = 8700, + .voltage_normal = 7400, + .voltage_min = 6000, + + /* Pre-charge current: I <= 0.01C */ + .precharge_current = 64, /* mA */ + + /* + * Operational temperature range + * 0 <= T_charge <= 50 deg C + * -20 <= T_discharge <= 60 deg C + */ + .start_charging_min_c = 0, + .start_charging_max_c = 50, + .charging_min_c = 0, + .charging_max_c = 50, + .discharging_min_c = -20, + .discharging_max_c = 60, +}; + +const struct battery_info *battery_get_info(void) +{ + return &info; +} + +#ifdef CONFIG_CHARGER_PROFILE_OVERRIDE + +static int fast_charging_allowed = 1; + +/* + * This can override the smart battery's charging profile. To make a change, + * modify one or more of requested_voltage, requested_current, or state. + * Leave everything else unchanged. + * + * Return the next poll period in usec, or zero to use the default (which is + * state dependent). + */ +int charger_profile_override(struct charge_state_data *curr) +{ + /* temp in 0.1 deg C */ + int temp_c; + const struct charger_info *info; + + /* keep track of last temperature range for hysteresis */ + static enum { + TEMP_LOW, + TEMP_NORMAL, + TEMP_HIGH + } temp_range = TEMP_NORMAL, prev_temp_range = TEMP_NORMAL; + + /* charging voltage to use at high temp */ + static int high_temp_charging_voltage; + + /* custom profile phase at normal temp */ + static int normal_temp_phase; + + /* battery voltage and current and previous voltage and current */ + int batt_voltage, batt_current; + static int prev_batt_voltage, prev_batt_current; + + /* + * Determine temperature range: + * Low: Battery is <15C + * Normal: Battery is 15-45C + * High: Battery is >45C + * + * Add 0.2 degrees of hysteresis. + * If temp reading was bad use last range. + */ + if (!(curr->batt.flags & BATT_FLAG_BAD_TEMPERATURE)) { + temp_c = curr->batt.temperature - 2731; + if (temp_c < 149) + temp_range = TEMP_LOW; + else if (temp_c > 151 && temp_c < 449) + temp_range = TEMP_NORMAL; + else if (temp_c > 451) + temp_range = TEMP_HIGH; + } + + /* + * Treat voltage and current as a pair, if either is bad fall back to + * previous reading. + */ + if (curr->batt.flags & + (BATT_FLAG_BAD_VOLTAGE | BATT_FLAG_BAD_CURRENT)) { + batt_voltage = prev_batt_voltage; + batt_current = prev_batt_current; + } else { + batt_voltage = prev_batt_voltage = curr->batt.voltage; + batt_current = prev_batt_current = curr->batt.current; + } + + /* + * If we are not charging or we aren't using fast charging profiles, + * then do not override desired current and voltage and reset some + * fast charging profile static variables. + */ + if (curr->state != ST_CHARGE || !fast_charging_allowed) { + prev_temp_range = TEMP_NORMAL; + normal_temp_phase = 0; + return 0; + } + + /* + * Okay, impose our custom will: + * Normal temp: + * Phase 0: CC at 9515mA @ 8.3V + * CV at 8.3V until current drops to 4759mA + * Phase 1: CC at 4759mA @ 8.7V + * CV at 8.7V + * + * Low temp: + * CC at 2854mA @ 8.7V + * CV at 8.7V + * + * High temp: + * If battery voltage < 8.3V then: + * CC at 6660mA @ 8.3V + * CV at 8.3V (when battery is hot we don't go to fully charged) + * else: + * CV at just above battery voltage which will essentially + * terminate the charge and allow battery to cool. + * Note that if we ever request a voltage below the present battery + * voltage, then we will stop the BQ switching, which will power off + * the INA and we won't be able to charge again until AC is + * disconnected. see crbug.com/p/35491. + */ + switch (temp_range) { + case TEMP_LOW: + curr->requested_current = 2854; + curr->requested_voltage = 8700; + break; + case TEMP_NORMAL: + if (normal_temp_phase == 0) { + curr->requested_current = 9515; + curr->requested_voltage = 8300; + if (batt_current <= 4759 && batt_voltage >= 8200) + normal_temp_phase = 1; + } + if (normal_temp_phase == 1) { + curr->requested_current = 4759; + curr->requested_voltage = 8700; + } + break; + case TEMP_HIGH: + /* + * First time TEMP_HIGH is used, get the closest voltage + * just above the battery voltage. If it is above 8.3V, we + * will use that as the target, otherwise we will use 8.3V. + */ + if (prev_temp_range != TEMP_HIGH) { + info = charger_get_info(); + high_temp_charging_voltage = MAX(8300, + charger_closest_voltage(batt_voltage + + info->voltage_step)); + } + curr->requested_current = 6660; + curr->requested_voltage = high_temp_charging_voltage; + break; + } + prev_temp_range = temp_range; + + return 0; +} + +/* Customs options controllable by host command. */ +#define PARAM_FASTCHARGE (CS_PARAM_CUSTOM_PROFILE_MIN + 0) + +enum ec_status charger_profile_override_get_param(uint32_t param, + uint32_t *value) +{ + if (param == PARAM_FASTCHARGE) { + *value = fast_charging_allowed; + return EC_RES_SUCCESS; + } + return EC_RES_INVALID_PARAM; +} + +enum ec_status charger_profile_override_set_param(uint32_t param, + uint32_t value) +{ + if (param == PARAM_FASTCHARGE) { + fast_charging_allowed = value; + return EC_RES_SUCCESS; + } + return EC_RES_INVALID_PARAM; +} + +#ifdef CONFIG_CMD_FASTCHARGE +static int command_fastcharge(int argc, char **argv) +{ + if (argc > 1 && !parse_bool(argv[1], &fast_charging_allowed)) + return EC_ERROR_PARAM1; + + ccprintf("fastcharge %s\n", fast_charging_allowed ? "on" : "off"); + + return EC_SUCCESS; +} +DECLARE_CONSOLE_COMMAND(fastcharge, command_fastcharge, + "[on|off]", + "Get or set fast charging profile", + NULL); +#endif /* CONFIG_CMD_FASTCHARGE */ + +#endif /* CONFIG_CHARGER_PROFILE_OVERRIDE */ + +#ifdef CONFIG_BATTERY_REVIVE_DISCONNECT +/* + * Check if battery is in disconnect state, a state entered by pulling + * BATT_DISCONN_N low, and clear that state if we have external power plugged + * and no battery faults are detected. Disconnect state resembles battery + * shutdown mode, but extra steps must be taken to get the battery out of this + * mode. + */ +enum battery_disconnect_state battery_get_disconnect_state(void) +{ + uint8_t data[6]; + int rv; + /* + * Take note if we find that the battery isn't in disconnect state, + * and always return NOT_DISCONNECTED without probing the battery. + * This assumes the battery will not go to disconnect state during + * runtime. + */ + static int not_disconnected; + + if (not_disconnected) + return BATTERY_NOT_DISCONNECTED; + + if (extpower_is_present()) { + /* Check if battery charging + discharging is disabled. */ + rv = sb_write(SB_MANUFACTURER_ACCESS, PARAM_OPERATION_STATUS); + if (rv) + return BATTERY_DISCONNECT_ERROR; + + rv = sb_read_string(I2C_PORT_BATTERY, BATTERY_ADDR, + SB_ALT_MANUFACTURER_ACCESS, data, 6); + + if (rv || !(data[3] & BATTERY_DISCHARGING_DISABLED) || + !(data[3] & BATTERY_CHARGING_DISABLED)) { + not_disconnected = 1; + return BATTERY_NOT_DISCONNECTED; + } + + /* + * Battery is neither charging nor discharging. Verify that + * we didn't enter this state due to a safety fault. + */ + rv = sb_write(SB_MANUFACTURER_ACCESS, PARAM_SAFETY_STATUS); + if (rv) + return BATTERY_DISCONNECT_ERROR; + + rv = sb_read_string(I2C_PORT_BATTERY, BATTERY_ADDR, + SB_ALT_MANUFACTURER_ACCESS, data, 6); + + if (rv || data[2] || data[3] || data[4] || data[5]) + return BATTERY_DISCONNECT_ERROR; + else + /* No safety fault -- clear disconnect state. */ + return BATTERY_DISCONNECTED; + } + not_disconnected = 1; + return BATTERY_NOT_DISCONNECTED; +} +#endif /* CONFIG_BATTERY_REVIVE_DISCONNECT */ + +#define PARAM_CUT_OFF_LOW 0x10 +#define PARAM_CUT_OFF_HIGH 0x00 + +int board_cut_off_battery(void) +{ + int rv; + uint8_t buf[3]; + + buf[0] = SB_MANUFACTURER_ACCESS & 0xff; + buf[1] = PARAM_CUT_OFF_LOW; + buf[2] = PARAM_CUT_OFF_HIGH; + + i2c_lock(I2C_PORT_BATTERY, 1); + rv = i2c_xfer(I2C_PORT_BATTERY, BATTERY_ADDR, buf, 3, NULL, 0, + I2C_XFER_SINGLE); + rv |= i2c_xfer(I2C_PORT_BATTERY, BATTERY_ADDR, buf, 3, NULL, 0, + I2C_XFER_SINGLE); + i2c_lock(I2C_PORT_BATTERY, 0); + + return rv; +} + |