Rust¶
OpenSiFli/sifli-rs entwickelt Rust-HAL- und PAC-Unterstützung sowie Funktionen für Flash-Tabellen für SiFli-MCUs. Die Maintainer kennzeichnen das Projekt als in Arbeit und noch nicht für den Produktionseinsatz geeignet. Dieser Leitfaden schafft daher eine Ausgangsbasis für die Evaluierung, keinen Workflow für Produktions-Firmware.
Arbeiten Sie zunächst auf demselben Board den Leitfaden Erste Schritte mit SiFli-SDK durch. So steht Ihnen ein erprobter serieller Zugang und Wiederherstellungspfad zur Verfügung, falls sich das Rust-Projekt nicht flashen oder debuggen lässt.
Was Sie benötigen¶
- Ein SF32LB52 DevKit LCD und ein USB-Typ-C-Datenkabel, das mit dem USB-zu-UART-Port des Boards verbunden ist.
- Grundlegende Vertrautheit mit Rust, eingebetteter Entwicklung und der Kommandozeile.
gitund eine aktuelle Rust-Toolchain, installiert mit rustup.- Der aktuelle sifli-rs Get-Started-Leitfaden und der Flash- und Debug-Leitfaden.
Erkundungspfad
Betrachten Sie diesen Leitfaden nicht als Beleg dafür, dass ein Chip, ein Peripheriegerät, eine Board-Konfiguration oder ein Anwendungsstack produktionsreif ist. Prüfen Sie vor einer Portierung im Repository den Supportstatus des konkreten Ziels und Peripheriegeräts.
Rust-Target vorbereiten¶
Der Leitfaden des Repositorys verwendet Arm-Cortex-M-Rust-Targets. Installieren Sie die dort dokumentierten Targets:
Klonen Sie das aktuelle Repository und arbeiten Sie dann vom Beispielverzeichnis für SF32LB52 aus:
Das Beispielverzeichnis enthält die Cargo-Target-Konfiguration, das Speicherlayout, das Build-Skript und die Beispiel-Binärdateien. Übernehmen Sie diese Dateien nicht ungeprüft in ein Produkt: Sie enthalten Annahmen zu Board und Flash, die für die Zielhardware überprüft werden müssen.
Flash-Runner konfigurieren¶
Das Repository dokumentiert sftool als normalen Flash-Runner. Setzen Sie in examples/sf32lb52x/.cargo/config.toml den Runner auf den USB-zu-UART-Port des Boards, gemäß dem aktuellen Flash- und Debug-Leitfaden. Das dort dokumentierte Muster lautet:
Der erste Flash-Vorgang erfordert möglicherweise eine Flash-Tabelle, einen Bootloader und ein Anwendungs-Image. Die genauen Images und Adressen hängen von der dokumentierten Board-/Flash-Anordnung ab. Folgen Sie dem Leitfaden des Repositorys, anstatt Adressen oder Binärdateien aus Arduino, Zephyr oder SiFli-SDK zu übernehmen.
Referenzbeispiel bauen und ausführen¶
Bauen und flashen Sie mit konfiguriertem Runner das unveränderte Blinky-Beispiel:
Eine erfolgreiche Kompilierung ist nur die erste Prüfung. Stellen Sie sicher, dass sich das Board wie erwartet verhält, und bewahren Sie die vollständige Ausgabe von cargo und sftool auf. Nehmen Sie anschließend eine kleine, reversible Änderung vor — etwa die Blink-Verzögerung —, bevor Sie ein weiteres Peripheriegerät ausprobieren.
Wenn das Referenzbeispiel fehlschlägt¶
Prüfen Sie zunächst, ob die SiFli-SDK-Referenzkonfiguration auf dem Board noch funktioniert. Erfassen Sie dann das Rust-Target, den Commit, das gewählte Beispiel, die Cargo-Konfiguration, den sftool-Befehl samt Ausgabe, die Board-Revision und das serielle oder Debug-Protokoll. Laut Upstream-Leitfaden kann das Debug-Verhalten im Zusammenhang mit Idle/WFI instabil sein. Außerdem muss die Flash-Tabelle groß genug für das Anwendungs-Image sein.
Informationen zu Architektur, Supportumfang und Produkteignung finden Sie auf der Seite Rust im Bereich Develop.
Vor der Wiederverwendung des Beispiels¶
Prüfen Sie vor der Anpassung des Beispiels, ob das Repository die Unterstützung für Ihr konkretes Board und dessen Peripherie dokumentiert. Kontrollieren Sie außerdem das passende Rust-Target, den Bootloader, das Flash-Tabellenlayout und den Debug-Pfad. Bewahren Sie die nachweislich funktionierende SiFli-SDK-Basiskonfiguration als Wiederherstellungsoption auf.
Zuletzt aktualisiert: