Miscellaneous#
API for the Miscellaneous functionality in the Application Framework.
Miscellaneous description.
API#
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().
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.
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.
API Documentation#
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
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
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