Konfigurieren des GPS-Sensors in VEXcode V5

Um die Daten des Game Positioning System™ (GPS)-Sensors in einem Projekt nutzen zu können, muss der Sensor zunächst als Gerät in VEXcode V5 hinzugefügt werden. Dieser Artikel führt Sie durch die Konfiguration des GPS-Sensors in VEXcode V5. Sehen Sie sich das Video unten an, um mehr über die in diesem Artikel behandelten Konzepte zu erfahren.

Gerät hinzufügen

Wenn Sie mit VEXcode V5zu programmieren beginnen, werden Blöcke für den GPS-Sensor erst in der Toolbox angezeigt, wenn dieser konfiguriert wurde. Um den GPS-Sensor zu konfigurieren, fügen Sie ihn als Gerät zu Ihrem Projekt hinzu.

VEXcode V5 Toolbar mit hervorgehobenem Gerätesymbol zwischen den Symbolen Code Viewer und Druckkonsole.

Wählen Sie das Gerätesymbol aus.

VEXcode V5 Gerätemenü mit hervorgehobener Schaltfläche „Gerät hinzufügen“.

Wählen Sie Gerät hinzufügen.

VEXcode V5 Geräte-Menü nach Auswahl der Schaltfläche "Gerät hinzufügen". Die GPS-Option ist hervorgehoben.

Wählen Sie GPS.

VEXcode V5 Gerätemenü mit Anzeige der Smart Port-Optionen für den GPS-Sensor. In diesem Beispiel ist der Smart Port mit der Nummer 1 hervorgehoben.

Wählen Sie den Smart Port aus, an den der GPS-Sensor am V5 Robot Brain angeschlossen ist.

VEXcode V5 Gerätemenü nach Auswahl der Smart Ports und bei Anzeige des Bildschirms GPS-Einstellungen. Unten ist die Schaltfläche „Fertig“ hervorgehoben.

Wählen SieFertig, um den GPS-Sensor als Gerät hinzuzufügen, ohne die Offsets festzulegen.

Um mehr über GPS-Sensor-Offsets zu erfahren, lesen Sie den folgenden Abschnitt.

GPS-Sensor-Offsets

Was ist ein Offset?

In der Konfiguration haben Sie die Möglichkeit, Offset-Informationen hinzuzufügen. Ein Versatz ist die Differenz zwischen einem Referenzpunkt auf dem Roboter und der Position des GPS-Sensors. Der Referenzpunkt ist eine aussagekräftige Position auf Ihrem Roboter, beispielsweise der Drehmittelpunkt oder der Arm des Roboters. Lassen Sie uns darüber nachdenken, warum das wichtig ist. Die folgenden Beispiele zeigen Axel, den Hero Bot für das VEX V5 Robotics Competition (V5RC)-Spiel High Stakes 2024–2025.

Warum sind Ausgleichszahlungen ein wertvolles Instrument?

Durch Festlegen des Versatzes für die Position des GPS-Sensors im Verhältnis zum Referenzpunkt (Axels Arm) können Sie Axels Arm an der gewünschten Stelle positionieren, anstatt auf der Rückseite des Roboters. VEXcode verwendet die Offset-Informationen, um die Daten vom GPS-Sensor so zu konvertieren, dass Werte verwendet werden, die dem Referenzpunkt in Ihrem Projekt entsprechen.

Mithilfe von Offsets können Sie die empfohlene Positionierung des GPS-Sensors (auf der Rückseite und hinter dem Roboter) verwenden, um möglichst genaue Daten vom Sensor zu erhalten und gleichzeitig anhand eines aussagekräftigen Standorts für Ihren Roboter und Ihr Projekt zu navigieren.

Abhängig von Ihrem Referenzpunkt und der Position des GPS-Sensors an Ihrem Roboter kann der Sensor entlang der X-Achse und/oder der Y-Achse versetzt sein.

Eine Draufsicht des Axel-Roboters. Ein grünes Kästchen hebt den GPS-Sensor im hinteren rechten Bereich des Roboters hervor. Auf der Vorderseite des Roboters, oben auf seinem Arm, befindet sich ein runder Punkt.

In diesem Bild von Axel befindet sich der GPS-Sensor auf der hinteren rechten Seite des Roboters (hervorgehoben durch ein grünes Kästchen). Ein Beispiel-Referenzpunkt wird hier an Axels Arm angezeigt, hervorgehoben mit einem grünen Punkt.

Eine Draufsicht auf den Axel-Roboter auf einem Spielfeld. Der Sensor zeigt hinter den Roboter, was durch einen durchgezogenen grünen Pfeil angezeigt wird. Der Referenzpunkt für den Roboter befindet sich auf der gegenüberliegenden Seite und wird durch einen gepunkteten grünen Pfeil dargestellt.

Außerdem muss der Winkel des Sichtfelds des GPS-Sensors im Verhältnis zum Referenzpunkt berücksichtigt werden.

Bei der empfohlenen Position für den GPS-Sensor zeigt der Sensor hinter Axel, wie hier mit einem grünen Pfeil angezeigt.

Der Referenzpunkt liegt jedoch auf der Vorderseite des Roboters und zeigt in die entgegengesetzte Richtung. Der GPS-Sensor verfügt dann auch über einen Winkelversatz.

Messen der X- und Y-Versätze

Durch Hinzufügen des Offsets zu Ihrer Konfiguration werden die in Ihrem VEXcode V5-Projekt verwendeten GPS-Sensorwerte automatisch angepasst, um den Offset und die Position des gewünschten Referenzpunkts des Roboters auf dem Feld widerzuspiegeln.

Der GPS-Sensor kann je nach Montageort des Sensors an Ihrem Roboter entlang der X-Achse und/oder der Y-Achse versetzt werden.

Eine Draufsicht des Axel-Roboters, die das grün hervorgehobene Kästchen um den GPS-Sensor und den grünen Kreis über dem Arm des Roboters zeigt. Über Axel wird ein X- und Y-Gitter gelegt, wobei der grüne Kreis über Axels Arm als Mittelpunkt des Gitters (0,0) angezeigt wird. Das grün hervorgehobene Kästchen um den GPS-Sensor befindet sich in der negativen Y- und positiven X-Achse des Rasters.

Im Beispiel von Axel befindet sich der GPS-Sensor hinter und rechts vom Referenzpunkt am Arm des Roboters.

Dasselbe Bild des Axel-Roboters von oben. Ein blauer Y-Achsenpfeil bewegt sich die Y-Achse hinunter in Richtung der Rückseite des Roboters. Ein roter Pfeil auf der X-Achse zeigt nach rechts in Richtung der Mitte des hervorgehobenen GPS-Sensors.

Dies bedeutet, dass der Sensor sowohl entlang der X-Achse (dargestellt durch den roten Pfeil) als auch entlang der Y-Achse (dargestellt durch den blauen Pfeil) versetzt ist.

Dieselbe Draufsicht des Axel-Roboters. Eine gestrichelte Linie kennzeichnet die X-Position des hervorgehobenen GPS-Sensors. Eine Beschriftung zeigt an, dass die Position der gestrichelten Linie auf der X-Achse 50 mm beträgt.

X-Versatz

Bei Axel ist der GPS-Sensor ca. 50 mm auf der positiven x-Achse bezogen auf den Referenzpunkt am Roboterarm montiert.

Der X-Versatz beträgt dann 50mm.

Dieselbe Draufsicht des Axel-Roboters. Eine gestrichelte Linie kennzeichnet die Y-Position des hervorgehobenen GPS-Sensors. Ein Etikett zeigt die Position des GPS-Sensors auf der Y-Achse mit -320 mm an.

Y-Versatz

Bei Axel ist der GPS-Sensor etwa 320 mm auf der negativen y-Achse in Bezug auf den Referenzpunkt am Roboterarm montiert.

Der Y-Offset beträgt dann –320 mm.

Messen des Winkelversatzes

Die Draufsicht des Axel-Roboters in der Mitte eines Kreises zeigt eine 0 vor dem Roboter, eine 90 rechts davon, eine 180 dahinter und eine 270 links von ihm. Der GPS-Sensor wird durch ein grünes Kästchen mit einem in Richtung 180 zeigenden Pfeil hervorgehoben. Über dem Arm des Roboters befindet sich ein grüner Kreis und ein Pfeil, der auf 0 zeigt.

Der GPS-Sensor meldet auch Kurswerte. Der GPS-Sensor zeigt jedoch in die entgegengesetzte Richtung zur Vorderseite des Roboters. Dies bedeutet, dass die Kurswerte denen des Referenzpunkts entgegengesetzt wären, der auf dem Roboter nach vorne zeigt.

Um die Ausrichtung des GPS-Sensors an der Vorwärtsrichtung des Referenzpunkts auf dem Roboter auszurichten, können Sie den Winkelversatz einstellen.

Bei Axel würde der Winkelversatz 180º betragen.

Hinweis: Basierend auf der empfohlenen Positionierung des GPS-Sensors wird die Konfiguration den Winkelversatz standardmäßig auf 180º einstellen.

Offsets in der Konfiguration eingeben

VEXcode V5 Gerätefenster mit Anzeige der GPS-Einstellungen. Die Optionen X-Offset, Y-Offset und Winkel-Offset sind hervorgehoben. Rechts befindet sich ein Diagramm des GPS-Sensors an einem Beispielroboter, um diese Werte zu veranschaulichen.

Es gibt Optionen zum Ändern der X-, Y- und Winkelversätze.

X- und Y-Versatz

Der X-Offset würde in der Konfiguration, wie in diesem Video gezeigt, auf 50 mm eingestellt.

Wenn der Offset-Wert geändert wird, passt sich die grafische Position des GPS-Sensors auf dem Robotersymbol rechts entsprechend an. (Beachten Sie, dass die grafische Darstellung nur zur Veranschaulichung dient und keinem bestimmten Maßstab entspricht.)

Der Y-Offset würde auf –320 mm eingestellt, wie in diesem Video gezeigt.

Wenn der Offset-Wert geändert wird, passt sich die grafische Position des GPS-Sensors auf dem Robotersymbol rechts entsprechend an. (Bitte beachten Sie, dass die grafische Darstellung nur zur Veranschaulichung dient und keinen bestimmten Maßstab angibt.)

Winkelversatz

VEXcode V5 Gerätefenster mit Anzeige der GPS-Einstellungen. Die Option „Winkelversatz“ ist hervorgehoben und in diesem Beispiel auf 180 Grad eingestellt.

Standardmäßig ist der Winkelversatz in der Konfiguration auf 180º eingestellt, basierend auf der empfohlenen Ausrichtung des GPS-Sensors. Dies bedeutet, dass die gemeldeten Richtungen des GPS-Sensors in VEXcode mit der Richtung des Roboters übereinstimmen.

In der Konfiguration wird auf dem Robotersymbol eine gelbe Markierung angezeigt, um das Sichtfeld zu veranschaulichen und die Ausrichtung des Sensors anzuzeigen. Wenn der Winkelversatzwert geändert wird, verschieben sich die Position des GPS und das Sichtfeld auf dem Robotersymbol rechts entsprechend. Dieses Video zeigt, wie der Winkelversatz verändert wird. (Beachten Sie, dass die grafische Darstellung nur zur Veranschaulichung dient und keinem bestimmten Maßstab entspricht.)

Notieren Sie die GPS-Position in der Konfiguration

Beachten Sie, dass die Position des GPS auf dem Robotersymbol in der Konfiguration mit der Position des GPS-Sensors auf dem physischen Roboter übereinstimmt.

Mithilfe dieser grafischen Darstellung können Sie sicherstellen, dass Ihre Offsets korrekt eingegeben werden. Die GPS-Position sollte mit der Position Ihres Roboters übereinstimmen.

VEXcode V5 Gerätemenü mit Anzeige des Bildschirms „GPS-Einstellungen“. Unten ist die Schaltfläche „Fertig“ hervorgehoben.

Sobald die X-, Y- und Winkelversatzwerte basierend auf der Position des GPS-Sensors auf Ihrem Roboter eingegeben sind, wählen Sie Fertig um die Konfiguration zu speichern.

GPS-Erkennungsbefehle in VEXcode

Sobald der GPS-Sensor konfiguriert ist, werden GPS-Sensing-Befehle in der Toolbox in VEXcode V5 angezeigt. Sie können sich mit der VEX-API über alle GPS-Sensing-Befehle in VEXcode V5 informieren. Wählen Sie den unten stehenden Link aus, um auf die GPS-Sensing-Befehle für Ihre bevorzugte Codierungsmethode zuzugreifen.

Um mehr über die Daten zu erfahrendie der GPS-Sensor meldet und wie diese mit der Position des Roboters auf dem Feld zusammenhängen, lesen Sie diesen Artikel.