第 18 课：Zephyr 自定义驱动（Custom Driver）摘要：本课将带你从驱动使用者进阶为驱动开发者，完整实现一个 Zephyr 自定义 LED Driver。你将掌握 Driver API 定义、Private Data 与 Config 结构、Devicetree Binding 与 Overlay 配置、DEVICE_DT_DEFINE核心宏，以及多实例支持。课程以 NUCLEO-F303RE 为实验平台，最终通过my_led_toggle()控制板载 LED 闪烁，并对比 Zephyr 与 Linux 驱动模型的对应关系。这是 Zephyr 学习计划中最重要的一课。前面你已经学习了：✅ GPIO / UART✅ Kconfig✅ Devicetree✅ Thread、Semaphore、Mutex✅ WorkQueue✅ Timer✅ Logging✅ Driver API 的使用这一课开始，我们从驱动使用者（Application）变成驱动开发者（Driver Developer）。本课目标完成一个真正的 Zephyr 自定义 Driver。学习完成后，你将能够：编写自己的 Driver定义 Driver API使用 Devicetree 描述硬件使用 Kconfig 控制驱动编译支持多个 Driver InstanceApplication 像调用官方 Driver 一样调用自己的 Driver这也是 Zephyr 官方推荐的驱动开发方式。为什么需要 Custom Driver？假设公司开发了一块板子：如果 Application 每次都直接调用gpio_pin_set()gpio_pin_get()spi_transceive()i2c_write()代码会越来越混乱。Zephyr 推荐：Application │ ▼ My LED Driver │ ▼ GPIO Driver │ ▼ GPIO Hardware这样：Application 永远不知道 GPIO 在哪里。Driver 架构Application │ My Driver API │ Driver │ GPIO/SPI/I2C Driver │ Hardware官方 Sensor Driver、Display Driver、CAN Driver 都是这种结构。本课程项目我们实现一个：LED Driver提供 API：led_on()led_off()led_toggle()Application 永远不用 GPIO。项目目录my_driver/├── CMakeLists.txt├── Kconfig├── drivers│ my_led.c│ my_led.h├── dts│ bindings│ mycompany,my-led.yaml├── boards│ nucleo_f303re.overlay└── srcmain.c这也是 Zephyr 官方 Driver 的典型组织方式。第一部分：Driver APImy_led.h定义：int my_led_on(const struct device *dev);int my_led_off(const struct device *dev);int my_led_toggle(const struct device *dev);Application 只调用这些接口。第二部分：Driver Private Datastruct my_led_data{bool state;};保存运行时数据。例如：LED 当前状态 是否初始化 计数器第三部分：Driver Configstructmy_led_config{structgpio_dt_specled;};注意：这里没有 GPIO Number。GPIO 来自：Devicetree。第四部分：Initstatic int my_led_init(...)初始化：gpio_is_ready()gpio_pin_configure()LOG_INF(...)Driver 在系统启动时自动执行。第五部分：Driver API 实现例如：my_led_on()里面其实就是：gpio_pin_set_dt(...)Application 并不知道。第六部分：Devicetree Binding新增：mycompany,my-led.yaml例如：compatible:"mycompany,my-led"properties: gpios: required:trueBinding 就是：Driver 与 Devicetree 之间的契约。第七部分：Overlay例如：myled{compatible="mycompany,my-led";gpios=;gpioa5GPIO_ACTIVE_HIGH;};Driver 自动读取：GPIOA Pin5无需写死。第八部分：DEVICE_DT_DEFINE这是 Zephyr Driver 最核心的一行代码：DEVICE_DT_DEFINE(...)它负责：创建 device object 注册 Driver 注册 Init 注册 API 放入初始化表系统启动时：main()之前完整代码示例：my_led.h系统启动与调用时序图下面这张时序图展示了从系统上电、内核初始化，到my_led_toggle()最终驱动 GPIO 硬件的完整调用链，每个步骤都标注了对应的代码位置："GPIO 硬件""main()(main.c)""GPIO Driver""my_led_init()(my_led.c)""DEVICE_DT_DEFINE(my_led.c)""内核 Kernel""GPIO 硬件""main()(main.c)""GPIO Driver""my_led_init()(my_led.c)""DEVICE_DT_DEFINE(my_led.c)""内核 Kernel"