Skip to main content

upload-ota-payload

Description

Upload a binary to be used for an OTA update.

See https://mflt.io/34PyNGQ for details about 'hardware-version',
'software-type' and 'software-version' nomenclature.

When deployed, this is the binary that will be returned from the Memfault /latest endpoint
which can be used for an Over The Air (OTA) update.


Example OTA Upload:

$ memfault --org-token $ORG_TOKEN \
--org acme-inc --project smart-sink \
upload-ota-payload \
--hardware-version mp \
--software-type stm32-fw \
--software-version 1.0.0-alpha \
--revision 89335ffade90ff7697e2ce5238bd4c68978b6d6e \
build/stm32-fw.bin


Example Delta OTA Upload:

$ memfault --org-token $ORG_TOKEN \
--org acme-inc --project smart-sink \
upload-ota-payload \
--hardware-version mp \
--software-type stm32-fw \
--delta-from 0.9.0 \
--delta-to 1.0.0-alpha \
--revision 89335ffade90ff7697e2ce5238bd4c68978b6d6e \
build/stm32-fw-delta.bin

Reference: https://mflt.io/create-release

Arguments

ArgumentTypeRequired
pathPathTrue

Options

OptionShortRequiredDefaultDescription
--hardware-versionNoneTrueNone

None

--software-typeNoneTrueNone

None

--software-versionNoneFalseNone

Make the OTA Payload a Full Release payload for this version.

--delta-fromNoneFalseNone

Pass --delta-from FROM_VERSION make the OTA Payload a Delta Release payload from the version FROM_VERSION. Use alongside --delta-to TO_VERSION

--delta-toNoneFalseNone

Pass --delta-to TO_VERSION to make the OTA Payload a Delta Release payload to version TO_VERSION. Use alongside --delta-from FROM_VERSION.

--notesNoneFalse

Optional release notes.

--must-pass-throughNoneFalseFalse

When the Release is deployed to a Cohort, forces a device to update through this version even if a newer version has also been deployed to the Cohort.

--extra-metadataNoneFalseNone

Extra metadata in the form of <key>=<value> to attach to this artifact. This metadata will be returned alongside the artifact when the release is fetched.

--revisionNoneFalseNone

Revision SHA or # (git, SVN, etc.)

--helpNoneFalseFalse

Show this message and exit.