state_of_charge.h

#pragma once
 
/************************************************************************************************
 * @file   state_of_charge.h
 *
 * @brief  Header file for State of Charge
 *
 * @date   2025-02-06
 * @author Midnight Sun Team #24 - MSXVI
 ************************************************************************************************/
 
/* Standard library Headers */
 
/* Inter-component Headers */
#include "bms_carrier.h"
#include "bms_carrier_getters.h"
#include "bms_carrier_setters.h"
#include "status.h"
 
/* Intra-component Headers */
 
#define CELL_INTERNAL_RESISTANCE_mOHMS 22U
#define PACK_INTERNAL_RESISTANCE_mOHMS (CELL_INTERNAL_RESISTANCE_mOHMS * 9U * 4U) / 8U
#define VOLTS_TO_mV 1000U
#define LUT_SIZE 41U
 
struct StateOfChargeStorage {
  uint32_t last_time;   
  float i_soc;          
  float v_soc;          
  float averaged_soc;   
  int32_t last_current; 
};
 
StatusCode state_of_charge_init(BmsStorage *storage);
 
StatusCode update_state_of_chrage();
 
void coulomb_counting_soc();
 
void ocv_voltage_soc();
 
float perdict_ocv_voltage();
 
#ifdef MS_TEST
 
void ramp_voltage_weight();
 
void set_last_time(uint32_t last_time);
 
void set_i_soc(float i_soc);
 
void set_v_soc(float v_soc);
 
void set_averaged_soc(float averaged_soc);
 
void set_last_current(int32_t last_current);
 
uint32_t get_last_time(void);
 
float get_i_soc(void);
 
float get_v_soc(void);
 
float get_averaged_soc(void);
 
int32_t get_last_current(void);
 
float get_voltage_weight(void);
 
#endif