romulan 0.1.1

Rust library for parsing a number of firmware images
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

// SPDX-License-Identifier: MIT

use alloc::string::String;
use core::mem;

pub mod flash;
pub mod directory;

pub struct Rom<'a> {
    data: &'a [u8],
    signature: &'a flash::Signature,
}

impl<'a> Rom<'a> {
    pub fn new(data: &'a [u8]) -> Result<Rom, String> {
        let mut i = 0;

        while i + mem::size_of::<flash::Signature>() <= data.len() {
            if data[i..i + 4] == [0xaa, 0x55, 0xaa, 0x55] {
                return Ok(Rom {
                    data: &data[i..],
                    signature: plain::from_bytes(&data[i..]).map_err(|err| {
                        format!("Flash signature invalid: {:?}", err)
                    })?
                });
            }

            i += 4;
        }

        Err(format!("Flash signature not found"))
    }

    pub fn data(&self) -> &'a [u8] {
        self.data
    }

    pub fn signature(&self) -> &'a flash::Signature {
        self.signature
    }
}