[FL-935] Queue-based SD app cycle. File select widget. (#388)

* SD App: more specific sd api
* Gui: view dispatcher fix api documentation
* Gui: view holder thingy
* SD App: do not sleep when working with sd card bus
* SD App: queue-based lifecycle
* Assets: sd-card assets
* SD App: init file select api

Co-authored-by: あく <alleteam@gmail.com>

applications/gui/modules/file_select.c

@@ -8,13 +8,16 @@ struct FileSelect {
     // public
     View* view;
     FS_Api* fs_api;
-    char* path;
-    char* extension;
+    const char* path;
+    const char* extension;
 
     bool init_completed;
 
     FileSelectCallback callback;
     void* context;
+
+    char* buffer;
+    uint8_t buffer_size;
 };
 
 typedef struct {
@@ -28,7 +31,7 @@ typedef struct {
 
 bool file_select_fill_strings(FileSelect* file_select);
 bool file_select_fill_count(FileSelect* file_select);
-static bool file_select_init(FileSelect* file_select);
+static bool file_select_init_inner(FileSelect* file_select);
 
 static void file_select_draw_callback(Canvas* canvas, void* _model) {
     FileSelectModel* model = _model;
@@ -66,8 +69,8 @@ static bool file_select_input_callback(InputEvent* event, void* context) {
 
     if(event->type == InputTypeShort) {
         if(!file_select->init_completed) {
-            if(!file_select_init(file_select)) {
-                file_select->callback(NULL, file_select->context);
+            if(!file_select_init_inner(file_select)) {
+                file_select->callback(false, file_select->context);
             }
         } else if(event->key == InputKeyUp) {
             with_view_model(
@@ -127,20 +130,24 @@ static bool file_select_input_callback(InputEvent* event, void* context) {
                         return false;
                     });
 
-                file_select->callback(result, file_select->context);
+                if(file_select->buffer) {
+                    strlcpy(file_select->buffer, result, file_select->buffer_size);
+                };
+
+                file_select->callback(true, file_select->context);
             }
             consumed = true;
         }
 
         if(!file_select_fill_strings(file_select)) {
-            file_select->callback(NULL, file_select->context);
+            file_select->callback(false, file_select->context);
         }
     }
 
     return consumed;
 }
 
-static bool file_select_init(FileSelect* file_select) {
+static bool file_select_init_inner(FileSelect* file_select) {
     bool result = false;
     if(file_select->path && file_select->extension && file_select->fs_api) {
         if(file_select_fill_count(file_select)) {
@@ -162,13 +169,6 @@ FileSelect* file_select_alloc() {
     view_set_draw_callback(file_select->view, file_select_draw_callback);
     view_set_input_callback(file_select->view, file_select_input_callback);
 
-    file_select->fs_api = NULL;
-    file_select->path = NULL;
-    file_select->extension = NULL;
-    file_select->init_completed = false;
-    file_select->callback = NULL;
-    file_select->context = NULL;
-
     with_view_model(
         file_select->view, (FileSelectModel * model) {
             for(uint8_t i = 0; i < FILENAME_COUNT; i++) {
@@ -209,12 +209,30 @@ void file_select_set_api(FileSelect* file_select, FS_Api* fs_api) {
 void file_select_set_callback(FileSelect* file_select, FileSelectCallback callback, void* context) {
 }
 
-void file_select_set_filter(FileSelect* file_select, char* path, char* extension) {
+void file_select_set_filter(FileSelect* file_select, const char* path, const char* extension) {
     furi_assert(file_select);
     file_select->path = path;
     file_select->extension = extension;
 }
 
+void file_select_set_result_buffer(FileSelect* file_select, char* buffer, uint8_t buffer_size) {
+    file_select->buffer = buffer;
+    file_select->buffer_size = buffer_size;
+
+    if(file_select->buffer) {
+        strlcpy(file_select->buffer, "", file_select->buffer_size);
+    }
+}
+
+bool file_select_init(FileSelect* file_select) {
+    if(!file_select_init_inner(file_select)) {
+        file_select->callback(false, file_select->context);
+        return false;
+    } else {
+        return true;
+    }
+}
+
 static bool filter_file(FileSelect* file_select, FileInfo* file_info, char* name) {
     bool result = false;
 

applications/gui/modules/file_select.h

@@ -8,7 +8,7 @@ extern "C" {
 
 typedef struct FileSelect FileSelect;
 
-typedef void (*FileSelectCallback)(const char* result, void* context);
+typedef void (*FileSelectCallback)(bool result, void* context);
 
 FileSelect* file_select_alloc();
 
@@ -17,7 +17,9 @@ View* file_select_get_view(FileSelect* file_select);
 
 void file_select_set_api(FileSelect* file_select, FS_Api* fs_api);
 void file_select_set_callback(FileSelect* file_select, FileSelectCallback callback, void* context);
-void file_select_set_filter(FileSelect* file_select, char* path, char* extension);
+void file_select_set_filter(FileSelect* file_select, const char* path, const char* extension);
+void file_select_set_result_buffer(FileSelect* file_select, char* buffer, uint8_t buffer_size);
+bool file_select_init(FileSelect* file_select);
 
 #ifdef __cplusplus
 }

applications/gui/view_dispatcher.h

@@ -7,47 +7,55 @@
 extern "C" {
 #endif
 
-/* ViewDispatcher view_port placement */
+/**
+ * @brief ViewDispatcher view_port placement
+ */
 typedef enum {
-    ViewDispatcherTypeNone, /* Special layer for internal use only */
-    ViewDispatcherTypeWindow, /* Main view_port layer, status bar is shown */
-    ViewDispatcherTypeFullscreen /* Fullscreen view_port layer */
+    ViewDispatcherTypeNone, /**< Special layer for internal use only */
+    ViewDispatcherTypeWindow, /**< Main view_port layer, status bar is shown */
+    ViewDispatcherTypeFullscreen /**< Fullscreen view_port layer */
 } ViewDispatcherType;
 
 typedef struct ViewDispatcher ViewDispatcher;
 
-/* Allocate ViewDispatcher
+/**
+ * @brief Allocate ViewDispatcher
  * @return pointer to ViewDispatcher instance
  */
 ViewDispatcher* view_dispatcher_alloc();
 
-/* Free ViewDispatcher
- * @param pointer to View
+/**
+ * @brief Free ViewDispatcher
+ * @param view_dispatcher pointer to ViewDispatcher
  */
 void view_dispatcher_free(ViewDispatcher* view_dispatcher);
 
-/* Add view to ViewDispatcher
+/**
+ * @brief Add view to ViewDispatcher
  * @param view_dispatcher, ViewDispatcher instance
- * @param view_id, View id to register
- * @param view, View instance
+ * @param view_id View id to register
+ * @param view View instance
  */
 void view_dispatcher_add_view(ViewDispatcher* view_dispatcher, uint32_t view_id, View* view);
 
-/* Remove view from ViewDispatcher
- * @param view_dispatcher, ViewDispatcher instance
- * @param view_id, View id to remove
+/**
+ * @brief Remove view from ViewDispatcher
+ * @param view_dispatcher ViewDispatcher instance
+ * @param view_id View id to remove
  */
 void view_dispatcher_remove_view(ViewDispatcher* view_dispatcher, uint32_t view_id);
 
-/* Switch to View
- * @param view_dispatcher, ViewDispatcher instance
- * @param view_id, View id to register
+/**
+ * @brief Switch to View
+ * @param view_dispatcher ViewDispatcher instance
+ * @param view_id View id to register
  */
 void view_dispatcher_switch_to_view(ViewDispatcher* view_dispatcher, uint32_t view_id);
 
-/* Attach ViewDispatcher to GUI
- * @param view_dispatcher, ViewDispatcher instance
- * @param gui, GUI instance to attach to
+/**
+ * @brief Attach ViewDispatcher to GUI
+ * @param view_dispatcher ViewDispatcher instance
+ * @param gui GUI instance to attach to
  */
 void view_dispatcher_attach_to_gui(
     ViewDispatcher* view_dispatcher,