Struct Client 

pub struct Client { /* private fields */ }

Cloneable client handle that serializes operations through one worker task.

Implementations

impl Client

pub async fn connect(addr: &str) -> Result<Self>

Connects directly to a controller and starts the client worker.

pub async fn with_route_path(addr: &str, route: RoutePath) -> Result<Self>

Connects using an ordered route and starts the client worker.

pub fn from_eip_client(client: EipClient) -> Result<Self>

Takes ownership of an existing connected client and starts its worker.

pub fn events(&self) -> Receiver<ConnectionEvent>

Subscribes to connection lifecycle events.

pub fn with_retry(&self, policy: RetryPolicy) -> RetryClient

Returns a retrying view of this client.

pub async fn read_tag(&self, tag_name: &str) -> Result<PlcValue>

Reads one symbolic tag.

pub async fn write_tag(&self, tag_name: &str, value: PlcValue) -> Result<()>

Writes one symbolic tag.

pub async fn write_string_tag(&self, tag_name: &str, value: &str) -> Result<()>

Writes a built-in or custom Logix string using handle discovery.

pub async fn write_udt_member( &self, udt_tag_name: &str, member_name: &str, value: PlcValue, ) -> Result<()>

Writes one named member of a UDT tag.

pub async fn write_udt_array_member( &self, udt_array_element_path: &str, member_name: &str, value: PlcValue, ) -> Result<()>

Writes one member of a UDT array element.

pub async fn execute_batch( &self, operations: &[BatchOperation], ) -> Result<Vec<BatchResult>>

Executes mixed read and write operations using batch packet grouping.

pub async fn read_tags_batch( &self, tag_names: &[&str], ) -> Result<Vec<(String, Result<PlcValue, BatchError>)>>

Reads several tags and preserves per-tag errors.

pub async fn write_tags_batch( &self, tag_values: &[(&str, PlcValue)], ) -> Result<Vec<(String, Result<(), BatchError>)>>

Writes several tags and preserves per-tag errors.

pub async fn check_health(&self) -> Result<bool>

Performs an active controller health check.

pub async fn get_diagnostics_snapshot(&self) -> Result<DiagnosticsSnapshot>

Returns a passive diagnostics snapshot from recorded operation state.

pub async fn get_diagnostics_snapshot_detailed( &self, ) -> Result<DiagnosticsSnapshot>

Performs a health check and returns a verified diagnostics snapshot.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.