Function Libertas_DeviceAttributes

Libertas_DeviceAttributes(device, cluster, cmd, attributes, exclude?, target?, seq?): void
Set the attributes of the remote device.
Parameters
- device: number
  
  A device.
- cluster: LibertasClusterId
  
  The cluster ID.
- cmd: LibertasClusterCmd
  
  The command. Only LibertasClusterCmd.WRITE, LibertasClusterCmd.REPORT, LibertasClusterCmd.WRITE_UNDIVIDED, LibertasClusterCmd.WRITE_NO_RSP, LibertasClusterCmd.READ_RSP, LibertasClusterCmd.NA are allowed.
- attributes: LibertasClusterAttributeMap | [LibertasAttrId]
  
  Attributes map, or array of attribute ID if cmd is LibertasClusterCmd.READ .
- Optional exclude: number
  
  Optional. The node that shall not be updated. It shall only be used with virtual device node.
  
  Optional
- Optional target: number
  
  Optional. It shall only be used with virtual device node. The target of LibertasClusterCmd.READ_RSP.
  
  Optional
- Optional seq: number
  
  Optional. It shall only be used with virtual device node. The sequenc number of LibertasClusterCmd.READ_RSP.
  
  Optional
Returns void

Remarks
The value of all arguments are upto access and permission check. Error may be raised. LibertasClusterCmd.READ_RSP is treated differently. First, only "volatile" attributes shall be updated. All other attribytes are already cached. If there is no "volatile" attributes, an empty map can be supplied. Secondly, target and seq arguments only applys to LibertasClusterCmd.READ_RSP command, the values shall be from the original event with LibertasClusterCmd.READ command.

If cmd is LibertasClusterCmd.NA, the attribute values are updated internally without broadcasting to bound endpoints. LibertasClusterCmd.NA is used to update volatile attributes in case an incoming event changed the attribute. For example, a "step" command will change the current level of a "Level Control" device. As a result, the "Level" attribute shall also be changed internally. However, if the Thing-APp engine doesn't maintain an attribute cache, it is not necessary to perform this update.

Generated using TypeDoc