1use core::ops::Range;
2
3use portable_atomic::{AtomicU8, Ordering};
4
5pub use self::implementation::*;
6
7#[cfg_attr(esp32, path = "esp32/mod.rs")]
8#[cfg_attr(esp32c2, path = "esp32c2/mod.rs")]
9#[cfg_attr(esp32c3, path = "esp32c3/mod.rs")]
10#[cfg_attr(esp32c6, path = "esp32c6/mod.rs")]
11#[cfg_attr(esp32h2, path = "esp32h2/mod.rs")]
12#[cfg_attr(esp32s2, path = "esp32s2/mod.rs")]
13#[cfg_attr(esp32s3, path = "esp32s3/mod.rs")]
14mod implementation;
15
16mod efuse_field;
17
18#[cfg(feature = "psram")]
19mod psram_common;
20
21#[cfg(feature = "psram")]
28static mut MAPPED_PSRAM: MappedPsram = MappedPsram { memory_range: 0..0 };
29
30pub(crate) fn psram_range() -> Range<usize> {
31 cfg_if::cfg_if! {
32 if #[cfg(feature = "psram")] {
33 #[allow(static_mut_refs)]
34 unsafe { MAPPED_PSRAM.memory_range.clone() }
35 } else {
36 0..0
37 }
38 }
39}
40
41const DRAM: Range<usize> = self::constants::SOC_DRAM_LOW..self::constants::SOC_DRAM_HIGH;
42
43#[cfg(feature = "psram")]
44pub struct MappedPsram {
45 memory_range: Range<usize>,
46}
47
48#[cfg_attr(not(feature = "unstable"), allow(unused))]
57static MAC_OVERRIDE_STATE: AtomicU8 = AtomicU8::new(0);
58#[cfg_attr(not(feature = "unstable"), allow(unused))]
59static mut MAC_OVERRIDE: [u8; 6] = [0; 6];
60
61#[derive(PartialEq, Eq, Copy, Clone, Debug)]
63#[cfg_attr(not(feature = "unstable"), allow(unused))]
64pub enum SetMacError {
65 AlreadySet,
67}
68
69#[cfg_attr(not(feature = "unstable"), allow(unused))]
70impl self::efuse::Efuse {
71 pub fn set_mac_address(mac: [u8; 6]) -> Result<(), SetMacError> {
79 if MAC_OVERRIDE_STATE
80 .compare_exchange(0, 1, Ordering::Relaxed, Ordering::Relaxed)
81 .is_err()
82 {
83 return Err(SetMacError::AlreadySet);
84 }
85
86 unsafe {
87 MAC_OVERRIDE = mac;
88 }
89
90 MAC_OVERRIDE_STATE.store(2, Ordering::Relaxed);
91
92 Ok(())
93 }
94
95 pub fn mac_address() -> [u8; 6] {
100 if MAC_OVERRIDE_STATE.load(Ordering::Relaxed) == 2 {
101 unsafe { MAC_OVERRIDE }
102 } else {
103 Self::read_base_mac_address()
104 }
105 }
106}
107
108#[allow(unused)]
109pub(crate) fn is_valid_ram_address(address: usize) -> bool {
110 addr_in_range(address, DRAM)
111}
112
113#[allow(unused)]
114pub(crate) fn is_slice_in_dram<T>(slice: &[T]) -> bool {
115 slice_in_range(slice, DRAM)
116}
117
118#[allow(unused)]
119pub(crate) fn is_valid_psram_address(address: usize) -> bool {
120 addr_in_range(address, psram_range())
121}
122
123#[allow(unused)]
124pub(crate) fn is_slice_in_psram<T>(slice: &[T]) -> bool {
125 slice_in_range(slice, psram_range())
126}
127
128#[allow(unused)]
129pub(crate) fn is_valid_memory_address(address: usize) -> bool {
130 is_valid_ram_address(address) || is_valid_psram_address(address)
131}
132
133fn slice_in_range<T>(slice: &[T], range: Range<usize>) -> bool {
134 let slice = slice.as_ptr_range();
135 let start = slice.start as usize;
136 let end = slice.end as usize;
137 addr_in_range(start, range.clone()) && end <= range.end
141}
142
143pub(crate) fn addr_in_range(addr: usize, range: Range<usize>) -> bool {
144 range.contains(&addr)
145}