upd

Author: GyverLibs

docs/1.main.md

@@ -65,6 +65,9 @@ foo(AnyPtr(buf, 10));   // для char-буфера нужно явно указ
 ```cpp
 Settings(const String& title = "", GyverDB* db = nullptr);
 
+// установить версию прошивки для отображения в меню
+void setVersion(const char* ver);
+
 // установить пароль на вебморду. Пустая строка "" чтобы отключить
 void setPass(Text pass);
 

docs/2.start.md

@@ -70,7 +70,7 @@ board_build.filesystem = littlefs
 Вебморда является самостоятельным веб-приложением, написанным на html/css/js. Её файлы минифицированы, сжаты в gz и вшиты в код библиотеки как PROGMEM массив. В библиотеке настроен вебсервер, который отправляет файлы вебморды при заходе на IP платы в браузере. Лёгкий html файл подгружается каждый раз, а скрипты и стили кешируются браузером для ускорения загрузки. Вебморда общается с платой по http: например при загрузке запрашивает пакет с виджетами и прочей информацией.
 
 ### Captive portal
-Во всех трёх реализациях сервера из коробки настроен DNS для работы как Captive portal - если ESP работает в режиме точки доступа (AP или AP_STA), то при подключении к точке автоматически откроется окно браузера со страницей настроек.
+Во всех трёх реализациях сервера из коробки настроен DNS для работы как Captive portal - если ESP работает в режиме точки доступа (AP или AP_STA), то при подключении к точке автоматически откроется окно браузера со страницей настроек. Если это не нужно - можно отключить, запуская вебморду с флагом на отключение dns: `begin(false)`.
 
 ### Приложение для поиска
 Позволяет находить устройства с библиотекой в локальной сети и заменяет браузер, вебморда открывается сразу в приложении, кнопка назад возвращает к списку устройств. Чтобы удалить устройство - долгое удержание на нём на смартфоне или правой кнопкой мыши на ПК. Для поиска смартфон/ПК должны быть в одной локальной сети с устройством. В приложении должна быть указана корректная маска подсети (настраивается в роутере). Если в роутере она не менялась - то она там стандартная *255.255.255.0*, как и в приложении по умолчанию.
@@ -108,7 +108,7 @@ void setup() {
     Serial.println(WiFi.localIP());
 
     // settings
-    sett.begin();
+    sett.begin();   // begin(false) если не нужен captive
     sett.onBuild(build);
 }
 

docs/7.other.md

@@ -15,6 +15,62 @@ sett.config.updateTout = 2500;
 sett.config.theme = sets::Colors::Green;
 ```
 
+### Переполнение стека ESP8266
+На ESP8266 может случиться переполнение стека, если вызываемая функция слишком большая. Большая буквально - слишком много кода, т.е. это именно та проблема, которая появится при слишком большом билдере для Settings. Решение простое - разделить билдер на несколько функций, передавая в них `sets::Builder& b`:
+
+```cpp
+void build_1(sets::Builder& b) {
+    // виджеты...
+}
+void build_2(sets::Builder& b) {
+    // виджеты...
+}
+void build_3(sets::Builder& b) {
+    // виджеты...
+}
+void build_4(sets::Builder& b) {
+    // виджеты...
+}
+
+void build(sets::Builder& b) {
+    build_1(b);
+    build_2(b);
+    build_3(b);
+    build_4(b);
+}
+```
+
+Второй вариант - лямбды, он тоже работает:
+
+```cpp
+void build(sets::Builder& b) {
+    [&](){
+        // виджеты...
+    }();
+
+    [&](){
+        // виджеты...
+    }();
+}
+```
+
+В библиотеке есть удобные макросы:
+
+```cpp
+void build(sets::Builder& b) {
+    SUB_BUILD_BEGIN
+        // виджеты...
+        
+    SUB_BUILD_NEXT
+        // виджеты...
+
+    SUB_BUILD_NEXT
+        // виджеты...
+
+    SUB_BUILD_END
+}
+```
+
 ### Статус
 - Вебморда отслеживает статус устройства, при потере связи появится текст offline в заголовке страницы. После потери связи вебморда будет запрашивать информацию о виджетах, это очень удобно при разработке - например добавляем виджет, загружаем прошивку. За это время вебморда уже понимает что устройство оффлайн и при первом успешном подключении выводит актуальные виджеты.
 - При изменении значений виджетов вебморда следит за доставкой пакета, при ошибке связи появится надпись **error*** у соответствующего виджета

library.properties

@@ -1,5 +1,5 @@
 name=Settings
-version=1.3.3
+version=1.3.4
 author=AlexGyver <[email protected]>
 maintainer=AlexGyver <[email protected]>
 sentence=Simple UI webface builder for esp8266/esp32

src/core/SettingsBase.h

@@ -14,13 +14,15 @@
 #include <WiFi.h>
 #endif
 
-#include "./core/HybridFS.h"
-#include "./core/builder.h"
-#include "./core/colors.h"
-#include "./core/containers.h"
-#include "./core/logger.h"
-#include "./core/packet.h"
-#include "./core/updater.h"
+#include "../web/settings.h"
+#include "./HybridFS.h"
+#include "./builder.h"
+#include "./colors.h"
+#include "./containers.h"
+#include "./logger.h"
+#include "./macro.h"
+#include "./packet.h"
+#include "./updater.h"
 
 namespace sets {
 
@@ -123,6 +125,11 @@ class SettingsBase {
     // файловая система
     HybridFS fs;
 
+    // установить версию прошивки для отображения в меню
+    void setVersion(const char* ver) {
+        _f_ver = ver;
+    }
+
     // установить пароль на вебморду. Пустая строка "" чтобы отключить
     void setPass(Text pass) {
         _passh = pass.hash();
@@ -455,6 +462,7 @@ class SettingsBase {
     BuildCallback _build_cb = nullptr;
     UpdateCallback _upd_cb = nullptr;
     FocusCallback _focus_cb = nullptr;
+    const char* _f_ver = nullptr;
     String _title;
     Timer _focus_tmr;
     Timer _upd_tmr;
@@ -505,6 +513,8 @@ class SettingsBase {
             p[Code::uptime] = millis() / 1000;
             p[Code::mac] = getMac();
             p[Code::local_ip] = getIP().toString();
+            p[Code::s_ver] = SETTINGS_VER;
+            if (_f_ver) p[Code::f_ver] = _f_ver;
             if (custom.p) p[Code::custom_hash] = custom.hash;
             if (_title.length()) p[Code::title] = _title;
             if (_passh) p[Code::granted] = granted;

src/core/codes.h

@@ -91,6 +91,8 @@ enum class Code : uint8_t {
     mac,
     local_ip,
     spinner,
+    s_ver,
+    f_ver,
 };
 
 }

src/core/macro.h

@@ -0,0 +1,5 @@
+#pragma once
+
+#define SUB_BUILD_BEGIN [&]() {
+#define SUB_BUILD_END }();
+#define SUB_BUILD_NEXT SUB_BUILD_END SUB_BUILD_BEGIN