driver_hdc302x.h

Go to the documentation of this file.

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



typedef enum
{
    HDC302X_ADDRESS_00 = (0x44 << 1),        
    HDC302X_ADDRESS_01 = (0x46 << 1),        
    HDC302X_ADDRESS_10 = (0x45 << 1),        
    HDC302X_ADDRESS_11 = (0x47 << 1),        
} hdc302x_address_t;

typedef enum
{
    HDC302X_LOW_POWER_MODE_0 = 0,        
    HDC302X_LOW_POWER_MODE_1 = 1,        
    HDC302X_LOW_POWER_MODE_2 = 2,        
    HDC302X_LOW_POWER_MODE_3 = 3,        
} hdc302x_low_power_mode_t;

typedef enum
{
    HDC302X_AUTO_MODE_0P5_HZ = 0,        
    HDC302X_AUTO_MODE_1_HZ   = 1,        
    HDC302X_AUTO_MODE_2_HZ   = 2,        
    HDC302X_AUTO_MODE_4_HZ   = 3,        
    HDC302X_AUTO_MODE_10_HZ  = 4,        
} hdc302x_auto_mode_t;

typedef enum
{
    HDC302X_STATUS_OVERALL_ALERT          = (1 << 15),        
    HDC302X_STATUS_HEATER                 = (1 << 13),        
    HDC302X_STATUS_RH_TRACKING_ALERT      = (1 << 11),        
    HDC302X_STATUS_T_TRACKING_ALERT       = (1 << 10),        
    HDC302X_STATUS_RH_HIGH_TRACKING_ALERT = (1 << 9),         
    HDC302X_STATUS_RH_LOW_TRACKING_ALERT  = (1 << 8),         
    HDC302X_STATUS_T_HIGH_TRACKING_ALERT  = (1 << 7),         
    HDC302X_STATUS_T_LOW_TRACKING_ALERT   = (1 << 6),         
    HDC302X_STATUS_DEVICE_RESET_DETECTED  = (1 << 4),         
    HDC302X_STATUS_CHECKSUM_VERY          = (1 << 0),         
} hdc302x_status_t;

typedef struct hdc302x_handle_s
{
    uint8_t (*iic_init)(void);                                                                     
    uint8_t (*iic_deinit)(void);                                                                   
    uint8_t (*iic_read_address16)(uint8_t addr, uint16_t reg, uint8_t *buf, uint16_t len);         
    uint8_t (*iic_write_address16)(uint8_t addr, uint16_t reg, uint8_t *buf, uint16_t len);        
    void (*receive_callback)(uint16_t type);                                                       
    void (*delay_ms)(uint32_t ms);                                                                 
    void (*debug_print)(const char *const fmt, ...);                                               
    uint8_t iic_addr;                                                                              
    uint8_t inited;                                                                                
    uint8_t low_power_mode;                                                                        
    uint8_t auto_mode;                                                                             
    uint8_t mode;                                                                                  
} hdc302x_handle_t;

typedef struct hdc302x_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;           
} hdc302x_info_t;



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

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

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

#define DRIVER_HDC302X_LINK_IIC_READ_ADDRESS16(HANDLE, FUC)         (HANDLE)->iic_read_address16 = FUC

#define DRIVER_HDC302X_LINK_IIC_WRITE_ADDRESS16(HANDLE, FUC)        (HANDLE)->iic_write_address16 = FUC

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

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

#define DRIVER_HDC302X_LINK_RECEIVE_CALLBACK(HANDLE, FUC)           (HANDLE)->receive_callback = FUC



uint8_t hdc302x_info(hdc302x_info_t *info);

uint8_t hdc302x_set_addr(hdc302x_handle_t *handle, hdc302x_address_t addr);

uint8_t hdc302x_get_addr(hdc302x_handle_t *handle, hdc302x_address_t *addr);

uint8_t hdc302x_irq_handler(hdc302x_handle_t *handle);

uint8_t hdc302x_init(hdc302x_handle_t *handle);

uint8_t hdc302x_deinit(hdc302x_handle_t *handle);

uint8_t hdc302x_set_low_power_mode(hdc302x_handle_t *handle, hdc302x_low_power_mode_t mode);

uint8_t hdc302x_get_low_power_mode(hdc302x_handle_t *handle, hdc302x_low_power_mode_t *mode);

uint8_t hdc302x_set_auto_mode(hdc302x_handle_t *handle, hdc302x_auto_mode_t mode);

uint8_t hdc302x_get_auto_mode(hdc302x_handle_t *handle, hdc302x_auto_mode_t *mode);

uint8_t hdc302x_soft_reset(hdc302x_handle_t *handle);

uint8_t hdc302x_single_read(hdc302x_handle_t *handle, uint16_t *temperature_raw, float *temperature_s,
                            uint16_t *humidity_raw, float *humidity_s);

uint8_t hdc302x_start_continuous_read(hdc302x_handle_t *handle);

uint8_t hdc302x_stop_continuous_read(hdc302x_handle_t *handle);

uint8_t hdc302x_continuous_read(hdc302x_handle_t *handle, uint16_t *temperature_raw, float *temperature_s,
                                uint16_t *humidity_raw, float *humidity_s);

uint8_t hdc302x_continuous_read_humidity(hdc302x_handle_t *handle, uint16_t *humidity_raw, float *humidity_s);

uint8_t hdc302x_read_temperature_min(hdc302x_handle_t *handle, uint16_t *temperature_raw, float *temperature_s);

uint8_t hdc302x_read_temperature_max(hdc302x_handle_t *handle, uint16_t *temperature_raw, float *temperature_s);

uint8_t hdc302x_read_humidity_min(hdc302x_handle_t *handle, uint16_t *humidity_raw, float *humidity_s);

uint8_t hdc302x_read_humidity_max(hdc302x_handle_t *handle, uint16_t *humidity_raw, float *humidity_s);

uint8_t hdc302x_write_set_low_alert(hdc302x_handle_t *handle, uint16_t threshold);

uint8_t hdc302x_write_clear_low_alert(hdc302x_handle_t *handle, uint16_t threshold);

uint8_t hdc302x_write_set_high_alert(hdc302x_handle_t *handle, uint16_t threshold);

uint8_t hdc302x_write_clear_high_alert(hdc302x_handle_t *handle, uint16_t threshold);

uint8_t hdc302x_read_set_low_alert(hdc302x_handle_t *handle, uint16_t *threshold);

uint8_t hdc302x_read_set_high_alert(hdc302x_handle_t *handle, uint16_t *threshold);

uint8_t hdc302x_read_clear_low_alert(hdc302x_handle_t *handle, uint16_t *threshold);

uint8_t hdc302x_read_clear_high_alert(hdc302x_handle_t *handle, uint16_t *threshold);

uint8_t hdc302x_enable_heater(hdc302x_handle_t *handle);

uint8_t hdc302x_disable_heater(hdc302x_handle_t *handle);

uint8_t hdc302x_set_heater_power(hdc302x_handle_t *handle, uint16_t power);

uint8_t hdc302x_get_heater_power(hdc302x_handle_t *handle, uint16_t *power);

uint8_t hdc302x_get_nist_id(hdc302x_handle_t *handle, uint8_t id[6]);

uint8_t hdc302x_get_status(hdc302x_handle_t *handle, uint16_t *status);

uint8_t hdc302x_clear_status(hdc302x_handle_t *handle);

uint8_t hdc302x_nvm_program_alert_threshold(hdc302x_handle_t *handle);

uint8_t hdc302x_nvm_program_temperature_humidity_offset(hdc302x_handle_t *handle, uint16_t offset);

uint8_t hdc302x_nvm_read_temperature_humidity_offset(hdc302x_handle_t *handle, uint16_t *offset);

uint8_t hdc302x_nvm_program_config(hdc302x_handle_t *handle, uint16_t config);

uint8_t hdc302x_nvm_read_config(hdc302x_handle_t *handle, uint16_t *config);

uint8_t hdc302x_alert_threshold_convert_to_register(hdc302x_handle_t *handle, float temperature_deg, 
                                                    float humidity_percentage, uint16_t *reg);

uint8_t hdc302x_alert_threshold_convert_to_data(hdc302x_handle_t *handle, uint16_t reg,
                                                float *temperature_deg, float *humidity_percentage);

uint8_t hdc302x_offset_convert_to_register(hdc302x_handle_t *handle, uint8_t temperature_symbol, float temperature_deg,
                                           uint8_t humidity_symbol, float humidity_percentage, uint16_t *reg);

uint8_t hdc302x_offset_convert_to_data(hdc302x_handle_t *handle, uint16_t reg,
                                       uint8_t *temperature_symbol, float *temperature_deg,
                                       uint8_t *humidity_symbol, float *humidity_percentage);



uint8_t hdc302x_set_reg(hdc302x_handle_t *handle, uint16_t command, uint8_t *buf, uint16_t len);

uint8_t hdc302x_get_reg(hdc302x_handle_t *handle, uint16_t command, uint8_t *buf, uint16_t len);


 
#ifdef __cplusplus
}
#endif
 
#endif