dtb_walker/property/
mod.rs

1//! §2.3
2
3mod reg;
4mod str;
5mod u32;
6
7use self::u32::u32_from;
8use crate::StructureBlock;
9use core::{fmt, slice};
10
11pub use self::str::{Str, StrList};
12pub use self::u32::PHandle;
13pub use reg::Reg;
14pub(crate) use reg::RegCfg;
15
16/// 属性
17pub enum Property<'a> {
18    /// §2.3.1 兼容性
19    Compatible(StrList<'a>),
20    /// §2.3.2 型号
21    Model(Str<'a>),
22    /// §2.3.3 引用号
23    PHandle(PHandle),
24    /// §2.3.4 状态
25    Status(Str<'a>),
26    /// §2.3.6 寄存器
27    Reg(Reg<'a>),
28    /// §2.3.7 寄存器
29    VirtualReg(u32),
30    /// §2.3.10 DMA 连贯性
31    DmaCoherent,
32    /// 一般属性
33    General { name: Str<'a>, value: &'a [u8] },
34}
35
36struct Error;
37type Result<T> = core::result::Result<T, Error>;
38
39impl<'a> Property<'a> {
40    pub(crate) fn new(name: &'a [u8], value: &'a [StructureBlock], len: usize) -> Self {
41        let general = |Error| Self::General {
42            name: Str(name),
43            value: unsafe { slice::from_raw_parts(value.as_ptr().cast(), len) },
44        };
45        match name {
46            b"compatible" => StrList::new(value, len).map_or_else(general, Self::Compatible),
47            b"model" => Str::new(value, len).map_or_else(general, Self::Model),
48            b"phandle" | b"linux,phandle" => u32_from(value)
49                .map(PHandle)
50                .map_or_else(general, Self::PHandle),
51            b"status" => Str::new(value, len).map_or_else(general, Self::Status),
52            b"virtual-reg" => u32_from(value).map_or_else(general, Self::VirtualReg),
53            b"dma-coherent" if value.is_empty() => Self::DmaCoherent,
54            _ => general(Error),
55        }
56    }
57}
58
59impl fmt::Debug for Property<'_> {
60    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
61        match self {
62            Property::Compatible(compatible) => write!(f, "compatible = {compatible};"),
63            Property::Model(model) => write!(f, "model = {model};"),
64            Property::Reg(reg) => write!(f, "reg = {reg:#x?};"),
65            Property::PHandle(phandle) => write!(f, "phandle = {phandle:?};"),
66            Property::Status(status) => write!(f, "status = {status};"),
67            Property::VirtualReg(vreg) => {
68                write!(f, "virtual-reg = <")?;
69                vreg.fmt(f)?;
70                write!(f, ">;")
71            }
72            Property::DmaCoherent => write!(f, "dma-coherent;"),
73            Property::General { name, value } => {
74                write!(f, "{}", unsafe { name.as_str_unchecked() })?;
75                match name {
76                    _ if !value.is_empty() => {
77                        write!(f, " = {value:02x?};")
78                    }
79                    _ => {
80                        write!(f, ";")
81                    }
82                }
83            }
84        }
85    }
86}
dtb_walker/property/mod.rs

dtb_walker/property/
mod.rs
