Zephyr中device与xxx_dt_spec的使用对比

一、引言

在Zephyr RTOS开发中，设备访问是嵌入式系统开发的基础环节。Zephyr提供了多种设备管理方式，其中最核心的是const struct device*（设备指针）和各种xxx_dt_spec结构体（如struct pwm_dt_spec、struct gpio_dt_spec等）。这两种方式各有特点和适用场景，理解它们的区别对于编写高效、可维护的Zephyr应用程序至关重要。本文将以SF32LB52-DevKit-LCD开发板为例，通过PWM模块的实际应用，对比分析这两种设备访问方式的特点和使用方法。

二、设备指针 (const struct device*)

2.1 基本特点

设备指针是Zephyr设备驱动模型中最基础、最通用的设备访问方式。它是一个指向设备对象的常量指针，通过设备树节点标识符获取。这种方式提供了最大的灵活性，可以直接调用设备驱动提供的所有通用API函数。

主要特点：

• 直接访问设备驱动API
• 适用于所有类型的设备
• 需要手动管理设备配置参数
• 代码相对冗长，但控制精细

2.2 使用示例

#include <zephyr/device.h>
#include <zephyr/drivers/pwm.h>
#include <zephyr/kernel.h>
#include <zephyr/devicetree.h>
#include <stdio.h>

/* 通过设备树别名获取PWM设备节点 */
#define PWM_DEV_NODE  DT_ALIAS(pwm)

/* 声明并获取设备指针 */
const struct device *pwm_dev = DEVICE_DT_GET(PWM_DEV_NODE);

int main(void)
{
    int ret = 0;

    /* 检查设备是否就绪 */
    if (!device_is_ready(pwm_dev)) {
        printf("PWM device not ready\n");
        return 1;
    }

    /* 使用设备API设置PWM参数
     * 参数说明：
     * - pwm_dev: PWM设备指针
     * - 1: PWM通道号（需与设备树配置一致）
     * - 2000000: PWM周期（纳秒），对应2ms周期
     * - 1000000: PWM脉冲宽度（纳秒），对应1ms高电平
     * - 0: 极性标志（0表示正常极性）
     */
    ret = pwm_set(pwm_dev, 1, 2000000, 1000000, 0);
    if (ret) {
        printf("Failed to set PWM: %d\n", ret);
        return 1;
    }

    printf("PWM set successfully with device pointer\n");

    /* 主循环 */
    while (1) {
        printf("PWM running...\n");
        k_sleep(K_MSEC(1000));
    }
    
    return 0;
}

三、xxx_dt_spec结构体 (如struct pwm_dt_spec)

3.1 基本特点

xxx_dt_spec结构体是Zephyr为简化设备树集成而引入的高级抽象。它封装了设备指针以及从设备树中提取的配置参数（如通道号、周期等），提供更简洁、更安全的API。

主要特点：

• 封装设备指针和设备树配置参数
• 提供更简洁的API接口
• 减少代码重复和配置错误
• 更好地与设备树集成
• 提供类型安全的专用函数

3.2 使用示例

#include <zephyr/device.h>
#include <zephyr/drivers/pwm.h>
#include <zephyr/kernel.h>
#include <zephyr/devicetree.h>
#include <stdio.h>

/* 通过设备树别名获取PWM设备节点 */
#define PWM_DEV_NODE  DT_ALIAS(pwm)

/* 定义PWM设备规格结构体
 * 注意：实际开发中通常使用PWM_DT_SPEC_GET宏自动初始化，
 * 这里为了演示显式初始化各个字段
 */
const struct pwm_dt_spec pwm_spec = {
    .dev = DEVICE_DT_GET(PWM_DEV_NODE),  // 设备指针
    .channel = 1,                        // PWM通道号
    .flags = 0,                          // 标志位
    .period = 2000000,                   // PWM周期（纳秒）
};

int main(void)
{
    int ret = 0;

    /* 使用专用函数检查设备就绪状态 */
    if (!pwm_is_ready_dt(&pwm_spec)) {
        printf("PWM device not ready\n");
        return -1;
    }
    
    /* 使用dt专用API设置PWM
     * 参数说明：
     * - &pwm_spec: PWM设备规格指针
     * - 2000000: PWM周期（纳秒）
     * - 1000000: PWM脉冲宽度（纳秒），占空比50%
     */
    ret = pwm_set_dt(&pwm_spec, 2000000, 1000000);
    if (ret) {
        printf("Error %d: failed to set PWM\n", ret);
        return ret;
    }

    printf("PWM set successfully with pwm_dt_spec\n");

    /* 主循环 */
    while (1) {
        printf("PWM running...\n");
        k_sleep(K_MSEC(1000));
    }
    
    return 0;
}

四、实际项目应用

在SF32LB52-DevKit-LCD开发板上，我们通过PWM模块控制LED亮度，对比两种设备访问方式的实际应用。

4.1 设备树覆写文件 (sf32lb52_devkit_lcd.overlay)

/ {
    aliases {
        /* 为PWM设备定义别名，方便代码引用 */
        pwm = &pwm0;
    };
};

&pinctrl {
    /* 定义PWM0引脚配置 */
    pwm0_default: pwm0_default {
        group1 {
            /* 将PA30引脚配置为GPTIM2_CH1功能 */
            pinmux = <PA30_GPTIM2_CH1>;
        };
    };
};

&gptim2 {
    status = "okay";              /* 启用GPTIM2定时器 */
    sifli,prescaler = <0>;        /* 预分频器设置为0 */
    
    /* 定义PWM0设备 */
    pwm0: pwm {
        status = "okay";          /* 启用PWM功能 */
        pinctrl-0 = <&pwm0_default>;  /* 应用引脚配置 */
        pinctrl-names = "default";
    };
};

4.2 两种方式的对比分析