你提供的图片显示的是 **设备树（Device Tree）编译时的警告信息**，并非“错误”（error），但大量警告可能影响系统稳定性或功能正常性。这些警告主要来自 `dtc`（Device Tree Compiler）在编译 `.dts` 文件时触发的检查规则。 --- ## 🔍 一、核心问题分析 从截图中可以看到两类主要警告： ### ✅ 类型1：`Failed prerequisite 'reg_format'` ``` (pci_device_reg): Failed prerequisite 'reg_format' (simple_bus_reg): Failed prerequisite 'reg_format' ... ``` **含义**：某些节点（如 PCI、I2C、SPI 总线等）的 `reg` 属性格式不符合预期规范。 👉 **原因**：通常是因为 `reg` 属性的值没有按照该总线类型的标准格式书写（比如地址/长度对的数量不对，或缺少必要的父节点定义）。 > 📌 示例：对于 simple-bus 下的设备，`reg = <base_addr size>;` 是标准格式；如果写成 `<base_addr>` 或 `<base_addr size extra>` 就会触发此警告。 --- ### ✅ 类型2：`Warning (clocks_property): ... cell X is not a phandle reference` ``` /cpus/cpu@0:clocks: cell 0 is not a phandle reference /soc/uart@28000000:clocks: cell 0 is not a phandle reference ... ``` **含义**：`clocks` 属性中的某个单元格（cell）应该是一个指向时钟控制器的 **phandle 引用**（即 `&clk_controller`），但它被写成了一个普通数值（如 `<0>` 或 `<1>`）。 👉 **原因**： - 你可能直接写了数字而不是引用时钟节点。 - 或者时钟节点未正确定义或未通过 `phandle` 暴露出来。 - 也可能是时钟绑定文档要求使用特定格式（如两个 cell：第一个是 phandle，第二个是 clock ID），而你只给了一个数字。 > 📌 正确写法示例： ```dts clocks = <&clkc 5>; // &clkc 是 phandle，5 是 clock ID ``` ❌ 错误写法： ```dts clocks = <5>; // 缺少 phandle！ ``` --- ### ✅ 类型3：`Relying on default #address-cells / #size-cells` ``` Warning (avoid_default_addr_size): /soc/qspi@28014000/flash@0: Relying on default #a... ``` 👉 **含义**：子节点依赖父节点隐式继承 `#address-cells` 和 `#size-cells`，但显式声明更安全、更清晰。 👉 **建议**：虽然这不是严重问题，但在生产环境中应明确写出这两个属性以避免歧义。 --- ## ️ 二、修改方法汇总 ### ✔️ 针对 `reg_format` 警告： 1. 检查所有带 `reg` 属性的节点是否符合其所在总线的规范。 2. 确保每个 `reg` 的值是成对的 `<addr size>`（除非是特殊总线如 PCIe 可能有多个 BAR）。 3. 如果是 `simple-bus` 子节点，必须保证父节点定义了 `#address-cells = <1>; #size-cells = <1>;`。 ✅ 示例修复： ```dts // 原始（可能报错） flash@0 { reg = <0>; }; // 修正后 flash@0 { reg = <0 0x1000000>; // 地址 + 大小 }; ``` --- ### ✔️ 针对 `clocks_property` 警告： 1. 找到所有出现 `clocks = <X>;` 的地方。 2. 确认 X 是否应该是 phandle + clock-id 的组合。 3. 查找对应的时钟控制器节点，并用 `&label` 引用它。 ✅ 示例修复： ```dts // 原始（错误） uart@28000000 { clocks = <0>; }; // 修正后（假设有一个名为 clkc 的时钟控制器） uart@28000000 { clocks = <&clkc 0>; }; ``` ⚠️ 注意：如果你不知道哪个是时钟控制器，请查看芯片手册或参考平台已有的 DTS 文件（如 arch/arm64/boot/dts/xxx.dtsi）。 --- ### ✔️ 针对 `avoid_default_addr_size` 警告： 在父节点中显式添加： ```dts soc { #address-cells = <1>; #size-cells = <1>; compatible = "simple-bus"; ... }; ``` 这样所有子节点就不需要再重复定义，也不会触发警告。 --- ## 🧪 三、如何验证修复？ 重新编译设备树： ```bash dtc -I dts -O dtb -o output.dts input.dts ``` 或者如果你用的是内核构建系统： ```bash make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- dtbs ``` 观察是否还有类似警告。若仍有警告，可尝试加 `-Wno-xxx` 参数临时屏蔽（不推荐用于最终版本）： ```bash dtc -W no-unit_address_vs_reg -I dts -O dtb ... ``` 但最好还是从根本上解决。 --- ## 💡 四、额外建议 - 使用 `dtc -@` 开启详细输出，帮助定位具体哪一行出错。 - 参考官方绑定文档：https://www.kernel.org/doc/html/latest/devicetree/bindings/ - 对于 ARM64 平台，优先参考 `arch/arm64/boot/dts/` 下已有平台的实现方式。 - 若你是基于某款 SoC（如 Rockchip, Allwinner, NXP i.MX 等），请查阅该厂商提供的 BSP 或 SDK 中的 DTS 模板。 --- ## ✅ 总结 | 警告类型 | 原因 | 解决方案 | |----------|------|-----------| | `reg_format` | `reg` 格式不符总线规范 | 补全 `<addr size>` 对，确认父节点 `#address-cells/#size-cells` | | `clocks_property` | `clocks` 中用了非 phandle 值 | 改为 `<&clk_ctrl id>` 形式 | | `avoid_default_addr_size` | 隐式继承地址/大小单元数 | 显式声明 `#address-cells` 和 `#size-cells` | --- 📌 **最后提醒**：这些虽然是 warning，但在嵌入式系统中可能导致驱动无法加载、外设不能工作等问题，务必认真对待并逐一修复！ 如果你能提供具体的 `.dts` 片段，我可以帮你逐行指出哪里需要改 😊