Système d'invite pour développeur de bibliothèque d'interface utilisateur ESP32

// ============================================================================ // ESP32 UI-Schema Library - Core Runtime // ============================================================================ // This library provides a task-based runtime environment for the ESP32, // exposing a REST API and serving a schema-driven frontend. #pragma once #include #include #include #include #include #include #include // ---------------------------------------------------------------------------- // Compile-time debug system (enabled via -DUI_DEBUG_LEVEL) // ---------------------------------------------------------------------------- #if defined(UI_DEBUG_LEVEL) && (UI_DEBUG_LEVEL > 0) #define UI_LOG(level, ...) do { \ if (level <= UI_DEBUG_LEVEL) { \ Serial.printf("[UI:%d] ", level); \ Serial.printf(__VA_ARGS__); \ Serial.println(); \ } \ } while (0) #else #define UI_LOG(level, ...) do {} while (0) #endif // ---------------------------------------------------------------------------- // Forward declarations // ---------------------------------------------------------------------------- namespace ui { // ---------------------------------------------------------------------------- // UI DSL - C++ fluent interface for defining UI elements // ---------------------------------------------------------------------------- class Element { public: virtual ~Element() = default; virtual void toJson(JsonObject& obj) const = 0; const String& name() const { return _name; } const String& type() const { return _type; } protected: Element(const String& name, const String& type) : _name(name), _type(type) {} String _name; String _type; }; class Button : public Element { public: Button(const String& name, const String& label) : Element(name, "button"), _label(label) {} void toJson(JsonObject& obj) const override { obj["name"] = _name; obj["type"] = _type; obj["label"] = _label; } private: String _label; }; class Slider : public Element { public: Slider(const String& name, int min, int max, int step, int value) : Element(name, "slider"), _min(min), _max(max), _step(step), _value(value) {} void toJson(JsonObject& obj) const override { obj["name"] = _name; obj["type"] = _type; obj["min"] = _min; obj["max"] = _max; obj["step"] = _step; obj["value"] = _value; } private: int _min, _max, _step, _value; }; class Label : public Element { public: Label(const String& name, const String& text) : Element(name, "label"), _text(text) {} void toJson(JsonObject& obj) const override { obj["name"] = _name; obj["type"] = _type; obj["text"] = _text; } private: String _text; }; // ---------------------------------------------------------------------------- // Task-Based Runtime Environment // ---------------------------------------------------------------------------- class Task { public: virtual ~Task() = default; virtual void setup() {} virtual void loop() = 0; virtual void onEvent(const String& event, const JsonObject& data) {} }; class Runtime { public: void addTask(std::unique_ptr task) { _tasks.push_back(std::move(task)); } void begin() { for (auto& task : _tasks) { task->setup(); } } void run() { for (auto& task : _tasks) { task->loop(); } } void dispatchEvent(const String& event, const JsonObject& data) { for (auto& task : _tasks) { task->onEvent(event, data); } } private: std::vector > _tasks; }; // ---------------------------------------------------------------------------- // REST API Contract // ---------------------------------------------------------------------------- // The following endpoints are mandatory: // GET /api/schema - Returns the UI schema as JSON // GET /api/state - Returns the current runtime state // POST /api/event - Sends an event to the runtime // GET /api/health - Returns health status // GET / - Serves the frontend (static files) class RestApi { public: RestApi(AsyncWebServer& server, Runtime& runtime) : _server(server), _runtime(runtime) {} void begin() { _server.on("/api/schema", HTTP_GET, [this](AsyncWebServerRequest* request) { // Build schema from registered UI elements JsonDocument doc; JsonArray elements = doc.createNestedArray("elements"); for (const auto& element : _elements) { JsonObject obj = elements.createNestedObject(); element->toJson(obj); } String response; serializeJson(doc, response); request->send(200, "application/json", response); }); _server.on("/api/state", HTTP_GET, [this](AsyncWebServerRequest* request) { // Build state from runtime JsonDocument doc; JsonObject state = doc.createNestedObject("state"); // Populate state from tasks for (auto& task : _tasks) { task->getState(state); } String response; serializeJson(doc, response); request->send(200, "application/json", response); }); _server.on("/api/event", HTTP_POST, [this](AsyncWebServerRequest* request) { // Parse JSON body JsonDocument doc; if (deserializeJson(doc, request->body()) == DeserializationError::Ok) { String event = doc["event"] | ""; JsonObject data = doc["data"].as (); _runtime.dispatchEvent(event, data); request->send(200, "application/json", "{\"status\":\"ok\"}"); } else { request->send(400, "application/json", "{\"error\":\"invalid JSON\"}"); } }); // Serve static frontend files from LittleFS _server.serveStatic("/", LittleFS, "/www/").setDefaultFile("index.html"); } void addElement(std::unique_ptr element) { _elements.push_back(std::move(element)); } private: AsyncWebServer& _server; Runtime& _runtime; std::vector > _elements; std::vector > _tasks; }; // ---------------------------------------------------------------------------- // Library Initialization (strictly within the library) // ---------------------------------------------------------------------------- class UILibrary { public: UILibrary(AsyncWebServer& server) : _api(server, _runtime) {} void begin() { // Initialize filesystem if (!LittleFS.begin()) { UI_LOG(1, "LittleFS mount failed"); return; } // Initialize runtime _runtime.begin(); // Initialize API _api.begin(); UI_LOG(1, "Library initialized"); } void loop() { _runtime.run(); } // User API to add elements and tasks void addElement(std::unique_ptr element) { _api.addElement(std::move(element)); } void addTask(std::unique_ptr task) { _runtime.addTask(std::move(task)); } private: AsyncWebServer& _server; Runtime _runtime; ApiApi _api; }; } // namespace ui // ---------------------------------------------------------------------------- // Example usage in user code // ---------------------------------------------------------------------------- /* #include #include #include "ui_library.h" class MyTask : public ui::Task { public: void setup() override { UI_LOG(1, "MyTask setup"); } void loop() override { // Task logic } void getState(JsonObject& state) override { state["myValue"] = _value; } private: int _value = 42; }; AsyncWebServer server(80); ui::Library uiLib(server); void setup() { Serial.begin(115200); LittleFS.begin(); uiLib.addElement(std::make_unique ("btn1", "Click Me")); uiLib.addElement(std::make_unique ("slider1", 0, 100, 50)); uiLib.addElement(std::make_unique ("label1", "Hello")); uiLib.addTask(std::make_unique ()); uiLib.begin(); } void loop() { uiLib.loop(); }

Système d'invite pour développeur de bibliothèque d'interface utilisateur ESP32

Contenu du PromptEnregistrer

Utilisation

Références

Discussion