ethercrab 0.7.1

A pure Rust EtherCAT MainDevice supporting std and no_std environments
Documentation
use crate::LEN_MASK;
use ethercrab_wire::{EtherCrabWireRead, EtherCrabWireSized, WireError};

/// PDU fields placed after ADP and ADO, e.g. `LEN`, `C` and `NEXT` fields in ETG1000.4 5.4.1.2
/// Table 14 – Auto increment physical read (APRD).
#[derive(Default, Copy, Clone, Debug, PartialEq, Eq)]
pub struct PduFlags {
    /// Data length of this PDU.
    pub(crate) length: u16,
    /// Circulating frame
    ///
    /// 0: Frame is not circulating,
    /// 1: Frame has circulated once
    pub(crate) circulated: bool,
    /// 0: last EtherCAT PDU in EtherCAT frame
    /// 1: EtherCAT PDU in EtherCAT frame follows
    pub(crate) more_follows: bool,
}

impl PduFlags {
    pub const fn new(data_len: u16, more_follows: bool) -> PduFlags {
        Self {
            length: data_len,
            more_follows,
            circulated: false,
        }
    }

    pub const fn with_len(len: u16) -> Self {
        Self::new(len, false)
    }

    pub const fn len(self) -> u16 {
        self.length
    }

    pub const fn const_default() -> Self {
        Self::with_len(0)
    }
}

impl ethercrab_wire::EtherCrabWireWrite for PduFlags {
    fn pack_to_slice_unchecked<'buf>(&self, buf: &'buf mut [u8]) -> &'buf [u8] {
        let raw = self.length & LEN_MASK
            | ((self.circulated as u16) << 14)
            | ((self.more_follows as u16) << 15);

        let buf = &mut buf[0..self.packed_len()];

        buf.copy_from_slice(&raw.to_le_bytes());

        buf
    }

    fn packed_len(&self) -> usize {
        <Self as EtherCrabWireSized>::PACKED_LEN
    }
}

impl EtherCrabWireRead for PduFlags {
    fn unpack_from_slice(buf: &[u8]) -> Result<Self, WireError> {
        let src = u16::unpack_from_slice(buf)?;

        let length = src & LEN_MASK;
        let circulated = (src >> 14) & 0x01 == 0x01;
        let is_not_last = (src >> 15) & 0x01 == 0x01;

        Ok(Self {
            length,
            circulated,
            more_follows: is_not_last,
        })
    }
}

impl EtherCrabWireSized for PduFlags {
    const PACKED_LEN: usize = 2;

    type Buffer = [u8; Self::PACKED_LEN];

    fn buffer() -> Self::Buffer {
        [0u8; Self::PACKED_LEN]
    }
}

impl ethercrab_wire::EtherCrabWireWriteSized for PduFlags {
    fn pack(&self) -> Self::Buffer {
        let mut buf = [0u8; Self::PACKED_LEN];

        ethercrab_wire::EtherCrabWireWrite::pack_to_slice_unchecked(self, &mut buf);

        buf
    }
}

#[cfg(test)]
mod tests {
    use ethercrab_wire::EtherCrabWireWriteSized;

    use super::*;

    #[test]
    fn pdu_flags_round_trip() {
        let flags = PduFlags {
            length: 0x110,
            circulated: false,
            more_follows: true,
        };

        let packed = flags.pack();

        assert_eq!(packed, [0x10, 0x81]);

        let unpacked = PduFlags::unpack_from_slice(&packed).unwrap();

        assert_eq!(unpacked, flags);
    }

    #[test]
    fn correct_length() {
        let flags = PduFlags {
            length: 1036,
            circulated: false,
            more_follows: false,
        };

        assert_eq!(flags.len(), 1036);

        assert_eq!(flags.pack(), [0b0000_1100, 0b0000_0100]);
        assert_eq!(flags.pack(), [0x0c, 0x04]);
    }
}