Přeskočit na hlavní obsah

Rychlý start s firmwarem

Vlastní firmware pro TOWER Core Module můžete snadno upravovat nebo vytvářet na každém hlavním operačním systému.

Získání prvního firmwaru TOWER​

tip

Pokud se k projektu vracíte, použijte ve VSCode volbu Open folder. Přejděte na File -> Open Folder... nebo použijte Ctrl + K a pak Ctrl + O.

  • Otevřete VSCode a klikněte na ikonu HARDWARIO v levém panelu
  • V sekci TOWER: Start vyberte From Skeleton Project...
  • Vyberte složku, ve které se má vytvořit nová složka s projektem firmwaru
  • Budete vyzváni k pojmenování složky, výchozí twr-skeleton je zatím dostačující
  • Vyčkejte, než se firmware dokončí stahovat
  • Visual Studio Code se znovu otevře s novým firmwarem
info

Firmware si můžete stáhnout také pomocí příkazu git.

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

Místo From Skeleton Project... můžete vybrat From Existing Project... a naklonovat tak jakýkoliv jiný projekt z GitHubu.

Struktura projektu​

Toto je struktura souborů projektu twr-skeleton, který jste právě naklonovali. Jde o repozitář inicializovaný v Gitu, připravený k použití bez dalších úprav.

Tento projekt lze okamžitě zkompilovat a nahrát do Core Module nebo Radio Dongle

.
├── .git
│   └── ...skipped
├── .github
│   └── CI files, you can put some workflow for GitHub Actions here
├── .vscode
│   └── ...skipped
├── sdk
│   └── a lot of files (mostly not important for normal user)
├── src
│   └── application.c
|   └── application.h
|   └── CMakeLists.txt
├── .editorconfig
├── .gitignore
├── .gitmodules
├── CMakeLists.txt
├── LICENSE
└── README.md

Místo, kde byste měli upravovat svůj kód, je adresář src. Obvykle nebudete potřebovat upravovat jiné soubory než tyto.

Vaším prvním krokem tedy bude nejspíš otevření souboru src/application.c.

note

Pokud používáte rozšíření HARDWARIO Code pro Visual Studio Code, soubor src/application.c se otevře automaticky.

info

Pokud si chcete prohlédnout nějaké příklady firmwaru, můžete navštívit náš repozitář na GitHubu nebo některou z kapitol How to: v sekci Firmware SDK.

Vývojový cyklus​

Vývojový cyklus je běžně opakováním následujících 4 kroků.

  • Upravte src/application.c a uložte změny pomocí Ctrl + S
  • Klikněte na Build + Flash (Console) pro kompilaci, nahrání a otevření sériové konzole pro logování.
  • Otestujte svůj firmware

Programovací jazyk​

Firmware je implementován v čistém jazyce C, což je průmyslově uznávaný jazyk pro embedded zařízení a zařízení s nízkou spotřebou.

Pro volbu této technologie existují následující hlavní důvody.

  • Efektivní využití hardwarových prostředků
  • Stabilní a dlouhodobě dostupné vývojové prostředí
  • Jednoduchá a pochopitelná syntaxe

Můžete používat všechny známé struktury jazyka C a také naše SDK, které je implementováno tak, abyste mohli rychle a snadno, bez jakýchkoliv problémů s kompatibilitou, vytvořit svůj vlastní firmware.

Řešení problémů​

Pokud se vám nedaří detekovat nebo naprogramovat Radio Dongle nebo Core Module, může jít o problém s ovladači nebo operačním systémem. Podle svého systému můžete vyzkoušet některá řešení

  • Na Windows a macOS nainstalujte FTDI VCP ovladače
  • Na Ubuntu musíte být v uživatelské skupině dialout. Použijte příkaz sudo usermod -a -G dialout $USER a restartujte počítač

Další kroky​

Od této chvíle byste měli být schopni vytvářet firmware a aktualizovat existující.

Pokud chcete vědět více o našich modulech a podívat se na příklady, přečtěte si sekci Hardwarové moduly nebo sekci Firmware SDK