/* Copyright 2016 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.h" #include "battery_smart.h" #include "charge_state.h" #include "console.h" #include "ec_commands.h" #include "extpower.h" #include "gpio.h" #include "hooks.h" #include "host_command.h" #include "system.h" #include "i2c.h" #include "util.h" /* FET ON/OFF cammand write to fet off register */ #define SB_FET_OFF 0x34 #define SB_FETOFF_DATA1 0x0000 #define SB_FETOFF_DATA2 0x1000 #define SB_FETON_DATA1 0x2000 #define SB_FETON_DATA2 0x4000 #define BATTERY_FETOFF 0x0100 #define GREEN_BOOK_SUPPORT (1 << 2) /* Shutdown mode parameter to write to manufacturer access register */ #define PARAM_CUT_OFF_LOW 0x10 #define PARAM_CUT_OFF_HIGH 0x00 /* Battery info for BQ40Z55 */ static const struct battery_info info = { /* FIXME(dhendrix): where do these values come from? */ .voltage_max = 13050, /* mV */ .voltage_normal = 11250, .voltage_min = 9000, .precharge_current = 200, /* mA */ .start_charging_min_c = 0, .start_charging_max_c = 45, .charging_min_c = 0, .charging_max_c = 60, .discharging_min_c = 0, .discharging_max_c = 70, }; #ifdef CONFIG_BATTERY_PRESENT_CUSTOM static inline enum battery_present battery_hw_present(void) { /* The GPIO is low when the battery is physically present */ return gpio_get_level(GPIO_EC_BATT_PRES_L) ? BP_NO : BP_YES; } #endif const struct battery_info *battery_get_info(void) { return &info; } static void wakeup(void) { int d; int mode; /* Add Green Book support */ if (sb_read(SB_BATTERY_MODE, &mode) == EC_RES_SUCCESS) { mode |= GREEN_BOOK_SUPPORT; sb_write(SB_BATTERY_MODE, mode); } if (sb_read(SB_FET_OFF, &d) == EC_RES_SUCCESS) { if (extpower_is_present() && (d == BATTERY_FETOFF)) { sb_write(SB_FET_OFF, SB_FETON_DATA1); sb_write(SB_FET_OFF, SB_FETON_DATA2); } } } DECLARE_HOOK(HOOK_INIT, wakeup, HOOK_PRIO_DEFAULT); static int cutoff(void) { int rv; /* Ship mode command must be sent twice to take effect */ rv = sb_write(SB_FET_OFF, SB_FETOFF_DATA1); if (rv != EC_SUCCESS) return rv; return sb_write(SB_FET_OFF, SB_FETOFF_DATA2); } int board_cut_off_battery(void) { return cutoff(); } 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 | 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; /* * Battery is present and also the status is initialized and * no safety fault, battery is disconnected. */ if (battery_is_present() == BP_YES) return BATTERY_DISCONNECTED; } not_disconnected = 1; return BATTERY_NOT_DISCONNECTED; } #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 = curr->batt.temperature - 2731; /* keep track of last temperature range for hysteresis */ static enum { TEMP_RANGE_1, TEMP_RANGE_2, TEMP_RANGE_3, TEMP_RANGE_4, TEMP_RANGE_5, } temp_range = TEMP_RANGE_3; /* keep track of last voltage range for hysteresis */ static enum { VOLTAGE_RANGE_LOW, VOLTAGE_RANGE_HIGH, } voltage_range = VOLTAGE_RANGE_LOW; /* Current and previous battery voltage */ int batt_voltage; static int prev_batt_voltage; /* * Determine temperature range. The five ranges are: * < 10C * 10-15C * 15-23C * 23-45C * > 45C * * Add 0.2 degrees of hysteresis. * If temp reading was bad, use last range. */ if (!(curr->batt.flags & BATT_FLAG_BAD_TEMPERATURE)) { if (temp_c < 99) temp_range = TEMP_RANGE_1; else if (temp_c > 101 && temp_c < 149) temp_range = TEMP_RANGE_2; else if (temp_c > 151 && temp_c < 229) temp_range = TEMP_RANGE_3; else if (temp_c > 231 && temp_c < 449) temp_range = TEMP_RANGE_4; else if (temp_c > 451) temp_range = TEMP_RANGE_5; } /* * If battery voltage reading is bad, use the last reading. Otherwise, * determine voltage range with hysteresis. */ if (curr->batt.flags & BATT_FLAG_BAD_VOLTAGE) { batt_voltage = prev_batt_voltage; } else { batt_voltage = prev_batt_voltage = curr->batt.voltage; if (batt_voltage < 8200) voltage_range = VOLTAGE_RANGE_LOW; else if (batt_voltage > 8300) voltage_range = VOLTAGE_RANGE_HIGH; } /* * If we are not charging or we aren't using fast charging profiles, * then do not override desired current and voltage. */ if (curr->state != ST_CHARGE || !fast_charging_allowed) return 0; /* * Okay, impose our custom will: * When battery is 0-10C: * CC at 486mA @ 8.7V * CV at 8.7V * * When battery is <15C: * CC at 1458mA @ 8.7V * CV at 8.7V * * When battery is <23C: * CC at 3402mA until 8.3V @ 8.7V * CC at 2430mA @ 8.7V * CV at 8.7V * * When battery is <45C: * CC at 4860mA until 8.3V @ 8.7V * CC at 2430mA @ 8.7V * CV at 8.7V until current drops to 450mA * * When battery is >45C: * CC at 2430mA @ 8.3V * CV at 8.3V (when battery is hot we don't go to fully charged) */ switch (temp_range) { case TEMP_RANGE_1: curr->requested_current = 486; curr->requested_voltage = 8700; break; case TEMP_RANGE_2: curr->requested_current = 1458; curr->requested_voltage = 8700; break; case TEMP_RANGE_3: curr->requested_voltage = 8700; if (voltage_range == VOLTAGE_RANGE_HIGH) curr->requested_current = 2430; else curr->requested_current = 3402; break; case TEMP_RANGE_4: curr->requested_voltage = 8700; if (voltage_range == VOLTAGE_RANGE_HIGH) curr->requested_current = 2430; else curr->requested_current = 4860; break; case TEMP_RANGE_5: curr->requested_current = 2430; curr->requested_voltage = 8300; break; } 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; } 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_CHARGER_PROFILE_OVERRIDE */ #ifdef CONFIG_BATTERY_PRESENT_CUSTOM /* * Physical detection of battery. */ enum battery_present battery_is_present(void) { enum battery_present batt_pres; int batt_status; /* Get the physical hardware status */ batt_pres = battery_hw_present(); /* * Make sure battery status is implemented, I2C transactions are * success & the battery status is Initialized to find out if it * is a working battery and it is not in the cut-off mode. * * FETs are turned off after Power Shutdown time. * The device will wake up when a voltage is applied to PACK. * Battery status will be inactive until it is initialized. */ if (batt_pres == BP_YES && !battery_status(&batt_status)) if (!(batt_status & STATUS_INITIALIZED)) batt_pres = BP_NO; return batt_pres; } #endif