Zephyr RTOS 的设备树（Device Tree）使用指南

引言

在嵌入式开发的世界中，硬件配置往往是一项复杂且容易出错的任务。Zephyr RTOS 通过引入设备树（Device Tree）机制，为开发者提供了一种优雅的方式来描述和管理硬件资源。设备树就像一张“硬件地图”，帮助 Zephyr 理解系统中的硬件组件及其关系。本文将带你深入探索设备树的魔法世界，从基础语法到实际应用，教你如何在 Zephyr 中轻松配置硬件资源。

1. 设备树：硬件世界的“地图”

1.1 什么是设备树？

设备树是一种用于描述硬件资源的数据结构，它以树形结构组织系统中的硬件组件，例如 CPU、内存、外设等。设备树的核心思想是将硬件描述与操作系统代码分离，使得同一份操作系统代码可以支持多种硬件平台。

1.2 设备树的作用

• 硬件抽象：设备树为操作系统提供了一个统一的硬件描述接口。

• 可移植性：通过修改设备树，可以轻松适配不同的硬件平台。

• 模块化：设备树支持分层和复用，便于管理复杂的硬件配置。

2. 设备树语法入门

设备树使用一种类似于 JSON 的文本格式（DTS，Device Tree Source）来描述硬件。以下是设备树的基本语法元素：

2.1 节点（Node）

设备树由节点组成，每个节点代表一个硬件组件。节点可以包含子节点，形成树形结构。

dts

复制

/ {
    node1 {
        property1 = "value1";
        property2 = <0x12345678>;
        child-node {
            property3 = "value3";
        };
    };
};

• 根节点：/ 是设备树的根节点，所有其他节点都是它的子节点。

• 属性：每个节点可以包含多个属性，属性用于描述硬件的具体配置。

2.2 常用属性

• compatible：用于匹配驱动程序，格式为 "厂商,设备型号"。

• reg：描述设备的寄存器地址和大小。

• interrupts：描述设备的中断信息。

• status：描述设备的状态，例如 "okay" 或 "disabled"。

2.3 示例：描述一个 GPIO 设备

dts

复制

/ {
    gpio0: gpio@10000000 {
        compatible = "vendor,gpio";
        reg = <0x10000000 0x1000>;
        interrupts = <1>;
        status = "okay";
    };
};

3. 在 Zephyr 中使用设备树

Zephyr 的设备树支持基于 Linux 设备树的语法，并进行了部分扩展。以下是 Zephyr 中设备树的核心使用方式。

3.1 设备树文件的位置

Zephyr 的设备树文件通常位于以下目录：

• boards/<架构>/<板卡名称>/<板卡名称>.dts：板卡特定的设备树文件。

• dts/common/：通用的设备树片段。

3.2 设备树的编译

Zephyr 使用 dtc（Device Tree Compiler）将 .dts 文件编译为二进制格式 .dtb，并在构建过程中将其与应用程序链接。

3.3 在代码中访问设备树

Zephyr 提供了丰富的 API 来访问设备树中的信息。以下是一个简单的示例：

c

复制

#include <zephyr.h>
#include <device.h>
#include <devicetree.h>

#define LED_NODE DT_NODELABEL(led0)  // 获取设备树中 LED 节点的标识符

void main(void) {
    const struct device *led_dev = DEVICE_DT_GET(LED_NODE);
    if (!device_is_ready(led_dev)) {
        printk("LED device not ready\n");
        return;
    }
    printk("LED device ready\n");
}

3.4 添加外设支持

如果你需要为新的外设添加支持，可以按照以下步骤操作：

1. 定义设备树节点：在 .dts 文件中添加外设的节点描述。

2. 编写驱动程序：在 Zephyr 中实现外设的驱动程序，并通过 compatible 属性与设备树节点匹配。

3. 配置 Kconfig：在 Kconfig 文件中添加外设的配置选项。

4. 设备树的高级技巧

4.1 设备树覆盖（Overlay）

设备树覆盖允许在不修改原始设备树文件的情况下，动态添加或修改节点。这在调试或适配不同硬件配置时非常有用。

dts

复制

// my_overlay.overlay
&gpio0 {
    status = "disabled";
};

在构建时，可以通过 -DOVERLAY_CONFIG=my_overlay.overlay 指定覆盖文件。

4.2 设备树绑定（Bindings）

设备树绑定是 Zephyr 中用于验证设备树节点是否符合预期的机制。每个外设都需要一个绑定文件（.yaml），用于定义节点的属性和约束。

yaml

复制

# gpio.yaml
description: GPIO device
compatible: "vendor,gpio"
properties:
  reg:
    type: array
    required: true
  interrupts:
    type: array
    required: true

4.3 调试设备树

Zephyr 提供了以下工具来调试设备树：

• west build -t menuconfig：通过图形化界面查看和修改设备树配置。

• west build -t guiconfig：查看设备树的生成结果。

5. 实战：为 Zephyr 添加一个 LED 设备

5.1 修改设备树

在板卡的 .dts 文件中添加 LED 节点：

dts

复制

/ {
    leds {
        compatible = "gpio-leds";
        led0: led_0 {
            gpios = <&gpio0 12 GPIO_ACTIVE_HIGH>;
            label = "User LED";
        };
    };
};

5.2 编写应用程序

在应用程序中访问 LED 设备并控制其状态：

c

复制

#include <zephyr.h>
#include <device.h>
#include <drivers/gpio.h>

#define LED_NODE DT_NODELABEL(led0)

void main(void) {
    const struct device *led_dev = DEVICE_DT_GET(LED_NODE);
    if (!device_is_ready(led_dev)) {
        printk("LED device not ready\n");
        return;
    }

    while (1) {
        gpio_pin_set(led_dev, 12, 1);
        k_sleep(K_MSEC(500));
        gpio_pin_set(led_dev, 12, 0);
        k_sleep(K_MSEC(500));
    }
}

6. 总结

设备树是 Zephyr RTOS 中管理硬件资源的强大工具。通过掌握设备树的语法和使用方法，你可以轻松配置和适配不同的硬件平台。无论是添加新外设还是调试现有硬件，设备树都能为你提供清晰的路径。希望这篇指南能帮助你解锁 Zephyr 设备树的魔法，开启嵌入式开发的无限可能！

参考资料

• Zephyr 官方文档：设备树

• Linux 设备树语法

• Zephyr 设备树绑定规范