Übersicht über die VEX VS Code-Erweiterungs-Benutzeroberfläche

Dieser Artikel bietet einen Überblick über die Benutzeroberfläche (UI) der VEX Visual Studio Code Extension. 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-Erweiterung UI-Layout

Die Benutzeroberfläche der VEX Visual Studio Code Extension ist in fünf Hauptbereiche unterteilt: Aktivitätsleiste, Seitenleiste, Editor, Terminalbereich und Symbolleiste.

Aktivitätsleiste

Die Aktivitätsleiste verfügt über eine Reihe von Symbolen, mit denen wir zwischen Ansichten wechseln können und die uns zusätzliche kontextspezifische Indikatoren für die VEX-Projektentwicklung bieten.

Die folgenden allgemeinen Symbole werden für die Entwicklung eines VEX-Projekts in VS Code verwendet:

• Explorer-Ansicht-Symbol – Beim Klicken wird die Explorer-Ansicht in der Seitenleiste geöffnet.
• Erweiterungsansicht-Symbol – Beim Klicken wird die Erweiterungsansicht in der Seitenleiste geöffnet.
• VEX-Ansichtssymbol – Beim Klicken wird die VEX-Ansicht in der Seitenleiste geöffnet.

Seitenleiste

Die Seitenleiste enthält verschiedene Ansichten, die es uns ermöglichen, die integrierten Tools in VS Code zu verwenden. Die allgemeinen Seitenleistenansichten, die zum Ausführen von Aufgaben für die VEX-Projektentwicklung verwendet werden, sind Erweiterungsansicht, VEX-Ansichtund Explorer-Ansicht.

Erweiterungsansicht

Die Extension View wird zum Installieren und Verwalten der Erweiterungen in VS Code verwendet. Für die Entwicklung von Software auf VEX IQ-Plattformen der 2. Generation, EXP und V5 müssen wir die VEX-Erweiterung, die C/C++-Erweiterung und die Python-Erweiterung installieren.

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

Mit VEX View können wir Projekte für VEX IQ 2. Generation, EXP und V5 in VS Code entwickeln. Die VEX-Ansicht umfasst drei Kategorien: „PROJEKTAKTIONEN“, VEX-GERÄTEINFO, und „VEX-FEEDBACK“.

• PROJEKTAKTIONEN
  Die Schaltflächen unter PROJEKTAKTIONEN werden verwendet, um ein neues VEX-Projekt zu erstellen oder ein vorhandenes VEXcode-Projekt zu importieren.
  Detaillierte Anleitungen zum Erstellen eines VEX-Projekts in VS Code finden Sie in diesem Artikel für V5, in diesem Artikel für EXPund in diesem Artikel für IQ (2.).

• VEX-GERÄTEINFO
  Die Kategorie VEX-GERÄTEINFO bietet uns eine Übersicht über das angeschlossene VEX-Gerät – ein VEX Brain oder einen VEX-Controller.
  
  

  

  
  Diese Kategorie gibt den angeschlossenen VEX-Gerätetyp an und zeigt die Informationen zum Brain-System, zum seriellen Port, zum heruntergeladenen Programm und zu den Geräten an, die an die Smart Ports des VEX Brain angeschlossen sind. Damit können wir einen Screenshot des VEX Brain-Bildschirmsmachen, das VEX Brain-Ereignisprotokoll anzeigen, den V5 Battery Medic verwenden, den Brain-Namen und die Teamnummerfestlegen und das Benutzerprogramm vom VEX Brain löschen
  
  Wenn ein VEX Brain mit dem Computer verbunden ist, zeigt die Kategorie VEX DEVICE INFO an, ob ein VEX Controller mit dem VEX Brain verbunden ist und ermöglicht uns, das VEXos für das VEX Brain zu aktualisieren, wenn die VEXos-Version des VEX Brain veraltet ist.
  
  Wenn ein VEX Controller mit dem Computer verbunden ist, zeigt die Kategorie VEX DEVICE INFO an, ob ein VEX Brain mit dem VEX Controller verbunden ist und ermöglicht uns, das VEXos für den VEX Controller zu aktualisieren, wenn die VEXos-Version des VEX Controllers veraltet ist.
  
  Eine umfassende Beschreibung der Geräteinformationen und der Verwendung der Funktionen unter VEX-GERÄTEINFOfinden 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 VEX-FEEDBACK in VS Code finden Sie in diesem Artikel.
  
  

Explorer-Ansicht

Die Explorer-Ansicht wird zum Durchsuchen, Öffnen und Verwalten der VEX-Projektdateien und -ordner in VS Code verwendet.

Editor

Der Editor ist der Hauptbereich zum Bearbeiten der 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 Entwicklung des Programms 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 die VEX-Befehlshilfe verwenden, um auf die Dokumentation zu dieser Funktion zuzugreifen, die in der C++- und Python-API (Application Programming Interface) enthalten ist.

Ausführliche Anweisungen zur Verwendung der VEX-Befehlshilfe in VS Code finden Sie in diesem Artikel.

Anschlussfeld

Die VEX VS Code-Erweiterung bietet beim Start zwei Terminals, das Protokollterminal und das interaktive Terminal. 

• Protokollterminal – Das Protokollterminal zeigt Build-Ausgabe, Build-Fehler und Download-Ergebnisse an.
  
  

• Interaktives Terminal - Das interaktive Terminal hat zwei Funktionen: Anzeige von Druckprotokollen und Zurücksenden von Rohtastenanschlägen an ein Benutzerprogramm.
  
  

  

  
  
  Hinweis: Um das interaktive Terminal zu verwenden, muss ein Brain oder Controller an einen Computer angeschlossen sein, auf dem die VEX VS Code Extension läuft.
  Hinweis: Die Ausgabe des interaktiven Terminals wird standardmäßig gelöscht, nachdem ein Benutzerprogramm erstellt und heruntergeladen wurde.

Symbolleiste

Die Symbolleiste enthält eine Reihe von Symbolen, die uns eine schnelle Möglichkeit zur Interaktion mit VEX VS Code-Erweiterungsprojekten, VEX Brains und VEX Controllern bieten.

Hinweis: Die Symbolleiste ist nur aktiv, wenn ein gültiges VEX-Projekt in VS Code geöffnet ist. 

Hinweis: Ein gültiges VEX-Projekt ist ein Projekt, das von der Erweiterung erstellt oder importiert wird. Im Editor geöffnete VEXcode- oder VEXcode Pro-Projekte werden nicht als gültige VEX-Projekte betrachtet und müssen importiert werden.

Zu den in der Symbolleiste enthaltenen Symbolen gehören:

• Geräteauswahl - Die Geräteauswahl zeigt das Symbol des angeschlossenen VEX-Geräts an (ein Gehirnsymbol oder ein Controllersymbol )
  Hinweis: Wenn ein Controller an den Computer angeschlossen ist, aber keine Funkverbindung zu einem Gehirn besteht, wird neben dem Controllersymbol kein Gehirnname angezeigt.

• Slot-Auswahlsymbol – Mit dem Slot-Auswahlsymbol können wir auswählen, auf welchen Slot die VEX-Erweiterung ein Benutzerprogramm herunterladen oder abspielen soll, indem wir darauf klicken und aus der Auswahlliste einen der acht verfügbaren Slots auf dem VEX-Gehirn auswählen.
• Build & Download-Symbol – Wenn ein VEX-Gerät angeschlossen ist, wird das Download-Symbol in der Symbolleiste angezeigt. Wenn Sie darauf klicken, wird das Projekt erstellt und, sofern erfolgreich, auf das verbundene VEX-Gerät heruntergeladen.
• Wiedergabesymbol – Wenn auf das Wiedergabesymbol geklickt wird, wird das heruntergeladene Benutzerprogramm im ausgewählten Slot auf dem VEX Brain ausgeführt.
• Stoppsymbol – Wenn auf das Stoppsymbol geklickt wird, wird die Ausführung des Benutzerprogramms auf dem VEX Brain gestoppt.
• Projektauswahl – Die Projektauswahl zeigt den Namen des ausgewählten Projekts an. Mit dem 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, wird die Python-Dateiauswahl in der Symbolleiste angezeigt. Der Python File Selector 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 in diesem Artikel.

VEX-Benutzereinstellungen

Die VEX-Benutzereinstellungen ermöglichen es uns, die VEX-Erweiterung entsprechend unseren eigenen Anforderungen zu konfigurieren. Benutzereinstellungen sind globale Einstellungen, die auf jedes VEX VS Code-Erweiterungsprojekt angewendet werden. Wir können auf die VEX-Benutzereinstellungen zugreifen, indem wir in VS Code auf das Einstellungssymbol klicken und die entsprechenden Elemente in den Menüs auswählen.

Die VEX-Benutzereinstellungen zum Konfigurieren der VEX VS Code-Erweiterung sind:

• Controllerkanal (nur V5-Controller) – Legt den Funkkanal des V5-Controllers auf Download oder Pitfest. Diese Einstellung gilt nur für die VEXnet-Funkverbindung.

• Cpp-Toolchain-Pfad – Legt den Pfad für die CPP-Toolchain fest.
• Benutzerterminal aktivieren– Aktiviert oder deaktiviert die Erweiterung zum Öffnen und Anzeigen von Daten vom Benutzerport.
• Protokolleinträge – Legt die Anzahl der Protokolleinträge fest, die von einem VEX Brain hochgeladen werden sollen.
• Projekterstellungstyp – Legt fest, wie die Erweiterung ein C++-Projekt erstellt.
• Projekt-Homepage – Legt den Standardspeicherort für neue Projekte fest.
• Nach 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 Brain automatisch wiederhergestellt werden soll, wenn im DFU-Modus ein IQ2 oder EXP erkannt wird.
• Websocket-Server aktivieren – Aktiviert oder deaktiviert die Erweiterung zum Starten des Websocket-Servers.
• Websocket-Server-Hostadresse – Legt die Hostadresse des Websocket-Servers fest.
• Websocket-Server-Port - Legt die Portnummer des Websocket-Servers fest

Hilfreiche Informationen zum Zugriff auf die VEX-Benutzereinstellungen und deren Festlegung finden Sie in diesem Artikel.