Attribute Storage#
API for the Attribute Storage functionality in the Application Framework.
Attribute Storage description.
API#
Locate attribute metadata.
Return true if the attribute exists.
Return true if an endpoint contains a cluster, checking for mfg code.
Return true if the endpoint contains the ZCL cluster with specified ID.
Return true if the endpoint has a cluster server, checking for the mfg code.
Return true if the endpoint contains the ZCL server with a specified ID.
Return true if the endpoint contains the cluster client.
Return true if the endpoint contains the ZCL client with a specified ID.
Write an attribute performing all checks.
Write a cluster server attribute.
Write a cluster client attribute.
Write a manufacturer-specific server attribute.
Write a manufacturer-specific client attribute.
Test the success of attribute write.
Read the attribute value performing all the checks.
Read the server attribute value performing all the checks.
Read the client attribute value, performing all the checks.
Read the manufacturer-specific server attribute value, performing all checks.
Read the manufacturer-specific client attribute value, performing all checks.
Return the size of the ZCL data in bytes.
Return the number of seconds the network remains open.
Take an index of an endpoint and return the Zigbee endpoint.
Return the network index of a given endpoint.
Return the total number of endpoints (dynamic and pre-compiled).
Return the number of pre-compiled endpoints.
Return the type of the attribute, either ANALOG, DISCRETE, or NONE.
Return true if type is signed, false otherwise.
Extract a 32-bit integer from the message buffer.
Extract a 24-bit integer from the message buffer.
Extract a 16-bit integer from the message buffer.
Extract a ZCL string from the message buffer.
Extract a ZCL long string from the message buffer.
Return true if the cluster is in the manufacturer-specific range.
Copy a uint16_t value into a buffer.
Copy a uint24_t value into a buffer.
Copy a uint32_t value into a buffer.
Return true if the cluster is in the manufacturer-specific range.
Return true if the cluster is in the manufacturer-specific range.
Return true if the cluster is in the manufacturer-specific range.
Return true if the cluster is in the manufacturer-specific range.
Return true if the cluster is in the manufacturer-specific range.
Check whether the endpoint is enabled.
Check whether the endpoint is identifying.
Enable or disables an endpoint.
When running on an OS, this API sets the Zigbee stack task to ready.
Enable/disable endpoints.
Determine if an endpoint at the specified index is enabled or disabled.
Return true if a given ZCL data type is a string type.
Return true if the given attribute type is a string.
Return true if the given attribute type is a long string.
Increment the ZCL sequence number and returns the value.
Retrieve the last sequence number that was used.
Simple integer comparison function. Compares two values of a known length as integers. Signed integer comparison are supported for numbers with length of 4 (bytes) or less. The integers are in native endianness.
Populate the passed EUI64 with the local EUI64 MAC address.
Return the node ID of the local node.
Generate a random key (link, network, or master).
Return the PAN ID of the local node.
Return the radioChannel of the current network.
Return true if the cluster is in the manufacturer-specific range.
Return true if the cluster is in the manufacturer-specific range.
Return the current network state. This call caches the results on the host to prevent frequent EZSP transactions.
Return the current network parameters.
Returns the current node type.
Enable local permit join and optionally broadcasts the ZDO Mgmt_Permit_Join_req message. This API can be called from any device type and still return EMBER_SUCCESS. If the API is called from an end device, the permit association bit will just be left off.
Enable local permit join and broadcasts the ZDO Mgmt_Permit_Join_req message. This API can be called from any device type and still return EMBER_SUCCESS. If the API is called from an end device, the permit association bit will just be left off.
Schedule a cluster-related event inside the application framework's event mechanism. This function provides a wrapper for the Ember stack event mechanism which allows the cluster code to access its events by their endpoint, cluster ID, and client/server identity. The passed poll and sleep controls allow the cluster to indicate whether it needs to long or short poll and whether it needs to stay awake or if it can sleep.
Schedule a cluster-related event inside the This function is a wrapper for ::emberAfScheduleTickExtended. The cluster on the given endpoint will be set to long poll if sleepControl is set to EMBER_AF_OK_TO_HIBERNATE or will be set to short poll otherwise. It will stay awake if sleepControl is EMBER_AF_STAY_AWAKE and will sleep otherwise.
Schedule a cluster client event. This function is a wrapper for sl_zigbee_zcl_schedule_tick_extended.
Schedule a cluster client event. This function is a wrapper for sl_zigbee_zcl_schedule_client_tick_extended. It indicates that the cluster client on the given endpoint can long poll and can sleep.
Schedule a cluster server event. This function is a wrapper for sl_zigbee_zcl_schedule_tick_extended.
Schedule a cluster server event. This function is a wrapper for sl_zigbee_zcl_schedule_server_tick_extended. It indicates that the cluster server on the given endpoint can long poll and can sleep.
Deactivate a cluster-related event. This function provides a wrapper for the Ember stack's event mechanism which allows an event to be accessed by its endpoint, cluster id, and client/server identity.
Deactivate a cluster client event. This function is a wrapper for sl_zigbee_zcl_deactivate_cluster_tick.
Deactivate a cluster server event. This function is a wrapper for sl_zigbee_zcl_deactivate_cluster_tick.
Send a ZCL response, based on the information that is currently in the outgoing buffer. It is expected that a complete ZCL message is present, including header. The application may use this method directly from within the message handling function and associated callbacks. However, this will result in the response being sent before the APS ACK is sent which is not ideal.
Send ZCL response with attached message sent callback.
Sends multicast.
Multicasts the message to the group in the binding table that matches the cluster and source endpoint in the APS frame. Note: if the binding table contains many matching entries, calling this API cause a significant amount of network traffic. Care should be taken when considering the effects of broadcasts in a network.
Send Multicast with alias with attached message sent callback.
Send multicast with attached message sent callback.
Send broadcast.
Send broadcast with attached message sent callback.
Send broadcast with alias with attached message sent callback.
Send unicast.
Send unicast with attached message sent callback.
Unicast the message to each remote node in the binding table that matches the cluster and source endpoint in the APS frame. Note: if the binding table contains many matching entries, calling this API cause a significant amount of network traffic.
emberAfSendUnicastToBindings with attached message sent callback.
Send interpan message.
Send end device binding request.
Send the command prepared with emberAfFill.... macro.
emberAfSendCommandUnicastToBindings with attached message sent callback.
Send the command prepared with emberAfFill.... macro.
Send the command prepared with emberAfFill.... macro.
emberAfSendCommandMulticast with attached message sent callback.
Send the command prepared with emberAfFill.... macro.
Send the command prepared with emberAfFill.... macro.
emberAfSendCommandUnicast with attached message sent callback.
Send the command prepared with emberAfFill.... macro.
emberAfSendCommandBroadcast with attached message sent callback.
emberAfSendCommandBroadcast from alias with attached message sent callback.
Send the command prepared with emberAfFill.... macro.
Send the command prepared with emberAfFill.... macro.
Send a default response to a cluster command.
emberAfSendDefaultResponse with attached message sent callback.
Send a default response to a cluster command using the current command.
emberAfSendImmediateDefaultResponse with attached message sent callback.
Return the maximum size of the payload that the Application Support sub-layer will accept for the given message type, destination, and APS frame.
Access to client API APS frame.
Set the source and destination endpoints in the client API APS frame.
Use this function to find devices in the network with endpoints matching a given profile ID and cluster ID in their descriptors. Target may either be a specific device, or the broadcast address EMBER_RX_ON_WHEN_IDLE_BROADCAST_ADDRESS.
Use this function to find all of the given in and out clusters implemented on a devices given endpoint. Target should only be the short address of a specific device.
Use this function to initiate a discovery for the IEEE address of the specified node id. This will send a unicast sent to the target node ID.
Use this function to initiate a discovery for the short ID of the specified long address. This will send a broadcast to all rx-on-when-idle devices (non-sleepies).
Initiate an Active Endpoint request ZDO message to the target node ID.
Use this function to add an entry for a remote device to the address table.
Use this function to add an entry for a remote device to the address table at a specific location.
Use this function to remove a specific entry from the address table.
Use this function to initiate key establishment with a remote node. emberAfKeyEstablishmentCallback will be called as events occur and when key establishment completes.
Use this function to initiate key establishment with a remote node on a different PAN. emberAfInterPanKeyEstablishmentCallback will be called as events occur and when key establishment completes.
Use this function to tell if the device is in the process of performing key establishment.
Use this function to initiate partner link key exchange with a remote node.
Use this function to determine if the security profile of the current network was set to Smart Energy. The security profile is configured in AppBuilder. @ return true if the security profile is Smart Energy or false otherwise.
Runtime subscription to specific incoming ZCL commands.
Use this function to form a new network using the specified network parameters.
Use this function to associate with the network using the specified network parameters.
Use this function to find an unused PAN id and form a new network.
Use this function to find a joinable network and join it.
Set the current network to that of the given index and adds it to the stack of networks maintained by the framework. Every call to this API must be paired with a subsequent call to emberAfPopNetworkIndex.
Set the current network to the callback network and adds it to the stack of networks maintained by the framework. Every call to this API must be paired with a subsequent call to emberAfPopNetworkIndex.
Set the current network to that of the given endpoint and adds it to the stack of networks maintained by the framework. Every call to this API must be paired with a subsequent call to emberAfPopNetworkIndex.
Remove the topmost network from the stack of networks maintained by the framework and sets the current network to the new topmost network. Every call to this API must be paired with a prior call to emberAfPushNetworkIndex, emberAfPushCallbackNetworkIndex, or emberAfPushEndpointNetworkIndex.
Return the primary endpoint of the given network index or 0xFF if no endpoints belong to the network.emberAfStatus.
Returns the primary endpoint of the current network index or 0xFF if no endpoints belong to the current network.
Return true if the cluster is in the manufacturer-specific range.
Return true if the attribute is read only.
Return true if this is a client attribute and false if if it is a server attribute.
Return true if the attribute is saved to a token.
Return true if the attribute is saved in external storage.
Return true if the attribute is a singleton.
Return true if the attribute is manufacturer specific.
Return the size of attribute in bytes.
Take an index of an endpoint and return the profile ID for it.
Take an index of an endpoint and return the device ID for it.
Take an index of an endpoint and return the device version for it.
Take an index of an endpoint and return the network index for it.
Return the primary profile ID.
Return the primary endpoint.
Extract a single byte out of the message.
Copy a uint8_t from variable into buffer.
Indicate a new image verification is taking place.
Indicate the continuation of an image verification already in progress.
The mask applied by emberAfNextSequence when generating ZCL sequence numbers.
The mask applied to generated message tags used by the framework when sending messages via EZSP. Customers who call ezspSend functions directly must use message tags outside this mask.
Return true if the cluster is in the manufacturer-specific range.
Return true if the cluster is in the manufacturer-specific range.
Return true if the cluster is in the manufacturer-specific range.
Return true if the cluster is in the manufacturer-specific range.
Return true if the cluster is in the manufacturer-specific range.
Return true if the cluster is in the manufacturer-specific range.
Friendly define for use in the scheduling or canceling client events with sl_zigbee_zcl_schedule_cluster_tick() and sl_zigbee_zcl_deactivate_cluster_tick().
Friendly define for use in the scheduling or canceling server events with sl_zigbee_zcl_schedule_cluster_tick() and sl_zigbee_zcl_deactivate_cluster_tick().
Retrieve the most restrictive sleep control value for all scheduled events. This function is used by emberAfOkToNap and emberAfOkToHibernate to makes sure that there are no events scheduled which will keep the device from hibernating or napping.
Set the default sleep control value against which all scheduled event sleep control values will be evaluated. This can be used to keep a device awake for an extended period of time by setting the default to EMBER_AF_STAY_AWAKE and then resetting the value to EMBER_AF_OK_TO_HIBERNATE once the wake period is complete.
Retrieve the default sleep control against which all event sleep control values are evaluated. The default sleep control value is initialized to EMBER_AF_OK_TO_HIBERNATE but can be changed by the application at any time using the emberAfSetDefaultSleepControl() function.
Friendly define for use in discovering client clusters with emberAfFindDevicesByProfileAndCluster().
Friendly define for use in discovering server clusters with emberAfFindDevicesByProfileAndCluster().
Return the current endpoint that is being served.
This variable defines an invalid image ID. It is used to determine if a returned EmberAfOtaImageId is valid or not. This is done by passing the data to the function emberAfIsOtaImageIdValid().
API Documentation#
emberAfLocateAttributeMetadata#
EmberAfAttributeMetadata* emberAfLocateAttributeMetadata (uint8_t endpoint, EmberAfClusterId clusterId, EmberAfAttributeId attributeId, uint8_t mask, uint16_t manufacturerCode)
Locate attribute metadata.
N/A | endpoint | Zigbee endpoint number. |
N/A | clusterId | Cluster ID of the sought cluster. |
N/A | attributeId | Attribute ID of the sought attribute. |
N/A | mask | CLUSTER_MASK_SERVER or CLUSTER_MASK_CLIENT |
N/A | manufacturerCode | Manufacturer code of the sough attribute. |
Function returns pointer to the attribute metadata structure, or NULL if attribute was not found.
Returns
Returns pointer to the attribute metadata location.
124
of file app/framework/include/af.h
emberAfContainsAttribute#
bool emberAfContainsAttribute (uint8_t endpoint, EmberAfClusterId clusterId, EmberAfAttributeId attributeId, uint8_t mask, uint16_t manufacturerCode)
Return true if the attribute exists.
N/A | endpoint | |
N/A | clusterId | |
N/A | attributeId | |
N/A | mask | |
N/A | manufacturerCode |
132
of file app/framework/include/af.h
emberAfContainsClusterWithMfgCode#
bool emberAfContainsClusterWithMfgCode (uint8_t endpoint, EmberAfClusterId clusterId, uint16_t manufacturerCode)
Return true if an endpoint contains a cluster, checking for mfg code.
N/A | endpoint | Zigbee endpoint number. |
N/A | clusterId | Cluster ID of the sought cluster. |
N/A | manufacturerCode | Manufacturer code of the sought endpoint. |
This function returns true regardless of whether the endpoint contains server, client or both. For standard libraries (when ClusterId < FC00), the manufacturerCode is ignored.
154
of file app/framework/include/af.h
emberAfContainsCluster#
bool emberAfContainsCluster (uint8_t endpoint, EmberAfClusterId clusterId)
Return true if the endpoint contains the ZCL cluster with specified ID.
N/A | endpoint | Zigbee endpoint number. |
N/A | clusterId | Cluster ID of the sought cluster. |
This function returns true regardless of whether the endpoint contains server, client or both in the Zigbee cluster Library. This wraps emberAfContainsClusterWithMfgCode with manufacturerCode = EMBER_AF_NULL_MANUFACTURER_CODE If this function is used with a manufacturer specific clusterId, it returns the first cluster that it finds in the Cluster table. It does not return any other clusters that share that ID.
170
of file app/framework/include/af.h
emberAfContainsServerWithMfgCode#
bool emberAfContainsServerWithMfgCode (uint8_t endpoint, EmberAfClusterId clusterId, uint16_t manufacturerCode)
Return true if the endpoint has a cluster server, checking for the mfg code.
N/A | endpoint | Zigbee endpoint number. |
N/A | clusterId | Cluster ID of the sought cluster. |
N/A | manufacturerCode | Manufacturer code of the sought cluster. |
This function returns true if the endpoint contains server of a given cluster. For standard libraries (when ClusterId < FC00), the manufacturerCode is ignored.
183
of file app/framework/include/af.h
emberAfContainsServer#
bool emberAfContainsServer (uint8_t endpoint, EmberAfClusterId clusterId)
Return true if the endpoint contains the ZCL server with a specified ID.
N/A | endpoint | Zigbee endpoint number. |
N/A | clusterId | Cluster ID of the sought cluster. |
This function returns true if the endpoint contains server of a given cluster. This wraps emberAfContainsServer with manufacturerCode = EMBER_AF_NULL_MANUFACTURER_CODE If this function is used with a manufacturer specific clusterId, it returns the first cluster that it finds in the Cluster table. It does not return any other clusters that share that ID.
199
of file app/framework/include/af.h
emberAfContainsClientWithMfgCode#
bool emberAfContainsClientWithMfgCode (uint8_t endpoint, EmberAfClusterId clusterId, uint16_t manufacturerCode)
Return true if the endpoint contains the cluster client.
N/A | endpoint | Zigbee endpoint number. |
N/A | clusterId | Cluster ID of the sought cluster. |
N/A | manufacturerCode | Manufacturer code of the sought cluster. |
This function returns true if the endpoint contains client of a given cluster. For standard library clusters (when ClusterId < FC00), the manufacturerCode is ignored.
213
of file app/framework/include/af.h
emberAfContainsClient#
bool emberAfContainsClient (uint8_t endpoint, EmberAfClusterId clusterId)
Return true if the endpoint contains the ZCL client with a specified ID.
N/A | endpoint | Zigbee endpoint number. |
N/A | clusterId | Cluster ID of the sought cluster. |
This function returns true if the endpoint contains client of a given cluster. It wraps emberAfContainsClient with manufacturerCode = EMBER_AF_NULL_MANUFACTURER_CODE If this function is used with a manufacturer-specific clusterId, it returns the first cluster that it finds in the Cluster table. It does not return any other clusters that share that ID.
229
of file app/framework/include/af.h
emberAfWriteAttribute#
EmberAfStatus emberAfWriteAttribute (uint8_t endpoint, EmberAfClusterId cluster, EmberAfAttributeId attributeID, uint8_t mask, uint8_t * dataPtr, EmberAfAttributeType dataType)
Write an attribute performing all checks.
N/A | endpoint | Zigbee endpoint number. |
N/A | cluster | Cluster ID of the sought cluster. |
N/A | attributeID | Attribute ID of the sought attribute. |
N/A | mask | CLUSTER_MASK_SERVER or CLUSTER_MASK_CLIENT. |
N/A | dataPtr | Pointer to the ZCL attribute. |
N/A | dataType | ZCL attribute type. |
This function attempts to write the attribute value from the provided pointer. It only checks that the attribute exists. If it does, it writes the value into the attribute table for the given attribute.
This function does not check to see if the attribute is writable since the read only / writable characteristic of an attribute only pertains to external devices writing over the air. Because this function is called locally, it assumes that the device knows what it is doing and has permission to perform the given operation.
See Also
emberAfWriteClientAttribute, emberAfWriteServerAttribute, emberAfWriteManufacturerSpecificClientAttribute, emberAfWriteManufacturerSpecificServerAttribute
257
of file app/framework/include/af.h
emberAfWriteServerAttribute#
EmberAfStatus emberAfWriteServerAttribute (uint8_t endpoint, EmberAfClusterId cluster, EmberAfAttributeId attributeID, uint8_t * dataPtr, EmberAfAttributeType dataType)
Write a cluster server attribute.
N/A | endpoint | Zigbee endpoint number. |
N/A | cluster | Cluster ID of the sought cluster. |
N/A | attributeID | Attribute ID of the sought attribute. |
N/A | dataPtr | Pointer to the ZCL attribute. |
N/A | dataType | ZCL attribute type. |
This function is the same as emberAfWriteAttribute except that it saves having to pass the cluster mask. This is useful for code saving because the write attribute is used frequently throughout the framework
See Also
emberAfWriteClientAttribute, emberAfWriteManufacturerSpecificClientAttribute, emberAfWriteManufacturerSpecificServerAttribute
282
of file app/framework/include/af.h
emberAfWriteClientAttribute#
EmberAfStatus emberAfWriteClientAttribute (uint8_t endpoint, EmberAfClusterId cluster, EmberAfAttributeId attributeID, uint8_t * dataPtr, EmberAfAttributeType dataType)
Write a cluster client attribute.
N/A | endpoint | Zigbee endpoint number. |
N/A | cluster | Cluster ID of the sought cluster. |
N/A | attributeID | Attribute ID of the sought attribute. |
N/A | dataPtr | Pointer to the ZCL attribute. |
N/A | dataType | ZCL attribute type. |
This function is the same as emberAfWriteAttribute except that it saves having to pass the cluster mask. This is useful for code saving because the write attribute is used frequently throughout the framework.
See Also
emberAfWriteServerAttribute, emberAfWriteManufacturerSpecificClientAttribute, emberAfWriteManufacturerSpecificServerAttribute
306
of file app/framework/include/af.h
emberAfWriteManufacturerSpecificServerAttribute#
EmberAfStatus emberAfWriteManufacturerSpecificServerAttribute (uint8_t endpoint, EmberAfClusterId cluster, EmberAfAttributeId attributeID, uint16_t manufacturerCode, uint8_t * dataPtr, EmberAfAttributeType dataType)
Write a manufacturer-specific server attribute.
N/A | endpoint | Zigbee endpoint number. |
N/A | cluster | Cluster ID of the sought cluster. |
N/A | attributeID | Attribute ID of the sought attribute. |
N/A | manufacturerCode | Manufacturer code of the sought cluster. |
N/A | dataPtr | Pointer to the ZCL attribute. |
N/A | dataType | ZCL attribute type. |
This function is the same as emberAfWriteAttribute except that it saves having to pass the cluster mask and allows passing a manufacturer code. This is useful for code saving because the write attribute is used frequently throughout the framework.
See Also
emberAfWriteClientAttribute, emberAfWriteServerAttribute, emberAfWriteManufacturerSpecificClientAttribute
331
of file app/framework/include/af.h
emberAfWriteManufacturerSpecificClientAttribute#
EmberAfStatus emberAfWriteManufacturerSpecificClientAttribute (uint8_t endpoint, EmberAfClusterId cluster, EmberAfAttributeId attributeID, uint16_t manufacturerCode, uint8_t * dataPtr, EmberAfAttributeType dataType)
Write a manufacturer-specific client attribute.
N/A | endpoint | Zigbee endpoint number. |
N/A | cluster | Cluster ID of the sought cluster. |
N/A | attributeID | Attribute ID of the sought attribute. |
N/A | manufacturerCode | Manufacturer code of the sought cluster. |
N/A | dataPtr | Pointer to the ZCL attribute. |
N/A | dataType | ZCL attribute type. |
This function is the same as emberAfWriteAttribute except that it saves having to pass the cluster mask and allows passing of a manufacturer code. This is useful for code saving because the write attribute is used frequently throughout the framework.
See Also
emberAfWriteClientAttribute, emberAfWriteServerAttribute, emberAfWriteManufacturerSpecificServerAttribute
357
of file app/framework/include/af.h
emberAfVerifyAttributeWrite#
EmberAfStatus emberAfVerifyAttributeWrite (uint8_t endpoint, EmberAfClusterId cluster, EmberAfAttributeId attributeID, uint8_t mask, uint16_t manufacturerCode, uint8_t * dataPtr, EmberAfAttributeType dataType)
Test the success of attribute write.
N/A | endpoint | Zigbee endpoint number |
N/A | cluster | Cluster ID of the sought cluster. |
N/A | attributeID | Attribute ID of the sought attribute. |
N/A | mask | CLUSTER_MASK_SERVER or CLUSTER_MASK_CLIENT |
N/A | manufacturerCode | Location where attribute will be written from. |
N/A | dataPtr | ZCL attribute type. |
N/A | dataType |
This function returns success if the attribute write is successful. It does not actually write anything, just validates for read-only and data-type.
378
of file app/framework/include/af.h
emberAfReadAttribute#
EmberAfStatus emberAfReadAttribute (uint8_t endpoint, EmberAfClusterId cluster, EmberAfAttributeId attributeID, uint8_t mask, uint8_t * dataPtr, uint8_t readLength, EmberAfAttributeType * dataType)
Read the attribute value performing all the checks.
N/A | endpoint | Zigbee endpoint number |
N/A | cluster | Cluster ID of the sought cluster. |
N/A | attributeID | Attribute ID of the sought attribute. |
N/A | mask | CLUSTER_MASK_SERVER or CLUSTER_MASK_CLIENT |
N/A | dataPtr | Pointer to the ZCL attribute. |
N/A | readLength | Length of the attribute to be read. |
N/A | dataType | ZCL attribute type. |
This function attempts to read the attribute and store it into the pointer. It also reads the data type. Both dataPtr and dataType may be NULL, signifying that either value or type is not desired.
See Also
emberAfReadClientAttribute, emberAfReadServerAttribute, emberAfReadManufacturerSpecificClientAttribute, emberAfReadManufacturerSpecificServerAttribute
406
of file app/framework/include/af.h
emberAfReadServerAttribute#
EmberAfStatus emberAfReadServerAttribute (uint8_t endpoint, EmberAfClusterId cluster, EmberAfAttributeId attributeID, uint8_t * dataPtr, uint8_t readLength)
Read the server attribute value performing all the checks.
N/A | endpoint | Zigbee endpoint number |
N/A | cluster | Cluster ID of the sought cluster. |
N/A | attributeID | Attribute ID of the sought attribute. |
N/A | dataPtr | Pointer to the server attribute. |
N/A | readLength | Length of the attribute to be read. |
This function attempts to read the attribute and store it into the pointer. It also reads the data type. Both dataPtr and dataType may be NULL, signifying that either value or type is not desired.
See Also
emberAfReadClientAttribute, emberAfReadManufacturerSpecificClientAttribute, emberAfReadManufacturerSpecificServerAttribute
432
of file app/framework/include/af.h
emberAfReadClientAttribute#
EmberAfStatus emberAfReadClientAttribute (uint8_t endpoint, EmberAfClusterId cluster, EmberAfAttributeId attributeID, uint8_t * dataPtr, uint8_t readLength)
Read the client attribute value, performing all the checks.
N/A | endpoint | Zigbee endpoint number |
N/A | cluster | Cluster ID of the sought cluster. |
N/A | attributeID | Attribute ID of the sought attribute. |
N/A | dataPtr | Pointer to the client attribute. |
N/A | readLength | Length of the attribute to be read. |
This function attempts to read the attribute and store it into the pointer. It also reads the data type. Both dataPtr and dataType may be NULL, signifying that either value or type is not desired.
See Also
emberAfReadServerAttribute, emberAfReadManufacturerSpecificClientAttribute, emberAfReadManufacturerSpecificServerAttribute
456
of file app/framework/include/af.h
emberAfReadManufacturerSpecificServerAttribute#
EmberAfStatus emberAfReadManufacturerSpecificServerAttribute (uint8_t endpoint, EmberAfClusterId cluster, EmberAfAttributeId attributeID, uint16_t manufacturerCode, uint8_t * dataPtr, uint8_t readLength)
Read the manufacturer-specific server attribute value, performing all checks.
N/A | endpoint | Zigbee endpoint number |
N/A | cluster | Cluster ID of the sought cluster. |
N/A | attributeID | Attribute ID of the sought attribute. |
N/A | manufacturerCode | Manufacturer code of the sought cluster. |
N/A | dataPtr | Pointer to the server attribute. |
N/A | readLength | Length of the attribute to be read. |
This function attempts to read the attribute and store it into the pointer. It also reads the data type. Both dataPtr and dataType may be NULL, signifying that either value or type is not desired.
See Also
emberAfReadClientAttribute, emberAfReadServerAttribute, emberAfReadManufacturerSpecificClientAttribute
480
of file app/framework/include/af.h
emberAfReadManufacturerSpecificClientAttribute#
EmberAfStatus emberAfReadManufacturerSpecificClientAttribute (uint8_t endpoint, EmberAfClusterId cluster, EmberAfAttributeId attributeID, uint16_t manufacturerCode, uint8_t * dataPtr, uint8_t readLength)
Read the manufacturer-specific client attribute value, performing all checks.
N/A | endpoint | Zigbee endpoint number |
N/A | cluster | Cluster ID of the sought cluster. |
N/A | attributeID | Attribute ID of the sought attribute. |
N/A | manufacturerCode | Manufacturer code of the sought cluster. |
N/A | dataPtr | Pointer to the server attribute. |
N/A | readLength | Length of the attribute to be read. |
This function attempts to read the attribute and store it into the pointer. It also reads the data type. Both dataPtr and dataType may be NULL, signifying that either value or type is not desired.
See Also
emberAfReadClientAttribute, emberAfReadServerAttribute, emberAfReadManufacturerSpecificServerAttribute
505
of file app/framework/include/af.h
emberAfGetDataSize#
uint8_t emberAfGetDataSize (uint8_t dataType)
Return the size of the ZCL data in bytes.
N/A | dataType | ZCL data type |
Returns
Size in bytes or 0 if invalid data type
518
of file app/framework/include/af.h
emberAfGetOpenNetworkDurationSec#
uint8_t emberAfGetOpenNetworkDurationSec (void )
Return the number of seconds the network remains open.
N/A |
Returns
A return value of 0 indicates that the network is closed.
525
of file app/framework/include/af.h
emberAfEndpointFromIndex#
uint8_t emberAfEndpointFromIndex (uint8_t index)
Take an index of an endpoint and return the Zigbee endpoint.
N/A | index | Index of an endpoint. |
Returns
Zigbee endpoint.
604
of file app/framework/include/af.h
emberAfIndexFromEndpoint#
uint8_t emberAfIndexFromEndpoint (uint8_t endpoint)
N/A | endpoint | Zigbee endpoint. |
Return the index of a given endpoint.
Returns
Index of a Zigbee endpoint.
612
of file app/framework/include/af.h
emberAfIndexFromEndpointIncludingDisabledEndpoints#
uint8_t emberAfIndexFromEndpointIncludingDisabledEndpoints (uint8_t endpoint)
N/A | endpoint | Zigbee endpoint. |
Return the index of a given endpoint. It does not ignore disabled endpoints.
Returns
Index of a Zigbee endpoint.
620
of file app/framework/include/af.h
emberAfFindClusterClientEndpointIndex#
uint8_t emberAfFindClusterClientEndpointIndex (uint8_t endpoint, EmberAfClusterId clusterId)
N/A | endpoint | Zigbee endpoint. |
N/A | clusterId | Cluster ID of a sought cluster. |
Return the endpoint index within a given cluster (Client-side), looking only for standard clusters.
Returns
Index of a Zigbee endpoint.
630
of file app/framework/include/af.h
emberAfFindClusterServerEndpointIndex#
uint8_t emberAfFindClusterServerEndpointIndex (uint8_t endpoint, EmberAfClusterId clusterId)
N/A | endpoint | Zigbee endpoint. |
N/A | clusterId | Cluster ID of a sought cluster. |
Return the endpoint index within a given cluster (Server-side), looking only for standard clusters.
Returns
Index of a Zigbee endpoint.
640
of file app/framework/include/af.h
emberAfNetworkIndexFromEndpoint#
uint8_t emberAfNetworkIndexFromEndpoint (uint8_t endpoint)
Return the network index of a given endpoint.
N/A | endpoint | Zigbee endpoint. |
Returns
Network index of a Zigbee endpoint.
668
of file app/framework/include/af.h
emberAfEndpointCount#
uint8_t emberAfEndpointCount (void )
Return the total number of endpoints (dynamic and pre-compiled).
N/A |
686
of file app/framework/include/af.h
emberAfFixedEndpointCount#
uint8_t emberAfFixedEndpointCount (void )
Return the number of pre-compiled endpoints.
N/A |
691
of file app/framework/include/af.h
emberAfGetAttributeAnalogOrDiscreteType#
uint8_t emberAfGetAttributeAnalogOrDiscreteType (uint8_t dataType)
Return the type of the attribute, either ANALOG, DISCRETE, or NONE.
N/A | dataType |
708
of file app/framework/include/af.h
emberAfIsTypeSigned#
bool emberAfIsTypeSigned (EmberAfAttributeType dataType)
Return true if type is signed, false otherwise.
N/A | dataType |
713
of file app/framework/include/af.h
emberAfGetInt32u#
uint32_t emberAfGetInt32u (const uint8_t * message, uint16_t currentIndex, uint16_t msgLen)
Extract a 32-bit integer from the message buffer.
N/A | message | |
N/A | currentIndex | |
N/A | msgLen |
718
of file app/framework/include/af.h
emberAfGetInt24u#
uint32_t emberAfGetInt24u (const uint8_t * message, uint16_t currentIndex, uint16_t msgLen)
Extract a 24-bit integer from the message buffer.
N/A | message | |
N/A | currentIndex | |
N/A | msgLen |
723
of file app/framework/include/af.h
emberAfGetInt16u#
uint16_t emberAfGetInt16u (const uint8_t * message, uint16_t currentIndex, uint16_t msgLen)
Extract a 16-bit integer from the message buffer.
N/A | message | |
N/A | currentIndex | |
N/A | msgLen |
728
of file app/framework/include/af.h
emberAfGetString#
uint8_t* emberAfGetString (uint8_t * message, uint16_t currentIndex, uint16_t msgLen)
Extract a ZCL string from the message buffer.
N/A | message | |
N/A | currentIndex | |
N/A | msgLen |
732
of file app/framework/include/af.h
emberAfGetLongString#
uint8_t* emberAfGetLongString (uint8_t * message, uint16_t currentIndex, uint16_t msgLen)
Extract a ZCL long string from the message buffer.
N/A | message | |
N/A | currentIndex | |
N/A | msgLen |
736
of file app/framework/include/af.h
emberAfGetDate#
uint8_t emberAfGetDate (uint8_t * message, uint16_t currentIndex, uint16_t msgLen, EmberAfDate * destination)
Return true if the cluster is in the manufacturer-specific range.
N/A | message | EmberAfCluster* to consider |
N/A | currentIndex | |
N/A | msgLen | |
N/A | destination |
741
of file app/framework/include/af.h
emberAfCopyInt16u#
void emberAfCopyInt16u (uint8_t * data, uint16_t index, uint16_t x)
Copy a uint16_t value into a buffer.
N/A | data | |
N/A | index | |
N/A | x |
755
of file app/framework/include/af.h
emberAfCopyInt24u#
void emberAfCopyInt24u (uint8_t * data, uint16_t index, uint32_t x)
Copy a uint24_t value into a buffer.
N/A | data | |
N/A | index | |
N/A | x |
759
of file app/framework/include/af.h
emberAfCopyInt32u#
void emberAfCopyInt32u (uint8_t * data, uint16_t index, uint32_t x)
Copy a uint32_t value into a buffer.
N/A | data | |
N/A | index | |
N/A | x |
763
of file app/framework/include/af.h
emberAfCopyString#
void emberAfCopyString (uint8_t * dest, uint8_t * src, uint8_t size)
Return true if the cluster is in the manufacturer-specific range.
N/A | dest | EmberAfCluster* to consider |
N/A | src | |
N/A | size |
769
of file app/framework/include/af.h
emberAfCopyLongString#
void emberAfCopyLongString (uint8_t * dest, uint8_t * src, uint16_t size)
Return true if the cluster is in the manufacturer-specific range.
N/A | dest | EmberAfCluster* to consider |
N/A | src | |
N/A | size |
775
of file app/framework/include/af.h
emberAfStringLength#
uint8_t emberAfStringLength (const uint8_t * buffer)
Return true if the cluster is in the manufacturer-specific range.
N/A | buffer | EmberAfCluster* to consider |
780
of file app/framework/include/af.h
emberAfLongStringLength#
uint16_t emberAfLongStringLength (const uint8_t * buffer)
Return true if the cluster is in the manufacturer-specific range.
N/A | buffer | EmberAfCluster* to consider |
785
of file app/framework/include/af.h
emberAfAttributeValueSize#
uint16_t emberAfAttributeValueSize (EmberAfAttributeType dataType, const uint8_t * buffer, const uint16_t bufferSize)
Return true if the cluster is in the manufacturer-specific range.
N/A | dataType | EmberAfCluster* to consider |
N/A | buffer | |
N/A | bufferSize |
805
of file app/framework/include/af.h
emberAfIsDeviceEnabled#
bool emberAfIsDeviceEnabled (uint8_t endpoint)
Check whether the endpoint is enabled.
N/A | endpoint | Zigbee endpoint number |
This function returns true if device at a given endpoint is enabled. At startup all endpoints are enabled.
838
of file app/framework/include/af.h
emberAfIsDeviceIdentifying#
bool emberAfIsDeviceIdentifying (uint8_t endpoint)
Check whether the endpoint is identifying.
N/A | endpoint | Zigbee endpoint number |
This function returns true if the device at a given endpoint is identifying.
848
of file app/framework/include/af.h
emberAfSetDeviceEnabled#
void emberAfSetDeviceEnabled (uint8_t endpoint, bool enabled)
Enable or disables an endpoint.
N/A | endpoint | Zigbee endpoint number |
N/A | enabled |
By calling this function, you turn off all processing of incoming traffic for a given endpoint.
858
of file app/framework/include/af.h
sl_zigbee_common_rtos_wakeup_stack_task#
void sl_zigbee_common_rtos_wakeup_stack_task (void )
When running on an OS, this API sets the Zigbee stack task to ready.
N/A |
884
of file app/framework/include/af.h
emberAfEndpointEnableDisable#
bool emberAfEndpointEnableDisable (uint8_t endpoint, bool enable)
Enable/disable endpoints.
N/A | endpoint | |
N/A | enable |
889
of file app/framework/include/af.h
emberAfEndpointIndexIsEnabled#
bool emberAfEndpointIndexIsEnabled (uint8_t index)
Determine if an endpoint at the specified index is enabled or disabled.
N/A | index |
894
of file app/framework/include/af.h
emberAfIsThisDataTypeAStringType#
bool emberAfIsThisDataTypeAStringType (EmberAfAttributeType dataType)
Return true if a given ZCL data type is a string type.
N/A | dataType |
Use this function to perform a different memory operation on a certain attribute because it is a string type. Since ZCL strings carry length as the first byte(s), it is often required to treat them differently than regular data types.
Returns
true if data type is a string.
925
of file app/framework/include/af.h
emberAfIsStringAttributeType#
bool emberAfIsStringAttributeType (EmberAfAttributeType attributeType)
Return true if the given attribute type is a string.
N/A | attributeType |
928
of file app/framework/include/af.h
emberAfIsLongStringAttributeType#
bool emberAfIsLongStringAttributeType (EmberAfAttributeType attributeType)
Return true if the given attribute type is a long string.
N/A | attributeType |
931
of file app/framework/include/af.h
emberAfNextSequence#
uint8_t emberAfNextSequence (void )
Increment the ZCL sequence number and returns the value.
N/A |
ZCL messages have sequence numbers so that they can be matched up with other messages in the transaction. To avoid conflicts with sequence numbers generated independently by the application, this API returns sequence numbers with the high bit clear. If the application generates its own sequence numbers, it should use numbers with the high bit set.
Returns
The next ZCL sequence number.
956
of file app/framework/include/af.h
emberAfGetLastSequenceNumber#
uint8_t emberAfGetLastSequenceNumber (void )
Retrieve the last sequence number that was used.
N/A |
962
of file app/framework/include/af.h
emberAfCompareValues#
int8_t emberAfCompareValues (uint8_t * val1, uint8_t * val2, uint8_t len, bool signedNumber)
Simple integer comparison function. Compares two values of a known length as integers. Signed integer comparison are supported for numbers with length of 4 (bytes) or less. The integers are in native endianness.
N/A | val1 | |
N/A | val2 | |
N/A | len | |
N/A | signedNumber |
Returns
-1, if val1 is smaller 0, if they are the same or if two negative numbers with length greater than 4 is being compared 1, if val2 is smaller.
976
of file app/framework/include/af.h
emberAfGetEui64#
void emberAfGetEui64 (EmberEUI64 returnEui64)
Populate the passed EUI64 with the local EUI64 MAC address.
N/A | returnEui64 |
981
of file app/framework/include/af.h
emberAfGetNodeId#
EmberNodeId emberAfGetNodeId (void )
Return the node ID of the local node.
N/A |
992
of file app/framework/include/af.h
emberAfGenerateRandomKey#
EmberStatus emberAfGenerateRandomKey (EmberKeyData * result)
Generate a random key (link, network, or master).
N/A | result |
998
of file app/framework/include/af.h
emberAfGetPanId#
EmberPanId emberAfGetPanId (void )
Return the PAN ID of the local node.
N/A |
1006
of file app/framework/include/af.h
emberAfGetRadioChannel#
uint8_t emberAfGetRadioChannel (void )
Return the radioChannel of the current network.
N/A |
Get this node's radio channel for the current network.
1011
of file app/framework/include/af.h
emberAfGetBindingIndex#
uint8_t emberAfGetBindingIndex (void )
Return true if the cluster is in the manufacturer-specific range.
N/A | EmberAfCluster* to consider |
1017
of file app/framework/include/af.h
emberAfGetAddressIndex#
uint8_t emberAfGetAddressIndex (void )
Return true if the cluster is in the manufacturer-specific range.
N/A | EmberAfCluster* to consider |
1023
of file app/framework/include/af.h
emberAfNetworkState#
EmberNetworkStatus emberAfNetworkState (void )
Return the current network state. This call caches the results on the host to prevent frequent EZSP transactions.
N/A |
1029
of file app/framework/include/af.h
emberAfGetNetworkParameters#
EmberStatus emberAfGetNetworkParameters (EmberNodeType * nodeType, EmberNetworkParameters * parameters)
Return the current network parameters.
N/A | nodeType | |
N/A | parameters |
1039
of file app/framework/include/af.h
emberAfGetNodeType#
EmberStatus emberAfGetNodeType (EmberNodeType * nodeType)
Returns the current node type.
N/A | nodeType |
1045
of file app/framework/include/af.h
emberAfPermitJoin#
EmberStatus emberAfPermitJoin (uint8_t duration, bool broadcastMgmtPermitJoin)
Enable local permit join and optionally broadcasts the ZDO Mgmt_Permit_Join_req message. This API can be called from any device type and still return EMBER_SUCCESS. If the API is called from an end device, the permit association bit will just be left off.
N/A | duration | The duration that the permit join bit will remain on and other devices will be able to join the current network. |
N/A | broadcastMgmtPermitJoin | whether or not to broadcast the ZDO Mgmt_Permit_Join_req message. |
Returns
status of whether or not permit join was enabled.
1070
of file app/framework/include/af.h
emberAfBroadcastPermitJoin#
EmberStatus emberAfBroadcastPermitJoin (uint8_t duration)
Enable local permit join and broadcasts the ZDO Mgmt_Permit_Join_req message. This API can be called from any device type and still return EMBER_SUCCESS. If the API is called from an end device, the permit association bit will just be left off.
N/A | duration | The duration that the permit join bit will remain on and other devices will be able to join the current network. |
Returns
status of whether or not permit join was enabled.
1085
of file app/framework/include/af.h
sl_zigbee_zcl_schedule_tick_extended#
EmberStatus sl_zigbee_zcl_schedule_tick_extended (uint8_t endpoint, EmberAfClusterId clusterId, bool isClient, uint32_t delayMs, EmberAfEventPollControl pollControl, EmberAfEventSleepControl sleepControl)
Schedule a cluster-related event inside the application framework's event mechanism. This function provides a wrapper for the Ember stack event mechanism which allows the cluster code to access its events by their endpoint, cluster ID, and client/server identity. The passed poll and sleep controls allow the cluster to indicate whether it needs to long or short poll and whether it needs to stay awake or if it can sleep.
N/A | endpoint | The endpoint of the event to be scheduled. |
N/A | clusterId | The cluster id of the event to be scheduled. |
N/A | isClient | EMBER_AF_CLIENT_CLUSTER_TICK if the event to be scheduled is associated with a client cluster or EMBER_AF_SERVER_CLUSTER_TICK otherwise. |
N/A | delayMs | The number of milliseconds until the event should be called. |
N/A | pollControl | EMBER_AF_SHORT_POLL if the cluster needs to short poll or EMBER_AF_LONG_POLL otherwise. |
N/A | sleepControl | EMBER_AF_STAY_AWAKE if the cluster needs to stay awake or EMBER_AF_OK_TO_SLEEP otherwise. |
Returns
EMBER_SUCCESS if the event was scheduled or an error otherwise.
1148
of file app/framework/include/af.h
sl_zigbee_zcl_schedule_cluster_tick#
EmberStatus sl_zigbee_zcl_schedule_cluster_tick (uint8_t endpoint, EmberAfClusterId clusterId, bool isClient, uint32_t delayMs, EmberAfEventSleepControl sleepControl)
Schedule a cluster-related event inside the This function is a wrapper for ::emberAfScheduleTickExtended. The cluster on the given endpoint will be set to long poll if sleepControl is set to EMBER_AF_OK_TO_HIBERNATE or will be set to short poll otherwise. It will stay awake if sleepControl is EMBER_AF_STAY_AWAKE and will sleep otherwise.
N/A | endpoint | The endpoint of the event to be scheduled. |
N/A | clusterId | The cluster id of the event to be scheduled. |
N/A | isClient | EMBER_AF_CLIENT_CLUSTER_TICK if the event to be scheduled is associated with a client cluster or EMBER_AF_SERVER_CLUSTER_TICK otherwise. |
N/A | delayMs | The number of milliseconds until the event should be called. |
N/A | sleepControl | the priority of the event, what the processor should be allowed to do in terms of sleeping while the event is active. |
Returns
EMBER_SUCCESS if the event was scheduled or an error otherwise.
1174
of file app/framework/include/af.h
sl_zigbee_zcl_schedule_client_tick_extended#
EmberStatus sl_zigbee_zcl_schedule_client_tick_extended (uint8_t endpoint, EmberAfClusterId clusterId, uint32_t delayMs, EmberAfEventPollControl pollControl, EmberAfEventSleepControl sleepControl)
Schedule a cluster client event. This function is a wrapper for sl_zigbee_zcl_schedule_tick_extended.
N/A | endpoint | The endpoint of the event to be scheduled |
N/A | clusterId | The cluster id of the event to be scheduled |
N/A | delayMs | The number of milliseconds until the event should be called. |
N/A | pollControl | EMBER_AF_SHORT_POLL if the cluster needs to short poll or EMBER_AF_LONG_POLL otherwise. |
N/A | sleepControl | EMBER_AF_STAY_AWAKE if the cluster needs to stay awake or EMBER_AF_OK_TO_SLEEP otherwise. |
Returns
EMBER_SUCCESS if the event was scheduled or an error otherwise.
1194
of file app/framework/include/af.h
sl_zigbee_zcl_schedule_client_tick#
EmberStatus sl_zigbee_zcl_schedule_client_tick (uint8_t endpoint, EmberAfClusterId clusterId, uint32_t delayMs)
Schedule a cluster client event. This function is a wrapper for sl_zigbee_zcl_schedule_client_tick_extended. It indicates that the cluster client on the given endpoint can long poll and can sleep.
N/A | endpoint | The endpoint of the event to be scheduled. |
N/A | clusterId | The cluster id of the event to be scheduled. |
N/A | delayMs | The number of milliseconds until the event should be called. |
Returns
EMBER_SUCCESS if the event was scheduled or an error otherwise.
1211
of file app/framework/include/af.h
sl_zigbee_zcl_schedule_server_tick_extended#
EmberStatus sl_zigbee_zcl_schedule_server_tick_extended (uint8_t endpoint, EmberAfClusterId clusterId, uint32_t delayMs, EmberAfEventPollControl pollControl, EmberAfEventSleepControl sleepControl)
Schedule a cluster server event. This function is a wrapper for sl_zigbee_zcl_schedule_tick_extended.
N/A | endpoint | The endpoint of the event to be scheduled. |
N/A | clusterId | The cluster id of the event to be scheduled. |
N/A | delayMs | The number of milliseconds until the event should be called. |
N/A | pollControl | EMBER_AF_SHORT_POLL if the cluster needs to short poll or EMBER_AF_LONG_POLL otherwise. |
N/A | sleepControl | EMBER_AF_STAY_AWAKE if the cluster needs to stay awake or EMBER_AF_OK_TO_SLEEP otherwise. |
Returns
EMBER_SUCCESS if the event was scheduled or an error otherwise.
1229
of file app/framework/include/af.h
sl_zigbee_zcl_schedule_server_tick#
EmberStatus sl_zigbee_zcl_schedule_server_tick (uint8_t endpoint, EmberAfClusterId clusterId, uint32_t delayMs)
Schedule a cluster server event. This function is a wrapper for sl_zigbee_zcl_schedule_server_tick_extended. It indicates that the cluster server on the given endpoint can long poll and can sleep.
N/A | endpoint | The endpoint of the event to be scheduled |
N/A | clusterId | The cluster id of the event to be scheduled. |
N/A | delayMs | The number of milliseconds until the event should be called. |
Returns
EMBER_SUCCESS if the event was scheduled or an error otherwise.
1246
of file app/framework/include/af.h
sl_zigbee_zcl_deactivate_cluster_tick#
EmberStatus sl_zigbee_zcl_deactivate_cluster_tick (uint8_t endpoint, EmberAfClusterId clusterId, bool isClient)
Deactivate a cluster-related event. This function provides a wrapper for the Ember stack's event mechanism which allows an event to be accessed by its endpoint, cluster id, and client/server identity.
N/A | endpoint | The endpoint of the event to be deactivated. |
N/A | clusterId | The cluster id of the event to be deactivated. |
N/A | isClient | EMBER_AF_CLIENT_CLUSTER_TICK if the event to be deactivated is a client cluster EMBER_AF_SERVER_CLUSTER_TICK otherwise. |
Returns
EMBER_SUCCESS if the event was deactivated or an error otherwise.
1264
of file app/framework/include/af.h
sl_zigbee_zcl_deactivate_client_tick#
EmberStatus sl_zigbee_zcl_deactivate_client_tick (uint8_t endpoint, EmberAfClusterId clusterId)
Deactivate a cluster client event. This function is a wrapper for sl_zigbee_zcl_deactivate_cluster_tick.
N/A | endpoint | The endpoint of the event to be deactivated. |
N/A | clusterId | The cluster id of the event to be deactivated. |
Returns
EMBER_SUCCESS if the event was deactivated or an error otherwise.
1277
of file app/framework/include/af.h
sl_zigbee_zcl_deactivate_server_tick#
EmberStatus sl_zigbee_zcl_deactivate_server_tick (uint8_t endpoint, EmberAfClusterId clusterId)
Deactivate a cluster server event. This function is a wrapper for sl_zigbee_zcl_deactivate_cluster_tick.
N/A | endpoint | The endpoint of the event to be deactivated. |
N/A | clusterId | The cluster id of the event to be deactivated. |
Returns
EMBER_SUCCESS if the event was deactivated or an error otherwise.
1289
of file app/framework/include/af.h
emberAfSendResponse#
EmberStatus emberAfSendResponse (void )
Send a ZCL response, based on the information that is currently in the outgoing buffer. It is expected that a complete ZCL message is present, including header. The application may use this method directly from within the message handling function and associated callbacks. However, this will result in the response being sent before the APS ACK is sent which is not ideal.
N/A |
NOTE: This will overwrite the ZCL sequence number of the message to use the LAST received sequence number.
1386
of file app/framework/include/af.h
emberAfSendResponseWithCallback#
EmberStatus emberAfSendResponseWithCallback (EmberAfMessageSentFunction callback)
Send ZCL response with attached message sent callback.
N/A | callback |
1391
of file app/framework/include/af.h
emberAfSendMulticast#
EmberStatus emberAfSendMulticast (EmberMulticastId multicastId, EmberApsFrame * apsFrame, uint16_t messageLength, uint8_t * message)
Sends multicast.
N/A | multicastId | |
N/A | apsFrame | |
N/A | messageLength | |
N/A | message |
1396
of file app/framework/include/af.h
emberAfSendMulticastToBindings#
EmberStatus emberAfSendMulticastToBindings (EmberApsFrame * apsFrame, uint16_t messageLength, uint8_t * message)
Multicasts the message to the group in the binding table that matches the cluster and source endpoint in the APS frame. Note: if the binding table contains many matching entries, calling this API cause a significant amount of network traffic. Care should be taken when considering the effects of broadcasts in a network.
N/A | apsFrame | |
N/A | messageLength | |
N/A | message |
1408
of file app/framework/include/af.h
emberAfSendMulticastWithAliasWithCallback#
EmberStatus emberAfSendMulticastWithAliasWithCallback (EmberMulticastId multicastId, EmberApsFrame * apsFrame, uint16_t messageLength, uint8_t * message, EmberNodeId alias, uint8_t sequence, EmberAfMessageSentFunction callback)
Send Multicast with alias with attached message sent callback.
N/A | multicastId | |
N/A | apsFrame | |
N/A | messageLength | |
N/A | message | |
N/A | alias | |
N/A | sequence | |
N/A | callback |
1415
of file app/framework/include/af.h
emberAfSendMulticastWithCallback#
EmberStatus emberAfSendMulticastWithCallback (EmberMulticastId multicastId, EmberApsFrame * apsFrame, uint16_t messageLength, uint8_t * message, EmberAfMessageSentFunction callback)
Send multicast with attached message sent callback.
N/A | multicastId | |
N/A | apsFrame | |
N/A | messageLength | |
N/A | message | |
N/A | callback |
1426
of file app/framework/include/af.h
emberAfSendBroadcast#
EmberStatus emberAfSendBroadcast (EmberNodeId destination, EmberApsFrame * apsFrame, uint16_t messageLength, uint8_t * message)
Send broadcast.
N/A | destination | |
N/A | apsFrame | |
N/A | messageLength | |
N/A | message |
1435
of file app/framework/include/af.h
emberAfSendBroadcastWithCallback#
EmberStatus emberAfSendBroadcastWithCallback (EmberNodeId destination, EmberApsFrame * apsFrame, uint16_t messageLength, uint8_t * message, EmberAfMessageSentFunction callback)
Send broadcast with attached message sent callback.
N/A | destination | |
N/A | apsFrame | |
N/A | messageLength | |
N/A | message | |
N/A | callback |
1443
of file app/framework/include/af.h
emberAfSendBroadcastWithAliasWithCallback#
EmberStatus emberAfSendBroadcastWithAliasWithCallback (EmberNodeId destination, EmberApsFrame * apsFrame, uint16_t messageLength, uint8_t * message, EmberNodeId alias, uint8_t sequence, EmberAfMessageSentFunction callback)
Send broadcast with alias with attached message sent callback.
N/A | destination | |
N/A | apsFrame | |
N/A | messageLength | |
N/A | message | |
N/A | alias | |
N/A | sequence | |
N/A | callback |
1452
of file app/framework/include/af.h
emberAfSendUnicast#
EmberStatus emberAfSendUnicast (EmberOutgoingMessageType type, uint16_t indexOrDestination, EmberApsFrame * apsFrame, uint16_t messageLength, uint8_t * message)
Send unicast.
N/A | type | |
N/A | indexOrDestination | |
N/A | apsFrame | |
N/A | messageLength | |
N/A | message |
1463
of file app/framework/include/af.h
emberAfSendUnicastWithCallback#
EmberStatus emberAfSendUnicastWithCallback (EmberOutgoingMessageType type, uint16_t indexOrDestination, EmberApsFrame * apsFrame, uint16_t messageLength, uint8_t * message, EmberAfMessageSentFunction callback)
Send unicast with attached message sent callback.
N/A | type | |
N/A | indexOrDestination | |
N/A | apsFrame | |
N/A | messageLength | |
N/A | message | |
N/A | callback |
1472
of file app/framework/include/af.h
emberAfSendUnicastToBindings#
EmberStatus emberAfSendUnicastToBindings (EmberApsFrame * apsFrame, uint16_t messageLength, uint8_t * message)
Unicast the message to each remote node in the binding table that matches the cluster and source endpoint in the APS frame. Note: if the binding table contains many matching entries, calling this API cause a significant amount of network traffic.
N/A | apsFrame | |
N/A | messageLength | |
N/A | message |
1485
of file app/framework/include/af.h
emberAfSendUnicastToBindingsWithCallback#
EmberStatus emberAfSendUnicastToBindingsWithCallback (EmberApsFrame * apsFrame, uint16_t messageLength, uint8_t * message, EmberAfMessageSentFunction callback)
emberAfSendUnicastToBindings with attached message sent callback.
N/A | apsFrame | |
N/A | messageLength | |
N/A | message | |
N/A | callback |
1492
of file app/framework/include/af.h
emberAfSendInterPan#
EmberStatus emberAfSendInterPan (EmberPanId panId, const EmberEUI64 destinationLongId, EmberNodeId destinationShortId, EmberMulticastId multicastId, EmberAfClusterId clusterId, EmberAfProfileId profileId, uint16_t messageLength, uint8_t * messageBytes)
Send interpan message.
N/A | panId | |
N/A | destinationLongId | |
N/A | destinationShortId | |
N/A | multicastId | |
N/A | clusterId | |
N/A | profileId | |
N/A | messageLength | |
N/A | messageBytes |
1500
of file app/framework/include/af.h
emberAfSendEndDeviceBind#
EmberStatus emberAfSendEndDeviceBind (uint8_t endpoint)
Send end device binding request.
N/A | endpoint |
1512
of file app/framework/include/af.h
emberAfSendCommandUnicastToBindings#
EmberStatus emberAfSendCommandUnicastToBindings (void )
Send the command prepared with emberAfFill.... macro.
N/A |
This function is used to send a command that was previously prepared using the emberAfFill... macros from the client command API. It will be sent as unicast to each remote node in the binding table that matches the cluster and source endpoint in the APS frame. Note: if the binding table contains many matching entries, calling this API cause a significant amount of network traffic.
1524
of file app/framework/include/af.h
emberAfSendCommandUnicastToBindingsWithCallback#
EmberStatus emberAfSendCommandUnicastToBindingsWithCallback (EmberAfMessageSentFunction callback)
emberAfSendCommandUnicastToBindings with attached message sent callback.
N/A | callback |
1529
of file app/framework/include/af.h
emberAfSendCommandMulticast#
EmberStatus emberAfSendCommandMulticast (EmberMulticastId multicastId)
Send the command prepared with emberAfFill.... macro.
N/A | multicastId |
This function is used to send a command that was previously prepared using the emberAfFill... macros from the client command API. It will be sent as multicast.
1538
of file app/framework/include/af.h
emberAfSendCommandMulticastWithAlias#
EmberStatus emberAfSendCommandMulticastWithAlias (EmberMulticastId multicastId, EmberNodeId alias, uint8_t sequence)
Send the command prepared with emberAfFill.... macro.
N/A | multicastId | |
N/A | alias | |
N/A | sequence |
This function is used to send a command that was previously prepared using the emberAfFill... macros from the client command API. It will be sent as multicast.
1547
of file app/framework/include/af.h
emberAfSendCommandMulticastWithCallback#
EmberStatus emberAfSendCommandMulticastWithCallback (EmberMulticastId multicastId, EmberAfMessageSentFunction callback)
emberAfSendCommandMulticast with attached message sent callback.
N/A | multicastId | |
N/A | callback |
1552
of file app/framework/include/af.h
emberAfSendCommandMulticastToBindings#
EmberStatus emberAfSendCommandMulticastToBindings (void )
Send the command prepared with emberAfFill.... macro.
N/A |
This function is used to send a command that was previously prepared using the emberAfFill... macros from the client command API. It will be sent as multicast to the group specified in the binding table that matches the cluster and source endpoint in the APS frame. Note: if the binding table contains many matching entries, calling this API cause a significant amount of network traffic.
1565
of file app/framework/include/af.h
emberAfSendCommandUnicast#
EmberStatus emberAfSendCommandUnicast (EmberOutgoingMessageType type, uint16_t indexOrDestination)
Send the command prepared with emberAfFill.... macro.
N/A | type | |
N/A | indexOrDestination |
This function is used to send a command that was previously prepared using the emberAfFill... macros from the client command API. It will be sent as unicast.
1573
of file app/framework/include/af.h
emberAfSendCommandUnicastWithCallback#
EmberStatus emberAfSendCommandUnicastWithCallback (EmberOutgoingMessageType type, uint16_t indexOrDestination, EmberAfMessageSentFunction callback)
emberAfSendCommandUnicast with attached message sent callback.
N/A | type | |
N/A | indexOrDestination | |
N/A | callback |
1579
of file app/framework/include/af.h
emberAfSendCommandBroadcast#
EmberStatus emberAfSendCommandBroadcast (EmberNodeId destination)
Send the command prepared with emberAfFill.... macro.
N/A | destination |
This function is used to send a command that was previously prepared using the emberAfFill... macros from the client command API.
1589
of file app/framework/include/af.h
emberAfSendCommandBroadcastWithCallback#
EmberStatus emberAfSendCommandBroadcastWithCallback (EmberNodeId destination, EmberAfMessageSentFunction callback)
emberAfSendCommandBroadcast with attached message sent callback.
N/A | destination | |
N/A | callback |
1594
of file app/framework/include/af.h
emberAfSendCommandBroadcastWithAliasWithCallback#
EmberStatus emberAfSendCommandBroadcastWithAliasWithCallback (EmberNodeId destination, EmberNodeId alias, uint8_t sequence, EmberAfMessageSentFunction callback)
emberAfSendCommandBroadcast from alias with attached message sent callback.
N/A | destination | |
N/A | alias | |
N/A | sequence | |
N/A | callback |
1600
of file app/framework/include/af.h
emberAfSendCommandBroadcastWithAlias#
EmberStatus emberAfSendCommandBroadcastWithAlias (EmberNodeId destination, EmberNodeId alias, uint8_t sequence)
Send the command prepared with emberAfFill.... macro.
N/A | destination | |
N/A | alias | |
N/A | sequence |
This function is used to send a command that was previously prepared using the emberAfFill... macros from the client command API.
1611
of file app/framework/include/af.h
emberAfSendCommandInterPan#
EmberStatus emberAfSendCommandInterPan (EmberPanId panId, const EmberEUI64 destinationLongId, EmberNodeId destinationShortId, EmberMulticastId multicastId, EmberAfProfileId profileId)
Send the command prepared with emberAfFill.... macro.
N/A | panId | |
N/A | destinationLongId | |
N/A | destinationShortId | |
N/A | multicastId | |
N/A | profileId |
This function is used to send a command that was previously prepared using the emberAfFill... macros from the client command API. It will be sent via inter-PAN. If destinationLongId is not NULL, the message will be sent to that long address using long addressing mode; otherwise, the message will be sent to destinationShortId using short address mode. IF multicastId is not zero, the message will be sent using multicast mode.
1624
of file app/framework/include/af.h
emberAfSendDefaultResponse#
EmberStatus emberAfSendDefaultResponse (const EmberAfClusterCommand * cmd, EmberAfStatus status)
Send a default response to a cluster command.
N/A | cmd | The cluster command to which to respond. |
N/A | status | Status code for the default response command. |
This function is used to prepare and send a default response to a cluster command.
Returns
An ::EmberStatus value that indicates the success or failure of sending the response.
1641
of file app/framework/include/af.h
emberAfSendDefaultResponseWithCallback#
EmberStatus emberAfSendDefaultResponseWithCallback (const EmberAfClusterCommand * cmd, EmberAfStatus status, EmberAfMessageSentFunction callback)
emberAfSendDefaultResponse with attached message sent callback.
N/A | cmd | |
N/A | status | |
N/A | callback |
1647
of file app/framework/include/af.h
emberAfSendImmediateDefaultResponse#
EmberStatus emberAfSendImmediateDefaultResponse (EmberAfStatus status)
Send a default response to a cluster command using the current command.
N/A | status | Status code for the default response command. |
This function is used to prepare and send a default response to a cluster command.
Returns
An ::EmberStatus value that indicates the success or failure of sending the response.
1662
of file app/framework/include/af.h
emberAfSendImmediateDefaultResponseWithCallback#
EmberStatus emberAfSendImmediateDefaultResponseWithCallback (EmberAfStatus status, EmberAfMessageSentFunction callback)
emberAfSendImmediateDefaultResponse with attached message sent callback.
N/A | status | |
N/A | callback |
1667
of file app/framework/include/af.h
emberAfMaximumApsPayloadLength#
uint8_t emberAfMaximumApsPayloadLength (EmberOutgoingMessageType type, uint16_t indexOrDestination, EmberApsFrame * apsFrame)
Return the maximum size of the payload that the Application Support sub-layer will accept for the given message type, destination, and APS frame.
N/A | type | The outgoing message type. |
N/A | indexOrDestination | Depending on the message type, this is either the EmberNodeId of the destination, an index into the address table, an index into the binding table, the multicast identifier, or a broadcast address. |
N/A | apsFrame | The APS frame for the message. |
The size depends on multiple factors, including the security level in use and additional information added to the message to support the various options.
Returns
The maximum APS payload length for the given message.
1686
of file app/framework/include/af.h
emberAfGetCommandApsFrame#
EmberApsFrame* emberAfGetCommandApsFrame (void )
Access to client API APS frame.
N/A |
1693
of file app/framework/include/af.h
emberAfSetCommandEndpoints#
void emberAfSetCommandEndpoints (uint8_t sourceEndpoint, uint8_t destinationEndpoint)
Set the source and destination endpoints in the client API APS frame.
N/A | sourceEndpoint | |
N/A | destinationEndpoint |
1698
of file app/framework/include/af.h
emberAfFindDevicesByProfileAndCluster#
EmberStatus emberAfFindDevicesByProfileAndCluster (EmberNodeId target, EmberAfProfileId profileId, EmberAfClusterId clusterId, bool serverCluster, EmberAfServiceDiscoveryCallback * callback)
Use this function to find devices in the network with endpoints matching a given profile ID and cluster ID in their descriptors. Target may either be a specific device, or the broadcast address EMBER_RX_ON_WHEN_IDLE_BROADCAST_ADDRESS.
N/A | target | The destination node ID for the discovery; either a specific node's ID or EMBER_RX_ON_WHEN_IDLE_BROADCAST_ADDRESS. |
N/A | profileId | The application profile for the cluster being discovered. |
N/A | clusterId | The cluster being discovered. |
N/A | serverCluster | EMBER_AF_SERVER_CLUSTER_DISCOVERY (true) if discovering servers for the target cluster; EMBER_AF_CLIENT_CLUSTER_DISCOVERY (false) if discovering clients for that cluster. |
N/A | callback | Function pointer for the callback function triggered when a match is discovered. (For broadcast discoveries, this is called once per matching node, even if a node has multiple matching endpoints.) |
With this function a service discovery is initiated and received responses are returned by executing the callback function passed in. For unicast discoveries, the callback will be executed only once. Either the target will return a result or a timeout will occur. For broadcast discoveries, the callback may be called multiple times and after a period of time the discovery will be finished with a final call to the callback.
1737
of file app/framework/include/af.h
emberAfFindClustersByDeviceAndEndpoint#
EmberStatus emberAfFindClustersByDeviceAndEndpoint (EmberNodeId target, uint8_t targetEndpoint, EmberAfServiceDiscoveryCallback * callback)
Use this function to find all of the given in and out clusters implemented on a devices given endpoint. Target should only be the short address of a specific device.
N/A | target | The destination node ID for the discovery. This should be a specific node's ID and should not be a broadcast address. |
N/A | targetEndpoint | The endpoint to target with the discovery process. |
N/A | callback | Function pointer for the callback function triggered when the discovery is returned. |
With this function a single service discovery is initiated and the response is passed back to the passed callback.
1757
of file app/framework/include/af.h
emberAfFindIeeeAddress#
EmberStatus emberAfFindIeeeAddress (EmberNodeId shortAddress, EmberAfServiceDiscoveryCallback * callback)
Use this function to initiate a discovery for the IEEE address of the specified node id. This will send a unicast sent to the target node ID.
N/A | shortAddress | |
N/A | callback |
1766
of file app/framework/include/af.h
emberAfFindNodeId#
EmberStatus emberAfFindNodeId (EmberEUI64 longAddress, EmberAfServiceDiscoveryCallback * callback)
Use this function to initiate a discovery for the short ID of the specified long address. This will send a broadcast to all rx-on-when-idle devices (non-sleepies).
N/A | longAddress | |
N/A | callback |
1774
of file app/framework/include/af.h
emberAfFindActiveEndpoints#
EmberStatus emberAfFindActiveEndpoints (EmberNodeId target, EmberAfServiceDiscoveryCallback * callback)
Initiate an Active Endpoint request ZDO message to the target node ID.
N/A | target | |
N/A | callback |
1780
of file app/framework/include/af.h
emberAfAddAddressTableEntry#
uint8_t emberAfAddAddressTableEntry (EmberEUI64 longId, EmberNodeId shortId)
Use this function to add an entry for a remote device to the address table.
N/A | longId | The EUI64 of the remote device. |
N/A | shortId | The node id of the remote device or ::EMBER_UNKNOWN_NODE_ID if the node id is currently unknown. |
If the EUI64 already exists in the address table, the index of the existing entry will be returned. Otherwise, a new entry will be created and the new new index will be returned. The framework will remember how many times the returned index has been referenced. When the address table entry is no longer needed, the application should remove its reference by calling emberAfRemoveAddressTableEntry.
Returns
The index of the address table entry for this remove device or ::EMBER_NULL_ADDRESS_TABLE_INDEX if an error occurred (e.g., the address table is full).
1801
of file app/framework/include/af.h
emberAfSetAddressTableEntry#
EmberStatus emberAfSetAddressTableEntry (uint8_t index, EmberEUI64 longId, EmberNodeId shortId)
Use this function to add an entry for a remote device to the address table at a specific location.
N/A | index | The index of the address table entry. |
N/A | longId | The EUI64 of the remote device. |
N/A | shortId | The node id of the remote device or ::EMBER_UNKNOWN_NODE_ID if the node id is currently unknown. |
The framework will remember how many times an address table index has been referenced through emberAfAddAddressTableEntry. If the reference count for the index passed to this function is not zero, the entry will be not changed. When the address table entry is no longer needed, the application should remove its reference by calling emberAfRemoveAddressTableEntry.
Returns
::EMBER_SUCCESS if the address table entry was successfully set, ::EMBER_ADDRESS_TABLE_ENTRY_IS_ACTIVE if any messages are being sent using the existing entry at that index or the entry is still referenced in the framework, or ::EMBER_ADDRESS_TABLE_INDEX_OUT_OF_RANGE if the index is out of range.
1823
of file app/framework/include/af.h
emberAfRemoveAddressTableEntry#
EmberStatus emberAfRemoveAddressTableEntry (uint8_t index)
Use this function to remove a specific entry from the address table.
N/A | index | The index of the address table entry. |
The framework will remember how many times an address table index has been referenced through emberAfAddAddressTableEntry and emberAfSetAddressTableEntry. The address table entry at this index will not actually be removed until its reference count reaches zero.
Returns
::EMBER_SUCCESS if the address table entry was successfully removed or ::EMBER_ADDRESS_TABLE_INDEX_OUT_OF_RANGE if the index is out of range.
1839
of file app/framework/include/af.h
emberAfInitiateKeyEstablishment#
EmberStatus emberAfInitiateKeyEstablishment (EmberNodeId nodeId, uint8_t endpoint)
Use this function to initiate key establishment with a remote node. emberAfKeyEstablishmentCallback will be called as events occur and when key establishment completes.
N/A | nodeId | The node ID of the remote device. |
N/A | endpoint | The endpoint on the remote device. |
Returns
::EMBER_SUCCESS if key establishment was initiated successfully
1870
of file app/framework/include/af.h
emberAfInitiateInterPanKeyEstablishment#
EmberStatus emberAfInitiateInterPanKeyEstablishment (EmberPanId panId, const EmberEUI64 eui64)
Use this function to initiate key establishment with a remote node on a different PAN. emberAfInterPanKeyEstablishmentCallback will be called as events occur and when key establishment completes.
N/A | panId | The PAN id of the remote device. |
N/A | eui64 | The EUI64 of the remote device. |
Returns
::EMBER_SUCCESS if key establishment was initiated successfully
1880
of file app/framework/include/af.h
emberAfPerformingKeyEstablishment#
bool emberAfPerformingKeyEstablishment (void )
Use this function to tell if the device is in the process of performing key establishment.
N/A |
Returns
::true if key establishment is in progress.
1888
of file app/framework/include/af.h
emberAfInitiatePartnerLinkKeyExchange#
EmberStatus emberAfInitiatePartnerLinkKeyExchange (EmberNodeId target, uint8_t endpoint, EmberAfPartnerLinkKeyExchangeCallback * callback)
Use this function to initiate partner link key exchange with a remote node.
N/A | target | The node id of the remote device. |
N/A | endpoint | The key establishment endpoint of the remote device. |
N/A | callback | The callback that should be called when the partner link key exchange completes. |
Returns
::EMBER_SUCCESS if the partner link key exchange was initiated successfully.
1900
of file app/framework/include/af.h
emberAfIsCurrentSecurityProfileSmartEnergy#
bool emberAfIsCurrentSecurityProfileSmartEnergy (void )
Use this function to determine if the security profile of the current network was set to Smart Energy. The security profile is configured in AppBuilder. @ return true if the security profile is Smart Energy or false otherwise.
N/A |
1919
of file app/framework/include/af.h
sl_zigbee_subscribe_to_zcl_commands#
sl_status_t sl_zigbee_subscribe_to_zcl_commands (uint16_t cluster_id, uint16_t manufacturer_id, uint8_t direction, sl_service_function_t service_function)
Runtime subscription to specific incoming ZCL commands.
N/A | cluster_id | The cluster ID of the ZCL messages to subscribe to. |
N/A | manufacturer_id | The manufacturer ID if any. If not set, a value of 0xFFFF should be passed in. |
N/A | direction | A value of ZCL_DIRECTION_CLIENT_TO_SERVER or ZCL_DIRECTION_SERVER_TO_CLIENT specifying the side (client or server) of the ZCL messages to subscribe to. |
N/A | service_function | A sl_service_function_t function pointer specifying the function to be invoked when an incoming ZCL command matches the criteria specified in this API. |
Returns
A ::sl_status_t value of:
::SL_STATUS_OK - If the subscription was successful.
::SL_STATUS_INVALID_PARAMETER - If one or more passed parameters are invalid.
::SL_STATUS_ALLOCATION_FAILED - If the system failed to allocate the necessary data structures.
2013
of file app/framework/include/af.h
emberAfFormNetwork#
EmberStatus emberAfFormNetwork (EmberNetworkParameters * parameters)
Use this function to form a new network using the specified network parameters.
N/A | parameters | Specification of the new network. |
Returns
An ::EmberStatus value that indicates either the successful formation of the new network or the reason that the network formation failed.
2094
of file app/framework/include/af.h
emberAfJoinNetwork#
EmberStatus emberAfJoinNetwork (EmberNetworkParameters * parameters)
Use this function to associate with the network using the specified network parameters.
N/A | parameters | Specification of the network with which the node should associate. |
Returns
An ::EmberStatus value that indicates either that the association process began successfully or the reason for failure.
2104
of file app/framework/include/af.h
emberAfFindUnusedPanIdAndForm#
EmberStatus emberAfFindUnusedPanIdAndForm (void )
Use this function to find an unused PAN id and form a new network.
N/A |
Returns
An ::EmberStatus value that indicates either the process begin successfully or the reason for failure.
2112
of file app/framework/include/af.h
emberAfStartSearchForJoinableNetwork#
EmberStatus emberAfStartSearchForJoinableNetwork (void )
Use this function to find a joinable network and join it.
N/A |
Returns
An ::EmberStatus value that indicates either the process begin successfully or the reason for failure.
2118
of file app/framework/include/af.h
emberAfPushNetworkIndex#
EmberStatus emberAfPushNetworkIndex (uint8_t networkIndex)
Set the current network to that of the given index and adds it to the stack of networks maintained by the framework. Every call to this API must be paired with a subsequent call to emberAfPopNetworkIndex.
N/A | networkIndex |
2129
of file app/framework/include/af.h
emberAfPushCallbackNetworkIndex#
EmberStatus emberAfPushCallbackNetworkIndex (void )
Set the current network to the callback network and adds it to the stack of networks maintained by the framework. Every call to this API must be paired with a subsequent call to emberAfPopNetworkIndex.
N/A |
2135
of file app/framework/include/af.h
emberAfPushEndpointNetworkIndex#
EmberStatus emberAfPushEndpointNetworkIndex (uint8_t endpoint)
Set the current network to that of the given endpoint and adds it to the stack of networks maintained by the framework. Every call to this API must be paired with a subsequent call to emberAfPopNetworkIndex.
N/A | endpoint |
2141
of file app/framework/include/af.h
emberAfPopNetworkIndex#
EmberStatus emberAfPopNetworkIndex (void )
Remove the topmost network from the stack of networks maintained by the framework and sets the current network to the new topmost network. Every call to this API must be paired with a prior call to emberAfPushNetworkIndex, emberAfPushCallbackNetworkIndex, or emberAfPushEndpointNetworkIndex.
N/A |
2149
of file app/framework/include/af.h
emberAfPrimaryEndpointForNetworkIndex#
uint8_t emberAfPrimaryEndpointForNetworkIndex (uint8_t networkIndex)
Return the primary endpoint of the given network index or 0xFF if no endpoints belong to the network.emberAfStatus.
N/A | networkIndex |
2154
of file app/framework/include/af.h
emberAfPrimaryEndpointForCurrentNetworkIndex#
uint8_t emberAfPrimaryEndpointForCurrentNetworkIndex (void )
Returns the primary endpoint of the current network index or 0xFF if no endpoints belong to the current network.
N/A |
2159
of file app/framework/include/af.h
emberAfClusterIsManufacturerSpecific#
#define emberAfClusterIsManufacturerSpecificValue:
(cluster)
Return true if the cluster is in the manufacturer-specific range.
532
of file app/framework/include/af.h
emberAfAttributeIsReadOnly#
#define emberAfAttributeIsReadOnlyValue:
(metadata)
Return true if the attribute is read only.
539
of file app/framework/include/af.h
emberAfAttributeIsClient#
#define emberAfAttributeIsClientValue:
(metadata)
Return true if this is a client attribute and false if if it is a server attribute.
547
of file app/framework/include/af.h
emberAfAttributeIsTokenized#
#define emberAfAttributeIsTokenizedValue:
(metadata)
Return true if the attribute is saved to a token.
554
of file app/framework/include/af.h
emberAfAttributeIsExternal#
#define emberAfAttributeIsExternalValue:
(metadata)
Return true if the attribute is saved in external storage.
561
of file app/framework/include/af.h
emberAfAttributeIsSingleton#
#define emberAfAttributeIsSingletonValue:
(metadata)
Return true if the attribute is a singleton.
568
of file app/framework/include/af.h
emberAfAttributeIsManufacturerSpecific#
#define emberAfAttributeIsManufacturerSpecificValue:
(metadata)
Return true if the attribute is manufacturer specific.
575
of file app/framework/include/af.h
emberAfAttributeSize#
#define emberAfAttributeSizeValue:
(metadata)
Return the size of attribute in bytes.
582
of file app/framework/include/af.h
emberAfProfileIdFromIndex#
#define emberAfProfileIdFromIndexValue:
(index)
Take an index of an endpoint and return the profile ID for it.
645
of file app/framework/include/af.h
emberAfDeviceIdFromIndex#
#define emberAfDeviceIdFromIndexValue:
(index)
Take an index of an endpoint and return the device ID for it.
650
of file app/framework/include/af.h
emberAfDeviceVersionFromIndex#
#define emberAfDeviceVersionFromIndexValue:
(index)
Take an index of an endpoint and return the device version for it.
655
of file app/framework/include/af.h
emberAfNetworkIndexFromEndpointIndex#
#define emberAfNetworkIndexFromEndpointIndexValue:
(index)
Take an index of an endpoint and return the network index for it.
660
of file app/framework/include/af.h
emberAfPrimaryProfileId#
#define emberAfPrimaryProfileIdValue:
()
Return the primary profile ID.
Primary profile is the profile of a primary endpoint as defined in AppBuilder.
676
of file app/framework/include/af.h
emberAfPrimaryEndpoint#
#define emberAfPrimaryEndpointValue:
()
Return the primary endpoint.
681
of file app/framework/include/af.h
emberAfGetInt8u#
#define emberAfGetInt8uValue:
(message, currentIndex, msgLen)
Extract a single byte out of the message.
746
of file app/framework/include/af.h
emberAfCopyInt8u#
#define emberAfCopyInt8uValue:
(data, index, x)
Copy a uint8_t from variable into buffer.
751
of file app/framework/include/af.h
EMBER_AF_NEW_IMAGE_VERIFICATION#
#define EMBER_AF_NEW_IMAGE_VERIFICATIONValue:
true
Indicate a new image verification is taking place.
899
of file app/framework/include/af.h
EMBER_AF_CONTINUE_IMAGE_VERIFY#
#define EMBER_AF_CONTINUE_IMAGE_VERIFYValue:
false
Indicate the continuation of an image verification already in progress.
905
of file app/framework/include/af.h
EMBER_AF_ZCL_SEQUENCE_MASK#
#define EMBER_AF_ZCL_SEQUENCE_MASKValue:
0x7Fu
The mask applied by emberAfNextSequence when generating ZCL sequence numbers.
937
of file app/framework/include/af.h
EMBER_AF_MESSAGE_TAG_MASK#
#define EMBER_AF_MESSAGE_TAG_MASKValue:
0x7Fu
The mask applied to generated message tags used by the framework when sending messages via EZSP. Customers who call ezspSend functions directly must use message tags outside this mask.
943
of file app/framework/include/af.h
EMBER_AF_REJOIN_DUE_TO_END_DEVICE_MOVE#
#define EMBER_AF_REJOIN_DUE_TO_END_DEVICE_MOVEValue:
(cluster)
Return true if the cluster is in the manufacturer-specific range.
1049
of file app/framework/include/af.h
EMBER_AF_REJOIN_DUE_TO_TC_KEEPALIVE_FAILURE#
#define EMBER_AF_REJOIN_DUE_TO_TC_KEEPALIVE_FAILUREValue:
(cluster)
Return true if the cluster is in the manufacturer-specific range.
1050
of file app/framework/include/af.h
EMBER_AF_REJOIN_DUE_TO_CLI_COMMAND#
#define EMBER_AF_REJOIN_DUE_TO_CLI_COMMANDValue:
(cluster)
Return true if the cluster is in the manufacturer-specific range.
1051
of file app/framework/include/af.h
EMBER_AF_REJOIN_DUE_TO_WWAH_CONNECTIVITY_MANAGER#
#define EMBER_AF_REJOIN_DUE_TO_WWAH_CONNECTIVITY_MANAGERValue:
(cluster)
Return true if the cluster is in the manufacturer-specific range.
1052
of file app/framework/include/af.h
EMBER_AF_REJOIN_FIRST_REASON#
#define EMBER_AF_REJOIN_FIRST_REASONValue:
(cluster)
Return true if the cluster is in the manufacturer-specific range.
1054
of file app/framework/include/af.h
EMBER_AF_REJOIN_LAST_REASON#
#define EMBER_AF_REJOIN_LAST_REASONValue:
(cluster)
Return true if the cluster is in the manufacturer-specific range.
1055
of file app/framework/include/af.h
EMBER_AF_CLIENT_CLUSTER_TICK#
#define EMBER_AF_CLIENT_CLUSTER_TICKValue:
true
Friendly define for use in the scheduling or canceling client events with sl_zigbee_zcl_schedule_cluster_tick() and sl_zigbee_zcl_deactivate_cluster_tick().
1117
of file app/framework/include/af.h
EMBER_AF_SERVER_CLUSTER_TICK#
#define EMBER_AF_SERVER_CLUSTER_TICKValue:
false
Friendly define for use in the scheduling or canceling server events with sl_zigbee_zcl_schedule_cluster_tick() and sl_zigbee_zcl_deactivate_cluster_tick().
1124
of file app/framework/include/af.h
emberAfGetCurrentSleepControl#
#define emberAfGetCurrentSleepControlValue:
()
Retrieve the most restrictive sleep control value for all scheduled events. This function is used by emberAfOkToNap and emberAfOkToHibernate to makes sure that there are no events scheduled which will keep the device from hibernating or napping.
Returns
The most restrictive sleep control value for all scheduled events or the value returned by emberAfGetDefaultSleepControl() if no events are currently scheduled. The default sleep control value is initialized to EMBER_AF_OK_TO_HIBERNATE but can be changed at any time using the emberAfSetDefaultSleepControl() function.
1306
of file app/framework/include/af.h
emberAfSetDefaultSleepControl#
#define emberAfSetDefaultSleepControlValue:
(x)
Set the default sleep control value against which all scheduled event sleep control values will be evaluated. This can be used to keep a device awake for an extended period of time by setting the default to EMBER_AF_STAY_AWAKE and then resetting the value to EMBER_AF_OK_TO_HIBERNATE once the wake period is complete.
1318
of file app/framework/include/af.h
emberAfGetDefaultSleepControl#
#define emberAfGetDefaultSleepControlValue:
()
Retrieve the default sleep control against which all event sleep control values are evaluated. The default sleep control value is initialized to EMBER_AF_OK_TO_HIBERNATE but can be changed by the application at any time using the emberAfSetDefaultSleepControl() function.
Returns
The current default sleep control value.
1329
of file app/framework/include/af.h
EMBER_AF_CLIENT_CLUSTER_DISCOVERY#
#define EMBER_AF_CLIENT_CLUSTER_DISCOVERYValue:
false
Friendly define for use in discovering client clusters with emberAfFindDevicesByProfileAndCluster().
1704
of file app/framework/include/af.h
EMBER_AF_SERVER_CLUSTER_DISCOVERY#
#define EMBER_AF_SERVER_CLUSTER_DISCOVERYValue:
true
Friendly define for use in discovering server clusters with emberAfFindDevicesByProfileAndCluster().
1710
of file app/framework/include/af.h
emberAfCurrentEndpoint#
#define emberAfCurrentEndpointValue:
()
Return the current endpoint that is being served.
The purpose of this macro is mostly to access endpoint that is being served in the command callbacks.
1859
of file app/framework/include/af.h
emberAfInvalidImageId#
const EmberAfOtaImageId emberAfInvalidImageId
This variable defines an invalid image ID. It is used to determine if a returned EmberAfOtaImageId is valid or not. This is done by passing the data to the function emberAfIsOtaImageIdValid().
913
of file app/framework/include/af.h