FOTA 2.6 User Guide

1 Preface

This guide is primarily intended to give a comprehensive understanding of the FOTA Platform.

2 Overview

FOTA platform is mainly used to manage the firmware upgrade of devices by users. The firmware management of users of FOTA platform supports two upgrade methods, including active upgrade and passive upgrade. Active Upgrade Through the command protocol supported on the device side, the platform issues upgrade orders in batches and checks the upgrade results. Typically, the device is required to connect to the ThingsMatrix IoT platform and services. Passive upgrade allows the device to inquire the content of upgrade regularly through the pre-agreed URL, and the platform side decides whether to inform the device of the existence of update in the returned result.

3 Firmware

The firmware used for device upgrades is managed and can be added, modified, downloaded and deleted.


When adding firmware, you need to fill in the name of the firmware, select the type of firmware package, the Model and PID supported, and the target version of the upgrade, and upload the firmware file. After filling in the firmware file, click "submit" to upload.


4 Proactive Upgrade

4.1 Create a new active upgrade task

  1. Fill in the task name, select the firmware to be used and the device to be upgraded.


  2. Fill in the upgrade strategy, including upgrade time, device, device signal strength, and device battery status. The device will only be upgraded if it meets the policy set.


  3. Fill in the retry policy including timeout, retry number and retry interval. The device retries based on the conditions set.


4.2 Proactive upgrade list and details

Shows the number of devices in each state of the upgrade task, along with specific details. Click the function button in the upper right corner to retry and cancel the upgrade task.


5 Passive Upgrade

The list type displays all the current passive escalation tasks. When a task is selected, in addition to the basic information, it also displays the channel access record and operation record for that task.


5.1 Tasks

The device accesses the burning channel and compares the set rules. If the device meets the rules, it will get the address to download the firmware and upgrade it.

5.1.1 Add Task

Click the top right corner of the list to add passive upgrade task, fill in the name, select upgrade conditions.


Upgrade conditions include: (1)Firmware that does not require or require an upgrade. If you select No Upgrade, the devices in the list will no longer upgrade when they access the channel.

(2)If a device is checked, then only the selected device can access the upgrade channel for the task, and if no device is selected, then there is no device limit.

(3)When the device accesses the channel of the task binding, it will compare the conditions set in order to see whether it meets the device list list, and obtain the corresponding firmware information.

5.2 Update Channel

The upgrade channel is used to give the device access to the upgrade address, after the device access, by checking whether they meet the upgrade conditions, and then compare the firmware version information to decide whether they want to upgrade. After the user is added, the channel can be managed online or offline. image-20210322191139189

There are two types of upgrade channels, public and encrypted. Encrypted devices need to pass password authentication when connecting to the channel. Open only need to fill in the name, the system will automatically generate an address, click the copy of the small icon to copy; Encryption also need to enter the password, automatically generate the address, support rapid replication use.


5.3 Configure channels for passive upgrade tasks

Click the channel in the operation column in the task list to configure the upgrade channel corresponding to the task. It can quickly search or select the corresponding channel and make a selection. After saving, the device accesses the upgrade channel to obtain the firmware upgrade address.


Last updated: 3/26/2021, 9:27:55 AM