Dieser Artikel gibt einen Überblick über die VEX Visual Studio Code Extension UI (Benutzeroberfläche). Die Erweiterung unterstützt die Entwicklung von C++- und Python-Projekten für die Plattformen VEX IQ 2nd Generation, EXP und V5.
UI-Komponenten
Die VEX VS Code Extension besteht aus drei Hauptkomponenten.
- Symbolleiste
- Aktivitätsleiste und Seitenleiste
- Anschlussfeld
Symbolleiste
Die Symbolleiste bietet Benutzern eine schnelle Möglichkeit, mit den VEX VS Code -Erweiterungsprojekten VEX Brains und VEX Controllers zu interagieren. Die Symbolleiste ist nur aktiv, wenn ein gültiges VEX-Projekt in VS Codegeöffnet ist. Ein gültiges VEX-Projekt ist ein Projekt, das von der Erweiterung erstellt oder importiert wird. Das Öffnen eines VEXcode- oder VEXcode Pro-Projekts ist ungültig und muss importiert werden.
Geräteauswahl
Die Geräteauswahl hat zwei Hauptfunktionen. Zunächst wird ein Gehirn- oder Controller-Symbol angezeigt, das den angeschlossenen VEX-Gerätetyp darstellt.
Zweitens wird beim Klicken auf das Gerätelistensymbol eine Schnellauswahlliste mit allen angeschlossenen VEX-Geräten angezeigt. Der Benutzer kann auswählen, mit welchem Gerät die Erweiterung verbunden wird.
Das aktuell verbundene Gerät erscheint immer oben in der Liste, gefolgt von allen anderen Geräten, sortiert nach Gerätetyp (Brain oder Controller) und Plattform (IQ 2. Generation, EXP und V5).
Jedes Geräteelement enthält Informationen zu Brain Name, Plattform, Gerätetyp und Gerätepfad.
Wichtig
Wenn ein Controller mit einem Computer verbunden ist, aber keine Funkverbindung zu einem Gehirn hat, wird neben dem Listenelement oder dem Statusleistensymbol der Geräteliste kein Gehirnname angezeigt.
Slot-Auswahl
Mit dem Slot-Auswahlsymbol kann der Benutzer auswählen, auf welchem Slot die Erweiterung ein Benutzerprogramm herunterladen oder abspielen soll.
Wenn auf das Slot-Auswahlsymbol geklickt wird, erscheint eine Schnellauswahlliste mit den verfügbaren Benutzerprogramm-Slots 1–8.
Erstellen/Herunterladen
Das Build/Download-Symbol ändert die Funktionen, wenn ein VEX Brain oder ein VEX Controller angeschlossen ist.
Wenn kein VEX-Gerät angeschlossen ist, wird das Build-Symbol angezeigt. Wenn Sie darauf klicken, wird das Projekt nur erstellt.
Wenn ein VEX-Gerät angeschlossen ist, wird das Download-Symbol angezeigt. Wenn Sie darauf klicken, wird das Projekt erstellt und bei Erfolg auf das VEX-Gerät heruntergeladen.
Spielen
Wenn Sie auf das Wiedergabesymbol klicken, wird das Benutzerprogramm im ausgewählten Slot ausgeführt.
Stoppen
Wenn Sie auf das Stoppsymbol klicken, wird ein Benutzerprogramm gestoppt.
Ausgewählter Arbeitsbereich
VS Code unterstützt Projekte mit mehreren Arbeitsbereichen. Mit der Projektauswahl können Benutzer zwischen VEX-Projekten wechseln, wenn mehrere im Arbeitsbereich vorhanden sind.
Wenn Sie auf das Projektauswahlsymbol klicken, wird eine Schnellauswahlliste mit allen gültigen Projekten angezeigt.
Wichtig
Wenn ein Projekt ungültig ist, wird es nicht in der Projekt-Schnellauswahlliste angezeigt. Ein Projekt ist nur dann gültig, wenn es von der VEX VS Code -Erweiterung erstellt oder importiert wurde.
Python-Dateiauswahl (nur Python)
Wenn ein VEX-Python-Projekt ausgewählt wird, erscheint die Python-Dateiauswahl in der Symbolleiste. Python für VEX unterstützt derzeit nur das Herunterladen einzelner Dateien.
Wenn Sie auf das Symbol klicken, wird eine Schnellauswahlliste mit allen Python-Dateien angezeigt, die sich im Arbeitsbereichsverzeichnis befinden.
Mit der Python-Dateiauswahl kann der Benutzer zwischen Python-Quelldateien (.py) wechseln.
VEX-Aktivitätsleiste und Seitenleiste
Projekte Aktionen
Die Vex-Aktivitätsleiste enthält die Ansicht „Projektaktionen“ und die Ansicht „VEX-Geräteinformationen“.
Die Ansicht „Projektaktionen“ wird zum Erstellen eines neuen Projekts oder zum Importieren eines vorhandenen VEXcode- oder VEXcode Pro-Projekts verwendet.
Versionsinformationen werden auch in der unteren linken und rechten Ecke der Ansicht angezeigt.
Wichtig
Wenn ein VEXcode- oder VEXcode Pro-Projekt im Editor geöffnet ist, wird es nicht als gültiges VEX-Projekt betrachtet. Das Projekt muss über die Schaltfläche „Importieren“ in der VEX-Seitenleiste importiert werden.
VEX-Geräteinformationen
Die VEX-Geräteinfo-Ansicht gibt dem Benutzer einen Überblick über das angeschlossene VEX Brain oder den VEX Controller. In dieser Ansicht finden Sie VEXos-Version, Pfad zur seriellen Schnittstelle, Benutzerprogramm und Geräteinformationen. Andere Funktionen wie VEXos-Firmware-Updates, Screenshots, das Festlegen des Gehirnnamens und der Teamnummer können ebenfalls über diese Ansicht ausgeführt werden.
System Information
Die Systeminformationen bieten einen kurzen Überblick über ein angeschlossenes VEX-Gerät. Dazu gehören die VEXos-Version eines Geräts, der Brain-Name, die Teamnummer, die Brain-ID und Informationen zur Python-Laufzeitversion.
Informationen zur seriellen Schnittstelle
Die Informationen zum seriellen Port zeigen den Gerätepfad für jeden Port an, der für ein VEX-Gerät verfügbar ist. Die meisten VEX-Geräte verfügen über zwei serielle Ports. Der serielle Kommunikationsanschluss wird zum Herunterladen von Programmen und zur Steuerung der Gehirnfunktionen verwendet. Der serielle Benutzeranschluss wird zum Übertragen von Daten zwischen der auf dem Brain ausgeführten Benutzer-App und dem über USB angeschlossenen Host-Computer verwendet. Der V5-Controller ist das einzige VEX-Gerät, das nur über einen seriellen Kommunikationsanschluss und keinen seriellen Benutzeranschluss verfügt.
Programminformationen
Programminformationen zeigen eine Liste aller heruntergeladenen Benutzerprogramme auf einem VEX Brain an.
Jedes Programmlistenelement kann erweitert werden, um zusätzliche Informationen zu jedem Benutzerprogramm anzuzeigen, z. B. Slot-Speicherort, Dateiname, Sprachtyp, Dateigröße und Zeitpunkt des Downloads.
Geräteinformationen
Geräteinformationen zeigen eine Liste aller Smart-Port-Geräte, die mit einem VEX Brain verbunden sind. Jedes Listenelement zeigt die Smart-Port-Nummer und den Gerätetyp an.
Jedes Element in der Geräteliste kann erweitert werden, um Firmware-Versionsinformationen zu jedem Smart-Port-Gerät anzuzeigen.
Der Status der Controller-Verknüpfung wird angezeigt, wenn eine Verbindung zum VEX Brain-Gerät besteht.
VEX Brain ist mit einem VEX Controller verbunden
VEX Brain ist nicht mit einem VEX-Controller verbunden
Der VEX V5-Controller ist an ein VEX V5-Gehirn angeschlossen
Screenshots
Durch Klicken auf das Kamerasymbol kann ein Benutzer einen Screenshot von einem VEX Brain erstellen und herunterladen.
Screenshots sind nur verfügbar, wenn eine direkte Verbindung zu einem VEX Brain über USB besteht
Battery Medic (nur V5 Brain)
Durch Klicken auf das Herzsymbol lädt die Erweiterung das Benutzerprogramm „Battery Medic“ herunter und führt es aus.
Legen Sie den Gehirnnamen fest
Durch Klicken auf das Bleistiftsymbol neben dem System->-Namen kann ein Benutzer den Namen für ein VEX Brain festlegen.
Nachdem Sie auf das Bleistiftsymbol geklickt haben, wird oben im VS-Code-Editor ein Eingabefeld angezeigt. Geben Sie den neuen Gehirnnamen in das Eingabefeld ein und drücken Sie zum Festlegen die Eingabetaste.
Teamnummer festlegen
Durch Klicken auf das Bleistiftsymbol neben System->-Team kann ein Benutzer die Teamnummer für ein VEX Brain festlegen.
Nachdem Sie auf das Bleistiftsymbol geklickt haben, wird oben im VS-Code-Editor ein Eingabefeld angezeigt. Geben Sie die neue Teamnummer in das Eingabefeld ein und drücken Sie zum Festlegen die Eingabetaste.
Benutzerprogramm löschen
Durch Klicken auf das Symbol Papierkorb neben „Programme –>Projektname“ kann ein Benutzer ein Programm in einem bestimmten Slot löschen. WICHTIG: Sobald Sie ein Programm gelöscht haben, kann es nicht wiederhergestellt werden. Bitte seien Sie vorsichtig, wenn Sie diese Funktion verwenden.
Warnungen zu Geräteinformationen
VEXos-Update
Wenn die VEXos-Version eines VEX Brain veraltet ist, wird neben der VEXos-Version ein Warnmeldungssymbol angezeigt und beide Brain-Symbole werden gelb.
Um diese Warnung zu beheben, sollte ein Benutzer VEXos für sein VEXos Brain aktualisieren.
VEXos können aktualisiert werden, indem Sie auf den Aufwärtspfeil neben dem VEX Brain-Symbol klicken.
Außerdem wird in der unteren rechten Ecke des VS-Code-Editors ein Benachrichtigungsfeld angezeigt, wenn VEXos veraltet ist. Ein Benutzer kann ein VEXos-Update starten, indem er auf die Schaltfläche „Aktualisieren“ klickt, oder auf die Schaltfläche „Ignorieren“, um das VEXos-Update zu überspringen.
Gehirn ist nicht mit verbundenem Controller verbunden
Das VEX-Controller-Symbol wird gelb, wenn ein VEX-Controller an einen Computer angeschlossen, aber nicht mit einem VEX Brain verbunden ist.
Um diese Warnung zu beheben, sollte ein Benutzer einen VEX-Controller mit einem VEX Brain verbinden
Anschlussfeld
Die VEX VS Code Extension stellt beim Start zwei Terminals bereit, das Log Terminal und das Interactive Terminal
Log-Terminal
Das Protokollterminal zeigt Build-Ausgabe, Build-Fehler und Download-Ergebnisse an.
Interaktives Terminal
Das interaktive Terminal verfügt über zwei Funktionen: das Anzeigen von Druckprotokollen und das Zurücksenden roher Tastenanschläge an ein Benutzerprogramm. Um die Vorteile des interaktiven Terminals nutzen zu können, muss ein Brain oder Controller mit einem Computer verbunden sein, auf dem die VEX VS Code Extension ausgeführt wird. Die interaktive Terminalausgabe wird nach dem Erstellen und Herunterladen eines Benutzerprogramms standardmäßig gelöscht.
Benutzereinstellungen
Benutzereinstellungen sind globale Einstellungseinstellungen, die Visual Studio Code für jede Erweiterung bietet. Benutzereinstellungen werden auf jedes VEX VS Code-Erweiterungsprojekt angewendet.
So greifen Sie auf die VEX-Benutzereinstellungen zu
Klicken Sie auf das Zahnrad in der linken Ecke von VS Code und ein Kontextmenü wird angezeigt
Klicken Sie im Kontextmenü auf den Punkt „Einstellungen“ und es erscheint eine Einstellungsseite.
Klicken Sie in der linken Listenansicht auf den Eintrag „Erweiterungen“. Scrollen Sie als Nächstes nach unten und suchen Sie den Eintrag mit der Bezeichnung „VEX“.
Klicken Sie auf den Listeneintrag „VEX“.
Die VEX-Benutzereinstellungen werden im rechten Bereich angezeigt.
Übersicht über die Einstellungen
Controller-Kanal (nur V5-Controller)
Die Einstellung Controller-Kanal steuert den Funkkommunikationskanaltyp zwischen einem V5 Brain und einem V5 Controller.
Diese Einstellung gilt nur, wenn VS Code über USB mit einem V5-Controller verbunden ist und der Controller über VEXnet mit einem V5 Brain verbunden ist. Der Benutzer kann zwischen Download und Pit Kanälen wählen. Bei der Einstellung Downloadspringt das Radio zu einem Download-VEXnet-Kanal, sobald ein Benutzerprogramm-Download initiiert wird. Der Download-Kanal ermöglicht höhere Datenraten und effizientere Downloads. Bei der Einstellung Pitbleibt das Radio auf einem Pit-Kanal und der Download dauert viel länger. Standardmäßig ist diese Einstellung auf Downloadeingestellt.
Cpp-Projekt-SDK-Startseite
BEARBEITEN SIE DIESE EINSTELLUNG NICHT.
Cpp-Toolchain-Pfad
Cpp Toolchain Path legt den Pfad für die Toolchain fest, die beim Erstellen eines C++ VEX VS Code -Projekts verwendet wird.
Benutzerterminal aktivieren
Die Einstellung Benutzerterminal aktivieren“ ermöglicht es der Erweiterung, den seriellen Benutzerport zu öffnen, wenn ein VEX Brain oder VEX Controller von der Erweiterung erkannt wird. Die einzige Ausnahme gilt für einen V5-Controller, der nicht mit einem seriellen Benutzerport nummeriert ist.
Aktivieren ermöglicht der Erweiterung, beim Start eine Verbindung zu einem Benutzerport herzustellen und erstellt das interaktive Terminal. Wenn „Aktivieren“ ausgewählt wird, während die Erweiterung ausgeführt wird, versucht die Erweiterung, den Benutzerport zu öffnen, wenn ein Gerät angeschlossen ist.
Deaktivieren verhindert, dass die Erweiterung beim Start eine Verbindung zum Benutzerport herstellt und erstellt kein interaktives Terminal. Wenn „Deaktivieren“ ausgewählt wird, während die Erweiterung ausgeführt wird, schließt die Erweiterung den Benutzerport und entfernt das interaktive Terminal.
Projekt-Build-Typ
Project Build Type legt fest, wie die Erweiterung ein C++-Projekt erstellt. Der Benutzer kann den Build-Typ auf „Build“ oder „Rebuild“ festlegen.
Build erstellt das Projekt nur, wenn Make Änderungen im Quellcode des Projekts erkennt.
Rebuild bereinigt das Build-Verzeichnis des Projekts und erstellt dann das Projekt. Diese Option ist normalerweise viel langsamer.
Projekthaus
Project Home legt das Standard-Home-Verzeichnis für ein neues Projekt fest, wenn der Assistent für neue Projekte abgeschlossen wird.
Nach dem Download ausführen
Nach Download ausführen Wenn diese Option aktiviert ist, wird das Benutzerprogramm ausgeführt, nachdem es auf ein VEX Brain heruntergeladen wurde.
Python SDK-Startseite
BEARBEITEN SIE DIESE EINSTELLUNG NICHT.
VEX-Befehlshilfe
Die VEX-Befehlshilfe ermöglicht den Zugriff auf die Dokumentation für bestimmte Funktionen, die in der C++- und Python-API (Application Programming Interface) enthalten sind. Die Dokumentation ist für jede VEX-Plattform spezifisch (IQ 2. Generation, EXP, V5).
Um auf die VEX-Befehlshilfe zuzugreifen, markieren Sie zunächst den Text der zu suchenden Funktion.
Klicken Sie mit der rechten Maustaste auf den ausgewählten Text und ein Kontextmenü wird angezeigt.
Weiter Klicken Sie auf die VEX-Befehlshilfe, um auf die Dokumentation zuzugreifen.
Wenn VEX Command Help eine genaue Übereinstimmung findet, wird eine neue Webansicht mit relevanter Dokumentation angezeigt.
Wenn mehrere Dokumente mit dem ausgewählten Text übereinstimmen, wird ein Dropdown-Menü mit einer gefilterten Liste relevanter Dokumentation angezeigt.