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ů.
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.
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í 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.
-
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).
-
VEX DEVICE INFO
Kategorie VEX DEVICE INFO nám poskytuje přehled připojených 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 chytrý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.
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.
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.
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í.
-
Interaktivní terminál - Interaktivní terminál má dvě funkce – zobrazování tiskových protokolů a odesílání nezpracovaných úhozů zpět do uživatelského programu.
Poznámka: Pro využití 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.
Poznámka: Interaktivní terminálový výstup se po vytvoření a stažení uživatelského programu standardně smaž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.
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ří:
-
Device Picker - Device Picker zobrazuje ikonu připojeného zařízení VEX (ikonu mozku
nebo ikonu ovladače
)
Poznámka: Pokud je ovladač připojen k počítači, ale nemá rádiové spojení s mozku, nebude vedle ikony ovladače zobrazen žá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.
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.