cylon/examples/conway_sphero/conway_sphero.markdown

Conway's Game Of Life - With Spheros

For this Cylon example, we're going to run a version of Conway's Game Of Life, using Spheros as cells.

To account for the fact that we're now using Spheros to play the game, we need to make some changes to the mechanics. Here's how our version of Conway's Game will go:

• "alive" Spheros glow green, "dead" spheros glow red.
• At the start of the game, all Spheros are "alive".
• On every tick, the "alive" Spheros roll randomly, and count the number of collisions they have.
• After the tick, all the Spheros that had between two and six collisions are considered "alive", and those with less than two or more than six collisions are now "dead"
• If a "dead" Sphero is bumped into by an "alive" one, or has collisions through other means, it can become "alive" again.

With those alterations in hand, let's start building it with Cylon! Before you start, make sure you have the cylon-sphero module installed.

First off, let's load up Cylon:

var Cylon = require('../..');

For easier use later, let's define the colors we'll be using with the Spheros, green for alive and red for dead:

var Green = 0x0000FF,
    Red = 0xFF0000;

We'll be using four robots for this example, but they'll have very similar programming so we just need to define what's different between them for now. Each of the robots will have a unique name, and will communicate on their own port.

var bots = {
  'Thelma': '/dev/rfcomm0',
  'Louise': '/dev/rfcomm1',
  'Grace':  '/dev/rfcomm2',
  'Ada':    '/dev/rfcomm3'
};

That gets the basics out of the way.

Since, as previously mentioned, our robots all have the same basic functionality, we can just loop over the bots object, and create robots as we go.

Object.keys(bots).forEach(function(name) {
  var port = bots[name];

All of our robots will be connecting to a Sphero, and be operating via a single device (you guessed it, a Sphero).

  Cylon.robot({
    name: name,

    connections: {
      sphero: { adaptor: 'sphero', port: port }
    },

    devices: {
      sphero: { driver: 'sphero' }
    },

Now that the pieces are there, we can set up our robot's work. It starts by being "born", then moves every three seconds if it's alive, celebrates it's birthday every ten seconds, and increments it's contacts every time the Sphero detects a collision.

    work: function(my) {
      my.born();

      my.sphero.on('collision', function() {
        my.contacts += 1;
      });

      every((3).seconds(), function() {
        if (my.alive) {
          my.move();
        }
      });

      every((10).seconds(), function() {
        my.birthday();
      });
    },

When a robot is asked to move, it rolls in a random direction at speed 60.

    move: function() {
      this.sphero.roll(60, Math.floor(Math.random() * 360));
    },

When the robots are first started, they are born. This sets their contacts to zero, their age to zero, makes them "alive", and starts them moving for the first tick.

    born: function() {
      this.contacts = 0;
      this.age = 0;
      this.life();
      this.move();
    },

In the case of our robots, "life" just means the robot's internal "alive" state is set to true, and the Sphero's LED is set to green.

    life: function() {
      this.alive = true;
      this.sphero.setRGB(Green);
    },

Similarly, "death" just sets the "alive" state to false, the Sphero's color to red, and stops the Sphero from moving.

    death: function() {
      this.alive = false;
      this.sphero.setRGB(Red);
      this.sphero.stop();
    },

A robot is decided to have enough contacts if it has between two and six contacts.

    enoughContacts: function() {
      return this.contacts >= 2 && this.contacts < 7;
    },

On a robot's birthday, it increments it's age, prints it's name, age, and contacts to the console, and then determines if it's now alive or dead based on the number of contacts it had in the last tick.

    birthday: function() {
      this.age += 1;

      if (this.alive) {
        console.log("Happy birthday, " + this.name + ". You are " + this.age + " and had " + this.contacts + " contacts.");
      }

      if (this.enoughContacts()) {
        if (!this.alive) {
          this.born();
        }
      } else {
        this.death();
      }

      this.contacts = 0;
    }
  });
});

Now that Cylon knows about our robots and what they do, we can get started!

Cylon.start();