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.
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.
Výběr zařízení
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.
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).
Každá položka zařízení obsahuje informace o názvu mozku, platformě, typu zařízení a cestě k zařízení.
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 voliče slotu umožňuje uživateli vybrat, na kterém slotu bude rozšíření stahovat nebo hrát uživatelský program.
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 Build/Download mění funkce, pokud je připojen VEX Brain nebo VEX Controller.
Pokud zařízení VEX není připojeno, zobrazí se ikona sestavení. Po kliknutí se projekt pouze sestaví.
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
Po kliknutí na ikonu přehrávání spustíte uživatelský program ve vybraném slotu.
Stop
Ikona stop po kliknutí zastaví uživatelský program.
Vybraný pracovní prostor
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ů.
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.
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ů.
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
Projekty Akce
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 naleznete 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
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é 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
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
Informace o programu zobrazí seznam všech stažených uživatelských programů na VEX Brain.
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í
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í.
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.
VEX Brain je propojen s ovladačem VEX
VEX Brain není propojen s ovladačem VEX
Ovladač VEX V5 je připojen k mozku VEX V5
Snímky obrazovky
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)
Kliknutím na ikonu srdce rozšíření stáhne a spustí uživatelský program battery medic.
Nastavte název mozku
Kliknutím na ikonu tužky vedle názvu systému>může uživatel nastavit název pro VEX Brain.
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
Kliknutím na ikonu tužky vedle týmu system->může uživatel nastavit číslo týmu pro VEX Brain.
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
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
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.
VEXos lze aktualizovat kliknutím na šipku nahoru vedle ikony VEX Brain.
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
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
Logový terminál
Log Terminal zobrazuje výstup sestavení, chybu sestavení a výsledky stahování.
Interaktivní terminál
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.
Jak získat přístup k uživatelským nastavením VEX
Klikněte na ozubené kolo v levém rohu VS Code a zobrazí se kontextová nabídka
V kontextové nabídce klikněte na položku „Nastavení“ a zobrazí se stránka nastavení.
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“.
Klikněte na položku seznamu „VEX“.
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.
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.
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.
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ší.
Domov projektu
Domovská stránka projektu nastaví výchozí domovský adresář pro nový projekt při dokončení průvodce Nový projekt.
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.
Domovská stránka sady Python SDK
NEUPRAVUJTE TOTO NASTAVENÍ.
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).
Chcete-li otevřít nápovědu k příkazu VEX, nejprve zvýrazněte text funkce, kterou chcete vyhledat.
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.
Pokud nápověda k příkazu VEX najde přesnou shodu, objeví se nové webové zobrazení s příslušnou dokumentací.
Pokud vybranému textu odpovídá více dokumentů, zobrazí se rozbalovací nabídka s filtrovaným seznamem relevantní dokumentace.