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.
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 de VEX VS Code-extensieprojecten VEX Brains en VEX Controllers. De werkbalk is alleen actief wanneer een geldig VEX-project is geopend 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.
Apparaatkiezer
De apparaatkiezer heeft twee hoofdfuncties. Ten eerste wordt er een hersen- of controllerpictogram weergegeven dat het aangesloten VEX-apparaattype vertegenwoordigt.
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).
Elk apparaatitem bevat informatie over de hersennaam, het platform, het apparaattype en het apparaatpad.
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
Met het slotselectiepictogram kan de gebruiker kiezen op welk slot de extensie een gebruikersprogramma downloadt of afspeelt.
Wanneer op het slotselectiepictogram wordt geklikt, verschijnt er een snelle keuzelijst met de beschikbare gebruikersprogrammaslots 1-8.
Bouwen/downloaden
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.
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
Als u op het afspeelpictogram klikt, wordt het gebruikersprogramma in het geselecteerde slot uitgevoerd.
Stop
Als u op het stoppictogram klikt, stopt een gebruikersprogramma.
Geselecteerde werkruimte
VS Code ondersteunt projecten met meerdere werkruimten. Met de projectkiezer kunnen gebruikers schakelen tussen VEX-projecten als er meerdere binnen de werkruimte bestaan.
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 pas geldig als het is aangemaakt of geïmporteerd door de VEX VS Code-extensie.
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
Projecten Acties
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
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 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
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
Programma-informatie toont een lijst met alle gedownloade gebruikersprogramma's op een VEX Brain.
Elk programmalijstitem kan worden uitgebreid om aanvullende informatie over elk gebruikersprogramma weer te geven, zoals slotlocatie, bestandsnaam, taaltype, bestandsgrootte en downloadtijd.
Apparateninformatie
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.
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.
VEX Brain is gekoppeld aan een VEX Controller
VEX Brain is niet gekoppeld aan een VEX Controller
De VEX V5-controller is vastgemaakt aan een VEX V5 Brain
Schermafbeeldingen
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)
Door op het hartpictogram te klikken, downloadt de extensie het batterijmedic-gebruikersprogramma en voert het uit.
Hersennaam instellen
Door op het potloodpictogram naast de naam van systeem>te klikken, kan een gebruiker de naam voor een VEX Brain instellen.
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
Door op het potloodpictogram naast systeem->-team te klikken, kan een gebruiker het teamnummer voor een VEX Brain instellen.
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.
VEXos kunnen worden bijgewerkt door op de pijl omhoog naast het VEX Brain-pictogram te klikken.
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
De Log Terminal geeft build-uitvoer, build-fouten en downloadresultaten weer.
Interactieve terminal
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
Klik op het tandwiel in de linkerhoek van VS Code en er verschijnt een contextmenu
Klik in het contextmenu op het item "Instellingen" en er verschijnt een instellingenpagina.
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".
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.
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.
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.
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).
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.
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.