Over-the-Air (OtA) Updates - Wilderness Labs Developer Portal

Overview

Meadow.Cloud provides secure, Over-the-Air (OtA) updates, which enable you to push a new version of a Meadow application to a device in the field over the network.

To get OtA setup you need to first provision your device. Then, you need to package an application that enables the Update Service and upload it to Meadow.Cloud. Finally, you can publish your package to be received by your devices.

Enable Update Service in Meadow.Core

By default, OtA is not enabled. Follow the steps to enable OtA in your application.

In app.config.yaml, add the following:
```
 Update:
   Enabled: true
```
- (Optional) To see more detailed output, enable trace logging by adding the following lines in app.config.yaml:
```
  Logging:
    LogLevel:
        Default: "Trace"
```

Next, add event handlers for downloading and applying the updates.

 using Meadow.Update;
 ...
 public override async Task Run()
 {
     var svc = Resolver.Services.Get<IUpdateService>() as Meadow.Update.UpdateService;
     // Uncomment to clear any persisted update info. This allows installing the same update multiple times, such as you might do during development.
     // svc.ClearUpdates();

     svc.OnUpdateAvailable += (updateService, info) =>
     {
         Resolver.Log.Info("Update available!");

         // Queue update for retrieval "later"
         Task.Run(async () =>
         {
             await Task.Delay(5000);
             updateService.RetrieveUpdate(info);
         });
     };

     svc.OnUpdateRetrieved += (updateService, info) =>
     {
         Resolver.Log.Info("Update retrieved!");

         Task.Run(async () =>
         {
             await Task.Delay(5000);
             updateService.ApplyUpdate(info);
         });
     };

     ...

 }

This code adds event handlers to download the new package, updateService.RetrieveUpdate(info). and send the new file(s) to the bootloader, updateService.ApplyUpdate(info).

MPAK Creation

An .mpak file is an application bundle. We’ll use the application we created in the previous section.

Create your MPAK with the Meadow CLI, replacing [target Meadow OS version] with your target Meadow OS version (such as 1.3.0.0) and giving whatever name you want to provide.
```
 meadow package create -p application_path/your_app.csproj -v [target Meadow OS version] -n "name of MPAK"
```
This command creates an .mpak file with the contents of your application and additional metadata.
Upload your newly created .mpak bundle to Meadow.Cloud.
```
 meadow package upload -p [path to .mpak file]
```
Visit https://www.meadowcloud.co/my/packages to verify your package was successfully uploaded.

Publish

To publish via CLI, run meadow package publish -p your_package_id.
To publish via Web, go to https://www.meadowcloud.co/my/packages and click Publish.

With a Meadow app deployed that can be updated via Over-the-Air (OtA) updates, check out the other Meadow.Cloud features.

These docs are open source. If you find an issue, please file a bug, or send us a pull request. And if you want to contribute, we'd love that too!