Skip to content
Branch: master
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time


Odroid-C1 Fish for CloudI

Use odroid_display to display CloudI service requests as UTF8-art fish on a 16x2 (blue) LCD display. This is mainly for demonstration purposes and was inspired by (which is also in Python).

4 Odroid-C1 CloudI nodes are used to demonstrate both local and remote service request communication, with the "lake" configuration (Odroid-C1 node positions with 16x2 LCD displays) as:

(node 2)        (node 0)

(node 3)        (node 1)

The separate CloudI configuration files for each node are provided along with the Python CloudI service.


Each UTF8 fish contains the node integer that created the fish, so the node integer follows the fish in the LCD display as it swims to other nodes. The types of fish are shown below (for node 0):

>0)°>       bass
>←0{{·>     salmon
>←0[[[[θ>   carp

The fish are JSON data sent within CloudI service requests, with a timeout that determines the lifetime of the fish. Separate service requests manage the hatchery and view updates with regular "tick" intervals.

The 16x2 LCD display also provides 7 status LEDs below the LCD. These LEDs are toggled whenever a view update comes from a specific node (so a view update from node X toggles LED #X on the destination node Y). Once a fish's position crosses a node boundary, the fish's service request passes to the remote node (as shown at the end of FishState.__render_move). The internal time kept within the fish's JSON data is reset before the send to a remote node, since it is assumed that there is no clock synchronization in-place.

Running CloudI with the provided configurations on the 4 Odroid-C1s (not including a Netgear GS108 Gigabit Switch) consumes a total of ~14 watts.


Install (Node 0)

cd ~
mkdir src
cd src
git clone
cd CloudI/src
./ && CLOUDI_ARG_NODE_NAME_SHORT=odroid CLOUDI_ARG_NODE_COOKIE=odroid ./configure --with-cxx-backtrace --with-boost-libdir=/usr/lib/arm-linux-gnueabihf/ && ./make_dev
sudo ./make_dev install
cd ../../
git clone
cd wiringPi
cd ..
git clone
cd odroid_display/src
cd ../../
git clone
sudo mv -f /usr/local/etc/cloudi/cloudi.conf /usr/local/etc/cloudi/cloudi.conf.old
sudo cp -f odroid_fish/odroid0_cloudi.conf /usr/local/etc/cloudi/cloudi.conf
# make sure /etc/hostname and /etc/hosts allow the nodes to find each other
# (i.e., change "odroid" to "odroid0" and add IP addresses for 1-3)
sudo cloudi start


Michael Truog (mjtruog at protonmail dot com)


MIT License

Thematic Inspiration

Find The Fish (1983)


Make service requests swim!




No releases published
You can’t perform that action at this time.