Struct PortStates

pub struct PortStates(/* private fields */);

Represents the collective states of all NUMBER_OF_PORTS ports.

This struct holds an array of PortState and provides constants for reading all port states using a single Modbus “Read Holding Registers” (0x03) command.

Implementations

impl PortStates

pub const ADDRESS: u16 = 1u16

The Modbus function code 0x03 (Read Holding Registers) register address used for reading all port states sequentially.

pub const QUANTITY: u16 = 8u16

The number of consecutive Modbus registers (Words) to read to get all port states.

This corresponds to NUMBER_OF_PORTS.

pub fn decode_from_holding_registers(words: &[Word]) -> Self

Decodes the states of all ports from a slice of Modbus holding register values.

Expects words to contain NUMBER_OF_PORTS values. Each word in the slice corresponds to the state of a single port, decoded via PortState::decode_from_holding_registers.

If words contains fewer than NUMBER_OF_PORTS items, the remaining port states in the returned struct will retain their default initialized value (PortState::Close). Extra items in words beyond NUMBER_OF_PORTS are ignored.

Arguments

• words: A slice of Word containing the register values read from the device.

Returns

A PortStates struct containing the decoded state for each port.

Panics

Panics if words does not have length equal to NUMBER_OF_PORTS.

Example

// Example data mimicking a Modbus read response for 8 registers
let modbus_data: [Word; NUMBER_OF_PORTS] = [0x1, 0x0, 0xFFFF, 0x0, 0x0, 0x0, 0x1234, 0x0];
let decoded_states = PortStates::decode_from_holding_registers(&modbus_data);
assert_eq!(decoded_states.as_array()[0], PortState::Open);
assert_eq!(decoded_states.as_array()[1], PortState::Close);
assert_eq!(decoded_states.as_array()[2], PortState::Open); // Non-zero treated as Open
// ... and so on for all ports

pub fn iter(&self) -> Iter<'_, PortState>

Returns an iterator over the individual PortState values in the order of the ports.

pub fn as_slice(&self) -> &[PortState]

Returns a slice containing all Temperature values.

pub fn as_array(&self) -> &[PortState; 8]

Provides direct access to the underlying array of port states.

Trait Implementations

impl Clone for PortStates

fn clone(&self) -> PortStates

Returns a duplicate of the value.

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PortStates

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for PortStates

Provides a comma-separated string representation of all port states (e.g., “close, open, close, …”).

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for PortStates

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Index<usize> for PortStates

fn index(&self, index: usize) -> &Self::Output

Allows indexing into the port states array.

Panics

Panics if the index is out of bounds (0-7).

type Output = PortState

The returned type after indexing.

impl<'a> IntoIterator for &'a PortStates

type Item = &'a PortState

The type of the elements being iterated over.

type IntoIter = Iter<'a, PortState>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for PortStates

type Item = PortState

The type of the elements being iterated over.

type IntoIter = IntoIter<PortState, NUMBER_OF_PORTS>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for PortStates

fn eq(&self, other: &PortStates) -> bool

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for PortStates

impl Eq for PortStates

impl StructuralPartialEq for PortStates