Overzicht van de gebruikersinterface van VEX VS Code Extension – 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-platformen.

VEX VS Code Extension UI-indeling

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

Schermafbeelding met de complete VEX VS Code UI-layout. De activiteitenbalk en zijbalk bevinden zich aan de linkerkant van het scherm, de werkbalk en terminal 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. Ook krijgt u aanvullende contextspecifieke indicatoren voor de ontwikkeling van het VEX-project.

VS Code-activiteitenbalk met de VEX Robotics-extensie geïnstalleerd. De activiteitenbalk bevat pictogrammen die handige snelle acties bieden, 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 erop wordt geklikt, wordt de Extensieweergave geopend in de zijbalk.
VEX View-pictogram - Wanneer erop wordt geklikt, wordt de VEX View geopend in de zijbalk.

Zijbalk

De zijbalk bevat verschillende weergaven waarmee u de geïntegreerde hulpmiddelen in VS Code kunt gebruiken. De algemene zijbalkweergaven die worden gebruikt om taken voor VEX-projectontwikkeling uit te voeren, 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, u dit artikel

De VS Code-extensieweergave toont een lijst met geïnstalleerde extensies. Elke extensie heeft een instellingenmenu dat hier geopend kan worden, en er is een zoekbalk om nieuwe extensies te vinden en te 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.

De VS Code VEX-weergave toont bovenaan opties voor het maken en importeren van projecten, daaronder het menu met VEX-apparaatinformatie en onderaan een feedbackmenu.

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

Het gedeelte 'Projectacties' in de VEX-extensieweergave. In dit gedeelte vind je twee knoppen met de tekst 'Nieuw project' en 'Project importeren'.

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

Deze categorie geeft het type aangesloten VEX-apparaat aan en toont informatie 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-batterijmedicijn gebruiken, de naam van het brein instellen en het teamnummer, en het gebruikersprogramma van het VEX Brain wissen

Wanneer een VEX Brain is aangesloten op de computer, wordt in de categorie VEX DEVICE INFO aangegeven of de VEX Brain bijwerken als de VEXos-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. kunnen we de VEXos voor de VEX-controller bijwerken als de VEXos-versie van de VEX-controller verouderd is

Voor een uitgebreide beschrijving van de apparaatgegevens en hoe u de functies onder VEX-APPARAATINFOkunt gebruiken, raadpleegt u dit artikel.

VEX FEEDBACK
We kunnen feedback naar VEX sturen door het bericht in het tekstvak onder VEX FEEDBACK te typen en op de VERZENDEN knop te klikken.
Voor nuttige informatie over het gebruik van VEX FEEDBACK in VS Code, zie dit artikel.

Het VEX Feedback-gedeelte van de VEX Extension View. In dit gedeelte vindt u een formulier met opties om feedback aan VEX te geven.

Explorer-weergave

De Explorer View wordt gebruikt om de VEX-projectbestanden en -mappen in VS Code te doorbladeren, openen en beheren.

De VS Code Explorer-weergave stelt de gebruiker in staat om door de mappen en bestanden in hun VEX-project te navigeren. De bestanden hebben bijbehorende pictogrammen en bestandstypen; in dit voorbeeld is een Python-bestand geselecteerd en de titel luidt VEXcode Project.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. Dit helpt ons bij de ontwikkeling 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-robotica-programma's te maken die zijn gekoppeld aan 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 printlogboeken en het terugsturen van onbewerkte toetsaanslagen naar een gebruikersprogramma.

Opmerking: Om de interactieve terminal te gebruiken, moet een Brain of Controller zijn aangesloten op een computer waarop de VEX VS Code-extensie 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 je snel kunt communiceren met verbonden VEX-apparaten en -projecten. De VEX-functies omvatten de apparaatkiezer, de slotkiezer, het downloadpictogram voor build & , het afspeelpictogram, het stoppictogram, 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 worden geopend, worden niet beschouwd als geldige VEX-projecten en moeten worden geïmporteerd.

De pictogrammen op de werkbalk omvatten:

Apparaatkiezer - De apparaatkiezer toont het pictogram van het aangesloten VEX-apparaat (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 brain-naam weergegeven naast het Controller-pictogram.

Slotselectie-pictogram - Het Slotselectie-pictogram stelt ons in staat om te kiezen in welk slot de VEX-extensie een gebruikersprogramma zal downloaden of afspelen door erop te klikken en een van de acht beschikbare slots op de VEX Brain uit de keuzelijst te selecteren.
Build & Downloadpictogram - Als een VEX-apparaat is aangesloten, wordt het Downloadpictogram op de werkbalk weergegeven. Wanneer u hierop klikt, wordt het project gebouwd en, indien succesvol, gedownload naar het aangesloten VEX-apparaat.
Afspeelpictogram - Wanneer erop geklikt wordt, start het Afspeelpictogram het gedownloade gebruikersprogramma in de geselecteerde sleuf op de VEX Brain.
Stop-pictogram - Wanneer erop geklikt wordt, stopt het Stop-pictogram de uitvoering van het gebruikersprogramma op de VEX Brain.
Projectkiezer - De Projectkiezer toont de naam van het geselecteerde project. Met het projectselectiepictogram kunt u schakelen tussen VEX-projecten als 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 raadplegen.

VEX-gebruikersinstellingen

Met de VEX-gebruikersinstellingen kunnen we VEX Extension configureren volgens onze eigen vereisten. 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.

De gebruikersinstellingen van VS Code worden 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 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 - Stelt het aantal logboekvermeldingen in dat moet worden geüpload van een VEX Brain.
Project Build Type - Hiermee stelt u in hoe de extensie een C++-project bouwt.
Project Home - Stelt de standaardlocatie in voor nieuwe projecten.
Uitvoeren na downloaden - Hiermee wordt ingesteld of het gebruikersprogramma moet worden uitgevoerd nadat het is gedownload naar een VEX Brain.
Systeem DFU Automatisch Herstel - 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 voor het starten van de Websocket Server in of uit.
Websocket Server Host Address - Stelt het hostadres van de Websocket-server in.
Websocket-serverpoort - Stelt Websocket-serverpoortnummer in

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