Översikt över VS Code-gränssnittet för IQ – VEX bibliotek

Den här artikeln är en översikt över VEX Visual Studio Code Extension UI (användargränssnitt). Tillägget stöder utveckling av C++- och Python-projekt för VEX IQ 2nd Generation-, EXP- och V5-plattformar.

Skärmdump som visar den kompletta VEX VS Code UI-layouten. Aktivitetsfältet och sidofältet finns på vänster sida av skärmen, verktygsfältet och terminalen finns längst ner på skärmen och redigeraren fyller resten av skärmen.

UI-komponenter

Det finns tre huvudkomponenter i VEX VS Code Extension.

Verktygsfält
Aktivitetsstång och sidostång
Terminalpanel

Verktygsfält

Verktygsfältet ger användarna ett snabbt sätt att interagera med VEX VS Code -tilläggsprojekt, VEX Brains och VEX Controllers. Verktygsfältet är bara aktivt när ett giltigt VEX-projekt är öppet i VS Code. Ett giltigt VEX-projekt är ett projekt som skapas eller importeras av tillägget. Det är inte giltigt att öppna ett VEXcode- eller VEXcode Pro-projekt och måste importeras.

VS Code-verktygsfält med VEX-tilläggsikoner som kan användas för att snabbt interagera med anslutna VEX-enheter och projekt. VEX-funktionerna inkluderar enhetsväljaren, platsväljaren, nedladdningsikonen för Bygg & , uppspelningsikonen, stoppikonen, projektväljaren och Python-filväljaren.

Enhetsväljare

Ikonen för enhetsväljaren är markerad i VS Code-verktygsfältet. I det här exemplet står det VEX_EXP.

Enhetsväljaren har två huvudfunktioner. Först visas en hjärn- eller kontrollikon som representerar den anslutna VEX-enhetstypen.

VS-kodsökfält med en snabbvalslista över alla anslutna VEX-enheter. I det här exemplet finns en V5 Brain, en V5 Controller och en EXP Controller listade.

För det andra, när man klickar på ikonen för enhetslistan visas en snabbvalslista med alla anslutna VEX-enheter. Användaren kan välja vilken enhet tillägget ska ansluta till.
Den för närvarande anslutna enheten visas alltid högst upp i listan följt av alla andra enheter sorterade efter enhetstyp (Brain eller Controller) och plattform (IQ 2nd Generation, EXP och V5).

VS Code-sökfält med ett objekt i snabbvalslistan som visas för att ge detaljer. Objektet läser MyBrain, V5 Brain, User COM8, Comm COM7.

Varje enhetsobjekt innehåller information om hjärnans namn, plattform, enhetstyp och enhetssökväg.

VS Code-sökfält med ett objekt i snabbvalslistan som visas för att ge detaljer. Föremålet är en V5-kontroll, men bakgrunden är gråtonad och det finns inget hjärnnamn listat. Detta indikerar att den här kontrollanten inte har någon radiolänk till en hjärna.

V5-kontrollenhet med blå bakgrund indikerar att denna kontrollenhet har en radiolänk till en hjärna.

Viktig

Om en styrenhet är ansluten till en dator, men inte har en radiolänk till en hjärna, kommer inget hjärnnamn att visas bredvid listobjektet eller ikonen för enhetslistans statusfält.

Platsväljare

Platsväljarikonen är markerad i VS-kodens verktygsfält. I det här exemplet står det Plats 1.

Ikonen för platsväljare låter användaren välja vilken plats tillägget ska ladda ner eller spela upp ett användarprogram på.

VS-kodsökfält med en snabbvalslista över alla tillgängliga platser på den anslutna VEX Brain. I det här exemplet finns det åtta tillgängliga platser.

När du klickar på ikonen för platsväljare visas en snabbvalslista med de tillgängliga användarprogramplatserna 1–8.

Bygg/Ladda ner

Bygg-ikonen. Nedladdningsikon.

Ikonen Bygg/Ladda ner ändrar funktion om en VEX Brain eller en VEX Controller är ansluten.

Bygg-ikonen.

Om en VEX-enhet inte är ansluten visas byggikonen. När du klickar på den kommer projektet bara att byggas.

Nedladdningsikon.

Om en VEX-enhet är ansluten visas nedladdningsikonen. När du klickar på den kommer projektet att byggas och om det lyckas laddas ner till VEX-enheten.

Spela

Spela upp-ikonen.

När du klickar på uppspelningsikonen körs användarprogrammet i den valda platsen.

Stopp

Stopp-ikonen.

När du klickar på stoppikonen stoppar den ett användarprogram.

Vald arbetsyta

Projektväljaren visas i VS Code-verktygsfältet. I det här exemplet läser den EXPTestProject.

VS Code stöder projekt med flera arbetsytor. Projektväljaren låter användare växla mellan VEX-projekt när det finns flera i arbetsytan.

VS-kodsökfält med en snabbvalslista över sparade VEX-projekt. I det här exemplet finns det ett Python-projekt och ett C++-projekt listat.

När du klickar på projektväljarikonen visas en snabbvalslista med alla giltiga projekt.

Viktigt
Om ett projekt inte är giltigt visas det inte i projektets snabbvalslista. Ett projekt är inte giltigt om det inte har skapats eller importerats av VEX VS Code Extension.

Ikonen för Python-filväljaren visas i VS Code-verktygsfältet. I det här exemplet står det main.py.

Python-filväljare (endast Python)
När ett VEX Python-projekt väljs visas Python-filväljaren i verktygsfältet. Python för VEX stöder för närvarande endast nedladdningar av enskilda filer.

VS Code-sökfält med en snabbvalslista över alla Python-filer i detta VEX-projekt. I det här exemplet finns det tre Python-filer, var och en på en annan filplats.

När man klickar på ikonen visas en snabbvalslista med alla python-filer som finns i arbetsytekatalogen.
Python-filväljaren låter användaren växla mellan python-källfiler (.py)

VEX aktivitetsfält och sidofält

Skärmdump som visar VS Code-aktivitetsfältet och sidofältet öppna i VEX-vyn. VEX View har alternativ för att skapa och importera projekt ovan, VEX-enhetsinfo-menyn nedan och en feedbackmeny längst ner.

Projekt Åtgärder

Avsnittet Projektåtgärder i VEX-tilläggsvyn. Det här avsnittet har två knappar som läser Nytt projekt och Importera projekt.

Vex-aktivitetsfältet innehåller vyn Projektåtgärder och vyn VEX-enhetsinformation.

Projektåtgärdsvyn används för att skapa ett nytt projekt eller importera ett befintligt VEXcode- eller VEXcode Pro-projekt.

För mer information om att skapa ett nytt projekt, kolla in den här artikeln!

Versionsinformation visas också i vyns nedre vänstra och högra hörn.

Viktigt
Om ett VEXcode- eller VEXcode Pro-projekt är öppet i redigeraren kommer det inte att betraktas som ett giltigt VEX-projekt. Projektet måste importeras med hjälp av knappen Importera i VEX-sidofältet.

VEX-enhetsinformation

Avsnittet VEX-enhetsinformation i VEX-tilläggsvyn visas med en lista över alla anslutna enheter och specifik information om var och en. I det här exemplet visas en IQ-hjärna (2:a generationen) och dess nedladdade program. I listan Kontroller står det Kontroller, inte länkad.

VEX-enhetsinfovyn ger användaren en översikt över den anslutna VEX Brain eller VEX-styrenheten. VEXos-version, serieportens sökväg, användarprogram och enhetsinformation finns alla i den här vyn. Andra funktioner som uppdateringar av VEXos firmware, skärmdumpar, inställning av hjärnnamn och teamnummer kan också utföras via den här vyn.

Systeminformation

Systemmappen och dess innehåll visas och markeras under Brain-mappen. Systemmappen innehåller data om hjärnan, och informationen läser VEXos 1.0.1.0, namn VEX_EXP, team 000000, id 0EC83725 och Python 1.0.0.7.

Systeminformationen ger en kort översikt över en ansluten VEX-enhet. Detta inkluderar en enhets VEXos-version, Brain-namn, teamnummer, Brain-ID och information om Python-körtidsversionen.

Information om serieport

Mappen Seriell port och dess innehåll visas under mappen Brain. Mappen Seriell port innehåller data om hjärnans trådbundna anslutning. Denna data läser kommunikation COM167, användare COM168.

Seriell portinformation visar enhetssökvägen för varje port som är tillgänglig för en VEX-enhet. De flesta VEX-enheter räknas upp som två seriella portar. Den seriella kommunikationsporten används för att ladda ner program och styra hjärnans funktioner. Användarens serieport används för att överföra data mellan användarappen som körs på Brain och värddatorn som är ansluten via USB. V5-styrenheten är den enda VEX-enheten som bara har en seriell kommunikationsport och ingen seriell användarport.

Programinformation

Programmappen och dess innehåll visas under Brain-mappen. Programmappen visar alla nedladdade VEX-projekt på Brain. I det här exemplet finns fyra C/C++-program nedladdade till den anslutna hjärnan.

Programinformation visar en lista över alla nedladdade användarprogram på en VEX Brain.

Programmappen och dess innehåll visas under Brain-mappen, nu med den första projektets mapp öppen för att visa dess innehåll. Projektmappen visar data om plats, fil, typ, storlek och tid.

Varje programlista kan utökas för att visa ytterligare information om varje användarprogram, såsom platsens plats, filnamn, språktyp, filstorlek och nedladdningstid.

Enhetsinformation

Mappen Enheter och dess innehåll visas under mappen Hjärna. Mappen Enheter visar alla enheter som är anslutna till hjärnan. I det här exemplet finns 6 enheter listade, inklusive 4 motorer, en 3-trådig och en intern radio.

Enhetsinformation visar en lista över alla smarta portenheter som är anslutna till en VEX Brain. Varje listobjekt visar smartportnumret och enhetstypen.

Mappen Enheter och dess innehåll visas under mappen Hjärna. I det här exemplet har en Motor-enhet valts och dess innehåll är Typ Motor, Version 1.0.0.4, Boot 1.0.2.0.

Varje objekt i enhetslistan kan utökas för att visa information om firmwareversion för varje smartport-enhet.

Status för länkad styrenhet visas när den är ansluten till VEX Brain-enheten.

Kontrollern finns listad under mappen Enheter. Denna Controller läser Controller, länkad.

VEX Brain är kopplad till en VEX-styrenhet

Kontrollern finns listad under mappen Enheter. Denna Controller läser Controller, inte länkad.

VEX Brain är inte kopplad till en VEX-styrenhet

Kontrollern finns listad under mappen Enheter. Denna Controller läser Controller, tethered.

VEX V5-styrenheten är ansluten till en VEX V5 Brain

Skärmdumpar

Markören svävar över mappen VEX Device Indicator och en kameraikon visas bredvid den.

Genom att klicka på kameraikonen kan en användare ta och ladda ner en skärmdump från en VEX Brain.
Skärmdumpar är endast tillgängliga när den är direkt ansluten till en VEX Brain via USB.

Batteriläkare (endast V5 Brain)

Markören svävar över mappen V5 Brain VEX Device Indicator och en Battery Medic-ikon visas bredvid den.

Genom att klicka på hjärtikonen kommer tillägget att ladda ner och köra användarprogrammet för batterimedicin.

Ange hjärnnamn

Markören svävar över alternativet Namn i systemmappen och det visas en pennikon bredvid den.

Genom att klicka på pennikonen bredvid system->namnet kan en användare ange namnet för en VEX-hjärna.

Ställ in fönstret Brain Name med ett textfält och ett meddelande nedanför som lyder Tryck på Enter för att bekräfta din inmatning eller Escape för att avbryta.

Efter att du har klickat på pennikonen visas en inmatningsruta högst upp i VS Code-redigeraren. Skriv det nya hjärnnamnet i inmatningsrutan och tryck på Enter för att ställa in.

Ange lagnummer

Markören svävar över alternativet Team i systemmappen och det visas en pennikon bredvid den.

Genom att klicka på pennikonen bredvid system->teamet kan en användare ange teamnumret för en VEX Brain.

Fönster för ange teamnummer med ett textfält och ett meddelande nedanför som lyder Tryck på Enter för att bekräfta din inmatning eller Escape för att avbryta.

Efter att du klickat på pennikonen visas en inmatningsruta högst upp i VS Code-redigeraren. Skriv det nya lagnumret i inmatningsrutan och tryck på Enter för att bekräfta.

Radera användarprogram

Markören svävar över ett program i programmappen och det visas en papperskorgen-ikon bredvid den.

Genom att klicka på Papperskorgen ikonen bredvid program->projektnamnet kan en användare radera ett program i en specifik plats. VIKTIGT, när du har raderat ett program kan det inte återställas. Var försiktig när du använder den här funktionen.

Varningar om enhetsinformation

VEXos-uppdatering

Ikonen för Brain-mapp och ikonen för VEX-enhetsindikatorn visas i orange, och det finns en varningssymbol bredvid systemets VEXos-version. Dessa tecken indikerar att hjärnans VEXos-version är föråldrad.

När en VEX Brains VEXos-version är föråldrad visas en varningsmeddelandeikon bredvid VEXos-versionen och båda Brain-ikonerna blir gula.

För att åtgärda den här varningen bör en användare uppdatera VEXos för sin VEXos Brain.

Markören svävar över den föråldrade Brain-mappen och det visas en uppåtpil bredvid den.

VEXos kan uppdateras genom att klicka på uppåtpilen bredvid VEX Brain-ikonen.

Uppdatera VEXos-meddelandefönstret med ett meddelande som lyder VEXos-uppdatering tillgänglig: 1.0.1.0. Källa, VEX-tillägg. Nedan finns två knappar som heter Uppdatera och Ignorera.

En meddelanderuta visas också i det nedre högra hörnet av VS Code-redigeraren när VEXos är föråldrad. En användare kan starta en VEXos-uppdatering genom att klicka på knappen ”Uppdatera” eller klicka på knappen ”Ignorera” för att hoppa över VEXos-uppdateringen.

Hjärnan är inte kopplad till ansluten kontrollenhet

Mappen Brain under VEX Device Indicator-mappen har en orange ikon och lyder Brain, inte länkad. Dessa tecken indikerar att det inte finns någon VEX-hjärna ansluten.

VEX-styrenhetens ikon blir gul när en VEX-styrenhet är ansluten till en dator, men inte är länkad till en VEX Brain.

För att åtgärda denna varning bör en användare länka en VEX-styrenhet till en VEX Brain

Terminalpanel

VEX VS Code Extension tillhandahåller två terminaler vid start, loggterminalen och den interaktiva terminalen.

VS-kodterminalfönstret är öppet och visar VEX-loggterminalen och VEX interaktiva terminalen.

Loggterminal

VS-kod VEX-loggterminalen öppnas och visar historiken över VEX-tilläggets användning. I det här exemplet finns det meddelanden som lyder Logg, Windows-version för plattformen vexexp, Ladda ner användarprogram och Nedladdning klar.

Loggterminalen visar byggutdata, byggfel och nedladdningsresultat.

Interaktiv terminal

VS Code VEX Interactive Terminal öppnas och visar ett meddelande som lyder Hej världen.

Den interaktiva terminalen har två funktioner, att visa printf-loggar och att skicka råa tangenttryckningar tillbaka till ett användarprogram. För att kunna dra nytta av den interaktiva terminalen måste en hjärna eller styrenhet vara ansluten till en dator som kör VEX VS Code Extension. Utdata från interaktiv terminal rensas som standard efter att ett användarprogram har skapats och laddats ner.

Användarinställningar

Användarinställningar är globala inställningar som Visual Studio-kod erbjuder för varje tillägg. Användarinställningar tillämpas på alla VEX VS Code-tilläggsprojekt.

VS-kodens användarinställningar öppnas på VEX-sidan där beteendet hos VEX Robotics Extension kan anpassas.

Så här får du åtkomst till VEX användarinställningar

Inställningsikonen längst ner i VS Code-aktivitetsfältet, som finns i skärmens nedre vänstra hörn.

Klicka på kugghjulet i vänster hörn av VS Code så visas en kontextmeny.

VS-kodinställningarnas snabbmeny med många listade alternativ. Ett alternativ som läser Inställningar är markerat och är det tredje alternativet i menyn, under Kommandopalett och profiler.

I snabbmenyn klickar du på alternativet "Inställningar" så visas en inställningssida.

Fönstret VS-kodinställningar är öppet och kategorin Tillägg är markerad i den vänstra navigeringslistan.

I listvyn till vänster klickar du på alternativet "Tillägg". Scrolla sedan ner till botten och hitta objektet som är märkt "VEX".

Fönstret VS-kodinställningar är öppet och länken till VEX-sidan i kategorin Tillägg är markerad.

Klicka på listobjektet ”VEX”.

VS-kodens användarinställningar öppnas på VEX-sidan där beteendet hos VEX Robotics Extension kan anpassas.

VEX-användarinställningarna visas i den högra panelen.

Översikt över inställningar

Styrenhetskanal (endast V5-styrenhet)

Inställningen Controller Channel styr radiokommunikationskanaltypen mellan en V5 Brain och en V5 Controller.
Denna inställning gäller endast när VS Code är ansluten till en V5 Controller via USB och regulatorn är ansluten till en V5 Brain via VEXnet. Användaren kan välja mellan nedladdningskanaler och Pit -kanaler. När den är inställd på Ladda ner, hoppar radion till en nedladdningsbar VEXnet-kanal när en nedladdning av ett användarprogram påbörjas. Nedladdningskanalen möjliggör högre datahastigheter och effektivare nedladdningar. När den är inställd på för Pitkommer radion att förbli på en pitkanal och nedladdningen tar mycket längre tid. Som standard är den här inställningen inställd på Ladda ner.

VEX användarinställningar med alternativet Styrenhetskanal visat. Det här alternativet har en rullgardinsmeny som är inställd på Ladda ner som standard. Beskrivningen lyder Ställer in V5-styrenhetens radiokanal.

Cpp-projektets SDK-hemsida

REDIGERA INTE DENNA INSTÄLLNING.

Cpp-verktygskedjans sökväg

Cpp Verktygskedja Sökväg anger sökvägen för verktygskedjan som används när ett C++ VEX VS Code projekt bygger.

VEX-användarinställningar med Cpp-verktygskedjan: Sökvägsalternativet visas. Det här alternativet har ett textfält som representerar en filsökväg.

Aktivera användarterminalen

Inställningen Aktivera användarterminal tillåter tillägget att öppna användarens seriella port när en VEX Brain eller VEX-styrenhet detekteras av tillägget. Det enda undantaget gäller en V5-kontroller som inte räknar upp en användarens serieport.

VEX användarinställningar med alternativet Allmänt aktivera användarterminal visas. Det här alternativet har en rullgardinsmeny som är inställd på Aktivera som standard. Beskrivningen lyder Aktivera tillägget för att öppna och visa data från användarporten.

Aktivera tillåter tillägget att ansluta till en användarport vid start och skapar den interaktiva terminalen. Om aktivera väljs medan tillägget körs, kommer tillägget att försöka öppna användarporten om en enhet är ansluten.
Inaktivera förhindrar att tillägget ansluter till användarporten vid start och skapar inte en interaktiv terminal. Om inaktivera väljs medan tillägget körs stänger tillägget användarporten och tar bort den interaktiva terminalen.

Projektbyggnadstyp

Projektbyggtyp anger hur tillägget ska bygga ett C++-projekt. Användaren kan ställa in byggtypen till Bygg eller Ombygg.
Bygg bygg endast projektet när Make upptäcker några ändringar i projektets källkod.
Ombygg rensar projektets byggkatalog och bygger sedan projektet. Det här alternativet är normalt sett mycket långsammare.

VEX-användarinställningar med alternativet Projektbyggtyp visat. Det här alternativet har en rullgardinsmeny som är inställd på Bygg som standard. Beskrivningen lyder Ange Cpp-projektets byggtyp.

Projekt Hem

Projekt Startsida anger standardhemkatalogen för ett nytt projekt när guiden Nytt projekt slutförs.

VEX användarinställningar med alternativet Projekt Hem visat. Det här alternativet har ett textfält som representerar en filsökväg. Beskrivningen lyder Anger standardplatsen för nya projekt.

Kör efter nedladdning

Kör efter nedladdning När den är aktiverad körs användarprogrammet efter att det har laddats ner till en VEX Brain.

VEX-användarinställningar med alternativet Projektkörning efter nedladdning visat. Det här alternativet har en kryssruta som visas som markerad i det här exemplet. Beskrivningen lyder Ange om användarprogrammet ska köras efter nedladdning.

Python SDK-hemsida

REDIGERA INTE DENNA INSTÄLLNING.

VEX-användarinställningar med Python SDK Home-alternativet visat. Det här alternativet har en länk som läser Redigera i settings.json. Beskrivningen lyder REDIGERA INTE.

Hjälp med VEX-kommandot

VEX Command Help ger åtkomst till dokumentation för specifika funktioner som ingår i C++ och Python API (Application Programming Interface). Dokumentationen är specifik för varje VEX-plattform (IQ 2:a generationen, EXP, V5).

C++-kommandot i VS Code-redigeraren har markerats med markören.

För att komma åt VEX-kommandohjälpen, markera först texten för den funktion som du vill söka efter.

Kontextmenyn för C++-kommandot har öppnats och hjälpalternativet för VEX-kommandot är markerat.

Högerklicka på den markerade texten så visas en kontextmeny.
Klicka sedan på VEX-kommandohjälpen för att komma åt dokumentationen.

Hjälpsidan för VEX-kommandot är öppen och visar information om och exempel på C++-kommandot Brain Screen Print.

Om VEX Command Help hittar en exakt matchning visas en ny webbvy med relevant dokumentation.

VS-kodsökfält med en snabbvalslista med matchande VEX C++-kommandon i VEX-kommandohjälpen för att begränsa användarens sökning.

Om flera dokument matchar den valda texten visas en rullgardinsmeny med en filtrerad lista över relevant dokumentation.