[Example-Cpp] Add MIT licence and some code cleanup

Author: Yaya-Cout

apps/Example-Cpp/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Damien Nicolet and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

apps/Example-Cpp/Makefile

@@ -1,14 +1,15 @@
 API=../../api
 CC=arm-none-eabi-gcc
 OBJCOPY=arm-none-eabi-objcopy
-AR=arm-none-eabi-ar
 CFLAGS=-DNDEBUG -ggdb3 -I$(API) -Os -mcpu=cortex-m7 -mthumb -mfpu=fpv5-sp-d16 -mfloat-abi=hard -fno-common -fdata-sections -ffunction-sections -fno-exceptions
 LDFLAGS=-Wl,-L$(API) -Wl,--gc-sections -Wl,--entry=entrypoint --specs=nosys.specs -nostartfiles -Wl,-Ur -lapi
 
+OBJS = main.o peripherals.o selector.o
+
 %.o: %.cpp
 	$(CC) $(CFLAGS) -c $<
 
-app.elf: main.o peripherals.o selector.o
+app.elf: $(OBJS)
 	$(CC) $^ -o $@ $(CFLAGS) $(LDFLAGS)
 
 clean:

apps/Example-Cpp/app.elf

@@ -14,18 +14,15 @@ void extapp_main(void) {
     Peripherals::waitForKeyReleased();
     // Draw a white background
     Peripherals::init_display();
-    // Draw hello world message
+
     extapp_drawTextLarge("Hello World !", 0, 20 * 1, 0x0000, 0xFFFF, false);
     extapp_drawTextLarge("Press any key to continue", 0, 20 * 2, 0x0000, 0xFFFF, false);
 
-    // Just wait for a key to be pressed (defined in peripherals.c)
     Peripherals::waitForKeyPressed();
     Peripherals::waitForKeyReleased();
 
     // Select a file (The code is in selector.c)
-    // The code is a bit more complicated, but you can see how to use the file system API to read a file
     const char * filename = Selector::select_file("", 10);
-    // Wait for the key to be released
     Peripherals::waitForKeyReleased();
 
     // Clear the screen
@@ -81,17 +78,16 @@ void extapp_main(void) {
 
     // Initialize the filename to write to the ram filesystem
     const char * filename_to_write = "hello_world.py";
-    // Initialize the file content to write to the ram filesystem, add three spaces at the beginning
+    // Initialize the file content to write to the ram filesystem, add 1 spaces at the beginning
     // because the Python app use the first character to store the auto importation status
     const char * filecontent_to_write = " hello world";
 
     // Write the file into the ram filesystem
     extapp_fileWrite(filename_to_write, filecontent_to_write, strlen(filecontent_to_write) + 1, EXTAPP_RAM_FILE_SYSTEM);
     extapp_drawTextLarge("File written to ram filesystem", 0, 20 * 2, 0x0000, 0xFFFF, false);
     extapp_drawTextLarge("Press any key to exit", 0, 20 * 3, 0x0000, 0xFFFF, false);
+
     // Wait for a key to be pressed before exiting the application
     Peripherals::waitForKeyPressed();
     Peripherals::waitForKeyReleased();
-
-    return;
 }

apps/Example-Cpp/app.icon

@@ -14,22 +14,21 @@ namespace Selector {
  * @param nb int, the number of files in the list
  * @param selected_file int, the selected file to highlight
  */
-static void drawfileList(char ** filenames, int nb, int selected_file) {
-  // Initialize the name buffer
+static void drawfileList(char **filenames, int nb, int selected_file) {
   char name_buffer[FILENAME_LENGTH_MAX];
-  // Iterate through the file list
+  // Iterate through the file list and display them
   for (int i = 0; i < nb; i++) {
-    // Copy the filename into the buffer
     strncpy(name_buffer, filenames[i], FILENAME_LENGTH_MAX);
-    // Force the string to terminate with \0 because the filename can be longer than the length of the buffer
+    // Truncate the list if needed
     name_buffer[26] = '\0';
-    // Draw the filename, highlighted if selected
     extapp_drawTextLarge(name_buffer, 0, (i + 1) * 20, selected_file == i ? SELECTOR_COLOR_FG_SELECT : SELECTOR_COLOR_FG, SELECTOR_COLOR_BG, false);
-    // TODO: I don't understand it
+
+    // Shouldn't be necessary
     strncpy(name_buffer, filenames[i], FILENAME_LENGTH_MAX);
   }
 }
 
+// Remove element from the list
 static char ** remove(char ** first, char ** last) {
   char ** result = first;
   while (first != last) {
@@ -49,90 +48,65 @@ static char ** remove(char ** first, char ** last) {
  * @return const char *, the name of the selected file, or NULL if no file is selected
  */
 const char * select_file(const char * extension_to_match, int max_files) {
-  // The file list
   char * filenames[max_files];
-  // The selected file index in the order of the file list
   int selected_file = 0;
 
-  // Wait for the last key to be released
   Peripherals::waitForKeyReleased();
 
-  // Clear the display
   extapp_pushRectUniform(0, 0, LCD_WIDTH, LCD_HEIGHT, SELECTOR_COLOR_BG);
-  // Draw title bar
   extapp_drawTextLarge("          Select a file         ", 0, 0, SELECTOR_COLOR_HEAD_FG, SELECTOR_COLOR_HEAD_BG, false);
 
   // Get the list of files from the flash memory
   int nb = extapp_fileListWithExtension((const char **)filenames, max_files, "", EXTAPP_FLASH_FILE_SYSTEM);
 
-  // The extension of the file
   char * extension;
 
   // If the extension to match isn't empty, filter the file list
-  // Checking without strcomp, because it's also a string littery when it is empty
   if (extension_to_match[0] != '\0') {
-    // Iterate through the file list
     for (int i = 0; i < nb; i++) {
-      // Get the file extension by splitting his name by a dot
       extension = strrchr(filenames[i], '.');
 
-      // Get if the file's extension doesn't match the requested extension
       if (strcmp(extension, extension_to_match) != 0) {
         // If the extension doesn't match, delete the file from the list
         filenames[i] = NULL;
       }
     }
-    // Update the number of files
     nb = remove(filenames, filenames + nb) - filenames;
   }
 
   // If no files match, draw a no file found message
   if (nb == 0) {
-    // Draw the text
     extapp_drawTextLarge("          No file found          ", 0, 120, SELECTOR_COLOR_FG, SELECTOR_COLOR_BG, false);
-    // Sleep for 10 milliseconds
     extapp_msleep(10);
-    // Wait for a key to be pressed
     Peripherals::waitForKeyPressed();
-    // Return nothing
     return NULL;
   } else {
     // Draw the file list
     drawfileList(filenames, nb, selected_file);
-    // Infinite loop
     for (;;) {
-      // Sleep for 10 milliseconds
       extapp_msleep(10);
+
       // Scan the keyboard
       uint64_t scancode = extapp_scanKeyboard();
       // If the down arrow is pressed, select the next file
       if (scancode & SCANCODE_Down) {
-        // Select the next file, and go to the first file if the file is out of range
         selected_file = (selected_file + 1) % nb;
-        // Redraw the file list
         drawfileList(filenames, nb, selected_file);
-        // Wait for the key to be released, or 200 milliseconds if the key sill pressed
         Peripherals::waitForKeyReleasedTimeout(200);
       } else if (scancode & SCANCODE_Up) {
-        // Select the previous file
         selected_file = (selected_file - 1) % nb;
-        // If the file is out of range, select the last file
         if (selected_file < 0) {
           selected_file = nb + selected_file;
         }
-        // Redraw the file list
         drawfileList(filenames, nb, selected_file);
-        // Wait for the key to be released, or 200 milliseconds if the key sill pressed
         Peripherals::waitForKeyReleasedTimeout(200);
       } else if (scancode & (SCANCODE_OK | SCANCODE_EXE)) {
         // If OK or EXE is pressed, exit the loop
         break;
-      } else if (scancode & SCANCODE_Back) {
-        // If back key is pressed, exit the menu and return nothing
+      } else if (scancode & (SCANCODE_Back | SCANCODE_Home | SCANCODE_OnOff)) {
         return NULL;
       }
     }
-    // Redraw the selected file
     return filenames[selected_file];
   }
 }