English

Автоматизація інвертора

Пристрій сам стежить за батареєю, мережею, погодою і може писати в Telegram або змінювати режим інвертора. Правила — короткий скрипт (схожий на спрощений JavaScript). Файл на пристрої: /automation.js, до 6 КБ.

Перевірка йде кожні ~1.5 с, починаючи з 20-ї секунди після старту.

1. З чого почати

1. Відкрийте сторінку Автоматизація.
2. Вкладка Script — повний текст. Visual — прості картки.
3. Натисніть Check — пристрій перевірить синтаксис без Telegram, HTTP і записів в інвертор (стан edge/at теж не змінюється).
4. Якщо OK — Зберегти.

fn setup() {
}

fn tick() {
  if (edge(pid(100) < 50)) {
    tg("Мережа пропала, батарея [pid110]%");
  }
}

pid(100) — напруга мережі. [pid110] у тексті заміниться на заряд батареї. Так можна підставляти будь-який PID.

2. Дві вкладки: Visual і Script

Це один і той самий файл. Міняєте в одній вкладці — бачите в іншій після збереження / перемикання.

Visual — прості картки

Картка = одне просте правило: «коли … тоді зробити …». У списку видно назву і вмикач. Клік по назві відкриває одну картку.

У картці можна:

• обрати коли (один раз при зміні, кожні N секунд, рівно о годині, …);
• додати умови по PID (батарея < 30, мережа пропала, …);
• додати дії: Telegram, встановити параметр, журнал, HTTP.

  // @vis Мережа пропала
  if (edge(pid(100) < 50)) { tg("Мережа пропала"); }
  // @endvis

Під картками — «Показники на головній» (expose). Шаблони внизу — готові типові сценарії.

Script — повна мова

Тут живуть змінні, свої функції, if / else, нічний тариф із двома гілками. Visual цей код не затирає.

3. Скелет скрипта

// Коментар до кінця рядка. Пристрій його ігнорує.

let min_soc = 25;          // глобальна змінна (пам'ять між циклами)

fn setup() {               // один раз після збереження або ребута
  expose(800, "Поріг", "%");
  set(800, min_soc);
}

fn tick() {                // кожні ~1.5 секунди
  set(800, min_soc);

  if (pid(110) < min_soc && every(600)) {
    tg("Батарея [pid110]%");
  }
}

• fn setup() — старт: показати значення на головній, початкові set.
• fn tick() — робоче серце. Усі «якщо батарея…» пишіть сюди.
• let — тільки зверху, не всередині функції. Ім’я до 11 латинських символів: min_soc ок, night_min_soc — занадто довге.
• Після кожного виклику і присвоєння ставте ;.
• У if і else завжди фігурні дужки { } (у else if дужки має сам if). Без них Check скаже помилку.
• Повний рядок, що починається з //, пристрій викидає з робочої копії (маркери @vis теж). Коментар в кінці робочого рядка лишається і ігнорується парсером.

Циклів for / while немає навмисно: скрипт завжди закінчується і не може «зависнути».

4. Коли спрацьовує правило

Найчастіша помилка новачка: написати if (pid(110) < 30) { tg("..."); } — і Telegram сипле кожні 1.5 с. Оберіть тип спрацювання:

if (edge(pid(100) < 50)) { tg("Мережа пропала"); }

if (edge(pid(100) < 50)) { tg("Мережа пропала, SOC [pid110]%"); }
if (edge(pid(100) > 50)) { tg("Мережа [pid100]V"); }
if (pid(110) < 25 && every(600)) { tg("Низький SOC [pid110]%"); }
if (pid(509) > 40 && every(1800)) { tg("Спека [pid509]°C"); }

5. Умови: if, else, кілька рівнів

Порівняння як у школі: > < >= <= == !=. Логіка: && (і), || (або), ! (не). Дужки ( ) — щоб не плутати порядок.

Можна мішати PID між собою: pid(106) - pid(117) > 1500 (надлишок сонця).

Один рівень

if (pid(110) < 20) {
  set(800, 1);
} else {
  set(800, 0);
}

set(800, …) на expose-змінну головної безпечний кожен цикл (це RAM, не команда інвертору). Для pid132 так робити не варто.

Кілька рівнів (else if)

Мова розуміє else if. Гілки перевіряються зверху вниз, спрацює перша правдива.

if (pid(110) < 15) {
  set(800, 1);
} else if (pid(110) < 30) {
  set(800, 2);
} else if (pid(110) > 90) {
  set(800, 3);
} else {
  set(800, 0);
}

Вкладений if всередині if

if (at("23:00")) {
  if (pid(513) >= 3000 && pid(110) >= 25) {
    set(132, 2);
  } else {
    set(132, 1);
    set(131, 2);
    tg("Нічний заряд, завтра [pid513]");
  }
}

Короткий запис без if

умова ? якщо_так : якщо_ні

let flag = 0;          // зверху файлу, не всередині fn
fn tick() {
  flag = pid(509) > 40 ? 1 : 0;
  if (edge(flag == 1)) { tg("Спека [pid509]°C"); }
}

6. Дії

У фігурних дужках можна кілька рядків — виконаються підряд.

if (at("07:00")) { set(132, 2); }

if (pid(513) < 1000 && at("23:00")) {
  set(132, 1);
  set(138, 4);
  tg("Нічний заряд, завтра [pid513] Wh/m², SOC [pid110]%");
  log("night charge");
}

7. Час доби

Годинник пристрою (NTP). now() — число ГГХХ: 7:30 → 730, 23:00 → 2300.

if ((dow() == 0 || dow() == 6) && at("10:00")) {
  tg("Вихідний, SOC [pid110]%");
}

Не розбирайте pid611 у скрипті — для умов є now / at / between. Після ребута почекайте синхронізацію часу (або pid(608) > 2 — аптайм у хвилинах).

8. Змінні, expose, свої функції

Змінні

До 16 штук. Живуть між циклами tick, скидаються при ребуті й при збереженні скрипта. На флеш самі не пишуться.

let peak = 0;

fn tick() {
  peak = max(peak, pid(106));
  if (at("23:50")) { peak = 0; }
}

Показник на головній — expose

Номер PID 800–807 (або вільний). Не потрапляє в графіки дня.

fn setup() {
  expose(800, "Пік PV", "W");
}
fn tick() {
  set(800, peak);
}

У Visual те саме — блок під картками.

Свої функції

Разом до 8 функцій, рахуючи setup і tick (тобто до 6 своїх). Без параметрів, ім’я до 11 символів. return — результат.

fn excess() {
  return pid(106) - pid(117);
}

fn tick() {
  if (edge(held(excess() > 1500 && pid(110) > 80, 300))) {
    set(1000, 1);
  }
}

return; всередині tick — решта правил цього циклу не виконається.

9. Довідник функцій

Також: + - * / %, порівняння, && || !, ?:. == з допуском 0.001 (25 і 25.0005 вважаються рівними).

10. Готові рецепти

if (edge(pid(100) < 50)) {
  tg("Мережа пропала! Батарея [pid110]% ([pid109]V)");
}
if (edge(pid(100) > 50)) {
  tg("Мережа [pid100]V");
}

if (edge(between("22:00", "06:00") && pid(110) > 60)) {
  set(132, 2);
  tg("Ніч, батарея [pid110]%");
}

if (edge(held(pid(106) - pid(117) > 1500 && pid(110) > 80, 300))) {
  set(1000, 1);
}
if (edge(pid(110) < 40 || pid(106) < 500)) {
  set(1000, 0);
}

if (at("18:00")) { set(704, 1); }
if (at("22:00")) { set(704, 0); }

let sun_ok = 3000;
let min_soc = 25;
let grid_a = 4;

fn tick() {
  if (at("23:00")) {
    if (pid(513) >= sun_ok && pid(110) >= min_soc) {
      set(131, 3);
      set(132, 2);
    } else {
      set(132, 1);
      set(131, 2);
      set(138, grid_a);
      tg("Нічний заряд. Завтра [pid513], SOC [pid110]%");
    }
  }
  if (at("07:00")) {
    set(132, 2);
    set(131, 1);
  }
}

11. Обмеження і типові помилки

• Скрипт ≤ 6144 байти. 16 × let, 8 × fn (разом із setup/tick), 8 × expose, 8 × avg, 24 «слоти» для edge/every/held/at.
• Імена лише латиниця, цифри, _, до 11 символів.
• Немає масивів і рядкових змінних. Текст — лише в лапках у tg/log/http/at/…
• За один tick: 1 × Telegram, 1 × HTTP, 3 × log. Якщо кілька tg в одному циклі — піде лише перший.
• Кожен виклик edge/at — окреме місце в тексті. Не копіюйте «той самий» виклик двічі, думаючи що це один лічильник.

Повний список параметрів — кнопка Список PID на сторінці автоматизації. GPIO 7xx, Tasmota 1000+, BMS 9xx — як у вашій таблиці.

12. Міграція зі старого JSON

Якщо є /automation_PARAMS.json, а /automation.js ще немає — пристрій сам конвертує правила (без інтернету). JSON лишається копією. Старі правила стають картками з @vis.

Прошивка 4.24+. Check → Зберегти. Складне — у Script без карток; просте — у Visual з @vis.