DTB

Device tree blob utilities

This no_std crate contains types for reading and writing DTBs. Here is a code showing how to read a DTB-file:

```rust let mut buf = Vec::new(); let mut file = File::open("example.dtb").unwrap(); file.readtoend(&mut buf).unwrap(); let reader = Reader::read(buf.as_slice()).unwrap();

for entry in reader.reservedmementries() { println!("reserved: {:?}, {:?}", entry.address, entry.size); }

let root = reader.structitems(); let (prop, _) = root.pathstructitems("/node/property").next().unwrap(); println!("property: {:?}, {:?}", prop.name(), prop.valuestr());

let (node, nodeiter) = root.pathstructitems("/node/node2").next().unwrap(); println!("node: {:?}@{:?}", node.nodename(), node.unit_address());

let mut buf = [0; 32];

let (prop, ) = nodeiter.pathstructitems("property").next().unwrap(); println!( "property: {:?}, {:?}", prop.name(), prop.valuestrlist(&mut buf) );

let (prop, ) = nodeiter.pathstructitems("property2").next().unwrap(); println!( "property: {:?}, {:?}", prop.name(), prop.valueu32list(&mut buf) ); ```

To read DTB directly from a memory address use Reader::read_from_address().

To run a test sample execute: sh cargo run --example dump src/test_dtb/sample.dtb

Fuzzing instructions

The reader (and methods of read items) can be fuzzed with [cargo-fuzz/libfuzzer] which can be installed as cargo install cargo-fuzz. Note that the coverage is not yet complete but provides a straightforward harness. The baseline corpus is the directory of tests is src/test_dtb. Note that this command will require a nightly compiler.

cargo fuzz run reader src/test_dtb