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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

//! §2.3

mod reg;
mod str;
mod u32;

use self::u32::u32_from;
use crate::StructureBlock;
use core::{fmt, slice};

pub use self::str::{Str, StrList};
pub use self::u32::PHandle;
pub use reg::Reg;
pub(crate) use reg::RegCfg;

/// 属性
pub enum Property<'a> {
    /// §2.3.1 兼容性
    Compatible(StrList<'a>),
    /// §2.3.2 型号
    Model(Str<'a>),
    /// §2.3.3 引用号
    PHandle(PHandle),
    /// §2.3.4 状态
    Status(Str<'a>),
    /// §2.3.6 寄存器
    Reg(Reg<'a>),
    /// §2.3.7 寄存器
    VirtualReg(u32),
    /// §2.3.10 DMA 连贯性
    DmaCoherent,
    /// 一般属性
    General { name: Str<'a>, value: &'a [u8] },
}

struct Error;
type Result<T> = core::result::Result<T, Error>;

impl<'a> Property<'a> {
    pub(crate) fn new(name: &'a [u8], value: &'a [StructureBlock], len: usize) -> Self {
        let general = |Error| Self::General {
            name: Str(name),
            value: unsafe { slice::from_raw_parts(value.as_ptr().cast(), len) },
        };
        match name {
            b"compatible" => StrList::new(value, len).map_or_else(general, Self::Compatible),
            b"model" => Str::new(value, len).map_or_else(general, Self::Model),
            b"phandle" | b"linux,phandle" => u32_from(value)
                .map(PHandle)
                .map_or_else(general, Self::PHandle),
            b"status" => Str::new(value, len).map_or_else(general, Self::Status),
            b"virtual-reg" => u32_from(value).map_or_else(general, Self::VirtualReg),
            b"dma-coherent" if value.is_empty() => Self::DmaCoherent,
            _ => general(Error),
        }
    }
}

impl fmt::Debug for Property<'_> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Property::Compatible(compatible) => write!(f, "compatible = {compatible};"),
            Property::Model(model) => write!(f, "model = {model};"),
            Property::Reg(reg) => write!(f, "reg = {reg:#x?};"),
            Property::PHandle(phandle) => write!(f, "phandle = {phandle:?};"),
            Property::Status(status) => write!(f, "status = {status};"),
            Property::VirtualReg(vreg) => {
                write!(f, "virtual-reg = <")?;
                vreg.fmt(f)?;
                write!(f, ">;")
            }
            Property::DmaCoherent => write!(f, "dma-coherent;"),
            Property::General { name, value } => {
                write!(f, "{}", unsafe { name.as_str_unchecked() })?;
                match name {
                    _ if !value.is_empty() => {
                        write!(f, " = {value:02x?};")
                    }
                    _ => {
                        write!(f, ";")
                    }
                }
            }
        }
    }
}