077、Zephyr RTOS驱动开发基础：驱动API设计

Zephyr RTOS驱动开发基础：驱动API设计从一次凌晨三点的现场崩溃说起去年冬天，某工厂的AGV调度系统在凌晨三点突然死机。现场工程师发来的日志显示，一个磁导航传感器的驱动在中断上下文里调用了k_malloc——Zephyr的驱动API设计规范里明确禁止的行为，但我们的驱动代码偏偏绕过了API层直接操作了内核对象。那次事故让我意识到，驱动API设计不是纸上谈兵，它直接决定了系统在极端工况下的生死。Zephyr的驱动模型设计得相当精巧，但如果你只是照着例程抄，迟早会踩进“API设计不规范”的坑里。今天这篇笔记，我们就从驱动API设计的底层逻辑讲起，结合我踩过的几个真实雷区，把Zephyr驱动开发的基础骨架拆开揉碎。驱动API的“三权分立”架构Zephyr的驱动API设计遵循一个核心原则：设备驱动模型（Device Driver Model, DDM）。它把驱动拆成三个层次，每个层次各司其职，互不越界。第一层：设备树（Device Tree）这是硬件描述层。你在.dts文件里定义外设的寄存器地址、中断号、时钟频率等物理属性。比如一个UART设备：uart0:serial@40002000/