Plugin Commands: OTA Server#
The OTA Server plugin provides Over-the-air commands for upgrading firmware and downloading specific files on the server side.
Macros#
plugin ota-server notify [destination:2] [endpoint:1] [payloadType:1] [jitter:1] [manuf-id:2] [imageTypeId:2] [version:4]
plugin ota-server policy block-request [policyValue:1]
plugin ota-server policy image-req-min-period [period:2]
plugin ota-server policy page-req-miss [modulus:1]
plugin ota-server policy page-req-sup [pageRequestSupported:1]
plugin ota-server policy print
plugin ota-server policy query [policyValue:1]
plugin ota-server policy upgrade [policyValue:1]
plugin ota-server upgrade [nodeId:2] [endpoint:1] [mfrId:2] [imageType:2] [fileVersion:4]
Macro Definition Documentation#
EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_NOTIFY#
#define EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_NOTIFY
plugin ota-server notify [destination:2] [endpoint:1] [payloadType:1] [jitter:1] [manuf-id:2] [imageTypeId:2] [version:4]
Sends an OTA Image Notify message to the specified destination indicating a new version of an image is available for download.
destination - INT16U - The node ID (can be a broadcast address) to which this OTA Notify message should be sent
endpoint - INT8U - Target endpoint for the OTA Notify message (only really meaningful for non-broadcast target destination).
payloadType - INT8U - Used to specify which parameters you want included in the OTA Notify cluster command payload (0 = jitter value only; 1 = jitter and manufacturer id; 2 = jitter, mfr id, and device id; 3 = jitter, mfr id, device id, and firmware version)
jitter - INT8U - Corresponds to QueryJitter parameter in the OTA Upgrade cluster specification. The parameter indicates whether the client receiving Image Notify Command should send in Query Next Image Request command or not.
manuf-id - INT16U - Manufacturer ID for the image being advertised (should match the mfr ID in the OTA file's header)
imageTypeId - INT16U - Image type ID for the image being advertised (should match the image type ID from the OTA file's header)
version - INT32U - Firmware version of the image being advertised (should match the version from the OTA file's header)
4560
of file /Users/vihuszar/Git/EmbeddedSoftware/super/protocol/zigbee/app/framework/test/headers/cli.doc
EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_BLOCK_REQUEST#
#define EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_BLOCK_REQUEST
plugin ota-server policy block-request [policyValue:1]
Sets the policy used by the ota-server Policy Plugin when it receives an image block request.
policyValue - INT8U - 0: Send block (default), 1: Delay download once for 2 minutes, 2: Always abort download after first block
4566
of file /Users/vihuszar/Git/EmbeddedSoftware/super/protocol/zigbee/app/framework/test/headers/cli.doc
EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_IMAGE_REQ_MIN_PERIOD#
#define EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_IMAGE_REQ_MIN_PERIOD
plugin ota-server policy image-req-min-period [period:2]
period - INT16U - The minimum block period in milliseconds.
4580
of file /Users/vihuszar/Git/EmbeddedSoftware/super/protocol/zigbee/app/framework/test/headers/cli.doc
EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_PAGE_REQ_MISS#
#define EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_PAGE_REQ_MISS
plugin ota-server policy page-req-miss [modulus:1]
Sets the modulus number of blocks to not respond to. This is used in testing to simulate a device that fails to receive certain blocks from an Image Page Request message.
modulus - INT8U - The block modulus number to skip sending when responding to an Image Page Request. E.g. if 2, every other block will not be sent. 0 turns the feature off.
4586
of file /Users/vihuszar/Git/EmbeddedSoftware/super/protocol/zigbee/app/framework/test/headers/cli.doc
EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_PAGE_REQ_SUP#
#define EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_PAGE_REQ_SUP
plugin ota-server policy page-req-sup [pageRequestSupported:1]
Sets whether the Page Request feature is supported or not.
pageRequestSupported - INT8U - 1 if Page Request is supported, 0 if unsupported
4592
of file /Users/vihuszar/Git/EmbeddedSoftware/super/protocol/zigbee/app/framework/test/headers/cli.doc
EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_PRINT#
#define EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_PRINT
plugin ota-server policy print
Prints the polices used by the OTA Server Policy Plugin
4597
of file /Users/vihuszar/Git/EmbeddedSoftware/super/protocol/zigbee/app/framework/test/headers/cli.doc
EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_QUERY#
#define EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_QUERY
plugin ota-server policy query [policyValue:1]
Sets the policy used by the OTA Server Policy Plugin when it receives a query request from the client.
policyValue - INT8U - 0: Upgrade if server has newer (default), 1: Downgrade if server has older, 2: Reinstall if server has same, 3: No next version (no next image is available for download)
4603
of file /Users/vihuszar/Git/EmbeddedSoftware/super/protocol/zigbee/app/framework/test/headers/cli.doc
EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_UPGRADE#
#define EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_POLICY_UPGRADE
plugin ota-server policy upgrade [policyValue:1]
Sets the policy used by the OTA Server Policy Plugin when it receives an upgrade end request
policyValue - INT8U - 0: Upgrade Now (default), 1: Upgrade in 2 minutes, 2: Ask me later to upgrade, 3: Abort Upgrade (send default response)
4609
of file /Users/vihuszar/Git/EmbeddedSoftware/super/protocol/zigbee/app/framework/test/headers/cli.doc
EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_UPGRADE#
#define EMBER_AF_DOXYGEN_CLI_COMMAND_PLUGIN_OTA_SERVER_PLUGIN_OTA_SERVER_UPGRADE
plugin ota-server upgrade [nodeId:2] [endpoint:1] [mfrId:2] [imageType:2] [fileVersion:4]
Instruct a device to upgrade now.
nodeId - INT16U - Short destination to send message
endpoint - INT8U - Endpoint destination to send message
mfrId - INT16U - Manufacturer ID for the image (0xFFFF for wildcard)
imageType - INT16U - Image type for the image (0xFFFF for wildcard)
fileVersion - INT32U - File version for the image (0xFFFFFFFF for wildcard)
4619
of file /Users/vihuszar/Git/EmbeddedSoftware/super/protocol/zigbee/app/framework/test/headers/cli.doc