upd

Author: GyverLibs

docs/4.widgets.md

@@ -83,8 +83,10 @@ logger.println(sets::Logger::warn() + "warn text");
 logger.println(sets::Logger::error() + "error text");
 ```
 
-### Таблица
-Передаётся в формате CSV текстом или как путь к файлу на флешке. CSV горизонтальный разделитель `;`, вертикальный `\n`. Внутри ячеек использование разделителей не допускается.
+### TableCSV
+Передаётся в формате CSV строкой или как путь к файлу с расширением `.csv` на флешке. CSV - горизонтальный разделитель `;`, вертикальный `\n`. Внутри ячеек использование разделителей не допускается.
+
+Начиная с версии 1.3.6 умеет отрисовывать бинарные таблицы [Table](https://github.com/GyverLibs/Table) с расширением `.tbl`.
 
 ### LinearGauge
 Линейная шкала с заполнением, обновляется через апдейт.
@@ -94,6 +96,9 @@ logger.println(sets::Logger::error() + "error text");
 - Все могут обновляться в реальном времени
 - Названия осей передаются в виде списка с разделителем `;` - `"axis 1;test;test 2"`
 - Единицы измерения для графиков-линий опционально добавляются в конце названия оси в квадратных скобках - `"Value;Temp[°C];USD[ $]"`
+- Виджеты графиков поддерживают загрузку данных напрямую из файла с таблицей в формате:
+  - Текстовая CSV таблица (разделитель столбцов `;`, строк - `\n`) с расширением `.csv`
+  - Бинарная таблица из библиотеки [Table](https://github.com/GyverLibs/Table) с расширением `.tbl`
 
 > [!TIP]
 > Если график хранится в файле бинарной таблицы с расширением `.tbl`, то при скачивании его из файлового менеджера он будет конвертирован в читаемый `.csv`
@@ -129,9 +134,7 @@ sett.updater().updatePlot(H(stack), (const float[]){random(100), random(100), ra
 ```
 
 ### Plot
-График с линиями. Работает с таблицами в текстовом формате .csv (разделение `;` или `,`), а также с бинарными таблицами [Table](https://github.com/GyverLibs/Table).
-
-Первый столбец таблицы - unix-время, остальные - значения осей:
+График с линиями. Первый столбец таблицы - unix-время, остальные - значения осей:
 
 ```cpp
 время   значения...
@@ -150,9 +153,7 @@ b.Plot(H(plot2), "/table.csv");
 ```
 
 ### PlotTimeline
-График с состояниями осей вкл/выкл в виде блоков. Работает с таблицами в текстовом формате .csv (разделение `;` или `,`), а также с бинарными таблицами [Table](https://github.com/GyverLibs/Table).
-
-Первый столбец таблицы - unix-время, остальные - значения осей, есть три формата данных:
+График с состояниями осей вкл/выкл в виде блоков. Первый столбец таблицы - unix-время, остальные - значения осей. Есть три формата данных:
 
 1. Режим `sets::TMode::All`, **остальные** столбцы - состояния (1 или 0) всех осей по одному в столбце:
 
@@ -187,19 +188,40 @@ b.PlotTimeline("/tline_mask.csv", sets::TMode::Mask, "1;2;3;4");
 b.PlotTimeline("/tline_per.csv", sets::TMode::Single, "1;2;3;4");
 ```
 
-### Table
-Использовать `Table` очень просто:
+#### Table
+`Table` - класс для удобного создания и редактирования динамических таблиц со столбцами разных типов. Использовать очень просто:
 
 ```cpp
-// таблица с временем и двумя float столбцами
+// таблица с временем и двумя float столбцами (3 столбца, 0 строк)
 Table t(0, 3, cell_t::Uint32, cell_t::Float, cell_t::Float);
 
+// прибавить строки
 t.append(unix1, random(100), random(100));
 t.append(unix2, random(100), random(100));
 ```
 
 И теперь её можно отправлять.
 
+#### TableFileStatic
+Для ведения долгосрочных логов и построения графика гораздо интереснее использовать `TableFileStatic` - эта таблица хранится в файле и не загружается в оперативную память, что позволяет не ограничивать её размер объёмом оперативки и хранить большие объёмы данных (сотни килобайт), а виджет в свою очередь просто скачивает файл. Этот тип таблиц позволяет прибавлять к себе новые строки, сохраняя настроенный лимит на количество строк, например хранить данные о температуре за последние 3 месяца (чтобы файл не увеличивался до бесконечности).
+
+```cpp
+void build(sets::Builder& b) {
+    b.Plot(H(plot1), "/file_plot1.tbl");
+}
+
+// условно вызывается каждую минуту
+void everyMinute() {
+    TableFileStatic t(&LittleFS, "/file_plot1.tbl", 100);   // макс. 100 строк, будет смещаться при append()
+
+    // инициализация, должна быть вызвана хотя бы один раз после непосредственного создания файла
+    t.init(3, cell_t::Uint32, cell_t::Float, cell_t::Int8);
+
+    // добавление в файл
+    t.append(sett.rtc.getUnix(), (random(100) - 50) / 2.0, random(-100, 100));
+}
+```
+
 ## Активные виджеты
 ### Input
 Ввод текста. Поддерживает регулярные выражения и комментарий при ошибке ввода:

examples/plot_file/plot_file.ino

@@ -53,7 +53,7 @@ void loop() {
             tmr = millis();
 
             // ===== бинарная таблица =====
-            TableFileStatic t(&LittleFS, "/file_plot1.tbl");
+            TableFileStatic t(&LittleFS, "/file_plot1.tbl", 100);   // макс. 100 строк, будет смещаться при append()
 
             // инициализация, должна быть вызвана хотя бы один раз после непосредственного создания файла
             t.init(3, cell_t::Uint32, cell_t::Float, cell_t::Int8);

library.properties

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