335 lines
9.0 KiB
C
335 lines
9.0 KiB
C
|
/* 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.
|
||
|
|
*
|
||
|
|
* Placeholder values for temporary battery pack.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#include "battery.h"
|
||
|
|
#include "battery_smart.h"
|
||
|
|
#include "bd9995x.h"
|
||
|
|
#include "charge_ramp.h"
|
||
|
|
#include "charge_state.h"
|
||
|
|
#include "console.h"
|
||
|
|
#include "ec_commands.h"
|
||
|
|
#include "extpower.h"
|
||
|
|
#include "gpio.h"
|
||
|
|
#include "hooks.h"
|
||
|
|
#include "util.h"
|
||
|
|
|
||
|
|
#define CPRINTS(format, args...) cprints(CC_CHARGER, format, ## args)
|
||
|
|
|
||
|
|
/* Shutdown mode parameter to write to manufacturer access register */
|
||
|
|
#define SB_SHUTDOWN_DATA 0x0010
|
||
|
|
|
||
|
|
enum battery_type {
|
||
|
|
BATTERY_LG,
|
||
|
|
BATTERY_LISHEN,
|
||
|
|
BATTERY_SIMPLO,
|
||
|
|
BATTERY_TYPE_COUNT,
|
||
|
|
};
|
||
|
|
|
||
|
|
struct board_batt_params {
|
||
|
|
const char *manuf_name;
|
||
|
|
const struct battery_info *batt_info;
|
||
|
|
};
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Set LISHEN as default since the LG precharge current level could cause the
|
||
|
|
* LISHEN battery to not accept charge when it's recovering from a fully
|
||
|
|
* discharged state.
|
||
|
|
*/
|
||
|
|
#define DEFAULT_BATTERY_TYPE BATTERY_LISHEN
|
||
|
|
static enum battery_present batt_pres_prev = BP_NOT_SURE;
|
||
|
|
static enum battery_type board_battery_type = BATTERY_TYPE_COUNT;
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Battery info for LG A50. Note that the fields start_charging_min/max and
|
||
|
|
* charging_min/max are not used for the Eve charger. The effective temperature
|
||
|
|
* limits are given by discharging_min/max_c.
|
||
|
|
*/
|
||
|
|
static const struct battery_info batt_info_lg = {
|
||
|
|
.voltage_max = TARGET_WITH_MARGIN(8800, 5), /* mV */
|
||
|
|
.voltage_normal = 7700,
|
||
|
|
.voltage_min = 6100, /* Add 100mV for charger accuracy */
|
||
|
|
.precharge_current = 256, /* mA */
|
||
|
|
.start_charging_min_c = 0,
|
||
|
|
.start_charging_max_c = 46,
|
||
|
|
.charging_min_c = 10,
|
||
|
|
.charging_max_c = 50,
|
||
|
|
.discharging_min_c = 0,
|
||
|
|
.discharging_max_c = 60,
|
||
|
|
};
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Battery info for LISHEN. Note that the fields start_charging_min/max and
|
||
|
|
* charging_min/max are not used for the Eve charger. The effective temperature
|
||
|
|
* limits are given by discharging_min/max_c.
|
||
|
|
*/
|
||
|
|
static const struct battery_info batt_info_lishen = {
|
||
|
|
.voltage_max = TARGET_WITH_MARGIN(8800, 5), /* mV */
|
||
|
|
.voltage_normal = 7700,
|
||
|
|
.voltage_min = 6100, /* Add 100mV for charger accuracy */
|
||
|
|
.precharge_current = 256, /* mA */
|
||
|
|
.start_charging_min_c = 0,
|
||
|
|
.start_charging_max_c = 46,
|
||
|
|
.charging_min_c = 10,
|
||
|
|
.charging_max_c = 50,
|
||
|
|
.discharging_min_c = 0,
|
||
|
|
.discharging_max_c = 60,
|
||
|
|
};
|
||
|
|
|
||
|
|
static const struct board_batt_params info[] = {
|
||
|
|
[BATTERY_LG] = {
|
||
|
|
.manuf_name = "LG A50",
|
||
|
|
.batt_info = &batt_info_lg,
|
||
|
|
},
|
||
|
|
|
||
|
|
[BATTERY_LISHEN] = {
|
||
|
|
.manuf_name = "Lishen A50",
|
||
|
|
.batt_info = &batt_info_lishen,
|
||
|
|
},
|
||
|
|
|
||
|
|
[BATTERY_SIMPLO] = {
|
||
|
|
.manuf_name = "Simplo A50",
|
||
|
|
.batt_info = &batt_info_lishen,
|
||
|
|
},
|
||
|
|
|
||
|
|
};
|
||
|
|
BUILD_ASSERT(ARRAY_SIZE(info) == BATTERY_TYPE_COUNT);
|
||
|
|
|
||
|
|
/* Get type of the battery connected on the board */
|
||
|
|
static int board_get_battery_type(void)
|
||
|
|
{
|
||
|
|
char name[3];
|
||
|
|
int i;
|
||
|
|
|
||
|
|
if (!battery_manufacturer_name(name, sizeof(name))) {
|
||
|
|
for (i = 0; i < BATTERY_TYPE_COUNT; i++) {
|
||
|
|
if (!strncasecmp(name, info[i].manuf_name,
|
||
|
|
ARRAY_SIZE(name)-1)) {
|
||
|
|
board_battery_type = i;
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
return board_battery_type;
|
||
|
|
}
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Initialize the battery type for the board.
|
||
|
|
*
|
||
|
|
* Very first battery info is called by the charger driver to initialize
|
||
|
|
* the charger parameters hence initialize the battery type for the board
|
||
|
|
* as soon as the I2C is initialized.
|
||
|
|
*/
|
||
|
|
static void board_init_battery_type(void)
|
||
|
|
{
|
||
|
|
if (board_get_battery_type() != BATTERY_TYPE_COUNT)
|
||
|
|
CPRINTS("found batt: %s", info[board_battery_type].manuf_name);
|
||
|
|
else
|
||
|
|
CPRINTS("battery not found");
|
||
|
|
}
|
||
|
|
DECLARE_HOOK(HOOK_INIT, board_init_battery_type, HOOK_PRIO_INIT_I2C + 1);
|
||
|
|
|
||
|
|
const struct battery_info *battery_get_info(void)
|
||
|
|
{
|
||
|
|
return info[board_battery_type == BATTERY_TYPE_COUNT ?
|
||
|
|
DEFAULT_BATTERY_TYPE : board_battery_type].batt_info;
|
||
|
|
}
|
||
|
|
|
||
|
|
int board_cut_off_battery(void)
|
||
|
|
{
|
||
|
|
int rv;
|
||
|
|
|
||
|
|
/* Ship mode command must be sent twice to take effect */
|
||
|
|
rv = sb_write(SB_MANUFACTURER_ACCESS, SB_SHUTDOWN_DATA);
|
||
|
|
if (rv != EC_SUCCESS)
|
||
|
|
return EC_RES_ERROR;
|
||
|
|
|
||
|
|
rv = sb_write(SB_MANUFACTURER_ACCESS, SB_SHUTDOWN_DATA);
|
||
|
|
return rv ? EC_RES_ERROR : EC_RES_SUCCESS;
|
||
|
|
}
|
||
|
|
|
||
|
|
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_read_mfgacc(PARAM_OPERATION_STATUS,
|
||
|
|
SB_ALT_MANUFACTURER_ACCESS, data, sizeof(data));
|
||
|
|
if (rv)
|
||
|
|
return BATTERY_DISCONNECT_ERROR;
|
||
|
|
|
||
|
|
if (~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_read_mfgacc(PARAM_SAFETY_STATUS,
|
||
|
|
SB_ALT_MANUFACTURER_ACCESS, data, sizeof(data));
|
||
|
|
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;
|
||
|
|
}
|
||
|
|
|
||
|
|
static int charger_should_discharge_on_ac(struct charge_state_data *curr)
|
||
|
|
{
|
||
|
|
/* Can not discharge on AC without battery */
|
||
|
|
if (curr->batt.is_present != BP_YES)
|
||
|
|
return 0;
|
||
|
|
|
||
|
|
/* Do not discharge on AC if the battery is still waking up */
|
||
|
|
if (!(curr->batt.flags & BATT_FLAG_WANT_CHARGE) &&
|
||
|
|
!(curr->batt.status & STATUS_FULLY_CHARGED))
|
||
|
|
return 0;
|
||
|
|
|
||
|
|
/*
|
||
|
|
* In light load (<450mA being withdrawn from VSYS) the DCDC of the
|
||
|
|
* charger operates intermittently i.e. DCDC switches continuously
|
||
|
|
* and then stops to regulate the output voltage and current, and
|
||
|
|
* sometimes to prevent reverse current from flowing to the input.
|
||
|
|
* This causes a slight voltage ripple on VSYS that falls in the
|
||
|
|
* audible noise frequency (single digit kHz range). This small
|
||
|
|
* ripple generates audible noise in the output ceramic capacitors
|
||
|
|
* (caps on VSYS and any input of DCDC under VSYS).
|
||
|
|
*
|
||
|
|
* To overcome this issue enable the battery learning operation
|
||
|
|
* and suspend USB charging and DC/DC converter.
|
||
|
|
*/
|
||
|
|
if ((board_get_version() < 5) && !battery_is_cut_off() &&
|
||
|
|
!(curr->batt.flags & BATT_FLAG_WANT_CHARGE) &&
|
||
|
|
(curr->batt.status & STATUS_FULLY_CHARGED))
|
||
|
|
return 1;
|
||
|
|
|
||
|
|
/*
|
||
|
|
* To avoid inrush current from the external charger, enable
|
||
|
|
* discharge on AC 2till the new charger is detected and charge
|
||
|
|
* detect delay has passed.
|
||
|
|
*/
|
||
|
|
if (!chg_ramp_is_detected() && curr->batt.state_of_charge > 2)
|
||
|
|
return 1;
|
||
|
|
|
||
|
|
return 0;
|
||
|
|
}
|
||
|
|
|
||
|
|
int charger_profile_override(struct charge_state_data *curr)
|
||
|
|
{
|
||
|
|
const struct battery_info *batt_info;
|
||
|
|
/* battery temp in 0.1 deg C */
|
||
|
|
int bat_temp_c = curr->batt.temperature - 2731;
|
||
|
|
int disch_on_ac = charger_should_discharge_on_ac(curr);
|
||
|
|
|
||
|
|
charger_discharge_on_ac(disch_on_ac);
|
||
|
|
|
||
|
|
if (disch_on_ac) {
|
||
|
|
curr->state = ST_DISCHARGE;
|
||
|
|
return 0;
|
||
|
|
}
|
||
|
|
|
||
|
|
batt_info = battery_get_info();
|
||
|
|
/* Don't charge if outside of allowable temperature range */
|
||
|
|
if (bat_temp_c >= batt_info->charging_max_c * 10 ||
|
||
|
|
bat_temp_c < batt_info->charging_min_c * 10) {
|
||
|
|
curr->requested_current = 0;
|
||
|
|
curr->requested_voltage = 0;
|
||
|
|
curr->batt.flags &= ~BATT_FLAG_WANT_CHARGE;
|
||
|
|
curr->state = ST_IDLE;
|
||
|
|
}
|
||
|
|
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)
|
||
|
|
{
|
||
|
|
return EC_RES_INVALID_PARAM;
|
||
|
|
}
|
||
|
|
|
||
|
|
enum ec_status charger_profile_override_set_param(uint32_t param,
|
||
|
|
uint32_t value)
|
||
|
|
{
|
||
|
|
return EC_RES_INVALID_PARAM;
|
||
|
|
}
|
||
|
|
|
||
|
|
enum battery_present battery_hw_present(void)
|
||
|
|
{
|
||
|
|
/* The GPIO is low when the battery is physically present */
|
||
|
|
return gpio_get_level(GPIO_BATTERY_PRESENT_L) ? BP_NO : BP_YES;
|
||
|
|
}
|
||
|
|
|
||
|
|
static int battery_init(void)
|
||
|
|
{
|
||
|
|
int batt_status;
|
||
|
|
|
||
|
|
return battery_status(&batt_status) ? 0 :
|
||
|
|
!!(batt_status & STATUS_INITIALIZED);
|
||
|
|
}
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Physical detection of battery.
|
||
|
|
*/
|
||
|
|
enum battery_present battery_is_present(void)
|
||
|
|
{
|
||
|
|
enum battery_present batt_pres;
|
||
|
|
|
||
|
|
/* 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.
|
||
|
|
*
|
||
|
|
* If battery I2C fails but VBATT is high, battery is booting from
|
||
|
|
* 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 && batt_pres_prev != batt_pres &&
|
||
|
|
!battery_is_cut_off() && !battery_init()) {
|
||
|
|
batt_pres = BP_NO;
|
||
|
|
}
|
||
|
|
|
||
|
|
batt_pres_prev = batt_pres;
|
||
|
|
|
||
|
|
return batt_pres;
|
||
|
|
}
|
||
|
|
|
||
|
|
int board_battery_initialized(void)
|
||
|
|
{
|
||
|
|
return battery_hw_present() == batt_pres_prev;
|
||
|
|
}
|