VEX VS Code Extension UI-overzicht – VEX-bibliotheek

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

VEX VS Code-extensie UI-indeling

De gebruikersinterface van de VEX Visual Studio Code Extension is verdeeld in vijf hoofdgebieden: Activiteitenbalk, Zijbalk, Editor, Terminalpaneel en Werkbalk.

Schermafbeelding van de volledige VEX VS Code UI-indeling. De activiteitenbalk en de zijbalk bevinden zich aan de linkerkant van het scherm, de werkbalk en de terminal bevinden zich aan de onderkant van het scherm en de editor vult de rest van het scherm.

Activiteitenbalk

De activiteitenbalk bevat een reeks pictogrammen waarmee u kunt schakelen tussen weergaven en waarmee u aanvullende contextspecifieke indicatoren voor de ontwikkeling van het VEX-project krijgt.

VS Code-activiteitenbalk met de VEX Robotics-extensie geïnstalleerd. De activiteitenbalk bevat pictogrammen waarmee u snel en eenvoudig handige acties kunt uitvoeren, zoals zoeken, extensies beheren, versiebeheer en meer.

De meest gebruikte pictogrammen voor het ontwikkelen van een VEX-project in VS Code zijn:

Explorer-weergavepictogram - Wanneer erop wordt geklikt, wordt de Explorer-weergave geopend in de zijbalk.
Extensieweergave-pictogram - Wanneer u hierop klikt, wordt de Extensieweergave geopend in de zijbalk.
VEX-weergavepictogram - Wanneer erop wordt geklikt, wordt de VEX-weergave geopend in de zijbalk.

Zijbalk

De zijbalk bevat verschillende weergaven waarmee u de geïntegreerde tools in VS Code kunt gebruiken. De algemene zijbalkweergaven die worden gebruikt om taken uit te voeren voor VEX-projectontwikkeling zijn Extensieweergave, VEX-weergaveen Verkennerweergave.

Uitbreidingsweergave

De Extension View wordt gebruikt om de extensies in VS Code te installeren en beheren. Voor het ontwikkelen van software op VEX IQ 2nd Generation, EXP en V5 platforms moeten we de VEX Extension, C/C++ Extension en Python Extension installeren.

Voor stapsgewijze instructies over het installeren van de VEX Extension, C/C++ Extensionen Python Extension in VS Code, raadpleegt dit.

VS Code Extension View toont een lijst met geïnstalleerde extensies. Elke extensie heeft een instellingenmenu dat u hier kunt openen. Ook is er een zoekbalk waarmee u nieuwe extensies kunt zoeken en downloaden.

VEX-weergave

Met de VEX View kunnen we projecten ontwikkelen voor VEX IQ 2nd Generation, EXP en V5 in VS Code. Er zijn drie categorieën opgenomen in de VEX-weergave: PROJECTACTIES, VEX-APPARAATINFO, en VEX-FEEDBACK.

VS Code VEX-weergave met opties voor het maken en importeren van projecten (boven), het menu VEX-apparaatinfo (onder) en een feedbackmenu (onder).

PROJECTACTIES
De knoppen onder PROJECTACTIES worden gebruikt om een nieuw VEX-project te maken of een bestaand VEXcode-project te importeren.
Voor gedetailleerde richtlijnen voor het maken van een VEX-project in VS Code, zie dit artikel voor V5, dit artikel voor EXPen dit artikel voor IQ (2nd).

Sectie Projectacties van de VEX Extension View. In deze sectie zijn twee knoppen te vinden: Nieuw project en Project importeren.

VEX DEVICE INFO
De categorie VEX DEVICE INFO geeft ons een overzicht van het aangesloten VEX-apparaat - een VEX Brain of een VEX Controller.

Deze categorie geeft het aangesloten VEX-apparaattype aan en geeft informatie weer over het Brain-systeem, de seriële poort, het gedownloade programma en de apparaten die zijn aangesloten op de slimme poorten van de VEX Brain. Hiermee kunnen we screenshots maken van het VEX Brain-scherm, het VEX Brain-gebeurtenislogboek bekijken, de V5 Battery Medic gebruiken, de naam van het brein instellen en het teamnummeren het gebruikersprogramma van de VEX Brain wissen

Wanneer een VEX Brain is aangesloten op de computer, wordt in de categorie VEX DEVICE INFO weergegeven of er een VEX-controller is gekoppeld aan de VEX Brain en kunnen we de VEXo's voor de VEX Brain als de VEXo-versie van de VEX Brain verouderd is.

Wanneer een VEX Controller is aangesloten op de computer, wordt in de categorie VEX DEVICE INFO weergegeven of er een VEX Brain is gekoppeld aan de VEX Controller en kunnen we de VEXo's voor de VEX Controller als de VEXo-versie van de VEX Controller verouderd is.

Raadpleeg dit artikel voor een uitgebreide beschrijving van de apparaatgegevens en hoe u de functies onder VEXAPPARAATINFOkunt gebruiken.

VEX FEEDBACK
We kunnen feedback naar VEX sturen door het bericht in te typen in het tekstvak onder VEX FEEDBACK en op de knop VERZENDEN te klikken.
Raadpleeg dit artikel voor nuttige informatie over hetvan VEX FEEDBACK in VS Code.

VEX Feedback-sectie van de VEX Extension View. In deze sectie vindt u een formulier met opties voor het indienen van feedback bij VEX.

Explorer-weergave

Met de Explorer View kunt u de VEX-projectbestanden en -mappen in VS Code doorbladeren, openen en beheren.

VS Code Explorer-weergave waarmee de gebruiker door de mappen en bestanden in zijn VEX-project kan navigeren. De bestanden hebben bijbehorende pictogrammen en bestandstypen. In dit voorbeeld is een Python-bestand geselecteerd en luidt de titel main.py.

Editor

De Editor is het belangrijkste gebied voor het bewerken van bestanden in VS Code. De VEX VS Code-extensie maakt Intellisense/Linting mogelijk voor zowel C/C++ als Python in het Editor-gedeelte om ons te helpen bij het ontwikkelen van het programma.

VS Code Editor met een Python-bestand geopend als onderdeel van een VEX-project. Hier kan Python- of C/C++-code worden geschreven en bewerkt om VEX-roboticaprogramma's te maken wanneer deze is verbonden met een VEX Brain.

In het Editor-gedeelte kunt u nuttige informatie over een specifieke functie opvragen door de muis over de tekst van de functie te bewegen of door de VEX Command Help te gebruiken om toegang te krijgen tot de documentatie voor deze functie die is opgenomen in de C++ en Python API (Application Programming Interface).

Voor gedetailleerde instructies over het gebruik van de VEX Command Help in VS Code, zie dit artikel.

Aansluitpaneel

De VEX VS Code-extensie biedt bij het opstarten twee terminals: de Log Terminal en de Interactive Terminal.

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

De VS Code VEX Log Terminal wordt geopend en toont een standaard lege status met slechts één bericht: Log.

Interactieve terminal - De interactieve terminal heeft twee functies: het weergeven van afdruklogboeken en het terugsturen van onbewerkte toetsaanslagen naar een gebruikersprogramma.

Opmerking: Om de interactieve terminal te kunnen gebruiken, moet een Brain of Controller worden aangesloten op een computer waarop de VEX VS Code Extension draait.
Opmerking: De uitvoer van de interactieve terminal wordt standaard gewist nadat een gebruikersprogramma is gebouwd en gedownload.

Werkbalk

De werkbalk bevat een reeks pictogrammen waarmee u snel kunt communiceren met VEX VS Code-uitbreidingsprojecten, VEX Brains en VEX Controllers.

VS Code-werkbalk met VEX-extensiepictogrammen waarmee u snel kunt communiceren met aangesloten VEX-apparaten en projecten. De VEX-functies omvatten de apparaatkiezer, de slotkiezer, het pictogram Downloaden Build & , het pictogram Afspelen, het pictogram Stoppen, de projectkiezer en de Python-bestandskiezer.

Opmerking: De werkbalk is alleen actief wanneer er een geldig VEX-project is geopend in VS Code.

Opmerking: Een geldig VEX-project is een project dat door de extensie is gemaakt of geïmporteerd. VEXcode- of VEXcode Pro-projecten die in de editor zijn geopend, worden niet als geldig VEX-projecten beschouwd en moeten worden geïmporteerd.

De pictogrammen op de werkbalk zijn onder meer:

Apparaatkiezer - De apparaatkiezer geeft het pictogram van het aangesloten VEX-apparaat weer (een Brain-pictogram of een Controller-pictogram )
Opmerking: Als een controller is aangesloten op de computer, maar geen radioverbinding heeft met een brain, wordt er geen brainnaam weergegeven naast het Controller-pictogram.

Slot Selector-pictogram - Met het Slot Selector-pictogram kunt u kiezen op welke Slot de VEX Extension een gebruikersprogramma zal downloaden of afspelen door erop te klikken en een van de acht beschikbare Slots op de VEX Brain te selecteren uit de keuzelijst.
Build & Downloadpictogram - Als er een VEX-apparaat is aangesloten, wordt het Downloadpictogram weergegeven op de werkbalk. Wanneer u hierop klikt, wordt het project gebouwd en, indien succesvol, gedownload naar het aangesloten VEX-apparaat.
Afspeelpictogram - Wanneer u hierop klikt, start het Afspeelpictogram het gedownloade gebruikersprogramma in de geselecteerde sleuf op de VEX Brain.
Stoppictogram - Wanneer erop wordt geklikt, stopt het Stoppictogram de uitvoering van het gebruikersprogramma op de VEX Brain.
Projectkiezer - De Projectkiezer geeft de naam van het geselecteerde project weer. Met het projectselectiepictogram kunt u schakelen tussen VEX-projecten wanneer er meerdere projecten in de werkruimte aanwezig zijn. Klik hierop en selecteer een project uit de keuzelijst.
Python-bestandsselector (alleen Python) - Wanneer een VEX Python-project is geselecteerd, verschijnt de Python-bestandsselector in de werkbalk. De Python-bestandsselector geeft de naam van het geselecteerde Python-bestand weer. Python voor VEX ondersteunt momenteel alleen het downloaden van afzonderlijke bestanden.

Voor nuttige informatie over het gebruik van de Toolbar-functies in VS Code kunt u dit raadplegen

VEX-gebruikersinstellingen

Met de VEX-gebruikersinstellingen kunnen we VEX extensie naar eigen wens configureren. Gebruikersinstellingen zijn algemene instellingen die worden toegepast op elk VEX VS Code-extensieproject. We krijgen toegang tot de VEX-gebruikersinstellingen door op het instellingenpictogram in VS Code te klikken en de overeenkomstige items in de menu's te selecteren.

VS Code Gebruikersinstellingen wordt geopend in de VEX-categorie, waar het gedrag van de VEX Robotics Extension kan worden aangepast.

De VEX-gebruikersinstellingen voor het configureren van de VEX VS Code-extensie zijn:

Controllerkanaal (alleen V5-controller) - Stelt het V5-controllerradiokanaal in op Download of Pit. Deze instelling is alleen van toepassing op de VEXnet-radioverbinding.

Cpp Toolchain Pad - Stelt het pad voor de CPP Toolchain in.
Gebruikersterminalinschakelen - Hiermee schakelt u de extensie in of uit om gegevens van de gebruikerspoort te openen en weer te geven.
Logboekvermeldingen - Hiermee stelt u het aantal logboekvermeldingen in dat moet worden geüpload vanaf een VEX Brain.
Project Build Type - Hiermee wordt ingesteld hoe de extensie een C++-project bouwt.
Project Home - Stelt de standaardlocatie voor nieuwe projecten in.
Uitvoeren na downloaden - Hiermee wordt ingesteld of het gebruikersprogramma moet worden uitgevoerd nadat het is gedownload naar een VEX Brain.
Systeem DFU Automatisch herstellen - Hiermee stelt u in of de hersenen automatisch moeten herstellen wanneer een IQ2 of EXP wordt gedetecteerd in de DFU-modus.
Websocket Server Enable - Hiermee schakelt u de extensie in of uit om de Websocket Server te starten.
Hostadres Websocket-server - Stelt het hostadres van de Websocket-server in.
Websocket Server Poort - Stelt Websocket Server Poortnummer in

dit artikelvoor nuttige informatie over het openen en instellen van de VEX-gebruikersinstellingen.