Přehled uživatelského rozhraní kódu VS pro IQ – Knihovna VEX

Tento článek je přehledem uživatelského rozhraní VEX Visual Studio Code Extension UI (uživatelské rozhraní). Rozšíření podporuje vývoj projektů C++ a Python pro platformy VEX IQ 2nd Generation, EXP a V5.

Snímek obrazovky zobrazující kompletní rozvržení uživatelského rozhraní VEX VS Code. Panel aktivit a postranní panel se nacházejí na levé straně obrazovky, panel nástrojů a terminál na spodní straně obrazovky a zbytek obrazovky vyplňuje editor.

Komponenty uživatelského rozhraní

Rozšíření kódu VEX VS obsahuje 3 hlavní součásti.

Panel nástrojů
Panel aktivity a boční panel
Terminálový panel

Panel nástrojů

Panel nástrojů poskytuje uživatelům rychlý způsob interakce s projekty rozšíření VEX VS Code VEX Brains a VEX Controllers. Panel nástrojů je aktivní pouze tehdy, když je otevřený platný projekt VEX v VS Code. Platný projekt VEX je projekt, který je vytvořen nebo importován rozšířením. Otevření projektu VEXcode nebo VEXcode Pro není platné a bude nutné jej importovat.

Panel nástrojů VS Code s ikonami rozšíření VEX, které lze použít k rychlé interakci s připojenými zařízeními a projekty VEX. Mezi funkce VEX patří Výběr zařízení, Výběr slotů, Ikona stahování Build & , Ikona přehrávání, Ikona zastavení, Výběr projektu a Výběr souborů Pythonu.

Výběr zařízení

Ikona nástroje pro výběr zařízení je zvýrazněna na panelu nástrojů VS Code. V tomto příkladu se jedná o VEX_EXP.

Nástroj pro výběr zařízení má dvě hlavní funkce. Nejprve zobrazí ikonu mozku nebo ovladače představující typ připojeného zařízení VEX.

Vyhledávací panel VS Code se seznamem pro rychlý výběr všech připojených zařízení VEX. V tomto příkladu je uveden V5 Brain, V5 Controller a EXP Controller.

Za druhé, když kliknete na ikonu seznamu zařízení, zobrazí se rychlý výběrový seznam se všemi připojenými zařízeními VEX. Uživatel si může vybrat, ke kterému zařízení se rozšíření připojí.
Aktuálně připojené zařízení se vždy objeví v horní části seznamu následované všemi ostatními zařízeními seřazenými podle typu zařízení (Brain nebo Controller) a platformy (IQ 2nd Generation, EXP a V5).

Vyhledávací panel VS Code s položkou seznamu pro rychlý výběr zobrazenou pro zobrazení podrobností. Položka má následující označení: MyBrain, V5 Brain, User COM8, Comm COM7.

Každá položka zařízení obsahuje informace o názvu mozku, platformě, typu zařízení a cestě k zařízení.

Vyhledávací panel VS Code s položkou seznamu pro rychlý výběr zobrazenou pro zobrazení podrobností. Položka je ovladač V5, ale pozadí je šedé a není uveden žádný název Brain. To znamená, že tento Controller nemá rádiové spojení s Brainem.

Předmět ovladače V5 s modrým pozadím, který označuje, že tento ovladač má rádiové spojení s mozkem.

Důležité

Pokud je ovladač připojen k počítači, ale nemá rádiové spojení s mozkem, nebude se vedle položky seznamu nebo ikony stavového řádku seznamu zařízení zobrazovat žádný název mozku.

Volič slotu

Ikona Výběru slotů je zvýrazněna na panelu nástrojů VS Code. V tomto příkladu se jedná o Slot 1.

Ikona voliče slotu umožňuje uživateli vybrat, na kterém slotu bude rozšíření stahovat nebo hrát uživatelský program.

Vyhledávací lišta VS Code se seznamem pro rychlý výběr všech dostupných slotů na připojeném VEX Brainu. V tomto příkladu je k dispozici osm slotů.

Po kliknutí na ikonu voliče slotu se zobrazí seznam rychlého výběru s dostupnými sloty uživatelského programu 1-8.

Sestavit/Stáhnout

Ikona sestavení. Ikona stažení.

Ikona Build/Download mění funkce, pokud je připojen VEX Brain nebo VEX Controller.

Ikona sestavení.

Pokud zařízení VEX není připojeno, zobrazí se ikona sestavení. Po kliknutí se projekt pouze sestaví.

Ikona stažení.

Pokud je připojeno zařízení VEX, zobrazí se ikona stahování. Po kliknutí se projekt sestaví a pokud bude úspěšný, stáhne se do zařízení VEX.

Hrát si

Ikona přehrávání.

Po kliknutí na ikonu přehrávání spustíte uživatelský program ve vybraném slotu.

Stop

Ikona zastavení.

Ikona stop po kliknutí zastaví uživatelský program.

Vybraný pracovní prostor

Výběr projektu se zobrazuje na panelu nástrojů VS Code. V tomto příkladu se čte EXPTestProject.

VS Code podporuje projekty s více pracovními prostory. Selektor projektů umožňuje uživatelům přepínat mezi projekty VEX, pokud v pracovním prostoru existuje více projektů.

Vyhledávací panel VS Code se seznamem pro rychlý výběr uložených projektů VEX. V tomto příkladu je uveden jeden projekt v Pythonu a jeden projekt v C++.

Po kliknutí na ikonu výběru projektů se zobrazí rychlý výběrový seznam se všemi platnými projekty.

Důležité
Pokud projekt není platný, nezobrazí se v seznamu rychlého výběru projektu. Projekt není platný, pokud nebyl vytvořen nebo importován pomocí rozšíření VEX VS Code Extension.

Ikona Výběru souborů Pythonu se zobrazuje na panelu nástrojů VS Code. V tomto příkladu se jedná o main.py.

Selektor souboru Python (pouze Python)
Když je vybrán projekt VEX python, na panelu nástrojů se zobrazí selektor souboru python. Python pro VEX aktuálně podporuje pouze stahování jednotlivých souborů.

Vyhledávací panel VS Code se seznamem pro rychlý výběr všech souborů Pythonu v tomto projektu VEX. V tomto příkladu existují tři soubory Pythonu, každý v jiném umístění souboru.

Po kliknutí na ikonu se zobrazí rychlý výběrový seznam se všemi soubory python umístěnými v adresáři pracovního prostoru.
Selektor souboru python umožňuje uživateli přepínat mezi zdrojovými soubory pythonu (.py)

Panel aktivity a postranní panel VEX

Snímek obrazovky, který ukazuje panel aktivit VS Code a postranní panel otevřený v zobrazení VEX. VEX View má výše uvedené možnosti pro vytváření a import projektů, níže nabídku VEX Device Info a dole nabídku zpětné vazby.

Projekty Akce

Sekce Akce projektu v zobrazení rozšíření VEX. Tato sekce obsahuje dvě tlačítka s nápisy Nový projekt a Importovat projekt.

Panel aktivity vex obsahuje pohled Akce projektu a pohled Informace o zařízení VEX.

Zobrazení Akce projektu se používá k vytvoření nového projektu nebo importu existujícího VEXcode nebo VEXcode Pro Project.

Další informace o vytváření nového projektu najdete v tomto článku!

Informace o verzi se také zobrazují v levém a pravém dolním rohu pohledu.

Důležité
Pokud je v editoru otevřen projekt VEXcode nebo VEXcode Pro, nebude považován za platný projekt VEX, projekt je třeba importovat pomocí tlačítka Importovat na postranním panelu VEX.

Informace o zařízení VEX

V zobrazení VEX Extension View se zobrazuje sekce VEX Device Information se seznamem všech připojených zařízení a konkrétními informacemi o každém z nich. V tomto příkladu je zobrazen mozek IQ (2. generace) a jeho stažené programy. Výpis Controlleru se uvádí jako Controller, nikoli jako propojený.

Zobrazení VEX Device Info poskytuje uživateli přehled o připojeném VEX Brain nebo VEX Controlleru. V tomto zobrazení lze nalézt verzi VEXos, cestu k sériovému portu, uživatelský program a informace o zařízení. Prostřednictvím tohoto zobrazení lze také provádět další funkce, jako jsou aktualizace firmwaru VEXos, snímky obrazovky, nastavení názvu mozku a čísla týmu nastavení.

Systémové informace

Systémová složka a její obsah jsou zobrazeny a zvýrazněny pod složkou Brain. Systémová složka obsahuje data o Brainu a data zní VEXos 1.0.1.0, název VEX_EXP, tým 000000, ID 0EC83725 a Python 1.0.0.7.

Systémové informace poskytují stručný přehled připojeného zařízení VEX. To zahrnuje verzi VEXos zařízení, název mozku, číslo týmu, ID mozku a informace o verzi runtime pythonu.

Informace o sériovém portu

Složka Serial Port a její obsah se zobrazí pod složkou Brain. Složka Serial Port obsahuje data o kabelovém připojení Brainu. Tato data se zobrazují jako komunikační COM167, uživatelský COM168.

Informace o sériovém portu zobrazují cestu zařízení pro každý port dostupný pro zařízení VEX. Většina zařízení VEX má dva sériové porty. Komunikační sériový port se používá pro stahování programů a ovládání mozkových funkcí. Uživatelský sériový port se používá k přenosu dat mezi uživatelskou aplikací spuštěnou na Brain a hostitelským počítačem připojeným přes USB. Kontrolér V5 je jediné zařízení VEX, které má pouze komunikační sériový port a žádný uživatelský sériový port.

Informace o programech

Složka Programy a její obsah se zobrazí pod složkou Brain. Složka Programy zobrazuje všechny stažené projekty VEX na Brainu. V tomto příkladu jsou do připojeného Brainu stažené čtyři programy v jazyce C/C++.

Informace o programu zobrazí seznam všech stažených uživatelských programů na VEX Brain.

Složka Programs a její obsah se zobrazí pod složkou Brain, nyní s otevřenou složkou prvního projektu pro zobrazení jejího obsahu. Složka projektu zobrazuje data o slotu, souboru, typu, velikosti a čase.

Každou položku seznamu programů lze rozbalit a zobrazit další informace o každém uživatelském programu, jako je umístění slotu, název souboru, typ jazyka, velikost souboru a čas stažení.

Informace o zařízení

Složka Zařízení a její obsah se zobrazí pod složkou Brain. Složka Zařízení zobrazuje všechna zařízení připojená k Brainu. V tomto příkladu je uvedeno 6 zařízení, včetně 4 motorů, 3vodičového zařízení a interního rádia.

Informace o zařízeních zobrazují seznam všech zařízení smart port připojených k VEX Brain. Každá položka seznamu zobrazuje číslo chytrého portu a typ zařízení.

Složka Zařízení a její obsah se zobrazí pod složkou Brain. V tomto příkladu bylo vybráno zařízení Motor a jeho obsah je Typ Motor, verze 1.0.0.4, Boot 1.0.2.0.

Každou položku seznamu zařízení lze rozšířit tak, aby zobrazovala informace o verzi firmwaru každého zařízení s chytrým portem.

Při připojení k zařízení VEX Brain se zobrazí stav propojení s ovladačem.

Řadič je uveden ve složce Zařízení. Tento Controller čte Controller, propojený.

VEX Brain je propojen s ovladačem VEX

Řadič je uveden ve složce Zařízení. Tento Controller čte Controller, není propojen.

VEX Brain není propojen s ovladačem VEX

Řadič je uveden ve složce Zařízení. Tento Controller se čte jako Controller, tethered.

Ovladač VEX V5 je připojen k mozku VEX V5

Snímky obrazovky

Kurzor se nachází nad složkou VEX Device Indicator a vedle něj je zobrazena ikona kamery.

Kliknutím na ikonu fotoaparátu může uživatel pořídit a stáhnout snímek obrazovky z VEX Brain.
Snímky obrazovky jsou dostupné pouze při přímém připojení k VEX Brain přes USB

Battery Medic (pouze V5 Brain)

Kurzor se nachází nad složkou V5 Brain VEX Device Indicator a vedle ní je zobrazena ikona Battery Medic.

Kliknutím na ikonu srdce rozšíření stáhne a spustí uživatelský program battery medic.

Nastavte název mozku

Kurzor se nachází nad možností Název ve složce Systém a vedle ní je zobrazena ikona tužky.

Kliknutím na ikonu tužky vedle názvu systému>může uživatel nastavit název pro VEX Brain.

Okno s výzvou k nastavení názvu mozku s textovým polem a zprávou pod ním, která zní: Stiskněte klávesu Enter pro potvrzení zadaného textu nebo klávesu Escape pro zrušení.

Po kliknutí na ikonu tužky se v horní části editoru kódu VS objeví vstupní pole. Do vstupního pole zadejte nový název mozku a nastavte jej stisknutím klávesy Enter.

Nastavte číslo týmu

Kurzor se nachází nad možností Tým ve složce Systém a vedle ní je zobrazena ikona tužky.

Kliknutím na ikonu tužky vedle týmu system->může uživatel nastavit číslo týmu pro VEX Brain.

Okno s výzvou k nastavení čísla týmu s textovým polem a zprávou pod ním, která zní: Stiskněte klávesu Enter pro potvrzení zadaného textu nebo klávesu Escape pro zrušení.

Po kliknutí na ikonu tužky se v horní části editoru kódu VS objeví vstupní pole. Zadejte nové číslo týmu do vstupního pole a stisknutím klávesy Enter nastavte.

Vymazat uživatelský program

Kurzor se nachází nad programem ve složce Programy a vedle něj se zobrazuje ikona koše.

Kliknutím na ikonu Koš vedle názvu projektu programy->může uživatel vymazat program v určitém slotu. DŮLEŽITÉ, jakmile program vymažete, nelze jej obnovit. Při používání této funkce buďte opatrní.

Upozornění na informace o zařízení

Aktualizace VEXos

Ikona složky Brain a ikona indikátoru zařízení VEX jsou zobrazeny oranžově a vedle verze systému VEXos je symbol nebezpečí. Tyto příznaky naznačují, že verze VEXos pro Brain je zastaralá.

Když je verze VEXos VEX Brain zastaralá, zobrazí se vedle verze VEXos ikona varovné zprávy a obě ikony Brain zežloutnou.

K vyřešení tohoto varování by měl uživatel aktualizovat VEXos pro svůj VEXos Brain.

Kurzor se nachází nad zastaralou složkou Brain a vedle něj je zobrazena ikona šipky nahoru.

VEXos lze aktualizovat kliknutím na šipku nahoru vedle ikony VEX Brain.

Okno s výzvou k aktualizaci VEXos se zprávou „K dispozici je aktualizace VEXos: 1.0.1.0“. Zdroj, rozšíření VEX. Níže jsou dvě tlačítka s nápisy Aktualizovat a Ignorovat.

Pokud jsou VEXos zastaralé, v pravém dolním rohu editoru kódu VS se zobrazí oznamovací pole. Uživatel může spustit aktualizaci VEXos kliknutím na tlačítko „Aktualizovat“ nebo kliknutím na tlačítko „Ignorovat“ aktualizaci VEXos přeskočit.

Mozek není propojen s připojeným ovladačem

Složka Brain pod složkou VEX Device Indicator má oranžovou ikonu a je označena jako Brain, nepropojeno. Tyto příznaky naznačují, že není připojen žádný VEX Brain.

Ikona ovladače VEX se změní na žlutou, když je ovladač VEX připojen k počítači, ale není připojen k VEX Brain.

K vyřešení tohoto varování by měl uživatel propojit VEX Controller s VEX Brain

Terminálový panel

VEX VS Code Extension poskytuje při spuštění dva terminály, Log Terminal a Interactive Terminal

Okno terminálu VS Code je otevřené a zobrazuje terminál VEX Log a interaktivní terminál VEX.

Logový terminál

Otevře se terminál protokolu VEX ve VS Code a zobrazí se historie používání rozšíření VEX. V tomto příkladu se zobrazují zprávy typu Log, Windows build for platform vexexp, Download User Program, Download Finished.

Log Terminal zobrazuje výstup sestavení, chybu sestavení a výsledky stahování.

Interaktivní terminál

Interaktivní terminál VS Code VEX se otevře a zobrazí se zpráva s textem Hello World.

Interaktivní terminál má dvě funkce, zobrazování protokolů printf a odesílání nezpracovaných úhozů zpět do uživatelského programu. Aby bylo možné využít výhod interaktivního terminálu, musí být Brain nebo Controller připojen k počítači, na kterém je spuštěno rozšíření VEX VS Code Extension. Interaktivní terminálový výstup se po vytvoření a stažení uživatelského programu standardně vymaže.

Uživatelské nastavení

Uživatelská nastavení jsou globální nastavení, která kód Visual Studio nabízí pro každé rozšíření. Uživatelská nastavení jsou aplikována na každý projekt rozšíření VEX VS Code.

Nastavení uživatele VS Code se otevře na stránce VEX, kde lze přizpůsobit chování rozšíření VEX Robotics.

Jak získat přístup k uživatelským nastavením VEX

Ikona nastavení v úplné spodní části panelu aktivit VS Code, který se nachází v levém dolním rohu obrazovky.

Klikněte na ozubené kolo v levém rohu VS Code a zobrazí se kontextová nabídka

Kontextová nabídka nastavení VS Code s mnoha uvedenými možnostmi. Je zvýrazněna možnost Nastavení, která je třetí možností v nabídce pod Paletou příkazů a Profily.

V kontextové nabídce klikněte na položku „Nastavení“ a zobrazí se stránka nastavení.

Okno nastavení VS Code je otevřené a v levém navigačním seznamu je zvýrazněna kategorie Rozšíření.

V levém zobrazení seznamu klikněte na položku „Rozšíření“. Dále přejděte dolů a najděte položku označenou „VEX“.

Okno nastavení VS Code je otevřené a odkaz na stránku VEX v kategorii Rozšíření je zvýrazněný.

Klikněte na položku seznamu „VEX“.

Nastavení uživatele VS Code se otevře na stránce VEX, kde lze přizpůsobit chování rozšíření VEX Robotics.

Uživatelská nastavení VEX se objeví na pravém panelu.

Přehled nastavení

Kanál ovladače (pouze ovladač V5)

Nastavení Controller Channel řídí typ rádiového komunikačního kanálu mezi V5 Brain a V5 Controller.
Toto nastavení platí pouze v případě, že je VS Code připojen k ovladači V5 přes USB a ovladač je připojen k V5 Brain přes VEXnet. Uživatel si může vybrat mezi Download a Pit kanály. Když je nastaveno na Download, rádio přeskočí na kanál stahování VEXnet, jakmile je zahájeno stahování uživatelského programu. Stahovací kanál umožňuje vyšší datové rychlosti a efektivnější stahování. Při nastavení na Pitzůstane rádio na pitovém kanálu a stahování bude trvat mnohem déle. Ve výchozím nastavení je toto nastavení nastaveno na Stáhnout.

Uživatelská nastavení VEX se zobrazenou možností Kanál řídicí jednotky. Tato možnost má rozbalovací nabídku, která je ve výchozím nastavení nastavena na možnost Stáhnout. Popis zní Nastavuje rádiový kanál řídicí jednotky V5.

Domovská stránka sady Cpp Project SDK

NEUPRAVUJTE TOTO NASTAVENÍ.

Cesta Cpp Toolchain

Cpp Toolchain Path nastavuje cestu pro toolchain, který se používá při vytváření projektu C++ VEX VS Code.

Uživatelská nastavení VEX s zobrazenou možností Cesta v nástroji Cpp. Tato možnost má textové pole, které představuje cestu k souboru.

Povolit uživatelský terminál

Nastavení Enable User Terminal umožňuje rozšíření otevřít uživatelský sériový port, když rozšíření detekuje VEX Brain nebo VEX Controller. Jediná výjimka platí pro řadič V5, který nemá výčet s uživatelským sériovým portem.

Uživatelská nastavení VEX se zobrazenou možností Obecné povolení uživatelského terminálu. Tato možnost má rozbalovací nabídku, která je ve výchozím nastavení nastavena na Povolit. Popis zní: Povolit rozšíření pro otevírání a zobrazování dat z uživatelského portu.

Povolit umožňuje rozšíření připojit se k uživatelskému portu při spuštění a vytvořit interaktivní terminál. Pokud je vybrána možnost Povolit, když je rozšíření spuštěno, rozšíření se pokusí otevřít uživatelský port, pokud je připojeno zařízení.
Zakázat zabrání rozšíření v připojení k uživatelskému portu při spuštění a nevytvoří interaktivní terminál. Pokud je vybrána možnost Zakázat, když je rozšíření spuštěno, rozšíření zavře uživatelský port a odebere interaktivní terminál.

Typ sestavení projektu

Typ sestavení projektu nastavuje, jak rozšíření vytvoří projekt C++. Uživatel může nastavit typ sestavení na Build nebo Rebuild.
Sestavení sestaví projekt pouze tehdy, když Make zjistí jakékoli změny ve zdrojovém kódu projektu.
Rebuild vyčistí adresář sestavení projektu a poté sestaví projekt. Tato možnost je obvykle mnohem pomalejší.

Uživatelská nastavení VEX se zobrazenou možností Typ sestavení projektu. Tato možnost má rozbalovací nabídku, která je ve výchozím nastavení nastavena na Sestavit. Popis zní Nastavit typ sestavení projektu CPP.

Domov projektu

Domovská stránka projektu nastaví výchozí domovský adresář pro nový projekt při dokončení průvodce Nový projekt.

Uživatelská nastavení VEX se zobrazenou možností Domovská stránka projektu. Tato možnost má textové pole, které představuje cestu k souboru. Popis zní Nastaví výchozí umístění pro nové projekty.

Spustit po stažení

Spustit po stažení pokud je povoleno, způsobí spuštění uživatelského programu po jeho stažení do VEX Brain.

Uživatelská nastavení VEX se zobrazenou možností Spustit projekt po stažení. Tato možnost má zaškrtávací políčko, které je v tomto příkladu zobrazeno jako zaškrtnuté. Popis zní: Nastaví, zda se má uživatelský program spustit po stažení.

Domovská stránka sady Python SDK

NEUPRAVUJTE TOTO NASTAVENÍ.

Uživatelská nastavení VEX se zobrazenou možností Domovská stránka Python SDK. Tato možnost má odkaz s názvem Upravit v souboru settings.json. V popisu je uvedeno NEEDITOVAT.

Nápověda k příkazu VEX

Nápověda k příkazům VEX umožňuje přístup k dokumentaci pro specifické funkce obsažené v C++ a Python API (Application Programming Interface). Dokumentace je specifická pro každou platformu VEX (IQ 2. generace, EXP, V5).

Příkaz C++ v editoru VS Code byl zvýrazněn kurzorem.

Chcete-li otevřít nápovědu k příkazu VEX, nejprve zvýrazněte text funkce, kterou chcete vyhledat.

Kontextová nabídka pro příkaz C++ byla otevřena a možnost Nápověda k příkazům VEX je zvýrazněna.

Klikněte pravým tlačítkem na vybraný text a zobrazí se kontextová nabídka.
Další Klepnutím na nápovědu příkazu VEX otevřete dokumentaci.

Stránka s nápovědou k příkazům VEX je otevřená a zobrazuje informace o příkazu Brain Screen Print v jazyce C++ a příklady těchto příkazů.

Pokud nápověda k příkazu VEX najde přesnou shodu, objeví se nové webové zobrazení s příslušnou dokumentací.

Vyhledávací panel VS Code se seznamem pro rychlý výběr odpovídajících příkazů VEX C++ v nápovědě k příkazům VEX, který pomáhá zúžit vyhledávání uživatele.

Pokud vybranému textu odpovídá více dokumentů, zobrazí se rozbalovací nabídka s filtrovaným seznamem relevantní dokumentace.