Ardity creates a thread in which it polls a COM port, all data it receives is stored in a shared thread-safe queue.

Later, your Unity program must either configure a callback that is invoked each time data is available, or call ReadSerialMessage() which dequeues the next message of this queue. You choose.

You can also send data to the COM port, use SendSerialMessage().

There are some sample scenes inside the Unity package, they are a good starting point, but basically what you need to get Ardity up and running is adding the SerialController script to one of your GameObjects:

If you let the "Message Listener" field unset, then you need to poll Ardity each time you want to get a message.

If you want Ardity to automatically call your own callback whenever a message arrives, then set that field to a GameObject that has the following two functions:

public class SampleMessageListener : MonoBehaviour
{
    // Invoked when a line of data is received from the serial device.
    void OnMessageArrived(string msg)
    {
        ...
    }

    // Invoked when a connect/disconnect event occurs. The parameter 'success'
    // will be 'true' upon connection, and 'false' upon disconnection or
    // failure to connect.
    void OnConnectionEvent(bool success)
    {
        ...
    }
}

The Arduino code necessary for making communication with Ardity possible is straightforward, use the Serial.println() function.

Here is an example of an Arduino program that works well with this library:

unsigned long last_time = 0;

void setup()
{
    Serial.begin(9600);
}

void loop()
{
    // Print a heartbeat
    if (millis() > last_time + 2000)
    {
        Serial.println("Arduino is alive!!");
        last_time = millis();
    }

    // Send some message when I receive an 'A' or a 'Z'.
    switch (Serial.read())
    {
        case 'A':
            Serial.println("That's the first letter of the abecedarium.");
            break;
        case 'Z':
            Serial.println("That's the last letter of the abecedarium.");
            break;
    }
}