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

Zephyr RTOS 是一个开源的实时操作系统，专为资源受限的嵌入式设备设计。为了支持多种硬件平台和外设，Zephyr 采用了设备树（Device Tree）机制来描述硬件资源。设备树是一种数据结构，用于描述系统中的硬件组件及其配置信息。本文将详细介绍如何在 Zephyr 中使用设备树，包括设备树的基本语法、如何添加外设支持以及如何在 Zephyr 项目中配置和使用设备树。

Possumic正和微芯官方

2129人浏览 · 2025-03-03 14:10:00

Possumic正和微芯官方 · 2025-03-03 14:10:00 发布

引言

在嵌入式开发的世界中，硬件配置往往是一项复杂且容易出错的任务。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 来访问设备树中的信息。以下是一个简单的示例：

复制

#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 添加外设支持

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

定义设备树节点：在 .dts 文件中添加外设的节点描述。
编写驱动程序：在 Zephyr 中实现外设的驱动程序，并通过 compatible 属性与设备树节点匹配。
配置 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 设备并控制其状态：

复制

#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));
    }
}