ESP32 UI库开发者系统提示

# platformio.ini [env:esp32dev] platform = espressif32 board = esp32dev framework = arduino build_flags = -std=c++14 -fno-rtti lib_deps = esphome/ESPAsyncWebServer-esphome@^3.1.0 bblanchon/ArduinoJson@^7.0.0 littlefs ``` ```cpp // src/UI_DLS.h #pragma once #include #include #include #include namespace UIDSL { // Base class for all UI elements class Element { public: virtual ~Element() = default; virtual void serialize(JsonObject& obj) const = 0; virtual const char* type() const = 0; const char* id() const { return _id; } protected: explicit Element(const char* id) : _id(id) {} const char* _id; }; // Button element class Button : public Element { public: Button(const char* id, const char* label, std::function onClick) : Element(id), _label(label), _onClick(std::move(onClick)) {} void serialize(JsonObject& obj) const override { obj["type"] = "button"; obj["id"] = _id; obj["label"] = _label; } const char* type() const override { return "button"; } void click() { if (_onClick) _onClick(); } private: const char* _label; std::function _onClick; }; // Slider element class Slider : public Element { public: Slider(const char* id, const char* label, int min, int max, int value) : Element(id), _label(label), _min(min), _max(max), _value(value) {} void serialize(JsonObject& obj) const override { obj["type"] = "slider"; obj["id"] = _id; obj["label"] = _label; obj["min"] = _min; obj["max"] = _max; obj["value"] = _value; } const char* type() const override { return "slider"; } void setValue(int v) { _value = v; } int value() const { return _value; } private: const char* _label; int _min, _max, _value; }; // Text display element class TextDisplay : public Element { public: TextDisplay(const char* id, const char* label, const char* value = "") : Element(id), _label(label), _value(value) {} void serialize(JsonObject& obj) const override { obj["type"] = "text"; obj["id"] = _id; obj["label"] = _label; obj["value"] = _value; } const char* type() const override { return "text"; } void setValue(const char* v) { _value = v; } private: const char* _label; const char* _value; }; // Container for grouping elements class Container : public Element { public: Container(const char* id, const char* title) : Element(id), _title(title) {} template Container& add(T&& element) { _elements.push_back(std::make_shared >(std::forward (element))); return *this; } void serialize(JsonObject& obj) const override { obj["type"] = "container"; obj["id"] = _id; obj["title"] = _title; JsonArray children = obj.createNestedArray("children"); for (const auto& elem : _elements) { JsonObject childObj = children.createNestedObject(); elem->serialize(childObj); } } const char* type() const override { return "container"; } private: const char* _title; std::vector > _elements; }; // Root UI definition class UI { public: UI() = default; template UI& add(T&& element) { _elements.push_back(std::make_shared >(std::forward (element))); return *this; } void serialize(JsonDocument& doc) const { JsonArray root = doc.to (); for (const auto& elem : _elements) { JsonObject obj = root.createNestedObject(); elem->serialize(obj); } } private: std::vector > _elements; }; } // namespace UIDSL ``` ```cpp // src/UI_Runtime.h #pragma once #include #include #include #include #include #include #include #include #include "UI_DLS.h" namespace UIRuntime { // Task-based runtime environment class Runtime { public: Runtime() : _server(80), _taskHandle(nullptr) {} // Initialize the runtime (must be called once) void begin() { // Mount filesystem if (!LittleFS.begin(true)) { log_e("LittleFS mount failed"); return; } // Setup web server routes setupRoutes(); // Start server _server.begin(); // Create runtime task xTaskCreatePinnedToCore( runtimeTask, "ui_runtime", 8192, this, 1, &_taskHandle, 1); } // Register UI schema void setSchema(const UIDSL::UI& ui) { std::lock_guard lock(_mutex); _schema = &ui; } // Register state update callback void onStateChange(std::function callback) { _stateCallback = std::move(callback); } // Update runtime state (thread-safe) void updateState(JsonDocument&& state) { std::lock_guard lock(_mutex); _state = std::move(state); _stateDirty = true; } private: AsyncWebServer _server; TaskHandle_t _taskHandle; std::mutex _mutex; const UIDSL::UI* _schema = nullptr; JsonDocument _state; bool _stateDirty = false; std::function _stateCallback; void setupRoutes() { // Serve static frontend files _server.serveStatic("/", LittleFS, "/www/").setDefaultFile("index.html"); // REST API endpoints _server.on("/api/schema", HTTP_GET, [this](AsyncWebServerRequest* request) { if (!_schema) { request->send(500, "application/json", "{\"error\":\"Schema not set\"}"); return; } JsonDocument doc; _schema->serialize(doc); String response; serializeJson(doc, response); request->send(200, "application/json", response); }); _server.on("/api/state", HTTP_GET, [this](AsyncWebServerRequest* request) { std::lock_guard lock(_mutex); String response; serializeJson(_state, response); request->send(200, "application/json", response); }); _server.on("/api/state", HTTP_POST, [this](AsyncWebServerRequest* request) { // Parse incoming state update JsonDocument incoming; if (deserializeJson(incoming, request->body()) != DeserializationError::Ok) { request->send(400, "application/json", "{\"error\":\"Invalid JSON\"}"); return; } // Update state { std::lock_guard lock(_mutex); _state = incoming; _stateDirty = true; } // Notify callback if (_stateCallback) { _stateCallback(incoming); } request->send(200, "application/json", "{\"status\":\"ok\"}"); }); // Handle 404 _server.onNotFound([](AsyncWebServerRequest* request) { request->send(404, "application/json", "{\"error\":\"Not found\"}"); }); } static void runtimeTask(void* param) { Runtime* runtime = static_cast (param); while (true) { // Process state updates { std::lock_guard lock(runtime->_mutex); if (runtime->_stateDirty) { runtime->_stateDirty = false; // State is ready for consumption } } // Yield to other tasks vTaskDelay(pdMS_TO_TICKS(100)); } } }; } // namespace UIRuntime ``` ```cpp // src/DebugSystem.h #pragma once #include #include namespace UIDebug { // Compile-time debug levels enum class Level : uint8_t { NONE = 0, ERROR = 1, WARN = 2, INFO = 3, DEBUG = 4, TRACE = 5 }; // Compile-time configuration #ifndef UI_DEBUG_LEVEL #define UI_DEBUG_LEVEL UIDebug::Level::INFO #endif // Compile-time assertion for debug level static_assert(UI_DEBUG_LEVEL >= UIDebug::Level::NONE && UI_DEBUG_LEVEL <= UIDebug::Level::TRACE, "Invalid debug level"); // Compile-time string hashing for log tags constexpr uint32_t hashString(const char* str, uint32_t seed = 0) { return *str ? hashString(str + 1, (seed ^ *str) * 16777619u) : seed; } // Log macro with compile-time filtering #define UI_LOG(level, tag, ...) \ do { \ if constexpr (level <= UI_DEBUG_LEVEL) { \ Serial.printf("[%s] ", tag); \ Serial.printf(__VA_ARGS__); \ Serial.println(); \ } \ } while(0) // Convenience macros #define UI_LOGE(tag, ...) UI_LOG(UIDebug::Level::ERROR, tag, __VA_ARGS__) #define UI_LOGW(tag, ...) UI_LOG(UIDebug::Level::WARN, tag, __VA_ARGS__) #define UI_LOGI(tag, ...) UI_LOG(UIDebug::Level::INFO, tag, __VA_ARGS__) #define UI_LOGD(tag, ...) UI_LOG(UIDebug::Level::DEBUG, tag, __VA_ARGS__) #define UI_LOGT(tag, ...) UI_LOG(UIDebug::Level::TRACE, tag, __VA_ARGS__) // Compile-time feature flags #define UI_FEATURE_ENABLED(feature) (feature > 0) // Example feature flags #define UI_FEATURE_WEBSOCKET 1 #define UI_FEATURE_OTA 0 #define UI_FEATURE_MQTT 0 // Compile-time assertions for feature compatibility static_assert(UI_FEATURE_ENABLED(UI_FEATURE_WEBSOCKET) || !UI_FEATURE_ENABLED(UI_FEATURE_WEBSOCKET), "WebSocket feature flag must be boolean"); } // namespace UIDebug ``` ```cpp // src/UI_Library.h #pragma once #include "UI_DLS.h" #include "UI_Runtime.h" #include "DebugSystem.h" // Main library namespace namespace UILib { // Main library class class UI { public: UI() : _runtime() {} // Initialize the library void begin() { UI_LOGI("UI", "Initializing UI library"); _runtime.begin(); } // Get runtime instance UIRuntime::Runtime& runtime() { return _runtime; } // Set UI schema void setSchema(const UIDSL::UI& schema) { _runtime.setSchema(schema); } // Update state void updateState(JsonDocument&& state) { _runtime.updateState(std::move(state)); } // Register state change callback void onStateChange(std::function callback) { _runtime.onStateChange(std::move(callback)); } private: UIRuntime::Runtime _runtime; }; } // namespace UILib ``` ```cpp // examples/basic_usage/main.cpp #include #include using namespace UIDSL; using namespace UILib; // Global UI instance UI ui; // Example state int ledState = 0; float temperature = 25.5f; // Button callback void toggleLED() { ledState = !ledState; digitalWrite(LED_BUILTIN, ledState); // Update state JsonDocument state; state["led"] = ledState; state["temperature"] = temperature; ui.updateState(std::move(state)); } void setup() { Serial.begin(115200); pinMode(LED_BUILTIN, OUTPUT); // Build UI schema UI schema; schema.add( Container("main", "Control Panel") .add(Button("btn_led", "Toggle LED", toggleLED)) .add(Slider("slider_temp", "Temperature", 0, 100, 25)) .add(TextDisplay("txt_temp", "Current Temp", "25.5°C")) ); // Initialize library ui.begin(); ui.setSchema(schema); // Register state change handler ui.onStateChange([](const JsonDocument& state) { if (state.containsKey("slider_temp")) { temperature = state["slider_temp"]; Serial.printf("Temperature set to: %.1f\n", temperature); } }); // Initial state JsonDocument initialState; initialState["led"] = 0; initialState["temperature"] = temperature; ui.updateState(std::move(initialState)); UI_LOGI("APP", "Setup complete"); } void loop() { // Main loop - runtime handles everything in background delay(1000); } ``` ```json // data/www/index.html (frontend placeholder) ESP32 UI

ESP32 UI库开发者系统提示

提示词内容收藏

用法

参考资料

讨论