Splits long messages into smaller blocks for transmission and reassembles received blocks. See Message Fragmentation for documentation.
DeprecatedThe fragment library is deprecated and will be removed in a future release. Similar functionality is available in the Fragmentation plugin in Application Framework.
License#
Copyright 2018 Silicon Laboratories Inc. www.silabs.com
The licensor of this software is Silicon Laboratories Inc. Your use of this software is governed by the terms of Silicon Labs Master Software License Agreement (MSLA) available at www.silabs.com/about-us/legal/master-software-license-agreement. This software is distributed to you in Source Code format and is governed by the sections of the MSLA applicable to Source Code.
/***************************************************************************/
EmberStatus emberFragmentSendUnicast(EmberOutgoingMessageType type,
uint16_t indexOrDestination,
EmberApsFrame *apsFrame,
EmberMessageBuffer payload,
uint8_t maxFragmentSize);
bool emberFragmentMessageSent(EmberApsFrame *apsFrame,
EmberMessageBuffer buffer,
EmberStatus status);
void emberFragmentMessageSentHandler(EmberStatus status);
bool emberFragmentIncomingMessage(EmberApsFrame *apsFrame,
EmberMessageBuffer *payload);
void emberFragmentTick(void);
Transmitting#
Receiving#
Transmitting Documentation#
emberFragmentSendUnicast#
EmberStatus emberFragmentSendUnicast (EmberOutgoingMessageType type, uint16_t indexOrDestination, EmberApsFrame *apsFrame, EmberMessageBuffer payload, uint8_t maxFragmentSize)
| N/A | type | Specifies the outgoing message type. Must be one of EMBER_OUTGOING_DIRECT, EMBER_OUTGOING_VIA_ADDRESS_TABLE, or EMBER_OUTGOING_VIA_BINDING. |
| N/A | indexOrDestination | Depending on the type of addressing used, this is either the EmberNodeId of the destination, an index into the address table, or an index into the binding table. |
| N/A | apsFrame | The APS frame for the message. |
| N/A | payload | The long message to be sent. |
| N/A | maxFragmentSize | The message will be broken into blocks no larger than this. |
Send a long message by splitting it into blocks. Only one long message can be sent at a time. Calling this function a second time aborts the first message.
Returns
An EmberStatus value.
EMBER_INVALID_CALL is returned if the payload length is zero or if the window size (EMBER_FRAGMENT_WINDOW_SIZE) is zero.
78 of file app/util/zigbee-framework/fragment.hemberFragmentMessageSent#
bool emberFragmentMessageSent (EmberApsFrame *apsFrame, EmberMessageBuffer buffer, EmberStatus status)
| N/A | apsFrame | The APS frame passed to emberMessageSentHandler(). |
| N/A | buffer | The buffer passed to emberMessageSentHandler(). |
| N/A | status | The status passed to emberMessageSentHandler(). |
The application must call this function at the start of its emberMessageSentHandler(). If it returns true, the fragmentation code has handled the event and the application must not process it further.
Returns
true if the sent message was a block of a long message. The fragmentation code has handled the event so the application must return immediately from its emberMessageSentHandler(). Returns false otherwise. The fragmentation code has not handled the event so the application must continue to process it.
98 of file app/util/zigbee-framework/fragment.hemberFragmentMessageSentHandler#
void emberFragmentMessageSentHandler (EmberStatus status)
| N/A | status | EMBER_SUCCESS if all the blocks of the long message were delivered to the destination, otherwise EMBER_DELIVERY_FAILED, EMBER_NO_BUFFERS, EMBER_NETWORK_DOWN or EMBER_NETWORK_BUSY. |
The fragmentation code calls this application-defined handler when it finishes sending a long message.
109 of file app/util/zigbee-framework/fragment.hReceiving Documentation#
emberFragmentIncomingMessage#
bool emberFragmentIncomingMessage (EmberApsFrame *apsFrame, EmberMessageBuffer *payload)
| N/A | apsFrame | The APS frame passed to emberIncomingMessageHandler(). |
| N/A | payload | The payload passed to emberIncomingMessageHandler(). |
The application must call this function at the start of its emberIncomingMessageHandler(). If it returns true, the fragmentation code has handled the message and the application must not process it further. When the final block of a long message is received, this function replaces the message with the reassembled long message and returns false so that the application processes it.
Returns
true if the incoming message was a block of an incomplete long message. The fragmentation code has handled the message so the application must return immediately from its emberIncomingMessageHandler(). Returns false if the incoming message was not part of a long message. The fragmentation code has not handled the message so the application must continue to process it. Returns false if the incoming message was a block that completed a long message. The fragmentation code replaces the message with the reassembled long message so the application must continue to process it.
137 of file app/util/zigbee-framework/fragment.hemberFragmentTick#
void emberFragmentTick (void)
| N/A |
Used by the fragmentation code to time incoming blocks. The application must call this function regularly.
143 of file app/util/zigbee-framework/fragment.h