battery.h

Go to the documentation of this file.

 
#ifndef COMPONENT_BATTERY_H
#define COMPONENT_BATTERY_H
 
#include <cstdint>
 
#include "src/system/utils/utils.h"
 
#include "src/system/common/curves.h"
 
namespace lampda {
namespace component {
 
namespace battery {
 
extern uint16_t get_raw_battery_voltage_mv();
 
extern bool is_battery_usable_as_power_source();
extern bool can_battery_be_charged();
 
inline uint16_t liion_mv_to_battery_percent(const uint16_t liionLevel_mv, const uint8_t batteryCountSerie)
{
  using curve_t = common::curves::LinearCurve<uint16_t, uint16_t>;
  static curve_t liionVoltagePercentToRealPercent({// low end of the curve, sharp drop
                                                   curve_t::point_t {3000, 0},
                                                   curve_t::point_t {3210, 500},
                                                   curve_t::point_t {3350, 1000},
                                                   curve_t::point_t {3430, 1500},
                                                   curve_t::point_t {3470, 2000},
                                                   // linear approximation works well enough in range 20-90%
                                                   curve_t::point_t {4080, 9000},
                                                   curve_t::point_t {4110, 9500},
                                                   curve_t::point_t {4180, 10000}});
 
  // sample the curve
  return liionVoltagePercentToRealPercent.sample(liionLevel_mv / batteryCountSerie);
}
 
inline uint16_t get_level_percent(const uint16_t batteryVoltage_mV, const uint8_t cellCount = batteryCount)
{
  return liion_mv_to_battery_percent(batteryVoltage_mV, cellCount);
}
 
inline uint16_t get_level_safe(const uint16_t battery_mv, const uint8_t cellCount = batteryCount)
{
  // save the init values
  static const uint16_t minSafeLevel_percent = get_level_percent(batteryMinVoltageSafe_mV);
  static const uint16_t maxSafeLevel_percent = get_level_percent(batteryMaxVoltageSafe_mV);
 
  // get the result of the total battery life, map it to the safe battery level
  // indicated by user
  return lmpd_constrain<uint16_t>(
          lmpd_map<uint16_t>(
                  get_level_percent(battery_mv, cellCount), minSafeLevel_percent, maxSafeLevel_percent, 0, 10000),
          0,
          10000);
}
 
inline uint16_t get_battery_level()
{
  // get the result of the total battery life, map it to the safe battery level
  // indicated by user
  return get_level_safe(get_raw_battery_voltage_mv());
}
 
uint16_t get_battery_minimum_cell_level();
 
uint16_t get_battery_maximum_cell_level();
 
} // namespace battery
} // namespace component
} // namespace lampda
 
#endif