stm32-eth 0.8.2

Embedded Rust Ethernet driver for the STM32 MCU series
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
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

use core::ops::{Deref, DerefMut};

use aligned::{Aligned, A8};
use volatile_register::{RO, RW};

#[cfg(not(feature = "stm32f1xx-hal"))]
const DESC_SIZE: usize = 8;

#[cfg(feature = "stm32f1xx-hal")]
const DESC_SIZE: usize = 4;

#[repr(C)]
pub struct Descriptor {
    pub(crate) desc: Aligned<A8, [u32; DESC_SIZE]>,
}

impl Clone for Descriptor {
    fn clone(&self) -> Self {
        Descriptor {
            desc: Aligned(*self.desc),
        }
    }
}

impl Default for Descriptor {
    fn default() -> Self {
        Self::new()
    }
}

impl Descriptor {
    pub const fn new() -> Self {
        Self {
            desc: Aligned([0; DESC_SIZE]),
        }
    }

    pub unsafe fn clear(&mut self) {
        (0..DESC_SIZE).for_each(|i| self.write(i, 0));
    }

    fn r(&self, n: usize) -> &RO<u32> {
        let ro = &self.desc.deref()[n] as *const _ as *const RO<u32>;
        unsafe { &*ro }
    }

    unsafe fn rw(&mut self, n: usize) -> &mut RW<u32> {
        let rw = &mut self.desc.deref_mut()[n] as *mut _ as *mut RW<u32>;
        &mut *rw
    }

    pub fn read(&self, n: usize) -> u32 {
        self.r(n).read()
    }

    pub unsafe fn write(&mut self, n: usize, value: u32) {
        self.rw(n).write(value)
    }

    pub unsafe fn modify<F>(&mut self, n: usize, f: F)
    where
        F: FnOnce(u32) -> u32,
    {
        self.rw(n).modify(f)
    }
}