Vývoj s nástroji příkazové řádky

info

Pokud chcete vyvíjet pomocí grafického nástroje, přejděte na kapitolu O aplikaci HARDWARIO Code nebo Rozšíření TOWER VSCode.

Tato kapitola se zaměřuje na vývoj firmwaru výhradně pomocí nástrojů příkazové řádky.

caution

V této kapitole si projdeme použití několika nástrojů jako CMake a ninja a také náš nástroj pro nahrávání firmwaru z příkazové řádky. Samostatná kapitola Nástroj pro nahrání firmwaru popisuje, jak jej nainstalovat.

Instalace

Abyste mohli svůj projekt sestavit, budete potřebovat nainstalovat několik nástrojů:

note

Všechny musí být v PATH.

Windows

• bcf
• CMake
• Ninja
• arm-none-eabi-gcc 12.2 nebo novější
• make (LEGACY)

Linux

• bcf
• CMake
• Ninja
• arm-none-eabi-gcc 12.2 nebo novější
• make (LEGACY)

macOS

• bcf
• CMake
• Ninja
• arm-none-eabi-gcc 12.2 nebo novější
• make (LEGACY)

Vývojový cyklus

• Nejprve je potřeba naklonovat některý firmware z našeho GitHubu. Pro start z čistého listu je k dispozici firmware twr-skeleton

  • Pro naklonování firmwaru použijte:

    git clone https://github.com/hardwario/twr-skeleton.git --recursive

    note

    Přepínač --recursive je potřeba k naklonování všech submodulů, především submodulu SDK.

• Otevřete projekt ve svém oblíbeném editoru
• Proveďte v kódu nějaké změny
• Spuštěním CMake vygenerujte soubory pro sestavení:

  cmake -B obj/debug . -G Ninja -DTYPE=debug -DCMAKE_TOOLCHAIN_FILE=sdk/toolchain/toolchain.cmake

• Spuštěním ninja vygenerujte výsledný binární soubor firmwaru:

  ninja -C obj/debug

• Nahrajte firmware do svého zařízení pomocí bcf (budete vyzváni k výběru zařízení, do kterého chcete firmware nahrát)

  bcf flash

• Pokud chcete k zařízení připojit konzoli pro ladění, spusťte bcf s přepínačem --log nebo jen spusťte bcf log:

  bcf flash --log

  NEBO

  bcf log

• Pro vyčištění výstupu, abyste mohli vše zkompilovat od začátku, stačí spustit:

  ninja -t clean

• Tyto kroky opakujte, dokud nezískáte výsledný firmware, který chcete