# Firmware-Update

Für deinen zigfred erscheinen regelmässig Firmware-Updates. Diese beinhalten neue Funktionen, Verbesserungen und Fehlerbehebungen.

Wir empfehlen dir, stets die neuste Firmware-Version zu installieren.

{% hint style="info" %}
Sobald eine neuere Firmware-Version installiert wurde, ist es nicht mehr möglich auf eine ältere Version zurück zu wechseln.&#x20;
{% endhint %}

## Updaten der Firmware

Die neuste Firmware installierst du über die **zigfred-App**.

Beim Einrichten deines zigfred wirst du vom Assistenten aufgefordert, ein Update durchzuführen.

Ebenfalls benachrichtigt dich die zigfred-App, sobald ein neues Update für deine zigfreds Verfügbar ist. Du kannst dann den Updatevorgang starten.&#x20;

Deine zigfreds werden **nicht automatisch** aktualisiert.&#x20;

Jeder zigfred muss einzeln aktualisiert werden.

{% hint style="info" %}
Ein Firmware-Update deines zigfred per zigbee OTA ist zurzeit leider noch nicht möglich.
{% endhint %}

Du kannst das Update jederzeit in der App manuell auslösen und auch wiederholen, falls etwas schief gelaufen ist. Öffne hierzu die Detailseite deines zigfred und scrolle, bis du die Kachel mit den Firmware-Informationen siehst. Drücke anschliessend auf den Update-Button.

![Manuelles Auslösen des Firmware-Updates](/files/nQPaYTXCby4RIZaxTSQR)

Den Zustand des Firmware-Updates kannst du in der App oder anhand der LED an deinem zigfred sehen:

| Vorgang                  | LED                       | Beschreibung                                                              |
| ------------------------ | ------------------------- | ------------------------------------------------------------------------- |
| Daten werden übertragen  | pulsiert :blue\_circle:   | Bitte warten                                                              |
| Daten werden geschrieben | blinkt :blue\_circle:     | Bitte warten                                                              |
| Update erfolgreich       | blinkt :green\_circle:    | <p>zigfred startet automatisch neu. <br>Vorgang abgeschlossen </p>        |
| Update fehlgeschlagen    | blinkt :red\_circle:      | <p>zigfred startet automatisch neu. <br>Bitte Vorgang erneut starten.</p> |
| Bootloader-Modus         | pulsiert :yellow\_circle: | Kritischer Firmware-Fehler. [Wiederherstellung](#undefined) notwendig.    |

{% hint style="info" %}
Es ist normal, dass deine App während dem Update für kurze Zeit die Verbindung zum zigfred verliert.
{% endhint %}

{% hint style="warning" %}
Trenne während dem Firmware-Update nicht die Stromversorgung deines zigfred und schalte keine Verbraucher. Ansonsten kann es sein, dass du eine [Wiederherstellung](#undefined) durchführen musst.
{% endhint %}

## Firmware-Wiederherstellung

Wenn ein Firmware-Update fehlschlägt oder dein zigfred wegen einem Softwarefehler nicht mehr starten kann, wird er in den **Bootloader-Modus** wechseln.

Du erkennst anhand einer **gelb-grün pulsierenden LED**, ob dein zigfred im Bootloader-Modus ist.

Im Bootloader-Modus kann dein zigfred auf die neuste Firmware-Version aktualisiert werden. Alle anderen Funktionen, die zu Problemen führen könnten, sind dabei nicht aktiviert.

### Manuell in den Bootloader-Modus wechseln

Falls dein zigfred Probleme beim Starten hat und von der App nicht mehr gefunden wird oder ein Firmware-Update wiederholt nicht klappt, kannst du manuell in den Bootloader-Modus wechseln.

#### App

Klappe in der Detailseite deines zigfred das Menü *Fortgeschritten* aus und wähle die Option *Rescue Modus aktivieren.*

#### Manuell

Für diesen Prozess benötigst du eine Hilfsperson.

* Trenne zigfred für mindestens 8 Sekunden per Sicherung vom Stromnetz
* Lasse deine Hilfsperson die **obere linke** (LED oben) Taste gedrückt halten
* Schalte die Sicherung ein.&#x20;
* Dein zigfred sollte nun im Bootloader-Modus sein und gelb-grün pulsieren. Dein Partner kann in der Zwischenzeit die Taste loslassen.

### Firmware Wiederherstellen

Das Wiederherstellen der Firmware läuft nahezu gleich wie ein normales [Firmware-Update](#updaten-der-firmware) ab.

Im Suchbildschirm deiner App solltest du den Eintrag *zigfred BL DFU* sehen.&#x20;

Halte den Eintrag für 2 Sekunden gedrückt und wähle *Info* im Aufklappmenü.

Anschliessend siehst du die Kachel mit den Firmware-Informationen und kannst mit Druck auf den Update-Button die Wiederherstellung starten.

![Manueller Wechsel in den Bootloader und Firmware-Wiederherstellung](/files/zyAsoQc1ZrKmuoY6Fay0)

### Probleme bei der Wiederherstellung

Wenn auch die Wiederherstellung nicht klappen möchte und du wieder in den Bootloader-Modus zurückfällst (LED pulsiert gelb-grün) versuche bitte noch folgendes, bevor du den Support kontaktierst:

* Falls noch nicht kürzlich getan: Schalte die **Stromversorgung** deines zigfred noch einmal aus und wieder ein.
* Verwende ein **anderes Smartphone**. Manche ältere Smartphones haben Probleme mit grösseren Datenmengen über Bluetooth Low Energy
* Halte bereits am Ende des Update-Vorgangs die **obere rechte Taste** gedrückt. So werden direkt nach Abschluss des Updates die Werkseinstellungen geladen, und möglichen Abstürzen durch fehlerhafte Konfiguration vorgebeugt. Siehe dazu auch [Werkseinstellungen](/zigfred/problembehandlung/werkseinstellungen.md).
* Schliesse einen **Neutralleiter** an. Siehe [Installation](/zigfred/einrichtung/installation.md).

## Release Notes

Unter [Release Notes](/zigfred/weitere-informationen/release-notes.md) kannst du nachlesen welche Änderung wir an der Firmware (und App) vorgenommen haben, um deine Wunschfunktionen umzusetzen und zigfred für dich stetig zu verbessern.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zigfred.ch/zigfred/problembehandlung/firmware-update.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
