MachineQ Developer Documentation logo DOCS

Practical guides for scheduling, delivering, and monitoring firmware updates with the FUOTA API.

1. FUOTA API Overview

Introduction to the MachineQ FUOTA server and the LoRaWAN packages it uses to update devices over the air.

2. Quick Start Guide

Authenticate with the FUOTA API and run your first firmware update campaign end to end.

3. Gateway Selection

How the FUOTA server selects gateways automatically and how to choose them manually for reliable updates.

4. Choosing Multicast Setup Time

How to select the Multicast Setup Time parameter that gives every device enough time to join the multicast session.

5. Multicast Session Overlap Avoidance

How the FUOTA server prevents multiple campaigns from overlapping their multicast sessions on the same gateway.

6. Managed Campaigns

Continuously upgrade any number of devices over days or weeks based on firmware version filters.

7. Firmware Version Parsing

Use hexadecimal patterns to match device firmware versions flexibly in campaigns and managed campaigns.

8. Multicast Key Management

Centrally upload, update, and delete multicast keys for devices that do not support automatic key generation.

9. Reliable Downlinks

Send a downlink to many devices and confirm delivery by matching the expected uplink, with automatic retries.

10. Upgrade Delegation

Allow one subscriber to manage the device upgrades of another subscriber using delegation records.

11. Troubleshooting

How the FUOTA server automatically identifies why a device failed to update.

12. Frequently Asked Questions

Answers to common questions about keys, device classes, and campaign parameters in the FUOTA API.