Merge Develop into Main (#298)

Various improvements and new internal APIs including a new Development service+app which allows `tactility.py` to upload and run applications remotely.
2025-07-19 00:27:49 +02:00
parent d06197a6aa
commit ab4cf79a47
25 changed files with 1096 additions and 12 deletions
@@ -0,0 +1,11 @@
+#pragma once
+
+#ifdef ESP_PLATFORM
+
+namespace tt::app::development {
+
+void start();
+
+}
+
+#endif // ESP_PLATFORM
@@ -0,0 +1,97 @@
+#pragma once
+#ifdef ESP_PLATFORM
+
+#include "Tactility/service/Service.h"
+
+#include <Tactility/Mutex.h>
+
+#include <esp_event.h>
+#include <esp_http_server.h>
+#include <Tactility/kernel/SystemEvents.h>
+
+namespace tt::service::development {
+
+class DevelopmentService final : public Service {
+
+    Mutex mutex = Mutex(Mutex::Type::Recursive);
+    httpd_handle_t server = nullptr;
+    bool enabled = false;
+    kernel::SystemEventSubscription networkConnectEventSubscription = 0;
+    kernel::SystemEventSubscription networkDisconnectEventSubscription = 0;
+    std::string deviceResponse;
+
+    httpd_uri_t handleGetInfoEndpoint = {
+        .uri = "/info",
+        .method = HTTP_GET,
+        .handler = handleGetInfo,
+        .user_ctx = this
+    };
+
+    httpd_uri_t appRunEndpoint = {
+        .uri = "/app/run",
+        .method = HTTP_POST,
+        .handler = handleAppRun,
+        .user_ctx = this
+    };
+
+    httpd_uri_t appInstallEndpoint = {
+        .uri = "/app/install",
+        .method = HTTP_PUT,
+        .handler = handleAppInstall,
+        .user_ctx = this
+    };
+
+    void onNetworkConnected();
+    void onNetworkDisconnected();
+
+    void startServer();
+    void stopServer();
+
+    static esp_err_t handleGetInfo(httpd_req_t* request);
+    static esp_err_t handleAppRun(httpd_req_t* request);
+    static esp_err_t handleAppInstall(httpd_req_t* request);
+
+public:
+
+    // region Overrides
+
+    void onStart(ServiceContext& service) override;
+    void onStop(ServiceContext& service) override;
+
+    // endregion Overrides
+
+    // region Internal API
+
+    /**
+     * Enabling the service means that the user is willing to start the web server.
+     * @return true when the service is enabled
+     */
+    bool isEnabled() const;
+
+    /**
+     * Enabling the service means that the user is willing to start the web server.
+     * @param[in] enabled
+     */
+    void setEnabled(bool enabled);
+
+    /**
+     * @return true if the service will enable itself when it is started (e.g. on boot, or manual start)
+     */
+    bool isEnabledOnStart() const;
+
+    /**
+     * Set whether the service should auto-enable when it is started.
+     * @param enabled
+     */
+    void setEnabledOnStart(bool enabled);
+
+    bool isStarted() const;
+
+    // region Internal API
+};
+
+std::shared_ptr<DevelopmentService> findService();
+
+}
+
+#endif // ESP_PLATFORM