Översikt över VS-kodgränssnittet för V5 – 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 av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare för att förbättra deras kodningsupplevelse.

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.

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, med markerade avsnitt för enkel navigering och användning.

Enhetsväljare

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för användare för att förbättra deras utvecklingsupplevelse.

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

Skärmdump av V5 VS Code Extension-gränssnittet, som visar funktioner och verktyg som är tillgängliga för utvecklare som använder VEX Robotics-plattformen.

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).

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som finns tillgängliga för att förbättra utvecklingsarbetsflöden.

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

Skärmdump av VS Code Extension för V5, som visar gränssnittet och funktionerna som är utformade för att förbättra kodningseffektiviteten och stödet för V5-utveckling.

Skärmdump av VS Code-tilläggsgränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodavsnitt, felsökningsalternativ och projektledningsfunktioner.

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

Skärmdump av V5 VS Code Extension-gränssnittet, som visar funktioner och verktyg som är tillgängliga för V5-utveckling, inklusive kodavsnitt och felsökningsalternativ.

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å.

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för V5-utveckling, inklusive kodavsnitt och projektledningsalternativ.

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

Bygg/Ladda ner

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, med fokus på att förbättra produktivitet och kodhantering.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, med fokus på att förbättra produktivitet och kodhantering.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodredigeringsalternativ och projektledningsfunktioner.

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

Skärmdump av VS Code Extension för V5, som visar dess användargränssnitt och funktioner, inklusive kodredigeringsverktyg och VEX-robotintegration.

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

Stopp

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare som använder V5-plattformen.

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

Vald arbetsyta

Skärmdump av VS Code Extension för V5, som visar dess användargränssnitt och funktioner, inklusive kodredigeringsverktyg och V5-kategorialternativ, utformade för att förbättra utvecklingsupplevelsen.

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.

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner som är relevanta för V5-kategoribeskrivningen, inklusive kodredigeringsverktyg och alternativ för utvecklare.

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.

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive alternativ för kodredigering och felsökning.

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.

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive alternativ för kodredigering och felsökning.

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 av VS Code Extension för V5, som visar dess användargränssnitt och funktioner relaterade till V5-kategoribeskrivningen, inklusive kodredigeringsverktyg och navigeringsalternativ.

Projekt Åtgärder

Skärmdump av V5 VS Code Extension-gränssnittet, som visar funktioner och funktioner för att förbättra kodningsupplevelsen med VEX-robotar.

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

Skärmdump av VS Code Extension för V5, som visar dess gränssnitt och funktioner, inklusive kodredigeringsverktyg och V5-specifika funktioner. Skärmdump av VEX V5 Code Extension-gränssnittet i Visual Studio Code, som visar viktiga funktioner och alternativ som är tillgängliga för programmering av V5-robotsystem.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare i V5-kategorin.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodavsnitt och felsökningsalternativ.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare som arbetar med V5-projekt.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodavsnitt och integrationsalternativ.

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

Skärmdump av V5 VS Code Extension-gränssnittet, som visar funktioner och verktyg som är tillgängliga för V5-utveckling, inklusive kodavsnitt och konfigurationsalternativ.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare som arbetar med V5-projekt.

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.

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare som arbetar med VEX Robotics, inklusive alternativ för kodredigering och felsökning.

VEX Brain är kopplad till en VEX-styrenhet

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och funktionaliteter som är relevanta för utvecklare som använder V5-plattformen.

VEX Brain är inte kopplad till en VEX-styrenhet

Skärmdump av VS Code Extension-gränssnittet för V5, som visar viktiga funktioner och verktyg som är tillgängliga för utvecklare för att förbättra deras kodningsupplevelse.

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

Skärmdumpar

Skärmdump av VS Code Extension-gränssnittet för V5, som visar olika funktioner och verktyg som är tillgängliga för utvecklare för att förbättra deras kodningsupplevelse.

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)

Skärmdump av VS Code Extension för V5, som visar dess gränssnitt och funktioner, inklusive kodredigeringsverktyg och VEX-robotintegrationsalternativ.

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

Ange hjärnnamn

Skärmdump av VS Code Extension för V5, som visar användargränssnittet och funktionerna som är utformade för att förbättra kodningseffektiviteten och projektledningen inom VEX-robotutveckling.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för VEX-robotprogrammering, inklusive kodredigering och felsökningsalternativ.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare som arbetar med V5-projekt.

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

Skärmdump av VS Code Extension för V5, som visar användargränssnittet och funktioner som är relevanta för V5-kategoriutveckling, inklusive kodredigeringsverktyg och integrationsalternativ.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodredigeringsalternativ och projektledningsfunktioner.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodredigeringsalternativ och integrationsfunktioner.

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.

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och funktionalitet för att förbättra kodningsupplevelsen, inklusive menyer och verktygsalternativ.

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

Skärmdump av VS Code Extension för V5, som visar dess användargränssnitt och funktioner, inklusive kodredigeringsverktyg och integrationsalternativ för en förbättrad utvecklingsupplevelse.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodavsnitt och projektledningsalternativ.

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.

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodavsnitt och projektledningsalternativ.

Loggterminal

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för V5-utveckling, inklusive alternativ för kodredigering och felsökning.

Loggterminalen visar byggutdata, byggfel och nedladdningsresultat.

Interaktiv terminal

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för VEX-robotutveckling, inklusive kodredigering och felsökningsalternativ.

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.

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodavsnitt och projektledningsalternativ.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och alternativ som är tillgängliga för användare för att förbättra sin kodningsupplevelse med VEX-robotik.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare i V5-kategorin.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodredigeringsalternativ och VEX-specifika funktioner.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodredigeringsalternativ och projektledningsfunktioner.

Klicka på listobjektet ”VEX”.

Skärmdump av VS Code Extension för V5, som visar funktioner som är relevanta för V5-kategoribeskrivningen, inklusive användargränssnittselement och kodavsnitt.

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.

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare som arbetar med V5-projekt.

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.

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodavsnitt, felsökningsalternativ och projektledningsverktyg.

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.

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive alternativ för kodredigering och felsökning.

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.

Skärmdump av VS Code Extension för V5, som visar dess gränssnitt och funktioner, utformat för att förbättra kodningseffektiviteten och effektivisera utvecklingsprocesser för användare som arbetar med V5-projekt.

Projekt Hem

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive alternativ för kodredigering och felsökning.

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.

Skärmdump av VS Code Extension för V5, som visar dess användargränssnitt och funktioner, inklusive kodredigeringsverktyg och VEX-specifika funktioner.

Python SDK-hemsida

REDIGERA INTE DENNA INSTÄLLNING.

Skärmdump av V5 VS Code Extension-gränssnittet, som visar funktioner och verktyg som är tillgängliga för V5-utveckling, inklusive kodavsnitt och projektledningsalternativ.

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).

Skärmdump av VS Code Extension för V5, som visar dess användargränssnitt och funktioner, inklusive kodredigeringsverktyg och integrationsalternativ för VEX-robotprogrammering.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodavsnitt och felsökningsalternativ.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodavsnitt och projektledningsalternativ.

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

Skärmdump av VS Code Extension-gränssnittet för V5, som visar funktioner och verktyg som är tillgängliga för utvecklare, inklusive kodavsnitt och projektledningsalternativ.

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