* 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 |