PebbleOS v4.47.0-512-g5285d4236
Loading...
Searching...
No Matches
Battery

The battery cell, as the hardware description gives it. More...

Data Structures

struct  pbl_battery_ocv_point
 A point of an open-circuit voltage curve. More...
 
struct  pbl_battery
 The battery cell, as the hardware description gives it. More...
 

Macros

#define PBL_BATTERY_DEFINE(sym, _capacity_uah, _resistance_uohm, _chg_current_ua, _term_current_ua, _chg_voltage_uv, ...)
 Define a battery.
 

Variables

const struct pbl_battery *const BATTERY
 The board's battery.
 

Detailed Description

The battery cell, as the hardware description gives it.


Data Structure Documentation

◆ pbl_battery_ocv_point

struct pbl_battery_ocv_point

A point of an open-circuit voltage curve.

Data Fields
uint8_t pct State of charge in percent.
uint32_t uv Open-circuit voltage in uV.

◆ pbl_battery

struct pbl_battery

The battery cell, as the hardware description gives it.

Data, not a device: chargers and fuel gauges read it. Fields the description lacks are 0.

Data Fields
uint32_t charge_full_design_uah Design capacity in uAh.
uint32_t charge_term_current_ua Charge termination current in uA.
uint32_t constant_charge_current_ua Constant charge current in uA.
uint32_t constant_charge_voltage_uv Constant charge voltage in uV.
uint32_t internal_resistance_uohm Internal resistance in uOhm.
const struct pbl_battery_ocv_point * ocv Open-circuit voltage curve, from full to empty, or NULL.
size_t ocv_count Number of points of ocv.

Macro Definition Documentation

◆ PBL_BATTERY_DEFINE

#define PBL_BATTERY_DEFINE (   sym,
  _capacity_uah,
  _resistance_uohm,
  _chg_current_ua,
  _term_current_ua,
  _chg_voltage_uv,
  ... 
)
Value:
__VA_OPT__(static const struct pbl_battery_ocv_point sym##_ocv[] = {__VA_ARGS__};) \
const struct pbl_battery sym = { \
.charge_full_design_uah = (_capacity_uah), \
.internal_resistance_uohm = (_resistance_uohm), \
.constant_charge_current_ua = (_chg_current_ua), \
.charge_term_current_ua = (_term_current_ua), \
.constant_charge_voltage_uv = (_chg_voltage_uv), \
__VA_OPT__(.ocv = sym##_ocv, .ocv_count = PBL_ARRAY_SIZE(sym##_ocv), ) \
}
uint32_t charge_full_design_uah
Design capacity in uAh.
Definition battery.h:32
A point of an open-circuit voltage curve.
Definition battery.h:18
The battery cell, as the hardware description gives it.
Definition battery.h:30
#define PBL_ARRAY_SIZE(array)
Get the number of elements of an array.
Definition size.h:40

Define a battery.

Parameters
symSymbol of the battery.
_capacity_uahDesign capacity in uAh.
_resistance_uohmInternal resistance in uOhm.
_chg_current_uaConstant charge current in uA.
_term_current_uaCharge termination current in uA.
_chg_voltage_uvConstant charge voltage in uV.
...Open-circuit voltage curve, as {uV, percent} points from full to empty, if any.

Variable Documentation

◆ BATTERY

const struct pbl_battery* const BATTERY
extern

The board's battery.