3. DTS基本语法：分号、花括号、逗号、引号、注释、标签（label）的使用规则

设备树源文件（.dts）采用一种类C语言的语法结构，但更为精简。掌握其基本标点符号和注释规则，是正确编写和解析DTS文件的前提。本章将逐一解析分号、花括号、逗号、引号、注释以及标签（label）的精确用法。

3.1 语法元素总览

下表列出了DTS语法中核心符号的用途与注意事项，便于快速查阅：

3.2 分号（;）—— 语句终结符

在DTS中，每条属性赋值语句必须以分号结尾。分号是编译器（DTC）识别一条完整属性声明的标志。

/dts-v1/;

/ {
    compatible = "vendor,board";    // <-- 分号结束
    model = "Example Board";        // <-- 分号结束
    #address-cells = <1>;           // <-- 分号结束
    #size-cells = <1>;             // <-- 分号结束
};

3.3 花括号（{ }）—— 节点作用域界定符

花括号用于定义一个节点的层级范围。每个节点以{开始，以}结束，内部包含该节点的属性和子节点。

soc {
    compatible = "simple-bus";
    #address-cells = <1>;
    #size-cells = <1>;
    ranges;

    uart0: serial@10000000 {      // 子节点开始
        compatible = "ns16550";
        reg = <0x10000000 0x1000>;
        interrupts = <33>;
    };                            // 子节点结束
};

3.4 逗号（,）—— 列表与多值分隔

逗号在DTS中有三种典型应用场景：

1. 字符串列表分隔： compatible = "vendor1,device1", "vendor2,device2";
2. reg地址/大小对分隔： reg = <0x1000 0x100>, <0x2000 0x200>;
3. 时钟/中断等数组元素分隔： clocks = <&clk1 0>, <&clk2 1>;

// 正确示例：逗号分隔多个compatible值
compatible = "ti,am335x-gpio", "ti,omap-gpio";

// 正确示例：逗号分隔多个reg区域
reg = <0x4A000000 0x1000>, <0x4A001000 0x1000>;

// 错误示例：最后一个元素后误加逗号（某些DTC版本会警告）
// interrupts = <33>, <34>,;

3.5 双引号（" "）—— 字符串属性值

所有字符串类型的属性值必须使用双引号包裹。单引号在DTS中无特殊含义，通常不被使用。

// 字符串属性
compatible = "fsl,imx6q-sabresd";
model = "Freescale i.MX6 Quad SABRE Smart Device Board";

// 字符串列表属性
clock-names = "uart_clk", "ipg_clk";

3.6 注释（// 与 /* */）—— 代码说明

DTS支持两种C语言风格的注释：

// 这是单行注释，用于解释下一行属性的含义
compatible = "vendor,device";

/*
 * 这是块注释，可以跨越多行。
 * 常用于文件头部版权声明或复杂逻辑说明。
 */
#address-cells = <1>;
#size-cells = <1>;

3.7 标签（label）—— 节点引用与复用

标签（label）是DTS中实现节点复用、属性覆盖和追加的核心机制。标签定义在节点名称之前，使用冒号（:）与节点名分隔。

3.7.1 标签定义语法

// 定义标签：uart0 指向 serial@10000000 节点
uart0: serial@10000000 {
    compatible = "ns16550";
    reg = <0x10000000 0x1000>;
    status = "okay";
};

3.7.2 标签引用语法

通过&label语法引用已定义的标签，可以在其他位置追加属性或覆盖原有值：

// 引用 uart0 标签，追加 pinctrl 属性
&uart0 {
    pinctrl-names = "default";
    pinctrl-0 = <&uart0_pins>;
    status = "disabled";  // 覆盖原 status 为 "disabled"
};

3.7.3 标签在include文件中的典型用法

// 在 .dtsi 文件中定义基础节点
// imx6q.dtsi
soc {
    uart1: serial@02020000 {
        compatible = "fsl,imx6q-uart", "fsl,imx21-uart";
        reg = <0x02020000 0x4000>;
        interrupts = <0 26 0x04>;
        status = "disabled";
    };
};

// 在 .dts 文件中通过标签启用并配置
// myboard.dts
#include "imx6q.dtsi"

&uart1 {
    status = "okay";
    pinctrl-0 = <&pinctrl_uart1>;
};

3.8 综合语法示例：分号、花括号、逗号、引号、注释、标签

以下是一个完整的DTS片段，综合展示了本章所有语法元素：

// SPDX-License-Identifier: GPL-2.0
/*
 * 示例设备树：综合语法演示
 * 适用于虚拟平台 vplatform
 */
/dts-v1/;

#include "vplatform.dtsi"

/ {
    model = "Virtual Platform Demo Board";
    compatible = "vendor,vplatform-demo";

    /* 内存节点 */
    memory@80000000 {
        device_type = "memory";
        reg = <0x80000000 0x40000000>;  // 1GB RAM
    };

    /* 简单外设总线 */
    soc {
        compatible = "simple-bus";
        #address-cells = <1>;
        #size-cells = <1>;
        ranges;

        gpio0: gpio@10120000 {
            compatible = "vendor,gpio-controller";
            reg = <0x10120000 0x1000>;
            interrupts = <0 15 4>;
            gpio-controller;
            #gpio-cells = <2>;
        };
    };
};

// 通过标签引用，追加板级特定配置
&gpio0 {
    status = "okay";
    gpio-line-names = "LED_RED", "LED_GREEN", "BTN_USER";
};

3.9 语法规则SVG流程图

下图展示了DTS解析器处理语法元素的基本流程，帮助理解各符号在编译过程中的角色：

3.10 常见语法错误与避坑指南