The EmbedThis Updater is a command-line utility and library for downloading and applying device software updates published on the EmbedThis Builder.

Devices can use the updater command or library to enable Over-The-Air software update capabilities. The EmbedThis Builder offers hosting and global distribution for updates, policy-based update distribution, and gradual rollout and control of updates. Additionally, graphical metrics and reporting are available.

This repository provides different versions of a standalone updater program.

• A C code command line utility
• A NodeJS command line utility
• A C updater library for integration in your programs

A shell script sample updater.sh is also provided. This must be customized with necessary arguments.

The Ioto device agent includes the updater functionality internally. The Appweb and GoAhead web servers include this repositiory under their src/updater directories.

All devices using other embedded web servers and device agents can include this Updater to include OTA software update functionality.

updater [options] key=value,...

Where options are:

The key=value pairs can provide device specific properties that can be used by the Builder software update policy to determine which devices receive the update.

updater -v --device "A123456789" \
    --host "https://ygp2t8ckqj.execute-api.ap-southeast-1.amazonaws.com" \
    --product "XABCDACC2T1234567890123455" \
    --token "TT488ETG5H1234567890123456" \
    --version "2.1.2" \
    --cmd ./apply.sh \
    pro=true

Replace the host, product and token with values from your Builder account.

You can use the updater.c source file and invoke the update() API from your programs.

You can use the supplied Makefile to build the updater program and library.