# spi.rs - source
Source of the Rust file `/home/runner/.cargo/registry/src/github.com-1ecc6299db9ec823/embedded-hal-1.0.0-alpha.1/src/blocking/spi.rs`.
Keywords: rust, rustlang, rust-lang

    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

    //! Blocking SPI API

    /// Blocking transfer
    pub trait Transfer<W> {
        /// Error type
        type Error;

        /// Sends `words` to the slave. Returns the `words` received from the slave
        fn try_transfer<'w>(&mut self, words: &'w mut [W]) -> Result<&'w [W], Self::Error>;
    }

    /// Blocking write
    pub trait Write<W> {
        /// Error type
        type Error;

        /// Sends `words` to the slave, ignoring all the incoming words
        fn try_write(&mut self, words: &[W]) -> Result<(), Self::Error>;
    }

    /// Blocking write (iterator version)
    pub trait WriteIter<W> {
        /// Error type
        type Error;

        /// Sends `words` to the slave, ignoring all the incoming words
        fn try_write_iter<WI>(&mut self, words: WI) -> Result<(), Self::Error>
        where
            WI: IntoIterator<Item = W>;
    }

    /// Blocking transfer
    pub mod transfer {
        /// Default implementation of `blocking::spi::Transfer<W>` for implementers of
        /// `spi::FullDuplex<W>`
        pub trait Default<W>: crate::spi::FullDuplex<W> {}

        impl<W, S> crate::blocking::spi::Transfer<W> for S
        where
            S: Default<W>,
            W: Clone,
        {
            type Error = S::Error;

            fn try_transfer<'w>(&mut self, words: &'w mut [W]) -> Result<&'w [W], S::Error> {
                for word in words.iter_mut() {
                    block!(self.try_send(word.clone()))?;
                    *word = block!(self.try_read())?;
                }

                Ok(words)
            }
        }
    }

    /// Blocking write
    pub mod write {
        /// Default implementation of `blocking::spi::Write<W>` for implementers of `spi::FullDuplex<W>`
        pub trait Default<W>: crate::spi::FullDuplex<W> {}

        impl<W, S> crate::blocking::spi::Write<W> for S
        where
            S: Default<W>,
            W: Clone,
        {
            type Error = S::Error;

            fn try_write(&mut self, words: &[W]) -> Result<(), S::Error> {
                for word in words {
                    block!(self.try_send(word.clone()))?;
                    block!(self.try_read())?;
                }

                Ok(())
            }
        }
    }

    /// Blocking write (iterator version)
    pub mod write_iter {
        /// Default implementation of `blocking::spi::WriteIter<W>` for implementers of
        /// `spi::FullDuplex<W>`
        pub trait Default<W>: crate::spi::FullDuplex<W> {}

        impl<W, S> crate::blocking::spi::WriteIter<W> for S
        where
            S: Default<W>,
            W: Clone,
        {
            type Error = S::Error;

            fn try_write_iter<WI>(&mut self, words: WI) -> Result<(), S::Error>
            where
                WI: IntoIterator<Item = W>,
            {
                for word in words.into_iter() {
                    block!(self.try_send(word.clone()))?;
                    block!(self.try_read())?;
                }

                Ok(())
            }
        }
    }