sdmmc-core 0.5.0

SD/MMC core data structures and algorithms
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
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

//! I/O Operation Conditions Register (`IO_OCR`).

use crate::lib_bitfield;
use crate::result::{Error, Result};

// I/O OCR length in bytes.
const IO_OCR_LEN: usize = 3;

lib_bitfield! {
    /// Represents the SD card I/O operation conditions register (`IO_OCR`).
    pub IoOcr(MSB0 [u8; IO_OCR_LEN]): bool {
        /// VDD Volatage Window (VDD1): 3.5-3.6V.
        pub vdd_3536: 23;
        /// VDD Volatage Window (VDD1): 3.4-3.5V.
        pub vdd_3435: 22;
        /// VDD Volatage Window (VDD1): 3.3-3.4V.
        pub vdd_3334: 21;
        /// VDD Volatage Window (VDD1): 3.2-3.3V.
        pub vdd_3233: 20;
        /// VDD Volatage Window (VDD1): 3.1-3.2V.
        pub vdd_3132: 19;
        /// VDD Volatage Window (VDD1): 3.0-3.1V.
        pub vdd_3031: 18;
        /// VDD Volatage Window (VDD1): 2.9-3.0V.
        pub vdd_2930: 17;
        /// VDD Volatage Window (VDD1): 2.8-2.9V.
        pub vdd_2829: 16;
        /// VDD Volatage Window (VDD1): 2.7-2.8V.
        pub vdd_2728: 15;
        /// VDD Volatage Window (VDD1): 2.6-2.7V.
        pub vdd_2627: 14;
        /// VDD Volatage Window (VDD1): 2.5-2.6V.
        pub vdd_2526: 13;
        /// VDD Volatage Window (VDD1): 2.4-2.5V.
        pub vdd_2425: 12;
        /// VDD Volatage Window (VDD1): 2.3-2.4V.
        pub vdd_2324: 11;
        /// VDD Volatage Window (VDD1): 2.2-2.3V.
        pub vdd_2223: 10;
        /// VDD Volatage Window (VDD1): 2.1-2.2V.
        pub vdd_2122: 9;
        /// VDD Volatage Window (VDD1): 2.0-2.1V.
        pub vdd_2021: 8;
    }
}

impl IoOcr {
    /// Represents the byte length of the [IoOcr].
    pub const LEN: usize = IO_OCR_LEN;

    /// Creates a new [IoOcr].
    pub const fn new() -> Self {
        Self([0; Self::LEN])
    }

    /// Converts the [IoOcr] into a [`u32`].
    pub const fn bits(&self) -> u32 {
        u32::from_be_bytes([0, self.0[0], self.0[1], self.0[2]])
    }

    /// Converts a [`u32`] into an [IoOcr].
    pub const fn from_bits(val: u32) -> Self {
        let [_, io0, io1, io2] = val.to_be_bytes();
        Self([io0, io1, io2])
    }

    /// Converts an [IoOcr] into a byte array.
    pub const fn into_bytes(self) -> [u8; Self::LEN] {
        self.0
    }

    /// Attempts to convert a byte slice into an [IoOcr].
    pub const fn try_from_bytes(val: &[u8]) -> Result<Self> {
        match val.len() {
            len if len < Self::LEN => Err(Error::invalid_length(len, Self::LEN)),
            _ => Ok(Self([val[0], val[1], val[2]])),
        }
    }
}

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

impl From<u32> for IoOcr {
    fn from(val: u32) -> Self {
        Self::from_bits(val)
    }
}

impl From<IoOcr> for u32 {
    fn from(val: IoOcr) -> Self {
        val.bits()
    }
}

impl TryFrom<&[u8]> for IoOcr {
    type Error = Error;

    fn try_from(val: &[u8]) -> Result<Self> {
        Self::try_from_bytes(val)
    }
}

impl<const N: usize> TryFrom<&[u8; N]> for IoOcr {
    type Error = Error;

    fn try_from(val: &[u8; N]) -> Result<Self> {
        Self::try_from_bytes(val.as_ref())
    }
}

impl<const N: usize> TryFrom<[u8; N]> for IoOcr {
    type Error = Error;

    fn try_from(val: [u8; N]) -> Result<Self> {
        Self::try_from_bytes(val.as_ref())
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::test_field;

    #[test]
    fn test_fields() {
        let mut ocr = IoOcr::new();

        test_field!(ocr, vdd_2021: 8);
        test_field!(ocr, vdd_2122: 9);
        test_field!(ocr, vdd_2223: 10);
        test_field!(ocr, vdd_2324: 11);
        test_field!(ocr, vdd_2425: 12);
        test_field!(ocr, vdd_2526: 13);
        test_field!(ocr, vdd_2627: 14);
        test_field!(ocr, vdd_2728: 15);
        test_field!(ocr, vdd_2829: 16);
        test_field!(ocr, vdd_2930: 17);
        test_field!(ocr, vdd_3031: 18);
        test_field!(ocr, vdd_3132: 19);
        test_field!(ocr, vdd_3233: 20);
        test_field!(ocr, vdd_3334: 21);
        test_field!(ocr, vdd_3435: 22);
        test_field!(ocr, vdd_3536: 23);
    }
}