From f34eaf039af4f442f4adf0ddb80e53a6cdaa5c2f Mon Sep 17 00:00:00 2001 From: Cristian Maglie Date: Thu, 27 Jun 2013 22:40:34 +0200 Subject: Temboo examples moved in their specific folder --- .../GetYahooWeatherReport.ino | 103 ------------ .../Bridge/examples/ReadATweet/ReadATweet.ino | 174 --------------------- .../Bridge/examples/SendAnEmail/SendAnEmail.ino | 142 ----------------- .../SendDataToGoogleSpreadsheet.ino | 165 ------------------- .../GetYahooWeatherReport.ino | 103 ++++++++++++ .../examples/Temboo/ReadATweet/ReadATweet.ino | 174 +++++++++++++++++++++ .../examples/Temboo/SendAnEmail/SendAnEmail.ino | 142 +++++++++++++++++ .../SendDataToGoogleSpreadsheet.ino | 165 +++++++++++++++++++ 8 files changed, 584 insertions(+), 584 deletions(-) delete mode 100644 libraries/Bridge/examples/GetYahooWeatherReport/GetYahooWeatherReport.ino delete mode 100644 libraries/Bridge/examples/ReadATweet/ReadATweet.ino delete mode 100644 libraries/Bridge/examples/SendAnEmail/SendAnEmail.ino delete mode 100644 libraries/Bridge/examples/SendDataToGoogleSpreadsheet/SendDataToGoogleSpreadsheet.ino create mode 100644 libraries/Bridge/examples/Temboo/GetYahooWeatherReport/GetYahooWeatherReport.ino create mode 100644 libraries/Bridge/examples/Temboo/ReadATweet/ReadATweet.ino create mode 100644 libraries/Bridge/examples/Temboo/SendAnEmail/SendAnEmail.ino create mode 100644 libraries/Bridge/examples/Temboo/SendDataToGoogleSpreadsheet/SendDataToGoogleSpreadsheet.ino (limited to 'libraries') diff --git a/libraries/Bridge/examples/GetYahooWeatherReport/GetYahooWeatherReport.ino b/libraries/Bridge/examples/GetYahooWeatherReport/GetYahooWeatherReport.ino deleted file mode 100644 index d8fdf61..0000000 --- a/libraries/Bridge/examples/GetYahooWeatherReport/GetYahooWeatherReport.ino +++ /dev/null @@ -1,103 +0,0 @@ -/* - GetYahooWeatherReport - - Demonstrates making a request to the Yahoo! Weather API using the Temboo Arduino Yun SDK. - - A Temboo account and application key are necessary to run all Temboo examples. - If you don't already have one, you can register for a free Temboo account at - http://www.temboo.com - - This example assumes basic familiarity with Arduino sketches, and that your Yun is connected - to the Internet. For more tutorials on using the Temboo Library and Temboo Arduino Yun SDK, visit - http://www.temboo.com/arduino - - This example code is in the public domain. -*/ - -#include -#include -#include -#include -#include -#include "TembooAccount.h" // contains Temboo account information, as described below - -int numRuns = 0; // execution count, so that this doesn't run forever -int maxRuns = 10; // max number of times the Yahoo WeatherByAddress Choreo should be run - -void setup() { - Serial.begin(9600); - - // for debugging, wait until a serial console is connected - while(!Serial); - Bridge.begin(); -} - -void loop() -{ - // while we haven't reached the max number of runs... - if (numRuns < maxRuns) { - - // print status - Serial.println("Running GetWeatherByAddress - Run #" + String(numRuns++)); - - // we need a Process object to send a Choreo request to Temboo - Process GetWeatherByAddressChoreo; - - // invoke the Temboo client - GetWeatherByAddressChoreo.begin("temboo"); - - // set Temboo account credentials - GetWeatherByAddressChoreo.addParameter("-a"); - GetWeatherByAddressChoreo.addParameter(TEMBOO_ACCOUNT); - GetWeatherByAddressChoreo.addParameter("-u"); - GetWeatherByAddressChoreo.addParameter(TEMBOO_APP_KEY_NAME); - GetWeatherByAddressChoreo.addParameter("-p"); - GetWeatherByAddressChoreo.addParameter(TEMBOO_APP_KEY); - - // identify the Temboo Library choreo to run (Yahoo > Weather > GetWeatherByAddress) - GetWeatherByAddressChoreo.addParameter("-c"); - GetWeatherByAddressChoreo.addParameter("/Library/Yahoo/Weather/GetWeatherByAddress"); - - // set choreo inputs; in this case, the address for which to retrieve weather data - // the Temboo client provides standardized calls to 100+ cloud APIs - GetWeatherByAddressChoreo.addParameter("-i"); - GetWeatherByAddressChoreo.addParameter("Address:104 Franklin St., New York NY 10013"); - - // run the choreo - GetWeatherByAddressChoreo.run(); - - // when the choreo results are available, print them to the serial monitor - while(GetWeatherByAddressChoreo.available()) { - - // note that in this example, we just print the raw XML response from Yahoo - // see the examples on using Temboo SDK output filters at http://www.temboo.com/arduino - // for information on how to filter this data - - Serial.print((char)GetWeatherByAddressChoreo.read()); - } - GetWeatherByAddressChoreo.close(); - - } - - Serial.println("Sleeping..."); - delay(30000); // sleep 30 seconds between GetWeatherByAddress calls -} - -/* - IMPORTANT NOTE: TembooAccount.h: - - TembooAccount.h is a file referenced by this sketch that contains your Temboo account information. - You need to create this file. To do so, make a new tab in Arduino, call it TembooAccount.h, and - include the following variables and constants: - - #define TEMBOO_ACCOUNT "myTembooAccountName" // your Temboo account name - #define TEMBOO_APP_KEY_NAME "myFirstApp" // your Temboo app key name - #define TEMBOO_APP_KEY "xxx-xxx-xxx-xx-xxx" // your Temboo app key - - The same TembooAccount.h file settings can be used for all Temboo SDK sketches. - - Visit https://www.temboo.com/account to access your Temboo account credentials. - - Keeping your account information in a separate file means you can save it once, - then just distribute the main .ino file without worrying that you forgot to delete your credentials. -*/ diff --git a/libraries/Bridge/examples/ReadATweet/ReadATweet.ino b/libraries/Bridge/examples/ReadATweet/ReadATweet.ino deleted file mode 100644 index e732412..0000000 --- a/libraries/Bridge/examples/ReadATweet/ReadATweet.ino +++ /dev/null @@ -1,174 +0,0 @@ -/* - ReadATweet - - Demonstrates retrieving the most recent Tweet from a user's home timeline - using the Temboo Arduino Yun SDK. - - A Temboo account and application key are necessary to run all Temboo examples. - If you don't already have one, you can register for a free Temboo account at - http://www.temboo.com - - In order to run this sketch, you'll need to register an application using - the Twitter dev console at https://dev.twitter.com. After creating the - app, you'll find OAuth credentials for that application under the "OAuth Tool" tab. - Substitute these values for the placeholders below. - - This example assumes basic familiarity with Arduino sketches, and that your Yun - is connected to the Internet. For more tutorials on using the Temboo Library and - Temboo Arduino Yun SDK, visit http://www.temboo.com/arduino - - This example code is in the public domain. -*/ - -#include -#include -#include -#include -#include -#include "TembooAccount.h" // contains Temboo account information, as described below - -int numRuns = 0; // execution count, so this sketch doesn't run forever -int maxRuns = 10; // the max number of times the Twitter HomeTimeline Choreo should run - -void setup() { - Serial.begin(9600); - - // for debugging, wait until a serial console is connected - delay(4000); - while(!Serial); - Bridge.begin(); -} - -void loop() -{ - // while we haven't reached the max number of runs... - if (numRuns < maxRuns) { - - // print status - Serial.println("Running HomeTimeline - Run #" + String(numRuns++)); - - // define the Process that will be used to call the "temboo" client - Process HomeTimelineChoreo; - - // invoke the Temboo client - HomeTimelineChoreo.begin("temboo"); - - // set Temboo account credentials - HomeTimelineChoreo.addParameter("-a"); - HomeTimelineChoreo.addParameter(TEMBOO_ACCOUNT); - HomeTimelineChoreo.addParameter("-u"); - HomeTimelineChoreo.addParameter(TEMBOO_APP_KEY_NAME); - HomeTimelineChoreo.addParameter("-p"); - HomeTimelineChoreo.addParameter(TEMBOO_APP_KEY); - - // tell the Temboo client which Choreo to run (Twitter > Timelines > HomeTimeline) - HomeTimelineChoreo.addParameter("-c"); - HomeTimelineChoreo.addParameter("/Library/Twitter/Timelines/HomeTimeline"); - - // set the required choreo inputs - // see https://www.temboo.com/library/Library/Twitter/Timelines/HomeTimeline/ - // for complete details about the inputs for this Choreo - - HomeTimelineChoreo.addParameter("-i"); - HomeTimelineChoreo.addParameter("Count:1"); // the max number of Tweets to return from each request - - // IMPORTANT! You'll need to substitute your own Access Token, Access Token Secret, - // Consumer Secret, and Consumer Key from the Twitter dev console into the method calls - // below. (Make sure not to delete the "AccessToken:" etc prefixes!) - HomeTimelineChoreo.addParameter("-i"); - HomeTimelineChoreo.addParameter("AccessToken:your-twitter-access-token"); - HomeTimelineChoreo.addParameter("-i"); - HomeTimelineChoreo.addParameter("AccessTokenSecret:your-twitter-access-token-secret"); - HomeTimelineChoreo.addParameter("-i"); - HomeTimelineChoreo.addParameter("ConsumerSecret:your-twitter-consumer-secret"); - HomeTimelineChoreo.addParameter("-i"); - HomeTimelineChoreo.addParameter("ConsumerKey:your-twitter-consumer-key"); - - // next, we'll define two output filters that let us specify the - // elements of the response from Twitter that we want to receive. - // see the examples at http://www.temboo.com/arduino - // for more on using output filters - - // we want the text of the tweet - HomeTimelineChoreo.addParameter("-o"); - HomeTimelineChoreo.addParameter("tweet:/[1]/text:Response"); - - // and the name of the author - HomeTimelineChoreo.addParameter("-o"); - HomeTimelineChoreo.addParameter("author:/[1]/user/screen_name:Response"); - - - // tell the Process to run and wait for the results. The - // return code (rc) will tell us whether the Temboo client - // was able to send our request to the Temboo servers - unsigned int rc = HomeTimelineChoreo.run(); - - // a response code of 0 means success; print the API response - if(rc == 0) { - - String author; // a String to hold the tweet author's name - String tweet; // a String to hold the text of the tweet - - - // choreo outputs are returned as key/value pairs, delimited with - // newlines and record/field terminator characters, for example: - // Name1\n\x1F - // Value1\n\x1E - // Name2\n\x1F - // Value2\n\x1E - - // see the examples at http://www.temboo.com/arduino for more details - // we can read this format into separate variables, as follows: - - while(HomeTimelineChoreo.available()) { - // read the name of the output item - String name = HomeTimelineChoreo.readStringUntil('\x1F'); - name.trim(); - - // read the value of the output item - String data = HomeTimelineChoreo.readStringUntil('\x1E'); - data.trim(); - - // assign the value to the appropriate String - if (name == "tweet") { - tweet = data; - } else if (name == "author") { - author = data; - } - } - - Serial.println("@" + author + " - " + tweet); - - } else { - // there was an error - // print the raw output from the choreo - while(HomeTimelineChoreo.available()) { - Serial.print((char)HomeTimelineChoreo.read()); - } - } - - HomeTimelineChoreo.close(); - } - - Serial.println("Sleeping..."); - delay(90000); // sleep 90 seconds between HomeTimeline calls -} - -/* - IMPORTANT NOTE: TembooAccount.h: - - TembooAccount.h is a file referenced by this sketch that contains your Temboo account information. - You need to create this file. To do so, make a new tab in Arduino, call it TembooAccount.h, and - include the following variables and constants: - - #define TEMBOO_ACCOUNT "myTembooAccountName" // your Temboo account name - #define TEMBOO_APP_KEY_NAME "myFirstApp" // your Temboo app key name - #define TEMBOO_APP_KEY "xxx-xxx-xxx-xx-xxx" // your Temboo app key - - The same TembooAccount.h file settings can be used for all Temboo SDK sketches. - - Visit https://www.temboo.com/account to access your Temboo account credentials. - - Keeping your account information in a separate file means you can save it once, - then just distribute the main .ino file without worrying that you forgot to delete your credentials. -*/ diff --git a/libraries/Bridge/examples/SendAnEmail/SendAnEmail.ino b/libraries/Bridge/examples/SendAnEmail/SendAnEmail.ino deleted file mode 100644 index a8409d9..0000000 --- a/libraries/Bridge/examples/SendAnEmail/SendAnEmail.ino +++ /dev/null @@ -1,142 +0,0 @@ -/* - SendAnEmail - - Demonstrates sending an email via a Google Gmail account - using the Temboo Arduino Yun SDK. - - A Temboo account and application key are necessary to run all Temboo examples. - If you don't already have one, you can register for a free Temboo account at - http://www.temboo.com - - Since this sketch uses Gmail to send the email, you'll also need a valid - Google Gmail account. The sketch needs the username and password you use - to log into your Gmail account: substitute the placeholders below for these values. - - This example assumes basic familiarity with Arduino sketches, and that your Yun is connected - to the Internet. For more tutorials on using the Temboo Library and Temboo Arduino Yun SDK, visit - http://www.temboo.com/arduino - - This example code is in the public domain. -*/ - -#include -#include -#include -#include -#include -#include "TembooAccount.h" // contains Temboo account information, as described below - - -boolean success = false; // a flag to indicate whether we've sent the email yet or not - -void setup() { - Serial.begin(9600); - - // for debugging, wait until a serial console is connected - delay(4000); - while(!Serial); - - Bridge.begin(); -} - -void loop() -{ - // only try to send the email if we haven't already sent it successfully - if (!success) { - - Serial.println("Running SendEmail ..."); - - // we need a Process object to send a Choreo request to Temboo - Process SendEmailChoreo; - - // invoke the Temboo client - SendEmailChoreo.begin("temboo"); - - // set Temboo account credentials - SendEmailChoreo.addParameter("-a"); - SendEmailChoreo.addParameter(TEMBOO_ACCOUNT); - SendEmailChoreo.addParameter("-u"); - SendEmailChoreo.addParameter(TEMBOO_APP_KEY_NAME); - SendEmailChoreo.addParameter("-p"); - SendEmailChoreo.addParameter(TEMBOO_APP_KEY); - - // identify the Temboo Library choreo to run (Google > Gmail > SendEmail) - SendEmailChoreo.addParameter("-c"); - SendEmailChoreo.addParameter("/Library/Google/Gmail/SendEmail"); - - // set the required choreo inputs - // see https://www.temboo.com/library/Library/Google/Gmail/SendEmail/ - // for complete details about the inputs for this Choreo - - // the first input is a your Gmail user name. - // NOTE: substitute your own value, retaining the "Username:" prefix. - SendEmailChoreo.addParameter("-i"); - SendEmailChoreo.addParameter("Username:your-gmail-username"); - - // next is your Gmail password. - // NOTE: substitute your own value, retaining the "Password:" prefix - SendEmailChoreo.addParameter("-i"); - SendEmailChoreo.addParameter("Password:your-gmail-password"); - - // then a subject line - SendEmailChoreo.addParameter("-i"); - SendEmailChoreo.addParameter("Subject:ALERT: Greenhouse Temperature"); - - // next comes the message body, the main content of the email - SendEmailChoreo.addParameter("-i"); - SendEmailChoreo.addParameter("MessageBody:Hey! The greenhouse is too cold!"); - - // next is the email address of who the email is from. - // NOTE: substitute your Gmail address, retaining the "FromAddress:" prefix. - SendEmailChoreo.addParameter("-i"); - SendEmailChoreo.addParameter("FromAddress:your-gmail-email-address"); - - // who to send the email to - // NOTE: substitute your desired recipient, retaining the "ToAddress:" prefix - SendEmailChoreo.addParameter("-i"); - SendEmailChoreo.addParameter("ToAddress:recipient-email-address"); - - // tell the Process to run and wait for the results. The - // return code (rc) will tell us whether the Temboo client - // was able to send our request to the Temboo servers - unsigned int rc = SendEmailChoreo.run(); - - // a return code of zero (0) means everything worked - if (rc == 0) { - Serial.println("Success! Email sent!"); - success = true; - } else { - // a non-zero return code means there was an error - // read and print the error message - while (SendEmailChoreo.available()) { - Serial.print((char)SendEmailChoreo.read()); - } - } - SendEmailChoreo.close(); - - // do nothing for the next 60 seconds - delay(60000); - } -} - -/* - IMPORTANT NOTE: TembooAccount.h: - - TembooAccount.h is a file referenced by this sketch that contains your Temboo account information. - You need to create this file. To do so, make a new tab in Arduino, call it TembooAccount.h, and - include the following variables and constants: - - #define TEMBOO_ACCOUNT "myTembooAccountName" // your Temboo account name - #define TEMBOO_APP_KEY_NAME "myFirstApp" // your Temboo app key name - #define TEMBOO_APP_KEY "xxx-xxx-xxx-xx-xxx" // your Temboo app key - - The same TembooAccount.h file settings can be used for all Temboo SDK sketches. - - Visit https://www.temboo.com/account to access your Temboo account credentials. - - Keeping your account information in a separate file means you can save it once, - then just distribute the main .ino file without worrying that you forgot to delete your credentials. - - (Be sure to delete this comment after creating your TembooAccount.h file!) -*/ - diff --git a/libraries/Bridge/examples/SendDataToGoogleSpreadsheet/SendDataToGoogleSpreadsheet.ino b/libraries/Bridge/examples/SendDataToGoogleSpreadsheet/SendDataToGoogleSpreadsheet.ino deleted file mode 100644 index 984bd53..0000000 --- a/libraries/Bridge/examples/SendDataToGoogleSpreadsheet/SendDataToGoogleSpreadsheet.ino +++ /dev/null @@ -1,165 +0,0 @@ -/* - SendDataToGoogleSpreadsheet - - Demonstrates appending a row of data to a Google spreadsheet - from the Arduino Yun using the Temboo Arduino Yun SDK. - - A Temboo account and application key are necessary to run all Temboo examples. - If you don't already have one, you can register for a free Temboo account at - http://www.temboo.com - - This example assumes basic familiarity with Arduino sketches, and that your - Yun is connected to the Internet. For more tutorials on using the Temboo Library - and Temboo Arduino Yun SDK, visit http://www.temboo.com/arduino - - Since this sketch uses a Google spreadsheet, you'll also need a - Google account: substitute the placeholders below for your Google account values. - - The columns in your spreadsheet must have labels for the Choreo to - work properly. It doesn't matter what the column labels actually are, - but there must be text in the first row of each column. This example - assumes there are two columns. The first column is the time (in milliseconds) - that the row was appended, and the second column is a sensor value - (simulated in this example via a random number). - - This example code is in the public domain. - -*/ - -#include -#include -#include -#include -#include -#include "TembooAccount.h" // contains Temboo account information, as described below - - -const unsigned long RUN_INTERVAL_MILLIS = 60000; // how often to run the Choreo (in milliseconds) - -// the last time we ran the Choreo -// (initialized to 60 seconds ago so the -// Choreo is run immediately when we start up) -unsigned long lastRun = (unsigned long)-60000; - -void setup() { - - // for debugging, wait until a serial console is connected - Serial.begin(9600); - delay(4000); - while(!Serial); - - Serial.print("Initializing the bridge..."); - Bridge.begin(); - Serial.println("Done"); -} - -void loop() -{ - // get the number of milliseconds this sketch has been running - unsigned long now = millis(); - - // run again if it's been 60 seconds since we last ran - if (now - lastRun >= RUN_INTERVAL_MILLIS) { - - // remember 'now' as the last time we ran the choreo - lastRun = now; - - Serial.println("Getting sensor value..."); - - // get the value we want to append to our spreadsheet - unsigned long sensorValue = getSensorValue(); - - Serial.println("Appending value to spreadsheet..."); - - // we need a Process object to send a Choreo request to Temboo - Process AppendRowChoreo; - - // invoke the Temboo client - AppendRowChoreo.begin("temboo"); - - // set Temboo account credentials - AppendRowChoreo.addParameter("-a"); - AppendRowChoreo.addParameter(TEMBOO_ACCOUNT); - AppendRowChoreo.addParameter("-u"); - AppendRowChoreo.addParameter(TEMBOO_APP_KEY_NAME); - AppendRowChoreo.addParameter("-p"); - AppendRowChoreo.addParameter(TEMBOO_APP_KEY); - - // identify the Temboo Library choreo to run (Google > Spreadsheets > AppendRow) - AppendRowChoreo.addParameter("-c"); - AppendRowChoreo.addParameter("/Library/Google/Spreadsheets/AppendRow"); - - // set the required Choreo inputs - // see https://www.temboo.com/library/Library/Google/Spreadsheets/AppendRow/ - // for complete details about the inputs for this Choreo - - // your Google username (usually your email address) - // NOTE: substitute your own value, retaining the "Username:" prefix. - AppendRowChoreo.addParameter("-i"); - AppendRowChoreo.addParameter("Username:your-google-username"); - - // your Google account password - // NOTE: substitute your own value, retaining the "Password:" prefix. - AppendRowChoreo.addParameter("-i"); - AppendRowChoreo.addParameter("Password:your-google-password"); - - // the title of the spreadsheet you want to append to - // NOTE: substitute your own value, retaining the "SpreadsheetTitle:" prefix. - AppendRowChoreo.addParameter("-i"); - AppendRowChoreo.addParameter("SpreadsheetTitle:your-spreadsheet-title"); - - // convert the time and sensor values to a comma separated string - String rowData(now); - rowData += ","; - rowData += sensorValue; - - // add the RowData input item - AppendRowChoreo.addParameter("-i"); - AppendRowChoreo.addParameter("RowData:" + rowData); - - // run the Choreo and wait for the results - // The return code (rc) will indicate success or failure - unsigned int rc = AppendRowChoreo.run(); - - // return code of zero (0) means success - if (rc == 0) { - Serial.println("Success! Appended " + rowData); - } else { - // return code of anything other than zero means failure - // read and display any error messages - while (AppendRowChoreo.available()) { - Serial.print((char)AppendRowChoreo.read()); - } - } - - AppendRowChoreo.close(); - } -} - -// this function simulates reading the value of a sensor -// in this example, we're generating a random number -unsigned long getSensorValue() { - return (unsigned long)random(0, 256); -} - -/* - IMPORTANT NOTE: TembooAccount.h: - - TembooAccount.h is a file referenced by this sketch that contains your Temboo account information. - You need to create this file. To do so, make a new tab in Arduino, call it TembooAccount.h, and - include the following variables and constants: - - #define TEMBOO_ACCOUNT "myTembooAccountName" // your Temboo account name - #define TEMBOO_APP_KEY_NAME "myFirstApp" // your Temboo app key name - #define TEMBOO_APP_KEY "xxx-xxx-xxx-xx-xxx" // your Temboo app key - - The same TembooAccount.h file settings can be used for all Temboo SDK sketches. - - Visit https://www.temboo.com/account to access your Temboo account credentials. - - Keeping your account information in a separate file means you can save it once, - then just distribute the main .ino file without worrying that you forgot to delete your credentials. - - (Be sure to delete this comment after creating your TembooAccount.h file!) -*/ - diff --git a/libraries/Bridge/examples/Temboo/GetYahooWeatherReport/GetYahooWeatherReport.ino b/libraries/Bridge/examples/Temboo/GetYahooWeatherReport/GetYahooWeatherReport.ino new file mode 100644 index 0000000..d8fdf61 --- /dev/null +++ b/libraries/Bridge/examples/Temboo/GetYahooWeatherReport/GetYahooWeatherReport.ino @@ -0,0 +1,103 @@ +/* + GetYahooWeatherReport + + Demonstrates making a request to the Yahoo! Weather API using the Temboo Arduino Yun SDK. + + A Temboo account and application key are necessary to run all Temboo examples. + If you don't already have one, you can register for a free Temboo account at + http://www.temboo.com + + This example assumes basic familiarity with Arduino sketches, and that your Yun is connected + to the Internet. For more tutorials on using the Temboo Library and Temboo Arduino Yun SDK, visit + http://www.temboo.com/arduino + + This example code is in the public domain. +*/ + +#include +#include +#include +#include +#include +#include "TembooAccount.h" // contains Temboo account information, as described below + +int numRuns = 0; // execution count, so that this doesn't run forever +int maxRuns = 10; // max number of times the Yahoo WeatherByAddress Choreo should be run + +void setup() { + Serial.begin(9600); + + // for debugging, wait until a serial console is connected + while(!Serial); + Bridge.begin(); +} + +void loop() +{ + // while we haven't reached the max number of runs... + if (numRuns < maxRuns) { + + // print status + Serial.println("Running GetWeatherByAddress - Run #" + String(numRuns++)); + + // we need a Process object to send a Choreo request to Temboo + Process GetWeatherByAddressChoreo; + + // invoke the Temboo client + GetWeatherByAddressChoreo.begin("temboo"); + + // set Temboo account credentials + GetWeatherByAddressChoreo.addParameter("-a"); + GetWeatherByAddressChoreo.addParameter(TEMBOO_ACCOUNT); + GetWeatherByAddressChoreo.addParameter("-u"); + GetWeatherByAddressChoreo.addParameter(TEMBOO_APP_KEY_NAME); + GetWeatherByAddressChoreo.addParameter("-p"); + GetWeatherByAddressChoreo.addParameter(TEMBOO_APP_KEY); + + // identify the Temboo Library choreo to run (Yahoo > Weather > GetWeatherByAddress) + GetWeatherByAddressChoreo.addParameter("-c"); + GetWeatherByAddressChoreo.addParameter("/Library/Yahoo/Weather/GetWeatherByAddress"); + + // set choreo inputs; in this case, the address for which to retrieve weather data + // the Temboo client provides standardized calls to 100+ cloud APIs + GetWeatherByAddressChoreo.addParameter("-i"); + GetWeatherByAddressChoreo.addParameter("Address:104 Franklin St., New York NY 10013"); + + // run the choreo + GetWeatherByAddressChoreo.run(); + + // when the choreo results are available, print them to the serial monitor + while(GetWeatherByAddressChoreo.available()) { + + // note that in this example, we just print the raw XML response from Yahoo + // see the examples on using Temboo SDK output filters at http://www.temboo.com/arduino + // for information on how to filter this data + + Serial.print((char)GetWeatherByAddressChoreo.read()); + } + GetWeatherByAddressChoreo.close(); + + } + + Serial.println("Sleeping..."); + delay(30000); // sleep 30 seconds between GetWeatherByAddress calls +} + +/* + IMPORTANT NOTE: TembooAccount.h: + + TembooAccount.h is a file referenced by this sketch that contains your Temboo account information. + You need to create this file. To do so, make a new tab in Arduino, call it TembooAccount.h, and + include the following variables and constants: + + #define TEMBOO_ACCOUNT "myTembooAccountName" // your Temboo account name + #define TEMBOO_APP_KEY_NAME "myFirstApp" // your Temboo app key name + #define TEMBOO_APP_KEY "xxx-xxx-xxx-xx-xxx" // your Temboo app key + + The same TembooAccount.h file settings can be used for all Temboo SDK sketches. + + Visit https://www.temboo.com/account to access your Temboo account credentials. + + Keeping your account information in a separate file means you can save it once, + then just distribute the main .ino file without worrying that you forgot to delete your credentials. +*/ diff --git a/libraries/Bridge/examples/Temboo/ReadATweet/ReadATweet.ino b/libraries/Bridge/examples/Temboo/ReadATweet/ReadATweet.ino new file mode 100644 index 0000000..e732412 --- /dev/null +++ b/libraries/Bridge/examples/Temboo/ReadATweet/ReadATweet.ino @@ -0,0 +1,174 @@ +/* + ReadATweet + + Demonstrates retrieving the most recent Tweet from a user's home timeline + using the Temboo Arduino Yun SDK. + + A Temboo account and application key are necessary to run all Temboo examples. + If you don't already have one, you can register for a free Temboo account at + http://www.temboo.com + + In order to run this sketch, you'll need to register an application using + the Twitter dev console at https://dev.twitter.com. After creating the + app, you'll find OAuth credentials for that application under the "OAuth Tool" tab. + Substitute these values for the placeholders below. + + This example assumes basic familiarity with Arduino sketches, and that your Yun + is connected to the Internet. For more tutorials on using the Temboo Library and + Temboo Arduino Yun SDK, visit http://www.temboo.com/arduino + + This example code is in the public domain. +*/ + +#include +#include +#include +#include +#include +#include "TembooAccount.h" // contains Temboo account information, as described below + +int numRuns = 0; // execution count, so this sketch doesn't run forever +int maxRuns = 10; // the max number of times the Twitter HomeTimeline Choreo should run + +void setup() { + Serial.begin(9600); + + // for debugging, wait until a serial console is connected + delay(4000); + while(!Serial); + Bridge.begin(); +} + +void loop() +{ + // while we haven't reached the max number of runs... + if (numRuns < maxRuns) { + + // print status + Serial.println("Running HomeTimeline - Run #" + String(numRuns++)); + + // define the Process that will be used to call the "temboo" client + Process HomeTimelineChoreo; + + // invoke the Temboo client + HomeTimelineChoreo.begin("temboo"); + + // set Temboo account credentials + HomeTimelineChoreo.addParameter("-a"); + HomeTimelineChoreo.addParameter(TEMBOO_ACCOUNT); + HomeTimelineChoreo.addParameter("-u"); + HomeTimelineChoreo.addParameter(TEMBOO_APP_KEY_NAME); + HomeTimelineChoreo.addParameter("-p"); + HomeTimelineChoreo.addParameter(TEMBOO_APP_KEY); + + // tell the Temboo client which Choreo to run (Twitter > Timelines > HomeTimeline) + HomeTimelineChoreo.addParameter("-c"); + HomeTimelineChoreo.addParameter("/Library/Twitter/Timelines/HomeTimeline"); + + // set the required choreo inputs + // see https://www.temboo.com/library/Library/Twitter/Timelines/HomeTimeline/ + // for complete details about the inputs for this Choreo + + HomeTimelineChoreo.addParameter("-i"); + HomeTimelineChoreo.addParameter("Count:1"); // the max number of Tweets to return from each request + + // IMPORTANT! You'll need to substitute your own Access Token, Access Token Secret, + // Consumer Secret, and Consumer Key from the Twitter dev console into the method calls + // below. (Make sure not to delete the "AccessToken:" etc prefixes!) + HomeTimelineChoreo.addParameter("-i"); + HomeTimelineChoreo.addParameter("AccessToken:your-twitter-access-token"); + HomeTimelineChoreo.addParameter("-i"); + HomeTimelineChoreo.addParameter("AccessTokenSecret:your-twitter-access-token-secret"); + HomeTimelineChoreo.addParameter("-i"); + HomeTimelineChoreo.addParameter("ConsumerSecret:your-twitter-consumer-secret"); + HomeTimelineChoreo.addParameter("-i"); + HomeTimelineChoreo.addParameter("ConsumerKey:your-twitter-consumer-key"); + + // next, we'll define two output filters that let us specify the + // elements of the response from Twitter that we want to receive. + // see the examples at http://www.temboo.com/arduino + // for more on using output filters + + // we want the text of the tweet + HomeTimelineChoreo.addParameter("-o"); + HomeTimelineChoreo.addParameter("tweet:/[1]/text:Response"); + + // and the name of the author + HomeTimelineChoreo.addParameter("-o"); + HomeTimelineChoreo.addParameter("author:/[1]/user/screen_name:Response"); + + + // tell the Process to run and wait for the results. The + // return code (rc) will tell us whether the Temboo client + // was able to send our request to the Temboo servers + unsigned int rc = HomeTimelineChoreo.run(); + + // a response code of 0 means success; print the API response + if(rc == 0) { + + String author; // a String to hold the tweet author's name + String tweet; // a String to hold the text of the tweet + + + // choreo outputs are returned as key/value pairs, delimited with + // newlines and record/field terminator characters, for example: + // Name1\n\x1F + // Value1\n\x1E + // Name2\n\x1F + // Value2\n\x1E + + // see the examples at http://www.temboo.com/arduino for more details + // we can read this format into separate variables, as follows: + + while(HomeTimelineChoreo.available()) { + // read the name of the output item + String name = HomeTimelineChoreo.readStringUntil('\x1F'); + name.trim(); + + // read the value of the output item + String data = HomeTimelineChoreo.readStringUntil('\x1E'); + data.trim(); + + // assign the value to the appropriate String + if (name == "tweet") { + tweet = data; + } else if (name == "author") { + author = data; + } + } + + Serial.println("@" + author + " - " + tweet); + + } else { + // there was an error + // print the raw output from the choreo + while(HomeTimelineChoreo.available()) { + Serial.print((char)HomeTimelineChoreo.read()); + } + } + + HomeTimelineChoreo.close(); + } + + Serial.println("Sleeping..."); + delay(90000); // sleep 90 seconds between HomeTimeline calls +} + +/* + IMPORTANT NOTE: TembooAccount.h: + + TembooAccount.h is a file referenced by this sketch that contains your Temboo account information. + You need to create this file. To do so, make a new tab in Arduino, call it TembooAccount.h, and + include the following variables and constants: + + #define TEMBOO_ACCOUNT "myTembooAccountName" // your Temboo account name + #define TEMBOO_APP_KEY_NAME "myFirstApp" // your Temboo app key name + #define TEMBOO_APP_KEY "xxx-xxx-xxx-xx-xxx" // your Temboo app key + + The same TembooAccount.h file settings can be used for all Temboo SDK sketches. + + Visit https://www.temboo.com/account to access your Temboo account credentials. + + Keeping your account information in a separate file means you can save it once, + then just distribute the main .ino file without worrying that you forgot to delete your credentials. +*/ diff --git a/libraries/Bridge/examples/Temboo/SendAnEmail/SendAnEmail.ino b/libraries/Bridge/examples/Temboo/SendAnEmail/SendAnEmail.ino new file mode 100644 index 0000000..a8409d9 --- /dev/null +++ b/libraries/Bridge/examples/Temboo/SendAnEmail/SendAnEmail.ino @@ -0,0 +1,142 @@ +/* + SendAnEmail + + Demonstrates sending an email via a Google Gmail account + using the Temboo Arduino Yun SDK. + + A Temboo account and application key are necessary to run all Temboo examples. + If you don't already have one, you can register for a free Temboo account at + http://www.temboo.com + + Since this sketch uses Gmail to send the email, you'll also need a valid + Google Gmail account. The sketch needs the username and password you use + to log into your Gmail account: substitute the placeholders below for these values. + + This example assumes basic familiarity with Arduino sketches, and that your Yun is connected + to the Internet. For more tutorials on using the Temboo Library and Temboo Arduino Yun SDK, visit + http://www.temboo.com/arduino + + This example code is in the public domain. +*/ + +#include +#include +#include +#include +#include +#include "TembooAccount.h" // contains Temboo account information, as described below + + +boolean success = false; // a flag to indicate whether we've sent the email yet or not + +void setup() { + Serial.begin(9600); + + // for debugging, wait until a serial console is connected + delay(4000); + while(!Serial); + + Bridge.begin(); +} + +void loop() +{ + // only try to send the email if we haven't already sent it successfully + if (!success) { + + Serial.println("Running SendEmail ..."); + + // we need a Process object to send a Choreo request to Temboo + Process SendEmailChoreo; + + // invoke the Temboo client + SendEmailChoreo.begin("temboo"); + + // set Temboo account credentials + SendEmailChoreo.addParameter("-a"); + SendEmailChoreo.addParameter(TEMBOO_ACCOUNT); + SendEmailChoreo.addParameter("-u"); + SendEmailChoreo.addParameter(TEMBOO_APP_KEY_NAME); + SendEmailChoreo.addParameter("-p"); + SendEmailChoreo.addParameter(TEMBOO_APP_KEY); + + // identify the Temboo Library choreo to run (Google > Gmail > SendEmail) + SendEmailChoreo.addParameter("-c"); + SendEmailChoreo.addParameter("/Library/Google/Gmail/SendEmail"); + + // set the required choreo inputs + // see https://www.temboo.com/library/Library/Google/Gmail/SendEmail/ + // for complete details about the inputs for this Choreo + + // the first input is a your Gmail user name. + // NOTE: substitute your own value, retaining the "Username:" prefix. + SendEmailChoreo.addParameter("-i"); + SendEmailChoreo.addParameter("Username:your-gmail-username"); + + // next is your Gmail password. + // NOTE: substitute your own value, retaining the "Password:" prefix + SendEmailChoreo.addParameter("-i"); + SendEmailChoreo.addParameter("Password:your-gmail-password"); + + // then a subject line + SendEmailChoreo.addParameter("-i"); + SendEmailChoreo.addParameter("Subject:ALERT: Greenhouse Temperature"); + + // next comes the message body, the main content of the email + SendEmailChoreo.addParameter("-i"); + SendEmailChoreo.addParameter("MessageBody:Hey! The greenhouse is too cold!"); + + // next is the email address of who the email is from. + // NOTE: substitute your Gmail address, retaining the "FromAddress:" prefix. + SendEmailChoreo.addParameter("-i"); + SendEmailChoreo.addParameter("FromAddress:your-gmail-email-address"); + + // who to send the email to + // NOTE: substitute your desired recipient, retaining the "ToAddress:" prefix + SendEmailChoreo.addParameter("-i"); + SendEmailChoreo.addParameter("ToAddress:recipient-email-address"); + + // tell the Process to run and wait for the results. The + // return code (rc) will tell us whether the Temboo client + // was able to send our request to the Temboo servers + unsigned int rc = SendEmailChoreo.run(); + + // a return code of zero (0) means everything worked + if (rc == 0) { + Serial.println("Success! Email sent!"); + success = true; + } else { + // a non-zero return code means there was an error + // read and print the error message + while (SendEmailChoreo.available()) { + Serial.print((char)SendEmailChoreo.read()); + } + } + SendEmailChoreo.close(); + + // do nothing for the next 60 seconds + delay(60000); + } +} + +/* + IMPORTANT NOTE: TembooAccount.h: + + TembooAccount.h is a file referenced by this sketch that contains your Temboo account information. + You need to create this file. To do so, make a new tab in Arduino, call it TembooAccount.h, and + include the following variables and constants: + + #define TEMBOO_ACCOUNT "myTembooAccountName" // your Temboo account name + #define TEMBOO_APP_KEY_NAME "myFirstApp" // your Temboo app key name + #define TEMBOO_APP_KEY "xxx-xxx-xxx-xx-xxx" // your Temboo app key + + The same TembooAccount.h file settings can be used for all Temboo SDK sketches. + + Visit https://www.temboo.com/account to access your Temboo account credentials. + + Keeping your account information in a separate file means you can save it once, + then just distribute the main .ino file without worrying that you forgot to delete your credentials. + + (Be sure to delete this comment after creating your TembooAccount.h file!) +*/ + diff --git a/libraries/Bridge/examples/Temboo/SendDataToGoogleSpreadsheet/SendDataToGoogleSpreadsheet.ino b/libraries/Bridge/examples/Temboo/SendDataToGoogleSpreadsheet/SendDataToGoogleSpreadsheet.ino new file mode 100644 index 0000000..984bd53 --- /dev/null +++ b/libraries/Bridge/examples/Temboo/SendDataToGoogleSpreadsheet/SendDataToGoogleSpreadsheet.ino @@ -0,0 +1,165 @@ +/* + SendDataToGoogleSpreadsheet + + Demonstrates appending a row of data to a Google spreadsheet + from the Arduino Yun using the Temboo Arduino Yun SDK. + + A Temboo account and application key are necessary to run all Temboo examples. + If you don't already have one, you can register for a free Temboo account at + http://www.temboo.com + + This example assumes basic familiarity with Arduino sketches, and that your + Yun is connected to the Internet. For more tutorials on using the Temboo Library + and Temboo Arduino Yun SDK, visit http://www.temboo.com/arduino + + Since this sketch uses a Google spreadsheet, you'll also need a + Google account: substitute the placeholders below for your Google account values. + + The columns in your spreadsheet must have labels for the Choreo to + work properly. It doesn't matter what the column labels actually are, + but there must be text in the first row of each column. This example + assumes there are two columns. The first column is the time (in milliseconds) + that the row was appended, and the second column is a sensor value + (simulated in this example via a random number). + + This example code is in the public domain. + +*/ + +#include +#include +#include +#include +#include +#include "TembooAccount.h" // contains Temboo account information, as described below + + +const unsigned long RUN_INTERVAL_MILLIS = 60000; // how often to run the Choreo (in milliseconds) + +// the last time we ran the Choreo +// (initialized to 60 seconds ago so the +// Choreo is run immediately when we start up) +unsigned long lastRun = (unsigned long)-60000; + +void setup() { + + // for debugging, wait until a serial console is connected + Serial.begin(9600); + delay(4000); + while(!Serial); + + Serial.print("Initializing the bridge..."); + Bridge.begin(); + Serial.println("Done"); +} + +void loop() +{ + // get the number of milliseconds this sketch has been running + unsigned long now = millis(); + + // run again if it's been 60 seconds since we last ran + if (now - lastRun >= RUN_INTERVAL_MILLIS) { + + // remember 'now' as the last time we ran the choreo + lastRun = now; + + Serial.println("Getting sensor value..."); + + // get the value we want to append to our spreadsheet + unsigned long sensorValue = getSensorValue(); + + Serial.println("Appending value to spreadsheet..."); + + // we need a Process object to send a Choreo request to Temboo + Process AppendRowChoreo; + + // invoke the Temboo client + AppendRowChoreo.begin("temboo"); + + // set Temboo account credentials + AppendRowChoreo.addParameter("-a"); + AppendRowChoreo.addParameter(TEMBOO_ACCOUNT); + AppendRowChoreo.addParameter("-u"); + AppendRowChoreo.addParameter(TEMBOO_APP_KEY_NAME); + AppendRowChoreo.addParameter("-p"); + AppendRowChoreo.addParameter(TEMBOO_APP_KEY); + + // identify the Temboo Library choreo to run (Google > Spreadsheets > AppendRow) + AppendRowChoreo.addParameter("-c"); + AppendRowChoreo.addParameter("/Library/Google/Spreadsheets/AppendRow"); + + // set the required Choreo inputs + // see https://www.temboo.com/library/Library/Google/Spreadsheets/AppendRow/ + // for complete details about the inputs for this Choreo + + // your Google username (usually your email address) + // NOTE: substitute your own value, retaining the "Username:" prefix. + AppendRowChoreo.addParameter("-i"); + AppendRowChoreo.addParameter("Username:your-google-username"); + + // your Google account password + // NOTE: substitute your own value, retaining the "Password:" prefix. + AppendRowChoreo.addParameter("-i"); + AppendRowChoreo.addParameter("Password:your-google-password"); + + // the title of the spreadsheet you want to append to + // NOTE: substitute your own value, retaining the "SpreadsheetTitle:" prefix. + AppendRowChoreo.addParameter("-i"); + AppendRowChoreo.addParameter("SpreadsheetTitle:your-spreadsheet-title"); + + // convert the time and sensor values to a comma separated string + String rowData(now); + rowData += ","; + rowData += sensorValue; + + // add the RowData input item + AppendRowChoreo.addParameter("-i"); + AppendRowChoreo.addParameter("RowData:" + rowData); + + // run the Choreo and wait for the results + // The return code (rc) will indicate success or failure + unsigned int rc = AppendRowChoreo.run(); + + // return code of zero (0) means success + if (rc == 0) { + Serial.println("Success! Appended " + rowData); + } else { + // return code of anything other than zero means failure + // read and display any error messages + while (AppendRowChoreo.available()) { + Serial.print((char)AppendRowChoreo.read()); + } + } + + AppendRowChoreo.close(); + } +} + +// this function simulates reading the value of a sensor +// in this example, we're generating a random number +unsigned long getSensorValue() { + return (unsigned long)random(0, 256); +} + +/* + IMPORTANT NOTE: TembooAccount.h: + + TembooAccount.h is a file referenced by this sketch that contains your Temboo account information. + You need to create this file. To do so, make a new tab in Arduino, call it TembooAccount.h, and + include the following variables and constants: + + #define TEMBOO_ACCOUNT "myTembooAccountName" // your Temboo account name + #define TEMBOO_APP_KEY_NAME "myFirstApp" // your Temboo app key name + #define TEMBOO_APP_KEY "xxx-xxx-xxx-xx-xxx" // your Temboo app key + + The same TembooAccount.h file settings can be used for all Temboo SDK sketches. + + Visit https://www.temboo.com/account to access your Temboo account credentials. + + Keeping your account information in a separate file means you can save it once, + then just distribute the main .ino file without worrying that you forgot to delete your credentials. + + (Be sure to delete this comment after creating your TembooAccount.h file!) +*/ + -- cgit v1.2.3-18-g5258