The Z Wave protocol MAY notify an application by sending SReceiveNodeUpdate when a Node Information Frame has been received.
The Z Wave protocol MAY refrain from sending the information if the protocol is currently expecting node information.
A controller application MAY use the information provided by SReceiveNodeUpdate to update local data structures.
The Z Wave protocol MUST notify a controller application by calling SReceiveNodeUpdate when a new node has been added or deleted from the controller through the network management features.
The Z Wave protocol MUST pass SReceiveNodeUpdate to application in response to SNodeInfoRequest being passed to protocol by the controller application. The Z Wave protocol MAY notify a controller application by sending SReceiveNodeUpdate when a Node Information Frame has been received. The Z Wave protocol MAY refrain from sending the information if the protocol is currently expecting a Node Information frame.
SReceiveNodeUpdate MUST be sent in a controller node operating as SIS each time a node is added or deleted by the primary controller. SReceiveNodeUpdate MUST be sent in a controller node operating as SIS each time a node is added/deleted by an inclusion controller.
A controller application MAY send a ZW_RequestNetWorkUpdate command to a SIS or SIS node. In response, the SIS MUST return update information for each node change since the last update handled by the requesting controller node. The application of the requesting controller node MAY receive multiple instances of SReceiveNodeUpdate in response to application passing SNetworkUpdateRequest to protocol.
The Z Wave protocol MUST NOT send SReceiveNodeUpdate in a controller node acting as primary controller or inclusion controller when a node is added or deleted.
Any controller application MUST implement this function.
serialapi{ZW->HOST: REQ | 0x49 | bStatus | bNodeID | bLen | basic | generic | specific | commandclasses[ ]}
SReceiveNodeUpdate via the Serial API also have the possibility for receiving the status UPDATE_STATE_NODE_INFO_REQ_FAILED, which means that a node did not acknowledge a SNodeInfoRequest .
Public Attribute Documentation#
Status#
uint8_t SReceiveNodeUpdate::Status
2039
of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_application_transport_interface.h
NodeId#
node_id_t SReceiveNodeUpdate::NodeId
2046
of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_application_transport_interface.h
iLength#
uint8_t SReceiveNodeUpdate::iLength
2047
of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_application_transport_interface.h
aPayload#
uint8_t SReceiveNodeUpdate::aPayload[MAX_NODE_INFO_LENGTH]
2048
of file /mnt/raid/workspaces/ws.6QOxxjIBR/overlay/gsdk/protocol/z-wave/ZWave/API/ZW_application_transport_interface.h