Function Libertas_DeviceWriteReq

Libertas_DeviceWriteReq(
device: number,
requests: LibertasClusterAttributes[],
): number
Send a asynchronize write request to the device.
Parameters
- device: number
  A LibertasDevice.
- requests: LibertasClusterAttributes[]
  An array of LibertasClusterAttributes.
Returns number
The reference number of this request.
See
Remarks
Use Libertas_SetOnDevice to setup the callback function for the response.

The callback will be triggered asynchroniously with a LibertasClusterWriteRsp[] array and the reference number.

IMPORTANT! If the task sends another WriteReq before the previous WriteReq is responded, the previous one may be discarded by Libertas OS. As a general rule, a task shall always wait for the response to previous interaction before sending another one, or only expect the response to the latest request.

The request may never reach the recipient if, for example, there is a network problem. In that case, a LibertasDeviceAction.StatusResponse with a Matter.Status.Timeout will be received from the callback registered with Libertas_SetOnDevice.

The Thing-App task shall not assume that it is the only process that sends requests. Other agents may also send requests. A task can only receive the write response to its own write requests.In order to receive all changes to a attribute, use Libertas_AppSubscribeReq.