Virtual Machine Installation

1. Download Oracle VirtualBox, Oracle Virtual Box Extension Pack and MARRtino_x.x.ova file.

2. Install VirtualBox and Extension Pack

  • IMPORTANT: You need to login to the PC with an Administrator user. In some cases, you may need to enable virtualization options in the BIOS of your PC.

  • Install VirtualBox: run the donwloaded executable (double click on the downloaded file) and follow the instructions.

  • install Extension Pack: open VirtualBox and follow

    • File --> Preferences --> Estensions

    • Click on "+" and select the downloaded file Oracle_VM_VirtualBox_Extension_Pack-X.X.xxx

3. Import MARRtino virtual application

  • Open VirtualBox and follow

    • File -> Import Appliance

    • Select downloaded file MARRtino_x.x.ova and confirm default options

  • MARRtino VM now appears in the list of VirtualBox available machines

4. Start MARRtino VM

  • Open VirtualBox, select MARRtino VM and Start it. If you get error messages about virtualization, you may need to enable this option in the BIOS of your PC. Find some guide on Internet searching for your PC model.

  • MARRtino 4.x system uses Ubuntu Mate 20.04 as base OS (User: marrtino Password: marrtino) and docker containers with ROS melodic and MARRtino software (User: robot, Password: robot)

  • You may want to change the keyboard layout, by clicking on the language symbol on the top right panel.

5. Start the simulation environment in the VM

  • Start MARRtino VM

  • Open Firefox browser

  • From the home page Welcome to MARRtino robot! select Bringup

  • Press Connect

  • Press Simrobot Start

  • Stage simulator window appears

6. Program the simulated robot

  • Start the simulator

  • Open the browser and select Programming

  • Open Commands page

  • Press Connect

  • Write a program pressing the action buttons. Click Play (green button) to execute the program. Use X button to cancel the program. The Python program is displayed on the right tab.

  • Press STOP, if you want to interrupt the execution of the program.

7. Close the environment

  • Disconnect in all the open web pages

  • In the Bringup page, select Simrobot Stop

  • Close Firefox web browser

  • Close the VM (shutdown menu on the top right panel).