StmGpio.h

Go to the documentation of this file.

 
#pragma once
 
#include "BaseGpio.h"
#include "StmTypes.h"
 
// Forward-declare GPIO_TypeDef only when CMSIS / HAL has not already defined it
// as a typedef (which is the case on every STM32 family).
#ifndef GPIOA
struct GPIO_TypeDef;
#endif
 
class StmGpio : public BaseGpio {
public:
 
    explicit StmGpio(
        hf_pin_num_t           pin_num,
        GPIO_TypeDef*          port,
        hf_u16_t               hal_pin_mask,
        hf_gpio_direction_t    direction        = hf_gpio_direction_t::HF_GPIO_DIRECTION_INPUT,
        hf_gpio_active_state_t active_state     = hf_gpio_active_state_t::HF_GPIO_ACTIVE_HIGH,
        hf_gpio_output_mode_t  output_mode      = hf_gpio_output_mode_t::HF_GPIO_OUTPUT_MODE_PUSH_PULL,
        hf_gpio_pull_mode_t    pull_mode        = hf_gpio_pull_mode_t::HF_GPIO_PULL_MODE_FLOATING,
        hf_gpio_drive_cap_t    drive_capability = hf_gpio_drive_cap_t::HF_GPIO_DRIVE_CAP_MEDIUM
    ) noexcept;
 
    explicit StmGpio(const hf_stm32_gpio_config_t& config) noexcept;
 
    ~StmGpio() noexcept override;
 
    // ── Public pure-virtual overrides ───────────────────────────────────────
    bool Initialize() noexcept override;
    bool IsPinAvailable() const noexcept override;
    hf_u8_t GetMaxPins() const noexcept override;
    const char* GetDescription() const noexcept override;
 
    // ── EXTI dispatch (call from HAL_GPIO_EXTI_Callback in user code) ───────
    static void ExtiCallbackDispatch(hf_u16_t gpio_pin_mask) noexcept;
 
    // ── Accessors ───────────────────────────────────────────────────────────
    GPIO_TypeDef* GetPort() const noexcept { return port_; }
    hf_u16_t GetHalPinMask() const noexcept { return hal_pin_mask_; }
 
protected:
    // ── Platform implementation overrides ───────────────────────────────────
    hf_gpio_err_t SetDirectionImpl(hf_gpio_direction_t direction) noexcept override;
    hf_gpio_err_t GetDirectionImpl(hf_gpio_direction_t& direction) const noexcept override;
    hf_gpio_err_t SetOutputModeImpl(hf_gpio_output_mode_t mode) noexcept override;
    hf_gpio_err_t GetOutputModeImpl(hf_gpio_output_mode_t& mode) const noexcept override;
    hf_gpio_err_t SetPullModeImpl(hf_gpio_pull_mode_t mode) noexcept override;
    hf_gpio_pull_mode_t GetPullModeImpl() const noexcept override;
    hf_gpio_err_t SetPinLevelImpl(hf_gpio_level_t level) noexcept override;
    hf_gpio_err_t GetPinLevelImpl(hf_gpio_level_t& level) noexcept override;
 
private:
    GPIO_TypeDef*       port_;
    hf_u16_t            hal_pin_mask_;
    hf_gpio_direction_t direction_;
    hf_gpio_output_mode_t output_mode_;
    hf_gpio_pull_mode_t pull_mode_;
    hf_gpio_drive_cap_t drive_cap_;
 
    void ApplyHalConfig() noexcept;
 
    static StmGpio* s_exti_instances_[16];
};