Seminar Das U-Boot: Debugging, Logging und Fehleranalyse

Einordnung

Das Seminar vermittelt eine methodische Fehleranalyse vom ersten Reset bis zum Betriebssystemstart. Serielle Diagnose, frühe Debugausgaben, Logging, Driver Model, Device Tree, Speicher, Bootflows, Sandbox und Hardwaremessungen werden zu einem reproduzierbaren Vorgehen verbunden.

Inhaltsübersicht

• Fehlerbild reproduzierbar sichern
• Frühe Startphase sichtbar machen
• Logging gezielt konfigurieren
• Driver Model und Devicetree prüfen
• Speicher- und Imagefehler analysieren
• Bootflow und Kernelübergabe untersuchen
• Sandbox und Debugger einsetzen
• Praxisübungen
• Lernziele

Zielgruppe und Vorkenntnisse

Zielgruppe: BSP-Entwicklung, Embedded-C-Entwicklung, Integrations- und Testteams, Service Engineering sowie technische Maintainer.
Vorkenntnisse: Gute U-Boot-, C- und Linux-Kenntnisse; Erfahrung mit serieller Konsole, Cross-Build und Device Tree.

1. Fehlerbild reproduzierbar sichern

Vor Änderungen wird ein eindeutiger Ausgangszustand mit wiederholbaren Schritten hergestellt.

1. Schritt 1: Hardwarestand, Imageversion, Konfiguration und Bootmedium erfassen.
2. Schritt 2: Erwarteten und tatsächlichen Ablauf zeitlich gegenüberstellen.
3. Schritt 3: Minimalen reproduzierbaren Fehlerfall und Abbruchpunkt definieren.

2. Frühe Startphase sichtbar machen

Fehler vor der regulären Konsole werden mit Debug-UART, Markern und Messpunkten eingegrenzt.

1. Schritt 1: Reset, Takt und Pinmux vor der Ausgabe prüfen.
2. Schritt 2: Frühe Debugausgabe oder GPIO-Marker an kritischen Stellen einsetzen.
3. Schritt 3: Watchdog, Exception und Resetursache getrennt protokollieren.

3. Logging gezielt konfigurieren

Loglevel, Kategorien und Formate werden so gewählt, dass Signal und Rauschen im richtigen Verhältnis stehen.

1. Schritt 1: Globale und modulbezogene Logstufen festlegen.
2. Schritt 2: Zusätzliche Ausgaben nur an begründeten Entscheidungspunkten ergänzen.
3. Schritt 3: Sensible Werte und Schlüsselmaterial aus Logs ausschließen.

4. Driver Model und Devicetree prüfen

Bind-, Probe- und Ressourcenfehler werden aus Gerätehierarchie und Hardwarebeschreibung abgeleitet.

1. Schritt 1: Gerätebaum, Uclass und Probe-Zustand ausgeben.
2. Schritt 2: Compatible, Adressen, Clocks, Resets und Regulatoren gegen die Hardware prüfen.
3. Schritt 3: Fehlercode bis zur auslösenden Ressource oder Operation zurückverfolgen.

5. Speicher- und Imagefehler analysieren

Ladeadressen, Relokation, Reservierungen und Imagegrenzen werden auf Überlappung untersucht.

1. Schritt 1: DRAM-Größe und reservierte Bereiche erfassen.
2. Schritt 2: Kernel, Initramfs, FDT und U-Boot-Lage in einer Speicherkarte darstellen.
3. Schritt 3: Hashes, Header, Kompression und Entpackgrenzen prüfen.

6. Bootflow und Kernelübergabe untersuchen

Fehler nach erfolgreicher Hardwareinitialisierung werden in Laden, Prüfen, Parametrisieren und Starten zerlegt.

1. Schritt 1: Bootflow-Zustand und ausgewählte Images dokumentieren.
2. Schritt 2: Bootargs, Device Tree und Root-Dateisystemparameter überprüfen.
3. Schritt 3: Manuellen Start mit reduziertem Parametersatz gegen die Automatik vergleichen.

7. Sandbox und Debugger einsetzen

Hostbasierte Reproduktion und Quellcodeanalyse verkürzen die Iteration.

1. Schritt 1: Fehlerrelevante Funktion in Sandbox oder Testbuild nachstellen.
2. Schritt 2: Breakpoint, Backtrace und Variablenzustand mit Debugger untersuchen.
3. Schritt 3: Korrektur durch Unit- oder Python-Test gegen Wiederauftreten absichern.

Praxisübungen

• Analyse eines frühen Startfehlers ohne reguläre Konsole.
• Diagnose eines Driver-Model-Probe-Fehlers aus Devicetree und Log.
• Eingrenzung eines Kernelstartfehlers durch Speicherkarte, Bootflow und reduzierte Parameter.

Lernziele

• U-Boot-Fehler reproduzierbar klassifizieren und priorisieren.
• Frühe Startphasen mit geeigneten Ausgaben und Messpunkten sichtbar machen.
• Driver-Model-, Devicetree-, Speicher- und Bootflowfehler systematisch verfolgen.
• Sandbox und Debugger für schnellere Iterationen nutzen.
• Fehlerkorrekturen durch Regressionstests absichern.