VS Code UI-overzicht voor IQ – 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 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.

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.

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.

Apparaatkiezer

Het pictogram Apparaatkiezer is gemarkeerd op de VS Code-werkbalk. In dit voorbeeld is dat VEX_EXP.

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

VS Code-zoekbalk met een snelkeuzelijst van alle aangesloten VEX-apparaten. In dit voorbeeld worden een V5 Brain, een V5 Controller en een EXP Controller weergegeven.

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

Zoekbalk van VS Code met een snelkeuzelijstitem om details te verstrekken. Het item luidt MyBrain, V5 Brain, User COM8, Comm COM7.

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

Zoekbalk van VS Code met een snelkeuzelijstitem om details te verstrekken. Het item is een V5-controller, maar de achtergrond is grijs en er staat geen Brain-naam vermeld. Dit geeft aan dat deze Controller geen radioverbinding heeft met een Brain.

V5 Controller-item met een blauwe achtergrond om aan te geven dat deze Controller een radioverbinding met een Brain heeft.

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

Het Slot Selector-pictogram is gemarkeerd op de VS Code-werkbalk. In dit voorbeeld staat er Slot 1.

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

VS Code-zoekbalk met een snelkeuzelijst van alle beschikbare slots op de aangesloten VEX Brain. In dit voorbeeld zijn er acht beschikbare slots.

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

Bouwen/downloaden

Bouw-icoon. Download-pictogram.

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

Bouw-icoon.

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

Download-pictogram.

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

Afspeelpictogram.

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

Stop

Stop-icoon.

Als u op het stoppictogram klikt, stopt een gebruikersprogramma.

Geselecteerde werkruimte

De projectselector wordt weergegeven op de VS Code-werkbalk. In dit voorbeeld staat er EXPTestProject.

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

VS Code-zoekbalk met een snelle keuzelijst met opgeslagen VEX-projecten. In dit voorbeeld wordt er één Python-project en één C++-project vermeld.

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.

Het pictogram van de Python-bestandsselector wordt weergegeven op de werkbalk van VS Code. In dit voorbeeld is dat main.py.

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.

VS Code-zoekbalk met een snelkeuzelijst van alle Python-bestanden in dit VEX-project. In dit voorbeeld zijn er drie Python-bestanden, elk op een andere bestandslocatie.

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

Schermafbeelding van de VS Code-activiteitenbalk en de zijbalk geopend in de VEX-weergave. VEX View bevat opties voor het maken en importeren van projecten (boven), het menu VEX-apparaatinfo (onder) en een feedbackmenu (onder).

Projecten Acties

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

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

In het gedeelte VEX-apparaatinfo van de VEX-extensieweergave vindt u een lijst met alle aangesloten apparaten en specifieke informatie over elk apparaat. In dit voorbeeld worden een IQ (2e generatie) Brain en de gedownloade programma's weergegeven. In de Controller-vermelding staat Controller, niet gekoppeld. Het gedeelte VEX-apparaatinfo wordt opnieuw weergegeven, maar in de vermelding Controller staat nu Controller, gekoppeld.

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

De systeemmap en de inhoud ervan worden weergegeven en gemarkeerd onder de map Brain. De systeemmap bevat gegevens over Brain, en de gegevens luiden VEXos 1.0.1.0, naam VEX_EXP, team 000000, id 0EC83725 en Python 1.0.0.7.

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

De map Serial Port en de inhoud ervan worden onder de map Brain weergegeven. De map Seriële poort bevat gegevens over de bekabelde verbinding van de Brain. Deze gegevens luiden Communicatie COM167, Gebruiker COM168.

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

De map Programma's en de inhoud ervan worden onder de map Brain weergegeven. In de map Programma's worden alle gedownloade VEX-projecten op de Brain weergegeven. In dit voorbeeld zijn er vier C/C++-programma's gedownload naar de aangesloten Brain.

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

De map Programma's en de inhoud ervan worden onder de map Brain weergegeven. Nu is de map van het eerste project geopend om de inhoud ervan te tonen. De projectmap toont gegevens over de sleuf, het bestand, het type, de grootte en de tijd.

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

Apparateninformatie

De map Apparaten en de inhoud ervan worden onder de map Brain weergegeven. In de map Apparaten worden alle apparaten weergegeven die op de Brain zijn aangesloten. In dit voorbeeld worden er 6 apparaten vermeld, waaronder 4 motoren, een 3-draads apparaat en een interne radio.

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.

De map Apparaten en de inhoud ervan worden onder de map Brain weergegeven. In dit voorbeeld is het apparaat Motor geselecteerd en de inhoud is: Type Motor, Versie 1.0.0.4, Boot 1.0.2.0.

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.

Controller staat vermeld onder de map Apparaten. Deze Controller leest Controller, gekoppeld.

VEX Brain is gekoppeld aan een VEX Controller

Controller staat vermeld onder de map Apparaten. Deze Controller luidt Controller, niet gekoppeld.

VEX Brain is niet gekoppeld aan een VEX Controller

Controller staat vermeld onder de map Apparaten. Deze Controller leest Controller, tethered.

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

Schermafbeeldingen

De cursor beweegt over de map VEX Device Indicator en ernaast wordt een camerapictogram weergegeven.

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)

De cursor beweegt over de map V5 Brain VEX Device Indicator en ernaast wordt een Battery Medic-pictogram weergegeven.

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

Hersennaam instellen

De cursor beweegt over de optie Naam in de map Systeem en ernaast wordt een potloodpictogram weergegeven.

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

Er verschijnt een promptvenster met de naam van uw brein, met daaronder een tekstveld en een bericht. Druk op Enter om uw invoer te bevestigen of op Escape om te annuleren.

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

De cursor beweegt over de optie Team in de map Systeem en ernaast wordt een potloodpictogram weergegeven.

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

Er verschijnt een promptvenster waarin u het teamnummer kunt instellen, met een tekstveld en daaronder de tekst Druk op Enter om uw invoer te bevestigen of op Escape om te annuleren.

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

De cursor beweegt over een programma in de map Programma's en ernaast wordt een Prullenbakpictogram weergegeven.

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

Het pictogram van de map Brain en het pictogram van de VEX-apparaatindicator worden oranje weergegeven. Naast de VEXos-versie van het systeem staat een gevarensymbool. Deze signalen geven aan dat de VEXos-versie van Brain verouderd is.

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.

De cursor beweegt over de verouderde map Brain en ernaast wordt een pictogram met een pijltje omhoog weergegeven.

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

Werk het VEXos-promptvenster bij met het bericht VEXos-update beschikbaar: 1.0.1.0. Bron: VEX Extension. Hieronder ziet u twee knoppen: Bijwerken en Negeren.

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

De map Brain onder de map VEX Device Indicator heeft een oranje pictogram en de tekst Brain, niet gekoppeld. Deze signalen geven aan dat er geen VEX Brain-verbinding is.

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

Het VS Code Terminal-venster is geopend en toont de VEX Log Terminal en de VEX Interactive Terminal.

Logterminal

VS Code VEX Log Terminal wordt geopend en toont de gebruiksgeschiedenis van de VEX Extension. In dit voorbeeld zijn de berichten Log, Windows build voor platform vexexp, Download gebruikerprogramma, Download voltooid.

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

Interactieve terminal

VS Code VEX Interactive Terminal wordt geopend en het bericht Hallo wereld wordt weergegeven.

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.

Via de gebruikersinstellingen van VS Code wordt de VEX-pagina geopend, waar het gedrag van de VEX Robotics Extension kan worden aangepast.

Toegang krijgen tot de VEX-gebruikersinstellingen

Instellingenpictogram helemaal onderaan de VS Code-activiteitenbalk, in de linkerbenedenhoek van het scherm.

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

Contextmenu van VS Code-instellingen met vele opties. De optie Instellingen is gemarkeerd en is de derde optie in het menu, onder Opdrachtpalet en Profielen.

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

Het venster VS Code-instellingen is geopend en de categorie Extensies is gemarkeerd in de navigatielijst aan de linkerkant.

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

Het venster VS Code-instellingen is geopend en de koppeling naar de VEX-pagina in de categorie Extensies is gemarkeerd.

Klik op het lijstitem "VEX".

Via de gebruikersinstellingen van VS Code wordt de VEX-pagina geopend, waar het gedrag van de VEX Robotics Extension kan worden aangepast.

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.

VEX-gebruikersinstellingen met de optie Controllerkanaal weergegeven. Deze optie heeft een vervolgkeuzemenu dat standaard is ingesteld op Downloaden. De beschrijving luidt: Hiermee stelt u het V5-controllerradiokanaal in.

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.

VEX-gebruikersinstellingen met de Cpp Toolchain: Pad-optie weergegeven. Deze optie heeft een tekstveld dat een bestandspad vertegenwoordigt.

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.

VEX-gebruikersinstellingen met de optie Algemeen gebruikersterminal inschakelen weergegeven. Deze optie heeft een vervolgkeuzemenu dat standaard is ingesteld op Inschakelen. De beschrijving luidt: Schakel de extensie in om gegevens van de gebruikerspoort te openen en weer te geven.

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.

VEX-gebruikersinstellingen met de optie Projectbouwtype weergegeven. Deze optie heeft een vervolgkeuzemenu dat standaard is ingesteld op Bouwen. De beschrijving luidt: Set Cpp Project Build Type.

Projecthuis

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

VEX-gebruikersinstellingen met de optie Project Home weergegeven. Deze optie heeft een tekstveld dat een bestandspad vertegenwoordigt. De beschrijving luidt: Stelt de standaardlocatie voor nieuwe projecten in.

Uitvoeren na downloaden

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

VEX-gebruikersinstellingen met de optie Project uitvoeren na downloaden weergegeven. Deze optie heeft een selectievakje dat in dit voorbeeld als geselecteerd wordt weergegeven. De beschrijving luidt: Stel in of het gebruikersprogramma moet worden uitgevoerd na het downloaden.

Python SDK-startpagina

BEWERK DEZE INSTELLING NIET.

VEX-gebruikersinstellingen met de Python SDK Home-optie weergegeven. Deze optie heeft een link met de tekst Bewerken in settings.json. In de beschrijving staat: NIET BEWERKEN.

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

De C++-opdracht in de VS Code-editor is gemarkeerd met de cursor.

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

Het contextmenu voor de C++-opdracht is geopend en de optie VEX Command Help is gemarkeerd.

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.

De VEX Command Help-pagina is geopend en toont informatie en voorbeelden over de C++-opdracht Brain Screen Print.

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

VS Code-zoekbalk met een snelkeuzelijst met overeenkomende VEX C++-opdrachten in VEX Command Help om de zoekopdracht van de gebruiker te verfijnen.

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