Clover

Simulation VM setup

In addition to native installation instructions, we provide a preconfigured developer virtual machine imageopen in new window. The image contains:

  • Ubuntu 18.04 with XFCE lightweight desktop environment;
  • ROS packages required to develop for the Clover platform;
  • QGroundControl;
  • preconfigured Gazebo simulation environment;
  • Visual Studio Code with C++ and Python plugins.

TIP

The default username on the VM is clover, with password clover.

The VM is an easy way to set up a simulation environment, but can be used as a development environment for a real drone as well.

Downloading

You can download the latest VM image in the VM releases repositoryopen in new window.

TIP

The virtual machine should be used when native installation is not feasible or possible. You may experience reduced performance in programs that use 3D rendering, like rviz and Gazebo.

Setting up the VM

You need to use a VM manager that supports OVF format, like VirtualBoxopen in new window, VMware Playeropen in new window or VMware Workstationopen in new window.

TIP

At the time of writing VirtualBox had issues running the VM, particularly with 3D applications. We recommend using VMware Player or VMware Workstation if possible. The following steps assume you're using VMware Player.

Make sure that you have hardware virtualization enabled in your BIOS/UEFI (it may be supported by your hardware but turned off by default). The steps to enable virtualization differ from manufacturer to manufacturer, but should be described in your system manual. Consult your system's manufacturer if you're having trouble turning virtualization on.

  1. Import the OVA archive into your virtualization environment. Use the Open a Virtual Machine option in VMware Player:

    Open dialog with clever-devel.ova selected

    Note You may see a dialog box with a warning about the VM format: Import failure dialog You can safely ignore the warning and press Retry.

  2. Right-click on the VM name and select Virtual Machine Settings. In the new window, set the following parameters:

    • increase the amount of memory available to the virtual machine (a good rule of thumb is 2048 MB per CPU core, but no less than 4 GB): Increasing available memory
    • increase the amount available CPU cores: Increasing cpu cores
    • enable 3D acceleration: Enabling 3D acceleration
    • enable USB 2.0/3.0 controller (if you plan to connect external devices to the VM): USB 3.0 controller
    • optionally enable the "bridged" network connection (if you plan to connect to a real drone): Enabling bridge networking

    Note Some host network adapters may not work well with the bridged network. Consider using external USB Wi-Fi adapters managed by your VM to connect to a real drone.

  3. "Power on" the virtual machine. You may see a warning message about your host system not providing 3D acceleration:

    No 3D support from host

    Make sure you have the latest GPU drivers for your host system. If the warnings persist, add the following line to clover-devel.vmx (actual file name may differ based on the VM name):

    mks.gl.allowBlacklistedDrivers = "TRUE"

    You can find this file in a folder where the VM is imported to.

  4. (Bridged networking only) Set up network bridge configuration in VM settings or using vmware-netcfg utility (in Linux):

    vmware-netcfg interface

    Select vmnet0 in the networks list, set it to Bridged, and choose the adapter you are planning to use to connect to drone in the drop-down menu.