Options to use when sending a message.

The discover-route, APS-retry, and APS-indirect options may be used together. Poll response cannot be combined with any other options. uint16_t

Enumeration Members

DESTINATION_EUI64

Include the destination EUI64 in the network frame.

DSA_SIGN

This signs the application layer message body (APS Frame not included) and appends the ECDSA signature to the end of the message, which is needed by Smart Energy applications and requires the CBKE and ECC libraries. The ::emberDsaSignHandler() function is called after DSA signing is complete but before the message has been sent by the APS layer. Note that when passing a buffer to the stack for DSA signing, the final byte in the buffer has a special significance as an indicator of how many leading bytes should be ignored for signature purposes. See the API documentation of emberDsaSign() or the dsaSign EZSP command for more details about this requirement.

ENABLE_ADDRESS_DISCOVERY

Send a ZDO request to discover the node ID of the destination if it is not already known.

ENABLE_ROUTE_DISCOVERY

Send the message with the NWK 'enable route discovery' flag, which causes a route discovery to be initiated if no route to the destination is known. Note that in the mesh stack, this option and the APS retry option must be enabled an existing route to be repaired automatically.

ENCRYPT_WITH_TRANSIENT_KEY
ENCRYPTION

Send the message using APS Encryption using the Link Key shared with the destination node to encrypt the data at the APS Level.

FORCE_ROUTE_DISCOVERY

Send the message with the NWK 'force route discovery' flag, which causes a route discovery to be initiated even if one is known.

FRAGMENT

This message is part of a fragmented message. This option may only be set for unicasts. The groupId field gives the index of this fragment in the low-order byte. If the low-order byte is zero this is the first fragment and the high-order byte contains the number of fragments in the message.

NONE

No options.

POLL_RESPONSE

This message is being sent in response to a call to ::emberPollHandler(). It causes the message to be sent immediately instead of being queued up until the next poll from the (end device) destination.

RETRY

Resend the message using the APS retry mechanism. This option and the enable route discovery option must be enabled for an existing route to be repaired automatically.

SOURCE_EUI64

Include the source EUI64 in the network frame.

USE_ALIAS_SEQUENCE_NUMBER
ZDO_RESPONSE_REQUIRED

This incoming message is a valid ZDO request and the application is responsible for sending a ZDO response. This flag is used only within emberIncomingMessageHandler() when EMBER_APPLICATION_RECEIVES_UNSUPPORTED_ZDO_REQUESTS is defined.