bar_bmp585.h

Go to the documentation of this file.

/*
 * bar_bmp585.h
 *
 * The processing of barometer sensor BMP585
 *  Created on: 16. 2. 2026
 *      Author: Milan
 *
 * Barometer sensor BMP585, datasheet datasheets/V1/Bar_bst-bmp585-ds003.pdf
 *       BMP585 from Bosch Sensortec
 *
 * The sensor needs to be explicitly turned on and then off to save power consumption
 *
 */
 
#ifndef INC_BAR_BMP585_H_
#define INC_BAR_BMP585_H_
 
#include "mysensors_def.h"
 
#ifdef SENSOR_BAR_BMP585
 
#include "stm32wlxx_hal.h"
 
#pragma pack(1)
/**
 * @brief Measurement data produced by the BMP585 barometric pressure sensor.
 *        Populated by bar_bmp585_Read(); check IsDataValid before use.
 */
typedef struct
{
    float PressureABS;  /**< Absolute atmospheric pressure in hPa */
    float PressureSEA;  /**< Pressure corrected to sea level in hPa (requires SHT45 temperature and configured altitude) */
    float Temperature;  /**< Temperature measured by the BMP585 sensor in degrees Celsius */
    int8_t IsDataValid; /**< 1 – values are valid; 0 – last read failed or sensor not ready */
} bar_bmp585_t;
#pragma pack()
 
/**
 * @brief Live measurement data from the BMP585 sensor; updated by bar_bmp585_Read().
 */
extern bar_bmp585_t _bar_bmp585Data;
/**
 * @brief Snapshot copy of the last completed BMP585 measurement; used for LoRaWAN transmission.
 */
extern bar_bmp585_t _bck_bar_bmp585Data;
 
/**
 * @brief Check if sensor is present
 * @param hi2c - I2C handle
 * @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 bar_bmp585_Is(I2C_HandleTypeDef *hi2c, int8_t tryInit);
 
/**
 * @brief Initialize sensor, check if it really is this sensor. After check the sensor is turned off to save power
 * @param hi2c - I2C handle
 * @retval HAL_OK, HAL_ERROR
 */
HAL_StatusTypeDef bar_bmp585_Init(I2C_HandleTypeDef *hi2c);
 
/**
 * @brief Turn on sensor - wakeup the sensor and start to processing of pressure measure
 * @param hi2c - I2C handle
 * @retval HAL_OK, HAL_ERROR
 */
HAL_StatusTypeDef bar_bmp585_On(I2C_HandleTypeDef *hi2c);
 
/**
 * @brief Turn off sensor - stop measure and put sensor in very deep sleep mode
 * @param hi2c - I2C handle
 * @retval HAL_OK, HAL_ERROR
 */
HAL_StatusTypeDef bar_bmp585_Off(I2C_HandleTypeDef *hi2c);
 
/**
 * @brief Read value from sensor, pressure and temperature.
 * Sensor must be turned on before
 * @param hi2c - I2C handle
 * @retval
 *  HAL_OK - have data,
 *  HAL_BUSY - next reading in progress,
 *  HAL_TIMEOUT - sensor is not turned on
 *  HAL_ERROR - error
 */
HAL_StatusTypeDef bar_bmp585_Read(I2C_HandleTypeDef *hi2c);
 
/**
 * @brief Log data to buffer
 * @param buf - buffer to log data to
 */
void bar_bmp585_LogData(char* buf);
 
#endif
 
#endif /* INC_BAR_BMP585_H_ */