必须先验证魔数：用std::ifstream以binary模式读取前4字节到uint8_t[4]，按大端拼成0xd00dfeed；不可直接按小端解析uint32_t。
如何用 C++ 读取 DTB 文件的原始字节并验证魔数
DTB 文件不是普通文本，不能用 fstream 直接当 XML 或 JSON 解析。第一步必须确认文件确实是合法 DTB：它开头 4 字节是大端序的魔数 0xd00dfeed（注意字节序）。很多初学者直接 std::ifstream::read() 后按小端解析，结果头两个 uint32_t 全错。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
std::ifstream以std::ios::binary模式打开，read()前 4 字节到uint8_t[4]数组 - 手动拼成大端整数：
magic = (buf[0] ，再比对 <code>0xd00dfeed - 别依赖
htonl()—— 它转的是主机序到网络序，而 DTB 魔数是固定大端布局，和主机无关 - 验证失败时，检查文件是否被截断（
stat看大小是否 .dts 源文件
dtc 工具链的 libfdt 是唯一靠谱的解析入口
Linux 内核源码树里的 scripts/dtc/libfdt/ 提供了稳定 ABI 的 C 接口（fdt.h），C++ 可直接 extern "C" 包含。自己手写偏移计算、字符串表跳转、结构块对齐（DTB 要求 4 字节对齐，但某些字段需 8 字节）极易出错——比如 fdt_first_subnode() 返回负值不一定是没子节点，可能是 offset 超出 fdt_totalsize() 边界。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 编译时链接
-lfdt（Debian/Ubuntu 装libfdt-dev；从源码编译 dtc 时加make LIBFDT=y） - 关键函数必须配对使用：
fdt_open_into()处理可能被重定位的 DTB；fdt_check_header()必须在任何fdt_node_offset_by_*前调用 - 不要假设
fdt_getprop()返回的字符串以\0结尾——它返回的是指向 property value 的裸指针，长度由第 4 参数lenp输出，需用std::string_view(prop, *lenp)安全封装
遍历节点时如何安全处理 name 和 prop 的内存生命周期
libfdt 所有 fdt_*_name() 和 fdt_getprop() 返回的指针都指向 DTB 内存映射区，**不分配新内存**。C++ 容易在这里踩坑：把返回的 const char* 直接塞进 std::string 构造函数，却忘了 DTB buffer 生命周期结束（munmap() 或 std::vector<uint8_t></uint8_t> 析构）后字符串立即悬空。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- DTB 数据用
std::vector<uint8_t></uint8_t>加载后，用fdt_open_into()将其转为可查询格式，之后所有操作基于该 vector 内存 - 对节点名，用
fdt_get_name(fdt, offset, &len)+std::string(name, len)拷贝一份；对属性值，用std::vector<uint8_t>(prop, prop + len)</uint8_t>或std::string_view（确保 vector 不析构） - 避免在 lambda 捕获中直接存裸指针，例如
[name = fdt_get_name(...)](){ /* use name */ }是危险的
解析中断、reg、phandle 等复合属性的典型模式
像 interrupts、reg 这类属性不是字符串，而是按特定格式排列的 uint32_t 数组。例如 reg = 在 DTB 中占 4 个 uint32_t，需按 #address-cells / #size-cells 解包；phandle 是单个 uint32_t，但必须用 fdt_get_phandle() 获取，不能直接 fdt_getprop() 后 reinterpret_cast。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 查
#address-cells和#size-cells必须从当前节点向上回溯到根节点（fdt_path_offset(fdt, "/")），不能只看父节点——某些 SoC 的子节点会覆盖这些值 - 用
fdt_address_cells()和fdt_size_cells()获取当前节点生效的数值，再配合fdt_getprop()返回的 raw data 循环解析 - 对
interrupts，优先用fdt_interrupt_reg()（libfdt ≥ 1.7.0）而非手算；旧版本需参考Documentation/devicetree/bindings/interrupt-controller/arm,gic.yaml中的编码规则
DTB 解析真正的难点不在读取，而在理解每个属性的语义约束——同一个 reg 字段，在 PCI 设备和 AMBA 总线上解包逻辑完全不同，必须结合 compatible 字符串查对应 binding 文档。跳过这步直接硬编码解析，迟早遇到 arm64 和 riscv 平台行为不一致的问题。
