Firmware

Upload, sign, and manage firmware versions for your products.

Uploading Firmware

Prerequisites

1. At least one product created
2. A signing keypair generated

Upload Steps

1. Go to Firmware in the sidebar
2. Generate or import a signing key (if not already done)
3. Select a product
4. Enter the version number (e.g., "1.2.3")
5. Optionally add release notes
6. Select your firmware binary (.bin file)
7. Click Upload & Sign

The firmware will be:

• Hashed with SHA-256
• Signed with your private key
• Uploaded to secure storage
• Recorded in the database

Version Format

Use semantic versioning (MAJOR.MINOR.PATCH):

• 1.0.0 - Initial release
• 1.0.1 - Bug fix
• 1.1.0 - New feature
• 2.0.0 - Breaking change

Devices compare versions to determine if an update is needed.

Activating Firmware

Only active firmware is delivered to devices.

To activate:

1. Find the firmware version in the list
2. Click Activate

To deactivate:

1. Click Deactivate on the active version

You can have multiple active versions, but devices will receive the most recent one.

Signature Details

Click View Signature Details on any firmware to see:

• Key Fingerprint: Which signing key was used
• Signature: The ECDSA signature (truncated, with copy option)

This helps verify which key signed each firmware and supports key rotation.

Limits

| Resource | Free | Pro | Enterprise | |----------|------|-----|------------| | Firmware per product | 5 | 50 | Unlimited | | Storage | 100 MB | 1 GB | 10 GB |

Deleting Firmware

Click Delete to remove a firmware version.

Warning: Devices currently updating to this version may fail. Ensure no devices are targeting this version before deleting.

Best Practices

1. Test before uploading - Verify firmware on test devices
2. Use descriptive release notes - Help track what changed
3. Keep some versions - Don't delete all old versions immediately
4. Version carefully - Can't upload same version twice