fixed examples

Author: cristidragomir97

examples/AdvancedInternalStorage/AdvancedInternalStorage.ino

@@ -1,44 +1,46 @@
    /*
-   BackupInternalPartitions
-
-   This code demonstrates how the "Arduino_UnifiedStorage" can be used to access multiple partitions on the internal storage,
-   and transfer information to a USB Mass storage device.
-
-   In the setup function, the code initializes serial communication, mounts both USB & internal storage.
-   It then creates a root directory in the internal storage and creates a subdirectory with files inside it.
-
-   The "addSomeFakeFiles" function generates random files in the specified folder, simulating real data.
-
-   Afterward, it copies files from internal storage to USB storage and moves folders from each partition internal storage to USB storage.
-
-   The "move" function is responsible for transferring folders and files between storage locations.
-
-   The "backupPartitionsC33" and "backupPartitionsH7" functions backup partitions based on the board type, as each have a different default scheme. 
-
-   Created: 31th August 2023
-   By: Cristian Dragomir
-
-   Source: https://github.com/arduino-libraries/Arduino_UnifiedStorage/blob/main/examples/BackupInternalPartitions/BackupInternalPartitions.ino
+    BackupInternalPartitions
+
+    This code demonstrates how the "Arduino_UnifiedStorage" can be used to access multiple partitions on the internal storage,
+    and transfer information to a USB Mass storage device.
+
+    In the setup function, the code initializes serial communication, and registers a callback for the insertion of the USB Drive. 
+    
+    If the device is succesfully mounted, a folder for this instance of a backup will be created on the USB Drive.
+
+    Afterwards the sketch does the following:
+        - lists all partitions available on the InternalStorage
+        - mounts each partition
+        - creates a sub folder for each partition,
+        - copies everything on that partition to the coresponding subfolder.
+    
+    The "addSomeFakeFiles" function generates random files in the specified folder, simulating real data.
+    The "move" function is responsible for transferring folders and files between storage locations.
+
+    INSTRUCTIONS
+    - Make sure you have "POSIXStorage" and "Arduino_UnifiedStorage" installed
+    - Insert a USB Drive whenever you want 
+    - Wait for the sketch to finish, it will display the following "DONE, you can restart the board now" when succesful
+    - Unplug the USB device and inspect its contents. 
+
+    Created: 31th August 2023
+    By: Cristian Dragomir
+
+    Source: https://github.com/arduino-libraries/Arduino_UnifiedStorage/blob/main/examples/BackupInternalPartitions/BackupInternalPartitions.ino
 */
 
 #include <Arduino_UnifiedStorage.h>
 
 
-#if defined(ARDUINO_PORTENTA_C33)
-InternalStorage ota = InternalStorage(1, "ota", FS_FAT);
-InternalStorage data = InternalStorage(2, "data", FS_FAT);
-
-#elif defined(ARDUINO_PORTENTA_H7_M7)
-InternalStorage wifi = InternalStorage(1, "wifi", FS_FAT);
-InternalStorage ota = InternalStorage(2, "ota", FS_FAT);
-InternalStorage data = InternalStorage(3, "data", FS_FAT);
-#endif
+constexpr boolean createFakeFiles = true;
+boolean done = false;
+volatile boolean connected = false;
 
 USBStorage thumbDrive = USBStorage();
 
 
 void addSomeFakeFiles(Folder * folder){
-    Serial.println("* adding some fake files to: " + String(folder -> getPathAsString()));
+    Serial.println("Adding some fake files to: " + String(folder -> getPathAsString()));
 
     for (int i = 0; i < random(0, 9); i++){
         UFile thisFile = folder -> createFile("File_"+ String(random(999)), FileMode::WRITE);
@@ -59,61 +61,80 @@ void addSomeFakeFiles(Folder * folder){
 
 void move(Folder * source, Folder * dest){
     for(Folder f: source -> getFolders()){
-        Serial.println("* copying folder :" + String(f.getPathAsString()));
+        Serial.println("Copying folder :" + String(f.getPathAsString()));
         f.moveTo(*dest);
     }
 
     for(UFile f: source -> getFiles()){
-        Serial.println("* copying file :" + String(f.getPathAsString()));
+        Serial.println("Copying file :" + String(f.getPathAsString()));
         f.moveTo(*dest);
     }
 }
 
 
+void onConnected(){
+    connected = true;
+}
+
+void onDisconnected(){
+    connected = false;
+}
 
 
 
-void backupPartitions(){
-        Folder otaRoot = ota.getRootFolder();
-        addSomeFakeFiles(&otaRoot);
-        Folder otaFolder = backupFolder -> createSubfolder("ota");
-        move(&otaRoot, &otaFolder);
-        ota.unmount();
-    } else {
-        Serial.println("OTA partition not mounted, cannot proceed");
-    }
-}
 
 void setup(){
     randomSeed(analogRead(A0));
 
-
     Serial.begin(115200);
     while(!Serial);
 
-    int thumbMounted = thumbDrive.begin(FS_FAT);
-    Serial.println("* usb drive mounted:" + String(thumbMounted));
+    thumbDrive.onConnect(onConnected);
 
+    Serial.println("Waiting for a USB thumb drive to be plugged in...");
 
-    Folder thumbRoot = thumbDrive.getRootFolder();
-    String folderName = "InternalBackup_" + String(millis());
-    Folder backupFolder = thumbRoot.createSubfolder(folderName);
+}
 
-    int partitionIndex = 0;
-    for (auto part: InternalStorage::readPartitions()){
-        partitionBackupFolderName = "Part" + String(partitionIndex);
-        backupFolder.createFolder(partitionBackupFolderName);
-        
-        
-    }
 
-    thumbDrive.unmount();
+void loop(){
+    if(connected && !done){
+        Serial.println("USB Thumb Drive has been inserted");
+        bool thumbMounted = thumbDrive.begin(FS_FAT);
+        if(thumbMounted){
+            Serial.println("USB Thumb Drive has been mounted");
 
-    Serial.println("DONE, you can restart the board now");
+            Folder thumbRoot = thumbDrive.getRootFolder();
+            String folderName = "InternalBackup_" + String(millis());
+            Folder backupFolder = thumbRoot.createSubfolder(folderName);
 
-}
+            int partitionIndex = 0;
 
+            std::vector<Partition> partitions = InternalStorage::readPartitions();
+            Serial.println("Found " + String(partitions.size()) + " partitions on internalStorage \n");
 
-void loop(){
+            for (auto part: partitions){
+                partitionIndex++;
+                const char * partitionName = createPartitionName(partitionIndex);
+                Folder thisPartitionBackupFolder = backupFolder.createSubfolder(partitionName);
 
+                InternalStorage thisPartition = InternalStorage(partitionIndex, partitionName, part.fileSystemType);
+                thisPartition.begin();
+
+                Folder partitionRootFolder = thisPartition.getRootFolder();
+                Serial.println(partitionRootFolder.getPathAsString());
+
+                if(createFakeFiles){
+                    addSomeFakeFiles(&partitionRootFolder);
+                }
+
+                move(&partitionRootFolder, &thisPartitionBackupFolder);
+                thisPartition.unmount();
+            }
+
+            thumbDrive.unmount();
+            done = true;
+
+            Serial.println("DONE, you can restart the board now");
+        }
+    }
 }

examples/BackupInternalPartitions/BackupInternalPartitions.ino

@@ -0,0 +1,46 @@
+
+/*
+  Callbacks 
+
+  This code demonstrates the usage of the "Arduino_UnifiedStorage" library to handle USB Mass Storage device connection and disconnection callbacks for different supported Arduino boards.
+  The code defines callback functions for USB device connection and uses LED indicators to signal when a USB device is connected (LED turned on) or disconnected (LED turned off).
+
+  INSTRUCTIONS:
+  - Make sure you have "POSIXStorage" and "Arduino_UnifiedStorage" installed
+  - Connect an Arduino board to a computer via USB and run this code.
+  - The code will turn on the designated LED when a USB Mass Storage device is connected and turn it off when the device is disconnected.
+  - This code can be adapted to perform actions or operations when a USB device is connected or disconnected.
+  - You can also customize the LED indicators for different boards according to your hardware configuration.
+*/
+
+
+
+#include "Arduino_UnifiedStorage.h"
+
+#if defined(ARDUINO_PORTENTA_H7_M7)
+#define CALLBACK_LED LED_BLUE
+#elif defined(ARDUINO_PORTENTA_C33)
+#define CALLBACK_LED LEDB
+#elif defined(ARDUINO_OPTA)
+#define CALLBACK_LED LED_D0
+#endif
+
+USBStorage usbStorage = USBStorage();
+
+void connectionCallback(){
+    digitalWrite(CALLBACK_LED, HIGH);
+}
+
+void disconnectionCallback(){
+    digitalWrite(CALLBACK_LED, LOW);
+}
+
+void setup(){
+    pinMode(CALLBACK_LED, OUTPUT);
+    usbStorage.onConnect(connectionCallback);
+    usbStorage.onDisconnect(disconnectionCallback);
+}
+
+void loop(){
+
+}