Den Arbeitsbereich kennenlernen
Beginnen Sie mit einem vorbereiteten Gelände. Lernen Sie die Anzeigen kennen, bevor Sie Befehle an das Fahrzeug senden.
Anmelden und die erste Welt starten
- Registrieren Sie sich auf WWW-POSIM, bestätigen Sie Ihre E-Mail-Adresse und melden Sie sich an. Prüfen Sie gegebenenfalls den Spamordner oder fordern Sie eine neue Nachricht an. Die Bestätigung gilt auch für die installierte App.
- Wählen Sie in der App Simulator starten. Öffnen Sie auf der Website Ihren persönlichen Arbeitsbereich; ein Serverplatz kann Wartezeit erfordern.
- Öffnen Sie Arbeitsbereich, wählen Sie Vorgeneriertes Gelände und KMOU waterfront · 1 × 1 km.
- Wählen Sie unter Regionales Gelände → Fahrzeug den WAM-V, Tiefe 0 m und Autopilot.
- Wählen Sie Erzeugte Welt starten. Warten Sie auf das Fahrzeug und aktuelle Positionsdaten. Das erste Einrichtungsfenster der App bleibt bis zum erfolgreichen Weltstart geöffnet.

| Einstieg | Zweck |
|---|---|
| Demo-Welten | Startet WAM-V oder BlueROV2; andere Vorschauen zeigen ihre Verfügbarkeit. |
| Vorgeneriertes Gelände | Zeigt fertige, herunterladbare und bereits erzeugte Gelände. |
| Übungsbereich | Bereitet die Übung vor, sofern verfügbar. |
| Eigene Welt | Öffnet regionales Gelände, Fahrzeugeditor, RViz-Werkzeuge und Speicherverwaltung. |
| Ort → Fahrzeug → Prüfen | Legt Gelände, Fahrzeug und Startpose fest und prüft die Einstellungen vor dem Start. |
Wählen Sie Autopilot oder ROS 2 direkt vor dem Weltstart. Für einen anderen Steuerungstyp starten Sie eine Welt mit der anderen Auswahl. Ein ArduPilot-Moduswechsel ist davon getrennt. Beachten Sie die Grenzen für Koordinaten und Tiefe. Der Übungs-Seed ist eine ganze Zahl von 0 bis 1 000 000; ohne Wert wird die Anordnung automatisch gewählt. Freie Erkundung und Administrator-Referenzläufe ignorieren diesen Seed.
Auf dem Mac wird vorbereitetes Gelände bei der ersten Auswahl mit Fortschrittsanzeige heruntergeladen. Anschließend bleibt es mit seiner festgelegten Inhaltsrevision offline verfügbar. Bei einem Fehler prüfen Sie die Verbindung und wählen es erneut. Die WAM-V-Demo nutzt Hongkong: eine korallfarbene Boje liegt 16 m voraus und 5 m links, eine limettengrüne 30 m voraus und 8 m rechts. Prüfen Sie beide mit Frontkamera und LiDAR.
Aufbau der Oberfläche

| Bereich | Inhalt |
|---|---|
| Obere Leiste | Fahrzeug, Gelände, Live-Status, Arbeitsbereich, Sprache sowie Szenenvergrößerung und Panelanzeige. Bei erfasster Nutzungszeit erscheint auch die Sitzung. |
| Mitte | Fahrzeug-, Welt- und Kartenansicht. |
| Links | Umgebung und Anzeige unter Szene, Messungen unter Sensoren sowie ROS-Topics. |
| Rechts | ArduPilot- oder ROS-2-Steuerung, darunter Fahrzeuginstrumente und Diagramme. |
| Untere Karte | Geografische Position, Wegpunkte und Missionsbefehle unter Bodenstation. |
Öffnen Sie Überschriften oder + / −. Der Inhalt scrollt innerhalb des verfügbaren Platzes; andere Bereiche können sich dafür einklappen. Panels blendet die Panels ein oder aus. Szene fokussieren vergrößert die Szene und lässt die Karte erreichbar. Die Simulation läuft weiter. Der Einstiegsbildschirm bietet außerdem Rückkehr zur Hauptseite und Abmeldung.
| Ansicht oder Aktion | Wirkung |
|---|---|
| Fahrzeug | Folgt dem Fahrzeug; erlaubt Umkreisen und Zoomen. |
| Welt | Schräge Nahübersicht mit begrenztem Zoom und Schwenkbereich. |
| Karte | Nach Norden ausgerichtete Karte mit simulierter Position; Ziehen verschiebt die Karte. |
| Ziehen, rechte Maustaste, Mausrad | Verschieben, Umkreisen oder Zoomen gemäß den Hinweisen der Ansicht. |
| Spur löschen | Entfernt geplante Route und gemessene Spur aus der Ansicht. Die Aufzeichnung läuft ab der aktuellen Position weiter; der Missionsbericht bleibt erhalten. |
Der untere Kompass beschreibt die Beobachterkamera, nicht den Fahrzeugkurs. Der feste Pfeil zeigt nach vorn, die Buchstaben drehen sich mit der Nordrichtung. Die Zeitanzeige zeigt Simulationszeit. 1,00× bedeutet Fortschritt in Echtzeit.
Gelb kennzeichnet die geplante Route, Blaugrün die gemessene Spur. Bis zu 1 024 Segmente bleiben sichtbar. Eine neue geführte Mission löscht die Gazebo-Spur. Die 5 mm breiten Szenenlinien erscheinen nicht in Sensorbildern.
Szene, Wellen und Strömung

| Abschnitt | Bedienung |
|---|---|
| Wellen | Seegang 0 bis 4 wählen und anwenden. Erweiterte Einstellungen bieten Wind, Richtung und Steilheit. |
| Meeresströmung | Strömung einschalten, gleichförmige Strömung oder Tiefenprofil wählen und Strömung anwenden ausführen. Bestätigung des Solvers abwarten. |
| Schiffsverkehr | Zeigt Schiffe aus aktuellen AIS-Meldungen; abhängig von Abdeckung und Simulationsgeschwindigkeit. |
| Szenenrenderer | Wählt Browser oder Gazebo, sofern verfügbar, und öffnet Unterwassereffekte. |
| Anzeige | Meeresboden, Oberfläche, Gitter und Achsen; je nach Ansicht Beleuchtung und Wasser-/Kartenopazität. |
| Grafikleistung | Gemessene Renderstatistik des Browsers. |
Freie Arbeitsbereiche beginnen mit Seegang 2. Die Vorgaben verwenden Windgeschwindigkeiten von 0, 1, 3, 6 und 8 m/s bei Steilheit 1. Sie sind Näherungen, keine garantierten Wellenhöhen. Die Info-Schaltfläche zeigt WMO-Bereiche. Übungen behalten ihre vorgegebenen Bedingungen.
Beenden Sie Mission oder direkte ROS-Steuerung vor Strömungsänderungen. Das Profil beginnt bei 0 m Tiefe und erlaubt bis zu acht Knoten mit 0–1 m/s. Horizontales Ziehen ändert die Geschwindigkeit; die Tabelle bearbeitet Tiefe und Richtung. 0° zeigt nach Osten, 90° nach Norden, jeweils in Fließrichtung. In jedem Physikschritt werden die Vektoren an der tatsächlichen Tiefe jedes Links linear interpoliert. Unterhalb des tiefsten Knotens bleibt dessen Strömung bestehen. Sie verändert den wasserrelativen Widerstand; Wellen behalten ihr eigenes Modell.
Die installierte App öffnet standardmäßig Gazebo. Browser reduziert die Last der Gazebo-Szenenkamera; Physik, Kameras und GPU-LiDAR werden weiterhin in Gazebo berechnet. Die Auswahl gilt für die geöffnete Ansicht. Die BlueROV2-Verfolgerkamera glättet Bewegungen und zeigt die Oberfläche. Vertikales Ziehen in geeigneten Ansichten ermöglicht den Blick von unten.
Unterwasseransicht
Öffnen Sie Szene → Szenenrenderer → Unterwasseransicht. Änderungen wirken auf die Gazebo-Szene und Kamerafarbbilder einschließlich RGBD. Numerische Tiefenwerte und Kollisionsgeometrie bleiben erhalten.
- Sandtextur, Dunst, Farbabsorption, abnehmendes Sonnenlicht und Lichtmuster am Boden: anfangs aktiviert.
- Gitter, Höhenlinien und Partikel: anfangs deaktiviert; Standardabstände 10 m für Gitter und 5 m für Höhenlinien.
- Die BlueROV2-KMOU-Demo startet mit aktivierten Schwebepartikeln und deaktivierter tiefenabhängiger Sonnenlichtdämpfung. Gespeicherte Einstellungen der installierten Anwendung haben Vorrang vor diesen Demo-Standardwerten.
- Wasseroptik schaltet die optischen Effekte gemeinsam; Textur und Linien bleiben einzeln wählbar.
- Die installierte App speichert bestätigte Einstellungen. Gehostete Sitzungen beginnen mit Standardwerten. Während einer Bewertung sind Änderungen gesperrt.
Gazebo zeigt die vollständigen Effekte; Browser übernimmt Sanddetails und Bodenlinien. Das Bildmodell verwendet einen ebenen mittleren Meeresspiegel und PBR-Oberflächen. Unbeleuchtete Materialien und eigene Wassershader haben eine eigene Darstellung. Partikel und Lichtmuster sind visuelle Näherungen. Dunst, Dämpfung und Verdeckung begrenzen die nutzbare Sicht zusätzlich zum geometrischen Clipping. Siehe Technische Daten und Meeresdynamik und Rendering.
Sensoren und ROS-Topics

Wählen Sie unter Sensoren das Fahrzeug und anschließend Kamera, LiDAR oder IMU. Die Ausstattung hängt vom Modell ab. Eine nach unten gerichtete Inspektionskamera zeigt den Boden.
| Bedienelement | Aktion |
|---|---|
| Stream starten/stoppen | Steuert diesen Bildempfang; die Simulation läuft weiter. |
| Vergrößern / Bild speichern | Vergrößert das Bild oder speichert das empfangene Einzelbild. |
| Sensorrate | Fordert eine Übertragungsrate an; die gemessene Anzeige zeigt den tatsächlichen Empfang. |
| Digitalzoom / Zurücksetzen | Vergrößert das empfangene Bild oder stellt den Maßstab zurück. |
| ROS-Topics → Suche → Topic | Öffnet die Nachricht; Abonnieren und Abbestellen steuern ihren Empfang. |
| Feld / Diagramm / Rohdaten / Zeichnen | Zeigt Zahlenfelder oder unterstützte räumliche Nachrichten entsprechend Typ und Koordinatenrahmen. |
Die Szenenkamera ist ein äußerer Beobachter. Die Sensorkamera folgt ihrer Einbaupose am Fahrzeug. Beide können in unterschiedliche Richtungen sehen.
Streamzustände
Verbinden oder Warten bedeutet, dass Sensor oder Übertragung vorbereitet werden. Prüfen Sie die Empfangszeit. Ein beibehaltenes Bild mit Veraltet oder Neu verbinden ist keine aktuelle Messung. Prüfen Sie zuerst Weltbereitschaft und Sensorauswahl.
Die öffentliche Hongkong-Demo verwendet gemeinsames H.264-Video mit Startpuffer. Persönliche Kameras fordern JPEG-Bilder an; komprimierte ROS-Bilder haben einen getrennten Übertragungsweg. Speichern erfasst in der Demo einen Videoframe, im persönlichen Panel die empfangene Bilddatei. Sensorfrequenz, Video-FPS und Echtzeitfaktor sind verschiedene Messgrößen. Siehe Simulation, Rendering und Sensoren und Visualisierung mit RViz und Foxglove.
ArduPilot und manuelle Steuerung


Prüfen Sie Telemetrie, Freigabezustand und gemeldeten Modus in der Überschrift. Zentrieren Sie manuelle Eingaben und beenden oder brechen Sie die Mission vor einem Moduswechsel ab. Wählen Sie Flugmodus, wenden Sie ihn an und prüfen Sie die Rückmeldung: Das Auswahlfeld formuliert zunächst eine Anforderung.
Scharf gibt den Antrieb nach den Bereitschaftsprüfungen frei. Sichern sperrt ihn und beendet die Mission. Die Modusauswahl allein gibt das Fahrzeug nicht frei. Lesen Sie bei Ablehnung Fehler und Verbindungsdetails. Ein Kamerabild belegt keine Steuerungsbereitschaft.
| Fahrzeug | Menümodi |
|---|---|
| WAM-V · ArduRover | MANUAL: direkte Gas-/Lenkeingaben. HOLD: neutraler Antrieb, weiterhin mögliche Bewegung durch Trägheit, Wellen und Strömung. STEERING: geregelte Geschwindigkeits- und Kurvenunterstützung. |
| BlueROV2 · ArduSub | MANUAL: direkte Bedienung. STABILIZE: stabilisierte Lage, manuelle Tiefe. ALT_HOLD: zusätzliche Tiefenhaltung, keine horizontale Positionshaltung. |
Geprüfte Missionen fordern beim Start GUIDED und die Antriebsfreigabe an. Die Mission verwaltet diesen Modus; er steht nicht im manuellen Menü. Siehe Autopilot-Missionen.

Aktivieren Sie Joystick-Eingabe und wählen Sie Maus/Touch oder Gamepad. WAM-V bietet Gas und Lenkung; BlueROV2 zusätzlich seitliche und vertikale Bewegung. Beginnen Sie zentriert mit niedrigem Eingabefaktor. Eingabe stoppen beendet das aktuelle Drücken; zum Fortsetzen loslassen und neu drücken. Fokusverlust, Sperren des Antriebs, Quellenwechsel oder abgelehnte Befehle beenden den Druck ebenfalls.
Halten Sie am Gamepad LB/L1 während der Steuerung. Loslassen sendet Neutralwerte, sperrt aber nicht den Antrieb und stoppt Bewegung nicht sofort. Bei BlueROV2 fordert Y/Dreieck ALT_HOLD und A/Kreuz STABILIZE an. Prüfen Sie die Modusrückmeldung. Alle Belegungen stehen in Manuelle Steuerung und Gamepad.
Karte und Missionen
Neue Unterwasserwegpunkte beginnen bei 2 m. Der normale Bereich ist 0–10 m; bei unterstützten Inspektionsszenen gilt die vom Server angezeigte Tiefengrenzen für Missionen.

Vervollständigen Sie Koordinaten und Tiefe vor der Routenprüfung. Oberflächenpunkte verwenden 0 m; Kartenwegpunkte warten jeweils eine Sekunde. Leere Eingabefelder bleiben beim Bearbeiten leer.
| Aktion | Wirkung |
|---|---|
| Klick / Rechtsklick | Fügt einen Punkt hinzu / entfernt einen nahen Punkt. Ziehen, Mausrad oder Pinch verschieben und zoomen. |
| Zum Start zurückkehren / Löschen | Legt Rückkehr fest / entfernt bearbeitbare Punkte. |
| Route prüfen | Erstellt eine geländegeprüfte Vorschau. Prüfen Sie Verlauf, Abstand und Hindernisgründe. |
| Route starten | Startet die geprüfte Route und gibt den Antrieb nach den Prüfungen frei. |
| Stoppen / Weiter / Abbrechen | Hält an einem Warteziel / setzt fort / bricht ab und sperrt den Antrieb. |
Prüfen Sie vor jedem weiteren Lauf erneut, da sich das Fahrzeug bewegt haben kann. Kartenwegpunkte haben Vorrang vor Szenariovorgaben; löschen Sie sie für ein vorgegebenes Szenario. Die Prüfung bewertet Gelände und Rumpfabstand, garantiert aber weder Ausweichen vor bewegten Schiffen noch COLREG-Konformität. Siehe Autopilot-Missionen.
Fahrzeuginstrumente

Der feste blaue Marker stellt das Fahrzeug dar. Der bewegte Horizont zeigt Rollen und Nicken. Der Kurs verwendet 0° Nord, 90° Ost, 180° Süd, 270° West. Tiefe ist −Z relativ zum Meeresspiegelnullpunkt: darunter positiv, darüber negativ. Sie ist nicht der Abstand zum Boden.
Das Diagramm behält die letzten 100 empfangenen Posen. Wählbar sind Tiefe, Kurs, Nicken, Rollen, Geschwindigkeit und Schubanforderung. Tiefe, Lage und Geschwindigkeit stammen aus dem Simulator. Geschwindigkeit zeigt X vorwärts, Y links und Z aufwärts in m/s. Schub zeigt Befehle in Newton, keine gemessene Kraft. Fehlende oder veraltete Werte ergeben Lücken oder —. Tiefe und Lage teilen sich Messzeit und Datensatz; die Demo gleicht sie mit dem Video ab.
Geschwindigkeit und Physikschritt
Eine Auswahl wird sofort gesendet. Warten Sie auf die Bestätigung.
| Einstellung | Werte |
|---|---|
| Angeforderte Geschwindigkeit | 0,25×, 0,5×, 1×, 2× und 4× |
| Physikschritt | 5, 10 oder 20 ms; auch 30 ms, wenn die Welt bereits diesen Wert nutzt |
| Tatsächlich | Simulationszeit geteilt durch Echtzeit; kann unter dem Sollwert liegen |
Der Antrieb muss gesperrt, das Gelände bereit und Mission sowie manuelle/ROS-Eingaben inaktiv sein. Über 1× ist AIS nicht verfügbar. Windows und Linux beginnen bei 20 ms, der native Mac bei 10 ms. Übungen behalten ihre vorgeschriebenen 10 ms. Siehe Welten anpassen.
Position und Verbindungen
N/E/D bedeutet Nord, Ost, Unten in Metern ab lokalem Ursprung. Geografische Koordinaten sind Breite und Länge in Grad. R/P/Y · ENU zeigt Rohwinkel: Gieren 0° nach Osten, 90° nach Norden. Das Instrument zeigt Nicken −P und Kurs (90 − Y + 360) % 360.
Verbindungsdetails nennen Sequenz, Alter und ENU-Rahmen der Position. Steigende Sequenz und geringes Alter belegen neue Daten. Das Steuerungspanel hat eigene Diagnosen. RViz öffnet den passenden Betrachter: natives RViz2 in der App, Webbetrachter im Browser. Die Welt und in der App auch der RViz-Dienst müssen bereit sein. Siehe Visualisierung mit RViz und Foxglove. ArduPilot-Parameter werden im eigenen Panel gelesen, exportiert und geändert; erlaubte Änderungen werden bei gesperrtem Antrieb angewendet und zurückgelesen.
Direkte ROS-2-Steuerung

Aktivieren Sie ROS für begrenzte Befehle des verbundenen Controllers. ROS stoppen hält die Ausgabe neutral bis zur erneuten Aktivierung. Die Diagnose zeigt Grund, angewendete Sequenz, Bestätigung und Schubwerte. Ein Watchdog setzt die Ausgabe bei ausbleibenden Befehlen auf neutral. Folgen Sie ROS-Terminals und Verbindung, Einen Web-Arbeitsbereich steuern oder Einen lokalen Arbeitsbereich steuern.
Ressourcen speichern und übertragen
Unter Arbeitsbereich → Eigene Welt → Speicher sehen Sie Gelände, Fahrzeugrevisionen, Weltkonfigurationen, Caches und freien Platz. Archivieren blendet Ressourcen aus, behält Dateien und gibt keinen Platz frei. Wiederherstellen macht sie erneut auswählbar. Warten Sie auf das Ende nutzender Sitzungen.
ZIP-Export/-Import überträgt Fahrzeuge mit Ressourcen. Eine bearbeitete Kopie erzeugt eine neue Revision. Vor dem Start können Sie Fahrzeug- und Welt-SDF herunterladen, ändern und als kompatible Revision hochladen. Siehe Ein Fahrzeug vorbereiten, Fahrzeuge anpassen und Welten anpassen.
Kleine Bildschirme und Wartezustände
Am Telefon öffnen die unteren Schaltflächen jeweils ein scrollbares Panel. × oder Escape führt zur Szene zurück. Querformat platziert das Panel neben den Steuerelementen. Die Desktopansicht der öffentlichen Demo skaliert das gesamte Layout; Hochformat fordert zum Drehen auf. Vollbild hängt von Browserunterstützung und einer Benutzeraktion ab.
Deaktivierte Schaltflächen bedeuten häufig fehlende Bereitschaft, ausstehendes Gelände, eine aktive Mission oder einen laufenden Befehl. Lesen Sie den Status vor einem neuen Versuch. Panels ausblenden, Spuren löschen, Bilder stoppen und Topics abbestellen stoppen das Fahrzeug nicht. Beenden Sie zum Schluss die Sitzung. Schließen der installierten App beendet lokale Dienste und Geländeerzeugung; gespeicherte Daten bleiben erhalten.
AIS-Zugangsdaten
Demos verwenden den AISStream-Schlüssel des Servers. Ohne diesen nutzen installierte Demos den öffentlichen AIS-Datenstrom von Open Waters. Das Panel zeigt Anbieter und Status; sichtbare Schiffe hängen von aktuellen Meldungen ab.
Tragen Sie für eine eigene Welt Ihren Schlüssel unter Szene → Schiffsverkehr ein und speichern Sie ihn lokal. Er wird in diesem Browser gespeichert und an den ausgewählten Simulationsserver übermittelt. Lokales Entfernen löscht ihn aus dem Browser. Aktivieren Sie den Verkehr zum Verbinden. Siehe Simulation, Rendering und Sensoren.
Mit QGC steuern
Wählen Sie bei einem Autopilot-Fahrzeug Open QGC im Bereich ArduPilot. Lassen Sie die installierte App und den angemeldeten Arbeitsbereich geöffnet. Der Dialog bereitet das Fahrzeug vor und übergibt die Steuerung an QGroundControl. Installation, Verbindung und Freigabe beschreibt Mit QGC steuern.
BlueROV2-Frontlichter
Mit Frontlichter in der Joystick-Steuerung schalten Sie beide BlueROV2-Lampen ON/OFF. Die Rückmeldung bestätigt den tatsächlichen Zustand; fehlgeschlagene oder nicht verfügbare Befehle gelten nicht als Erfolg. Fahrzeuglicht ist unabhängig von Tag/Nacht der Szene und Kameraauswahl.