Searching...

Matching results

    How to manage your device from AirVantage

    This tutorial aims to explain how to manage your device remotely using AirVantage. In Device Management, we include:

    • Upgrade your applications in the device (module or host) like the firmware or the software
    • Monitor your connectivity, your device, your application(s)
    • Be able to act on your device to reboot, reset to factory, change configuration in your device, …

    Follow this tutorial to learn how to do this for a single device or for a set of devices.

    Step 1: How to upgrade your device

    In AirVantage, you can ugrade a Sierra Wireless firmware and install or upgrade a software application. This section explains how to do both on a single device or on a fleet of devices.

    Upgrade your firmware over the air

    All official Sierra Wireless Firmwares are already available in AirVantage, so you just have to select which to install on your device. According to package available, AirVantage will select the one in this order of priority:

    • Select the delta package with reverse package between the current firmware version and the new one
    • Select the delta package between the current firmware version and the new one
    • Select the full package

    To upgrade your device, follow these steps:

    • Go to Monitor > Systems
    • Select your systems:

      • Select your systems by filtering using firmware version, labels, …
      • Click on the Upgrade button
    • Select your firmware:

      • Click on the Search an application button in the Applications line

      • In Public Applications tab, filter with the name of your module (for example HL8528)

      • Select the correct firmware version

    How to find the firmware version

    To get the firmware version (and more), open a serial port terminal (like Tera Term, …). For Open AT modules, send the following AT command:

    ati3

    RHL85xx.5.14.0.5.2.20160603.x6255

    OK

    For Legato modules, send the following legato command:

    cm info

    Device: WP8548

    IMEI: 3599XXXXXXXX

    FSN: LLYYYYYYYYYY

    Firmware: SWI9X15Y_07.VV.VV.VV

    Bootloadder: SWI9X15Y_07.VV.VV.VV

    According to your module or gateway, the command to get the Firmware version may vary. Please read the module manual to get the correct command.

    • Click on Upgrade Firmware button

    OMA-DM Firmware upgrade Consumption

    Warning: the bandwidth may vary according to the network context (quality, signal strenght, network errors, …)

    DM Session:

    1. DM session initiation from client with authenticating info: 398 bytes
    2. Response from server which authenticates client, authenticates itself to the client and requests firmware version and Key Index on client: 363 bytes. Client has 5 minutes to reply.
    3. Client authenticates server and sends firmware version to server: 232 bytes
    4. Server sends the update pkg descriptor URL: 277 bytes
    5. Client acknowledges the URL (Client has 5 minutes to acknowledge): 186 bytes
    6. Server sends the exec command to client to download the update pkg descriptor: 217 bytes
    7. Client acknowledges the exec command: 183 bytes
    8. Server terminates the session: 174 bytes

    HTTP Download:

    1. Client requests the update package download descriptor: Simple HTTP GET request
    2. Server responds with the download descriptor (XML) which contains the update package URL: 397 bytes
    3. Client requests the update package: Simple HTTP GET request
    4. Server responds with the update package: Payload size is the size of the update package

    DM Session to send Firmware update status:

    1. DM session initiation from client with authenticating info and firmware update status: 399 bytes
    2. Response from server which authenticates client, acknowledges the firmware update status and terminates the session: 386 bytes

    You can proceed to install firmware application in the System Details View (from the toolbar) as well.

    Install or upgrade your software over the air

    Release your Software Application in AirVantage

    Before using an application with your system, you have to release and publish it (make it available for upgrade and installation) on AirVantage.

    Follow this tutorial to release your application.

    Installation

    To upgrade the softwre application of your device, follow these steps:

    • Go to Monitor > Systems
    • Select your systems:

      • Select your systems by filtering using software version, labels, …
      • Click on the More menu and Install software
    • Select your software:

      • Click on the Search an application button in the Applications line

      • In My Apps Applications tab, filter with the name of your software (for example Greenhouse)

      • Select the correct software version

    • Click on Install Application button

    You can proceed to install software application in the System Details View (from the top menu or using the System Applications widget) as well.

    Step 2: How to monitor your device

    To monitor your device, you can use:

    • synchronization: you can manually request a synchronization between your device and AirVantage
    • configure a Default Status Report to be sent to AirVantage
    • configure a custom Additinal Dataset to be sent to AirVantage
    • Retrieve a custom set of data manually

    Status report & heartbeat consumption

    Warning: the bandwidth may vary according to the network context (quality, signal strength, network errors, …)

    A simple heartbeat is 1-2KB.

    Status Report:

    • 5 status reports with 10 values (SL6087):
      • 7 808B
      • 8 087B
      • 5 816B
      • 5 945B
      • 6 377B
    • Average: 6 806B
    • EcIo, CCid, IpAd has not be sent.

    It includes:

    • A simple Polling request from device to the server
    • Server send READ request to the device
    • The device sends the 10 values to the devices.

    Data monitoring:

    100 data (about 36 289B):

    • 1641B: Http header
    • 448B: OMA DM header
    • 34.2KB: data

    Synchronize the device information on AirVantage

    The synchronization fills or updates all the information from your system in AirVantage about device and connectivity. All this information can be viewed in the System Info widget you can access from Monitor > Systems > System’s details:

    You can then configure the communication of your system in order to get a dataset regularly from your device using the configure communication button in the top of the screen. Have a look at this How to .

    How to synchronize your system

    • First, go in the system detail view
    • Click on the Synchronize button in the top menu bar
    • Click on Synchronize System

    A new operation is created which will be completed once the device communicates all the information to AirVantage.

    Configure a Default Status Report or an Additional Dataset

    Have a look to this tutorial to enable and configure the default status report.

    Retrieve data from one or several systems

    Have a look to this tutorial to retrieve a set of data using a dataset.

    Step 3: How to act on your device

    This last section describes how to reboot your device, reset to factory (when it is available), change the configuration in your device, send a SMS, wake up your device.

    Both of them can be applied on a single device (from the System Detail View) or a set of devices (from Monitor > Systems view).

    Each of these commands is prepared as an operation. Once the device communicates with AirVantage, they are requested from the device. You can use the Wake Up mechanim, when available, to generate a communication between the device and AirVantage.

    • Reboot & Reset to factory: these commands are available in the toolbar in Monitor > Systems or in the System Detail View.
    • Configure your device to modify its behavior.
    • Send a SMS/Wake Up SMS: a text SMS is sent to the device if a SMS provider has been configured in AirVantage. Wake Up SMS is a binary SMS your device understands and which generates a communication to AirVantage.
    TOP