/**
 * @file temperatura.h
 * @brief Definiciones y declaraciones para el módulo de manejo de temperatura.
 * 
 * Este archivo contiene las declaraciones de las funciones utilizadas para
 * inicializar y obtener mediciones de temperatura del ADC, así como para
 * configurar una bandera que indica la disponibilidad de una nueva medición.
 * 
 * @version 1.2
 * @date 20/03/2024
 */

#ifndef __TEMPERATURE_H__
#define __TEMPERATURE_H__

#include <stdint.h>
#include <stddef.h>

/**
 * @brief Inicializa el ADC en modo de medición de temperatura.
 * Configura el ADC para sensar la temperatura y espera a que la referencia
 * se estabilice. También configura la bandera que será utilizada para indicar cuando
 * haya una medida de temperatura lista.
 * 
 * @param flag_main Puntero a la bandera a configurar.
 * @return uint8_t Retorna 1 si la inicialización fue correcta, 0 sino.
 */
uint8_t init_temperature_sensor(uint8_t* flag_main);


/**
 * @brief Inicia una nueva medición de temperatura.
 * 
 * Comienza el proceso de muestreo y conversión de la temperatura actual
 * mediante el ADC.
 */
void run_temperature_measurement(void);

/**
 * @brief Obtiene la última medición de temperatura en miligrados Celsius.
 * 
 * Calcula y retorna la última temperatura medida, convertida a miligrados
 * Celsius.
 * 
 * @return int32_t Temperatura en miligrados Celsius.
 */
int32_t get_temperature_value(void);

#endif // __TEMPERATURA_H__