 53435579b3
			
		
	
	
		53435579b3
		
			
		
	
	
	
	
		
			
			* fbt, faploader: minimal app module implementation * faploader, libs: moved API hashtable core to flipper_application * example: compound api * lib: flipper_application: naming fixes, doxygen comments * fbt: changed `requires` manifest field behavior for app extensions * examples: refactored plugin apps; faploader: changed new API naming; fbt: changed PLUGIN app type meaning * loader: dropped support for debug apps & plugin menus * moved applications/plugins -> applications/external * Restored x bit on chiplist_convert.py * git: fixed free-dap submodule path * pvs: updated submodule paths * examples: example_advanced_plugins.c: removed potential memory leak on errors * examples: example_plugins: refined requires * fbt: not deploying app modules for debug/sample apps; extra validation for .PLUGIN-type apps * apps: removed cdefines for external apps * fbt: moved ext app path definition * fbt: reworked fap_dist handling; f18: synced api_symbols.csv * fbt: removed resources_paths for extapps * scripts: reworked storage * scripts: reworked runfap.py & selfupdate.py to use new api * wip: fal runner * fbt: moved file packaging into separate module * scripts: storage: fixes * scripts: storage: minor fixes for new api * fbt: changed internal artifact storage details for external apps * scripts: storage: additional fixes and better error reporting; examples: using APP_DATA_PATH() * fbt, scripts: reworked launch_app to deploy plugins; moved old runfap.py to distfap.py * fbt: extra check for plugins descriptors * fbt: additional checks in emitter * fbt: better info message on SDK rebuild * scripts: removed requirements.txt * loader: removed remnants of plugins & debug menus * post-review fixes
		
			
				
	
	
		
			154 lines
		
	
	
		
			5.1 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			154 lines
		
	
	
		
			5.1 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| #include "plugin_manager.h"
 | |
| 
 | |
| #include <loader/firmware_api/firmware_api.h>
 | |
| #include <storage/storage.h>
 | |
| #include <toolbox/path.h>
 | |
| 
 | |
| #include <m-array.h>
 | |
| #include <m-algo.h>
 | |
| 
 | |
| #include <furi.h>
 | |
| 
 | |
| #define TAG "libmgr"
 | |
| 
 | |
| ARRAY_DEF(FlipperApplicationList, FlipperApplication*, M_PTR_OPLIST)
 | |
| #define M_OPL_FlipperApplicationList_t() ARRAY_OPLIST(FlipperApplicationList, M_PTR_OPLIST)
 | |
| 
 | |
| struct PluginManager {
 | |
|     const char* application_id;
 | |
|     uint32_t api_version;
 | |
|     Storage* storage;
 | |
|     FlipperApplicationList_t libs;
 | |
|     const ElfApiInterface* api_interface;
 | |
| };
 | |
| 
 | |
| PluginManager* plugin_manager_alloc(
 | |
|     const char* application_id,
 | |
|     uint32_t api_version,
 | |
|     const ElfApiInterface* api_interface) {
 | |
|     PluginManager* manager = malloc(sizeof(PluginManager));
 | |
|     manager->application_id = application_id;
 | |
|     manager->api_version = api_version;
 | |
|     manager->api_interface = api_interface ? api_interface : firmware_api_interface;
 | |
|     manager->storage = furi_record_open(RECORD_STORAGE);
 | |
|     FlipperApplicationList_init(manager->libs);
 | |
|     return manager;
 | |
| }
 | |
| 
 | |
| void plugin_manager_free(PluginManager* manager) {
 | |
|     for
 | |
|         M_EACH(loaded_lib, manager->libs, FlipperApplicationList_t) {
 | |
|             flipper_application_free(*loaded_lib);
 | |
|         }
 | |
|     FlipperApplicationList_clear(manager->libs);
 | |
|     furi_record_close(RECORD_STORAGE);
 | |
|     free(manager);
 | |
| }
 | |
| 
 | |
| PluginManagerError plugin_manager_load_single(PluginManager* manager, const char* path) {
 | |
|     FlipperApplication* lib = flipper_application_alloc(manager->storage, manager->api_interface);
 | |
| 
 | |
|     PluginManagerError error = PluginManagerErrorNone;
 | |
|     do {
 | |
|         FlipperApplicationPreloadStatus preload_res = flipper_application_preload(lib, path);
 | |
| 
 | |
|         if(preload_res != FlipperApplicationPreloadStatusSuccess) {
 | |
|             FURI_LOG_E(TAG, "Failed to preload %s", path);
 | |
|             error = PluginManagerErrorLoaderError;
 | |
|             break;
 | |
|         }
 | |
| 
 | |
|         if(!flipper_application_is_plugin(lib)) {
 | |
|             FURI_LOG_E(TAG, "Not a plugin %s", path);
 | |
|             error = PluginManagerErrorLoaderError;
 | |
|             break;
 | |
|         }
 | |
| 
 | |
|         FlipperApplicationLoadStatus load_status = flipper_application_map_to_memory(lib);
 | |
|         if(load_status != FlipperApplicationLoadStatusSuccess) {
 | |
|             FURI_LOG_E(TAG, "Failed to load module_demo_plugin1.fal");
 | |
|             break;
 | |
|         }
 | |
| 
 | |
|         const FlipperAppPluginDescriptor* app_descriptor =
 | |
|             flipper_application_plugin_get_descriptor(lib);
 | |
| 
 | |
|         if(!app_descriptor) {
 | |
|             FURI_LOG_E(TAG, "Failed to get descriptor %s", path);
 | |
|             error = PluginManagerErrorLoaderError;
 | |
|             break;
 | |
|         }
 | |
| 
 | |
|         if(strcmp(app_descriptor->appid, manager->application_id) != 0) {
 | |
|             FURI_LOG_E(TAG, "Application id mismatch %s", path);
 | |
|             error = PluginManagerErrorApplicationIdMismatch;
 | |
|             break;
 | |
|         }
 | |
| 
 | |
|         if(app_descriptor->ep_api_version != manager->api_version) {
 | |
|             FURI_LOG_E(TAG, "API version mismatch %s", path);
 | |
|             error = PluginManagerErrorAPIVersionMismatch;
 | |
|             break;
 | |
|         }
 | |
| 
 | |
|         FlipperApplicationList_push_back(manager->libs, lib);
 | |
|     } while(false);
 | |
| 
 | |
|     if(error != PluginManagerErrorNone) {
 | |
|         flipper_application_free(lib);
 | |
|     }
 | |
| 
 | |
|     return error;
 | |
| }
 | |
| 
 | |
| PluginManagerError plugin_manager_load_all(PluginManager* manager, const char* path) {
 | |
|     File* directory = storage_file_alloc(manager->storage);
 | |
|     char file_name_buffer[256];
 | |
|     FuriString* file_name = furi_string_alloc();
 | |
|     do {
 | |
|         if(!storage_dir_open(directory, path)) {
 | |
|             FURI_LOG_E(TAG, "Failed to open directory %s", path);
 | |
|             break;
 | |
|         }
 | |
|         while(true) {
 | |
|             if(!storage_dir_read(directory, NULL, file_name_buffer, sizeof(file_name_buffer))) {
 | |
|                 break;
 | |
|             }
 | |
| 
 | |
|             furi_string_set(file_name, file_name_buffer);
 | |
|             if(!furi_string_end_with_str(file_name, ".fal")) {
 | |
|                 continue;
 | |
|             }
 | |
| 
 | |
|             path_concat(path, file_name_buffer, file_name);
 | |
|             FURI_LOG_D(TAG, "Loading %s", furi_string_get_cstr(file_name));
 | |
|             PluginManagerError error =
 | |
|                 plugin_manager_load_single(manager, furi_string_get_cstr(file_name));
 | |
| 
 | |
|             if(error != PluginManagerErrorNone) {
 | |
|                 FURI_LOG_E(TAG, "Failed to load %s", furi_string_get_cstr(file_name));
 | |
|                 break;
 | |
|             }
 | |
|         }
 | |
|     } while(false);
 | |
|     storage_dir_close(directory);
 | |
|     storage_file_free(directory);
 | |
|     furi_string_free(file_name);
 | |
|     return PluginManagerErrorNone;
 | |
| }
 | |
| 
 | |
| uint32_t plugin_manager_get_count(PluginManager* manager) {
 | |
|     return FlipperApplicationList_size(manager->libs);
 | |
| }
 | |
| 
 | |
| const FlipperAppPluginDescriptor* plugin_manager_get(PluginManager* manager, uint32_t index) {
 | |
|     FlipperApplication* app = *FlipperApplicationList_get(manager->libs, index);
 | |
|     return flipper_application_plugin_get_descriptor(app);
 | |
| }
 | |
| 
 | |
| const void* plugin_manager_get_ep(PluginManager* manager, uint32_t index) {
 | |
|     const FlipperAppPluginDescriptor* lib_descr = plugin_manager_get(manager, index);
 | |
|     furi_check(lib_descr);
 | |
|     return lib_descr->entry_point;
 | |
| }
 |