VS Code UI-overzicht voor V5 – VEX-bibliotheek

Dit artikel is een overzicht van de VEX Visual Studio Code Extension UI (gebruikersinterface). De extensie ondersteunt de ontwikkeling van C++- en Python-projecten voor VEX IQ 2e generatie-, EXP- en V5-platforms.

Schermafbeelding van de VS Code Extension-interface voor V5, met functies en hulpmiddelen waarmee ontwikkelaars hun codeerervaring kunnen verbeteren.

UI-componenten

Er zijn 3 belangrijke componenten in de VEX VS Code Extension.

Werkbalk
Activiteitenbalk en zijbalk
Terminalpaneel

Werkbalk

De werkbalk biedt gebruikers een snelle manier om te communiceren met VEX VS Code -uitbreidingsprojecten VEX Brains en VEX Controllers. De werkbalk is alleen actief als er een geldig VEX-project geopend is in VS Code. Een geldig VEX-project is een project dat door de extensie is gemaakt of geïmporteerd. Het openen van een VEXcode- of VEXcode Pro-project is niet geldig en moet worden geïmporteerd.

Schermafbeelding van de VS Code Extension-interface voor V5, met de functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars, met gemarkeerde secties voor eenvoudige navigatie en gebruik.

Apparaatkiezer

Schermafbeelding van de VS Code Extension-interface voor V5, met functies en hulpmiddelen waarmee gebruikers hun ontwikkelervaring kunnen verbeteren.

De apparaatkiezer heeft twee hoofdfuncties. Ten eerste wordt er een hersen- of controllerpictogram weergegeven dat het aangesloten VEX-apparaattype vertegenwoordigt.

Screenshot van de V5 VS Code Extension-interface, met de functies en tools die beschikbaar zijn voor ontwikkelaars die het VEX Robotics-platform gebruiken.

Ten tweede, wanneer op het apparaatlijstpictogram wordt geklikt, verschijnt er een snelle keuzelijst met alle aangesloten VEX-apparaten. De gebruiker kan selecteren met welk apparaat de extensie verbinding zal maken.
Het huidige verbonden apparaat verschijnt altijd bovenaan de lijst, gevolgd door alle andere apparaten, gesorteerd op apparaattype (Brain of Controller) en platform (IQ 2e generatie, EXP en V5).

Schermafbeelding van de VS Code Extension-interface voor V5, met functies en hulpmiddelen die beschikbaar zijn voor het verbeteren van ontwikkelworkflows.

Elk apparaatitem bevat informatie over de hersennaam, het platform, het apparaattype en het apparaatpad.

Screenshot van de VS Code-extensie voor V5, met de interface en functies die zijn ontworpen om de coderingsefficiëntie en ondersteuning voor V5-ontwikkeling te verbeteren.

Schermafbeelding van de VS Code-extensie-interface voor V5, met een overzicht van de functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars, waaronder codefragmenten, foutopsporingsopties en projectbeheerfuncties.

Belangrijk

Als een controller op een computer is aangesloten, maar geen radioverbinding met de hersenen heeft, wordt er geen hersennaam weergegeven naast het statusbalkpictogram van het lijstitem of de apparaatlijst.

Slotkiezer

Schermafbeelding van de interface van V5 VS Code Extension, met een overzicht van de functies en hulpmiddelen die beschikbaar zijn voor V5-ontwikkeling, waaronder codefragmenten en foutopsporingsopties.

Met het slotselectiepictogram kan de gebruiker kiezen op welk slot de extensie een gebruikersprogramma downloadt of afspeelt.

Schermafbeelding van de VS Code Extension-interface voor V5, met een overzicht van de functies en hulpmiddelen die beschikbaar zijn voor V5-ontwikkeling, waaronder codefragmenten en opties voor projectbeheer.

Wanneer op het slotselectiepictogram wordt geklikt, verschijnt er een snelle keuzelijst met de beschikbare gebruikersprogrammaslots 1-8.

Bouwen/downloaden

Schermafbeelding van de VS Code Extension-interface voor V5, met een overzicht van de functies en hulpmiddelen voor ontwikkelaars, met de nadruk op het verbeteren van de productiviteit en het beheer van de code.

Het Build/Download-pictogram verandert van functie als een VEX Brain of een VEX Controller is aangesloten.

Als er geen VEX-apparaat is aangesloten, wordt het build-pictogram weergegeven. Wanneer erop wordt geklikt, wordt het project alleen maar gebouwd.

Schermafbeelding van de VS Code Extension-interface voor V5, met een overzicht van de functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars, waaronder opties voor codebewerking en functionaliteiten voor projectbeheer.

Als er een VEX-apparaat is aangesloten, wordt het downloadpictogram weergegeven. Wanneer erop wordt geklikt, wordt het project gebouwd en, indien succesvol, gedownload naar het VEX-apparaat.

Toneelstuk

Screenshot van de VS Code-extensie voor V5, met een demonstratie van de gebruikersinterface en functies, waaronder codebewerkingshulpmiddelen en VEX-robotica-integratie.

Als u op het afspeelpictogram klikt, wordt het gebruikersprogramma in het geselecteerde slot uitgevoerd.

Stop

Schermafbeelding van de VS Code Extension-interface voor V5, met een overzicht van de functies en tools die beschikbaar zijn voor ontwikkelaars die het V5-platform gebruiken.

Als u op het stoppictogram klikt, stopt een gebruikersprogramma.

Geselecteerde werkruimte

Screenshot van de VS Code-extensie voor V5, met een demonstratie van de gebruikersinterface en functies, waaronder codebewerkingshulpmiddelen en V5-categorieopties, die zijn ontworpen om de ontwikkelervaring te verbeteren.

VS Code ondersteunt projecten met meerdere werkruimten. Met de projectkiezer kunnen gebruikers schakelen tussen VEX-projecten als er meerdere binnen de werkruimte bestaan.

Schermafbeelding van de VS Code Extension-interface voor V5, met functies en functionaliteiten die relevant zijn voor de beschrijving van de V5-categorie, waaronder hulpmiddelen en opties voor codebewerking voor ontwikkelaars.

Wanneer op het projectkiezerpictogram wordt geklikt, verschijnt er een snelle keuzelijst met alle geldige projecten.

Belangrijk
Als een project niet geldig is, wordt het niet getoond in de projectsnelkeuzelijst. Een project is niet geldig tenzij het is gemaakt of geïmporteerd door de VEX VS Code -extensie.

Schermafbeelding van de VS Code Extension-interface voor V5, met een overzicht van de functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars, waaronder codebewerking en foutopsporingsopties.

Python-bestandskiezer (alleen Python)
Wanneer een VEX Python-project is geselecteerd, verschijnt de Python-bestandskiezer in de werkbalk. Python voor VEX ondersteunt momenteel alleen het downloaden van afzonderlijke bestanden.

Wanneer op het pictogram wordt geklikt, verschijnt er een snelle keuzelijst met alle Python-bestanden in de werkruimtemap.
Met de Python-bestandskiezer kan de gebruiker schakelen tussen Python-bronbestanden (.py)

VEX-activiteitenbalk en zijbalk

Screenshot van de VS Code-extensie voor V5, met de gebruikersinterface en functies die verband houden met de categoriebeschrijving van V5, inclusief hulpmiddelen voor codebewerking en navigatieopties.

Projecten Acties

Screenshot van de V5 VS Code Extension-interface, met functies en functionaliteiten voor het verbeteren van de codeerervaring met VEX-robotica.

De vex-activiteitenbalk bevat de weergave Projectacties en de weergave VEX-apparaatinfo.

De weergave Projectacties wordt gebruikt voor het maken van een nieuw project of het importeren van een bestaand VEXcode- of VEXcode Pro-project.

Voor meer informatie over het aanmaken van een nieuw project, bekijk artikel!

Versie-informatie wordt ook weergegeven in de linker- en rechterbenedenhoek van de weergave.

Belangrijk
Als een VEXcode- of VEXcode Pro-project geopend is in de editor, wordt het niet als een geldig VEX-project beschouwd. Het project moet worden geïmporteerd met behulp van de knop Importeren in de VEX-zijbalk.

VEX-apparaatinfo

Screenshot van de VS Code-extensie voor V5, met een demonstratie van de interface en functies, waaronder codebewerkingshulpmiddelen en V5-specifieke functionaliteiten. Schermafbeelding van de VEX V5 Code Extension-interface in Visual Studio Code, met de belangrijkste functies en opties voor het programmeren van V5-roboticasystemen.

De VEX Device Info-weergave geeft de gebruiker een overzicht van de aangesloten VEX Brain of VEX Controller. VEXos-versie, seriële poortpad, gebruikersprogramma en apparaatinformatie zijn allemaal te vinden in deze weergave. Andere functies zoals VEXos-firmware-updates, schermafbeeldingen, het instellen van de hersennaam en het instellen van het teamnummer kunnen ook via deze weergave worden uitgevoerd.

Systeem informatie

Schermafbeelding van de VS Code Extension-interface voor V5, met een overzicht van de functies en tools die beschikbaar zijn voor ontwikkelaars in de V5-categorie.

De systeeminformatie geeft een kort overzicht van een aangesloten VEX-apparaat. Dit omvat de VEXos-versie van een apparaat, Brain-naam, teamnummer, Brain ID en informatie over de runtime-versie van Python.

Seriële poortinformatie

Schermafbeelding van de VS Code Extension-interface voor V5, met een overzicht van de functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars, waaronder codefragmenten en foutopsporingsopties.

Seriële poortinformatie toont het apparaatpad voor elke poort die beschikbaar is voor een VEX-apparaat. De meeste VEX-apparaten tellen als twee seriële poorten. De seriële communicatiepoort wordt gebruikt om programma's te downloaden en de hersenfuncties te besturen. De seriële poort van de gebruiker wordt gebruikt om gegevens over te dragen tussen de gebruikersapp die op de Brain draait en de hostcomputer die via USB is aangesloten. De V5-controller is het enige VEX-apparaat dat alleen een seriële communicatiepoort heeft en geen seriële gebruikerspoort.

Programma's Informatie

Schermafbeelding van de VS Code Extension-interface voor V5, met functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars die met V5-projecten werken.

Programma-informatie toont een lijst met alle gedownloade gebruikersprogramma's op een VEX Brain.

Schermafbeelding van de VS Code Extension-interface voor V5, met een overzicht van de functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars, waaronder codefragmenten en integratieopties.

Elk programmalijstitem kan worden uitgebreid om aanvullende informatie over elk gebruikersprogramma weer te geven, zoals slotlocatie, bestandsnaam, taaltype, bestandsgrootte en downloadtijd.

Apparateninformatie

Schermafbeelding van de V5 VS Code Extension-interface, met een overzicht van de functies en hulpmiddelen die beschikbaar zijn voor V5-ontwikkeling, waaronder codefragmenten en configuratieopties.

Apparaatinformatie toont een lijst met alle smart port-apparaten die zijn aangesloten op een VEX Brain. Bij elk lijstitem wordt het smart port-nummer en het apparaattype weergegeven.

Schermafbeelding van de VS Code Extension-interface voor V5, met functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars die met V5-projecten werken.

Elk apparaatlijstitem kan worden uitgebreid om informatie over de firmwareversie van elk smart port-apparaat weer te geven.

De gekoppelde status van de controller wordt weergegeven wanneer verbonden met het VEX Brain Device.

Screenshot van de VS Code Extension-interface voor V5, met de functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars die met VEX Robotics werken, waaronder codebewerking en foutopsporingsopties.

VEX Brain is gekoppeld aan een VEX Controller

Schermafbeelding van de VS Code Extension-interface voor V5, met functies en functionaliteiten die relevant zijn voor ontwikkelaars die het V5-platform gebruiken.

VEX Brain is niet gekoppeld aan een VEX Controller

Schermafbeelding van de VS Code Extension-interface voor V5, met de belangrijkste functies en hulpmiddelen waarmee ontwikkelaars hun codeerervaring kunnen verbeteren.

De VEX V5-controller is vastgemaakt aan een VEX V5 Brain

Schermafbeeldingen

Schermafbeelding van de VS Code Extension-interface voor V5, met verschillende functies en hulpmiddelen waarmee ontwikkelaars hun codeerervaring kunnen verbeteren.

Door op het camerapictogram te klikken, kan een gebruiker een screenshot maken en downloaden van een VEX Brain.
Schermafbeeldingen zijn alleen beschikbaar bij directe aansluiting op een VEX Brain via USB

Batterijmedic (alleen V5 Brain)

Screenshot van de VS Code-extensie voor V5, met een demonstratie van de interface en functies, waaronder codebewerkingstools en VEX-robotica-integratieopties.

Door op het hartpictogram te klikken, downloadt de extensie het batterijmedic-gebruikersprogramma en voert het uit.

Hersennaam instellen

Screenshot van de VS Code-extensie voor V5, met de gebruikersinterface en functies die zijn ontworpen om de coderingsefficiëntie en het projectbeheer in VEX-roboticaontwikkeling te verbeteren.

Door op het potloodpictogram naast de naam van systeem>te klikken, kan een gebruiker de naam voor een VEX Brain instellen.

Screenshot van de VS Code Extension-interface voor V5, met een overzicht van de functies en hulpmiddelen die beschikbaar zijn voor VEX-roboticaprogrammering, waaronder codebewerking en foutopsporingsopties.

Nadat op het potloodpictogram is geklikt, verschijnt er een invoervak bovenaan de VS Code-editor. Typ de nieuwe hersennaam in het invoervak en druk op Enter om in te stellen.

Teamnummer instellen

Schermafbeelding van de VS Code Extension-interface voor V5, met functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars die met V5-projecten werken.

Door op het potloodpictogram naast systeem->-team te klikken, kan een gebruiker het teamnummer voor een VEX Brain instellen.

Screenshot van de VS Code-extensie voor V5, met de gebruikersinterface en functies die relevant zijn voor de ontwikkeling van V5-categorieën, waaronder codebewerkingshulpmiddelen en integratieopties.

Nadat op het potloodpictogram is geklikt, verschijnt er een invoervak bovenaan de VS Code-editor. Typ het nieuwe teamnummer in het invoervak en druk op Enter om in te stellen.

Wis gebruikersprogramma

Door op het pictogram Prullenbak naast de programmanaam>projectnaam te klikken, kan een gebruiker een programma in een specifiek slot wissen. BELANGRIJK: als u een programma eenmaal heeft gewist, kan het niet meer worden hersteld. Wees voorzichtig bij het gebruik van deze functie.

Apparaatinfo-waarschuwingen

VEXos-update

Wanneer de VEXos-versie van een VEX Brain verouderd is, verschijnt er een waarschuwingspictogram naast de VEXos-versie en worden beide Brain-pictogrammen geel.

Om deze waarschuwing op te lossen, moet een gebruiker VEXos updaten voor zijn VEXos Brain.

Schermafbeelding van de VS Code Extension-interface voor V5, met functies en functionaliteit om de codeerervaring te verbeteren, waaronder menu's en toolopties.

VEXos kunnen worden bijgewerkt door op de pijl omhoog naast het VEX Brain-pictogram te klikken.

Screenshot van de VS Code-extensie voor V5, met een demonstratie van de gebruikersinterface en functies, waaronder codebewerkingshulpmiddelen en integratieopties voor een verbeterde ontwikkelervaring.

Er verschijnt ook een meldingsvenster in de rechterbenedenhoek van de VS Code-editor wanneer VEXos verouderd is. Een gebruiker kan een VEXos-update starten door op de knop “Update” te klikken of op de knop “Negeren” klikken om de VEXos-update over te slaan.

Hersenen niet gekoppeld aan aangesloten controller

Het VEX Controller-pictogram wordt geel wanneer een VEX-controller is aangesloten op een computer, maar niet is gekoppeld aan een VEX Brain.

Om deze waarschuwing op te lossen, moet een gebruiker een VEX-controller aan een VEX Brain koppelen

Terminalpaneel

De VEX VS Code Extension biedt twee terminals bij het opstarten, de Log Terminal en de Interactieve Terminal

Logterminal

Schermafbeelding van de VS Code Extension-interface voor V5, met een overzicht van de functies en hulpmiddelen die beschikbaar zijn voor V5-ontwikkeling, waaronder codebewerking en foutopsporingsopties.

De Log Terminal geeft build-uitvoer, build-fouten en downloadresultaten weer.

Interactieve terminal

Screenshot van de VS Code Extension-interface voor V5, met een overzicht van de functies en tools die beschikbaar zijn voor VEX-roboticaontwikkeling, waaronder codebewerking en foutopsporingsopties.

De Interactieve Terminal heeft twee functies: printf-logboeken weergeven en onbewerkte toetsaanslagen terugsturen naar een gebruikersprogramma. Om te profiteren van de interactieve terminal moet een Brain of Controller worden aangesloten op een computer waarop de VEX VS Code Extension draait. Interactieve terminaluitvoer wordt standaard gewist na het bouwen en downloaden van een gebruikersprogramma.

Gebruikersinstellingen

Gebruikersinstellingen zijn algemene instellingen die Visual Studio Code voor elke extensie biedt. Gebruikersinstellingen worden toegepast op elk VEX VS Code-uitbreidingsproject.

Toegang krijgen tot de VEX-gebruikersinstellingen

Screenshot van de VS Code Extension-interface voor V5, met functies en opties waarmee gebruikers hun codeerervaring met VEX-robotica kunnen verbeteren.

Klik op het tandwiel in de linkerhoek van VS Code en er verschijnt een contextmenu

Schermafbeelding van de VS Code Extension-interface voor V5, met een overzicht van de functies en tools die beschikbaar zijn voor ontwikkelaars in de V5-categorie.

Klik in het contextmenu op het item "Instellingen" en er verschijnt een instellingenpagina.

Screenshot van de VS Code Extension-interface voor V5, met een overzicht van de functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars, waaronder opties voor codebewerking en VEX-specifieke functionaliteiten.

Klik in de linkerlijstweergave op het item "Extensies". Blader vervolgens naar beneden en zoek het item met het label "VEX".

Klik op het lijstitem "VEX".

Schermafbeelding van de VS Code-extensie voor V5, met weergave van functies en functionaliteiten die relevant zijn voor de beschrijving van de V5-categorie, inclusief gebruikersinterface-elementen en codefragmenten.

De VEX-gebruikersinstellingen verschijnen in het rechterpaneel.

Overzicht instellingen

Controllerkanaal (alleen V5-controller)

De instelling Controller Channel regelt het type radiocommunicatiekanaal tussen een V5 Brain en een V5 Controller.
Deze instelling is alleen van toepassing als VS Code via USB is aangesloten op een V5 Controller en de controller via VEXnet is aangesloten op een V5 Brain. De gebruiker kan kiezen tussen Download en Pit kanalen. Wanneer ingesteld op Download, springt de radio naar een download-VEXnet-kanaal zodra een download van een gebruikersprogramma wordt gestart. Het downloadkanaal zorgt voor hogere datasnelheden en efficiëntere downloads. Wanneer ingesteld op Pit, blijft de radio op een pitkanaal en duurt het downloaden veel langer. Standaard staat deze instelling op Downloaden.

Schermafbeelding van de VS Code Extension-interface voor V5, met functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars die met V5-projecten werken.

Cpp Project SDK-startpagina

BEWERK DEZE INSTELLING NIET.

Cpp Toolchain-pad

Cpp Toolchain Path stelt het pad in voor de toolchain die wordt gebruikt bij het bouwen van een C++ VEX VS Code -project.

Schakel gebruikersterminal in

Met de instelling Enable User Terminal kan het toestel de seriële gebruikerspoort openen wanneer een VEX Brain of VEX Controller door het toestel wordt gedetecteerd. De enige uitzondering geldt voor een V5-controller die niet opsomt met een seriële gebruikerspoort.

Met Inschakelen kan de extensie bij het opstarten verbinding maken met een gebruikerspoort en wordt de interactieve terminal gemaakt. Als inschakelen is geselecteerd terwijl de extensie actief is, zal de extensie proberen de gebruikerspoort te openen als er een apparaat is aangesloten.
Uitschakelen voorkomt dat de extensie bij het opstarten verbinding maakt met de gebruikerspoort en maakt geen interactieve terminal aan. Als uitschakelen wordt geselecteerd terwijl de extensie actief is, zal de extensie de gebruikerspoort sluiten en de interactieve terminal verwijderen.

Type projectopbouw

Projectbouwtype bepaalt hoe de extensie een C++-project bouwt. De gebruiker kan het buildtype instellen op Build of Rebuild.
Build bouw het project alleen wanneer Make eventuele wijzigingen in de broncode van het project detecteert.
Rebuild ruimt de build-directory van het project op en bouwt vervolgens het project. Deze optie is normaal gesproken veel langzamer.

Screenshot van de VS Code-extensie voor V5, met de interface en functies ervan. Deze extensie is ontworpen om de coderingsefficiëntie te verbeteren en ontwikkelingsprocessen te stroomlijnen voor gebruikers die met V5-projecten werken.

Projecthuis

Project Home stelt de standaard homedirectory in voor een nieuw project bij het voltooien van de New Project-wizard.

Uitvoeren na downloaden

Run After Download zorgt ervoor dat, indien ingeschakeld, het gebruikersprogramma wordt uitgevoerd nadat het is gedownload naar een VEX Brain.

Screenshot van de VS Code-extensie voor V5, met een demonstratie van de gebruikersinterface en functies, waaronder codebewerkingshulpmiddelen en VEX-specifieke functionaliteiten.

Python SDK-startpagina

BEWERK DEZE INSTELLING NIET.

Hulp bij VEX-opdrachten

VEX Command Help biedt toegang tot documentatie voor specifieke functies in de C++ en Python API (Application Programming Interface). Documentatie is specifiek voor elk VEX-platform (IQ 2e generatie, EXP, V5).

Screenshot van de VS Code-extensie voor V5, met een demonstratie van de gebruikersinterface en functies, waaronder codebewerkingshulpmiddelen en integratieopties voor VEX-roboticaprogrammering.

Om toegang te krijgen tot de VEX Command Help, markeert u eerst de tekst van de functie waarnaar u wilt zoeken.

Klik met de rechtermuisknop op de geselecteerde tekst en er verschijnt een contextmenu.
Volgende Klik op VEX Command Help om toegang te krijgen tot de documentatie.

Schermafbeelding van de VS Code Extension-interface voor V5, met de functies en hulpmiddelen die beschikbaar zijn voor ontwikkelaars, waaronder codefragmenten en opties voor projectbeheer.

Als VEX Command Help een exacte match vindt, verschijnt er een nieuwe webview met relevante documentatie.

Als meerdere documenten overeenkomen met de geselecteerde tekst, verschijnt er een vervolgkeuzelijst met een gefilterde lijst met relevante documentatie.