/* 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"); #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; }