传感器驱动必须继承sensor抽象基类，通过纯虚函数定义init()、read()、name()契约，剥离硬件细节与通信栈，实现低耦合；派生类自主管理上下文，禁用基类构造参数与析构阻塞操作，推荐模板策略替代虚函数以避免运行时开销。
传感器驱动必须继承 Sensor 抽象基类
不写虚函数接口，就谈不上低耦合。C++单片机项目里，所有具体传感器（如 BME280、MPU6050）必须显式继承统一的纯虚基类：
class Sensor {
public:
virtual bool init() = 0;
virtual bool read(float* data, size_t len) = 0;
virtual const char* name() const = 0;
virtual ~Sensor() = default;
};这个基类不包含任何硬件细节（比如 I2C 地址、寄存器偏移），也不依赖具体通信栈（HAL、CMSIS、Linux i2c-dev）。它只定义行为契约——上层调用者只需知道“能初始化、能读、有名字”，其他一概不管。常见错误是把初始化参数（如 i2c_addr）塞进基类构造函数，导致派生类无法复用；正确做法是让派生类自己管理硬件上下文，基类保持“无状态”。
init() 和 read() 必须返回明确错误语义
嵌入式环境没有异常，但也不能靠全局错误码或 assert 混过去。推荐两种轻量方式：
- 返回
bool：仅区分“成功/失败”，适合资源有限的 Cortex-M0/M3 - 返回
std::expected<size_t errorcode></size_t>（C++23）：在支持的平台（如 ESP-IDF + C++23 工具链）中，可携带具体错误原因（EIO、ETIMEDOUT、ENODEV）
避免在 read() 内部做重试逻辑——那是上层策略，不是驱动职责。驱动只负责“本次通信是否按协议完成”，重试、超时、降级由调度器或融合模块决定。
通信协议逻辑必须模板化或策略注入，不能硬编码在驱动里
同一个 BME280 可能跑在 I2C 或 SPI 上；同一块板子上可能混用不同总线。若在 BME280_I2C 类里直接调用 HAL_I2C_Master_Transmit()，就锁死了移植性。
可行方案：
- 用模板参数传入通信策略：
template<typename bus> class BME280 final : public Sensor { Bus bus_; }</typename>，其中Bus是满足send(uint8_t*, size_t)/recv(uint8_t*, size_t)的概念 - 用依赖注入：构造时传入
std::function<bool size_t></bool>，适用于需要运行时切换总线的场景（如热插拔）
注意：不要为了“泛型”引入虚函数调用开销。模板策略在编译期展开，无额外成本；而虚函数调用在 Cortex-M 系统中多 1–2 个周期，对微秒级传感器轮询是敏感的。
RAII 必须覆盖硬件资源生命周期，但禁止在析构中做阻塞操作
驱动对象创建时申请资源（I2C 句柄、DMA 缓冲区、定时器），销毁时自动释放——这是 RAII 的底线。例如：
class BME280_I2C : public Sensor {
I2C_HandleTypeDef* hi2c_;
std::unique_ptr<uint8_t> rx_buf_;
public:
BME280_I2C(I2C_HandleTypeDef* h) : hi2c_(h), rx_buf_(std::make_unique<uint8_t>(32)) {}
~BME280_I2C() override { /* 不做 HAL_I2C_DeInit() */ }
};</uint8_t></uint8_t>
关键点：
- 析构函数里只释放本对象拥有的资源（如
rx_buf_），不调用可能阻塞的 HAL 函数（如HAL_I2C_DeInit()）——那是系统关闭阶段由设备管理器统一协调的 - 中断回调、DMA 完成回调中绝不能 delete 驱动对象（会引发堆破坏），应通过状态标志+主循环清理
- 所有指针成员优先用
std::unique_ptr或裸指针（若确定生命周期由外部严格管理），禁用std::shared_ptr（引用计数非原子，且开销不可控）
最易被忽略的是：当驱动被频繁 new/delete（比如热插拔模拟），而底层总线句柄是全局共享的，此时 RAII 管理的必须是“使用权”而非“所有权”。这时候该用 std::weak_ptr<bushandle></bushandle> 配合自旋等待，而不是假设每次都能独占硬件。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
