Dieser Artikel bietet einen Überblick über die Benutzeroberfläche (UI) der VEX Visual Studio Code-Erweiterung. Die Erweiterung unterstützt die Entwicklung von C++- und Python-Projekten für die Plattformen VEX IQ 2nd Generation, EXP und V5.
VEX VS Code Erweiterungs-UI-Layout
Die Benutzeroberfläche der VEX Visual Studio Code-Erweiterung ist in fünf Hauptbereiche unterteilt: Aktivitätsleiste, Seitenleiste, Editor, Terminal-Panel und Symbolleiste.
Aktivitätsleiste
Die Aktivitätsleiste enthält eine Reihe von Symbolen, mit denen wir zwischen verschiedenen Ansichten wechseln können und die uns zusätzliche kontextspezifische Indikatoren für die Entwicklung des VEX-Projekts liefern.
Die gängigen Symbole, die für die Entwicklung eines VEX-Projekts in VS Code verwendet werden, sind:
-
Explorer-Ansicht Symbol - Beim Anklicken öffnet sich die Explorer-Ansicht in der Seitenleiste.
-
Erweiterungsansicht Symbol - Beim Anklicken öffnet sich die Erweiterungsansicht in der Seitenleiste.
-
VEX-Ansichtssymbol - Beim Anklicken öffnet sich die VEX-Ansicht in der Seitenleiste.
Seitenleiste
Die Seitenleiste enthält verschiedene Ansichten, die es uns ermöglichen, die in VS Code integrierten Tools zu nutzen. Die üblicherweise in der Seitenleiste verwendeten Ansichten zur Durchführung von Aufgaben im Rahmen der VEX-Projektentwicklung sind Erweiterungsansicht, VEX-Ansichtund Explorer-Ansicht.
Erweiterungsansicht
Die Erweiterungsansicht dient zum und Verwalten der Erweiterungen in VS Code. Für die Softwareentwicklung auf den Plattformen VEX IQ 2nd Generation, EXP und V5 müssen die VEX-Erweiterung, die C/C++-Erweiterung und die Python-Erweiterung installiert werden.
Eine Schritt-für-Schritt-Anleitung zur Installation der VEX-Erweiterung, C/C++-Erweiterungund Python-Erweiterung in VS Code finden Sie in diesem Artikel.
VEX-Ansicht
VEX View können wir Projekte für VEX IQ 2nd Generation, EXP und V5 in VS Code entwickeln. Die VEX-Ansicht enthält drei Kategorien: PROJEKTAKTIONEN, VEX-GERÄTEINFORMATIONEN, und VEX-FEEDBACK.
-
PROJEKTAKTIONEN
Die Schaltflächen unter PROJEKTAKTIONEN dienen zum Erstellen eines neuen VEX-Projekts oder zum Importieren eines bestehenden VEXcode-Projekts.
Eine detaillierte Anleitung zum Erstellen eines VEX-Projekts in VS Code finden Sie diesem Artikel für V5 in diesem Artikel für EXPund
-
VEX-GERÄTEINFORMATIONEN
Die Kategorie VEX-GERÄTEINFORMATIONEN bietet uns einen Überblick über das angeschlossene VEX-Gerät – ein VEX Brain oder einen VEX Controller.
Diese Kategorie gibt den angeschlossenen VEX-Gerätetyp an und zeigt Informationen über das Brain-System, den seriellen Port, das heruntergeladene Programm und die an die Smart Ports des VEX Brain angeschlossenen Geräte an. Es ermöglicht uns, einen Screenshot des VEX Brain-Bildschirmszu erstellen, das VEX Brain-Ereignisprotokollanzuzeigen, den V5 Battery Mediczu verwenden, den Brain-Namen und die Teamnummerfestzulegen und das Benutzerprogramm vom VEX Brain zu löschen.
Wenn ein VEX Brain mit dem Computer verbunden ist, zeigt die Kategorie VEX-Geräteinformationen an, ob ein VEX-Controller mit dem VEX Brain verbunden ist, und ermöglicht es uns, VEXos für das VEX Brain zu aktualisieren, falls die VEXos-Version des VEX Brain veraltet ist.
Wenn ein VEX-Controller an den Computer angeschlossen ist, zeigt die Kategorie VEX-Geräteinformationen an, ob ein VEX Brain mit dem VEX-Controller verbunden ist, und ermöglicht es uns für den VEX-Controller zu aktualisieren, falls dessen VEXos-Version veraltet ist.
Eine ausführliche Beschreibung der Geräteinformationen und der Funktionen unter VEX DEVICE INFOfinden Sie in diesem Artikel.
-
VEX-FEEDBACK
Wir können Feedback an VEX senden, indem wir die Nachricht in das Textfeld unter VEX-FEEDBACK eingeben und auf die Schaltfläche SENDEN klicken.
Hilfreiche Informationen zur Verwendung von FEEDBACK in VS Code finden Sie in diesem Artikel
Explorer-Ansicht
Die Explorer-Ansicht dient zum Durchsuchen, Öffnen und Verwalten der VEX-Projektdateien und -ordner in VS Code.
Editor
Der Editor ist der Hauptbereich zum Bearbeiten von Dateien in VS Code. Die VEX VS Code-Erweiterung ermöglicht Intellisense/Linting für C/C++ und Python im Editorbereich, um uns bei der Programmentwicklung zu unterstützen.
Im Editorbereich können wir hilfreiche Informationen zu einer bestimmten Funktion abrufen, indem wir mit der Maus über den Text der Funktion fahren oder indem wir den Befehl VEX Command Help verwenden, um auf die Dokumentation für diese Funktion zuzugreifen, die in der C++ und Python API (Application Programming Interface) enthalten ist.
Eine detaillierte Anleitung zur Verwendung des Befehls VEX in VS Code finden Sie diesem.
Anschlussfeld
Die VEX VS Code-Erweiterung bietet beim Start zwei Terminals: das Log-Terminal und das interaktive Terminal.
-
Log Terminal - Das Log Terminal zeigt Build-Ausgabe, Build-Fehler und Download-Ergebnisse an.
-
Interaktives Terminal - Das interaktive Terminal hat zwei Funktionen: die Anzeige von Druckprotokollen und die Rücksendung der Rohdaten der Tastatureingaben an ein Benutzerprogramm.
Hinweis: Um das interaktive Terminal zu nutzen, muss ein Brain oder Controller mit einem Computer verbunden sein, auf dem die VEX VS Code-Erweiterung ausgeführt wird.
: Die Ausgabe des Terminals wird nach dem Kompilieren und Herunterladen eines Benutzerprogramms standardmäßig gelöscht.
Symbolleiste
Die Toolbar enthält eine Reihe von Symbolen, die uns eine schnelle Möglichkeit bieten, mit VEX VS Code-Erweiterungsprojekten, VEX Brains und VEX Controllern zu interagieren.
: Die Symbolleiste ist nur aktiv wenn ein gültiges VEX-Projekt in VS Code geöffnet ist.
: Ein VEX-Projekt ist ein Projekt, das von der Erweiterung erstellt oder importiert wurde. Im Editor geöffnete VEXcode- oder VEXcode Pro-Projekte werden nicht als gültiges VEX-Projekt betrachtet und müssen importiert werden.
Die in der Symbolleiste enthaltenen Symbole umfassen:
-
Geräteauswahl - Die Geräteauswahl zeigt das Symbol des angeschlossenen VEX-Geräts an (ein Gehirn-Symbol
oder ein Controller-Symbol
)
Hinweis: Wenn ein Controller mit dem Computer verbunden ist, aber keine Funkverbindung zu einem Gehirn besteht, wird neben dem Controller-Symbol kein Gehirnname angezeigt.
-
Slot-Auswahlsymbol - Das Slot-Auswahlsymbol ermöglicht es uns, den Slot auszuwählen, auf dem die VEX-Erweiterung ein Benutzerprogramm herunterladen oder ausführen soll, indem wir darauf klicken und einen der acht verfügbaren Slots auf dem VEX Brain aus der Auswahlliste auswählen.
-
Build & Download-Symbol - Wenn ein VEX-Gerät angeschlossen ist, wird das Download-Symbol in der Symbolleiste angezeigt. Nach dem Anklicken wird das Projekt erstellt und, falls erfolgreich, auf das angeschlossene VEX-Gerät heruntergeladen.
-
Wiedergabesymbol - Beim Anklicken des Wiedergabesymbols wird das heruntergeladene Benutzerprogramm im ausgewählten Slot auf dem VEX Brain ausgeführt.
-
Stoppsymbol - Beim Anklicken des wird die Ausführung des Benutzerprogramms auf dem VEX Brain gestoppt.
-
Projektauswahl - Die Projektauswahl zeigt den Namen des ausgewählten Projekts an. Mit dem Symbol Projektauswahlsymbol können wir zwischen VEX-Projekten wechseln, wenn mehrere im Arbeitsbereich vorhanden sind, indem wir darauf klicken und ein Projekt aus der Auswahlliste auswählen.
-
Python-Dateiauswahl (nur Python) - Wenn ein VEX Python-Projekt ausgewählt ist, erscheint die Python-Dateiauswahl in der Symbolleiste. Der Python-Dateiauswahldialog zeigt den Namen der ausgewählten Python Datei an. Python für VEX unterstützt derzeit nur das Herunterladen einzelner Dateien.
Hilfreiche Informationen zur Verwendung der Toolbar-Funktionen in VS Code finden Sie diesem Artikel.
VEX-Benutzereinstellungen
Die VEX-Benutzereinstellungen ermöglichen es uns, die VEX-Erweiterung nach unseren eigenen Anforderungen zu konfigurieren. Benutzereinstellungen sind globale Einstellungen, die für jedes VEX VS Code-Erweiterungsprojekt gelten. Wir können auf die -Benutzereinstellungen zugreifen indem wir in VS Code auf das Symbol „Einstellungen“ klicken und die entsprechenden Menüpunkte auswählen.
Die VEX-Benutzereinstellungen zur Konfiguration der VEX VS Code-Erweiterung lauten:
- Controller-Kanal (nur V5 Controller) - Stellt den V5 Controller-Funkkanal auf Download oder Pit. Diese Einstellung gilt nur für die VEXnet-Funkverbindung.
- Cpp Toolchain Path - Legt den Pfad für die CPP Toolchain fest.
- Benutzerterminal aktivieren- Aktiviert oder deaktiviert die Erweiterung zum Öffnen und Anzeigen von Daten vom Benutzerport.
- Logeinträge - Legt die Anzahl der Logeinträge fest, die von einem VEX Brain hochgeladen werden sollen.
- Projekt-Build-Typ - Legt fest, wie die Erweiterung ein C++-Projekt erstellt.
- Projektstartseite - Legt den Standardspeicherort für neue Projekte fest.
- Nach dem Download ausführen - Legt fest, ob das Benutzerprogramm nach dem Herunterladen auf ein VEX Brain ausgeführt werden soll.
- System DFU Auto Recover - Legt fest, ob das Gehirn sich automatisch wiederherstellen soll, wenn ein IQ2 oder EXP im DFU-Modus erkannt wird.
- Websocket-Server aktivieren - Aktiviert oder deaktiviert die Erweiterung zum Starten des Websocket-Servers.
- Websocket Server Host Address - Legt die Hostadresse des Websocket-Servers fest.
- Websocket-Server-Port - Legt die Portnummer des Websocket-Servers fest
Hilfreiche Informationen zum Zugriff auf und zur Konfiguration der VEX-Benutzereinstellungen finden in diesem.