Die Benutzereinstellungen für die VEX VS Code-Erweiterung verstehen

Benutzereinstellungen sind globale Einstellungen, die Visual Studio Code für jede Erweiterung anbietet. Die VEX-Benutzereinstellungen ermöglichen es uns, die VEX-Erweiterung nach unseren eigenen Anforderungen zu konfigurieren und werden auf jedes VEX VS Code-Erweiterungsprojekt angewendet.

Zugriff auf die VEX-Benutzereinstellungen in VS Code

  • Klicken Sie auf das Einstellungssymbol unten links in der VS Code-Benutzeroberfläche.

    Das Symbol „Einstellungen“ befindet sich ganz unten in der VS Code-Aktivitätsleiste, die sich in der unteren linken Ecke des Bildschirms befindet.
  • Das Kontextmenü wird angezeigt. Klicken Sie auf den Eintrag Einstellungen.

    Das Kontextmenü der VS Code-Einstellungen bietet zahlreiche Optionen. Eine Option mit der Bezeichnung „Einstellungen“ ist hervorgehoben und befindet sich als dritte Option im Menü unterhalb von „Befehlspalette“ und „Profile“.
  • Das Fenster Einstellungen wird angezeigt.

    Das VS Code-Einstellungsfenster ist geöffnet und zeigt standardmäßig den Artikel „Häufig verwendete Einstellungen“ an.
  • Klicken Sie im linken Bereich des Fensters Einstellungen auf den Eintrag Erweiterungen , um die Liste der zu erweitern und deren Elemente anzuzeigen.

    Das VS Code-Einstellungsfenster ist geöffnet und die Kategorie „Erweiterungen“ ist in der linken Navigationsleiste hervorgehoben.
  • Scrollen Sie in der Listenansicht bis ganz nach unten und klicken Sie auf den Listeneintrag VEX.

    Das VS Code-Einstellungsfenster ist geöffnet und der Link zur VEX-Seite innerhalb der Kategorie Erweiterungen ist hervorgehoben.
  • Die VEX Benutzereinstellungen werden im rechten Bereich angezeigt.

    Die VS Code-Benutzereinstellungen öffnen die VEX-Seite, auf der das Verhalten der VEX Robotics Extension angepasst werden kann.

VEX-Benutzereinstellungen – Übersicht

  • 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.
    Um den V5 Controller Funkkanal einzustellen, klicken Sie auf das Dropdown-Menü und wählen Sie zwischen Download und Pit
    • Download - Bei Einstellung auf Downloadwechselt das Radio automatisch zu einem Download-Kanal von VEXnet, sobald ein Benutzerprogramm heruntergeladen wird. Der Downloadkanal ermöglicht höhere Datenraten und effizientere Downloads. 
    • Pit - Bei Einstellung Pit, bleibt das Funkgerät auf einem Boxenkanal, und der Download dauert deutlich länger.

    Hinweis: Standardmäßig ist der V5 Controller-Funkkanal auf Downloadeingestellt.

    VEX-Benutzereinstellungen mit der angezeigten Option „Controller-Kanal“. Diese Option verfügt über ein Dropdown-Menü, das standardmäßig auf „Herunterladen“ eingestellt ist. Die Beschreibung lautet: Stellt den V5-Controller-Funkkanal ein. Diese Einstellung gilt nur für VEXnet-Funkverbindungen.
  • Cpp SDK: Home
    Die Einstellung Cpp SDK Home legt das Stammverzeichnis des C++ SDK (Software Development Kit) fest. Diese Einstellung definiert den Speicherort auf dem Computer, an dem das C++ SDK installiert ist.
    Hinweis: DIESE EINSTELLUNG NICHT BEARBEITEN.

    VEX-Benutzereinstellungen mit der Option „Cpp SDK Home“ werden angezeigt. Diese Option enthält einen Link mit der Aufschrift „In settings.json bearbeiten“. In der Beschreibung steht: NICHT BEARBEITEN.
  • Cpp-Toolchain: Pfad
    Die Einstellung Cpp-Toolchain-Pfad legt den Pfad für die Toolchain fest, die beim Erstellen eines C++ VEX VS Code-Projekts verwendet wird.
    Um den Pfad zur Cpp-Toolchain festzulegen, geben Sie den Pfad zur Toolchain auf dem Computer in das Textfeld ein.

    VEX-Benutzereinstellungen mit der Cpp-Toolchain: Pfadoption angezeigt. Diese Option verfügt über ein Textfeld, das einen Dateipfad darstellt. Die Beschreibung lautet: Pfad zur Toolchain.
  • Allgemein: Benutzerterminal aktivieren
    Die Einstellung Benutzerterminal aktivieren ermöglicht es der VEX-Erweiterung, den seriellen Benutzerport zu öffnen, wenn ein VEX Brain oder VEX Controller von der Erweiterung erkannt wird. Die einzige Ausnahme betrifft einen V5-Controller, der nicht mit einem seriellen Benutzerport enumeriert.
    Um die Einstellung Benutzerterminal aktivieren festzulegen, klicken Sie auf das Dropdown-Menü und wählen Sie zwischen Aktivieren und Deaktivieren
    • Aktivieren - Aktivieren ermöglicht es der VEX-Erweiterung, sich beim Start mit einem Benutzerport zu verbinden und das interaktive Terminal zu erstellen. Wenn bei laufender Erweiterung die Option Aktivieren ausgewählt ist, versucht die Erweiterung, den Benutzerport zu öffnen, wenn ein Gerät angeschlossen ist.
    • Deaktivieren - Deaktivieren verhindert, dass die VEX-Erweiterung beim Start eine Verbindung zum Benutzerport herstellt und ein interaktives Terminal erstellt. Wenn bei laufender Erweiterung die Option Deaktivieren ausgewählt wird, schließt die Erweiterung den Benutzerport und entfernt das interaktive Terminal.
    Hinweis: Standardmäßig ist die Einstellung Benutzerterminal aktivieren auf Aktiviereneingestellt.

    VEX-Benutzereinstellungen mit der Option „Allgemein: Benutzerterminal aktivieren“ wird angezeigt. Diese Option verfügt über ein Dropdown-Menü, das standardmäßig auf „Aktiviert“ eingestellt ist. Die Beschreibung lautet: Aktiviert die Erweiterung, um Daten vom Benutzerport zu öffnen und anzuzeigen.
  • Allgemein: Protokolleinträge
    Die Einstellung Protokolleinträge legt die Anzahl der vom VEX Brain hochzuladenden Protokolleinträge fest.
    Um die Anzahl der Protokolleinträge festzulegen, geben Sie die Zahl in das Textfeld ein.
    Hinweis: Standardmäßig ist die Anzahl der Logeinträge auf 1000 eingestellt.

    VEX-Benutzereinstellungen mit der Option „Allgemeine Protokolleinträge“ werden angezeigt. Diese Option verfügt über ein Textfeld, das standardmäßig auf die Zahl 1000 eingestellt ist. Die Beschreibung lautet: Legt die Anzahl der Logeinträge fest, die von einem VEX Brain hochgeladen werden sollen.
  • Projekt: Build-Typ
    Die Einstellung Projekt: Build-Typ legt fest, wie die VEX-Erweiterung ein C++-Projekt erstellt.
    Um den Build-Typ des Cpp-Projekts festzulegen, klicken Sie auf das Dropdown-Menü und wählen Sie zwischen Build und Rebuild
    • Build - Build erstellt das Projekt nur dann, wenn Änderungen im Quellcode des Projekts erkannt werden.
    • Rebuild - Rebuild bereinigt das Build-Verzeichnis des Projekts und erstellt anschließend das Projekt. Diese Option ist deutlich langsamer.
    Hinweis: Standardmäßig ist der Build-Typ des Cpp-Projekts auf Buildeingestellt.

    VEX-Benutzereinstellungen mit der Option „Projekt-Build-Typ“ werden angezeigt. Diese Option verfügt über ein Dropdown-Menü, das standardmäßig auf „Erstellen“ eingestellt ist. Die Beschreibung lautet: „Set Cpp Project Build Type“.
  • Projekt: Home
    Die Einstellung Projekt: Home legt das Standardverzeichnis für ein neues Projekt fest, wenn der Assistent für neue Projekte abgeschlossen wird.
    Um den Standardspeicherort für neue Projekte festzulegen, geben Sie das Verzeichnis auf dem Computer in das Textfeld ein.

    VEX-Benutzereinstellungen mit der Option „Projektstartseite“ werden angezeigt. Diese Option verfügt über ein Textfeld, das einen Dateipfad darstellt. Die Beschreibung lautet: Legt den Standardspeicherort für neue Projekte fest.
  • Projekt: Nach dem Download ausführen
    Die Projekt: Nach dem Download ausführen Einstellung legt fest, ob das Benutzerprogramm nach dem Herunterladen auf ein VEX Brain ausgeführt werden soll.
    Um festzulegen, dass das Benutzerprogramm nach dem Herunterladen auf das VEX Brain ausgeführt wird, aktivieren Sie das Kontrollkästchen. Um zu verhindern, dass das Benutzerprogramm nach dem Download ausgeführt wird, deaktivieren Sie das Kontrollkästchen.
    Hinweis: Standardmäßig ist das Kontrollkästchen neben der Einstellung Projekt: Nach dem Download ausführen nicht ausgewählt .

    VEX-Benutzereinstellungen mit der Option „Projekt nach dem Download ausführen“. Diese Option verfügt über ein Kontrollkästchen, das standardmäßig nicht ausgewählt ist. Die Beschreibung lautet: Legt fest, ob das Benutzerprogramm nach dem Herunterladen ausgeführt werden soll.
  • Python: SDK Home
    Die Python SDK Home Einstellung legt das Stammverzeichnis des Python SDK (Software Development Kit) fest. Diese Einstellung definiert den Speicherort auf dem Computer, an dem das Python SDK installiert ist.
    Hinweis: DIESE EINSTELLUNG NICHT BEARBEITEN.

    VEX-Benutzereinstellungen mit der Option „Python SDK Home“ werden angezeigt. Diese Option enthält einen Link mit der Aufschrift „In settings.json bearbeiten“. In der Beschreibung steht: NICHT BEARBEITEN.
  • System DFU: Automatische Wiederherstellung
    Die Einstellung System DFU Automatische Wiederherstellung legt fest, ob das Brain automatisch wiederhergestellt werden soll, wenn ein IQ (2.) Brain oder ein EXP Brain im DFU-Modus (Geräte-Firmware-Update) erkannt wird.
    Um das Gehirn so einzustellen, dass es sich automatisch wiederherstellt, wenn ein IQ (2.) Gehirn oder ein EXP Gehirn im DFU-Modus erkannt wird, aktivieren Sie das Kontrollkästchen. Andernfalls deaktivieren Sie das Kontrollkästchen.
    Hinweis: Standardmäßig ist das Kontrollkästchen neben der Einstellung System DFU: Automatische Wiederherstellung ausgewählt.

    VEX-Benutzereinstellungen mit der Option „System DFU Auto Recover“ werden angezeigt. Diese Option verfügt über ein Kontrollkästchen, das standardmäßig aktiviert ist. Die Beschreibung lautet: Legen Sie fest, ob sich das Gehirn automatisch erholen soll, wenn im DFU-Modus ein IQ2 oder EXP erkannt wird.
  • Websocket-Server: Aktivieren
    Die Einstellung Websocket-Server: Aktivieren ermöglicht es der VEX-Erweiterung, den Websocket-Server zu starten, wodurch die Echtzeit-Datenübertragung zwischen dem Server und dem VEX-Gerät ermöglicht wird.
    Um die Einstellung Websocket Server: Aktivieren festzulegen, klicken Sie auf das Dropdown-Menü und wählen Sie zwischen Aktivieren und Deaktivieren
    • Aktivieren - Wenn Aktivieren ausgewählt ist, startet die VEX-Erweiterung den Websocket-Server, der dem Benutzer Zugriff auf eine bidirektionale Verbindung zum ausgewählten VEX-Gerät ermöglicht. Der Websocket-Server ist unter `ws://[ip]:[port]/vexrobotics.vexcode/device` erreichbar.
    • Deaktivieren - Wenn Deaktivieren ausgewählt ist, startet die VEX-Erweiterung den Wesocked-Server nicht. 
    Hinweis: Standardmäßig ist die Einstellung Websocket-Server: Aktivieren auf Deaktiviereneingestellt.

    VEX-Benutzereinstellungen mit aktivierter Websocket-Server-Option. Diese Option verfügt über ein Dropdown-Menü, das standardmäßig auf „Deaktiviert“ eingestellt ist. Die Beschreibung lautet: Ermöglicht der Erweiterung das Starten eines WebSocket-Servers. Der Server ermöglicht dem Benutzer den Zugriff auf eine bidirektionale Verbindung zum ausgewählten VEX-Gerät. Der WebSocket ist unter ws://[ip]:[port]/vexrobotics.vexcode/device erreichbar.
  • Websocket-Server: Hostadresse
    Die Einstellung Websocket-Server: Hostadresse legt die Hostadresse des WebSocket-Servers fest. Der Websocket-Server wird auf dem Computer gehostet, auf dem die VEX-Erweiterung ausgeführt wird. Die Hostadresse des WebSocket-Servers ist die IP-Adresse für den Zugriff auf den WebSocket-Server unter `ws://[ip]:[port]/vexrobotics.vexcode/device`.
    Um die Hostadressefestzulegen geben Sie die Hostadresse (IP-Adresse) in das Textfeld ein.

    VEX-Benutzereinstellungen mit der Option „Websocket-Server-Hostadresse“ werden angezeigt. Diese Option verfügt über ein Textfeld, das standardmäßig auf die Adresse 0.0.0.0 eingestellt ist. Die Beschreibung lautet: Legt die Hostadresse fest.


  • Websocket-Server: Port
    Die Einstellung Websocket-Server: Port konfiguriert die Portnummer des Ports, auf dem der Websocket-Server läuft. Die Portnummer kann für den Zugriff auf den WebSocket-Server unter `ws://[ip]:[port]/vexrobotics.vexcode/device` verwendet werden.
    Um die Websocket-Server-Portnummeroder einzustellen, geben Sie die Portnummer in das Textfeld ein.

    VEX-Benutzereinstellungen mit der Option „Websocket-Server-Port“ werden angezeigt. Diese Option verfügt über ein Textfeld, das in diesem Beispiel auf die Zahl 7071 eingestellt ist. Die Beschreibung lautet: Legt die Portnummer des WebSocket-Servers fest.

For more information, help, and tips, check out the many resources at VEX Professional Development Plus

Last Updated: