driver_sht30.h

Go to the documentation of this file.

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



typedef enum
{
    SHT30_ADDRESS_0 = (0x44 << 1),        
    SHT30_ADDRESS_1 = (0x45 << 1),        
} sht30_address_t;

typedef enum
{
    SHT30_BOOL_FALSE = 0x00,        
    SHT30_BOOL_TRUE  = 0x01,        
} sht30_bool_t;

typedef enum
{
    SHT30_RATE_0P5HZ = 0x20,        
    SHT30_RATE_1HZ   = 0x21,        
    SHT30_RATE_2HZ   = 0x22,        
    SHT30_RATE_4HZ   = 0x23,        
    SHT30_RATE_10HZ  = 0x27,        
} sht30_rate_t;

typedef enum  
{
    SHT30_REPEATABILITY_HIGH   = 0x00,        
    SHT30_REPEATABILITY_MEDIUM = 0x01,        
    SHT30_REPEATABILITY_LOW    = 0x02,        
} sht30_repeatability_t;

typedef enum  
{
    SHT30_STATUS_ALERT_PENDING_STATUS = (1 << 15),        
    SHT30_STATUS_HEATER_ON            = (1 << 13),        
    SHT30_STATUS_HUMIDITY_ALERT       = (1 << 11),        
    SHT30_STATUS_TEMPERATURE_ALERT    = (1 << 10),        
    SHT30_STATUS_SYSTEM_RESET         = (1 << 4),         
    SHT30_STATUS_COMMAND_STATUS       = (1 << 1),         
    SHT30_STATUS_CHECKSUM_STATUS      = (1 << 0),         
} sht30_status_t;

typedef struct sht30_handle_s
{
    uint8_t (*iic_init)(void);                                                                     
    uint8_t (*iic_deinit)(void);                                                                   
    uint8_t (*iic_write_address16)(uint8_t addr, uint16_t reg, uint8_t *buf, uint16_t len);        
    uint8_t (*iic_read_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 repeatability;                                                                         
    uint8_t inited;                                                                                
} sht30_handle_t;

typedef struct sht30_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;           
} sht30_info_t;



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

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

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

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

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

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

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

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



uint8_t sht30_info(sht30_info_t *info);

uint8_t sht30_set_addr_pin(sht30_handle_t *handle, sht30_address_t addr_pin);

uint8_t sht30_get_addr_pin(sht30_handle_t *handle, sht30_address_t *addr_pin);

uint8_t sht30_irq_handler(sht30_handle_t *handle);

uint8_t sht30_init(sht30_handle_t *handle);

uint8_t sht30_deinit(sht30_handle_t *handle);

uint8_t sht30_single_read(sht30_handle_t *handle, sht30_bool_t clock_stretching_enable, 
                          uint16_t *temperature_raw, float *temperature_s,
                          uint16_t *humidity_raw, float *humidity_s
                         );

uint8_t sht30_start_continuous_read(sht30_handle_t *handle, sht30_rate_t rate);

uint8_t sht30_stop_continuous_read(sht30_handle_t *handle);

uint8_t sht30_continuous_read(sht30_handle_t *handle, 
                              uint16_t *temperature_raw, float *temperature_s, 
                              uint16_t *humidity_raw, float *humidity_s);

uint8_t sht30_get_status(sht30_handle_t *handle, uint16_t *status);

uint8_t sht30_clear_status(sht30_handle_t *handle);

uint8_t sht30_set_repeatability(sht30_handle_t *handle, sht30_repeatability_t repeatability);

uint8_t sht30_get_repeatability(sht30_handle_t *handle, sht30_repeatability_t *repeatability);

uint8_t sht30_set_art(sht30_handle_t *handle);

uint8_t sht30_soft_reset(sht30_handle_t *handle);

uint8_t sht30_set_heater(sht30_handle_t *handle, sht30_bool_t enable);

uint8_t sht30_get_serial_number(sht30_handle_t *handle, uint8_t sn[4]);

uint8_t sht30_set_high_alert_limit(sht30_handle_t *handle, uint16_t set, uint16_t clear);

uint8_t sht30_get_high_alert_limit(sht30_handle_t *handle, uint16_t *set, uint16_t *clear);

uint8_t sht30_set_low_alert_limit(sht30_handle_t *handle, uint16_t set, uint16_t clear);

uint8_t sht30_get_low_alert_limit(sht30_handle_t *handle, uint16_t *set, uint16_t *clear);

uint8_t sht30_alert_limit_convert_to_register(sht30_handle_t *handle, float temperature, float humidity, uint16_t *reg);



uint8_t sht30_set_reg(sht30_handle_t *handle, uint16_t command);

uint8_t sht30_get_reg(sht30_handle_t *handle, uint16_t command, uint8_t *buf, uint16_t len);


 
#ifdef __cplusplus
}
#endif
 
#endif