View Source Grizzly.Node (grizzly v7.4.1)

Functions for working directly with a Z-Wave node

Summary

Types

Options to use when getting device info.

Functions

Get the information for a node by its id

Get the lifeline association group for a node.

Gets a node's statistics from Z/IP Gateway.

Set lifeline association for the node

Types

@type id() :: non_neg_integer()
@type info_opt() :: {:force_update, boolean()} | info_opt()

Options to use when getting device info.

  • :force_update - By default there is a cache managed by zipgateway that tracks the device information. Sometimes that can get out of date, so you can pass [force_update: true] to force the cache to update the device info. By default this is false
@type lifeline_opts() ::
  {:controller_id, Grizzly.ZWave.node_id()}
  | {:extra_node_ids, [Grizzly.ZWave.node_id()]}
@type opt() :: {:seq_number, integer()} | {:timeout, non_neg_integer()}

Functions

Link to this function

get_dsk(node_id, add_mode, opts \\ [])

View Source
@spec get_dsk(Grizzly.ZWave.node_id() | :gateway, :add | :learn, [
  Grizzly.command_opt()
]) ::
  Grizzly.send_command_response()

Get a node's dsk.

The response to this command is the DSKReport command

Sending this command with :gateway will always go to your Z-Wave controller

Link to this function

get_info(node_id, opts \\ [])

View Source

Get the information for a node by its id

The response to this command is the NodeInfoCacheReport command

Link to this function

get_lifeline_association(node_id)

View Source

Get the lifeline association group for a node.

Gets a node's statistics from Z/IP Gateway.

Link to this function

set_lifeline_association(node_id, opts \\ [])

View Source

Set lifeline association for the node

The lifeline associated is used to report events that happen at the Z-Wave device level back to the Z-Wave controller. For example, if you turn on a light and want to be notified, the device will need to have it's lifeline association set.

Opts:

  • :controller_id - the idea of the main controller to send lifeline reports to (defaults to 1)
  • :extra_node_ids - any extra nodes to set add to the association group