View Source Grizzly.VirtualDevices.Device behaviour (grizzly v8.5.3)

Behaviour for implementing virtual device specifics

Summary

Types

Optional device options that are passed with calling implemented callbacks

t()

A module that implements this behaviour

Callbacks

Return the device specification

Handle a Z-Wave command

Set the virtual device's id once added to the (virtual) Z-Wave network.

Types

@type device_opt() :: {atom(), term()}

Optional device options that are passed with calling implemented callbacks

This can be whatever extra information the consumer might need the device to know about when executing the callback function.

@type t() :: module()

A module that implements this behaviour

Callbacks

@callback device_spec([device_opt()]) :: Grizzly.ZWave.DeviceClass.t()

Return the device specification

@callback handle_command(Grizzly.ZWave.Command.t(), [device_opt()]) ::
  :ok
  | {:ok, Grizzly.ZWave.Command.t()}
  | {:notify, Grizzly.ZWave.Command.t()}
  | {:error, :timeout}

Handle a Z-Wave command

When handling a command you can reply, notify, or do nothing.

In Z-Wave if your device does not understand the command sent it ignores the command. For this case you'd return {:error, :timeout}.

When a command is received and your device supports the command and the command's parameters, you either respond with :ok or {:ok, Command.t()}. Normally, when you receive a "set" command you will want to response with :ok. When you receive a "get" command you will want to response the report command like {:ok, Command.t()}, where the Command.t() is whatever command report you want to send to the caller.

Often times, if your device reports changes that have been made due to handling a command, you can return {:notify, Command.t()}.

@callback set_device_id(pid(), Grizzly.VirtualDevices.id()) :: :ok

Set the virtual device's id once added to the (virtual) Z-Wave network.