Install dependencies

To use some features, and depending on what is already installed on your system, you may have to add some additional packages to your system.

Run the following command to make sure these are installed, now.

$ sudo apt install python-matplotlib python-tk python-gi python-gi-cairo

Install MDK

First, download the latest version of the MDK[1].

Next, unzip the MDK to a location of your choice.

Finally, perform the following commands to install the MDK.

$ cd ~/mdk-190211/bin/deb64 $ ./install_mdk.sh ...
Here we have assumed you are storing your MDK at ~/mdk-190211—you should replace this with the actual path you have chosen.
If you are running on 32-bit Debian, here and throughout the documentation, replace the token deb64 with the token deb32, wherever it appears.

Open a new bash terminal, and you should see text similar to that shown below.

________________________________________________________________ Sourcing mdk/setup.bash... MIRO edition: 2 MDK path: ~/mdk MDK release: R190211 User setup: ~/.miro2/config/user_setup.bash Network address: x.x.x.x Type "miro_info" to see your environment ________________________________________________________________

[1] If your robot does not have the latest MDK installed, you can either install a matching version on your workstation, or update the software on your robot to the latest MDK by following this procedure.

Gotchas

Please check the FAQ section "MDK" for a list of common MDK installation gotchas if you find you have immediate problems.

What did that do?

The install script performs the following tasks.

Add symbolic link
A link is placed at ~/mdk that points at the newly-installed MDK.
Initialise automatically
A command is added to the bottom of ~/.bashrc to run setup.bash and initialise the MDK whenever you start a new bash terminal (you will see the output above when you do).
Network address
The network address is recovered automatically when setup.bash is run, and is indicated as "Network address" in the output above.
Create configuration directory
A configuration directory is created at ~/.miro2 and default configuration files are written there.
Build catkin workspace
If required, the catkin workspace at ~/mdk/catkin_ws is built.

Configuration

If you are happy with all of the above, and the "Network address" is correct, then you do not need to do anything further.

If you want to change these defaults, read the page Configure MDK for advice on doing so.

If "Network address" is not correct, you must follow the instructions at Configure MDK to correct this before you can use the MDK.

If you anticipate that your system's network configuration may change in future, you may want to read through Configure MDK now so that you are aware of what may break if your network changes.