Cockpit Documentation
Usage

Getting Started

Welcome to Cockpit!

When you're first starting out, it's good to find out what there is and where you can find it. On the first boot, Cockpit opens a tutorial window that walks you through the main parts of the interface:

Tutorial

General Configuration

Cockpit generally automatically finds and/or connects to your vehicle:

  • When run as a BlueOS Extension, Cockpit will automatically be configured to connect using the IP address of the connection to BlueOS.
  • When run as a standalone application, there is a vehicle discovery process for detecting BlueOS vehicles on your network:
Vehicle Discovery

If that address changes while operating, or your vehicle is not running BlueOS, it may be necessary to configure the global vehicle address, and potentially also the more specific backend server addresses to connect to MAVLink2REST and the WebRTC video signalling server (e.g. from MAVLink Camera Manager), so that Cockpit knows the correct connection points for the vehicle.

To access the configuration section, open the left sidebar, and select Settings / General:

General Config

If necessary, there are some additional details in the advanced usage documentation.

Interface Setup

Visual Display

Once connected to a vehicle, Cockpit loads a profile with a default set of interface views that are relevant for the vehicle type. These should serve as a reasonable starting point, which you can then customise to suit your specific use-cases and preferences.

MAVs / QuadCopters

Micro-aerial vehicles start out with an interface similar to other control station softwares, with

  • a map
  • basic tracking of the connection details and notifications
  • on-screen control options to arm, take off, and change flight modes, and
  • some telemetry widgets to track the vehicle altitude and attitude
Mav Map View

Rovers / Boats

The default interface for rovers and boats is similar to the MAV one, but with the bottom bar altitude tracking swapped for a GPS speed widget:

Boat Map View

ROVs / Submarines

Cockpit was first developed for ROVs, and there are three starting views built in:

  1. Video view
    • Includes a video stream, vehicle telemetry, compass and attitude instrument indicators, status updates, and flight mode selection
    • Useful for first-person control, focused on what the vehicle can see
Sub Video View
  1. HUD view
    • Includes a video stream, vehicle telemetry, heads-up display (HUD) overlay elements, status updates, and flight mode selection
    • An alternative for first-person control of a vehicle, focused on precision maneuvering
Sub Hud View
  1. Map view
    • Includes a map, vehicle telemetry, status updates, and flight mode selection
    • Most useful for mission planning and remote monitoring of vehicles with a positioning system and/or autonomous control
Sub Map View

Joystick Configuration

For vehicles controlled via a joystick, button and axis function mappings can be set through the Settings / Joystick section of the left sidebar:

Joystick Config

Vehicle Setup

Cockpit does not currently contain vehicle configuration or calibration functionalities. It is recommended to perform these in advance, using either the BlueOS web interface and/or an alternative control station software like QGroundControl.

Operation

Once you're ready to operate your vehicle, you can get started with remote control, or switch between the Mission Planning and Flight displays via the left sidebar.


Powered by Zola and Bluetheme Documentation under CC BY-NC-SA 4.0 creative commons attribution non commercial share alike
Sponsored by Blue Robotics Code under AGPLv3 / Cockpit Custom