StmPwm.h

Go to the documentation of this file.

 
#pragma once
 
#include "BasePwm.h"
#include "StmTypes.h"
 
struct TIM_HandleTypeDef;  // Forward declaration
 
class StmPwm : public BasePwm {
public:
 
    explicit StmPwm(TIM_HandleTypeDef* htim,
                    hf_u32_t timer_clock_hz) noexcept;
 
    explicit StmPwm(const hf_stm32_pwm_config_t& config) noexcept;
 
    ~StmPwm() noexcept override;
 
    StmPwm(const StmPwm&) = delete;
    StmPwm& operator=(const StmPwm&) = delete;
 
    // ── Pure-virtual overrides (BasePwm) ────────────────────────────────────
 
    // Lifecycle
    hf_pwm_err_t Initialize() noexcept override;
    hf_pwm_err_t Deinitialize() noexcept override;
 
    // Channel control
    hf_pwm_err_t EnableChannel(hf_channel_id_t channel_id) noexcept override;
    hf_pwm_err_t DisableChannel(hf_channel_id_t channel_id) noexcept override;
    bool IsChannelEnabled(hf_channel_id_t channel_id) const noexcept override;
 
    // PWM control
    hf_pwm_err_t SetDutyCycle(hf_channel_id_t channel_id, float duty_cycle) noexcept override;
    hf_pwm_err_t SetDutyCycleRaw(hf_channel_id_t channel_id, hf_u32_t raw_value) noexcept override;
    hf_pwm_err_t SetFrequency(hf_channel_id_t channel_id, hf_frequency_hz_t frequency_hz) noexcept override;
    hf_pwm_err_t SetPhaseShift(hf_channel_id_t channel_id, float phase_shift_degrees) noexcept override;
 
    // Advanced
    hf_pwm_err_t StartAll() noexcept override;
    hf_pwm_err_t StopAll() noexcept override;
    hf_pwm_err_t UpdateAll() noexcept override;
    hf_pwm_err_t SetComplementaryOutput(hf_channel_id_t primary_channel,
                                        hf_channel_id_t complementary_channel,
                                        hf_u32_t deadtime_ns) noexcept override;
 
    // Status
    float GetDutyCycle(hf_channel_id_t channel_id) const noexcept override;
    hf_frequency_hz_t GetFrequency(hf_channel_id_t channel_id) const noexcept override;
 
    // ── Accessors ───────────────────────────────────────────────────────────
    TIM_HandleTypeDef* GetHalHandle() const noexcept { return htim_; }
 
    static constexpr hf_u8_t kMaxChannels = 4;
 
private:
    TIM_HandleTypeDef* htim_;
    hf_u32_t           timer_clock_hz_;
    bool               channel_enabled_[kMaxChannels];
    float              duty_[kMaxChannels];        
    hf_frequency_hz_t  frequency_hz_;              
 
    static hf_u32_t ChannelToHal(hf_channel_id_t ch) noexcept;
 
    bool ApplyFrequency(hf_frequency_hz_t freq_hz) noexcept;
 
    void ReapplyDuties() noexcept;
};