example.c

/**
  ******************************************************************************
  * file           : example.c
  * brief          : example program body
  ******************************************************************************
  *
  * Copyright (c) 2026 STMicroelectronics.
  * All rights reserved.
  *
  * This software is licensed under terms that can be found in the LICENSE file
  * in the root directory of this software component.
  * If no LICENSE file comes with this software, it is provided AS-IS.
  *
  ******************************************************************************
  */
/* Includes ------------------------------------------------------------------*/
#include "example.h"
#include "hts221.h"
#include "stdio.h"

/* Private typedef -----------------------------------------------------------*/
/* Private define ------------------------------------------------------------*/
/* Private function prototypes -----------------------------------------------*/
/* Private variables */
hts221_object_t *pHts2210; /* HTS221 object instance */
float gTempData; /* This variable store the temperature measurement (unit: deg C) */
float gHumData; /* This variable store the humidity measurement (unit: %) */


/** ########## Step 1 ##########
  * The init of HTS221 is triggered by the applicative code
  */

app_status_t app_init(void)
{
  app_status_t return_status = EXEC_STATUS_ERROR;
  /* Retrieve and store the HTS221 object pointer */
  pHts2210 = MX_HTS221_getobject();
  /* Initialize the HTS221 device 0 */
  if (hts221_drv_init(pHts2210, MX_HTS221) != 0)
  {
    PRINTF("[ERROR] Step 1: HTS221 sensor init error\n");
    goto _app_init_exit;
  }
  PRINTF("[INFO] Step 1: HTS221 sensor init completed\n");

  /* HTS221 device 0: enable the temperature and humidity features */
  if (hts221_drv_enable(pHts2210) != 0)
  {
    PRINTF("[ERROR] Step 1: Enabling TEMP and HUM features error\n");
    goto _app_init_exit;
  }
  PRINTF("[INFO] Step 1: Enabling TEMP and HUM features completed\n");

  return_status = EXEC_STATUS_INIT_OK;

_app_init_exit:
  return return_status;
}

/** ########## Step 2 ##########
  * Gets the values of the temperature in Celsius and of the humidity in %.
  * The values are displayed on the terminal.
  * output: EXEC_STATUS_OK if OK, EXEC_STATUS_ERROR in case of error
  */

app_status_t app_process(void)
{
  app_status_t return_status = EXEC_STATUS_ERROR;

  /* HTS221 device 0: get the temperature value and print it */
  if (hts221_drv_get_temperature(pHts2210, &gTempData) != 0)
  {
    PRINTF("[ERROR] Step 2: Reading temperature error\n");
    goto _app_process_exit;
  }
  PRINTF("[INFO] Step 2: TEMP %" PRIi32 " degC\n", (int32_t)gTempData);

  /* HTS221 device 0: get the humidity value and print it */
  if (hts221_drv_get_humidity(pHts2210, &gHumData) != 0)
  {
    PRINTF("[ERROR] Step 2: Reading humidity error\n");
    goto _app_process_exit;
  }
  PRINTF("[INFO] Step 2: HUM %" PRIu32 " %%\n", (uint32_t)gHumData);

  return_status = EXEC_STATUS_OK;

_app_process_exit:
  return return_status;
}

/** Deinitializes the HTS221 instance.
  * In this example, app_deinit is never called and is provided as a reference only.
  */

app_status_t app_deinit(void)
{
  hts221_drv_deinit(pHts2210);

  return EXEC_STATUS_OK;
}