Zum Inhalt

SiFli CodeKit

SiFli CodeKit ist die VS-Code-Erweiterung für die SiFli-SDK-Entwicklung. Sie bietet geführte Aktionen zum Installieren von SDK-Tools, zur Auswahl eines Boards, zum Bauen eines Beispiels, zum Flashen der Firmware und zum Öffnen einer seriellen Konsole.

Nutzen Sie diese Anleitung, wenn Sie lieber in einer IDE arbeiten. Wenn Sie nachvollziehen möchten, welche Befehle die Schaltflächen ausführen, lesen Sie den SiFli-SDK-Leitfaden für die manuelle Einrichtung.

Diese Anleitung behandelt die erste Inbetriebnahme. Sobald hello_world funktioniert, finden Sie in der CodeKit-Toolreferenz Informationen zu seiner Rolle im Entwicklungsalltag, zu den Erwartungen an die Reproduzierbarkeit und zu den Grenzen bei Fehlern.

Was Sie benötigen

Hardware

  • Ein von SiFli-SDK unterstütztes SF32-Entwicklungsboard.
  • Ein USB-Typ-C-Datenkabel, das mit dem USB-zu-UART-Port des Boards verbunden ist.
  • Ein Computer mit Windows, macOS oder Linux.

Software

  • Visual Studio Code
  • Die SiFli CodeKit-Erweiterung.
  • Git, falls CodeKit Sie auffordert, SiFli-SDK zu klonen oder zu importieren.

Offizielle Referenz

CodeKit installieren

  1. Öffnen Sie VS Code.
  2. Öffnen Sie Extensions.
  3. Suchen Sie nach SiFli-SDK-CodeKit.
  4. Installieren Sie die Erweiterung.
  5. Laden Sie VS Code neu, falls dazu aufgefordert.

Um die SDK-Verwaltung zu öffnen, klicken Sie in der VS-Code-Seitenleiste auf das SiFli-Symbol und wählen SDK Manager. Alternativ öffnen Sie View > Command Palette (Standardkürzel: F1) und führen Manage SiFli SDK installation aus. Die genauen Bezeichnungen können je nach Erweiterungsversion variieren; maßgeblich ist die oben verlinkte offizielle Installationsanleitung.

Tip

Wenn Sie die benötigte Aktion nicht finden können, öffnen Sie die Befehlspalette und suchen Sie nach SiFli.

SiFli-SDK installieren oder auswählen

Installieren Sie SiFli-SDK über den Einrichtungsablauf von CodeKit oder geben Sie den Pfad zu einer bereits geklonten SDK-Kopie an. Für die meisten Nutzer ist Release/Tag die passende Wahl: Diese Version ist festgelegt und getestet. Wählen Sie Branch, wenn Sie neuere Fehlerbehebungen oder Funktionen benötigen und eine möglicherweise geringere Stabilität akzeptieren. Die offizielle Anleitung beschreibt release/vX.Y als Branch für aktuelle Fehlerkorrekturen und Funktionen innerhalb der jeweiligen Release-Linie, ohne dass Sie dafür auf den weniger stabilen main-Branch wechseln müssen. Auch der Inhalt dieses Branches kann sich im Laufe der Zeit ändern.

Für Nutzer auf dem chinesischen Festland empfiehlt die offizielle Anleitung Gitee als SDK-Quelle und den SiFli-Spiegelserver für Toolchain-Downloads.

Wenn CodeKit nach einem SDK-Speicherort fragt, wählen Sie einen kurzen Pfad ohne Leerzeichen, zum Beispiel:

~/OpenSiFli/SiFli-SDK

C:\OpenSiFli\SiFli-SDK

CodeKit verwendet den Installer und die Umgebungsskripte des SDK. So wird dieselbe Umgebung wie bei der manuellen Einrichtung vorbereitet: Compiler, Python-Umgebung, Build- und Flash-Werkzeuge.

Ein Beispiel öffnen

Beginnen Sie mit dem hello_world-Beispiel des SDK:

example/get-started/hello_world/rtt/project

Öffnen Sie diesen Projektordner in VS Code. Falls CodeKit einen Importassistenten anbietet, wählen Sie das Projekt hello_world aus und lassen Sie den Assistenten das SDK-Stammverzeichnis erkennen.

Board auswählen

Wählen Sie die Board-Konfiguration, die zu Ihrer Hardware passt. Für ein Board der Klasse SF32LB52-DevKit-LCD lautet der gängige Boardname:

sf32lb52-lcd_n16r8

Wenn Sie ein anderes Board verwenden, wählen Sie den passenden Namen aus der CodeKit-Liste oder der SDK-Dokumentation zu unterstützten Boards. Der Boardname legt Speicherlayout, Pinbelegung, Flash-Einstellungen und Standardperipherie fest.

Bauen

Führen Sie die Build-Aktion von CodeKit aus. Ein erfolgreicher Build erzeugt einen Ausgabeordner für das jeweilige Board, zum Beispiel:

build_sf32lb52-lcd_n16r8_hcpu

Wenn der Build sofort fehlschlägt, prüfen Sie, ob CodeKit den Installationspfad von SiFli-SDK kennt und die Einrichtung der SDK-Umgebung abgeschlossen ist.

Flashen

Verbinden Sie das Board über den USB-zu-UART-Port und führen Sie dann die Aktion Flash oder Download von CodeKit aus.

Bei Aufforderung zur Auswahl eines seriellen Ports:

  • Wählen Sie unter Windows den passenden COM-Port.
  • Wählen Sie unter macOS das /dev/cu.*-Gerät statt /dev/tty.*.
  • Wählen Sie unter Linux das passende Gerät /dev/ttyUSB* oder /dev/ttyACM*.

Falls das Download-Werkzeug das Board nicht in den UART-Download-Modus versetzt, setzen Sie es unmittelbar vor Beginn der Übertragung zurück. Besteht das Problem weiterhin, folgen Sie der boardspezifischen Flash-Anleitung.

Serielle Konsole öffnen

Verwenden Sie den seriellen Monitor von CodeKit, die seriellen Tools von VS Code oder ein anderes Terminalprogramm. Nach dem Reset sollte die Konsole lesbare Boot-Ausgaben und die Ausgabe des hello_world-Beispiels zeigen.

Wenn die Boot-Meldungen lesbar sind, funktionieren Board und serielle Einstellungen. Ist die Ausgabe unleserlich, schließen Sie andere serielle Programme und prüfen Sie die vom Beispiel verwendete Baudrate.

Erfolgskontrolle

Fahren Sie fort, sobald alle folgenden Punkte erfüllt sind:

  • CodeKit erkennt den SDK-Speicherort.
  • Das ausgewählte Board passt zu Ihrer Hardware.
  • Build und Flash werden erfolgreich abgeschlossen.
  • Die serielle Konsole zeigt nach dem Reset die Ausgabe von hello_world.

Fehlerbehebung

Tabelle: Fehlerbehebung
Symptom Prüfung
Kein serieller Port erscheint Versuchen Sie ein Datenkabel, einen anderen USB-Port oder den USB-zu-UART-Anschluss des Boards.
CodeKit findet das SDK nicht Durchlaufen Sie die CodeKit-Einrichtung erneut und wählen Sie den Stammordner von SiFli-SDK aus.
Beim Build fehlen Werkzeuge Lassen Sie CodeKit die Toolchain erneut installieren oder führen Sie den SDK-Installer einmal manuell aus.
Flash startet nicht Wechselt das Werkzeug nicht in den UART-Download-Modus, setzen Sie das Board unmittelbar vor der Übertragung zurück. Bleibt das Problem bestehen, folgen Sie der Flash-Anleitung für das jeweilige Board.
Serielle Ausgabe unleserlich Prüfen Sie die Baudrate und stellen Sie sicher, dass nur ein serieller Monitor geöffnet ist.

Wie es weitergeht

Eine reproduzierbare Konfiguration festhalten

Notieren Sie CodeKit- und SDK-Version, den gewählten Tag oder Branch sowie das genaue Board-Ziel. Falls Menü- oder Befehlsnamen abweichen, verwenden Sie die offizielle Installationsanleitung und die Liste unterstützter Boards für die installierten Versionen als Referenz.

Zuletzt aktualisiert: