Teil 04: Embassy-Projekt einrichten
Lernziel: Ein lauffähiges Projektgerüst verwenden.
Voraussetzungen: Der Rust-PC-Grundlagenkurs bzw. Grundkenntnisse in Rust; außerdem die vorangegangenen Pico-Lektionen. Zielboard: Pico 2 / Pico 2 W (ARM); Hinweise für RP2040 in der Kursübersicht.
Worum geht es?
Embassy ist ein Embedded-Rust-Framework mit asynchronem Executor, Timern und Treibern. Für funktionierende Einstiegsprojekte ist es besser, die aktuellen offiziellen Beispiele aus dem Embassy-Repository zu übernehmen als lose Quelltextstücke verschiedener Versionen zu mischen. Prüfe dort unter examples/rp die Zielboard-Features, Cargo.toml, build.rs, memory.x und .cargo/config.toml.
Schritt für Schritt
git clone https://github.com/embassy-rs/embassy.git
cd embassy/examples/rp
# Beispiele/Features zuerst in Cargo.toml und README prüfen
cargo --version
# Gewünschtes Binary und Board-Feature anschließend gezielt bauen.
Einordnung: Die Schritte sind absichtlich versionsbewusst: ein universeller cargo-run-Befehl für alle Boards wäre irreführend.
Hintergrund und häufige Fehler
- Board prüfen: Pico/Pico W (RP2040) und Pico 2/Pico 2 W (RP2350) brauchen unterschiedliche Compilerziele und Boardkonfigurationen.
- Hardware zuerst: Vor dem Flashen Pinbelegung, gemeinsame Masse und 3,3-V-Pegel prüfen.
- Versionsstand: Übernehme die passenden Embassy-Beispiele und Abhängigkeiten aus demselben Repository-Stand; APIs ändern sich zwischen Releases.
- Schrittweise testen: Erst ein kleines funktionsfähiges Beispiel, danach jeweils genau eine Änderung vornehmen.
Selbst ausprobieren
Öffne Cargo.toml und finde embassy-rp, embassy-time sowie das Feature für dein Board.
Musterlösung anzeigen
Die exakten Namen und Beispiele ergeben sich aus dem geklonten Stand; notiere den verwendeten Git-Commit.
Dokumentation für deine Versuche
Notiere verwendetes Board, Verdrahtung, Git-Commit oder Bibliotheksversion, Build-Befehl, Ergebnis und aufgetretene Fehlermeldungen. Halte dazu ein Foto oder einen Screenshot fest, der später in den Website-Beitrag übernommen werden kann.
Weiterführende Informationen
- Embassy – offizielles Repository und RP-Beispiele
- Embassy-Dokumentation
- RP-HAL mit RP2040-/RP235x-Hinweisen
