Premium APIsSoftware ManagementGuidesGetting Started

Campaign Lifecycle Flow for v1

Campaign Lifecycle Flow for OMA-DM or LWM2M Devices using the /v1 Resource Path

v1CampaignLifeCycle fix

  1. The campaign always starts with a user scheduling the campaign with proper make, model, and current software prerequisites to be updated and identifying the software to be updated and when.
  2. After the user sends the campaign request, the campaign changes to “Request Pending” status.
    • After passing parameter checks, the campaign status moves to “Queued”.
      Parameter checks could include things like FOTA eligibility, unknown client type, make, model, firmware, and determining if the device is in another campaign.
    • If parameter checks fail, it moves to "RequestFailed."
  3. The campaign stays in “Queued” status while the systems collect requests.
    • Normally the campaign would move to "in progress." This stage is is when the software updates are executed in the OMA-DM or LWM2M server.
    • User can choose to cancel the campaign before the start date, or they can remove all devices from the queued campaign.
  4. After the campaign starts, it is "in progress" during the device update.
    • Once the campaign end date has been reached, the campaign status moves to "Finished."
    • If the OMA-DM or LWM2M server schedule a campaign, it moves to "UpgradeFailed" status.

Device Lifecycle Flow for OMA-DM or LWM2M Devices using the /v1 Resource Path

OMADMDeviceLifecycleFlow fix

Status and Error Messages for OMA-DM ro LWM2M Devices using the /v1 Resource Path

Device StatusDevice Detail Status
Device AcceptedDevice cleared all check so it can be added to the scheduled list.
Device RejectedDevice not found.
Device RejectedInvalid Device IMEI.
Device RejectedDevice not eligible for service.
Device RejectedUnknown client device type.
LicenseRemoveFailedLicense removal not allowed for devices that have ever upgraded firmware.
LicenseRemoveFailedInternal error.
Device RejectedDevice scheduled for firmware-upgrade previously, it needs to be completed before another upgrade is schedule.
Device RejectedDevice make/model do not meet firmware prerequisites.
Device RejectedCurrent device firmware version does not meet firmware prerequisites.
Upgrade FailedDevice is not in an active state or is not connected.
Upgrade FailedCurrent device module does not meet firmware prerequisites.
Upgrade FailedFirmware update to device failed.
Upgrade FailedInternal System Error. Please retry upgrade.
Upgrade SuccessThe firmware upgrade was successful.

On this page