Software

How to install software to use your robot

This section contains instructions about installing software needed to setup, run and program your MARRtino robot.

MARRtino Virtual Application and Raspberry image files

Version 2.x

Latest versions

v2.3 15/3/2019: Tablet interaction (Python interface)

v2.2 23/2/2019: camera settings for Raspberry PI B+

v2.1 13/2/2019: audio settings for Raspberry PI B+


MARRtino Virtual Application (Virtual Machine)

Requires:

  • Oracle VirtualBox 5.x or 6.x and Oracle VM VirtualBox Extension Pack
  • OVA file: MARRtino 2.2.ova

Installation instructions:

  • Install Oracle VirtualBox and Oracle VM VirtualBox Extension Pack
  • Download the Oracle virtual application MARRtino 2.2 (5 GB)
  • From Oracle VirtualBox, import the Oracle virtual application MARRtino.2.x (MARRtino2.x.ova file)
  • Run the MARRtino virtual application and enjoy it! (User: ubuntu, Password: marrtino)

For any help check also here.


Raspberry Pi 3 image files (for Model B and Model B+)

Image files for Model B: raspi3b_marrtino_v2.2 boot image (64 MB) - root image (10 GB)

Image files for Model B+: raspi3b+_marrtino_v2.2 boot image (64 MB) - root image (10 GB)

User: ubuntu, Password: marrtino

Raspberry Pi installation instructions


Network configuration for Raspberry Pi

Mount partition /dev/mmcblk0p2 (e.g., in /media/<USER>/PI_ROOT) and follow network configuration instructions in this file MARRtino v2.0 Network Configuration

This configuration will enable the Raspberry PI to act as a Wireless Access Point and will activate a web server on boot.

Boot Raspberry Pi with MARRtino software v2.x.

Connect your device to the wireless network provided by the Raspberry PI (e.g., MARRtino 101)

Open a browser to the URL http://10.3.1.1/ and follow links and instructions there.


Software update

The following instructions are valid both for the VM and for the Raspberry on the robot. To access a terminal on the Raspberry, open an ssh connection either from the VM (ssh ubuntu@10.3.1.1) or from the Config web page.

Updates need Internet connection. For the Raspberry, make sure it is connected to Internet through an Ethernet cable.

System update

Open a terminal (for Raspberry connect via ssh)

cd install
python marrtino_update.py

Confirm update

Password: marrtino

Note: you may need to repeat the update more times to update to the latest version. For example, to update from version 2.0 to version 2.2, you need to do the process twice: first to update from 2.0 to 2.1 and then to update from 2.1 to 2.2.

Note: system updates may require long time (specially if new libraries are compiled). Make sure you properly power the Raspberry (fully charged battery) and be patient!

IMPORTANT DO NOT INTERRUPT SYSTEM UPDATES

marrtino_apps update

Option 1: Use the button marrtino_apps Update in the Config web page

Option 2: open a terminal (for Raspberry connect via ssh) and type the commands

cd src/marrtino_apps
git pull

Version 1.x

You can use pre-installed operating systems either on a Virtual Machine (VM) or on a Raspberry PI3.

Updates to last version (for both VM and Raspberry)

Last version released: 1.8.0

The updates must be run on VM and (if any) on Raspberry.

0. To verify which version is installed on VM or Raspberry run: echo $MARRTINO_VERSION

1. Move to or create an install folder in the home directory

cd install

If the folder does not exist (you have a very old version), create it and download the update script.

mkdir install
cd install
wget -N http://www.diag.uniroma1.it/~iocchi/marrtino/marrtino_update.py

2. Run the update script

python marrtino_update.py

3. Confirm update to new version (if you want) and use the following password when needed

Password: marrtino

4. Execute again the update script if needed to reach the latest version.

Full downloads

Virtual Machine (Before the import of the VM, install VirtualBox 5.2.x + Extension Pack 5.2.x)

Last version available: MARRtino-v1.8.0

User: ubuntu, Password: marrtino

Raspberry PI3

1) Download boot and root images

Version 1.2 : boot_partition (64 MB) - root_partition (10 GB)

2) Insert SD card and create 3 partitions (e.g. using gparted) as shown below

P1) fat16, 64 MiB, Flags: boot, lba, (/dev/mmcblk0p1, /dev/sdb1), label PI_BOOT

Sectors: First: 2048 Last: 133119 Total: 131072

* flags can be set after format

P2) ext4, 10000 MiB, (/dev/mmcblk0p2, /dev/sdb2), label PI_ROOT

Sectors: First: 133120 Last: 20613119 Total: 20480000

P3) ext4, 20.34 GiB, (/dev/mmcblk0p3, /dev/sdb3), label data

Sectors: First: 20613120 Last: 63272959 Total: 42659840

3) Download the write script - check that the device names are correct and modify the script if needed - run the following commands

$ sudo bash
$ ./writeimg.bash raspi3_marrtino_v1.2

4) Put SD card in Raspberry, (for first setup, attach HDMI cable to a monitor) and boot it

User: ubuntu, Password: marrtino

5) Configure the network if needed.

Plug the Raspberry PI to an HDMI monitor, boot the Raspberry PI, configure the network locally and then use ssh to connect to it.

Manual installation

Manual installation (for expert users)