5.1.7.2.4 ZCL_StartSecurityReq Function

Syntax

void ZCL_StartSecurityReq(ZCL_StartSecurityReq_t *req);

Description

This function initializes the key establishment cluster, discovers the key establishment devices and performs the key establishment.

The applications supporting the key establishment cluster must call the function to perform key establishment procedures. The behavior differs between the trust center and common devices.
  • On the trust center:
    • If the user sets the remoteAddress field to ‘0’, the application initializes the key establishment cluster without performing key establishment with any device.
    • If the remoteAddress field is set to the extended address of a remote device, the trust center starts key establishment with it.
  • On a common device:
    • If the user sets the remoteAddress field to ‘0’ or to the extended address of the trust center, the key establishment with the trust center is going to start.
    • Otherwise, the request eventually fails. If not using the Certicom Security, the application always reports success status.
The response statuses, accessed via the argument’s ZCL_StartSecurityConf_t-status field of the ZCL_StartSecurityReq_t-ZCL_StartSecurityConf callbacks argument, are as follows:
  • All possible status codes are wrapped in the ZCL_SecurityStatus_t enumeration.
Input Parameters
Parameter NameDescription
reqRequest structure to pass attribute id
Return Type and Values
  • None