Published September 15, 2015 © GPL3+

Raspberry Pi Supercomputer with MPI

This project shows communication between Raspberry pi nodes in a cluster using the message passing interface library standard.

IntermediateFull instructions provided16,040

Things used in this project

Hardware components

Raspberry Pi 2 Model B

I used 3 Pis for my project but as long as you have at least 2, you're fine.

LED (generic)

Resistor 221 ohm

Story

The message passing interface standard has long since been a way to perform parallel computing within a cluster of machines. I was interested in doing this project because A) I wanted to learn MPI and B) I was curious about the possibilities of what I can do with a cluster of Raspberry Pis. If you want to learn more about MPI in detail, check out https://computing.llnl.gov/tutorials/mpi/. I've decided to use the python implementation of MPI (http://mpi4py.scipy.org/) for the demo below.

This project will be a circuit of 3 LEDs. Each LED will represent a node (in this case a Raspberry Pi) which will light up when they send signals to the master node. The master node will stay lit to indicate that it's the primary controller sending commands to the other nodes. The circuit will be connected to the master node. The Pis that make up my cluster are shown in the project profile pic.

Here are the steps to get everything up and running:

1. Setting up SSH

You will need to set up password-less communication between all of your nodes. On each node:

Run the command "ssh-keygen -t rsa". When it prompts you to enter a passphrase, press enter twice to leave a blank entry. Once finished, your RSA public key will be created in your .ssh directory.
This public key file will need to be placed on the other nodes. You can accomplish this by running the "ssh-copy-id <IP or MachineName>" command which will automatically place the public key into the destination node's .ssh folder. It will prompt you for the password of the machine that your going to but that will be the only time you need to do that.
Try connecting via SSH to another node. You should be able to connect to that machine without any prompts for a password.

2. Install MPI4PY on all nodes within the cluster.

MPI4PY needs to be installed on all of the nodes. I've attached an installation script to this project that will download any dependencies you need and install the latest copy of MPI4PY for your convenience. Once installed, you will also need to create a "machinefile". The only contents in this file are the IP addresses to each node within the cluster. I've attached an example below.

3. Build the circuit

The circuit will consist of the LEDs, Resistors, etc. all connected to the master node of the cluster. The schematic below illustrates the setup.

4. Write the code.

The ledDemo.py will be ran from the master node. The code is listed below.

5. Deploy the code.

Once you're finished coding, you need to make sure that your program is placed in the exact location on each of the other nodes as it is for your master node. Otherwise, MPI will throw file not found errors when you attempt to run it.

6. EXECUTE!

From the master node, run the following command as root (since you are accessing the GPIO pins):

sudo mpirun.openmpi -np 3 -machinefile <location of machinefile> python ledDemo.py

Here's a breakdown of what this command means:

"mpirun.openmpi" is the primary executable to get all the communication started in the cluster.

"np" is the number of processes or number of nodes in your cluster.

"machinefile" corresponds to the location of your machinefile storing your cluster IPs.

"python" is of course what you need to run the python implementation of your code.

Here is a video of the cluster in action:

Code

#!/bin/sh

#Download all necessary dependencies and mpi4py
sudo apt-get install python-dev
sudo apt-get install python-mpi4py

#Create directory for source/demo files for mpi4py
mkdir mpi4py
cd mpi4py

#Download tarball file and extract source/demo files for mpi4py
curl -k -O https://mpi4py.googlecode.com/files/mpi4py-1.3.1.tar.gz

#MPI will already be installed at this point. This is only for having the source code, documentation, and demos for your convenience
tar xvfz mpi4py-1.3.1.tar.gz

"""
LED Demo
""" 

from mpi4py import MPI
import RPi.GPIO as GPIO

# Set up GPIO
GPIO.cleanup()
GPIO.setmode(GPIO.BCM)
GPIO.setup(17, GPIO.OUT) #master - Green LED
GPIO.setup(18, GPIO.OUT) #Slave 1 - Purple LED
GPIO.setup(23, GPIO.OUT) #Slave 2 - Red LED 

# MPI variables for communication, rank, size, and name of the node
comm = MPI.COMM_WORLD
rank = comm.Get_rank()
size = comm.Get_size()
name = MPI.Get_processor_name()

total_requests = 2500 

# This is the master node.
if rank == 0:
    request = 0
    process = 1

    # Send the first batch of processes to the nodes.
    while process < size and request < total_requests:
        comm.send(request, dest=process, tag=1)
        print "Sending request",request,"to process",process
        request += 1
        process += 1

    # Wait for the data to come back
    received_processes = 0
    while received_processes < total_requests:
        process = comm.recv(source=MPI.ANY_SOURCE, tag=1)
        print "Received data from process", process 
        if (process == 1):
	    GPIO.output(18, True)
	    GPIO.output(23, False)
	elif (process == 2):
	    GPIO.output(23, True)
	    GPIO.output(18, False)
        received_processes += 1

        if request < total_requests:
            comm.send(request, dest=process, tag=1)
            print "Sending request",request,"to process", process 
            GPIO.output(17, True)
            request += 1

    # Send the shutdown signal
    for process in range(1,size):
        comm.send(-1, dest=process, tag=1)
    print "End"

# These are the slave nodes, where rank > 0. They receive the request from the master node and simply send a response back 
else:
    while True:
        start = comm.recv(source=0, tag=1)
        if start == -1: break
        comm.send(rank, dest=0, tag=1)


#Clean up GPIO activities after all processing takes place
GPIO.cleanup()

Credits

Marcus Johnson

9 projects • 28 followers

Software engineer with professional experience creating, maintaining, integrating, and testing software in Windows and Unix environments.

Raspberry Pi Supercomputer with MPI

Things used in this project

Hardware components

Story

1. Setting up SSH

2. Install MPI4PY on all nodes within the cluster.

3. Build the circuit

4. Write the code.

5. Deploy the code.

6. EXECUTE!

Schematics

LED Circuit

Code

installMPI.sh

MachineFile example

ledDemo.py

Credits

Marcus Johnson

Comments

Embed the widget on your own site

Raspberry Pi Supercomputer with MPI

Raspberry Pi Supercomputer with MPI

Things used in this project

Hardware components

Story

1. Setting up SSH

2. Install MPI4PY on all nodes within the cluster.

3. Build the circuit

4. Write the code.

5. Deploy the code.

6. EXECUTE!

Schematics

LED Circuit

Code

installMPI.sh

MachineFile example

ledDemo.py

Credits

Marcus Johnson

Comments

Related channels and tags