bar_ils22qs.c

Go to the documentation of this file.

/*
 * bar_ils22qs.c
 *
 *  Created on: 27. 12. 2025
 *      Author: Milan
 */
 
#include "bar_ils22qs.h"
 
#ifdef SENSOR_BAR_ILS22QS
 
#include "i2c.h"
#include "utils/mydefs.h"
#include "mymems.h"
#include "mysensors_base.h"
#include <stdio.h>
#include <math.h>
#include "tmphm_sht45.h"    // because of formula to see low level
 
// ILPS22QS I2C Address (SDO connected to GND by default on Barometer 8 Click)
#define ILPS22QS_I2C_ADDR    (0x5C << 1)
 
// Register Map
#define REG_WHO_AM_I         0x0F
#define REG_CTRL_REG1        0x10
#define REG_PRESS_OUT_XL     0x28
#define REG_PRESS_OFFSET     0x1A   // MT 10.1.2026 factory offset
// Device ID
#define ILPS22QS_ID          0xB4
 
bar_ils22qs_t _bar_ils22qsData = {};
bar_ils22qs_t _bck_bar_ils22qsData = {};    // backup
static uint8_t _isBarometer = 0;
 
static HAL_StatusTypeDef bar_ils22qs_IsOn(I2C_HandleTypeDef *hi2c, uint8_t *onOff)
{
    HAL_StatusTypeDef status = HAL_ERROR;
 
    if (_isBarometer)
    {
        // reading CTRL_REG1
        uint8_t ctrl1 = 0x00;
        status = HAL_I2C_Mem_Read(hi2c, ILPS22QS_I2C_ADDR, REG_CTRL_REG1, 1, &ctrl1, 1, 100);
        if (status == HAL_OK)
            if (onOff != 0)
                *onOff = ((ctrl1 & 0x50) != 0);
    }
    return status;
 
}
 
static HAL_StatusTypeDef barometer_onOff(I2C_HandleTypeDef *hi2c, uint8_t onOff)
{
    HAL_StatusTypeDef status = HAL_ERROR;
 
    if (_isBarometer)
    {
        // Configure CTRL_REG1
        // 0x50 = 01010000 -> ODR: 50Hz & ON, AVG: 0 Low-pass filter disabled
        uint8_t ctrl1 = onOff;      //0x50;
        status = HAL_I2C_Mem_Write(hi2c, ILPS22QS_I2C_ADDR, REG_CTRL_REG1, 1, &ctrl1, 1, 100);
        _isBarometer = (status == HAL_OK);
    }
    return status;
}
 
int8_t bar_ils22qs_Is(I2C_HandleTypeDef *hi2c, int8_t tryInit)
{
    if (!_isBarometer && tryInit)
        bar_ils22qs_Init(hi2c);
    return _isBarometer;
}
 
HAL_StatusTypeDef bar_ils22qs_On(I2C_HandleTypeDef *hi2c)
{
    // Configure CTRL_REG1
    // 0x50 = 01010000 -> ODR: 50Hz & ON, AVG: 0 Low-pass filter disabled
    /*
     *   7  6    5    4     3    2   1    0
     0 ODR3 ODR2 ODR1 ODR0 AVG2 AVG1 AVG0
     */
    const uint8_t val = 0b00011010;
    HAL_StatusTypeDef status = barometer_onOff(hi2c, val);
 
    _bar_ils22qsData.IsDataValid = 0;
    if (status == HAL_OK)
    {
        _memsMainBlock.Sens_BarometerStart++;
        mems_WriteMainBlock();
    }
    return status;
}
 
HAL_StatusTypeDef bar_ils22qs_Off(I2C_HandleTypeDef *hi2c)
{
    // Configure CTRL_REG1
    // 0x00 = 00000000 -> ODR: 50Hz & ON, AVG: 0 Low-pass filter disabled
    return barometer_onOff(hi2c, 0x00);
}
 
HAL_StatusTypeDef bar_ils22qs_Init(I2C_HandleTypeDef *hi2c)
{
    HAL_StatusTypeDef status = I2C_IsDeviceReadyMT(hi2c, ILPS22QS_I2C_ADDR, 2, 2);  // first check
 
    if (status == HAL_OK)
        do
        {
            // check who am'I
            uint8_t data = 0;
            if ((status = HAL_I2C_Mem_Read(hi2c, ILPS22QS_I2C_ADDR, REG_WHO_AM_I, 1, &data, 1, 100)) != HAL_OK)
                break;
            if (data != ILPS22QS_ID)
            {
                status = HAL_ERROR;
                break;
            }
            _isBarometer = 1; // because On/Off needs it
            // check turning on/off
            if ((status = bar_ils22qs_On(hi2c)) != HAL_OK)
                break;
            if ((status = bar_ils22qs_Off(hi2c)) != HAL_OK)
                break;
        } while (0);
    _isBarometer = (status == HAL_OK);
 
    return status;
}
 
HAL_StatusTypeDef bar_ils22qs_Read(I2C_HandleTypeDef *hi2c)
{
    uint8_t raw_data[5]; // 3 bytes for pressure, 2 for temperature
    HAL_StatusTypeDef status = HAL_ERROR;
 
    if (_isBarometer)
    {
        do
        {
            // check if sensor is turned on
            if ((status = bar_ils22qs_IsOn(hi2c, &raw_data[0])) != HAL_OK)
                break;
            if (!raw_data[0])
            {
                status = HAL_TIMEOUT;
                break;
            }
 
            if ((status = HAL_I2C_Mem_Read(hi2c, ILPS22QS_I2C_ADDR, REG_PRESS_OFFSET, 1, raw_data, 2, 100)) != HAL_OK)
                break;
            //uint32_t factoryOffset = (uint32_t)raw_data[1] << 16 | (uint32_t)raw_data[0];
 
            // Read Pressure (3 bytes) and Temperature (2 bytes) starting from PRESS_OUT_XL
            // Using auto-increment feature of the sensor
            if ((status = HAL_I2C_Mem_Read(hi2c, ILPS22QS_I2C_ADDR, REG_PRESS_OUT_XL, 1, raw_data, 5, 100)) != HAL_OK)
                break;
 
            // Process Pressure (24-bit signed)
            int32_t raw_press = (int32_t) ((uint32_t) raw_data[2] << 16 | (uint32_t) raw_data[1] << 8 | raw_data[0]);
            // Handle negative sign for 24-bit
            if (raw_press & 0x800000)
                raw_press |= 0xFF000000;
 
            _bar_ils22qsData.PressureSEA = _bar_ils22qsData.PressureABS = (float) raw_press / 4096.0f;
 
            // Process Temperature (16-bit signed)
            int16_t raw_temp = (int16_t) ((uint16_t) raw_data[4] << 8 | raw_data[3]);
            _bar_ils22qsData.Temperature = (float) raw_temp / 100.0f;
            _bar_ils22qsData.IsDataValid = 1;
 
            /*
             * Absolute vs. Relative Pressure
 
             Absolute (Station) Pressure: This is what your ILPS22QS measures. It is the actual weight of the air pressing on the sensor in Rožňava.
             Since Rožňava is at an elevation of approximately 310 meters above sea level, the air is "thinner" and the pressure is lower (around 968 hPa).
 
             Relative (Sea Level) Pressure: This is what the Slovak Hydro-meteorological institute reports (1005 hPa).
             It is a calculated value: "What would the pressure be if my room was at 0 meters altitude?"
             How to calculate Sea Level Pressure
 
             To match the official report, you need to apply the barometric formula. For altitudes under 11,000 meters, we use this approximation:
             Psea​=Pstation​⋅(1−T+0.0065⋅h+273.150.0065⋅h​)−5.257
 
             Where:
 
             Pstation​ = 968 hPa (your sensor reading)
 
             h = Elevation of Rožňava (≈310 meters)
 
             T = Temperature in °C (from your Temp&Hum 23 sensor)
             */
            // relative pressure needs temperature value
            if (_systemParams.SensAltitude > 0)
            {
#ifdef SENSOR_SHT45
                float temp = (_tmphm_sht45Data.IsDataValid) ? _tmphm_sht45Data.Temperature :_bar_ils22qsData.Temperature;
#else
                float temp = _bar_ils22qsData.Temperature;
#endif
                _bar_ils22qsData.PressureSEA = _bar_ils22qsData.PressureABS
                        * pow(1.0 - (0.0065 * _systemParams.SensAltitude) / (temp + (0.0065 * _systemParams.SensAltitude) + 273.15), -5.257);
            }
        } while (0);
    }
    return status;
}
 
void bar_ils22qs_LogData(char *buf)
{
    if (buf != NULL)
        sprintf(buf, "|barometer ABS:" PRIf_02 ", SEA:" PRIf_02 ", temp:" PRIf_02 " ", PRIf_02D(_bar_ils22qsData.PressureABS), PRIf_02D(_bar_ils22qsData.PressureSEA),
                PRIf_02D(_bar_ils22qsData.Temperature));
}
 
#endif