driver_sts21.h

Go to the documentation of this file.

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



typedef enum
{
    STS21_BOOL_FALSE = 0x00,        
    STS21_BOOL_TRUE  = 0x01,        
} sts21_bool_t;

typedef enum  
{
    SHT35_STATUS_VDD_OVER_2P25V = 0,        
    SHT35_STATUS_VDD_LESS_2P25V = 1,        
} sts21_status_t;

typedef enum
{
    STS21_MODE_HOLD_MASTER    = 0x00,        
    STS21_MODE_NO_HOLD_MASTER = 0x01,        
} sts21_mode_t;

typedef enum  
{
    STS21_RESOLUTION_T_14BIT = 0x00,        
    STS21_RESOLUTION_T_12BIT  = 0x01,        
    STS21_RESOLUTION_T_13BIT = 0x02,        
    STS21_RESOLUTION_T_11BIT = 0x03,        
} sts21_resolution_t;

typedef struct sts21_handle_s
{
    uint8_t (*iic_init)(void);                                                                     
    uint8_t (*iic_deinit)(void);                                                                   
    uint8_t (*iic_write_cmd)(uint8_t addr, uint8_t *buf, uint16_t len);                            
    uint8_t (*iic_write)(uint8_t addr, uint8_t reg, uint8_t *buf, uint16_t len);                   
    uint8_t (*iic_read_cmd)(uint8_t addr, uint8_t *buf, uint16_t len);                             
    uint8_t (*iic_read)(uint8_t addr, uint8_t reg, uint8_t *buf, uint16_t len);                    
    uint8_t (*iic_read_with_wait)(uint8_t addr, uint8_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 (*delay_ms)(uint32_t ms);                                                                 
    void (*debug_print)(const char *const fmt, ...);                                               
    uint8_t resolution;                                                                            
    uint8_t mode;                                                                                  
    uint8_t inited;                                                                                
} sts21_handle_t;

typedef struct sts21_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;           
} sts21_info_t;



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

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

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

#define DRIVER_STS21_LINK_IIC_WRITE_COMMAND(HANDLE, FUC)     (HANDLE)->iic_write_cmd = FUC

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

#define DRIVER_STS21_LINK_IIC_READ_COMMAND(HANDLE, FUC)      (HANDLE)->iic_read_cmd = FUC

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

#define DRIVER_STS21_LINK_IIC_READ_WITH_WAIT(HANDLE, FUC)    (HANDLE)->iic_read_with_wait = FUC

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

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

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



uint8_t sts21_info(sts21_info_t *info);

uint8_t sts21_init(sts21_handle_t *handle);

uint8_t sts21_deinit(sts21_handle_t *handle);

uint8_t sts21_read(sts21_handle_t *handle, uint16_t *temperature_raw, float *temperature_s);

uint8_t sts21_set_mode(sts21_handle_t *handle, sts21_mode_t mode);

uint8_t sts21_get_mode(sts21_handle_t *handle, sts21_mode_t *mode);

uint8_t sts21_soft_reset(sts21_handle_t *handle);

uint8_t sts21_set_resolution(sts21_handle_t *handle, sts21_resolution_t resolution);

uint8_t sts21_get_resolution(sts21_handle_t *handle, sts21_resolution_t *resolution);

uint8_t sts21_set_heater(sts21_handle_t *handle, sts21_bool_t enable);

uint8_t sts21_get_heater(sts21_handle_t *handle, sts21_bool_t *enable);

uint8_t sts21_set_disable_otp_reload(sts21_handle_t *handle, sts21_bool_t enable);

uint8_t sts21_get_disable_otp_reload(sts21_handle_t *handle, sts21_bool_t *enable);

uint8_t sts21_get_status(sts21_handle_t *handle, sts21_status_t *status);

uint8_t sts21_get_serial_number(sts21_handle_t *handle, uint8_t sn[8]);



uint8_t sts21_set_reg(sts21_handle_t *handle, uint8_t reg, uint8_t *data, uint16_t len);

uint8_t sts21_get_reg(sts21_handle_t *handle, uint8_t reg, uint8_t *data, uint16_t len);

uint8_t sts21_get_reg16(sts21_handle_t *handle, uint16_t reg, uint8_t *data, uint16_t len);

uint8_t sts21_set_cmd(sts21_handle_t *handle, uint8_t *data, uint16_t len);

uint8_t sts21_get_cmd(sts21_handle_t *handle, uint8_t *data, uint16_t len);


 
#ifdef __cplusplus
}
#endif
 
#endif