Přeskočit na hlavní obsah

Návod k rozšíření TOWER Extension

info

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.

Toto rozšíření umožňuje jednoduše vyvíjet, nahrávat a debugovat firmware pro HARDWARIO TOWER.

Rozšíření má dva režimy provozu:

info

V obou režimech byste měli vidět logo HARDWARIO v postranním panelu.

Basic Mode​

Pokud jste neotevřeli složku s firmwarem pro HARDWARIO TOWER, rozšíření se aktivuje, ale nabídne méně možností.

Získáte přístup k několika základním příkazům, které vás dovedou na naše webové stránky, a dále ke dvěma příkazům pro klonování firmwaru z našeho GitHubu.

Tyto příkazy můžete použít, když začínáte s vývojem firmwaru.

From Skeleton Project…​

Budete vyzváni k výběru složky, do které se má naklonovat firmware twr-skeleton (vytvoří se nová složka pro firmware).

Po výběru složky byste měli svou složku s firmwarem pojmenovat, abyste nenarazili na kolize s jinými složkami firmwaru.

From Existing Project…​

Zobrazí se vám seznam existujícího firmwaru pro HARDWARIO TOWER dostupného na našem GitHubu. Kterýkoli z nich můžete vybrat podle názvu a popisu firmwaru.

Budete vyzváni k výběru složky, do které se má vybraný firmware naklonovat (vytvoří se nová složka pro firmware). Po výběru složky můžete svou složku s firmwarem pojmenovat, abyste nenarazili na kolize s jinými složkami firmwaru.

note

Po naklonování firmwaru se okno znovu otevře již se složkou firmwaru.

Firmware Mode​

tip

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 jsou důležité ovládací prvky, které můžete rychle použít bez nutnosti sahat po ovládacích prvcích 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 výzva 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í.

info

Jsou zde i další ikony, které můžete použít; budou popsány dále společně s příkazy, které vyvolávají.

Build + Flash (Console)​

Tento příkaz provede celý cyklus, který můžete při vývoji používat. Sestaví firmware, nahraje jej do vybraného zařízení a poté připojí konzoli k zařízení, abyste viděli logovací zprávy.

note

Tohle budete při vývoji používat většinu času.

info

Pro konzoli TOWER Console existuje samostatná kapitola.

Build + Flash (Debugger)​

caution

Aby to fungovalo správně, budete potřebovat sondu JLink. Tohle je určeno pro pokročilé debugování. Musíte mít arm-none-eabi-gdb a JLinkGDBServerCL v PATH. Pokud používáte naši přenosnou verzi, nemusíte se tím zabývat a potřebujete jen sondu JLink.

Tento příkaz nepřipojí konzoli jako ten předchozí, ale místo toho se pokusí připojit k debuggeru JLink pro pokročilé debugování. Více o debugování přes JLink si můžete přečíst 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ž jej nahrajete do zařízení.

Flash Firmware​

Tento příkaz nahraje firmware do vybraného zařízení. Zároveň spustí příkaz pro sestavení, pokud jste to předtím neudělali nebo jste zapomněli změny znovu sestavit.

Attach Console​

Tento příkaz připojí konzoli k vybranému zařízení, takže můžete zobrazit logovací zprávy.

info

Pro konzoli TOWER Console existuje samostatná kapitola.

Attach Debugger​

caution

Aby to fungovalo správně, budete potřebovat sondu JLink. Tohle je určeno pro pokročilé debugování. Musíte mít arm-none-eabi-gdb a JLinkGDBServerCL v PATH. Pokud používáte naši přenosnou verzi, nemusíte se tím zabývat a potřebujete jen sondu JLink.

Tento příkaz se pokusí připojit k JLink pro pokročilé debugování.

Více o debugování přes JLink si můžete přečíst 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​

info

Ve složce .vscode by neměl být přítomen 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 přidejte tuto konfiguraci do již 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).