Jak vytvořit, sestavit, flashovat a simulovat “Hello World” Rust Bare Metal aplikaci pro ESP32-S3

Rust je skvělý programovací jazyk pro vývoj vestavěných zařízení, jako jsou MCU, které mají omezené zdroje. Zvláště Bare Metal (a.k.a. no_std) přináší mnoho výhod a umožňuje vytvořit celé aplikace čistě v Rustu.

Následující kroky popisují, jak vytvořit, sestavit, flashovat a simulovat aplikaci pro ESP32-S3, která je součástí mnoha DevKitů, jako jsou ESP32-S3-BOX-3 nebo M5Stack CoreS3.

Je potřeba nainstalovat několik nástrojů.

Nejprve musíme nainstalovat samotný Rust. Použijeme rustup.

Budeme potřebovat několik dalších nástrojů. Můžeme použít `cargo install` k provedení instalace ze zdrojového kódu. Rychlejší metodou je použití cargo-binstall, který instaluje binární soubory nástrojů a tím šetří čas ve srovnání s instalací ze zdrojového kódu.

Nyní můžeme nainstalovat další nástroje:

  • espup – Nástroj pro instalaci a údržbu Espressif Rust ekosystému.
  • cargo-generate – Nástroj pro vytváření Rust projektů z šablon.
  • espflash – Seriový flashovací nástroj pro Espressif SoC a moduly. Rust náhrada za Python založený esptool.py

Protože cílíme na ESP32-S3, který je založen na Xtensa architektuře, budeme potřebovat Rust Xtensa toolchain, který je potřeba nainstalovat samostatně. Poznámka: Pro čipy uvedené po ESP32-S3, jako je ESP32-C3, které jsou založeny na RISC-V architektuře, tato závislost není potřebná.

Nyní můžeme vygenerovat projekt pomocí Bare Metal šablony z esp-rs/esp-template pomocí cargo-generate. Nástroj se bude ptát na několik otázek. Zde je doporučené nastavení:

Projekt `embedded-rust` by měl být vytvořen a nyní jsme připraveni ho sestavit a flashovat.

Doporučuje se sestavit projekt v Release profilu kvůli výkonu, zejména pokud plánujete použít WiFi, které vyžaduje hodně zdrojů, a debug profil je příliš pomalý.

Připojte ESP32-S3-BOX-3 k počítači pomocí USB kabelu a zadejte následující příkaz, který vyvolá build a espflash příkaz s monitorovací volbou pro flashování a monitorování hardwaru.

Pokud nemáte k dispozici ESP32-S3-BOX-3, můžete použít Wokwi Simulator. Otevřete VS Code:

Nainstalujte Wokwi VS Code Extension (Ctrl+Shift+P), vyberte “Install extension”, vyhledejte Wokwi a klikněte na “install”.

Aktivujte bezplatnou Wokwi licenci (Ctrl+Shift+P), vyberte “Wokwi: Request a new license” a následujte aktivační proces ve webovém prohlížeči.

Pokud byl projekt vytvořen v Release profilu, musíme změnit cestu k binárnímu souboru v souboru `wokwi.toml`:

Spusťte simulaci (Ctrl+Shift+P), vyberte “Wokwi: Start Simulator”.

Simulovaný čip by se měl objevit a měli byste získat následující výsledek:

Gratulujeme! Dokončili jste svůj první Rust Bare Metal projekt pro ESP32-S3-BOX-3.

Tip: Můžete nechat okno Wokwi se simulátorem otevřené během vývoje aplikace. Jakmile aplikaci sestavíte pomocí `cargo run –release`, simulátor provede změnu a zobrazí vám simulaci, i když čekáte na dokončení flashovacího procesu. To může výrazně ušetřit čas, protože umožňuje okamžitě vidět výsledky změny kódu.