[AE-158] Simple and Advanced sketch revision

[aliphys]

This PR makes some adjustments to the Simple and Advanced sketches.

• 📛 Renamed sketch names, to be more descriptive of what they do
  • Simple.ino -> SimpleStorageWriteRead.ino
  • Advanced.ino -> AdvancedUSBInternalOperations.ino
• 📝 Rewrote sketch description in line with the Arduino Writing Style Guide, as refered to at the bottom of this page.
• SimpleStorageWriteRead.ino now uses the internal storage as default. Rationale is that the SD card is not present in the Opta, and requires additional hardware in the Portenta H7 and C33.
• Added in line comments to make code operation easier to grasp for newcommers (e.g. explanation of printFolderContents() helper function)

Note: I was not able to compile the examples.

[aliphys]

The errors are reduced with the patches made yesterday, but still present:

Compiling for the Portenta C33

• SimpleStorageReadWrite.ino - C33

  
  PS D:\Github\Arduino\Arduino_UnifiedStorage\examples\SimpleStorageWriteRead> arduino-cli compile -b arduino:renesas_portenta:portenta_c33  --library "D:\Github\Arduino\Arduino_POSIXStorage" --library  "D:\Github\Arduino\Arduino_UnifiedStorage"
  >> 
  WARNING: library Arduino_UnifiedStorage claims to run on renesas, mbed_portenta architecture(s) and may be incompatible with your current board which runs on renesas_portenta architecture(s).
  In file included from D:\Github\Arduino\Arduino_UnifiedStorage\src/Arduino_UnifiedStorage.h:43:0,
               from D:\Github\Arduino\Arduino_UnifiedStorage\examples\SimpleStorageWriteRead\SimpleStorageWriteRead.ino:24:
  D:\Github\Arduino\Arduino_UnifiedStorage\src/USBStorage.h:9:13: error: redefinition of 'bool available'
  static bool available = false;
           ^~~~~~~~~
  D:\Github\Arduino\Arduino_UnifiedStorage\src/USBStorage.h:6:13: note: 'bool available' previously defined here
  static bool available = false;
           ^~~~~~~~~

Used library Version Path Arduino_UnifiedStorage 1.0.0 D:\Github\Arduino\Arduino_UnifiedStorage Arduino_POSIXStorage 1.0.0 D:\Github\Arduino\Arduino_POSIXStorage FATFilesystem C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\renesas_portenta\1.0.2\libraries\FATFilesystem Storage C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\renesas_portenta\1.0.2\libraries\Storage LittleFilesystem C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\renesas_portenta\1.0.2\libraries\LittleFilesystem BlockDevices C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\renesas_portenta\1.0.2\libraries\BlockDevices UsbHostMsd C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\renesas_portenta\1.0.2\libraries\UsbHostMsd

Used platform Version Path arduino:renesas_portenta 1.0.2 C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\renesas_portenta\1.0.2 Error during build: exit status 1

- AdvancedUSBInternalOperations.ino

PS D:\Github\Arduino\Arduino_UnifiedStorage\examples\AdvancedUSBInternalOperations> arduino-cli compile -b arduino:renesas_portenta:portenta_c33 --library "D:\Github\Arduino\Arduino_POSIXStorage" --library "D:\Github\Arduino\Arduino_UnifiedStorage"

WARNING: library Arduino_UnifiedStorage claims to run on renesas, mbed_portenta architecture(s) and may be incompatible with your current board which runs on renesas_portenta architecture(s). In file included from D:\Github\Arduino\Arduino_UnifiedStorage\src/Arduino_UnifiedStorage.h:43:0, from D:\Github\Arduino\Arduino_UnifiedStorage\examples\AdvancedUSBInternalOperations\AdvancedUSBInternalOperations.ino:26: D:\Github\Arduino\Arduino_UnifiedStorage\src/USBStorage.h:9:13: error: redefinition of 'bool available' static bool available = false; ^~~~~ D:\Github\Arduino\Arduino_UnifiedStorage\src/USBStorage.h:6:13: note: 'bool available' previously defined here static bool available = false; ^~~~~

Used library Version Path Arduino_UnifiedStorage 1.0.0 D:\Github\Arduino\Arduino_UnifiedStorage Arduino_POSIXStorage 1.0.0 D:\Github\Arduino\Arduino_POSIXStorage FATFilesystem C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\renesas_portenta\1.0.2\libraries\FATFilesystem Storage C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\renesas_portenta\1.0.2\libraries\Storage LittleFilesystem C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\renesas_portenta\1.0.2\libraries\LittleFilesystem BlockDevices C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\renesas_portenta\1.0.2\libraries\BlockDevices UsbHostMsd C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\renesas_portenta\1.0.2\libraries\UsbHostMsd

Used platform Version Path arduino:renesas_portenta 1.0.2 C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\renesas_portenta\1.0.2 Error during build: exit status 1

# Compiling for the Portenta H7
- SimpleStorageReadWrite.ino

PS D:\Github\Arduino\Arduino_UnifiedStorage\examples\SimpleStorageWriteRead> arduino-cli compile -b arduino:mbed_portenta:envie_m7 --library "D:\Github\Arduino\Arduino_POSIXStorage" --library "D:\Github\Arduino\Arduino_UnifiedStorage"

D:\Github\Arduino\Arduino_UnifiedStorage\src\USBStorage.cpp:4:14: fatal error: Arduino_USBHostMbed5.h: No such file or directory

include

^~~~~~~~ compilation terminated.

Used library Version Path Arduino_UnifiedStorage 1.0.0 D:\Github\Arduino\Arduino_UnifiedStorage Arduino_POSIXStorage 1.0.0 D:\Github\Arduino\Arduino_POSIXStorage

Used platform Version Path arduino:mbed_portenta 4.0.4 C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\mbed_portenta\4.0.4 Error during build: exit status 1

- AdvancedUSBInternalOperations.ino

PS D:\Github\Arduino\Arduino_UnifiedStorage\examples\AdvancedUSBInternalOperations> arduino-cli compile -b arduino:mbed_portenta:envie_m7 --library "D:\Github\Arduino\Arduino_POSIXStorage" --library "D:\Github\Arduino\Arduino_UnifiedStorage"

D:\Github\Arduino\Arduino_UnifiedStorage\src\USBStorage.cpp:4:14: fatal error: Arduino_USBHostMbed5.h: No such file or directory

include

^~~~~~~~ compilation terminated.

Used library Version Path Arduino_UnifiedStorage 1.0.0 D:\Github\Arduino\Arduino_UnifiedStorage Arduino_POSIXStorage 1.0.0 D:\Github\Arduino\Arduino_POSIXStorage

Used platform Version Path arduino:mbed_portenta 4.0.4 C:\Users\user\AppData\Local\Arduino15\packages\arduino\hardware\mbed_portenta\4.0.4 Error during build: exit status 1