fennec-modbus 0.93.1

Modular Modbus client implementation
Documentation
use core::str::FromStr;

/// Modbus unit ID aka «slave ID».
#[must_use]
#[derive(Copy, Clone, Debug, Eq, PartialEq)]
pub enum UnitId {
    /// Broadcast on a subnetwork. Also accepted for a direct connection.
    Broadcast,

    /// Direct connection.
    ///
    /// Note that some devices do not respond to it even with direct direction over local network.
    /// In that case, specify a [`Self::Significant`] unit ID explicitly.
    NonSignificant,

    /// Addressed unit ID. `248..=254` are reserved and not valid.
    Significant(u8),
}

impl From<u8> for UnitId {
    fn from(unit_id: u8) -> Self {
        match unit_id {
            0 => Self::Broadcast,
            255 => Self::NonSignificant,
            _ => Self::Significant(unit_id),
        }
    }
}

impl From<UnitId> for u8 {
    fn from(unit_id: UnitId) -> Self {
        match unit_id {
            UnitId::Broadcast => 0,
            UnitId::NonSignificant => 255,
            UnitId::Significant(unit_id) => unit_id,
        }
    }
}

impl FromStr for UnitId {
    type Err = core::num::ParseIntError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        Ok(Self::from(u8::from_str(s)?))
    }
}