Přehled uživatelského rozhraní rozšíření kódu VEX VS – Knihovna VEX

Tento článek poskytuje přehled 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.

Rozvržení uživatelského rozhraní rozšíření VEX VS Code

Uživatelské rozhraní rozšíření kódu VEX Visual Studio je rozděleno do pěti hlavních oblastí: Panel aktivity, Postranní panel, Editor, Panel terminálu a Panel nástrojů.

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.

Panel aktivity

Panel činností obsahuje řadu ikon, které nám umožňují přepínat mezi zobrazeními a poskytují další kontextově specifické indikátory pro vývoj projektu VEX.

Panel aktivit VS Code s nainstalovaným rozšířením VEX Robotics. Panel aktivit obsahuje ikony, které umožňují užitečné rychlé akce, jako je vyhledávání, správa rozšíření, správa verzí a další.

Běžné ikony používané pro vývoj projektu VEX ve VS Code jsou:

Ikona Průzkumníka - Po kliknutí se na postranním panelu otevře Zobrazení Průzkumníka.
Ikona zobrazení rozšíření - Po kliknutí se na postranním panelu otevře zobrazení rozšíření.
Ikona VEX View - Po kliknutí se na boční liště otevře VEX View .

Boční lišta

Postranní panel obsahuje různá zobrazení, která nám umožňují používat integrované nástroje v rámci VS Code. Běžné pohledy postranního panelu používané k provádění úloh pro vývoj projektu VEX jsou Zobrazení rozšíření, Zobrazení VEXa Zobrazení Průzkumníka.

Zobrazení rozšíření

Zobrazení rozšíření se používá k instalaci a správě rozšíření ve VS Code. Pro vývoj softwaru na platformách VEX IQ 2nd Generation, EXP a V5 potřebujeme nainstalovat rozšíření VEX Extension, C/C++ Extension a Python Extension.

Podrobné pokyny k instalaci rozšíření VEX Extension, C/C++ Extensiona Python Extension v kódu VS naleznete v tomto článku.

Zobrazení rozšíření VS Code, které zobrazuje seznam nainstalovaných rozšíření. Každé rozšíření má nabídku nastavení, kterou lze otevřít zde, a je zde vyhledávací panel pro nalezení a stažení nových rozšíření.

Zobrazení VEX

VEX View nám umožňuje vyvíjet projekty pro VEX IQ 2nd Generation, EXP a V5 ve VS Code. V zobrazení VEX jsou zahrnuty tři kategorie: AKCE PROJEKTU, INFORMACE O ZAŘÍZENÍ VEX, a ZPĚTNÁ VAZBA VEX.

Zobrazení VEX ve VS Code, které výše zobrazuje možnosti pro vytváření a import projektů, níže nabídku Informace o zařízení VEX a dole nabídku zpětné vazby.

PROJECT ACTIONS
Tlačítka pod PROJECT ACTIONS se používají k vytvoření nového projektu VEX nebo importu existujícího projektu VEXcode.
Podrobné pokyny k vytvoření projektu VEX ve VS Code naleznete v tomto článku pro V5, v tomto článku pro EXPa v tomto článku pro IQ (2nd).

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

INFORMACE O ZAŘÍZENÍ VEX
Kategorie INFORMACE O ZAŘÍZENÍ VEX nám poskytuje přehled připojeného zařízení VEX – VEX Brain nebo VEX Controller.

Tato kategorie označuje typ připojeného zařízení VEX a zobrazuje informace o systému Brain, sériovém portu, staženém programu a zařízeních připojených k inteligentním portům VEX Brain. Umožňuje nám screenshot VEX Brain Screen, zobrazení VEX Brain Event Log, použití V5 Battery Medic, nastavení názvu mozku a týmu čísloa vymazání uživatelského programu z VEX Mozek.

Když je k počítači připojen VEX Brain, kategorie VEX DEVICE INFO ukazuje, zda je ovladač VEX připojen k VEX Brain, a umožňuje nám aktualizovat VEXos pro VEX Brain, pokud je VEX Brain verze VEXos neaktuální.

Když je ovladač VEX připojen k počítači, kategorie VEX DEVICE INFO ukazuje, zda je VEX Brain připojen k ovladači VEX, a umožňuje nám aktualizovat VEXos pro ovladač VEX, pokud je verze VEX ovladače VEX Controller neaktuální.

Podrobný popis informací o zařízení a použití funkcí pod VEX DEVICE INFOnaleznete v tomto článku.

VEX FEEDBACK
Můžeme odeslat zpětnou vazbu společnosti VEX zadáním zprávy do textového pole pod VEX FEEDBACK a kliknutím na tlačítko ODESLAT .
Užitečné informace o používání VEX FEEDBACK v kódu VS naleznete v tomto článku.

Sekce VEX Feedback v zobrazení VEX Extension. Tato sekce obsahuje formulář s možnostmi pro odeslání zpětné vazby společnosti VEX.

Zobrazení průzkumníka

Explorer View se používá k procházení, otevírání a správě souborů a složek projektu VEX ve VS Code.

Zobrazení VS Code Explorer, které umožňuje uživateli procházet složky a soubory v jeho projektu VEX. Soubory mají zobrazené odpovídající ikony a typy souborů, v tomto příkladu je vybrán soubor Pythonu a jeho název zní main.py.

Editor

Editor je hlavní oblastí pro úpravu souborů ve VS Code. Rozšíření kódu VEX VS umožňuje Intellisense/Linting pro C/C++ i Python v oblasti editoru, aby nám pomohl při vývoji programu.

Editor kódu VS se souborem Pythonu otevřeným jako součást projektu VEX. Zde lze psát a upravovat kód v Pythonu nebo C/C++ a vytvářet tak robotické programy VEX po připojení k VEX Brain.

V oblasti Editor můžeme přistupovat k užitečným informacím o konkrétní funkci najetím myši na text funkce nebo pomocí VEX Command Help pro přístup k dokumentaci pro tuto funkci, která je součástí C++ a Python API (Application Programming Interface ).

Podrobné pokyny k použití nápovědy VEX Command Help ve VS Code naleznete v tomto článku.

Terminálový panel

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

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

Terminál protokolu VEX kódu VS se otevře a zobrazuje výchozí prázdný stav s pouze jednou vytištěnou zprávou s textem Log.

Interaktivní terminál - Interaktivní terminál má dvě funkce – zobrazení protokolů tisku a odesílání nezpracovaných stisků kláves zpět do uživatelského programu.

Poznámka: Pro použití interaktivního terminálu musí být k počítači se spuštěným rozšířením VEX VS Code Extension připojen mozek nebo ovladač.
Poznámka: Výstup interaktivního terminálu se po sestavení a stažení uživatelského programu ve výchozím nastavení vymaže.

Panel nástrojů

Panel nástrojů obsahuje řadu ikon, které nám poskytují rychlý způsob interakce s projekty rozšíření VEX VS Code, VEX Brains a VEX Controllers.

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.

Poznámka: Panel nástrojů je aktivní pouze tehdy, když je ve VS Code otevřen platný projekt VEX.

Poznámka: Platný projekt VEX je projekt, který je vytvořen nebo importován rozšířením. Projekty VEXcode nebo VEXcode Pro otevřené v editoru nebudou považovány za platný projekt VEX a bude nutné je importovat.

Mezi ikony zobrazené na liště Toolbar patří:

Výběr zařízení - Výběr zařízení zobrazuje ikonu připojeného zařízení VEX (ikonu mozku nebo ikonu řadiče )
Poznámka: Pokud je řadič připojen k počítači, ale nemá rádiové spojení s mozkem, vedle ikony řadiče se nezobrazí žádný název mozku.

Ikona výběru slotu - Ikona výběru slotu nám umožňuje vybrat, který slot VEX Extension stáhne nebo na kterém přehraje uživatelský program, kliknutím na něj a výběrem jednoho z osmi dostupných slotů na VEX Brain ze seznamu.
Ikona sestavení & stahování - Pokud je připojeno zařízení VEX, na panelu nástrojů se zobrazí ikona stahování. Po kliknutí se projekt sestaví a pokud bude úspěšný, stáhne se do připojeného zařízení VEX.
Ikona přehrávání - Po kliknutí na ikonu Přehrát spustíte stažený uživatelský program ve vybraném slotu na VEX Brain.
Ikona Stop - Po kliknutí na ikonu Stop přestane spouštět uživatelský program na VEX Brain.
Project Selector - Project Selector zobrazuje název vybraného projektu. Ikona Project Selector Icon nám umožňuje přepínat mezi projekty VEX, pokud jich v pracovním prostoru existuje více, kliknutím na ni a výběrem projektu ze seznamu.
Selektor souborů Python (pouze Python) – Když je vybrán projekt VEX Python, na panelu nástrojů se zobrazí Selektor souborů Python. Python File Selector zobrazuje název vybraného Python souboru. Python pro VEX aktuálně podporuje pouze stahování jednotlivých souborů.

Užitečné informace o tom, jak používat funkce lišty Toolbar ve VS Code, naleznete v tomto článku.

Uživatelská nastavení VEX

Uživatelská nastavení VEX nám umožňují konfigurovat VEX Extension podle našich vlastních požadavků. Uživatelská nastavení jsou globální nastavení aplikovaná na každý projekt rozšíření VEX VS Code. K uživatelským nastavením VEX se dostaneme kliknutím na ikonu nastavení v kódu VS a výběrem odpovídajících položek v nabídkách.

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

Uživatelská nastavení VEX pro konfiguraci rozšíření kódu VEX VS jsou:

Kanál ovladače (pouze ovladač V5) – Nastaví rádiový kanál ovladače V5 na Download nebo Pit. Toto nastavení platí pouze pro rádiové spojení VEXnet.

Cpp Toolchain Path - Nastavuje cestu pro CPP Toolchain.
Povolit uživatelský terminál– Povolí nebo zakáže rozšíření pro otevírání a zobrazování dat z uživatelského portu.
Log Entries – Nastavuje počet záznamů protokolu, které se mají nahrát z VEX Brain.
Project Build Type – Nastavuje, jak rozšíření vytvoří projekt C++.
Domovská stránka projektu – Nastaví výchozí umístění pro nové projekty.
Run After Download – Nastavuje, zda se má uživatelský program spustit po stažení do VEX Brain.
System DFU Auto Recover – Nastavuje, zda se má Brain automaticky obnovit, když je detekován IQ2 nebo EXP v režimu DFU.
Websocket Server Enable – Povolí nebo zakáže rozšíření pro spuštění Websocket Server.
Websocket Server Host Address – Nastavuje hostitelskou adresu serveru Websocket.
Websocket Server Port – Nastavuje číslo portu serveru Websocket

Užitečné informace o přístupu a nastavení uživatelského nastavení VEX v tomto článku.