supply.h

Go to the documentation of this file.

 
#ifndef RCBENCH_SUPPLY_H
#define RCBENCH_SUPPLY_H
 
#include <stdbool.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif

typedef struct {
    float v_min,                            
          v_max,                            
          v_step;                           
    float i_min,                            
          i_max,                            
          i_step;                           
} supply_caps_t;

#define SUPPLY_CAPS_PPS_DEFAULT { 3.3f, 21.0f, 0.02f, 0.5f, 5.0f, 0.05f }

typedef enum {
    SUPPLY_MODE_OFF = 0,   
    SUPPLY_MODE_CV,        
    SUPPLY_MODE_CC,        
} supply_mode_t;

#define SUPPLY_OK_VOLTAGE 0x01u
#define SUPPLY_OK_CURRENT 0x02u

typedef struct {
    float         set_v;      
    float         set_i;      
    float         v;          
    float         i;          
    float         p;          
    supply_mode_t mode;                 
    bool          output;     
    bool          online;     
    bool          modelled;   
    uint8_t       ok;         
    uint8_t       trip;
    uint16_t      samples;
    uint32_t      taken_ms;
    bool          stamped;    
 
    /* The run's extremes, from the output's switch-on: how far the voltage
     * sagged, and the most current and power it gave. */
    float         v_min;
    float         i_max;
    float         p_max;
    bool          sag_seeded; 
 
    /* What the run delivered, counted by the panel (supply_count_totals). */
    float         charge_mah;
    float         energy_wh;
    uint8_t       counted;    
} supply_state_t;

typedef struct {
    float v_max;          
    float i_max;          
    float trip_i;         
    float trip_v;         
    float trip_s;         
} supply_limits_t;

supply_caps_t supply_caps_limited(const supply_caps_t *caps,
                                  const supply_limits_t *lim);

typedef enum {
    SUPPLY_TRIP_NONE = 0,
    SUPPLY_TRIP_CURRENT,
    SUPPLY_TRIP_VOLTAGE,
} supply_trip_kind_t;

typedef struct {
    float over_i_s;
    float over_v_s;
    bool  i_over;         
    bool  v_over;         
    float i_at;           
    float v_at;           
} supply_trip_t;

void supply_trip_reset(supply_trip_t *t);

supply_trip_kind_t supply_trip_step(supply_trip_t *t,
                                    const supply_limits_t *lim,
                                    const supply_state_t *s, float dt_s);

float supply_snap(float value, float min, float max, float step);

void supply_reset_peaks(supply_state_t *s);

void supply_track_peaks(supply_state_t *s);

void supply_reset_totals(supply_state_t *s);

void supply_count_totals(supply_state_t *s, float dt_s);
 
/* ---------------------------------------------------------------- model */

#define SUPPLY_SIM_LOAD_OHMS  6.0f
#define SUPPLY_SIM_PERIOD_S   3.0f
#define SUPPLY_SIM_BURST_S    0.6f
#define SUPPLY_SIM_BURST_A    1.4f
#define SUPPLY_SIM_SOURCE_OHMS 0.05f

typedef struct {
    supply_caps_t caps;
    float         t;          
    float set_v,                            
          set_i;                            
    bool          output;               
} supply_sim_t;

void supply_sim_init(supply_sim_t *m);
void supply_sim_set(supply_sim_t *m, float v, float i);
void supply_sim_output(supply_sim_t *m, bool on);
void supply_sim_step(supply_sim_t *m, float dt_s, supply_state_t *out);
 
#ifdef __cplusplus
}
#endif
 
#endif /* RCBENCH_SUPPLY_H */