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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
use crate::svd::create_peripheral;
use crate::Result;
pub mod registers;
/// Represents the Synopsys Databook Version of the DWGMAC peripheral.
#[repr(C)]
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum DwGmacVersion {
/// Version 3.40
Version340 = 0x34,
/// Version 3.50
Version350 = 0x35,
/// Version 4.00
Version400 = 0x40,
/// Version 4.10
Version410 = 0x41,
/// Version 5.00
Version500 = 0x50,
/// Version 5.10
Version510 = 0x51,
/// Version 5.20
Version520 = 0x52,
}
impl From<&str> for DwGmacVersion {
fn from(val: &str) -> Self {
if val.contains("3.4") {
Self::Version340
} else if val.contains("3.5") {
Self::Version350
} else if val.contains("4.0") {
Self::Version400
} else if val.contains("4.1") {
Self::Version410
} else if val.contains("5.0") {
Self::Version500
} else if val.contains("5.1") {
Self::Version510
} else if val.contains("5.2") {
Self::Version520
} else {
// Use the latest 3.xx version as a sane default.
// Not all DeviceTree will include the version in the "compatible" property.
Self::Version350
}
}
}
/// Represents a Synopsys DesignWare Gigabit Ethernet MAC (compatible) peripheral
pub struct DwGmac {
peripheral: svd::Peripheral,
}
impl DwGmac {
/// Creates a new [DwGmac] peripheral.
pub fn create(
name: &str,
base_address: u64,
size: u32,
interrupt: Option<Vec<svd::Interrupt>>,
version: DwGmacVersion,
dim: u32,
) -> Result<Self> {
let dim_element = if dim > 0 {
Some(
svd::DimElement::builder()
.dim(dim)
.dim_increment(size)
.build(svd::ValidateLevel::Strict)?,
)
} else {
None
};
let peripheral = create_peripheral(
name,
format!("Synopsys DesignWare Gigabit Ethernet MAC: {name}").as_str(),
base_address,
size,
interrupt,
Some(registers::create(version)?),
dim_element,
)?;
Ok(Self { peripheral })
}
/// Gets a reference to the SVD [`Peripheral`](svd::Peripheral).
pub const fn peripheral(&self) -> &svd::Peripheral {
&self.peripheral
}
/// Gets a mutable reference to the SVD [`Peripheral`](svd::Peripheral).
pub fn peripheral_mut(&mut self) -> &mut svd::Peripheral {
&mut self.peripheral
}
/// Converts the [DwGmac] into the inner SVD [`Peripheral`](svd::Peripheral).
pub fn to_inner(self) -> svd::Peripheral {
self.peripheral
}
}