ESP32-UI-Bibliothek Entwickler System Prompt

#include #include #include #include #include #include #include #include // ============================================================ // Compile-Time Debug System // ============================================================ namespace Debug { enum class Level : uint8_t { NONE = 0, ERROR = 1, WARN = 2, INFO = 3, DEBUG = 4 }; template struct Logger { static void log(const char* msg) { if constexpr (L <= CURRENT_LEVEL) { Serial.print("["); Serial.print(levelName(L)); Serial.print("] "); Serial.println(msg); } } static constexpr const char* levelName(Level l) { return l == Level::ERROR ? "ERR" : l == Level::WARN ? "WRN" : l == Level::INFO ? "INF" : "DBG"; } }; #ifdef DEBUG_LEVEL static constexpr Level CURRENT_LEVEL = DEBUG_LEVEL; #else static constexpr Level CURRENT_LEVEL = Level::INFO; #endif } // ============================================================ // UI DSL - Compile-Time Item Definition // ============================================================ namespace UIDSL { struct Item { const char* name; const char* type; const char* label; const char* unit; float min; float max; float step; bool readOnly; }; template struct Schema { std::array items; constexpr Schema(std::array arr) : items(arr) {} constexpr size_t size() const { return N; } }; // Helper macros for concise definition #define UI_ITEM(name, type, label, unit, min, max, step, ro) \ Item{name, type, label, unit, min, max, step, ro} #define UI_SLIDER(name, label, unit, min, max, step) \ UI_ITEM(name, "slider", label, unit, min, max, step, false) #define UI_TOGGLE(name, label) \ UI_ITEM(name, "toggle", label, nullptr, 0, 1, 1, false) #define UI_READONLY(name, label, unit) \ UI_ITEM(name, "readonly", label, unit, 0, 0, 0, true) } // ============================================================ // Task-Based Runtime Environment // ============================================================ namespace Runtime { class Task { public: virtual ~Task() = default; virtual void setup() {} virtual void loop() = 0; virtual const char* name() const = 0; }; class TaskManager { private: std::vector > tasks; unsigned long lastTick = 0; const unsigned long tickInterval = 10; // 10ms tick public: void addTask(std::unique_ptr task) { task->setup(); tasks.push_back(std::move(task)); } void run() { unsigned long now = millis(); if (now - lastTick >= tickInterval) { lastTick = now; for (auto& task : tasks) { task->loop(); } } } size_t count() const { return tasks.size(); } }; } // ============================================================ // State Management // ============================================================ class StateManager { private: JsonDocument doc; JsonObject state; public: StateManager() { doc = JsonDocument(); state = doc.to (); } void set(const char* key, float value) { state[key] = value; } void set(const char* key, bool value) { state[key] = value; } float getFloat(const char* key, float def = 0.0f) { return state[key] | def; } bool getBool(const char* key, bool def = false) { return state[key] | def; } JsonObject getState() { return state; } String serialize() { String output; serializeJson(doc, output); return output; } }; // ============================================================ // REST API Contract // ============================================================ namespace API { constexpr const char* BASE_PATH = "/api"; constexpr const char* STATE_PATH = "/api/state"; constexpr const char* SCHEMA_PATH = "/api/schema"; constexpr const char* CONTROL_PATH = "/api/control"; constexpr const char* HEALTH_PATH = "/api/health"; // Response format: {"status":"ok","data":{...}} // Error format: {"status":"error","message":"..."} } // ============================================================ // Main UI Library Class // ============================================================ template class ESP32UI { private: AsyncWebServer server; StateManager stateManager; Runtime::TaskManager taskManager; UIDSL::Schema schema; bool initialized = false; // Static file serving void serveStaticFiles() { // Serve index.html server.on("/", HTTP_GET, [](AsyncWebServerRequest *request) { request->send(LittleFS, "/index.html", "text/html"); }); // Serve static assets from LittleFS server.serveStatic("/static/", LittleFS, "/static/"); } // REST API endpoints void setupAPI() { // Health check server.on(API::HEALTH_PATH, HTTP_GET, [this](AsyncWebServerRequest *request) { AsyncResponseStream *response = request->beginResponseStream("application/json"); JsonDocument doc; doc["status"] = "ok"; doc["uptime"] = millis() / 1000; serializeJson(doc, *response); request->send(response); }); // Get current state server.on(API::STATE_PATH, HTTP_GET, [this](AsyncWebServerRequest *request) { AsyncResponseStream *response = request->beginResponseStream("application/json"); JsonDocument doc; doc["status"] = "ok"; doc["data"] = stateManager.getState(); serializeJson(doc, *response); request->send(response); }); // Get UI schema server.on(API::SCHEMA_PATH, HTTP_GET, [this](AsyncWebServerRequest *request) { AsyncResponseStream *response = request->beginResponseStream("application/json"); JsonDocument doc; doc["status"] = "ok"; JsonArray items = doc["data"].to (); for (const auto& item : schema.items) { JsonObject obj = items.add (); obj["name"] = item.name; obj["type"] = item.type; obj["label"] = item.label; if (item.unit) obj["unit"] = item.unit; obj["min"] = item.min; obj["max"] = item.max; obj["step"] = item.step; obj["readOnly"] = item.readOnly; } serializeJson(doc, *response); request->send(response); }); // Control endpoint (POST) server.on(API::CONTROL_PATH, HTTP_POST, [this](AsyncWebServerRequest *request) { // Parse JSON body if (request->hasParam("body", true)) { AsyncWebParameter* p = request->getParam("body", true); JsonDocument doc; DeserializationError error = deserializeJson(doc, p->value()); if (error) { request->send(400, "application/json", "{\"status\":\"error\",\"message\":\"Invalid JSON\"}"); return; } // Update state for (JsonPair kv : doc.as ()) { const char* key = kv.key().c_str(); if (kv.value().is ()) { stateManager.set(key, kv.value().as ()); } else if (kv.value().is ()) { stateManager.set(key, kv.value().as ()); } } request->send(200, "application/json", "{\"status\":\"ok\"}"); } else { request->send(400, "application/json", "{\"status\":\"error\",\"message\":\"No body\"}"); } }); } public: ESP32UI(UIDSL::Schema s) : server(80), schema(s) {} void begin() { if (initialized) return; // Initialize filesystem if (!LittleFS.begin(true)) { Debug::Logger ::log("LittleFS mount failed"); return; } // Setup web server serveStaticFiles(); setupAPI(); // Start server server.begin(); initialized = true; Debug::Logger ::log("ESP32UI initialized"); } void addTask(std::unique_ptr task) { taskManager.addTask(std::move(task)); } void update() { taskManager.run(); } // State access for user code void setState(const char* key, float value) { stateManager.set(key, value); } void setState(const char* key, bool value) { stateManager.set(key, value); } float getStateFloat(const char* key) { return stateManager.getFloat(key); } bool getStateBool(const char* key) { return stateManager.getBool(key); } String getStateJSON() { return stateManager.serialize(); } }; // ============================================================ // Example Usage (User Code) // ============================================================ /* // Define UI schema constexpr auto mySchema = UIDSL::Schema ({ UI_SLIDER("temperature", "Temperature", "°C", -40.0f, 125.0f, 0.5f), UI_TOGGLE("heater", "Heater"), UI_READONLY("voltage", "Voltage", "V") }); // Create UI instance ESP32UI ui(mySchema); // Define a custom task class SensorTask : public Runtime::Task { public: void setup() override { Debug::Logger ::log("Sensor task setup"); } void loop() override { static float temp = 25.0f; temp += 0.1f; ui.setState("temperature", temp); ui.setState("voltage", 3.3f); } const char* name() const override { return "sensor"; } }; void setup() { Serial.begin(115200); ui.begin(); ui.addTask(std::make_unique ()); } void loop() { ui.update(); } */

ESP32-UI-Bibliothek Entwickler System Prompt

Prompt-InhaltSpeichern

Verwendung

Referenzen

Diskussion