/** * @author Tilen MAJERLE * @email tilen@majerle.eu * @website http://stm32f4-discovery.net * @link http://stm32f4-discovery.net/2014/09/library-37-bmp180-pressure-sensor-stm32f4 * @version v1.0 * @ide Keil uVision * @license GNU GPL v3 * @brief BMP180 pressure sensor library for STM32F4xx * @verbatim ---------------------------------------------------------------------- Copyright (C) 2020 Tilen MAJERLE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . ---------------------------------------------------------------------- @endverbatim */ #ifndef TM_BMP180_H #define TM_BMP180_H 100 /* C++ detection */ #ifdef __cplusplus extern "C" { #endif /** * @addtogroup TM_STM32F4xx_Libraries * @{ */ /** * @defgroup TM_BMP180 * @brief BMP180 pressure sensor library for STM32F4xx - http://stm32f4-discovery.net/2014/09/library-37-bmp180-pressure-sensor-stm32f4 * @{ * * You can read temperature and pressure with this sensor. * * \par Reading procedure * * First you need to read temperature, then you are able to read pressure. * This is quite inefficient, because you can not read both at the same time. * * @note Sensor uses the same register for data for temperature and pressure. * This is not good, but it can be used in various small projects. * * \par Default pinout * @verbatim BMP180 STM32F4 DESCRIPTION SCL PA8 I2C3 Serial clock SDA PC9 I2C3 Serial data @endverbatim * * @warning Make sure, that you connect VCC to 3.3V and not to 5V, because you can blow device. * * \par Custom I2C settings * * If you want to change default I2C settings, open defines.h file and edit lines below: * @verbatim //Select custom I2C #define BMP180_I2C I2C3 #define BMP180_I2C_PINSPACK TM_I2C_PinsPack_1 @endverbatim * * \par PAW library dependence * * calculation of Altitude and PressureAtSeaLevel require paw library. If you not need one parameters, open defines.h file and edit lines below: * @verbatim //Select PAW library dependence #define BMP180_USE_ALTITUDE 0 @endverbatim * * \par Changelog * @verbatim Version 1.0 - First release @endverbatim * * \par Dependencies * @verbatim - STM32F4xx - STM32F4xx RCC - defines.h - TM I2C - math.h @endverbatim */ #include "stm32f4xx_hal.h" #include "stm32f4xx_hal_rcc.h" #include "defines.h" #include "tm_stm32_i2c.h" #include "math.h" /** * @defgroup TM_BMP180_Macros * @brief Library defines * @{ */ /* Default I2C pin */ #ifndef BMP180_I2C #define BMP180_I2C I2C3 #define BMP180_I2C_PINSPACK TM_I2C_PinsPack_1 #endif /* Default I2C speed */ #ifndef BMP180_I2C_SPEED #define BMP180_I2C_SPEED 100000 #endif /* BMP180 I2C address */ #ifndef BMP180_I2C_ADDRESS #define BMP180_I2C_ADDRESS 0xEE #endif /* Registers */ #define BMP180_REGISTER_CONTROL 0xF4 #define BMP180_REGISTER_RESULT 0xF6 #define BMP180_REGISTER_EEPROM 0xAA /* Commands */ #define BMP180_COMMAND_TEMPERATURE 0x2E #define BMP180_COMMAND_PRESSURE_0 0x34 #define BMP180_COMMAND_PRESSURE_1 0x74 #define BMP180_COMMAND_PRESSURE_2 0xB4 #define BMP180_COMMAND_PRESSURE_3 0xF4 /* Minimum waiting delay, in microseconds */ #define BMP180_TEMPERATURE_DELAY 4500 #define BMP180_PRESSURE_0_DELAY 4500 #define BMP180_PRESSURE_1_DELAY 7500 #define BMP180_PRESSURE_2_DELAY 13000 #define BMP180_PRESSURE_3_DELAY 25000 /** * @} */ /** * @defgroup TM_BMP180_Typedefs * @brief Library Typedefs * @{ */ /** * @brief BMP180 result enumerations */ typedef enum { TM_BMP180_Result_Ok = 0x00, /*!< Everything OK */ TM_BMP180_Result_DeviceNotConnected, /*!< Device is not connected to I2C */ TM_BMP180_Result_LibraryNotInitialized /*!< Library is not initialized */ , TM_BMP180_Result_Fail } TM_BMP180_Result_t; /** * @brief Options for oversampling settings * @note This settings differs in samples for one result * and sample time for one result */ typedef enum { TM_BMP180_Oversampling_UltraLowPower = 0x00, /*!< 1 sample for result */ TM_BMP180_Oversampling_Standard = 0x01, /*!< 2 samples for result */ TM_BMP180_Oversampling_HighResolution = 0x02, /*!< 3 samples for result */ TM_BMP180_Oversampling_UltraHighResolution = 0x03 /*!< 4 samples for result */ } TM_BMP180_Oversampling_t; /** * @brief BMP180 main structure */ typedef struct { float Altitude; /*!< Calculated altitude at given read pressure */ uint32_t Pressure; /*!< Pressure in pascals */ float Temperature; /*!< Temperature in degrees */ uint16_t Delay; /*!< Number of microseconds, that sensor needs to calculate data that you request to */ TM_BMP180_Oversampling_t Oversampling; /*!< Oversampling for pressure calculation */ } TM_BMP180_t; /** * @} */ /** * @defgroup TM_BMP180_Functions * @brief Library Functions * @{ */ /** * @brief Initializes BMP180 pressure sensor * @param *BMP180_Data: Pointer to @ref TM_BMP180_t structure * @retval Member of @ref TM_BMP180_Result_t */ TM_BMP180_Result_t TM_BMP180_Init(TM_BMP180_t* BMP180_Data); /** * @brief Starts temperature sensor on BMP180 * @param *BMP180_Data: Pointer to @ref TM_BMP180_t structure * @retval Member of @ref TM_BMP180_Result_t */ TM_BMP180_Result_t TM_BMP180_StartTemperature(TM_BMP180_t* BMP180_Data); /** * @brief Reads temperature from BMP180 sensor * @note Temperature has 0.1 degrees Celcius resolution * @param *BMP180_Data: Pointer to @ref TM_BMP180_t structure * @retval Member of @ref TM_BMP180_Result_t */ TM_BMP180_Result_t TM_BMP180_ReadTemperature(TM_BMP180_t* BMP180_Data); /** * @brief Starts pressure measurement on BMP180 sensor * @param *BMP180_Data: Pointer to @ref TM_BMP180_t structure * @param Oversampling: Oversampling option for pressure calculation. * This parameter can be a value of @ref TM_BMP180_Oversampling_t enumeration * @note Calculation time depends on selected oversampling * @retval Member of @ref TM_BMP180_Result_t */ TM_BMP180_Result_t TM_BMP180_StartPressure(TM_BMP180_t* BMP180_Data, TM_BMP180_Oversampling_t Oversampling); /** * @brief Reads pressure from BMP180 sensor and calculate it * @param *BMP180_Data: Pointer to @ref TM_BMP180_t structure * @retval Member of @ref TM_BMP180_Result_t */ TM_BMP180_Result_t TM_BMP180_ReadPressure(TM_BMP180_t* BMP180_Data); /** * @brief Calculates pressure above sea level in pascals * * This is good, if you read pressure from sensor at known altitude, not altitude provided from sensor. * Altitude from sensor is calculated in fact, that pressure above the sea is 101325 Pascals. * So, if you know your pressure, and you use calculated altitude, you will not get real pressure above the sea. * * @warning You need calculated pressure from sensor, and known altitude (from other sensor or GPS data, or whatever) * and then you are able to calculate pressure above the sea level. * @param pressure: Pressure at known altitude in units of pascals * @param altitude: Known altitude in units of meters * @retval Pressure above the sea in units of pascals */ uint32_t TM_BMP180_GetPressureAtSeaLevel(uint32_t pressure, float altitude); /** * @} */ /** * @} */ /** * @} */ /* C++ detection */ #ifdef __cplusplus } #endif #endif