Úkol 1: Instalace ESP-IDF a VSCode
Pro tento workshop budete potřebovat Visual Studio Code a nainstalovaný framework ESP-IDF. Prvním úkolem tedy bude nainstalovat si všechny potřebné nástroje.
K instalaci ESP-IDF použijeme EIM (Espressif Installation Manager).
Instalace pro Windows
- Nainstalujte EIM
- Stiskněte klávesu Windows + R a do objevivšího se okénka napište powershell
- Po zobrazení terminálu zadejte:
winget install Espressif.eim
- Nainstalujte ESP-IDF pomocí EIM
- Spusťte EIM z nabídky start nebo pomocí ikony na ploše
- Na uvítací obrazovce klikněte na tlačítko
Start Installationa potéCustom installationa nechte se průvodcem vést. Na stránce s výběrem verze zvolte verzi IDF 5.5.x - Instalátor vám v průběhu nabídne i nainstalování gitu nebo pythonu, pokud vám v počítači zatím chybí.
- Po dokončení instalace se vraťte na stránku instalátoru s přehledem verzí a použijte tlačítko
Install Driversve spodní části obrazovky, které pro vás nainstaluje potřebné ovladače.
- Nainstalujte Visual Studio Code
- Doporučujeme nainstalovat do VS Code rozšíření ESP-IDF kvůli našeptávání kódu, ale pro build a flashování budeme v tomto workshopu výhradně používat ESP-IDF Terminal.
Instalace pro Linux a Mac
- Nainstalujte EIM
- Pokud zvolíte instalaci pomocí balíčkovacího systému (brew, apt, rpm), vyřeší za vás i všechny prerekvizity.
- Pokud zvolíte CLI verzi, zavolejte
eim install -i v5.5.4 - Pokud zvolíte GUI verzi, klikněte na uvítací obrazovce na tlačítko
Start Installationa potéCustom installationa nechte se průvodcem vést. Na stránce s výběrem verze zvolte verzi IDF 5.5.x
- Nainstalujte Visual Studio Code
Instalace ESP BLE Prov
Během jednoho z úkolů vyzkoušíme také Wi-Fi provisioning. K tomu budeme potřebovat aplikaci, přes kterou našemu čipu ESP přes Bluetooth sdělíme SSID a heslo k síti.
Aplikaci buď vyhledáte v obchodě s aplikacemi příslušného systému, nebo přes odkazy níže:
- Android: ESP BLE Provisioning
- iOS: ESP BLE Provisioning
ESP-IDF Terminal
V tomto workshopu budeme s ESP-IDF pracovat přímo z příkazové řádky (CLI), a ne pomocí tlačítek v GUI. Díky tomu lépe pochopíte, co se děje „pod kapotou“, a v budoucnu si budete moci úlohy zautomatizovat.
Než budete moci používat nástroje ESP-IDF, jako je idf.py, musí být prostředí ESP-IDF v terminálu aktivováno. Vyberte si kteroukoli z následujících metod.
Možnost 1: Dashboard v EIM (všechny systémy)
- Otevřete aplikaci EIM (
eim) z nabídky start / spouštěče aplikací, podle vašeho systému. - Klikněte na
Manage Installationsa poté naOpen Dashboard. - Vyberte verzi ESP-IDF, kterou chcete používat (v5.5.x), a klikněte na
Open IDF Terminal. - Otevře se terminál s aktivovaným prostředím ESP-IDF. Ověřte to příkazem
idf.py --version.
Možnost 2: Zástupce na ploše (Windows)
EIM vytvoří na ploše zástupce pro každou nainstalovanou verzi, např. IDF_v5.5.4_Powershell. Dvojklikem na něj otevřete PowerShell s již aktivovaným ESP-IDF.
Možnost 3: Aktivační skript (Linux a macOS)
Na konci instalace vypíše EIM CLI příkaz podobný tomu níže. Spusťte ho v libovolném terminálu a ESP-IDF se v dané relaci terminálu aktivuje (místo <version> doplňte svou konkrétní verzi):
source "$HOME/.espressif/tools/activate_idf_v<version>.sh"
Přesnou cestu a verzi vypíše EIM na konci instalace. Tento příkaz je nutné spustit v každém novém terminálu.
Možnost 4: Rozšíření ESP-IDF ve VS Code
Pokud jste si nainstalovali rozšíření ESP-IDF, stiskněte Ctrl + Shift + P (nebo Cmd + Shift + P), napište ESP-IDF: Open ESP-IDF Terminal a stiskněte Enter.
V každém případě můžete ověřit, že prostředí funguje, spuštěním idf.py --version v terminálu. Pokud se příkaz nenajde, prostředí v daném terminálu aktivované není.
Nyní byste měli mít funkční prostředí ESP-IDF. Pojďme na náš první projekt!