driver_ina219.h

Go to the documentation of this file.

 
#ifndef DRIVER_INA219_H
#define DRIVER_INA219_H
 
#include <stdio.h>
#include <stdint.h>
#include <string.h>
 
#ifdef __cplusplus
extern "C"{
#endif



typedef enum
{
    INA219_ADDRESS_0 = (0x40 << 1),        
    INA219_ADDRESS_1 = (0x41 << 1),        
    INA219_ADDRESS_2 = (0x42 << 1),        
    INA219_ADDRESS_3 = (0x43 << 1),        
    INA219_ADDRESS_4 = (0x44 << 1),        
    INA219_ADDRESS_5 = (0x45 << 1),        
    INA219_ADDRESS_6 = (0x46 << 1),        
    INA219_ADDRESS_7 = (0x47 << 1),        
    INA219_ADDRESS_8 = (0x48 << 1),        
    INA219_ADDRESS_9 = (0x49 << 1),        
    INA219_ADDRESS_A = (0x4A << 1),        
    INA219_ADDRESS_B = (0x4B << 1),        
    INA219_ADDRESS_C = (0x4C << 1),        
    INA219_ADDRESS_D = (0x4D << 1),        
    INA219_ADDRESS_E = (0x4E << 1),        
    INA219_ADDRESS_F = (0x4F << 1)         
} ina219_address_t;

typedef enum
{
    INA219_BUS_VOLTAGE_RANGE_16V = 0,        
    INA219_BUS_VOLTAGE_RANGE_32V = 1,        
} ina219_bus_voltage_range_t;

typedef enum
{
    INA219_PGA_40_MV  = 0,        
    INA219_PGA_80_MV  = 1,        
    INA219_PGA_160_MV = 2,        
    INA219_PGA_320_MV = 3,        
} ina219_pga_t;

typedef enum
{
    INA219_ADC_MODE_9_BIT_1_SAMPLES    = 0x0,        
    INA219_ADC_MODE_10_BIT_1_SAMPLES   = 0x1,        
    INA219_ADC_MODE_11_BIT_1_SAMPLES   = 0x2,        
    INA219_ADC_MODE_12_BIT_1_SAMPLES   = 0x3,        
    INA219_ADC_MODE_12_BIT_2_SAMPLES   = 0x9,        
    INA219_ADC_MODE_12_BIT_4_SAMPLES   = 0xA,        
    INA219_ADC_MODE_12_BIT_8_SAMPLES   = 0xB,        
    INA219_ADC_MODE_12_BIT_16_SAMPLES  = 0xC,        
    INA219_ADC_MODE_12_BIT_32_SAMPLES  = 0xD,        
    INA219_ADC_MODE_12_BIT_64_SAMPLES  = 0xE,        
    INA219_ADC_MODE_12_BIT_128_SAMPLES = 0xF,        
} ina219_adc_mode_t;

typedef enum
{
    INA219_MODE_POWER_DOWN                   = 0x0,        
    INA219_MODE_SHUNT_VOLTAGE_TRIGGERED      = 0x1,        
    INA219_MODE_BUS_VOLTAGE_TRIGGERED        = 0x2,        
    INA219_MODE_SHUNT_BUS_VOLTAGE_TRIGGERED  = 0x3,        
    INA219_MODE_ADC_OFF                      = 0x4,        
    INA219_MODE_SHUNT_VOLTAGE_CONTINUOUS     = 0x5,        
    INA219_MODE_BUS_VOLTAGE_CONTINUOUS       = 0x6,        
    INA219_MODE_SHUNT_BUS_VOLTAGE_CONTINUOUS = 0x7,        
} ina219_mode_t;

typedef struct ina219_handle_s
{
    uint8_t iic_addr;                                                                   
    uint8_t (*iic_init)(void);                                                          
    uint8_t (*iic_deinit)(void);                                                        
    uint8_t (*iic_read)(uint8_t addr, uint8_t reg, uint8_t *buf, uint16_t len);         
    uint8_t (*iic_write)(uint8_t addr, uint8_t reg, uint8_t *buf, uint16_t len);        
    void (*delay_ms)(uint32_t ms);                                                      
    void (*debug_print)(const char *const fmt, ...);                                    
    double r;                                                                           
    double current_lsb;                                                                 
    uint8_t inited;                                                                     
} ina219_handle_t;

typedef struct ina219_info_s
{
    char chip_name[32];                
    char manufacturer_name[32];        
    char interface[8];                 
    float supply_voltage_min_v;        
    float supply_voltage_max_v;        
    float max_current_ma;              
    float temperature_min;             
    float temperature_max;             
    uint32_t driver_version;           
} ina219_info_t;



#define DRIVER_INA219_LINK_INIT(HANDLE, STRUCTURE)   memset(HANDLE, 0, sizeof(STRUCTURE))

#define DRIVER_INA219_LINK_IIC_INIT(HANDLE, FUC)    (HANDLE)->iic_init = FUC

#define DRIVER_INA219_LINK_IIC_DEINIT(HANDLE, FUC)  (HANDLE)->iic_deinit = FUC

#define DRIVER_INA219_LINK_IIC_READ(HANDLE, FUC)    (HANDLE)->iic_read = FUC

#define DRIVER_INA219_LINK_IIC_WRITE(HANDLE, FUC)   (HANDLE)->iic_write = FUC

#define DRIVER_INA219_LINK_DELAY_MS(HANDLE, FUC)    (HANDLE)->delay_ms = FUC

#define DRIVER_INA219_LINK_DEBUG_PRINT(HANDLE, FUC) (HANDLE)->debug_print = FUC



uint8_t ina219_info(ina219_info_t *info);

uint8_t ina219_set_addr_pin(ina219_handle_t *handle, ina219_address_t addr_pin);

uint8_t ina219_get_addr_pin(ina219_handle_t *handle, ina219_address_t *addr_pin);

uint8_t ina219_set_resistance(ina219_handle_t *handle, double resistance);

uint8_t ina219_get_resistance(ina219_handle_t *handle, double *resistance);

uint8_t ina219_init(ina219_handle_t *handle);

uint8_t ina219_deinit(ina219_handle_t *handle);

uint8_t ina219_read_shunt_voltage(ina219_handle_t *handle, int16_t *raw, float *mV);

uint8_t ina219_read_bus_voltage(ina219_handle_t *handle, uint16_t *raw, float *mV);

uint8_t ina219_read_current(ina219_handle_t *handle, int16_t *raw, float *mA);

uint8_t ina219_read_power(ina219_handle_t *handle, uint16_t *raw, float *mW);

uint8_t ina219_soft_reset(ina219_handle_t *handle);

uint8_t ina219_set_bus_voltage_range(ina219_handle_t *handle, ina219_bus_voltage_range_t range);

uint8_t ina219_get_bus_voltage_range(ina219_handle_t *handle, ina219_bus_voltage_range_t *range);

uint8_t ina219_set_pga(ina219_handle_t *handle, ina219_pga_t pga);

uint8_t ina219_get_pga(ina219_handle_t *handle, ina219_pga_t *pga);

uint8_t ina219_set_bus_voltage_adc_mode(ina219_handle_t *handle, ina219_adc_mode_t mode);

uint8_t ina219_get_bus_voltage_adc_mode(ina219_handle_t *handle, ina219_adc_mode_t *mode);

uint8_t ina219_set_shunt_voltage_adc_mode(ina219_handle_t *handle, ina219_adc_mode_t mode);

uint8_t ina219_get_shunt_voltage_adc_mode(ina219_handle_t *handle, ina219_adc_mode_t *mode);

uint8_t ina219_set_mode(ina219_handle_t *handle, ina219_mode_t mode);

uint8_t ina219_get_mode(ina219_handle_t *handle, ina219_mode_t *mode);

uint8_t ina219_set_calibration(ina219_handle_t *handle, uint16_t data);

uint8_t ina219_get_calibration(ina219_handle_t *handle, uint16_t *data);

uint8_t ina219_calculate_calibration(ina219_handle_t *handle, uint16_t *calibration);



uint8_t ina219_set_reg(ina219_handle_t *handle, uint8_t reg, uint16_t data);

uint8_t ina219_get_reg(ina219_handle_t *handle, uint8_t reg, uint16_t *data);


 
#ifdef __cplusplus
}
#endif
 
#endif