http://github.com/JChristensen/GroveStreams
README file

Arduino GroveStreams Library Copyright (C) 2015 Jack Christensen GNU GPL v3.0

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License v3.0 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/gpl.html

A library to communicate with the GroveStreams Data Analytics Platform.

Prerequisites
Mikal Hart's Streaming library
http://arduiniana.org/libraries/streaming/

To use the GroveStreams library:

• Go to https://github.com/JChristensen/GroveStreams, download the code as a ZIP file and save it to a convenient location on your PC.
• Uncompress the downloaded file. This will result in a folder containing all the files for the library, that has a name that includes the branch name, usually GroveStreams-master.
• Rename the folder to just GroveStreams.
• Copy the renamed folder to the Arduino sketchbook/libraries folder.

The following example sketches are included with the GroveStreams library:

• gsAnalog: A standalone GroveStreams client using an Arduino Uno, Arduino Ethernet Shield, and an analog temperature sensor.
• gsGateway: A data concentrator/web gateway node for an XBee ZB wireless sensor network. Use with the gsSensor example sketch.
• gsSensor: A wireless sensor node for use with gsGateway. Forwards sensor data to the gateway node which relays it to GroveStreams.
• aaXBee: A low-power, battery-operated wireless sensor node for use with gsGateway. Forwards sensor data to the gateway node which relays it to GroveStreams. For complete information on the circuit design, including Eagle files, configuration options, programming requirements, etc. see the GitHub repository.

See my blog post for step-by-step instructions to build a wireless sensor network using the gsGateway and gsSensor sketches.

Instantiates a GroveStreams object.

GroveStreams GS(serverName, apiKey, ledPin);

serverName A zero-terminated char array containing the address of the GroveStreams server (char*).

apiKey A zero-terminated char array in flash program memory containing the API key for the GroveStreams organization (const __FlashStringHelper*).

ledPin An optional argument giving the pin number of an LED to illuminate while waiting for responses from the GroveStreams server (int).

const char* gsServer = "grovestreams.com";
PROGMEM const char gsApiKey[] = "12345678-1234-5678-ABCD-1234567890AB";
const uint8_t WAIT_LED(7);		//LED on pin 7
GroveStreams myGS(gsServer, (const __FlashStringHelper*)gsApiKey, WAIT_LED);

Initializes the GroveStreams library.

myGS.begin();

None.

None.

Runs the GroveStreams state machine. This function should be called from loop() every time it is invoked, and loop() should be made to run as quickly as possible.

myGS.run();

None.

Status from the GroveStreams state machine. See the ethernetStatus_t enumeration in the GroveStreams.h file (ethernetStatus_t).

ethernetStatus_t gsStatus;
gsStatus = myGS.run();
if ( gsStatus == CONNECT_FAILED )
{
	Serial.println("Could not connect to GroveStreams");
}
else
{
	Serial.println("Connected to GroveStreams");
}

Sends data to GroveStreams for a specific component.

myGS.send(compID, data);

compID: A zero-terminated char array containing the GroveStreams component ID to receive the data (char*).

data: A zero-terminated char array containing the data to be sent. Each datastream must be formatted as &id=val where id is the GroveStreams datastream ID, and val is the value to be sent (char*).

SEND_ACCEPTED or SEND_BUSY, the latter indicating that the data was not sent because a transmission is already in progress. See the ethernetStatus_t enumeration in the GroveStreams.h file (ethernetStatus_t).

char myCompID[] = "c01";
char myPayload[40];
int speed, pressure, power;
sprintf( myPayload, "&ds1=%i&ds2=%i&ds3=%i, speed, pressure, power );
if ( myGS.send(myCompID, myPayload) == SEND_ACCEPTED )
{
    Serial.println("Data sent");
}
else
{
    Serial.println("Could not send data");
}

Resets the microcontroller after a given number of milliseconds. The minimum is 4 seconds (4000 ms). If a number less than 4000 is given, the delay will be approximately 4 seconds.

myGS.mcuReset(dly);

dly: Delay in milliseconds before reset (unsigned long).

None.

myGS.resetMCU(60000);		//reset after a minute

Utility function to convert an IP address to a zero-terminated char array for printing, etc.

myGS.ipToText(dest, ip);

dest: Array to receive the printable IP address. Minimum length is 16 characters (char*).

IPAddress: Input IP address (IPAddress).

None.

IPAddress likeHome(127, 0, 0, 1);
char noPlace[16];
myGS.ipToText( noPlace, likeHome );