coreboot-libre-fam15h-rdimm/3rdparty/chromeec/board/reef_mchp/battery.c

701 lines
17 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.
*
* Battery pack vendor provided charging profile
*/
#include "battery.h"
#include "battery_smart.h"
#include "bd9995x.h"
#include "charge_ramp.h"
#include "charge_state.h"
#include "charger_profile_override.h"
#include "common.h"
#include "console.h"
#include "ec_commands.h"
#include "extpower.h"
#include "gpio.h"
#include "hooks.h"
#include "i2c.h"
#include "util.h"
#include "tfdp_chip.h"
#define CPUTS(outstr) cputs(CC_CHARGER, outstr)
#define CPRINTS(format, args...) cprints(CC_CHARGER, format, ## args)
enum battery_type {
BATTERY_SONY_CORP,
BATTERY_PANASONIC,
BATTERY_SMP_COS4870,
BATTERY_SMP_C22N1626,
BATTERY_CPT_C22N1626,
BATTERY_TYPE_COUNT,
};
enum fast_chg_voltage_ranges {
VOLTAGE_RANGE_0,
VOLTAGE_RANGE_1,
VOLTAGE_RANGE_2,
};
enum temp_range {
TEMP_RANGE_0,
TEMP_RANGE_1,
TEMP_RANGE_2,
TEMP_RANGE_3,
TEMP_RANGE_4,
};
struct ship_mode_info {
const int ship_mode_reg;
const int ship_mode_data;
int (*batt_init)(void);
};
struct board_batt_params {
const char *manuf_name;
const struct ship_mode_info *ship_mode_inf;
const struct battery_info *batt_info;
const struct fast_charge_params *fast_chg_params;
};
#define DEFAULT_BATTERY_TYPE BATTERY_SONY_CORP
#define SONY_DISCHARGE_DISABLE_FET_BIT (0x01 << 13)
#define PANASONIC_DISCHARGE_ENABLE_FET_BIT (0x01 << 14)
#define C22N1626_DISCHARGE_ENABLE_FET_BIT (0x01 << 0)
/* keep track of previous charge profile info */
static const struct fast_charge_profile *prev_chg_profile_info;
static enum battery_present batt_pres_prev = BP_NOT_SURE;
static enum battery_type board_battery_type = BATTERY_TYPE_COUNT;
static const struct fast_charge_profile fast_charge_smp_cos4870_info[] = {
/* < 0C */
[TEMP_RANGE_0] = {
.temp_c = TEMPC_TENTHS_OF_DEG(-1),
.current_mA = {
[VOLTAGE_RANGE_0] = 0,
[VOLTAGE_RANGE_1] = 0,
},
},
/* 0C >= && <=15C */
[TEMP_RANGE_1] = {
.temp_c = TEMPC_TENTHS_OF_DEG(15),
.current_mA = {
[VOLTAGE_RANGE_0] = 944,
[VOLTAGE_RANGE_1] = 472,
},
},
/* 15C > && <=20C */
[TEMP_RANGE_2] = {
.temp_c = TEMPC_TENTHS_OF_DEG(20),
.current_mA = {
[VOLTAGE_RANGE_0] = 1416,
[VOLTAGE_RANGE_1] = 1416,
},
},
/* 20C > && <=45C */
[TEMP_RANGE_3] = {
.temp_c = TEMPC_TENTHS_OF_DEG(45),
.current_mA = {
[VOLTAGE_RANGE_0] = 3300,
[VOLTAGE_RANGE_1] = 3300,
},
},
/* > 45C */
[TEMP_RANGE_4] = {
.temp_c = TEMPC_TENTHS_OF_DEG(CHARGER_PROF_TEMP_C_LAST_RANGE),
.current_mA = {
[VOLTAGE_RANGE_0] = 0,
[VOLTAGE_RANGE_1] = 0,
},
},
};
static const struct fast_charge_params fast_chg_params_smp_cos4870 = {
.total_temp_ranges = ARRAY_SIZE(fast_charge_smp_cos4870_info),
.default_temp_range_profile = TEMP_RANGE_2,
.voltage_mV = {
[VOLTAGE_RANGE_0] = 8000,
[VOLTAGE_RANGE_1] = CHARGER_PROF_VOLTAGE_MV_LAST_RANGE,
},
.chg_profile_info = &fast_charge_smp_cos4870_info[0],
};
const struct battery_info batt_info_smp_cos4870 = {
.voltage_max = TARGET_WITH_MARGIN(8700, 5),
.voltage_normal = 7600,
/*
* Actual value 6000mV, added 100mV for charger accuracy so that
* unwanted low VSYS_Prochot# assertion can be avoided.
*/
.voltage_min = 6100,
.precharge_current = 256, /* mA */
.start_charging_min_c = 0,
.start_charging_max_c = 46,
.charging_min_c = 0,
.charging_max_c = 45,
.discharging_min_c = 0,
.discharging_max_c = 60,
};
static const struct fast_charge_profile fast_charge_sonycorp_info[] = {
/* < 10C */
[TEMP_RANGE_0] = {
.temp_c = TEMPC_TENTHS_OF_DEG(9),
.current_mA = {
[VOLTAGE_RANGE_0] = 1200,
[VOLTAGE_RANGE_1] = 1200,
},
},
/* >= 10C */
[TEMP_RANGE_1] = {
.temp_c = TEMPC_TENTHS_OF_DEG(CHARGER_PROF_TEMP_C_LAST_RANGE),
.current_mA = {
[VOLTAGE_RANGE_0] = 2250,
[VOLTAGE_RANGE_1] = 2250,
},
},
};
static const struct fast_charge_params fast_chg_params_sonycorp = {
.total_temp_ranges = ARRAY_SIZE(fast_charge_sonycorp_info),
.default_temp_range_profile = TEMP_RANGE_1,
.voltage_mV = {
[VOLTAGE_RANGE_0] = 8000,
[VOLTAGE_RANGE_1] = CHARGER_PROF_VOLTAGE_MV_LAST_RANGE,
},
.chg_profile_info = &fast_charge_sonycorp_info[0],
};
const struct battery_info batt_info_sonycorp = {
.voltage_max = TARGET_WITH_MARGIN(8700, 5),
.voltage_normal = 7600,
/*
* Actual value 6000mV, added 100mV for charger accuracy so that
* unwanted low VSYS_Prochot# assertion can be avoided.
*/
.voltage_min = 6100,
.precharge_current = 256, /* mA */
.start_charging_min_c = 0,
.start_charging_max_c = 50,
.charging_min_c = 0,
.charging_max_c = 60,
.discharging_min_c = -20,
.discharging_max_c = 75,
};
static const struct fast_charge_profile fast_charge_panasonic_info[] = {
/* < 0C */
[TEMP_RANGE_0] = {
.temp_c = TEMPC_TENTHS_OF_DEG(-1),
.current_mA = {
[VOLTAGE_RANGE_0] = 0,
[VOLTAGE_RANGE_1] = 0,
},
},
/* 0C >= && <= 60C */
[TEMP_RANGE_1] = {
.temp_c = TEMPC_TENTHS_OF_DEG(60),
.current_mA = {
[VOLTAGE_RANGE_0] = 3072,
[VOLTAGE_RANGE_1] = 3072,
},
},
/* > 60C */
[TEMP_RANGE_2] = {
.temp_c = TEMPC_TENTHS_OF_DEG(CHARGER_PROF_TEMP_C_LAST_RANGE),
.current_mA = {
[VOLTAGE_RANGE_0] = 0,
[VOLTAGE_RANGE_1] = 0,
},
},
};
static const struct fast_charge_params fast_chg_params_panasonic = {
.total_temp_ranges = ARRAY_SIZE(fast_charge_panasonic_info),
.default_temp_range_profile = TEMP_RANGE_1,
.voltage_mV = {
[VOLTAGE_RANGE_0] = 8000,
[VOLTAGE_RANGE_1] = CHARGER_PROF_VOLTAGE_MV_LAST_RANGE,
},
.chg_profile_info = &fast_charge_panasonic_info[0],
};
const struct battery_info batt_info_panasoic = {
.voltage_max = TARGET_WITH_MARGIN(8800, 5),
.voltage_normal = 7700,
/*
* Actual value 6000mV, added 100mV for charger accuracy so that
* unwanted low VSYS_Prochot# assertion can be avoided.
*/
.voltage_min = 6100,
.precharge_current = 256, /* mA */
.start_charging_min_c = 0,
.start_charging_max_c = 50,
.charging_min_c = 0,
.charging_max_c = 60,
.discharging_min_c = -20,
.discharging_max_c = 75,
};
static const struct fast_charge_profile fast_charge_smp_c22n1626_info[] = {
/* < 1C */
[TEMP_RANGE_0] = {
.temp_c = TEMPC_TENTHS_OF_DEG(0),
.current_mA = {
[VOLTAGE_RANGE_0] = 0,
[VOLTAGE_RANGE_1] = 0,
[VOLTAGE_RANGE_2] = 0,
},
},
/* >=1C && <=10C */
[TEMP_RANGE_1] = {
.temp_c = TEMPC_TENTHS_OF_DEG(10),
.current_mA = {
[VOLTAGE_RANGE_0] = 1752,
[VOLTAGE_RANGE_1] = 1752,
[VOLTAGE_RANGE_2] = 1752,
},
},
/* 10C > && <=45C */
[TEMP_RANGE_2] = {
.temp_c = TEMPC_TENTHS_OF_DEG(45),
.current_mA = {
[VOLTAGE_RANGE_0] = 4672,
[VOLTAGE_RANGE_1] = 4672,
[VOLTAGE_RANGE_2] = 2920,
},
},
/* 45C > && <=60C */
[TEMP_RANGE_3] = {
.temp_c = TEMPC_TENTHS_OF_DEG(60),
.current_mA = {
[VOLTAGE_RANGE_0] = 2920,
[VOLTAGE_RANGE_1] = 0,
[VOLTAGE_RANGE_2] = 0,
},
},
/* > 60C */
[TEMP_RANGE_4] = {
.temp_c = TEMPC_TENTHS_OF_DEG(CHARGER_PROF_TEMP_C_LAST_RANGE),
.current_mA = {
[VOLTAGE_RANGE_0] = 0,
[VOLTAGE_RANGE_1] = 0,
[VOLTAGE_RANGE_2] = 0,
},
},
};
static const struct fast_charge_params fast_chg_params_smp_c22n1626 = {
.total_temp_ranges = ARRAY_SIZE(fast_charge_smp_c22n1626_info),
.default_temp_range_profile = TEMP_RANGE_2,
.voltage_mV = {
[VOLTAGE_RANGE_0] = 8200,
[VOLTAGE_RANGE_1] = 8500,
[VOLTAGE_RANGE_2] = CHARGER_PROF_VOLTAGE_MV_LAST_RANGE,
},
.chg_profile_info = &fast_charge_smp_c22n1626_info[0],
};
static const struct fast_charge_profile fast_charge_cpt_c22n1626_info[] = {
/* < 1C */
[TEMP_RANGE_0] = {
.temp_c = TEMPC_TENTHS_OF_DEG(0),
.current_mA = {
[VOLTAGE_RANGE_0] = 0,
[VOLTAGE_RANGE_1] = 0,
[VOLTAGE_RANGE_2] = 0,
},
},
/* >=1C && <=10C */
[TEMP_RANGE_1] = {
.temp_c = TEMPC_TENTHS_OF_DEG(10),
.current_mA = {
[VOLTAGE_RANGE_0] = 1752,
[VOLTAGE_RANGE_1] = 1752,
[VOLTAGE_RANGE_2] = 1752,
},
},
/* 10C > && <=45C */
[TEMP_RANGE_2] = {
.temp_c = TEMPC_TENTHS_OF_DEG(45),
.current_mA = {
[VOLTAGE_RANGE_0] = 4600,
[VOLTAGE_RANGE_1] = 4600,
[VOLTAGE_RANGE_2] = 2920,
},
},
/* 45C > && <=60C */
[TEMP_RANGE_3] = {
.temp_c = TEMPC_TENTHS_OF_DEG(60),
.current_mA = {
[VOLTAGE_RANGE_0] = 2920,
[VOLTAGE_RANGE_1] = 0,
[VOLTAGE_RANGE_2] = 0,
},
},
/* >60C */
[TEMP_RANGE_4] = {
.temp_c = TEMPC_TENTHS_OF_DEG(CHARGER_PROF_TEMP_C_LAST_RANGE),
.current_mA = {
[VOLTAGE_RANGE_0] = 0,
[VOLTAGE_RANGE_1] = 0,
[VOLTAGE_RANGE_2] = 0,
},
},
};
static const struct fast_charge_params fast_chg_params_cpt_c22n1626 = {
.total_temp_ranges = ARRAY_SIZE(fast_charge_cpt_c22n1626_info),
.default_temp_range_profile = TEMP_RANGE_2,
.voltage_mV = {
[VOLTAGE_RANGE_0] = 8200,
[VOLTAGE_RANGE_1] = 8500,
[VOLTAGE_RANGE_2] = CHARGER_PROF_VOLTAGE_MV_LAST_RANGE,
},
.chg_profile_info = &fast_charge_cpt_c22n1626_info[0],
};
const struct battery_info batt_info_c22n1626 = {
.voltage_max = TARGET_WITH_MARGIN(8800, 5),
.voltage_normal = 7700,
/*
* Actual value 6000mV, added 100mV for charger accuracy so that
* unwanted low VSYS_Prochot# assertion can be avoided.
*/
.voltage_min = 6100,
.precharge_current = 256, /* 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 = 60,
};
static int batt_smp_cos4870_init(void)
{
int batt_status;
return battery_status(&batt_status) ? 0 :
batt_status & STATUS_INITIALIZED;
}
static int batt_sony_corp_init(void)
{
int batt_status;
/*
* SB_MANUFACTURER_ACCESS:
* [13] : Discharging Disabled
* : 0b - Allowed to Discharge
* : 1b - Not Allowed to Discharge
*/
return sb_read(SB_MANUFACTURER_ACCESS, &batt_status) ? 0 :
!(batt_status & SONY_DISCHARGE_DISABLE_FET_BIT);
}
static int batt_panasonic_init(void)
{
int batt_status;
/*
* SB_MANUFACTURER_ACCESS:
* [14] : Discharging Disabled
* : 0b - Not Allowed to Discharge
* : 1b - Allowed to Discharge
*/
return sb_read(SB_MANUFACTURER_ACCESS, &batt_status) ? 0 :
!!(batt_status & PANASONIC_DISCHARGE_ENABLE_FET_BIT);
}
static int batt_c22n1626_init(void)
{
int batt_status;
/*
* SB_PACK_STATUS:
* [0] : Discharging Enabled
* : 0b - Not Allowed to Discharge
* : 1b - Allowed to Discharge
*/
return sb_read(SB_PACK_STATUS, &batt_status) ? 0 :
!!(batt_status & C22N1626_DISCHARGE_ENABLE_FET_BIT);
}
static const struct ship_mode_info ship_mode_info_smp_cos4870 = {
.ship_mode_reg = 0x00,
.ship_mode_data = 0x0010,
.batt_init = batt_smp_cos4870_init,
};
static const struct ship_mode_info ship_mode_info_sonycorp = {
.ship_mode_reg = 0x3A,
.ship_mode_data = 0xC574,
.batt_init = batt_sony_corp_init,
};
static const struct ship_mode_info ship_mode_info_panasonic = {
.ship_mode_reg = 0x3A,
.ship_mode_data = 0xC574,
.batt_init = batt_panasonic_init,
};
static const struct ship_mode_info ship_mode_info_c22n1626 = {
.ship_mode_reg = 0x00,
.ship_mode_data = 0x0010,
.batt_init = batt_c22n1626_init,
};
static const struct board_batt_params info[] = {
/* BQ40Z555 SONY CORP BATTERY battery specific configurations */
[BATTERY_SONY_CORP] = {
.manuf_name = "SONYCorp",
.ship_mode_inf = &ship_mode_info_sonycorp,
.fast_chg_params = &fast_chg_params_sonycorp,
.batt_info = &batt_info_sonycorp,
},
/* RAJ240045 Panasoic battery specific configurations */
[BATTERY_PANASONIC] = {
.manuf_name = "PANASONIC",
.ship_mode_inf = &ship_mode_info_panasonic,
.fast_chg_params = &fast_chg_params_panasonic,
.batt_info = &batt_info_panasoic,
},
/* BQ40Z55 SMP COS4870 BATTERY battery specific configurations */
[BATTERY_SMP_COS4870] = {
.manuf_name = "SMP-COS4870",
.ship_mode_inf = &ship_mode_info_smp_cos4870,
.fast_chg_params = &fast_chg_params_smp_cos4870,
.batt_info = &batt_info_smp_cos4870,
},
/* BQ40Z55 SMP C22N1626 BATTERY battery specific configurations */
[BATTERY_SMP_C22N1626] = {
.manuf_name = "AS1FNZD3KD",
.ship_mode_inf = &ship_mode_info_c22n1626,
.fast_chg_params = &fast_chg_params_smp_c22n1626,
.batt_info = &batt_info_c22n1626,
},
/* BQ40Z55 CPT C22N1626 BATTERY battery specific configurations */
[BATTERY_CPT_C22N1626] = {
.manuf_name = "AS1FOAD3KD",
.ship_mode_inf = &ship_mode_info_c22n1626,
.fast_chg_params = &fast_chg_params_cpt_c22n1626,
.batt_info = &batt_info_c22n1626,
},
};
BUILD_ASSERT(ARRAY_SIZE(info) == BATTERY_TYPE_COUNT);
static inline const struct board_batt_params *board_get_batt_params(void)
{
return &info[board_battery_type == BATTERY_TYPE_COUNT ?
DEFAULT_BATTERY_TYPE : board_battery_type];
}
enum battery_present battery_hw_present(void)
{
int bp;
/* The GPIO is low when the battery is physically present */
bp = gpio_get_level(GPIO_EC_BATT_PRES_L);
return bp ? BP_NO : BP_YES;
}
/* Get type of the battery connected on the board */
static int board_get_battery_type(void)
{
const struct fast_charge_params *chg_params;
char name[32];
int i;
if (!battery_manufacturer_name(name, sizeof(name))) {
for (i = 0; i < BATTERY_TYPE_COUNT; i++) {
if (!strcasecmp(name, info[i].manuf_name)) {
board_battery_type = i;
break;
}
}
}
/* Initialize fast charging parameters */
chg_params = board_get_batt_params()->fast_chg_params;
prev_chg_profile_info = &chg_params->chg_profile_info[
chg_params->default_temp_range_profile];
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
CPUTS("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 board_get_batt_params()->batt_info;
}
int board_cut_off_battery(void)
{
int rv;
const struct ship_mode_info *ship_mode_inf =
board_get_batt_params()->ship_mode_inf;
/* Ship mode command must be sent twice to take effect */
rv = sb_write(ship_mode_inf->ship_mode_reg,
ship_mode_inf->ship_mode_data);
if (rv != EC_SUCCESS)
return rv;
rv = sb_write(ship_mode_inf->ship_mode_reg,
ship_mode_inf->ship_mode_data);
return rv;
}
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 (!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 till 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;
}
/*
* 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)
{
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;
}
return charger_profile_override_common(curr,
board_get_batt_params()->fast_chg_params,
&prev_chg_profile_info,
board_get_batt_params()->batt_info->voltage_max);
}
/*
* 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()) {
/* Re-init board battery if battery presence status changes */
if (board_get_battery_type() == BATTERY_TYPE_COUNT) {
if (bd9995x_get_battery_voltage() >=
board_get_batt_params()->batt_info->voltage_min)
batt_pres = BP_NO;
} else if (!board_get_batt_params()->ship_mode_inf->batt_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);
}