StmTemperature.h

Go to the documentation of this file.

 
#pragma once
 
#include "BaseTemperature.h"
#include "StmTypes.h"
 
struct ADC_HandleTypeDef;  // Forward declaration
 
using hf_stm32_temp_convert_fn = float(*)(hf_u32_t raw_adc_count, hf_u8_t resolution_bits);
 
struct hf_stm32_temp_sensor_config_t {
    ADC_HandleTypeDef*      hadc;                   
    hf_u32_t                channel;                
    hf_u8_t                 resolution_bits;        
    float                   vref_mv;                
    hf_stm32_temp_convert_fn convert_fn;            
    hf_temp_sensor_type_t   sensor_type;            
    float                   range_min_celsius;      
    float                   range_max_celsius;      
    hf_u32_t                sample_count;           
    hf_u32_t                timeout_ms;             
 
    hf_stm32_temp_sensor_config_t() noexcept
        : hadc(nullptr), channel(0), resolution_bits(12), vref_mv(3300.0f)
        , convert_fn(nullptr), sensor_type(HF_TEMP_SENSOR_TYPE_INTERNAL)
        , range_min_celsius(-40.0f), range_max_celsius(125.0f)
        , sample_count(4), timeout_ms(100) {}
};
 
class StmTemperature : public BaseTemperature {
public:
 
    explicit StmTemperature(const hf_stm32_temp_sensor_config_t& config) noexcept;
 
    explicit StmTemperature(ADC_HandleTypeDef* hadc = nullptr,
                            hf_u8_t resolution_bits = 12,
                            float vref_mv = 3300.0f) noexcept;
 
    ~StmTemperature() noexcept override;
 
    // ── Pure virtuals from BaseTemperature ──────────────────────────────────
    hf_temp_err_t GetSensorInfo(hf_temp_sensor_info_t* info) const noexcept override;
    hf_u32_t GetCapabilities() const noexcept override;
 
    // ── Optional overrides ──────────────────────────────────────────────────
    hf_temp_err_t SetRange(float min_celsius, float max_celsius) noexcept override;
    hf_temp_err_t GetRange(float* min_celsius, float* max_celsius) const noexcept override;
    hf_temp_err_t SetCalibrationOffset(float offset_celsius) noexcept override;
    hf_temp_err_t GetCalibrationOffset(float* offset_celsius) const noexcept override;
 
protected:
    bool Initialize() noexcept override;
    bool Deinitialize() noexcept override;
    hf_temp_err_t ReadTemperatureCelsiusImpl(float* temperature_celsius) noexcept override;
 
private:
    hf_stm32_temp_sensor_config_t config_;
    float calibration_offset_;   
 
    static float DefaultInternalConvert(hf_u32_t raw, hf_u8_t resolution_bits);
};