fdt-edit-0.1.0 has been yanked.

fdt-edit

用于创建、编辑和编码设备树（FDT）的高级 Rust 库。

概述

fdt-edit 是一个功能丰富的设备树操作库，基于 fdt-raw 构建，提供了完整的设备树创建、编辑和编码功能。该库支持从零创建新的设备树，修改现有的设备树，以及将编辑后的设备树编码为标准 DTB 格式。

特性

完整的设备树编辑：支持节点和属性的增删改查
类型安全的节点操作：提供专门的节点类型（时钟、内存、PCI、中断控制器等）
高效的编码器：将内存中的设备树结构编码为标准 DTB 格式
phandle 管理：自动 phandle 分配和引用管理
内存保留块支持：完整的内存保留区域操作
no_std 兼容：适用于嵌入式环境

核心组件

Fdt 结构

可编辑的设备树容器：

从原始 DTB 数据解析
创建新的空设备树
管理 phandle 缓存
编码为 DTB 格式

节点系统

支持多种专用节点类型：

时钟节点：时钟源和时钟消费者
内存节点：内存区域定义
PCI 节点：PCI 总线和设备
中断控制器：中断映射和管理
通用节点：可自定义的节点类型

属性系统

强类型属性：各种数据类型的属性支持
自动属性管理：智能的属性增删改查
格式化显示：友好的节点和属性显示

快速开始

use fdt_edit::{Fdt, Node, NodeKind};

// 创建新的空设备树
let mut fdt = Fdt::new();

// 添加根节点下的子节点
let memory_node = fdt.root_mut()
    .add_child("memory@80000000")
    .unwrap();
memory_node.add_property("device_type", "memory")?;
memory_node.add_property("reg", &[0x8000_0000u64, 0x1000_0000u64])?;

// 添加时钟节点
let clock_node = fdt.root_mut()
    .add_child("clk_osc")
    .unwrap();
clock_node.add_property("compatible", &["fixed-clock"])?;
clock_node.add_property("#clock-cells", &[0u32])?;
clock_node.add_property("clock-frequency", &[24_000_000u32])?;

// 编码为 DTB 数据
let dtb_data = fdt.encode()?;

从现有 DTB 编辑

// 解析现有 DTB
let mut fdt = Fdt::from_bytes(&existing_dtb)?;

// 查找并修改节点
if let Some(cpu_node) = fdt.root_mut()
    .find_child_mut("cpus")?
    .and_then(|n| n.find_child_mut("cpu@0")) {

    // 修改时钟频率
    cpu_node.set_property("clock-frequency", &[1_200_000_000u32])?;
}

// 添加新的属性
cpu_node.add_property("new-property", "value")?;

// 重新编码
let modified_dtb = fdt.encode()?;

节点遍历和查找

// 遍历所有节点
for node in fdt.root().traverse() {
    match node.kind() {
        NodeKind::Memory(mem) => {
            println!("Memory node: {:x?}", mem.regions());
        }
        NodeKind::Clock(clock) => {
            println!("Clock: {}, freq: {}", clock.name(), clock.frequency()?);
        }
        _ => {
            println!("Generic node: {}", node.name());
        }
    }
}

// 查找特定节点
if let Some(chosen) = fdt.root().find_child("chosen") {
    if let Some(bootargs) = chosen.get_property("bootargs") {
        println!("Boot args: {}", bootargs.as_str()?);
    }
}

依赖

fdt-raw - 底层 FDT 解析库
log = "0.4" - 日志记录
enum_dispatch = "0.3.13" - 枚举分发优化

开发依赖

dtb-file - 测试数据
env_logger = "0.11" - 日志实现

许可证

本项目采用开源许可证，具体许可证类型请查看项目根目录的 LICENSE 文件。

贡献

欢迎提交 Issue 和 Pull Request。请确保：

代码遵循项目的格式规范（cargo fmt）
通过所有测试（cargo test）
通过 Clippy 检查（cargo clippy）
新功能添加相应的测试用例

示例

更多使用示例请查看 examples/ 目录（如果存在）或源码中的测试用例。

fdt-edit 0.1.0