EtherCAT.Simulator.Slave (ethercat v0.5.0)

Device and signal-level API for simulated EtherCAT slaves.

Use this module to hydrate simulated devices from real EtherCAT.Driver modules and to inspect or override named signal values on a running simulator.

from_driver/2 can hydrate a simulated device from a real EtherCAT.Driver and a simulator-side companion such as MyDriver.Simulator. The companion is optional for real hardware drivers, but required for this hydration path; signal mappings alone do not define simulated behavior. See EtherCAT.Simulator for a complete UDP walkthrough.

Summary

Types

device()

driver()

signal_ref()

Functions

connect(arg1, arg2)

connections()

disconnect(arg1, arg2)

from_driver(driver, opts \\ [])

Build an authored simulator definition from a driver and its adapter.

get_value(slave_name, signal_name)

set_value(slave_name, signal_name, value)

signal_definitions(slave_name)

signals(slave_name)

subscribe(slave_name)

subscribe(slave_name, signal_name)

subscribe(slave_name, signal_name, subscriber)

unsubscribe(slave_name)

unsubscribe(slave_name, signal_name)

unsubscribe(slave_name, signal_name, subscriber)

Types

device()

@type device() :: EtherCAT.Simulator.Slave.Definition.t()

driver()

@type driver() :: module()

signal_ref()

@type signal_ref() :: {atom(), atom()}

Functions

connect(arg1, arg2)

@spec connect(signal_ref(), signal_ref()) ::
  :ok | {:error, :not_found | :unknown_signal | :invalid_value}

connections()

@spec connections() :: {:ok, [map()]} | {:error, :not_found | :timeout}

disconnect(arg1, arg2)

@spec disconnect(signal_ref(), signal_ref()) :: :ok | {:error, :not_found}

from_driver(driver, opts \\ [])

@spec from_driver(driver(), keyword()) :: device()

Build an authored simulator definition from a driver and its adapter.

Options:

:config — driver configuration map, default %{}
:name — override the simulated device name
:simulator — explicit EtherCAT.Simulator.Adapter module; otherwise resolves MyDriver.Simulator for MyDriver

Raises ArgumentError when no adapter is available or its options are invalid. This builds a definition only; start it with EtherCAT.Simulator.start/1.

get_value(slave_name, signal_name)

@spec get_value(atom(), atom()) ::
  {:ok, term()} | {:error, :not_found | :unknown_signal}

set_value(slave_name, signal_name, value)

@spec set_value(atom(), atom(), term()) ::
  :ok | {:error, :not_found | :unknown_signal | :invalid_value}

signal_definitions(slave_name)

@spec signal_definitions(device()) :: %{optional(atom()) => map()}

@spec signal_definitions(atom()) ::
  {:ok, %{optional(atom()) => map()}} | {:error, :not_found}

signals(slave_name)

@spec signals(device()) :: [atom()]

@spec signals(atom()) :: {:ok, [atom()]} | {:error, :not_found}

unsubscribe(slave_name)

@spec unsubscribe(atom()) :: :ok | {:error, :not_found}

unsubscribe(slave_name, signal_name)

@spec unsubscribe(atom(), atom() | :all) :: :ok | {:error, :not_found}

unsubscribe(slave_name, signal_name, subscriber)

@spec unsubscribe(atom(), atom() | :all, pid()) :: :ok | {:error, :not_found}