První program

Poznámka

Vyzkoušejte náš nový BriVis – vizuální programování v editoru Brian. Pro instrukce k nahrávání a spouštění pokračujte v sekci Nahrání programu do Briana a následujících oddílech.

Minimální nastavení nevyžaduje instalaci softwaru na vašem počítači. Pro efektivní práci jsou však doporučeny některé programy (viz IDE a Debugging).

IDE

IDE je software pro úpravu kódu, který vám pomůže s vývojem. Existuje mnoho možností. Vyberte si jakékoli IDE, které podporuje psaní kódu v pythonu. Pokud nechcete používat IDE, postačí i textový editor. Doporučujeme používat Visual Studio Code nebo PyCharm.

Poskytujeme dokumentaci ve formě souborů, které lzou načíst v IDE. Balíček si stáhněte zde.

Píšeme první program

Otevřete textový editor dle vlastního výběru a vytvořte soubor hello.py. Soubor by měl obsahovat následující:

hello.py
print("Hello Brian world!")

Zatím použijeme pouze tento velmi jednoduchý program. Má vypsat text „Hello Brian world!“ a nic víc. Poskytneme pro vás i několik dalších ukázkových programů.

Nahrání programu do Briana

Použití SD karty

Vložte SD kartu do svého počítače a zkopírujte tento soubor kamkoliv na kartu. Vyjměte kartu a vložte ji do Briana. To je vše. Váš program je nyní připraven ke spuštění. Pamatujte, že při každé aktualizaci programu by měla být karta bezpečně vyjmuta pomocí tlačítka Eject SD v zobrazení SD card. Jinak hrozí riziko poškození souborového systému.

Připojení SD karty přes USB

Vložte SD kartu do Briana a nechte ji tam. Při této možnosti je také nutné mít vloženou SD kartu, protože všechny programy jsou na kartě uloženy a načítají se z ní.

Připojte Briana k počítači pomocí USB kabelu. Zapněte Briana, ten by se měl zobrazit jako zařízení hromadného úložiště. Uvidíte obsah SD karty a můžete zkopírovat soubory přímo z počítače do Briana (SD karty). Všimněte si, že Briana uvidíte jako zařízení hromadného úložiště pouze tehdy, když je zapnutý a neběží na něm žádný program.

Zkopírujte soubor hello.py do Briana. To je vše.

Varování

Nepracujte přímo z připojeného zařízení!

Může být lákavé upravovat a pracovat na svých souborech přímo z připojeného zařízení. To se však nedoporučuje, protože se zařízení odpojí od počítače po každém spuštění programu. Náhlé objevení a zmizení souborů může zmást váš editor. Rovněž hrozí, že v případě poškození souborového systému SD karty přijdete o všechna data bez možnosti zálohy.

Poznámka

Připojení SD karty funguje pouze, pokud je tato funkce povolena (výchozí nastavení). Přečtěte si Výběr funkce USB.

Bezdrátový přenos

[ kalendář ] Brian obsahuje hardware pro komunikaci přes WiFi sítě. Softwarová část zatím není implementována. Připojení k Brianu přes WiFi a bezdrátový přenos souborů budou možné. Také bude možné komunikovat s běžícím programem pomocí WiFi.

Spouštění programu

Najděte a vyberte požadovaný soubor (hello.py) ve správci souborů SD karty. Zvolte hlavní soubor. Tím se otevře obrazovka s podrobnostmi a první možností bude spuštění programu. Upozorňujeme, že při spuštění programu se odpojí zařízení hromadného úložiště počítače.

Gratulujeme! Úspěšně jste na Brianovi spustili váš kód. Pro více možností se podívejte do sekce Ovládání Briana, nebo si přečtětě API reference.

Zastavení programu

Je odpovědností programátora zajistit mechanismus pro zastavení programu (například čekání na stisk konkrétního tlačítka). Existuje několik možností:

  • Program skončí, když nebude žádné další příkazy k vykonání. Náš jednoduchý hello.py vytiskne Hello Brian world! a zastaví se, protože je na konci souboru.

  • Program skončí standardním voláním API: sys.exit()

  • Brian odešle programu signál KeyboardInterrupt při současném stisknutí levého a pravého tlačítka. Nezáleží, zda stisknete horní nebo dolní tlačítko. Obvykle program skončí po přijetí signálu KeyboardInterrupt, ale v některých případech může být tento signál ignorován.

  • Vynucené vypnutí: Pokud váš program nereaguje a máte zakázanou možnost KeyboardInterrupt, nebo je tato možnost ignorována, můžete odebrat micro SD kartu. Tím se program ukončí (protože běží z SD karty). Upozorňujeme, že tento postup by se v běžných situacích neměl používat, neboť hrozí poškození souborů na SD kartě. Můžete také nuceně vypnout Briana odpojením USB kabelu a současným stisknutím všech čtyř tlačítek.

Výstup programu

Všechny příkazy print v Pythonu se zobrazují na obrazovce Briana. Výstupy lze procházet (pomocí kolečka), ale historie je z důvodu výkonu omezena na 1500 řádků.

Současně je výstup příkazů print streamován do připojené konzole, je-li tato funkce povolena (viz Výběr funkce USB). Pro jednoduchost je k dispozici konzolový nástroj v prohlížeči, ale výstup můžete samozřejmě sledovat pomocí jakékoli standardní sériové konzole připojené ke správnému portu. Brian komunikuje při přenosové rychlosti 115200 baud.

Výběr funkce USB

USB může fungovat v jednom ze dvou režimů:

Chcete-li změnit režim, přejděte z hlavního menu do sekce Settings a vyberte Use USB for.... Poté zvolte požadovaný režim. Při změně režimu odpojte USB, pokud je připojeno, a restartujte Briana. Jinak počítač nemusí správně rozpoznat typ zařízení.

Když se zobrazí ikona „USB - reboot pending“ ( usb-reboot ), znamená to, že zvolený režim se liší od aktuálně používaného a účinek se projeví až po restartu bez připojeného USB.

[ kalendář ] Podpora obou režimů současně je plánována, ale zatím není implementována.