path: root/board/samus/battery.c

/* Copyright 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_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;
		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_unlocked(I2C_PORT_BATTERY, BATTERY_ADDR_FLAGS,
			       buf, 3, NULL, 0, I2C_XFER_SINGLE);
	rv |= i2c_xfer_unlocked(I2C_PORT_BATTERY, BATTERY_ADDR_FLAGS,
				buf, 3, NULL, 0, I2C_XFER_SINGLE);
	i2c_lock(I2C_PORT_BATTERY, 0);

	return rv;
}