Protokollierung und Absturzanalyse¶
Protokolle sind Bestandteil des Produkts und kein vorübergehendes Hilfsmittel für die Fehlersuche. Gute Protokolle verkürzen die Inbetriebnahme, die Fehlersuche im Feld und die Untersuchung von Fehlern in der Fertigung.
Planen Sie die Protokollierung vor dem ersten Feldtest. Fällt ein Gerät im Feld aus, stehen nur die Daten zur Verfügung, deren Speicherung oder Ausgabe in der Firmware bereits vorgesehen ist.
Mindestumfang der Protokollierung¶
Erfassen Sie für jeden Firmware-Build:
- Firmware-Version.
- SDK-Branch oder Commit.
- Boardname und -Revision.
- Startursache.
- Version des Partitionslayouts.
- Ergebnisse der Initialisierung wichtiger Subsysteme.
- Absturz- oder Assert-Ausgabe, falls der Start fehlschlägt.
Ablauf der Absturzanalyse¶
- Reproduzieren Sie den Fehler auf einem Board, dessen funktionierende Baseline verifiziert wurde.
- Erfassen Sie das vollständige Startprotokoll ab dem Reset.
- Sichern Sie die exakte Binärdatei und die zugehörigen Symboldateien.
- Dekodieren Sie Assert- oder Dump-Ausgaben mit den SiFli-Tools.
- Prüfen Sie Stackgrößen, die Zuständigkeit für Speicherbereiche, DMA-Puffer und Cache-Wartungsoperationen.
- Grenzen Sie das Problem mit dem am ehesten passenden SDK-Beispiel ein.
Protokollierungsstufen¶
Tabelle: Protokollierungsstufen
| Phase | Empfohlene Protokollierung |
|---|---|
| Board-Inbetriebnahme | Ausführliche Protokolle zu Peripherie und Startvorgang. |
| Funktionsentwicklung | Modulbezogene Debug-Protokolle rund um die geprüfte Funktion. |
| Optimierung des Stromverbrauchs | Möglichst wenige Protokolle, da die Protokollierung selbst das Energieverhalten verändert. |
| Freigabekandidat | Warnungen, Fehler, Version, Startursache und wichtige Zustandsprüfungen. |
| Build zur Analyse eines Feldfehlers | Gezielte Protokolle zum vermuteten Subsystem. |
Merkmale eines guten Absturzberichts¶
- Er enthält das vollständige Protokoll vom Reset bis zum Absturz.
- Er benennt die exakte Binärdatei.
- Er enthält Symboldateien oder einen reproduzierbaren Build.
- Er gibt an, ob der Absturz auch bei einem unveränderten SDK-Beispiel auftritt.
- Er listet angeschlossene Peripherie und Stromquelle auf.
- Er gibt an, ob der Absturz auch nach vollständigem Löschen und erneuter Programmierung des Flashs auftritt.
Zuletzt aktualisiert: