get_channel()#

ModbusDevice.get_channel(
channel_name: str,
length: int = 1,
wait_for_new_samples: bool = False,
timeout: float = 10.0,
) → Measurement#

Return the most recent length samples for channel_name from the in-memory buffer.

If the channel does not exist yet, or no sample is available, the code will always block until timeout expires.

Parameters:

  • channel_name – Name of the channel to retrieve.

  • length – Number of trailing samples to return.

  • wait_for_new_samples – Block until at least length new values arrive.

  • timeout – Seconds to wait when insufficient data exists or wait_for_new_samples=True.

Raises:

  • RuntimeError – No background buffer; start() was not called.

  • ChannelNotFoundError – channel had no values and no data appeared before timeout. wait_for_new_samples=True and channel did not appear within timeout.

  • ChannelValueTimeoutError – wait_for_new_samples=True and values did not arrive within timeout.