mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2025-12-29 10:00:51 +00:00
4578166a89
It's sometimes desirable to boot without a battery, but we may brown out if we don't have sufficient current. Inhibit AP power-on, even if the system is unprotected, until our charger and current limit are initialized. BUG=chrome-os-partner:41258 TEST=Manual on reworked glados with subsequent commit. Remove battery and attach Zinger. Verify EC powers on and AP doesn't boot. Run `powerbtn`, verify that AP boots. Remove all power and attach battery, verify that EC powers on and AP boots. BRANCH=None Change-Id: Ifc3d16f8288a035854e9fd05812ce6de33170d6a Signed-off-by: Shawn Nematbakhsh <shawnn@chromium.org> Reviewed-on: https://chromium-review.googlesource.com/280563 Reviewed-by: Alec Berg <alecaberg@chromium.org>
120 lines
3.3 KiB
C
120 lines
3.3 KiB
C
/* 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.
|
|
*/
|
|
|
|
/* Charger/battery debug command module for Chrome EC */
|
|
|
|
#ifndef __CROS_EC_CHARGER_H
|
|
#define __CROS_EC_CHARGER_H
|
|
|
|
#include "common.h"
|
|
|
|
/* Charger infomation
|
|
* voltage unit: mV
|
|
* current unit: mA
|
|
*/
|
|
struct charger_info {
|
|
const char *name;
|
|
uint16_t voltage_max;
|
|
uint16_t voltage_min;
|
|
uint16_t voltage_step;
|
|
uint16_t current_max;
|
|
uint16_t current_min;
|
|
uint16_t current_step;
|
|
uint16_t input_current_max;
|
|
uint16_t input_current_min;
|
|
uint16_t input_current_step;
|
|
};
|
|
|
|
/*
|
|
* Parameters common to all chargers. Current is in mA, voltage in mV.
|
|
* The status and option values are charger-specific.
|
|
*/
|
|
struct charger_params {
|
|
int current;
|
|
int voltage;
|
|
int input_current;
|
|
int status;
|
|
int option;
|
|
int flags;
|
|
};
|
|
|
|
/* Get the current charger_params. Failures are reported in .flags */
|
|
void charger_get_params(struct charger_params *chg);
|
|
|
|
/* Bits to indicate which fields of struct charger_params could not be read */
|
|
#define CHG_FLAG_BAD_CURRENT 0x00000001
|
|
#define CHG_FLAG_BAD_VOLTAGE 0x00000002
|
|
#define CHG_FLAG_BAD_INPUT_CURRENT 0x00000004
|
|
#define CHG_FLAG_BAD_STATUS 0x00000008
|
|
#define CHG_FLAG_BAD_OPTION 0x00000010
|
|
/* Bit to indicate that the charger data has been initialized */
|
|
#define CHG_FLAG_INITIALIZED 0x00000020
|
|
/* All of the above CHG_FLAG_BAD_* bits */
|
|
#define CHG_FLAG_BAD_ANY 0x0000001f
|
|
|
|
/* Power state machine post init */
|
|
int charger_post_init(void);
|
|
|
|
/* Get charger information. */
|
|
const struct charger_info *charger_get_info(void);
|
|
|
|
/* Get smart battery charger status. Supported flags may vary. */
|
|
int charger_get_status(int *status);
|
|
|
|
/* Set smart battery charger mode. Supported modes may vary. */
|
|
int charger_set_mode(int mode);
|
|
|
|
/**
|
|
* For chargers that are able to supply 5V output power for OTG dongle, this
|
|
* function enables or disables 5V power output.
|
|
*/
|
|
int charger_enable_otg_power(int enabled);
|
|
|
|
/**
|
|
* Return the closest match the charger can supply to the requested current.
|
|
*
|
|
* @param current Requested current in mA.
|
|
*
|
|
* @return Current the charger will actually supply if <current> is requested.
|
|
*/
|
|
int charger_closest_current(int current);
|
|
|
|
/**
|
|
* Return the closest match the charger can supply to the requested voltage.
|
|
*
|
|
* @param voltage Requested voltage in mV.
|
|
*
|
|
* @return Voltage the charger will actually supply if <voltage> is requested.
|
|
*/
|
|
int charger_closest_voltage(int voltage);
|
|
|
|
/* Get/set charge current limit in mA */
|
|
int charger_get_current(int *current);
|
|
int charger_set_current(int current);
|
|
|
|
/* Get/set charge voltage limit in mV */
|
|
int charger_get_voltage(int *voltage);
|
|
int charger_set_voltage(int voltage);
|
|
|
|
/* Discharge battery when on AC power. */
|
|
int charger_discharge_on_ac(int enable);
|
|
|
|
/* Custom board function to discharge battery when on AC power */
|
|
int board_discharge_on_ac(int enable);
|
|
|
|
/* Other parameters that may be charger-specific, but are common so far. */
|
|
int charger_set_input_current(int input_current);
|
|
int charger_get_input_current(int *input_current);
|
|
int charger_manufacturer_id(int *id);
|
|
int charger_device_id(int *id);
|
|
int charger_get_option(int *option);
|
|
int charger_set_option(int option);
|
|
|
|
/* Print all charger info for debugging purposes */
|
|
void print_charger_debug(void);
|
|
|
|
#endif /* __CROS_EC_CHARGER_H */
|
|
|