Návod k rozšíření TOWER
Tento návod předpokládá, že máte nainstalované a funkční Visual Studio Code s naším rozšířením HARDWARIO TOWER nebo HARDWARIO Code.
S tímto rozšířením snadno vyvíjíte, nahráváte a debugujete firmware pro HARDWARIO TOWER.
Rozšíření pracuje ve dvou režimech:
V obou režimech byste měli vidět logo HARDWARIO v postranním panelu.
- Pokud máte otevřený nějaký firmware pro HARDWARIO TOWER (režim Firmware Mode)
- Pokud máte otevřeno cokoli jiného nebo nic (režim Basic Mode)
Basic Mode
Pokud jste neotevřeli složku s firmwarem pro HARDWARIO TOWER, rozšíření se aktivuje, ale nabídne méně možností.
K dispozici budete mít několik základních příkazů, které otevřou naše weby, a dva příkazy pro klonování firmwaru z našeho GitHubu.
Těmito příkazy můžete začít s vývojem firmwaru.
From Skeleton Project…
Vyberte složku, do které se má naklonovat firmware twr-skeleton (vytvoří se v ní nová složka pro firmware).
Pak složku s firmwarem pojmenujte, aby nekolidovala s jinými složkami firmwaru.
From Existing Project…
Zobrazí se seznam hotových firmwarů pro HARDWARIO TOWER z našeho GitHubu. Vybrat si můžete kterýkoli z nich podle názvu a popisu.
Pak vyberte složku, do které se má zvolený firmware naklonovat (vytvoří se v ní nová složka pro firmware). Nakonec můžete složku s firmwarem pojmenovat, aby nekolidovala s jinými složkami firmwaru.
Po naklonování se okno znovu otevře se složkou firmwaru.
Firmware Mode
Pokud používáte standardní firmware, měl by se na začátku otevřít soubor /src/application.c, takže můžete rovnou začít vyvíjet.
V tomto režimu získáte několik dalších ovládacích prvků ve spodním panelu a v postranním panelu.
Ve spodním panelu najdete důležité ovládací prvky, které rychle použijete i bez ovládacích prvků v postranním panelu:
Výběr zařízení Device: COM3 - bc-core-module
Tímto vyberete zařízení, se kterým chcete pracovat. Pokud nemáte připojené žádné zařízení HARDWARIO, zobrazí se hlášení No Device found!. Pokud máte připojeno více zařízení, můžete je procházet klikáním na text.
Výběr typu firmwaru Firmware type: Debug
Můžete zvolit, zda chcete sestavovat v režimu Debug nebo Release. Pro běžný vývoj doporučujeme výchozí nastavení debug, protože zapíná logování.
Další ikony popisujeme níže spolu s příkazy, které spouštějí.
Build + Flash (Console)
Tento příkaz provede celý cyklus, který při vývoji používáte: sestaví firmware, nahraje ho do vybraného zařízení a pak k němu připojí konzoli, abyste viděli logovací zprávy.
Při vývoji ho budete používat nejčastěji.
Konzoli TOWER se věnuje samostatná kapitola.
Build + Flash (Debugger)
K tomu potřebujete sondu JLink. Jde o pokročilé debugování. Nástroje arm-none-eabi-gdb a JLinkGDBServerCL musí být v proměnné PATH. Pokud používáte naši přenosnou verzi, nemusíte to řešit a stačí vám sonda JLink.
Na rozdíl od předchozího příkazu nepřipojí konzoli, ale pokusí se připojit debugger JLink pro pokročilé debugování. Více o debugování se sondou JLink najdete v kapitole Pokročilé debugování.
Clean All Outputs
Tento příkaz vyčistí všechny výstupy, takže můžete vše zkompilovat od začátku.
Build Firmware
Tento příkaz spustí nad kódem CMake a ninja. Můžete tak zkontrolovat, zda v kódu nemáte nějaké chyby nebo varování, ještě než ho nahrajete do zařízení.
Flash Firmware
Tento příkaz nahraje firmware do vybraného zařízení. Předtím ještě spustí příkaz pro sestavení pro případ, že jste firmware nesestavili nebo jste zapomněli sestavit poslední změny.
Attach Console
Tento příkaz připojí konzoli k vybranému zařízení, abyste viděli logovací zprávy.
Konzoli TOWER se věnuje samostatná kapitola.
Attach Debugger
K tomu potřebujete sondu JLink. Jde o pokročilé debugování. Nástroje arm-none-eabi-gdb a JLinkGDBServerCL musí být v proměnné PATH. Pokud používáte naši přenosnou verzi, nemusíte to řešit a stačí vám sonda JLink.
Tento příkaz se pokusí připojit k sondě JLink kvůli pokročilému debugování.
Více o debugování se sondou JLink najdete v kapitole Pokročilé debugování.
Debugování lze spustit několika způsoby:
Stiskněte klávesu F5, když je aktivní nějaký soubor *.c nebo *.h
Ve složce .vscode by neměl být soubor launch.json.
Pokud chcete jen spustit debugování a nic v launch.json neměnit, stačí stisknout F5 a vybrat TOWER Debugger. Debugování by mělo bez problémů začít.
Přejděte do Run and Debug a vytvořte launch.json
Pokud chcete mít vlastní launch.json, přejděte do okna Run and Debug v postranním panelu, klikněte na create a launch.json a vyberte TOWER Debugger. Nebo tuto konfiguraci přidejte do existujícího souboru.
{
"name": "HARDWARIO TOWER Debug",
"request": "launch",
"type": "cortex-debug",
"cwd": "${workspaceFolder}",
"device": "STM32L083CZ",
"servertype": "jlink",
"jlinkscript": "./sdk/tools/jlink/flash.jlink",
"interface": "swd",
"serverpath": "${command:hardwario-tower.locate_jlink}",
"svdFile": "./sdk/sys/svd/stm32l0x3.svd",
"gdbPath": "${command:hardwario-tower.locate_toolchain}",
"runToEntryPoint": "application_init",
"executable": "${workspaceFolder}/out/debug/firmware.elf",
"windows": {
"gdbPath": "${command:hardwario-tower.locate_toolchain}.exe",
"serverpath": "${command:hardwario-tower.locate_jlink}.exe"
}
}
Stiskněte Attach Debugger v paletě příkazů rozšíření HARDWARIO
Tuto možnost použijte, pokud se nechcete zabývat souborem launch.json ani žádnými dalšími dříve zmíněnými možnostmi. Stačí vybrat logo HARDWARIO v postranním panelu a zvolit možnost Attach Debugger nebo Build + Flash (Debugger).