Přeskočit obsah

Software Development Kit¤

Stručná verze pro zkušené vývojáře¤

Logic je řízený mikrokontrolérem ESP32. Doporučujeme použít nástroj PlatformIO jako vývojové prostředí, protože umí automaticky nainstalovat potřebný toolchain a další závislosti. Navíc se snadno integruje do mnoha existujících textových editorů a IDE.

Poskytujeme knihovnu ovladačů pro desku. Můžete ji ve svých projektech v PlatformIO použít tak, že do souboru platformio.ini přidáte tento řádek:

lib_deps = https://github.com/RoboticsBrno/Logic_library

Knihovna nabízí několik příkladů, projektovou šablonu a dokumentaci. Také je k dispozici rychlý přehled všech funkcionalit.

Krok za krokem¤

Pokud jste začátečníci, možná vám přijde vhod následující podrobný návod. Je primárně zaměřený na uživatele Windows (jak víte, vše týkající se vývoje je na tomto systému obvykle složitější). Budete potřebovat nainstalovat:

  1. Editor Visual Studio Code
  2. Python
    1. Pro Windows 8 a vyšší musíte stáhnout Python z Windows Store
    2. Pro Windows 7 potřebujete Python 3.8.10
  3. Git pro správu verzí
  4. USB ovladače (Windows 7, Windows 8 a vyšší)
  5. Plugin PlatformIO pro Visual Studio Code

1. Visual Studio Code¤

Toto je editor, ve kterém budete upravovat své programy. Stáhněte jej odtud a nainstalujte.

2. Python¤

Počítač musí mít nainstalovaný Python.

Windows 8, Windows 10¤

Je nezbytné, abyste Python nainstalovali přes Windows Store, jinak PlatformIO nebude fungovat správně. Můžete použít přímý odkaz do Windows Store.

Windows 7¤

Stáhněte Python 3.8 (novější verze Pythonu na Windows 7 nefungují) a nainstalujte jej. Během instalace se ujistěte, že je zaškrtnuto "Add to PATH".

3. Git¤

Stáhněte Git a nainstalujte ho. Všechny možnosti můžete ponechat na výchozích hodnotách.

4. Ovladače pro Logic¤

Stáhněte ovladače:

Je třeba rozbalit celý archiv a spustit soubor CP210xVCPInstaller_x64.exe. Poté se řídit zobrazeným průvodcem.

5. Platform.io IDE Extension¤

Otevřete Visual Studio Code a nainstalujte rozšíření PlatformIO:

VSCode extension
1. Otevřete VSCode a vlevo klikněte na tlačítko Extensions.

VSCode extension
2. Nainstalujte rozšíření PlatformIO IDE.

VSCode extension
3. Počkejte, než se nainstalují všechny balíčky.

VSCode extension
4. Následně vyčkejte na instalaci PlatformIO Core. Může to chvíli trvat.

VSCode extension
5. Jakmile je vše dokončeno, restartujte editor.

6. Hotovo!¤

Nyní byste měli být připraveni začít vyvíjet vlastní hry pro Logic! Můžete začít příkladovými projekty. Otevřete je pomocí File -> Open Folder.

VSCode extension
Po otevření příkladu je potřeba nastavit verzi Logic. Klikněte na Defaul <PROJECT> a vyberte svou verzi Logic.

VSCode extension
Poté můžete příklad zkompilovat a nahrát do svého Logic. K tomu použijte tlačítka v levém dolním rohu.