 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
		
			
				
	
	
		
			85 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			85 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
| #pragma once
 | |
| 
 | |
| #include <flipper_application/elf/elf_api_interface.h>
 | |
| 
 | |
| #include <stdint.h>
 | |
| 
 | |
| #ifdef __cplusplus
 | |
| extern "C" {
 | |
| #endif
 | |
| 
 | |
| /**
 | |
|  * @brief Symbol table entry
 | |
|  */
 | |
| struct sym_entry {
 | |
|     uint32_t hash;
 | |
|     uint32_t address;
 | |
| };
 | |
| 
 | |
| /**
 | |
|  * @brief Resolver for API entries using a pre-sorted table with hashes
 | |
|  * @param interface pointer to HashtableApiInterface
 | |
|  * @param name function name
 | |
|  * @param address output for function address
 | |
|  * @return true if the table contains a function
 | |
|  */
 | |
| bool elf_resolve_from_hashtable(
 | |
|     const ElfApiInterface* interface,
 | |
|     const char* name,
 | |
|     Elf32_Addr* address);
 | |
| 
 | |
| #ifdef __cplusplus
 | |
| }
 | |
| 
 | |
| #include <array>
 | |
| #include <algorithm>
 | |
| 
 | |
| /**
 | |
|  * @brief  HashtableApiInterface is an implementation of ElfApiInterface
 | |
|  * that uses a hash table to resolve function addresses.
 | |
|  * table_cbegin and table_cend must point to a sorted array of sym_entry
 | |
|  */
 | |
| struct HashtableApiInterface : public ElfApiInterface {
 | |
|     const sym_entry *table_cbegin, *table_cend;
 | |
| };
 | |
| 
 | |
| #define API_METHOD(x, ret_type, args_type)                                                     \
 | |
|     sym_entry {                                                                                \
 | |
|         .hash = elf_gnu_hash(#x), .address = (uint32_t)(static_cast<ret_type(*) args_type>(x)) \
 | |
|     }
 | |
| 
 | |
| #define API_VARIABLE(x, var_type) \
 | |
|     sym_entry { .hash = elf_gnu_hash(#x), .address = (uint32_t)(&(x)), }
 | |
| 
 | |
| constexpr bool operator<(const sym_entry& k1, const sym_entry& k2) {
 | |
|     return k1.hash < k2.hash;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * @brief Calculate hash for a string using the ELF GNU hash algorithm
 | |
|  * @param s string to calculate hash for
 | |
|  * @return hash value
 | |
|  */
 | |
| constexpr uint32_t elf_gnu_hash(const char* s) {
 | |
|     uint32_t h = 0x1505;
 | |
|     for(unsigned char c = *s; c != '\0'; c = *++s) {
 | |
|         h = (h << 5) + h + c;
 | |
|     }
 | |
|     return h;
 | |
| }
 | |
| 
 | |
| /* Compile-time check for hash collisions in API table.
 | |
|  * Usage: static_assert(!has_hash_collisions(api_methods), "Hash collision detected"); 
 | |
|  */
 | |
| template <std::size_t N>
 | |
| constexpr bool has_hash_collisions(const std::array<sym_entry, N>& api_methods) {
 | |
|     for(std::size_t i = 0; i < (N - 1); ++i) {
 | |
|         if(api_methods[i].hash == api_methods[i + 1].hash) {
 | |
|             return true;
 | |
|         }
 | |
|     }
 | |
| 
 | |
|     return false;
 | |
| }
 | |
| 
 | |
| #endif |