battery.h

Go to the documentation of this file.

 
#ifndef BATTERY_H
#define BATTERY_H
 
#include <stdint.h>
 
#define BATT_CELL_DETECT_V   4.35f   
#define BATT_PRESENT_V       2.5f    
#define BATT_ABSENT_V        1.5f
#define BATT_LEVEL_MS        2000u   
#define BATT_RECOVER_MS      2000u   
#define BATT_RECOVER_HYST    0.05f   
#define BATT_RESERVE_SOC     0.20f   
#define BATT_R_CELL_DEFAULT  0.040f  
typedef struct {
    float   scale_v;       
    float   scale_i;       
    float   sens_v_per_a;  
    uint8_t has_current;   
} batt_cfg_t;
 
typedef struct {
    uint8_t  present;      
    uint8_t  cells;        
    uint8_t  level;        
    uint8_t  pct;          
    float    vbat;         
    float    current;      
    float    used_mah;     
    float    cell_v;       
    float    cell_rest_v;  
    float    r_cell;       
    float    soc;          
    float    remain_s;     
    float    vbat_raw;     
} batt_state_t;
 
typedef struct {
    float   warn, crit, emerg;   
    float   capacity_mah;        
    uint8_t cells;               
} batt_limits_t;
 
void batt_init(const batt_cfg_t *cfg);
void batt_set_scales(float scale_v, float scale_i);
void batt_get_cfg(batt_cfg_t *out);
 
void batt_step(float pin_v, float cur_pin_v, uint32_t dt_ms, uint8_t armed, const batt_limits_t *lim);
 
const batt_state_t *batt_state(void);
 
void batt_read(batt_state_t *out);
 
float batt_soc_from_ocv(float cell_v);
 
#endif /* BATTERY_H */