Back Up SD File to Dropbox

Arduino Yun

Dropbox

Arduino Web Editor

SD Card

Temboo

<h3 >Overview</h3>Everyone wants to ensure that their precious notes and files are safe and accessible anywhere, well this device makes all of that easy. The Arduino Yun will back up your SD card files on Dropbox, and the best part is that all you have to do is insert the SD card and watch. There is no circuit involved, so it only takes minutes to get the project up and running.<div id="gallery"><img id="gallery" src=https://projects.arduinocontent.cc/6b8380c0-b56a-4f21-8191-e2cd5f0a92e7.JPG /><figcaption>No Circuit</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/44fe6e35-3afe-4f22-90c5-f21d7eeefa60.png /><figcaption>instant backup</figcaption></div><h3 >Functionality</h3>This project requires a Dropbox account to work, you can create one for free. Temboo is used to communicate with Dropbox, The Arduino Yun will read the data on an SD card file and will then send the data to Dropbox, simple. The Yun will only execute this protocol once, it will do so again after reset. Here is an image illustrating the data parsing protocol.<figure><img src=https://projects.arduinocontent.cc/26526fd2-6fa3-4536-91ef-503504124ec7.png /><figcaption>Communication Overview</figcaption></figure>Here is an image capturing the project's code overview.<figure><img src=https://projects.arduinocontent.cc/6af9e842-9119-4c67-8a71-0373f11cf8a9.png /><figcaption>Code Overview</figcaption></figure><ul ><li ><code >Read</code> <code >File</code> will read the contents of the file selected</li></ul><ul ><li ><code >Format</code> <code >Buffer</code> will store the value to a String and prepare it for parsing.</li></ul><ul ><li ><code >Connect</code> <code >Temboo</code> will connect the Yun to Temboo Services</li></ul><ul ><li ><code >Upload</code> <code >File</code> will upload the contents of the file to Temboo, the data will then be assigned to a file in Dropbox.</li></ul>This simple protocol basically backs up a text file on an SD card to Dropbox. There is not that much to explain about it because it's as simple as that. Note that the Yun can be disconnected from power and the SD card can be removed only when the device executes the code to prevent damaging the SD Card. Note that the Serial Monitor must be open to operate the device. A Temboo account is required to operate this project, see below for a guide.<h3 >Benefits</h3>The user operating this project will benefit in:<ul ><li >Storing files on Dropbox easily</li></ul><ul ><li >Backing up text files to dropbox from an SD Card in seconds.</li></ul><h3 >Constructing the Project</h3>Step 1: Required Apparatus<ul ><li >1, <a href="https://store.arduino.cc/arduino-yun">Arduino Yun</a></li></ul><ul ><li >1, <a href="https://www.amazon.co.uk/SanDisk-microSDHC-Memory-Adapter-Performance/dp/B073K14CVB/ref=sr_1_6?s=electronics&ie=UTF8&qid=1522150287&sr=1-6&keywords=micro+sd+class+10">Micro SD Card and SD Card adapter</a> (max 32 GB)</li></ul><figure><img src=https://projects.arduinocontent.cc/2866bb8c-d64d-45a4-a6ce-2dbf8e5dc95f.JPG /><figcaption>All the Components</figcaption></figure>Step 2: Preparing the SD CardThe Arduino Yun requires an SD card formatted with MS_DOS 16 or 32 bit. You will also need one or more files on the SD card for the Arduino to read. Here is a guide to getting all of that done. This tutorial is designed for an Apple Comput<div id="gallery"><img id="gallery" src=https://projects.arduinocontent.cc/3167f1f4-b66a-4b1a-a9c6-9b6ff68c7654.JPG /><figcaption>The first step is to inset the Micro SD card in the adapter and insert it into a Mac/PC</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/edcabcf8-9d73-4e1e-81ed-427f7c45450f.png /><figcaption>Open Disk Utility on the Mac</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/3b0fb9b6-c63c-4afc-ba8e-e7509cc08675.png /><figcaption>Select the inserted SD Card from the menu on the left</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/38e747d5-0516-432c-bbf1-7dd64ba6a41d.png /><figcaption>Click on Erase at the top of the window</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/ab258677-f77d-4f14-a9c2-a9b140688c4b.png /><figcaption>Give the SD Card a name and select MS-DOS as the format, click Erase</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/34d9b5ba-bf2c-4b81-9d5f-fda351a4c6a1.png /><figcaption>Wait for the SD Card to Eject and then click Done</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/fb0cc197-6021-4861-981d-6cc24c33fbc7.png /><figcaption>Create a plain/text file and write some stuff to it</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/62158b24-3d72-4f88-a264-f776e3defce9.png /><figcaption>Save the File to the SD Card as datalog.txt. You can eject the SD Card</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/5f0117c7-6f32-4f29-958d-7266e0c53595.JPG /><figcaption>take the Micro SD card out of the adapter</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/4d2abbb7-4421-4ba1-b5f7-ee68c6e16361.JPG /><figcaption>The last step is to insert it into the Arduino Yun</figcaption></div>Step 3: Setting Up DropboxThese images will guide you through the process of setting up Dropbox, note that you need a Dropbox Account.<div id="gallery"><img id="gallery" src=https://projects.arduinocontent.cc/7813ce17-af6b-47b2-8a33-5d885f68eb5d.png /><figcaption>Open Dropbox Developer by searching for it on Google</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/7ce41230-3888-42a9-8048-2e4704682ab5.png /><figcaption>Select my apps from the menu on the left</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/7b5af341-733e-40cf-ae8f-ee04eb580629.png /><figcaption>Click on Create app on the opening window</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/76a0ddc4-78b9-408a-9edc-fb79a206bf18.png /><figcaption>Select Dropbox API from the dropdown</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/c953f306-2af0-4eaa-bf61-a43b82d22d11.png /><figcaption>Select the Full Dropbox option from the fallowing dropdown menu</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/1a839090-ad0e-4742-bdec-4991490915d9.png /><figcaption>Next, give your app a name</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/1f88fd84-fad6-44a7-ab53-6cd7b5f77cad.png /><figcaption>You will be redirected to a new window containing your app's credentials. Copy the App Key and App Secret, you will need them later</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/efa5fe11-24af-408d-b685-910047958f9e.png /><figcaption>in the Redirect URLs section, enter https://TEMBOO_USERNAME.temboolive.com/callback/dropbox, where TEMBOO_USERNAME is your Temboo Username</figcaption></div>Step 4: Setting Up TembooA Temboo account is also required to operate this project, you can create one for free. Fallow the images below to set up Temboo.<div id="gallery"><img id="gallery" src=https://projects.arduinocontent.cc/db51465f-5272-40b1-bfab-3615efd3e957.png /><figcaption>Open temboo.com</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/b1e4133b-f743-437a-b69e-ef33ed2e2154.png /><figcaption>Sign into your account</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/4020b7cc-d2fb-4954-b812-77d60018ff94.png /><figcaption>Select the InitialiseOAuth choreo from the menu on the left; Dropbox -> OAuth -> InitialiseOAuth</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/9a089ea1-6d07-4fe3-9d92-6222908ccd87.png /><figcaption>Enter the AppKey retrieved from Dropbox, and click on Run Now below</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/2e5e6d77-a018-40e8-a312-de3cf966777e.png /><figcaption>Save the callback ID</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/061cc9ec-301d-49d7-98a0-9232b740686e.png /><figcaption> Open the URL above to complete the setup, in the new window, you will be requested to give the app access to your Dropbox, click Yes/Agree</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/58d7f3dc-0da5-4e45-b082-b369830e3799.png /><figcaption>Next select the FinaliseOAuth Choreo and insert the AppKey, AppSecret and CallbackID in the boxes</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/4a5b9fb1-33cf-4f0d-9721-8cdc62e0401b.png /><figcaption>Click on Run now and save the AccessToken and AccountID received, they are required for the device</figcaption></div>Step 5: Acknowledging the CodeThis simple code is composed of four main sections:<ul ><li >Read File</li></ul><ul ><li >Format Buffer</li></ul><ul ><li >Connect Temboo</li></ul><ul ><li >Upload File</li></ul>Each of these sections will be further explained below.<ul ><li >Read File</li></ul><pre ><code >File dataFile = FileSystem.open(&#34;/mnt/sd/datalog.txt&#34;, FILE_READ); // open the file as read (must be present) if(dataFile) // if file is present { Serial.println(&#34; Success - File Open&#34;); Serial.println(&#34;Reading File Content&#34;); while(dataFile.available()) { data = dataFile.read(); // read incomming bytes dataString = dataString + data; // store them to string } } </code></pre>This section of code opes the file and reads its contents if the file is available. The contents are then stored to a String Variable.<ul ><li >Format Buffer</li></ul><pre ><code >char valueToSend[120]; dataString.toCharArray(valueToSend, 120); // convert string to char </code></pre>these are two simple lines of code which covert the resulting data stored in a String Variable to a char array, Temboo requires a char array to be able to send non-encrypted data.<ul ><li >Connect Temboo</li></ul><pre ><code >TembooChoreo UploadChoreo; // initialise the choreo UploadChoreo.begin(); // begin the choreo UploadChoreo.setAccountName(TEMBOO_ACCOUNT); UploadChoreo.setAppKeyName(TEMBOO_APP_KEY_NAME); UploadChoreo.setAppKey(TEMBOO_APP_KEY); UploadChoreo.addInput(&#34;Path&#34;, &#34;/YunSD.txt&#34;); // the path to the file UploadChoreo.addInput(&#34;FileContent&#34;, valueToSend); UploadChoreo.addInput(&#34;ContentType&#34;, &#34;text/plain&#34;); // text/plain does not require encription UploadChoreo.addInput(&#34;AccessToken&#34;, DROPBOX_ACCESS_TOKEN); // edit in header file UploadChoreo.addInput(&#34;Mode&#34;, &#34;overwrite&#34;); // if file exists; overwrite UploadChoreo.setChoreo(&#34;/Library/Dropbox/Files/Upload&#34;); // identify the choreo to run </code></pre>This block of code tells the choreo to begin, initialises the choreo and configures the inputs.<ul ><li >Upload File</li></ul><pre ><code >UploadChoreo.run(); // run the choreo </code></pre>A single line of code that tells the choreo to run and the file gets uploaded. The code is very simple in the project.Setting Up the VariablesIn this project there is a header file named &#34;TembooAccount.h&#34; which has to be configured to the user's preference. the Temboo Account credentials are received when the user creates his/her Temboo Account and creates their first app. If you wish to retrieve this data, go to Temboo and open an example. Your credentials are stored in the header file provided with the code.Libraries<ul ><li >Bridge - copyright (c) Arduino LLC under the GNU Lesser General Public Licence, this library is in the public domain.</li></ul><ul ><li >File IO - Copyright (c) 2013 Arduino LLC under the GNU Lesser General Public Licence, this library is in the public domain.</li></ul><ul ><li >Temboo - Copyright (c) 2017 Temboo Inc. under the Apache 2.0 Licence. <a href="http://www.apache.org/licenses/LICENSE-2.0">View this licence</a></li></ul>FinalThe last step is to connect your Arduino Yun to a computer and upload the code below, ensure that the SD Card is inserted before continuing. Everything is automatic, in about 30 seconds, the Bridge will load and the file will be uploaded to Dropbox. You can change the name of the file to upload manually. You are all set.<h3 >Background</h3>I created this project because I thought it would be nice to back up a file to Dropbox by just simply inserting an SD card into an Arduino Yun. I decided to create another project using the Yun's built in SD Card module, after <a href="https://create.arduino.cc/projecthub/LightPro/blynk-terminal-to-sd-card-880dba?ref=user&ref_id=215268&offset=0">Blynk Terminal to SD Card</a> because it is fun and easy to use the module.<div id="gallery"><img id="gallery" src=https://projects.arduinocontent.cc/8a2d5a66-116a-4f08-b8fd-2a19de13a691.JPG /><figcaption>Back up SD file to Dropbox</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/4cf525ed-c3a4-4173-919d-a39d88a1a193.png /><figcaption>Serial Comm</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/87e534a3-473d-48d1-8cf4-b56edf3cd68e.png /><figcaption>the file data</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/3c04bf08-a34a-4b27-a8fa-a7b36172d064.png /><figcaption>Uploaded to Dropbox</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/92a26bb2-60a7-4e2b-b090-56ffe0cd2c21.png /><figcaption>In seconds</figcaption></div>

Back Up SD File to Dropbox

Back up a file stored on an SD card to Dropbox automatically.