3 releases
0.1.2 | Feb 19, 2023 |
---|---|
0.1.1 | Feb 19, 2023 |
0.1.0 | Feb 19, 2023 |
#1859 in Parser implementations
38 downloads per month
90KB
2K
SLoC
devicetree-tool
A device tree building and parsing tool written in Rust
General
This project is in early stage and should not be used with production workloads.
devicetree-tool
is both:
- A Rust crate that can be used for manipulating device trees
- A command line tool based on the crate that can be used to encode and decode device tree files
The center of devicetree-tool
is the meta data consisting the device tree:
DeviceTree
- The top level structure of the device tree meta dataNode
- A node in the device tree, representing a deviceProperty
- A property item of the device nodeReservation
- Physical memeory reservation block of the device tree
The device tree meta data can be created from the source code, or be built from the content of DTS or DTB files. The meta data can also be managed in source code, or be encoded to DTS or DTB format.
devicetree-tool
Crate
Examples
Create a device tree from scratch:
use devicetree_tool::Node;
use devicetree_tool::DeviceTree;
fn main() {
// Create the root node
let mut node = Node::new("");
// Add a property
node.add_property(Property::new_u32("prop", 42));
// Add a sub node
node.add_sub_node(Node::new("sub_node"));
// Create the device tree from the root node
let tree = DeviceTree::new(vec![], node);
assert_eq!(
format!("{}", tree),
"/dts-v1/;\n\n/ {\n\tprop = <0x0 0x0 0x0 0x2a>;\
\n\n\tsub_node {\n\t};\n};\n\n"
);
}
devicetree-tool
Crate
Examples
Encode a DTS file to DTB:
# Build devicetree-tool
cargo build --release
# Create a simple DTS file
cat << EOF > ./temp.dts
/dts-v1/;
/ {
cpus {
#address-cells = <0x02>;
#size-cells = <0x00>;
cpu@0 {
device_type = "cpu";
compatible = "arm,arm-v8";
enable-method = "psci";
reg = <0x00 0x00>;
};
};
};
EOF
# Decode the DTS file into DTB
./target/release/devicetree-tool \
--in-type dts --in-file ./temp.dts \
--out-type dtb --out-file ./temp.dtb
Dependencies
~0.4–1MB
~23K SLoC