Seminar Das U-Boot: Board-Portierung für neue Hardware

Einordnung

Das Seminar führt eine Board-Portierung von der Ausgangsanalyse bis zu einem testbaren, wartbaren U-Boot-Port durch. Behandelt werden Konfiguration, frühe Initialisierung, Devicetree, Speicher, Konsole, Bootmedien, Netzwerk, SPL, Imagebau, Test und Upstream-Fähigkeit.

Inhaltsübersicht

• Ausgangsplattform analysieren
• Boardkonfiguration anlegen
• Frühe Konsole herstellen
• DRAM und Speicherlayout validieren
• Devicetree und Driver Model integrieren
• Bootmedien und Netzwerk in Betrieb nehmen
• SPL und mehrstufigen Start aufbauen
• Images bauen und Port freigeben
• Praxisübungen
• Lernziele

Zielgruppe und Vorkenntnisse

Zielgruppe: BSP-Entwicklung, Embedded-C-Entwicklung, Hardware-Software-Integration, Plattformteams und technische Projektleitung mit Implementierungsverantwortung.
Vorkenntnisse: Sehr gute C- und Linux-Kenntnisse, Erfahrung mit Cross-Compiling, Git, Device Tree und serieller Hardwarediagnose.

1. Ausgangsplattform analysieren

SoC, Board, Boot-ROM und vorhandene U-Boot-Bausteine werden vollständig aufgenommen.

1. Schritt 1: Boot-ROM-Vorgaben, Ladeadressen und unterstützte Medien dokumentieren.
2. Schritt 2: Ein ähnliches vorhandenes Board und passende SoC-Unterstützung auswählen.
3. Schritt 3: Abweichungen bei Takt, DDR, Pinmux, Stromversorgung und Peripherie priorisieren.

2. Boardkonfiguration anlegen

Defconfig, Kconfig-Abhängigkeiten und Boarddateien werden minimal aufgebaut.

1. Schritt 1: Neue Defconfig aus einer geeigneten Ausgangskonfiguration ableiten.
2. Schritt 2: Board-, Vendor- und SoC-Pfade konsistent benennen.
3. Schritt 3: Nur für den ersten Start erforderliche Optionen aktivieren.

3. Frühe Konsole herstellen

Die ersten sichtbaren Lebenszeichen werden vor komplexeren Treibern abgesichert.

1. Schritt 1: Resetzustand, Taktquellen und notwendige Pinmux-Einstellungen prüfen.
2. Schritt 2: Debug-UART oder reguläre serielle Konsole so früh wie möglich aktivieren.
3. Schritt 3: Fehlerpunkte mit Markern und Messpunkten eingrenzen.

4. DRAM und Speicherlayout validieren

Speicherinitialisierung, Relokation und reservierte Bereiche werden gegen Hardwaredaten geprüft.

1. Schritt 1: DRAM-Parameter und Initialisierungsreihenfolge anpassen.
2. Schritt 2: Erkannten Speicher mit Grenz- und Mustertests prüfen.
3. Schritt 3: U-Boot-, Stack-, Heap-, FDT- und Ladebereiche überschneidungsfrei planen.

5. Devicetree und Driver Model integrieren

Hardwarebeschreibung und Treiberbindung werden schrittweise erweitert.

1. Schritt 1: Minimalen Control-Devicetree für Konsole, Timer und Bootmedium erstellen.
2. Schritt 2: Kompatibilitäten, Clocks, Resets, GPIOs und Regulatoren prüfen.
3. Schritt 3: Bindung, Probe-Reihenfolge und Fehlercodes mit Driver-Model-Werkzeugen kontrollieren.

6. Bootmedien und Netzwerk in Betrieb nehmen

Mindestens ein lokaler und ein servicefähiger Ladepfad werden stabilisiert.

1. Schritt 1: MMC, eMMC, SPI-NOR oder NAND passend zur Zielhardware aktivieren.
2. Schritt 2: Partitionen und Dateisystemzugriff mit Schreibschutzgrenzen testen.
3. Schritt 3: Ethernet, PHY und Netzwerkstart für Diagnose und Entwicklung einrichten.

7. SPL und mehrstufigen Start aufbauen

Für knappe On-Chip-Speicher wird eine minimalistische frühe Stufe erstellt.

1. Schritt 1: SPL-Funktionsumfang auf Takt, DRAM und Laden der nächsten Stufe begrenzen.
2. Schritt 2: Größenbudgets und phasenspezifische Devicetree-Eigenschaften prüfen.
3. Schritt 3: Übergabe an U-Boot proper mit definiertem Fallback testen.

8. Images bauen und Port freigeben

Firmwarebestandteile werden reproduzierbar paketiert, geflasht und gegen Regressionen abgesichert.

1. Schritt 1: Imagebeschreibung, Offsets und Alignment aus Hardwarevorgaben ableiten.
2. Schritt 2: Flashvorgang mit Readback, Hashprüfung und Recoverymöglichkeit absichern.
3. Schritt 3: Boot-, Speicher-, Netzwerk- und Recoverytests sowie Patchserie vorbereiten.

Praxisübungen

• Portierung eines Schulungsboards von der Defconfig bis zum Betriebssystemstart.
• Aufbau eines SPL-basierten Startpfads mit lokalem Medium und Netzwerkfallback.
• Erstellung einer testbaren Patchserie mit Boarddokumentation und Abnahmecheckliste.

Lernziele

• Eine neue Boardunterstützung methodisch und minimal aufbauen.
• Konsole, DRAM, Devicetree, Driver Model und Bootmedien systematisch in Betrieb nehmen.
• SPL und Firmware-Images reproduzierbar integrieren.
• Portierungsfehler mit Logs, Messungen und Tests eingrenzen.
• Einen wartbaren und upstream-fähigen Board-Port vorbereiten.