Files
zh_aht/include/zh_aht.h
T

74 lines
1.8 KiB
C

/**
* @file zh_aht.h
*/
#pragma once
#include "esp_err.h"
#include "esp_log.h"
#ifdef CONFIG_IDF_TARGET_ESP8266
#include "driver/i2c.h"
#else
#include "driver/i2c_master.h"
#endif
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
/**
* @brief AHT sensor initial default values.
*/
#define ZH_AHT_INIT_CONFIG_DEFAULT() \
{ \
.i2c_port = 0}
#ifdef __cplusplus
extern "C"
{
#endif
/**
* @brief Structure for initial initialization of AHT sensor.
*/
typedef struct
{
bool i2c_port; /*!< I2C port. */
#ifndef CONFIG_IDF_TARGET_ESP8266
i2c_master_bus_handle_t i2c_handle; /*!< Unique I2C bus handle. */
#endif
} zh_aht_init_config_t;
/**
* @brief Initialize AHT sensor.
*
* @param[in] config Pointer to AHT initialized configuration structure. Can point to a temporary variable.
*
* @attention I2C driver must be initialized first.
*
* @note Before initialize the sensor recommend initialize zh_aht_init_config_t structure with default values.
*
* @code zh_aht_init_config_t config = ZH_AHT_INIT_CONFIG_DEFAULT() @endcode
*
* @return ESP_OK if success or an error code otherwise.
*/
esp_err_t zh_aht_init(const zh_aht_init_config_t *config);
/**
* @brief Read AHT sensor.
*
* @param[out] humidity Pointer for AHT sensor reading data of humidity.
* @param[out] temperature Pointer for AHT sensor reading data of temperature.
*
* @return ESP_OK if success or an error code otherwise.
*/
esp_err_t zh_aht_read(float *humidity, float *temperature);
/**
* @brief Reset AHT sensor.
*
* @return ESP_OK if success or an error code otherwise.
*/
esp_err_t zh_aht_reset(void);
#ifdef __cplusplus
}
#endif