• Download one of the last stable version of the libraries available (links below)
• Select Sketch->Include Library->add .ZIP Library from Arduino IDE
• Select the downloaded .ZIP file and you’re done.

Arduino based on Wifi8266 module

Note: The library import line is #include “abtoo.h”

Arduino based on Wifi library, intended to be used with Arduino WiFi Shield (beta version)

Note: The library import line is #include “abtoowifi.h”

Arduino based on Ethernet Library, intended to be used with Arduino Ethernet Shield (beta version)

Note: The library import line is #include “abtooeth.h”

PD: If you experience any issue using any of this libraries please send me a message.

#include "abtoo.h"

int ledPin = 13; // GPIO13
char* ssid = "myhomessid";
char* password = "mywifipassword";
int h = LOW;

AbetooIno abtoino;

void messageReceived(String message)
{
 Serial.println(message);
 h = h^1;
 digitalWrite(ledPin, h?HIGH:LOW);

}

void setup() {
 Serial.begin(9600);
 delay(10);
 
 pinMode(ledPin, OUTPUT);
 digitalWrite(ledPin, LOW);
 
 // Connect to WiFi network
 Serial.println();
 Serial.println();
 Serial.print("Connecting to ");
 Serial.println(ssid);
 
 WiFi.begin(ssid, password);
 
 while (WiFi.status() != WL_CONNECTED) {
 delay(500);
 Serial.print(".");
 }
 Serial.println("");
 Serial.println("WiFi connected");

 String uuid = "uudi1";
 String channel = "-TbVO-rqdA0iWg6-gWh0eeQ636243460528994051"
 "#735acf9cd6eda96e66ee3858496dca59d750aff1";
 int heartbeat = 1; //minutes
 abtoino.init(uuid, channel, heartbeat, messageReceived);
}

void loop()
{
 abtoino.abetooloop();
}

Let’s check it out the code a little bit deeper.

The first step, before define our connection, is to establish a wifi/ethernet link, in this particular case, in the example above, a wifi connection procedure is used.

 // Connect to WiFi network
 Serial.println();
 Serial.println();
 Serial.print("Connecting to ");
 Serial.println(ssid);
 
 WiFi.begin(ssid, password);
 
 while (WiFi.status() != WL_CONNECTED) {
 delay(500);
 Serial.print(".");
 }
 Serial.println("");
 Serial.println("WiFi connected")

Within setup procedure, we have to define the connection parameters, there’re only 4 parameters. We have to introduce a valid channel id string, a heartbeat timeout in minutes, a unique identifier uuid across other connections to the same channel id and a function callback messageReceived to react to new messages.

 String uuid = "uudi1";
 String channel = "-TbVO-rqdA0iWg6-gWh0eeQ636243460528994051"
 "#735acf9cd6eda96e66ee3858496dca59d750aff1";
 int heartbeat = 1; // minutes
 abtoino.init(uuid, channel, heartbeat, messageReceived);

Once a new message arrives the function messageReceived is triggered, showing message content and flipping a led.

void messageReceived(String message)
{
 Serial.println(message);
 h = h^1;
 digitalWrite(ledPin, h?HIGH:LOW);

}

The other important part is to include a calling to the abetooloop function withing loop procedure,

void loop()
{
 abtoino.abetooloop();
}

If you launch the code above, you’ll see something like this at the serial console,

 
#include "abtoo.h"

int ledPin = 13; // GPIO13
char* ssid = "homessid";
char* password = "mypassword";
int h = LOW;

AbetooIno abtoino;

void messageReceived(String message)
{
Serial.println(message);
h = h^1;
digitalWrite(ledPin, h?HIGH:LOW);

}

void setup() {
Serial.begin(9600);
delay(10);

pinMode(ledPin, OUTPUT);
digitalWrite(ledPin, LOW);

// Connect to WiFi network
Serial.println();
Serial.println();
Serial.print("Connecting to ");
Serial.println(ssid);

WiFi.begin(ssid, password);

while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print(".");
}
Serial.println("");
Serial.println("WiFi connected");

String uuid = "uudi1";
String channel = "-TbVO-rqdA0iWg6-gWh0eeQ636243460528994051"
"#735acf9cd6eda96e66ee3858496dca59d750aff1";
int heartbeat = 1; // minutes
abtoino.init(uuid, channel, heartbeat, messageReceived);
}

String channeltarget = "-uC6s1LfZaEuw9AK0Js1w9w636243459698606497#"
"b90a9186b9b61ead17d51251f689aea1779d5203";
long count = 0;
long messages = 0;
void loop()
{
if (count++ == 1000000)
{
count = 0;
String body = "Message from arduino ";
body = body + (messages++) + "!";
abtoino.sendMessage(channeltarget, body, "no correlation id");
}


abtoino.abetooloop();
}

There is only a new piece of code where the sending process take place,

 
String channeltarget = "-uC6s1LfZaEuw9AK0Js1w9w636243459698606497#"
 "b90a9186b9b61ead17d51251f689aea1779d5203";
long count = 0;
long messages = 0;
void loop()
{
 if (count++ == 1000000)
 {
 count = 0;
 String body = "Message from arduino ";
 body = body + (messages++) + "!";
 abtoino.sendMessage(channeltarget, body, "no correlation id");
 }
 
 
 abtoino.abetooloop();
}

We have to define a target channel id, a message body and an optional correlation id.

Once every 1000000 loop iterations a message is sent to the target channel id.

To ilustrate the functionality exposed above I’m going to show you an example with a target device based on the xamarin android code.

void init(String UUID, String ChannelName, int Heartbeat, void(*messageReceived)(String message));

Used to define the connection parameters. Call this methid within arduino setup procedure.

• UUID, a unique identifier across all arduino connected to the same channel id.
• channelName, local channel id.
• HeartBeat, Timeout. Used to check the health of a connection.
• messageReceived, a function callback triggered whenever a new message arrives.

Methods

void abetooloop()

Used to keep the connection openned and ready for new messages. You have to call this method once within arduino loop procedure.

No parameters.

States getState()

Return the current state of the background connection to the remote server. (DISCONNECTED, CONNECTING, CONNECTED, WAITING, SUBSCRIBING, SUBSCRIBED, SENDING, SENT, DISCONNECTING, STOP)

No parameters.

int sendMessage(String DestinationId, String Body, String Correlationid)

Used to send messages to a remote device using it’s channel id

• DestinationId, channel id of the remote device you want to send a message.
• Body, message as a XML/JSON or as a plain text.
• Correlationid, used to keep track about the messages sent/received. If you want to use a challenge/response approach you can associate the challenge sent message with a correlation id, once a message is received you can use its correlation id to identify the associated challenge message.