Campaign Lifecycle Flow for LWM2M Devices using the v3 Resource Path

1. Creating a campaign starts with the user scheduling which devices with proper make, model and current software prerequisites need to be updated with which software including a start and end date.

2. Once the user schedules a campaign request, the campaign changes to “Request Pending” status

   • After passing parameter checks, campaign status typically moves to "Queued" status.

   • If parameter checks fail, it moves to "RequestFailed" and may bypass "Pending."
     Checks could include eligibility such as licenses, FOTA capable, prerequisites or timing checks.

3. The system performs network checks on the devices. Once the network checks are complete, it moves to pre-scheduled.

4. ThingSpace creates sub-campaigns if necessary. Once the sub-campaigns are created, it moves to “scheduled.” The campaign stays in "Scheduled" status during the device update. 

5. Once the campaign end date has been reached or if all eligible devices have been upgraded, the campaign status moves to “ended.”

After you send a request to schedule an upgrade, the upgrade advances through several states:

• CampaignRequestPending: The upgrade request has been accepted but is not scheduled yet.
  • If any parameter checks fail, the state changes to CampaignRequestFailed.
• CampaignQueued: The upgrade request has passed a campaign eligibility check and campaign parameters validation. The upgrade is in the queue waiting to be scheduled.
  • You can cancel the campaign if it is in Queued status and if it is before the Start Date, which becomes CampaignCancelled state.
  • You can delete the campaign after the start date, which becomes CampaignAborted state.
• CampaignFailed: The campaign scheduling API call has failed.
• CampaignPreScheduled: Assuming devices are reachable but the campaign has not been scheduled yet, the campaign is in “PreScheduled” status.
• CampaignScheduled: The upgrade is scheduled. This appears before the campaign start date.
  • After the start date has passed and the upgrade is in progress you can abort the campaign. Some devices may have already started or completed the upgrade. Upgrades on remaining devices might not complete the upgrade.
• CampaignEnded: The campaign end date has passed. No more devices are allowed to upgrade if they have checked in before the campaign end date.

Device Lifecycle Flow for LWM2M Devices using the /v3 Resource Path