Skip to content

OTA Updates

The WattWächter supports Over-the-Air (OTA) firmware updates. New firmware versions are automatically provided via the cloud update server.

Check for Updates

Check if an update is available:

curl http://ww.local/api/v1/ota/check \
  -H "Authorization: Bearer READ_TOKEN"

Response (update available)

{
  "ok": true,
  "data": {
    "update_available": true,
    "version": "1.2.0",
    "release_date": "2025-03-01",
    "release_note_de": "Optimierte Speicherverwaltung",
    "release_note_en": "Optimized memory management",
    "tag": "stable"
  }
}

Response (no update)

{
  "ok": true,
  "data": {
    "update_available": false
  }
}

Start Update

curl -X POST http://ww.local/api/v1/ota/start \
  -H "Authorization: Bearer WRITE_TOKEN"

During the Update

  • The LED turns solid magenta during the OTA update
  • Do not disconnect power!
  • The device restarts automatically after the update

Update Process

1. /ota/check     →  Checks update server for new version
2. /ota/start     →  Starts firmware download
3. Download       →  Firmware is downloaded (LED: magenta)
4. Flash          →  Firmware is written
5. Verify         →  MD5 checksum is verified
6. Reboot         →  Device restarts with new firmware
7. /system/alive  →  Device reports new version

Release Channels

Channel Description
stable Stable releases, recommended for production
test Test releases for early adopters

Troubleshooting

Problem Solution
Update check fails Check internet connection, verify DNS
Download aborts Check WiFi signal strength, try again
Device won't start after update Wait 30 seconds, then disconnect and reconnect USB-C
Version unchanged Check /api/v1/system/alive — possible fallback to previous version

Automatic Updates

Via the cloud portal, you can configure whether updates are installed automatically or require confirmation.