ra8_batt.c

Go to the documentation of this file.

 
#include "ra8_batt.h"
 
#include <stdint.h>
 
#include "ra8_check.h"
#include "ra8_err.h"

static const char* const s_tag = "ra8_batt";
 
ra8_err_t ra8_batt_monitor_init(ra8_batt_monitor_t* mon)
{
  RA8_CHECK_NULL_PTR(mon, s_tag, "mon must not be nullptr");
  mon->low_raised      = false;
  mon->critical_raised = false;
  return k_ra8_ok;
}
 
ra8_err_t
ra8_batt_update(ra8_batt_monitor_t* mon, uint8_t soc_pct, bool charging, ra8_batt_nag_t* out_nag)
{
  RA8_CHECK_NULL_PTR(mon, s_tag, "mon must not be nullptr");
  RA8_CHECK_NULL_PTR(out_nag, s_tag, "out_nag must not be nullptr");
 
  const uint8_t soc =
    (soc_pct > (uint8_t)k_ra8_batt_pct_max) ? (uint8_t)k_ra8_batt_pct_max : soc_pct;
  const uint8_t low_rearm =
    (uint8_t)((uint8_t)k_ra8_batt_low_pct + (uint8_t)k_ra8_batt_rearm_margin);
  const uint8_t crit_rearm =
    (uint8_t)((uint8_t)k_ra8_batt_critical_pct + (uint8_t)k_ra8_batt_rearm_margin);
 
  /* Re-arm a band once charging, or once SOC has recovered above its margin. */
  if (charging || (soc > low_rearm)) {
    mon->low_raised = false;
  }
  if (charging || (soc > crit_rearm)) {
    mon->critical_raised = false;
  }
 
  ra8_batt_nag_t nag = k_ra8_batt_nag_none;
  if (!charging) {
    if ((soc <= (uint8_t)k_ra8_batt_low_pct) && !mon->low_raised) {
      mon->low_raised = true;
      nag             = k_ra8_batt_nag_low;
    }
    if ((soc <= (uint8_t)k_ra8_batt_critical_pct) && !mon->critical_raised) {
      mon->critical_raised = true;
      nag                  = k_ra8_batt_nag_critical;
    }
  }
  *out_nag = nag;
  return k_ra8_ok;
}
 
const char* ra8_batt_nag_str(ra8_batt_nag_t nag)
{
  const char* label;
  switch (nag) {
    case k_ra8_batt_nag_none:
      label = "OK";
      break;
    case k_ra8_batt_nag_low:
      label = "LOW";
      break;
    case k_ra8_batt_nag_critical:
      label = "CRITICAL";
      break;
    default:
      label = "?";
      break;
  }
  RA8_ASSERT(label != nullptr, "nag label must be non-null");
  return label;
}