Struct MultiUnitManager 

pub struct MultiUnitManager { /* private fields */ }

Manager for multiple Modbus units.

Provides centralized management of multiple Modbus slave units, each with its own register store, word order configuration, and statistics.

Thread Safety

MultiUnitManager is thread-safe and can be shared across threads. All operations are lock-free using DashMap.

Example

use mabi_modbus::unit::{MultiUnitManager, UnitConfig, UnitManagerConfig};

let manager = MultiUnitManager::new(UnitManagerConfig::default());

// Add units
manager.add_unit(1, UnitConfig::new("Unit 1")).unwrap();
manager.add_unit(2, UnitConfig::new("Unit 2")).unwrap();

// Access unit
{
    let unit = manager.get_unit(1).unwrap();
    assert_eq!(unit.name(), "Unit 1");
}

Implementations

impl MultiUnitManager

pub fn new(config: UnitManagerConfig) -> Self

Create a new multi-unit manager.

pub fn with_defaults() -> Self

Create with default configuration.

pub fn config(&self) -> &UnitManagerConfig

Get the manager configuration.

pub fn unit_count(&self) -> usize

Get the number of registered units.

pub fn unit_ids(&self) -> Vec<u8>

Get all unit IDs.

pub fn has_unit(&self, unit_id: u8) -> bool

Check if a unit exists.

pub fn add_unit(&self, unit_id: u8, config: UnitConfig) -> ModbusResult<()>

Add a new unit.

Arguments

• unit_id - Unit ID (1-247)
• config - Unit configuration

Returns

Ok(()) if the unit was added, Err if:

• Unit ID is 0 (reserved for broadcast)
• Unit already exists
• Maximum units reached

pub fn remove_unit(&self, unit_id: u8) -> Option<UnitInfo>

Remove a unit.

Returns

The removed unit info if it existed.

pub fn get_unit(&self, unit_id: u8) -> Option<Ref<'_, u8, UnitInfo>>

Get a unit by ID.

If auto_create_units is enabled and the unit doesn’t exist, it will be created with default configuration.

pub fn get_unit_mut(&self, unit_id: u8) -> Option<RefMut<'_, u8, UnitInfo>>

Get a mutable reference to a unit.

pub fn update_unit<F>(&self, unit_id: u8, update_fn: F) -> ModbusResult<()>

where F: FnOnce(&mut UnitConfig),

Update a unit’s configuration.

pub fn read_holding_registers( &self, unit_id: u8, address: u16, quantity: u16, ) -> ModbusResult<Vec<u16>>

Read holding registers from a unit.

pub fn read_input_registers( &self, unit_id: u8, address: u16, quantity: u16, ) -> ModbusResult<Vec<u16>>

Read input registers from a unit.

pub fn read_coils( &self, unit_id: u8, address: u16, quantity: u16, ) -> ModbusResult<Vec<bool>>

Read coils from a unit.

pub fn read_discrete_inputs( &self, unit_id: u8, address: u16, quantity: u16, ) -> ModbusResult<Vec<bool>>

Read discrete inputs from a unit.

pub fn write_holding_register( &self, unit_id: u8, address: u16, value: u16, ) -> ModbusResult<()>

Write a single holding register to a unit.

pub fn write_holding_registers( &self, unit_id: u8, address: u16, values: &[u16], ) -> ModbusResult<()>

Write multiple holding registers to a unit.

pub fn write_coil( &self, unit_id: u8, address: u16, value: bool, ) -> ModbusResult<()>

Write a single coil to a unit.

pub fn write_coils( &self, unit_id: u8, address: u16, values: &[bool], ) -> ModbusResult<()>

Write multiple coils to a unit.

pub fn broadcast_write_holding_register( &self, address: u16, value: u16, ) -> ModbusResult<()>

Broadcast write holding register to all applicable units.

pub fn broadcast_write_holding_registers( &self, address: u16, values: &[u16], ) -> ModbusResult<()>

Broadcast write multiple holding registers to all applicable units.

pub fn broadcast_write_coil( &self, address: u16, value: bool, ) -> ModbusResult<()>

Broadcast write coil to all applicable units.

pub fn broadcast_write_coils( &self, address: u16, values: &[bool], ) -> ModbusResult<()>

Broadcast write multiple coils to all applicable units.

pub fn total_requests(&self) -> u64

Get total request count.

pub fn broadcast_count(&self) -> u64

Get total broadcast count.

pub fn unit_statistics(&self) -> Vec<UnitStatistics>

Get statistics for all units.

pub fn reset_statistics(&self)

Reset all statistics.

Trait Implementations

impl Debug for MultiUnitManager

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

Formats the value using the given formatter.

impl Default for MultiUnitManager

fn default() -> Self

Returns the “default value” for a type.