diff options
Diffstat (limited to 'libraries/Bridge/examples/Temboo/UploadToDropbox/UploadToDropbox.ino')
| -rw-r--r-- | libraries/Bridge/examples/Temboo/UploadToDropbox/UploadToDropbox.ino | 212 |
1 files changed, 212 insertions, 0 deletions
diff --git a/libraries/Bridge/examples/Temboo/UploadToDropbox/UploadToDropbox.ino b/libraries/Bridge/examples/Temboo/UploadToDropbox/UploadToDropbox.ino new file mode 100644 index 0000000..cb56582 --- /dev/null +++ b/libraries/Bridge/examples/Temboo/UploadToDropbox/UploadToDropbox.ino @@ -0,0 +1,212 @@ +/* + UploadToDropbox + + Demonstrates uploading a file to Dropbox using the Temboo Arduino Yun SDK. + + Check out the latest Arduino & Temboo examples and support docs at http://www.temboo.com/arduino + + 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 + + You'll also need a valid Dropbox account, and OAuth credentials for Dropbox. To + obtain OAuth credentials for Dropbox, you'll need to register a Dropbox app at + https://www.dropbox.com/developers/apps and then follow the instructions at + https://www.temboo.com/library/Library/Dropbox/OAuth/ to run the Initialize and Finalize + OAuth Choreos to complete the OAuth handshake and retrieve your Access Token information. + + This example assumes basic familiarity with Arduino sketches, and that your Yun is connected + to the Internet. + + Looking for another API? We've got over 100 in our Library! + + 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 in the footer comment below + + +/*** SUBSTITUTE YOUR VALUES BELOW: ***/ + +// your Dropbox app key, available on the Dropbox developer console after registering an app +const String DROPBOX_APP_KEY = "xxxxxxxxxx"; + +// your Dropbox app secret, available on the Dropbox developer console after registering an app +const String DROPBOX_APP_SECRET = "xxxxxxxxxx"; + +// your Dropbox access token, which is returned by the FinalizeOAuth Choreo +const String DROPBOX_ACCESS_TOKEN = "xxxxxxxxxx"; + +// your Dropbox access token secret, which is returned by the FinalizeOAuth Choreo +const String DROPBOX_ACCESS_TOKEN_SECRET = "xxxxxxxxxx"; + + +boolean success = false; // a flag to indicate whether we've uploaded the file yet + +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 upload the file if we haven't already done so + if (!success) { + + Serial.println("Base64 encoding data to upload..."); + + // base64 encode the data to upload + String base64EncodedData = base64Encode("Hello, Arduino!"); + + + Serial.println("Uploading data to Dropbox..."); + + // we need a Process object to send a Choreo request to Temboo + Process UploadFileChoreo; + + // invoke the Temboo client + UploadFileChoreo.begin("temboo"); + + // set Temboo account credentials + UploadFileChoreo.addParameter("-a"); + UploadFileChoreo.addParameter(TEMBOO_ACCOUNT); + UploadFileChoreo.addParameter("-u"); + UploadFileChoreo.addParameter(TEMBOO_APP_KEY_NAME); + UploadFileChoreo.addParameter("-p"); + UploadFileChoreo.addParameter(TEMBOO_APP_KEY); + + // identify the Temboo Library choreo to run (Dropbox > FilesAndMetadata > UploadFile) + UploadFileChoreo.addParameter("-c"); + UploadFileChoreo.addParameter("/Library/Dropbox/FilesAndMetadata/UploadFile"); + + // set the required choreo inputs + // see https://www.temboo.com/library/Library/Dropbox/FilesAndMetadata/UploadFile/ + // for complete details about the inputs for this Choreo + + // first specify the name of the file to create/update on Dropbox + UploadFileChoreo.addParameter("-i"); + UploadFileChoreo.addParameter("FileName:ArduinoTest.txt"); + + // next, the root folder on Dropbox relative to which the file path is specified. + // unless you're using an in-production Dropbox app, this should be left as "sandbox" + UploadFileChoreo.addParameter("-i"); + UploadFileChoreo.addParameter("Root:sandbox"); + + // next, the Base64 encoded file data to upload + UploadFileChoreo.addParameter("-i"); + UploadFileChoreo.addParameter("FileContents:" + base64EncodedData); + + // finally, the Dropbox OAuth credentials defined above + UploadFileChoreo.addParameter("-i"); + UploadFileChoreo.addParameter("AppSecret:" + DROPBOX_APP_SECRET); + UploadFileChoreo.addParameter("-i"); + UploadFileChoreo.addParameter("AccessToken:" + DROPBOX_ACCESS_TOKEN); + UploadFileChoreo.addParameter("-i"); + UploadFileChoreo.addParameter("AccessTokenSecret:" + DROPBOX_ACCESS_TOKEN_SECRET); + UploadFileChoreo.addParameter("-i"); + UploadFileChoreo.addParameter("AppKey:" + DROPBOX_APP_KEY); + + // 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 = UploadFileChoreo.run(); + + // a return code of zero (0) means everything worked + if (rc == 0) { + Serial.println("Success! File uploaded!"); + success = true; + } else { + // a non-zero return code means there was an error + Serial.println("Uh-oh! Something went wrong!"); + } + + // print out the full response to the serial monitor in all + // cases, just for debugging + while (UploadFileChoreo.available()) { + Serial.print((char)UploadFileChoreo.read()); + } + UploadFileChoreo.close(); + + Serial.println("Sleeping..."); + } + + delay(30000); // sleep 30 seconds between upload attempts +} + + +/* + A utility function to Base64 encode the specified string + by calling a Temboo Utilities Choreo. +*/ +String base64Encode(String toEncode) { + + // we need a Process object to send a Choreo request to Temboo + Process Base64EncodeChoreo; + + // invoke the Temboo client + Base64EncodeChoreo.begin("temboo"); + + // set Temboo account credentials + Base64EncodeChoreo.addParameter("-a"); + Base64EncodeChoreo.addParameter(TEMBOO_ACCOUNT); + Base64EncodeChoreo.addParameter("-u"); + Base64EncodeChoreo.addParameter(TEMBOO_APP_KEY_NAME); + Base64EncodeChoreo.addParameter("-p"); + Base64EncodeChoreo.addParameter(TEMBOO_APP_KEY); + + // identify the Temboo Library choreo to run (Utilities > Encoding > Base64Encode) + Base64EncodeChoreo.addParameter("-c"); + Base64EncodeChoreo.addParameter("/Library/Utilities/Encoding/Base64Encode"); + + // set choreo inputs + Base64EncodeChoreo.addParameter("-i"); + Base64EncodeChoreo.addParameter("Text:" + toEncode); + + // run the choreo + Base64EncodeChoreo.run(); + + // read in the choreo results, and return the "Base64EncodedText" output value. + // see http://www.temboo.com/arduino for more details on using choreo outputs. + while(Base64EncodeChoreo.available()) { + // read the name of the output item + String name = Base64EncodeChoreo.readStringUntil('\x1F'); + name.trim(); + + // read the value of the output item + String data = Base64EncodeChoreo.readStringUntil('\x1E'); + data.trim(); + + if(name == "Base64EncodedText") { + return data; + } + } +} + +/* + IMPORTANT NOTE About TembooAccount.h: + + TembooAccount.h is not included with this example because it contains your account information. + You need to create it for your own version of this application. To do so, make + a new tab in Arduino, call it TembooAccount.h, and include the following variables and constants: + + #define TEMBOO_ACCOUNT "matthew-yun" // your Temboo account name + #define TEMBOO_APP_KEY_NAME "someKey" // your Temboo app key name + #define TEMBOO_APP_KEY "fveIrkjAVIkuNUUPE6df" // 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 + + 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. +*/ |