Returns a specification to start this module under a supervisor.

See Supervisor.

@spec close(master_ref()) :: :ok

Closes the transport port.

@spec custom_request(master_ref(), binary(), keyword()) ::
  {:ok, ExDlt645.Frame.t()} | {:error, term()}

Sends a raw DL/T 645 packet.

@spec freeze(master_ref(), String.t(), binary(), keyword()) :: :ok | {:error, term()}

Sends a freeze command (0x16) to meter address.

@spec open(master_ref()) :: :ok | {:error, term()}

Opens the transport port for the configured device.

@spec read_address(master_ref(), keyword()) :: {:ok, String.t()} | {:error, term()}

Reads meter address using broadcast frame (0x13). Typically only one meter should be attached to the bus when invoking this.

@spec read_data(
  master_ref(),
  String.t(),
  non_neg_integer() | binary() | String.t(),
  keyword()
) ::
  {:ok, term()} | {:error, term()}

Reads a data item identified by di from meter address. Returns {:ok, parsed_value} or {:ok, %Frame{}} if raw: true.

@spec start_link(keyword(), keyword()) :: {:ok, pid()} | {:error, term()}

Starts the Master GenServer process.

Parameters

• :tty - Serial device path (e.g. "/dev/ttyUSB0"), virtual target ("virtual"), or TCP spec ("tcp://192.168.1.100:10001").
• :active - If true, asynchronous notifications are delivered to caller PID (default false).
• :timeout - Request timeout in milliseconds (default 5,000 ms).
• :transport - Optional explicit Transport module (defaults to resolving based on :tty).
• :uart_opts - Options passed to UART or virtual transport (e.g. [speed: 2400, parity: :even]).

@spec state(master_ref()) :: %ExDlt645.Master{
  active: term(),
  cmd: term(),
  last_cmd: term(),
  parent_pid: term(),
  status: term(),
  timeout: term(),
  transport: term(),
  tty: term(),
  uart_opts: term(),
  uart_pid: term()
}

Returns the current internal state struct of the Master.

@spec stop(master_ref()) :: :ok

Stops the Master GenServer process.

@spec sync_time(master_ref(), NaiveDateTime.t() | DateTime.t(), keyword()) ::
  :ok | {:error, term()}

Broadcasts time synchronization frame (0x08).

@spec write_address(master_ref(), String.t(), String.t(), keyword()) ::
  :ok | {:error, term()}

Writes a new address to meter old_address.

@spec write_data(
  master_ref(),
  String.t(),
  non_neg_integer() | binary(),
  binary(),
  keyword()
) ::
  :ok | {:ok, ExDlt645.Frame.t()} | {:error, term()}

Writes data to meter address.