StmPeriodicTimer.h

Go to the documentation of this file.

 
#pragma once
 
#include "BasePeriodicTimer.h"
#include "StmTypes.h"
 
struct TIM_HandleTypeDef;  // Forward declaration
 
class StmPeriodicTimer : public BasePeriodicTimer {
public:
 
    explicit StmPeriodicTimer(TIM_HandleTypeDef* htim,
                              hf_u32_t timer_clock_hz,
                              hf_timer_callback_t callback = nullptr,
                              void* user_data = nullptr) noexcept;
 
    explicit StmPeriodicTimer(const hf_stm32_timer_config_t& config,
                              hf_timer_callback_t callback = nullptr,
                              void* user_data = nullptr) noexcept;
 
    ~StmPeriodicTimer() noexcept override;
 
    // Non-copyable, non-movable
    StmPeriodicTimer(const StmPeriodicTimer&) = delete;
    StmPeriodicTimer& operator=(const StmPeriodicTimer&) = delete;
 
    // ── Pure‑virtual overrides ──────────────────────────────────────────────
    hf_timer_err_t Initialize() noexcept override;
    hf_timer_err_t Deinitialize() noexcept override;
    hf_timer_err_t Start(hf_u64_t period_us) noexcept override;
    hf_timer_err_t Stop() noexcept override;
    hf_timer_err_t SetPeriod(hf_u64_t period_us) noexcept override;
    hf_timer_err_t GetPeriod(hf_u64_t& period_us) noexcept override;
    hf_timer_err_t GetStats(hf_u64_t& callback_count,
                            hf_u64_t& missed_callbacks,
                            hf_timer_err_t& last_error) noexcept override;
    hf_timer_err_t ResetStats() noexcept override;
    const char* GetDescription() const noexcept override;
    hf_u64_t GetMaxPeriod() const noexcept override;
    hf_u64_t GetMinPeriod() const noexcept override;
    hf_u64_t GetResolution() const noexcept override;
 
    // ── Statistics / Diagnostics overrides ──────────────────────────────────
    hf_timer_err_t GetStatistics(hf_timer_statistics_t& statistics) const noexcept override;
    hf_timer_err_t GetDiagnostics(hf_timer_diagnostics_t& diagnostics) const noexcept override;
 
    // ── ISR Dispatch ────────────────────────────────────────────────────────
    static void IsrDispatch(TIM_HandleTypeDef* htim) noexcept;
 
private:
    TIM_HandleTypeDef* htim_;          
    hf_u32_t           timer_clock_hz_;
    hf_u64_t           period_us_;     
    hf_timer_stats_t   stats_;         
 
    bool ApplyPeriod(hf_u64_t period_us) noexcept;
 
    // ── Static dispatch table ───────────────────────────────────────────────
    static constexpr int kMaxTimerInstances = 8;
    struct DispatchEntry {
        TIM_HandleTypeDef* htim;
        StmPeriodicTimer*  instance;
    };
    static DispatchEntry s_dispatch_[kMaxTimerInstances];
    static int           s_dispatch_count_;
 
    void RegisterDispatch() noexcept;
    void UnregisterDispatch() noexcept;
};