5.1.7.2.3 ZCL_Set Function

Syntax

void ZCL_Set(ZCL_Set_t *req);

Description

Profile-based applications use the function to set various security parameters, including link keys, network key and key establishment cluster’s data. The security parameter that the function sets depends on the value of the argument’s attr.id field. The ZCL_SecurityAttrId_t enumeration type provides the possible values. The application executes the function synchronously.

The response statuses, accessed via the argument’s ZCL_Set_t-status field, are as follows:
  • ZCL_SUCCESS_STATUS (0x00) – Operation completed successfully
  • ZCL_INVALID_ATTRIBUTE_VALUE_STATUS (0x02) – The provided endpoint is invalid or the certificate description provided is null.
  • ZCL_TC_PERMISSION_TABLE_ERROR_STATUS (0x03) – The application failed to add the device to the TC permission table.
  • ZCL_APS_LINK_KEY_ERROR_STATUS (0x04) – The application has failed to set the link key via APS.
  • ZCL_UNSUPPORTED_ATTRIBUTE_STATUS (0x86) – An unsupported value was set to the argument’s attr.id field.
Input Parameters
Parameter NameDescription
reqRequest structure to pass attribute ID
Return Type and Values
  • None