Zum Inhalt

Bauen, Flashen und Überwachen der seriellen Ausgabe

Diese Seite beschreibt den täglichen Entwicklungsablauf mit dem SiFli-SDK: Umgebung aktivieren, mit scons bauen, das Board flashen und die Logs beobachten.

Das SDK aktivieren

Installieren Sie die SDK-Umgebung anhand der offiziellen Installationsanleitung für Ihre SDK-Version. Aktivieren Sie die Umgebung vor dem Build in jedem neuen Terminal, indem Sie das Export-Skript im SDK-Stammverzeichnis ausführen:

cd ~/OpenSiFli/SiFli-SDK
. ./export.sh

cd C:\OpenSiFli\SiFli-SDK
.\export.ps1

Das Export-Skript lädt die zur aktuellen SDK-Arbeitskopie gehörende Umgebung in das jeweilige Terminal. Installations- und Verwaltungsschritte unterscheiden sich je nach SDK-Version; folgen Sie deshalb der passenden offiziellen Anleitung.

Bauen

Aus dem Verzeichnis eines Beispielprojekts:

scons --board=<board_name> -j8

Wählen Sie einen zu Ihrem Rechner passenden Wert für -j. Wenn die Board-Kennung keinen Core angibt, wählt das SDK standardmäßig HCPU. Für sf32lb52-lcd_n16r8 lautet das Ausgabeverzeichnis beispielsweise build_sf32lb52-lcd_n16r8_hcpu/. Verwenden Sie das Ausgabeverzeichnis für die vom SDK ermittelte Kombination aus Board und Core. Ist der Core bereits in der Board-Kennung angegeben, hängen Sie _hcpu nicht noch einmal an.

Bereinigen und neu bauen

Bereinigen Sie den Build, wenn Sie das Board wechseln, die Konfiguration wesentlich ändern oder ein verdächtiges Build-Artefakt untersuchen. Führen Sie dazu im Verzeichnis des Beispielprojekts die dokumentierte SCons-Bereinigungsoption aus:

scons -c

Der Befehl bereinigt die Build-Ziele sowie die erzeugten temporären Dateien und Objektdateien. Bauen Sie anschließend mit der vorgesehenen Board-Konfiguration erneut.

Flashen

Verwenden Sie beispielsweise für das HCPU-Ziel sf32lb52-lcd_n16r8 das beim Build erzeugte UART-Download-Skript:

./build_sf32lb52-lcd_n16r8_hcpu/uart_download.sh

build_sf32lb52-lcd_n16r8_hcpu\uart_download.bat

OpenSiFli veröffentlicht außerdem sftool, ein quelloffenes Kommandozeilenwerkzeug zur Kommunikation mit SiFli-SoCs über eine serielle Schnittstelle. Zu den dokumentierten Funktionen zählen das Schreiben, Lesen und Löschen von Flash sowie die Steuerung des Chip-Resets. Welche Chips und Speichertypen unterstützt werden und welche Befehlsoptionen verfügbar sind, erfahren Sie in der README des Werkzeugs.

Serielle Ausgabe überwachen

Verwenden Sie ein serielles Terminal mit den Einstellungen des Boards und Beispiels. Die serielle Ausgabe sollte Bootmeldungen, RT-Thread-Startmeldungen, Anwendungsausgaben oder eine Shell-Eingabeaufforderung enthalten.

Halten Sie fest:

  • Boardname.
  • Serieller Port.
  • Baudrate.
  • Build-Befehl.
  • Flash-Befehl.
  • SDK-Branch oder -Release.

Täglicher Entwicklungszyklus

Tabelle: Täglicher Entwicklungszyklus
Schritt Ziel
Aktivieren Die SDK-Umgebung in das aktuelle Terminal laden.
Konfigurieren Board und Funktionsoptionen auswählen.
Bauen Board-spezifische Binärdateien erzeugen.
Flashen Das Image auf die Hardware übertragen.
Überwachen Boot- und Anwendungsverhalten bestätigen.
Dokumentieren Befehle und Protokolldetails für die Reproduzierbarkeit sichern.

Mit einem passenden Beispiel beginnen

Bevor Sie ein Projekt anlegen oder grundlegend ändern, wählen Sie das SDK-Beispiel, das am besten zum Board und zum kritischen Subsystem passt. Bauen, flashen und überwachen Sie zunächst dieses Beispiel im unveränderten Zustand. Halten Sie anschließend für das angepasste Projekt Boardname, SDK-Release, Befehle und erwartete Ausgabe fest.

Wenn Sie CodeKit verwenden, bewahren Sie dieselben Nachweise auf und prüfen Sie, ob sich die Aktionen im Editor auch mit den SDK-Befehlen reproduzieren lassen.

Fehlerbehebung

Tabelle: Fehlerbehebung
Symptom Prüfung
Build-Tool nicht gefunden export.sh / export.ps1 im aktuellen Terminal erneut ausführen.
Boardname unbekannt Die SDK-Dokumentation zu den unterstützten Boards prüfen.
Download-Skript kann den Port nicht öffnen Serielle Terminals schließen und USB-UART-Kabel sowie Anschluss prüfen.
Flashen startet nicht Die dokumentierte Download-Sequenz des Boards befolgen. Bei sf32lb52-lcd_n16r8 nach Auswahl des seriellen Ports das Board neu starten und innerhalb von 2 Sekunden die Eingabetaste drücken, um den Download zu starten. Für andere Boards gilt deren jeweilige Anleitung. Zusätzlich Stromversorgung, ausgewählten Port und UART-Verbindung prüfen.
Serielle Ausgabe ist unlesbar Baudrate prüfen und die Daten-UART verwenden, kein reines Ladekabel.

Checkliste für die Übergabe

Dokumentieren Sie bei der Übergabe eines Projekts an einen anderen Entwickler:

  • SDK-Branch oder -Commit.
  • Boardname.
  • Einrichtungs- und Installationshinweise.
  • Build-Befehl.
  • Flash-Befehl.
  • Einstellungen des seriellen Monitors.
  • Erwartete erste Protokollzeilen.
  • Befehl zur Wiederherstellung.

Zuletzt aktualisiert: