Ota Broadcast Bootloader Client Plugin

Functions

EmberAfOtaBootloaderStatus emberAfPluginOtaBootloaderClientAbortImageDownload (uint8_t imageTag, uint8_t applicationErrorStatus)
 Aborts an ongoing image download process. More...
 
bool emberAfPluginOtaBootloaderClientNewIncomingImageCallback (EmberNodeId serverId, EmberNodeId *alternateServerId, uint8_t imageTag)
 A callback invoked by the OTA Client plugin when the client starts receiving a new image. The application can choose to start receiving the image or it can ignore it. If the application chooses to receive the image, other images sent out by other server are ignored until the client completes this download. More...
 
void emberAfPluginOtaBootloaderClientIncomingImageSegmentCallback (EmberNodeId serverId, uint32_t startIndex, uint32_t endIndex, uint8_t imageTag, uint8_t *imageSegment)
 A callback invoked by the OTA Bootloader Client plugin when an image segment, that is part of an image that the application elected to download, was received. More...
 
void emberAfPluginOtaBootloaderClientImageDownloadCompleteCallback (EmberAfOtaBootloaderStatus status, uint8_t imageTag, uint32_t imageSize)
 A callback invoked by the OTA Bootloader Client plugin to indicate that an image downlaod has completed. More...
 
void emberAfPluginOtaBootloaderClientIncomingRequestStatusCallback (EmberNodeId serverId, uint8_t applicationServerStatus, uint8_t *applicationStatus)
 A callback invoked by the OTA Bootloader Client plugin to indicate that an OTA Bootloader Server has requested the status of the client device. More...
 
bool emberAfPluginOtaBootloaderClientIncomingRequestBootloadCallback (EmberNodeId serverId, uint8_t imageTag, uint32_t bootloadDelayMs, uint8_t *applicationStatus)
 A callback invoked by the OTA Bootloader Client plugin to indicate that an OTA Bootloader Server has requested to perform a bootload operation at a certain point in time in the future. More...
 

Detailed Description

See ota-broadcast-bootloader-client.h for source code.

Function Documentation

EmberAfOtaBootloaderStatus emberAfPluginOtaBootloaderClientAbortImageDownload ( uint8_t  imageTag,
uint8_t  applicationErrorStatus 
)

Aborts an ongoing image download process.

Parameters
imageTagA 1-byte tag that identifies the image the client should no longer download.
applicationErrorStatusA 1-byte error code reported to the server.
Returns
An EmberAfOtaBootloaderStatus value of:
void emberAfPluginOtaBootloaderClientImageDownloadCompleteCallback ( EmberAfOtaBootloaderStatus  status,
uint8_t  imageTag,
uint32_t  imageSize 
)

A callback invoked by the OTA Bootloader Client plugin to indicate that an image downlaod has completed.

Parameters
statusAn EmberAfOtaBootloaderStatus value of:
imageTagA 1-byte tag of the image this callback refers to.
imageSizeThe total size of the downloaded image in bytes. This parameter is meaningful only in case the status parameter is set to EMBER_OTA_BROADCAST_BOOTLOADER_STATUS_SUCCESS.
void emberAfPluginOtaBootloaderClientIncomingImageSegmentCallback ( EmberNodeId  serverId,
uint32_t  startIndex,
uint32_t  endIndex,
uint8_t  imageTag,
uint8_t *  imageSegment 
)

A callback invoked by the OTA Bootloader Client plugin when an image segment, that is part of an image that the application elected to download, was received.

Parameters
serverIdThe node ID of the server that initiated the new image distribution process.
startIndexThe index of the first byte of the passed segment.
endIndexThe index of the last byte of the passed segment.
imageTagA 1-byte tag of the image the passed segment belongs to.
imageSegmentAn array containing the image segment.
bool emberAfPluginOtaBootloaderClientIncomingRequestBootloadCallback ( EmberNodeId  serverId,
uint8_t  imageTag,
uint32_t  bootloadDelayMs,
uint8_t *  applicationStatus 
)

A callback invoked by the OTA Bootloader Client plugin to indicate that an OTA Bootloader Server has requested to perform a bootload operation at a certain point in time in the future.

Parameters
serverIdThe ID of the server the request came from.
imageTagA 1-byte tag of the image this callback refers to.
bootloadDelayMsThe delay in milliseconds after which the client has been requested to perform a bootload operation.
applicationStatusA 1-byte status set by the client application that is reported to the server.
Returns
TRUE if the application accepted the request of bootloading the specified image at the requested time, FALSE otherwise.
void emberAfPluginOtaBootloaderClientIncomingRequestStatusCallback ( EmberNodeId  serverId,
uint8_t  applicationServerStatus,
uint8_t *  applicationStatus 
)

A callback invoked by the OTA Bootloader Client plugin to indicate that an OTA Bootloader Server has requested the status of the client device.

Parameters
serverIdThe ID of the server the request came from.
applicationServerStatusThe server application status.
applicationStatusA 1-byte status set by the client application that is reported to the server.
bool emberAfPluginOtaBootloaderClientNewIncomingImageCallback ( EmberNodeId  serverId,
EmberNodeId alternateServerId,
uint8_t  imageTag 
)

A callback invoked by the OTA Client plugin when the client starts receiving a new image. The application can choose to start receiving the image or it can ignore it. If the application chooses to receive the image, other images sent out by other server are ignored until the client completes this download.

Parameters
serverIdThe node ID of the server that initiated the new image distribution process.
alternateServerIdThis node ID can be set by the application to include a well-known alternate server. If this is set to a valid address, the client allows segments also from this alternate server. If this is set to EMBER_BROADCAST_ADDRESS, the client accepts segments with the same image tag from any server.
imageTagA 1-byte tag that identifies the incoming image.