Přeskočit na hlavní obsah

Rychlý start s firmwarem

Vlastní firmware pro modul TOWER Core Module můžete snadno upravovat nebo vytvářet ve všech běžných operačních systémech.

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

tip

Pokud se k projektu vracíte, použijte ve VSCode volbu Open folder. Zvolte File -> Open Folder... nebo stiskněte 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
  • Zadejte název složky; výchozí twr-skeleton zatím stačí
  • Počkejte, až se firmware stáhne
  • Visual Studio Code se znovu otevře s novým firmwarem
informace

Firmware můžete stáhnout i příkazem 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ýkoli 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.

Projekt můžete hned zkompilovat a nahrát do modulu Core Module nebo do zařízení 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

Svůj kód upravujte v adresáři src. Jiné soubory obvykle upravovat nemusíte.

Nejspíš tedy nejdřív otevřete soubor src/application.c.

poznámka

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

informace

Příklady firmwaru najdete v našich repozitářích na GitHubu nebo v kapitolách „Jak na:“ v sekci Firmware SDK.

Vývojový cyklus​

Vývojový cyklus obvykle spočívá v opakování těchto 3 kroků:

  • Upravte src/application.c a uložte změny pomocí Ctrl + S
  • Kliknutím na Build + Flash (Console) firmware zkompilujete, nahrajete a otevřete sériovou konzoli s logem.
  • Otestujte svůj firmware

Programovací jazyk​

Firmware je napsaný v čistém jazyce C, který se v průmyslu běžně používá pro embedded zařízení a zařízení s nízkou spotřebou.

Tuto technologii jsme zvolili z těchto hlavních důvodů:

  • 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é konstrukce jazyka C a také naše SDK, se kterým vlastní firmware vytvoříte rychle, snadno a bez problémů s kompatibilitou.

Řešení problémů​

Pokud počítač nerozpozná Radio Dongle nebo Core Module, nebo do nich nejde nahrát firmware, může jít o problém s ovladači nebo operačním systémem. Vyzkoušejte řešení pro svůj systém:

  • Ve Windows a macOS nainstalujte ovladače FTDI VCP
  • V Ubuntu musíte být ve skupině uživatelů dialout. Spusťte příkaz sudo usermod -a -G dialout $USER a restartujte počítač

Další kroky​

Teď už byste měli umět vytvářet firmware a aktualizovat ten stávající.

Více o našich modulech i příklady najdete v sekci Hardwarové moduly nebo v sekci Firmware SDK.