Support for building and running external apps (#112)

Libraries/elf_loader/include/esp_elf.h

@@ -0,0 +1,94 @@
+/*
+ * SPDX-FileCopyrightText: 2023 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#pragma once
+
+#include "private/elf_types.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief Map symbol's address of ELF to physic space.
+ *
+ * @param elf - ELF object pointer
+ * @param sym - ELF symbol address
+ * 
+ * @return Mapped physic address.
+ */
+uintptr_t esp_elf_map_sym(esp_elf_t *elf, uintptr_t sym);
+
+/**
+ * @brief Initialize ELF object.
+ *
+ * @param elf - ELF object pointer
+ * 
+ * @return ESP_OK if sucess or other if failed.
+ */
+int esp_elf_init(esp_elf_t *elf);
+
+/**
+ * @brief Decode and relocate ELF data.
+ *
+ * @param elf - ELF object pointer
+ * @param pbuf - ELF data buffer
+ * 
+ * @return ESP_OK if sucess or other if failed.
+ */
+int esp_elf_relocate(esp_elf_t *elf, const uint8_t *pbuf);
+
+/**
+ * @brief Request running relocated ELF function.
+ *
+ * @param elf  - ELF object pointer
+ * @param opt  - Request options
+ * @param argc - Arguments number
+ * @param argv - Arguments value array
+ * 
+ * @return ESP_OK if sucess or other if failed.
+ */
+int esp_elf_request(esp_elf_t *elf, int opt, int argc, char *argv[]);
+
+/**
+ * @brief Deinitialize ELF object.
+ *
+ * @param elf - ELF object pointer
+ * 
+ * @return None
+ */
+void esp_elf_deinit(esp_elf_t *elf);
+
+/**
+ * @brief Print header description information of ELF.
+ *
+ * @param pbuf - ELF data buffer
+ * 
+ * @return None
+ */
+void esp_elf_print_hdr(const uint8_t *pbuf);
+
+/**
+ * @brief Print section header description information of ELF.
+ *
+ * @param pbuf - ELF data buffer
+ * 
+ * @return None
+ */
+void esp_elf_print_shdr(const uint8_t *pbuf);
+
+/**
+ * @brief Print section information of ELF.
+ *
+ * @param pbuf - ELF data buffer
+ * 
+ * @return None
+ */
+void esp_elf_print_sec(esp_elf_t *elf);
+
+#ifdef __cplusplus
+}
+#endif