aboutsummaryrefslogtreecommitdiff
path: root/libraries/Bridge/examples/SendAnEmail/SendAnEmail.ino
diff options
context:
space:
mode:
authorFederico Fissore <f.fissore@arduino.cc>2013-06-26 17:29:57 +0200
committerFederico Fissore <f.fissore@arduino.cc>2013-06-26 17:29:57 +0200
commitb24534d6a6e996321ff1a1bed67f0a1b6568b2c7 (patch)
treebd123e8346c7c8515706e370aa380f611a6ae49d /libraries/Bridge/examples/SendAnEmail/SendAnEmail.ino
parentbf82b241f55a34543e94cea854d819d0a607988c (diff)
included newest Temboo examples
Diffstat (limited to 'libraries/Bridge/examples/SendAnEmail/SendAnEmail.ino')
-rw-r--r--libraries/Bridge/examples/SendAnEmail/SendAnEmail.ino142
1 files changed, 142 insertions, 0 deletions
diff --git a/libraries/Bridge/examples/SendAnEmail/SendAnEmail.ino b/libraries/Bridge/examples/SendAnEmail/SendAnEmail.ino
new file mode 100644
index 0000000..a8409d9
--- /dev/null
+++ b/libraries/Bridge/examples/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 <Bridge.h>
+#include <Console.h>
+#include <FileIO.h>
+#include <HttpClient.h>
+#include <Process.h>
+#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!)
+*/
+