tmphm_sht45.h

Go to the documentation of this file.

#ifndef __TEMP_HUMP_23__
#define __TEMP_HUMP_23__
 
/*
 * MT 22.12.2025
 *
 * Temp&hum 23 click  SHT45.pdf   https://download.mikroe.com/documents/datasheets/SHT45-AD1B-R2_datasheet.pdf
 
 * I could have taken the library directly from https://github.com/MikroElektronika/mikrosdk_click_v2/blob/master/clicks/temphum23/lib_temphum23/src/temphum23.c
 * but there is a problem that I would need to pull in other modules, which would increase the program size
 * Therefore going the route of direct reading from I2C
 *
 * geminy:
 * https://gemini.google.com/share/b64c25662edf
 *
 * I2C address 0x44, or 0x45
 *
 * Sensor does not have option to separately turn on or off measurement, it turns on when reading data and turns off after measurement
 */
 
#include "mysensors_def.h"
 
#ifdef SENSOR_SHT45
 
#include "stm32wlxx_hal.h"
 
#pragma pack(1)
/**
 * @brief Measurement data produced by the SHT45 temperature and humidity sensor.
 *        Populate by calling tmphm_sht45_Read(); check IsDataValid before using
 *        Temperature or Humidity.
 */
typedef struct
{
    float Temperature; /**< Temperature in degrees Celsius */
    float Humidity;    /**< Relative humidity in percent (0–100 %) */
    int8_t IsDataValid; /**< 1 – values are valid; 0 – last read failed or not yet performed */
} tmphm_sht45_t;
#pragma pack()
/**
 * @brief Live measurement data from the SHT45 sensor; updated by tmphm_sht45_Read().
 */
extern tmphm_sht45_t _tmphm_sht45Data;
/**
 * @brief Snapshot copy of the last completed SHT45 measurement; used for LoRaWAN transmission.
 */
extern tmphm_sht45_t _bck_tmphm_sht45Data;
 
/**
 * @brief - check if tempHum sensor is present
 * @param tryInit - in case sensor is not yet initialized, 1 - attempt to initialize again, 0 - no
 * @retval 1 - is present, 0 - is not
 */
int8_t tmphm_sht45_Is(I2C_HandleTypeDef *hi2c, int8_t tryInit);
 
/**
 * @brief get state - sensor does not have on/off state - only for compatibility with others
 */
HAL_StatusTypeDef tmphm_sht45_IsOn(I2C_HandleTypeDef *hi2c, uint8_t *onOff);
 
/**
 * @brief Zapnutie sensora dummy
 */
HAL_StatusTypeDef tmphm_sht45_On(I2C_HandleTypeDef *hi2c);
 
/**
 * @brief turn off sensor - dummy
 */
HAL_StatusTypeDef tmphm_sht45_Off(I2C_HandleTypeDef *hi2c);
 
/**
 * @brief - initialization, check if sensor is present or not. Checks main (0x44) and alternative address (0x45)
 * If sensor is present, fnc tempHum_Is() returns 1
 * @retval - HAL_OK - sensor was found, HAL_ERROR - sensor is not present
 */
HAL_StatusTypeDef tmphm_sht45_Init(I2C_HandleTypeDef *hi2c);
 
/**
 * @brief - read temperature and humidity from sensor, values are in _tempHumData
 * @return -  HAL_OK, HAL_ERROR, HAL_TIMEOUT - if sensor is off
 */
HAL_StatusTypeDef tmphm_sht45_Read(I2C_HandleTypeDef *hi2c);
 
/**
 * @brief log data to buffer
 */
void tmphm_sht45_LogData(char* buf);
 
#endif
 
#endif