Seminar Das U-Boot: Buildsystem, Kconfig, Defconfig und Upstreaming

Einordnung

Der Kurs vermittelt den reproduzierbaren Aufbau von U-Boot, die saubere Pflege von Kconfig und Defconfig sowie einen wartbaren Git- und Reviewprozess. Lokale Sonderlösungen werden in nachvollziehbare Konfiguration, Tests und upstream-fähige Patchserien überführt.

Inhaltsübersicht

• Quellbaum und Artefakte verstehen
• Reproduzierbare Cross-Builds erstellen
• Kconfig-Abhängigkeiten gestalten
• Defconfig wartbar halten
• Buildman und Qualitätsprüfungen einsetzen
• Patchserie vorbereiten
• Langfristige Pflege organisieren
• Praxisübungen
• Lernziele

Zielgruppe und Vorkenntnisse

Zielgruppe: Embedded-C-Entwicklung, BSP-Pflege, Build Engineering, Release Engineering und technische Maintainer.
Vorkenntnisse: Gute Linux-, Git-, Make- und C-Kenntnisse; Erfahrung mit Cross-Compiling ist erforderlich.

1. Quellbaum und Artefakte verstehen

Verzeichnisse, Konfigurationsquellen und erzeugte Images werden entlang des Buildflusses eingeordnet.

1. Schritt 1: Architektur-, Board-, Treiber-, Konfigurations- und Toolpfade zuordnen.
2. Schritt 2: Defconfig, vollständige .config und generierte Header unterscheiden.
3. Schritt 3: Ausgabeverzeichnisse und Artefakte für mehrere Targets trennen.

2. Reproduzierbare Cross-Builds erstellen

Toolchain, Umgebungsvariablen und Buildparameter werden kontrolliert und dokumentiert.

1. Schritt 1: Compilerpräfix, Architektur und externe Firmwareinputs festlegen.
2. Schritt 2: Defconfig anwenden und Build in einem sauberen Ausgabeverzeichnis starten.
3. Schritt 3: Version, Konfiguration und Prüfsummen der Ergebnisse erfassen.

3. Kconfig-Abhängigkeiten gestalten

Optionen werden mit klarer Sichtbarkeit, Defaults und Abhängigkeiten modelliert.

1. Schritt 1: Symboltyp, Prompt, Hilfe und Abhängigkeiten fachlich begründen.
2. Schritt 2: Select, imply und depends on nur mit kontrollierten Nebenwirkungen einsetzen.
3. Schritt 3: Konfigurationsvarianten mit minimalen Testfällen prüfen.

4. Defconfig wartbar halten

Boardkonfigurationen werden auf notwendige Abweichungen reduziert.

1. Schritt 1: Lokale .config bereinigen und savedefconfig verwenden.
2. Schritt 2: Gemeinsame SoC- oder Plattformoptionen aus Boardspezifika herauslösen.
3. Schritt 3: Änderungen an Defaultwerten gegen mehrere Boards testen.

5. Buildman und Qualitätsprüfungen einsetzen

Mehrere Boards, Compilerwarnungen und Größenänderungen werden systematisch geprüft.

1. Schritt 1: Relevante Boardmenge und Toolchains definieren.
2. Schritt 2: Build-, Warnungs- und Größenergebnisse vergleichen.
3. Schritt 3: Regressionen vor der Patchveröffentlichung beheben oder begründen.

6. Patchserie vorbereiten

Änderungen werden in reviewbare, logisch getrennte Commits gegliedert.

1. Schritt 1: Formatierung, Coding Style und Commitstruktur prüfen.
2. Schritt 2: Konfiguration, Code, Tests und Dokumentation sinnvoll auf Commits verteilen.
3. Schritt 3: Cover Letter, Änderungsverlauf und Testnachweise erstellen.

7. Langfristige Pflege organisieren

Upstreaming wird als fortlaufender Wartungsprozess statt als einmaliger Versand verstanden.

1. Schritt 1: Reviewfeedback reproduzieren und ohne Nebenänderungen einarbeiten.
2. Schritt 2: Lokale Produktzweige auf ein kleines, nachvollziehbares Delta reduzieren.
3. Schritt 3: Regelmäßige Rebase-, Build- und Funktionstests planen.

Praxisübungen

• Reproduzierbarer Cross-Build für mehrere Defconfigs.
• Anlage einer Kconfig-Option mit Abhängigkeits- und Regressionstest.
• Erstellung einer logisch gegliederten Patchserie einschließlich Testnachweis.

Lernziele

• U-Boot-Builds reproduzierbar und für mehrere Ziele organisieren.
• Kconfig und Defconfig ohne unnötige Abhängigkeiten pflegen.
• Buildman- und Qualitätsprüfungen integrieren.
• Reviewbare, upstream-fähige Patchserien erstellen.
• Lokale Wartungskosten durch ein kleines, getestetes Delta begrenzen.