updated temboo examples

Author: Federico Fissore

hardware/arduino/avr/libraries/Bridge/examples/Temboo/GetYahooWeatherReport/GetYahooWeatherReport.ino

@@ -25,13 +25,18 @@
 #include "TembooAccount.h" // contains Temboo account information
                            // as described in the footer comment below
 
+
+// the address for which a weather forecast will be retrieved
+String ADDRESS_FOR_FORECAST = "104 Franklin St., New York NY 10013";
+
 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
+  delay(4000);
   while(!Serial);
   Bridge.begin();
 }
@@ -58,14 +63,14 @@ void loop()
     GetWeatherByAddressChoreo.addParameter("-p");
     GetWeatherByAddressChoreo.addParameter(TEMBOO_APP_KEY);
 
-   	// identify the Temboo Library choreo to run (Yahoo > Weather > GetWeatherByAddress)
+    // 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");
+    GetWeatherByAddressChoreo.addParameter("Address:" + ADDRESS_FOR_FORECAST);
 
     // run the choreo 
     GetWeatherByAddressChoreo.run();
@@ -76,34 +81,35 @@ void loop()
       // 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());
+      char c = GetWeatherByAddressChoreo.read();    
+      Serial.print(c);
     }
     GetWeatherByAddressChoreo.close();
 
   }
 
-  Serial.println("Sleeping...");
+  Serial.println("Waiting...");
   Serial.println("");
-  delay(30000); // sleep 30 seconds between GetWeatherByAddress calls
+  delay(30000); // wait 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:
+  TembooAccount.h is a file referenced by this sketch that contains your Temboo account information.
+  You'll need to edit the placeholder version of TembooAccount.h included with this example sketch,
+  by inserting your own Temboo account name and app key information. The contents of the file should
+  look like:
 
   #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.
-
   You can find your Temboo App Key information on the Temboo website, 
   under My Account > Application Keys
 
+  The same TembooAccount.h file settings can be used for all Temboo SDK sketches.
+
   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.
 */

hardware/arduino/avr/libraries/Bridge/examples/Temboo/GetYahooWeatherReport/TembooAccount.h

@@ -0,0 +1,4 @@
+#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
+

hardware/arduino/avr/libraries/Bridge/examples/Temboo/ReadATweet/ReadATweet.ino

@@ -33,12 +33,14 @@
 
 /*** SUBSTITUTE YOUR VALUES BELOW: ***/
 
+// Note that for additional security and reusability, you could
+// use #define statements to specify these values in a .h file.
 const String TWITTER_ACCESS_TOKEN = "your-twitter-access-token";
 const String TWITTER_ACCESS_TOKEN_SECRET = "your-twitter-access-token-secret";
 const String TWITTER_CONSUMER_KEY = "your-twitter-consumer-key";
 const String TWITTER_CONSUMER_SECRET = "your-twitter-consumer-secret";
 
-int numRuns = 0;   // execution count, so this sketch doesn't run forever
+int numRuns = 1;   // 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() {
@@ -53,7 +55,7 @@ void setup() {
 void loop()
 {
   // while we haven't reached the max number of runs...
-  if (numRuns < maxRuns) {
+  if (numRuns <= maxRuns) {
 
     // print status
     Serial.println("Running ReadATweet - Run #" + String(numRuns++) + "...");
@@ -108,12 +110,12 @@ void loop()
 
 
     // tell the Process to run and wait for the results. The 
-    // return code (rc) will tell us whether the Temboo client 
+    // return code will tell us whether the Temboo client 
     // was able to send our request to the Temboo servers
-    unsigned int rc = HomeTimelineChoreo.run();
+    unsigned int returnCode = HomeTimelineChoreo.run();
 
     // a response code of 0 means success; print the API response
-    if(rc == 0) {
+    if(returnCode == 0) {
 
       String author; // a String to hold the tweet author's name
       String tweet; // a String to hold the text of the tweet
@@ -152,34 +154,36 @@ void loop()
       // there was an error
       // print the raw output from the choreo
       while(HomeTimelineChoreo.available()) {
-        Serial.print((char)HomeTimelineChoreo.read());
+        char c = HomeTimelineChoreo.read();
+        Serial.print(c);
       }
     }
 
     HomeTimelineChoreo.close();
   }
 
-  Serial.println("Sleeping...");
+  Serial.println("Waiting...");
   Serial.println("");
-  delay(90000); // sleep 90 seconds between HomeTimeline calls
+  delay(90000); // wait 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:
+  TembooAccount.h is a file referenced by this sketch that contains your Temboo account information.
+  You'll need to edit the placeholder version of TembooAccount.h included with this example sketch,
+  by inserting your own Temboo account name and app key information. The contents of the file should
+  look like:
 
   #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.
-
   You can find your Temboo App Key information on the Temboo website, 
   under My Account > Application Keys
 
+  The same TembooAccount.h file settings can be used for all Temboo SDK sketches.
+
   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.
 */

hardware/arduino/avr/libraries/Bridge/examples/Temboo/ReadATweet/TembooAccount.h

@@ -0,0 +1,4 @@
+#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
+

hardware/arduino/avr/libraries/Bridge/examples/Temboo/SendATweet/SendATweet.ino

@@ -10,8 +10,10 @@
   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. 
+  the Twitter dev console at https://dev.twitter.com. Note that since this 
+  sketch creates a new tweet, your application will need to be configured with
+  read+write permissions. 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
@@ -33,6 +35,8 @@
 
 /*** SUBSTITUTE YOUR VALUES BELOW: ***/
 
+// Note that for additional security and reusability, you could
+// use #define statements to specify these values in a .h file.
 const String TWITTER_ACCESS_TOKEN = "your-twitter-access-token";
 const String TWITTER_ACCESS_TOKEN_SECRET = "your-twitter-access-token-secret";
 const String TWITTER_CONSUMER_KEY = "your-twitter-consumer-key";
@@ -72,7 +76,7 @@ void loop()
     StatusesUpdateChoreo.addParameter("-p");
     StatusesUpdateChoreo.addParameter(TEMBOO_APP_KEY);
 
-   	// identify the Temboo Library choreo to run (Twitter > Tweets > StatusesUpdate)
+    // identify the Temboo Library choreo to run (Twitter > Tweets > StatusesUpdate)
     StatusesUpdateChoreo.addParameter("-c");
     StatusesUpdateChoreo.addParameter("/Library/Twitter/Tweets/StatusesUpdate");
 
@@ -96,47 +100,48 @@ void loop()
     StatusesUpdateChoreo.addParameter("StatusUpdate:" + tweet);
 
     // tell the Process to run and wait for the results. The 
-    // return code (rc) will tell us whether the Temboo client 
+    // return code (returnCode) will tell us whether the Temboo client 
     // was able to send our request to the Temboo servers
-    unsigned int rc = StatusesUpdateChoreo.run();
+    unsigned int returnCode = StatusesUpdateChoreo.run();
 
     // a return code of zero (0) means everything worked
-    if (rc == 0) {
+    if (returnCode == 0) {
         Serial.println("Success! Tweet sent!");
     } else {
       // a non-zero return code means there was an error
       // read and print the error message
       while (StatusesUpdateChoreo.available()) {
-        Serial.print((char)StatusesUpdateChoreo.read());
+        char c = StatusesUpdateChoreo.read();
+        Serial.print(c);
       }
     } 
     StatusesUpdateChoreo.close();
 
     // do nothing for the next 90 seconds
-    Serial.println("Sleeping...");
+    Serial.println("Waiting...");
     delay(90000);
   }
 }
 
 /*
   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:
+  TembooAccount.h is a file referenced by this sketch that contains your Temboo account information.
+  You'll need to edit the placeholder version of TembooAccount.h included with this example sketch,
+  by inserting your own Temboo account name and app key information. The contents of the file should
+  look like:
 
   #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.
-
   You can find your Temboo App Key information on the Temboo website, 
   under My Account > Application Keys
 
+  The same TembooAccount.h file settings can be used for all Temboo SDK sketches.
+
   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.
 */
 
 
-

hardware/arduino/avr/libraries/Bridge/examples/Temboo/SendATweet/TembooAccount.h

@@ -0,0 +1,4 @@
+#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
+

hardware/arduino/avr/libraries/Bridge/examples/Temboo/SendAnEmail/SendAnEmail.ino

@@ -31,6 +31,9 @@
 
 /*** SUBSTITUTE YOUR VALUES BELOW: ***/
 
+// Note that for additional security and reusability, you could
+// use #define statements to specify these values in a .h file.
+
 // your Gmail address, eg "bob.smith@gmail.com"
 const String GMAIL_USER_NAME = "xxxxxxxxxx";
 
@@ -74,7 +77,7 @@ void loop()
     SendEmailChoreo.addParameter("-p");
     SendEmailChoreo.addParameter(TEMBOO_APP_KEY);
 
-   	// identify the Temboo Library choreo to run (Google > Gmail > SendEmail)
+    // identify the Temboo Library choreo to run (Google > Gmail > SendEmail)
     SendEmailChoreo.addParameter("-c");
     SendEmailChoreo.addParameter("/Library/Google/Gmail/SendEmail");
 
@@ -103,19 +106,20 @@ void loop()
     SendEmailChoreo.addParameter("MessageBody:Hey! The greenhouse is too cold!");
 
     // tell the Process to run and wait for the results. The 
-    // return code (rc) will tell us whether the Temboo client 
+    // return code (returnCode) will tell us whether the Temboo client 
     // was able to send our request to the Temboo servers
-    unsigned int rc = SendEmailChoreo.run();
+    unsigned int returnCode = SendEmailChoreo.run();
 
     // a return code of zero (0) means everything worked
-    if (rc == 0) {
+    if (returnCode == 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());
+        char c = SendEmailChoreo.read();
+        Serial.print(c);
       }
     } 
     SendEmailChoreo.close();
@@ -128,20 +132,20 @@ void loop()
 /*
   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:
+  TembooAccount.h is a file referenced by this sketch that contains your Temboo account information.
+  You'll need to edit the placeholder version of TembooAccount.h included with this example sketch,
+  by inserting your own Temboo account name and app key information. The contents of the file should
+  look like:
 
   #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.
-
   You can find your Temboo App Key information on the Temboo website, 
   under My Account > Application Keys
 
+  The same TembooAccount.h file settings can be used for all Temboo SDK sketches.
+
   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.
 */
-

hardware/arduino/avr/libraries/Bridge/examples/Temboo/SendAnEmail/TembooAccount.h

@@ -0,0 +1,5 @@
+#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
+
+