StmUart.h

Go to the documentation of this file.

 
#pragma once
 
#include "BaseUart.h"
#include "StmTypes.h"
 
#if defined(USE_HAL_DRIVER)
#include "stm32h7xx_hal_uart.h"
#else
struct __UART_HandleTypeDef;
typedef struct __UART_HandleTypeDef UART_HandleTypeDef;
#endif
 
class StmUart : public BaseUart {
public:
 
    explicit StmUart(UART_HandleTypeDef* huart,
                     hf_port_num_t port = 0) noexcept;
 
    explicit StmUart(const hf_stm32_uart_config_t& config) noexcept;
 
    ~StmUart() noexcept override;
 
    // Non-copyable
    StmUart(const StmUart&) = delete;
    StmUart& operator=(const StmUart&) = delete;
 
    // ── Pure-virtual overrides (BaseUart) ───────────────────────────────────
    bool Initialize() noexcept override;
    bool Deinitialize() noexcept override;
    hf_uart_err_t Write(const hf_u8_t* data, hf_u16_t length,
                        hf_u32_t timeout_ms = 0) noexcept override;
    hf_uart_err_t Read(hf_u8_t* data, hf_u16_t length,
                       hf_u32_t timeout_ms = 0) noexcept override;
    hf_u16_t BytesAvailable() noexcept override;
    hf_uart_err_t FlushTx() noexcept override;
    hf_uart_err_t FlushRx() noexcept override;
    int Printf(const char* format, ...) noexcept override;
 
    // ── Accessors ───────────────────────────────────────────────────────────
    UART_HandleTypeDef* GetHalHandle() const noexcept { return huart_; }
 
    // ── Software RX ring buffer (optional — call EnableRxBuffer) ────────────
    void EnableRxBuffer(hf_u8_t* buffer, hf_u16_t size) noexcept;
 
    void FeedRxByte(hf_u8_t byte) noexcept;
 
    void FeedRxBlock(const hf_u8_t* data, hf_u16_t length) noexcept;
 
private:
    UART_HandleTypeDef* huart_;
    hf_u32_t default_timeout_ms_;
 
    // Software RX ring buffer
    hf_u8_t* rx_buf_;
    hf_u16_t rx_buf_size_;
    volatile hf_u16_t rx_head_;  
    volatile hf_u16_t rx_tail_;  
};