Control with QGC
QGroundControl
Select Open QGC in the installed app or the ArduPilot title bar. The workspace opens the QGC connection dialog. Keep the WWW-POSIM installed app running, including when using a workspace on the website.
- Start a personal WAM-V or BlueROV2 world in Autopilot mode.
- Choose Install QGroundControl to download the official QGC 5.1.5 release, or Locate QGC to select an existing 5.1.x installation. Complete the installer; on macOS, drag QGC into Applications.
- When the indicator shows Ready to open QGC, select Open and connect. If preparation is needed, review the listed actions and select Confirm and open QGC.
After confirmation, WWW-POSIM stops the mission and manual inputs as needed, then waits for the vehicle to disarm before opening QGC. If preparation fails, QGC stays closed. A stopped mission does not resume automatically. Allow local-network access if the browser asks, then wait for QGC connected.
WWW-POSIM configures the connection and video source automatically, including on Windows. If QGC is already running, close it yourself and retry. Windows settings are backed up beside QGroundControl.ini before editing. macOS and Linux use a separate WWW-POSIM profile. Close QGC before reconnecting after a disconnect.
While QGC is open through WWW-POSIM, other automatic connections are paused on Windows. Closing QGC restores those settings and the previous video source. If the installed app exits first, open it again after closing QGC to finish restoration. If QGC needs to update or reset its settings, open QGC directly once, close it, then retry the connection.
MAVLink travels through the installed app, this signed-in browser page and the selected workspace's MAVROS connection. Keep the page open. Other workspace controls pause while QGC has control. Disconnect QGC, a lost connection or a world change releases control; disconnecting requests disarm for that world.
QGC receives H.264 video through a private connection. Windows and Linux use Gazebo's GStreamer camera plugin. macOS uses the installed engine's FFmpeg and Apple VideoToolbox to encode the selected camera at up to 5 frames per second. It uses the selected forward camera, or the first available camera if no forward camera is selected. If video is unavailable, enable a vehicle camera and restart the world with the current engine. This connection uses assigned private ports; no router port forwarding or manual Windows connection entry is needed.
QGC is available for personal Autopilot workspaces. ROS direct control, competitions and the public demo do not offer this connection.
QGC distinguishes raw GPS validity (GPS_RAW_INT) from the fused FCU position (GLOBAL_POSITION_INT). A valid accepted external sensor estimate can provide position while GPS reports no fix. WWW-POSIM does not forge a fix or substitute simulator coordinates. See GNSS & navigation for initialization and loss limits. Disarming for control handover can let an underwater vehicle rise under buoyancy.