RV1106 DTS设备树编译失败常见原因？

Question

RV1106 DTS设备树编译失败的常见原因之一是设备树源文件（.dts）中节点命名不规范或存在语法错误。例如，使用非法字符、未正确引用compatible属性、label定义重复或引用失效，都会导致编译报错。此外，include头文件路径错误或缺失对应的.dtsi头文件，也会引发包含失败。另一个常见问题是单元地址（reg属性）与父节点#address-cells和#size-cells定义不匹配，导致解析出错。这些语法和结构问题在编译时通常会触发“Malformed property”或“Undefined node”等错误提示，需仔细检查DTS结构与Rockchip平台规范的一致性。

Answer 1

1. RV1106 DTS设备树编译失败的常见原因概述

在嵌入式Linux开发中，设备树（Device Tree）是描述硬件资源的关键机制。RV1106作为Rockchip推出的AI视觉处理芯片，其DTS编译过程对语法和结构一致性要求极高。一旦源文件（.dts）存在命名不规范或语法错误，将直接导致编译失败。常见的报错如“Malformed property”、“Undefined node reference”等，通常源于基础语法疏漏。

2. 节点命名与语法错误分析

• 非法字符使用：节点名称中包含空格、特殊符号（如@#$%），仅允许使用字母、数字、连字符（-）和下划线（_）。
• compatible属性错误：未正确引用厂商前缀或驱动匹配字符串，例如应为"rockchip,rk805"而非"rk805"。
• Label定义冲突：同一label被多次定义，或引用了未定义的label，造成链接阶段解析失败。

3. Include头文件路径问题排查

DTS文件依赖.dtsi头文件进行平台共性配置复用。若include路径错误或文件缺失，预处理器无法完成包含操作。

问题类型	典型表现	解决方案
路径错误	#include "xxx.dtsi" 找不到文件	检查Kbuild搜索路径，使用相对路径或绝对路径修正
文件缺失	fatal error: rk3328.dtsi: No such file	确认SDK版本完整性，同步更新vendor/dts/目录
拼写错误	rk1106.dtsi误写为rv1106.dtsi	核对SoC型号与dtsi命名一致性

4. reg属性与地址单元不匹配问题

父节点通过#address-cells和#size-cells定义子节点reg属性的格式长度。若二者不匹配，dtc工具会抛出解析异常。

        
&i2c0 {
    #address-cells = <1>;
    #size-cells = <0>;

    sensor@3c {
        compatible = "ov,ov9734";
        reg = <0x3c>;  // 符合#address-cells=1, #size-cells=0
    };
};
        
    

若此处reg写成<0x3c 0x10>，则因#size-cells为0而触发“bad cell count”错误。

5. 编译错误日志分析流程图

graph TD
            A[编译报错] --> B{错误类型判断}
            B --> C["Malformed property"]
            B --> D["Undefined node or label"]
            B --> E["Failed to include file"]
            C --> F[检查property语法，如reg、interrupts]
            D --> G[查找label定义位置，确认唯一性]
            E --> H[验证include路径及文件存在性]
            F --> I[修复后重新编译]
            G --> I
            H --> I

6. 深度调试技巧与工具链支持

利用dtc反汇编功能可深入定位问题：

        
# 将.dtb转回.dts便于审查
dtc -I dtb -O dts -o output.dts input.dtb

# 启用详细输出
make ARCH=arm dtbs V=1
        
    

结合GCC预处理阶段提取.i文件，查看宏展开后的实际内容：

        
cpp -E -nostdinc -I./include -I./arch/arm/boot/dts rv1106-evb.dts -o rv1106-evb.i
        
    

7. Rockchip平台规范一致性校验

Rockchip维护严格的DTS编码规范，开发者需参照官方文档确保以下几点：

1. CPU节点必须遵循ARM Core binding标准；
2. PMU（电源管理单元）需正确声明interrupt-parent和irq；
3. I2C/SPI外设节点必须包含clocks、pinctrl引用；
4. GPIO标识须采用<&gpioX Y IRQ_TYPE>格式；
5. DDR频率节点需与dmc firmware兼容；
6. Camera模块需启用csi-dphy-tx-subsystem；
7. PCIe控制器需设置正确的reset-gpios与时钟源；
8. UART默认console需标注stdout-path；
9. 安全启动相关节点不得随意删改；
10. 自定义节点建议添加vendor前缀避免冲突。