嵌入式外设驱动单实例实现：禁止重复创建同一硬件实例（无异常）

核心思路 #

利用编译期常量（外设地址）作为模板参数，结合静态编译时断言，确保每个物理外设只能被实例化一次。硬件外设的基地址是编译期已知的固定值，完全可以在编译阶段拦截重复实例化操作，无需运行时检查或异常机制。

实现方案 #

1. 定义外设地址常量 #

先将所有UART/USART的硬件基地址定义为编译期常量（地址需根据实际MCU手册修改）：

// 示例：基于STM32的外设地址
constexpr uintptr_t UART1_BASE = 0x40013800;
constexpr uintptr_t UART2_BASE = 0x40004400;
constexpr uintptr_t UART3_BASE = 0x40004800;
constexpr uintptr_t USART4_BASE = 0x40004C00;
constexpr uintptr_t USART5_BASE = 0x40005000;

2. 编译时外设使用追踪器 #

通过模板元编程实现编译期的外设使用状态追踪：

#include <type_traits>

namespace detail {
    // 用类型列表记录已实例化的外设地址
    template<uintptr_t... Addrs>
    struct UsedPeripherals {};

    // 检查指定地址是否已在使用列表中
    template<uintptr_t Addr, typename List>
    struct IsUsed : std::false_type {};

    template<uintptr_t Addr, uintptr_t... Others>
    struct IsUsed<Addr, UsedPeripherals<Addr, Others...>> : std::true_type {};

    template<uintptr_t Addr, uintptr_t... Others>
    struct IsUsed<Addr, UsedPeripherals<Others...>> : IsUsed<Addr, UsedPeripherals<Others...>> {};

    // 全局已使用外设列表，初始为空
    inline constexpr auto used_peripherals = UsedPeripherals<>{};
}

3. 驱动类实现（UART/USART） #

将驱动设计为模板类，以外设地址作为模板参数，构造时通过static_assert做编译期检查：

// UART驱动模板类
template<uintptr_t PeriphBase>
class UartDriver {
public:
    // 构造函数：接收初始化参数（波特率、数据位等）
    UartDriver(uint32_t baud_rate, uint8_t data_bits, uint8_t stop_bits) {
        // 编译时断言：重复实例化直接报错
        static_assert(!detail::IsUsed<PeriphBase, decltype(detail::used_peripherals)>::value,
                      "该外设已存在驱动实例！");

        // 实际硬件初始化逻辑：配置寄存器、引脚等
        init_hardware(baud_rate, data_bits, stop_bits);
    }

    // 禁用拷贝/移动，防止实例被复制
    UartDriver(const UartDriver&) = delete;
    UartDriver& operator=(const UartDriver&) = delete;
    UartDriver(UartDriver&&) = delete;
    UartDriver& operator=(UartDriver&&) = delete;

    // 驱动核心方法：发送数据
    void send(const uint8_t* data, size_t len) {
        // 发送逻辑实现
        for (size_t i = 0; i < len; ++i) {
            while (!(*(volatile uint32_t*)(PeriphBase + 0x1C) & 0x80)); // 等待发送缓冲区空
            *(volatile uint8_t*)(PeriphBase + 0x04) = data[i]; // 写入数据
        }
    }

private:
    void init_hardware(uint32_t baud_rate, uint8_t data_bits, uint8_t stop_bits) {
        // 硬件初始化示例：使能时钟、配置波特率、数据格式等
        // *(volatile uint32_t*)(0x40021000 + 0x18) |= (1 << 14); // 使能UART1时钟
        // *(volatile uint32_t*)(PeriphBase + 0x0C) = calculate_baud_rate(baud_rate); // 设置波特率寄存器
    }
};

// USART驱动：继承UartDriver并扩展特有的功能
template<uintptr_t PeriphBase>
class UsartDriver : public UartDriver<PeriphBase> {
public:
    using UartDriver<PeriphBase>::UartDriver;

    // USART特有的同步模式配置
    void enable_sync_mode() {
        // 配置同步模式寄存器
        *(volatile uint32_t*)(PeriphBase + 0x00) |= (1 << 12);
    }
};

4. 使用示例 #

// 合法：创建不同外设的驱动实例
auto uart1 = UartDriver<UART1_BASE>(9600, 8, 1);
auto uart2 = UartDriver<UART2_BASE>(115200, 8, 1);
auto usart4 = UsartDriver<USART4_BASE>(19200, 8, 1);

// 非法：重复创建UART1实例，编译时触发static_assert报错
auto another_uart1 = UartDriver<UART1_BASE>(9600, 8, 1); // 编译失败

关键优势 #

• 编译期拦截错误：直接在编译阶段阻止重复实例化，避免运行时隐患，符合嵌入式系统可靠性要求。
• 无异常依赖：完全通过模板元编程和static_assert实现，不需要C++异常机制。
• 类型安全：每个外设对应唯一的驱动类型（不同模板特化），避免外设实例混用。
• 零运行时开销：所有检查都在编译阶段完成，不占用运行时资源。

注意事项 #

• 外设地址必须是编译期常量，不能用运行时变量作为模板参数。
• 如果MCU外设定义是指针宏（如STM32的USART1），可通过reinterpret_cast<uintptr_t>(USART1)转换为编译期常量作为模板参数。
• 必须禁用驱动类的拷贝/移动构造，防止通过拷贝生成多个实例。

内容的提问来源于stack exchange，提问作者Florian Humblot