Install mwp on a Windows computer for Linux noobs

This will install mwptools on Ubuntu (a Linux variant) in a virtual machine using VM VirtualBox on a windows computer. All is freeware or open source software.

Unmaintained Article Please check the manual for more up-to-date information.

Note: This contributed guide is outdated. In addition, there are credible reports of VirtualBox not providing sufficiently robust OpenGL to support the mapping library used by mwp. This may result in blank or corrupted maps, or mwp crashes.

freshly install Ubuntu on VM virtualBox

for instructions, see https://www.lifewire.com/install-ubuntu-linux-windows-10-steps-2202108

recommend at least 15GB virtual harddisk size, for the rest, just use the defaults.

once you can log into Ubuntu, it's time to install mwptools

Install mwptools

In a terminal:

mwp build instructions

see also https://vimeo.com/256052320 (note much of this is obsolete), just use the install script from the mwp build instructions

once this is completed, you should be able to start mwptools

mwp

when running, the MWP icon should show up on the left side... by right-click, and selecting Add to favorites, you can lock it there, so it is easier to start next time without going into the terminal window

Bluetooth connection

to connect to your FC using bluetooth, first bind the bluetooth adapter in ubuntu, go into bluetooth settings. it should see the adapter. click on it, and enter your password (usually 1234) it will change from 'Not set up' into 'Disconnected'

now, start mwp again. With your bluetooth adapter connected to the FC, it should show the adapter in the top right corner of mwp, and allow to connect

USB cable connection

when first connecting the cable, a /dev/ttyACM0 device should show up in the device field in mwp. However, it will probably refuse connection

first, you need to set permissions as follows. close mwp, and go back to terminal. type the following

sudo usermod -a -G dialout $USER

before the new permissions work, you need to logout from Ubuntu (or restart Ubuntu) and login again now, when opening mwp, it should allow you to connect using the cable as well.

Using the bluetooth dongle, I didn't need to set any permissions. However, when directly connected using a USB cable, I first need to set permissions.

Please note: in VirtualBox, it may be required to connect the bluetooth module (from the laptop) or the USB cable, to the virtual machine (Ubuntu) first (rather then to Windows), before you can connect any bluetooth / usb devices. Just find it in Devices menu (of VM VirtualBox), and enable it.

Blackbox logs

The install script installs blackbox-decode by default.

now, when opening mwp, the replay blackbox log and load blackbox log menu items (under file in mwp) should be selectable

Updating mwptools

whenever a new version is available on github, updating mwp is as follows (from terminal)

cd ~/Projects/mwptools/build

git pull && ninja install