Вбудовані застосунки

Time

Вбудований застосунок Time пропонує широкі можливості налаштування. Майже все можна налаштувати через API, а більшість параметрів також можна змінити через застосунок SVITRIX3. Формат часу можна налаштувати відповідно до ваших уподобань. За замовчуванням встановлено HH:mm. Якщо обраний формат не вміщується на екрані, він автоматично повернеться до формату за замовчуванням. Ви можете помітити кілька ліній внизу екрана. Ці лінії позначають дні тижня, а поточний день підсвічується яскравіше. Також можна вимкнути цю панель днів тижня. Ви також можете налаштувати кольори іконки календаря, панелі днів тижня та кольору тексту за допомогою SettingsAPI або мобільного застосунку.

Параметр TMODE визначає макет і стиль застосунку Time.

TMODE=0 Відображає час разом із панеллю днів тижня внизу екрана.

TMODE=1 Показує час із панеллю днів тижня внизу та блоком календаря, який виділяє поточний день місяця.

TMODE=2 Аналогічно до TMODE=1, але панель днів тижня розміщується вгорі.

TMODE=3 Відображає час із панеллю днів тижня внизу та іншою іконкою календаря.

TMODE=4 Аналогічно до TMODE=3, але панель днів тижня розміщується вгорі.

TMODE=5 Режим "великого часу", що використовує великий шрифт для відображення часу. Якщо у кореневому каталозі є GIF-файл 32x8 з назвою bigtime.gif, він буде програватися на фоні. Зверніть увагу: коли GIF відображається в режимі BigTime, його неможливо безпосередньо замінити, оскільки файл використовується. Щоб замінити іконку, спочатку переключіть режим на TMODE, і тоді ви зможете оновити GIF. Якщо GIF не знайдено, використовується глобальний колір тексту.

Тут можна знайти приклади GIF-файлів для bigtime.

TMODE=6 Відображає час у двійковому форматі: Верхній рядок показує години, середній рядок — хвилини, а нижній рядок — секунди. Кожен рядок має шість точок, де засвічені точки означають двійкову "1", а білі точки — двійковий "0". Щоб прочитати час, перетворіть засвічені точки в кожному рядку на десяткове число.

Доступні формати часу:

Format	Example	Description
`%H:%M:%S`	`13:30:45`	24-hour time with seconds
`%l:%M:%S`	`1:30:45`	12-hour time with seconds
`%H:%M`	`13:30`	24-hour time
`%H %M`	`13.30`	24-hour time with blinking colon
`%l:%M`	`1:30`	12-hour time
`%l %M`	`1:30`	12-hour time with blinking colon
`%l:%M %p`	`1:30 PM`	12-hour time with AM/PM indicator
`%l %M %p`	`1:30 PM`	12-hour time with blinking colon and AM/PM

Date

Застосунок Date показує поточну дату. Є кілька форматів дати 'DFORMAT', які можна обрати:

Доступні формати дати:

Format	Example	Description
`%d.%m.%y`	`16.04.22`	Day.Month.Year (short)
`%d.%m`	`16.04`	Day.Month
`%y-%m-%d`	`22-04-16`	Year-Month-Day
`%m-%d`	`04-16`	Month-Day
`%m/%d/%y`	`04/16/22`	Month/Day/Year
`%m/%d`	`04/16`	Month/Day
`%d/%m/%y`	`16/04/22`	Day/Month/Year
`%d/%m`	`16/04`	Day/Month
`%m-%d-%y`	`04-16-22`	Month-Day-Year

Temperature

Застосунок Temperature відображає поточні показання вбудованого датчика температури. Однак, через розташування датчика всередині корпусу, вимірювання можуть бути не зовсім точними. На показання температури можуть впливати такі фактори, як плата живлення, LED-матриця, яскравість, колір та кількість засвічених пікселів. Для точнішого вимірювання можна відкалібрувати температуру полем Компенсація (offset) цього ж застосунку у веб-інтерфейсі або ключем temp_offset у dev.json.

Humidity

Застосунок Humidity відображає поточні показання вбудованого датчика вологості. Однак, через розташування датчика всередині корпусу, вимірювання можуть бути не зовсім точними. На показання вологості можуть впливати такі фактори, як плата живлення, LED-матриця, яскравість, колір та кількість засвічених пікселів. Для точнішого вимірювання можна використати dev.json для калібрування вологості за допомогою ключа hum_offset.

Battery

Застосунок Battery відображає поточний рівень заряду вбудованого акумулятора з динамічною вертикальною піктограмою батареї: вона заповнюється знизу вгору пропорційно до заряду та змінює колір за рівнем (зелений ≥75%, жовтий 50–74%, помаранчевий 20–49%, червоний <20%). Через відмінності між партіями акумуляторів та деградацію недорогого акумулятора з часом може знадобитися ручне калібрування.

Використовуйте Status API для отримання показань bat_raw.
Відкрийте файл dev.json для налаштування значень min_battery та max_battery:
- min_battery: Введіть значення bat_raw, коли акумулятор розряджений.
- max_battery: Введіть значення bat_raw, коли акумулятор повністю заряджений.

Погодні застосунки

Погодні застосунки також є вбудованими (у прошивці), але потребують налаштування Weather API (ключ weatherapi.com + місцезнаходження) у Settings → Weather API. Після увімкнення вони беруть участь у тому самому циклі ротації, що й інші застосунки, і їх можна вільно впорядковувати (див. App Order у посібнику веб-інтерфейсу).

Застосунок	Опис
Outdoor Temp	Зовнішня температура. Налаштовуваний колір; враховує шкалу Цельсія/Фаренгейта.
Outdoor Humidity	Зовнішня відносна вологість (%). Налаштовуваний колір.
Pressure	Атмосферний тиск (mb/hPa). Налаштовуваний колір.
Air Quality (AQI)	Індекс якості повітря (US EPA, 1–6). Автоколір за рівнем (зелений → жовтий → помаранчевий → червоний) або фіксований колір. Коли перемикач автокольору увімкнено, колір рівня має пріоритет і перекриває будь-який фіксований колір чи колір елемента (нічний режим усе одно діє). Може також деталізувати забруднювачі, що вийшли за межі норми (див. нижче).
UV Index	Ультрафіолетовий індекс (0–11+). Автоколір за рівнем або фіксований колір. Коли перемикач автокольору увімкнено, колір рівня має пріоритет і перекриває будь-який фіксований колір чи колір елемента (нічний режим усе одно діє).

Кожен погодний застосунок має власну налаштовувану тривалість і вмикається окремо. Інтервал оновлення даних задається в розділі Weather API.

Деталізація забруднювачів (Air Quality)

Коли увімкнено опцію Show components (увімкнено за замовчуванням), після показу ICA:N застосунок по черзі відображає окремі забруднювачі, які самі по собі вийшли за межі здорового діапазону (рівень EU EAQI ≥ 4): PM2.5, PM10, O3, NO2, SO2 та CO. Вони показуються від найгіршого, не більше 3, і кожен малюється кольором власного рівня. Спрацьовування залежить від значення кожного забруднювача незалежно від загального індексу — тож забруднювач може з'явитися червоним, навіть коли загальний індекс помірний (напр., ICA:2, але O3 червоний).

Час показу кожного забруднювача налаштовується через Seconds per component (2–10 с, за замовчуванням 3). Уся послідовність (індекс + позначені забруднювачі) відтворюється в межах однієї появи застосунку; його час на екрані автоматично подовжується, щоб усе вмістилося.

Ці опції розташовані в Apps → AirQuality (розгорніть елемент у списку ротації): Auto color, Show components та поле секунд.

TIP

Якщо оновлення погоди не вдалося (напр., нестабільний інтернет), на екрані залишається останнє зчитане значення замість --, і повтор відбувається автоматично приблизно через 1 хвилину. Індикатор WiFi (верхній лівий кут) блимає червоним, поки завантаження не вдаються.

Місяць

Застосунок «Місяць» показує поточну фазу Місяця за допомогою одного з 8 дизайнерських растрових іконок фаз (набір LaMetric), по одній на кожну фазу Місяця (новий → повний → спадний), намальованого на тлі мерехтливих синіх зірок. Кути диска прозорі, тож зірки видно навколо нього, а в південній півкулі іконка віддзеркалюється.

Поряд із Місяцем по черзі відображаються до трьох налаштовуваних показників:

Назва фази (показується іспанською, напр. "Cuarto creciente", "Llena")
Вік Місяця у днях
Відсоток освітленості

Налаштовується в Apps → Moon (розгорніть елемент у ротації):

Параметр	Опис
Півкуля	Північна або Південна — віддзеркалює освітлений край Місяця.
Показувати назву фази / вік / %	Вмикає або вимикає кожен показник тексту.

Якщо вимкнути всі три показники, відображається лише Місяць — по центру екрана, а сині зірки заповнюють усю ширину.

Тривалість і колір тексту задаються для кожного елемента ротації, як і в інших застосунках. Фаза обчислюється астрономічно (на основі UTC), тож інтернет не потрібен.

Custom Apps

Окрім вбудованих застосунків, SVITRIX розроблений для безперешкодної інтеграції з вашою екосистемою розумного дому. Додаткові застосунки можна створювати за допомогою MQTT або HTTP-запитів.

WARNING

У SVITRIX термін 'Custom Apps' не означає традиційні застосунки для смартфонів, які ви завантажуєте та встановлюєте. Натомість CustomApps у SVITRIX функціонують як динамічні сторінки, які чергуються в циклі відображення Apploop на дисплеї. Ці сторінки не зберігають і не виконують власну логіку; вони лише відображають контент, надісланий із зовнішньої системи, наприклад, розумного дому. Цей контент має передаватися за допомогою протоколів MQTT або HTTP через CustomApp API. Важливо зазначити, що вся логіка керування контентом, який відображається в цих CustomApps, має оброблятися вашою зовнішньою системою. SVITRIX лише надає платформу для відображення інформації. Ви маєте можливість оновлювати контент на ваших CustomApps у реальному часі в будь-який момент, що робить його універсальним інструментом для відображення персоналізованої інформації у вашому розумному домі.

Такий підхід має численні переваги:

Персоналізація: Налаштуйте кожен застосунок відповідно до ваших уподобань та потреб.
Гнучкість: Розробляйте власні застосунки без необхідності модифікувати прошивку.
Ефективне використання ресурсів: Економте цінну flash-пам'ять на модулі ESP.
Адаптивність: Немає потреби переписувати прошивку, якщо API зазнав змін.

Можна використовувати будь-яку систему, яка здатна формувати JSON-рядки та надсилати їх у MQTT-топік.

SVITRIX FLOWS

Це ваш основний ресурс для обміну та пошуку автоматизацій SVITRIX, також відомих як Custom Apps для різних сервісів. Покращуйте свій досвід роботи з SVITRIX, обмінюйтесь ідеями та надихайтесь. Давайте разом втілювати наші креативні автоматизації в життя! Реєстрація не потрібна ні для перегляду, ні для створення нових flows. Як автор, ви отримаєте посилання, за яким завжди зможете редагувати свій flow. Зберігайте його надійно! Ви можете завантажувати свої іконки до свого flow, а користувачі зможуть копіювати їх безпосередньо на свій SVITRIX одним натисканням! Нові flows регулярно модеруються. https://flows.svitrix.dev/

Приклад flow з Node-RED

Node-RED є ідеальним програмним рішенням для створення таких застосунків. Він доступний як окрема програма або як плагін для Home Assistant та ioBroker, що дозволяє ще більше розширити можливості вашої системи SVITRIX.

Ось демонстрація, натисніть трикутник, щоб розгорнути.

Приклад додавання застосунку Youtube як flow у NodeRED


[
  {
    "id": "2a59d30d07abe14f",
    "type": "group",
    "z": "54b42d8d.cda474",
    "style": {
      "stroke": "#999999",
      "stroke-opacity": "1",
      "fill": "none",
      "fill-opacity": "1",
      "label": true,
      "label-position": "nw",
      "color": "#a4a4a4"
    },
    "nodes": [
      "f0f17299.3736c",
      "dc7878f9.4756c8",
      "f234aae371d72680",
      "555bb8624b88c9c3",
      "69c388146e28049d",
      "a349ade5a57f7537"
    ],
    "x": 34,
    "y": 39,
    "w": 892,
    "h": 122
  },
  {
    "id": "f0f17299.3736c",
    "type": "inject",
    "z": "54b42d8d.cda474",
    "g": "2a59d30d07abe14f",
    "name": "",
    "props": [],
    "repeat": "3600",
    "crontab": "",
    "once": true,
    "onceDelay": 0.1,
    "topic": "",
    "x": 130,
    "y": 120,
    "wires": [
      [
        "a349ade5a57f7537"
      ]
    ]
  },
  {
    "id": "dc7878f9.4756c8",
    "type": "http request",
    "z": "54b42d8d.cda474",
    "g": "2a59d30d07abe14f",
    "name": "",
    "method": "GET",
    "ret": "obj",
    "paytoqs": "query",
    "url": "https://youtube.googleapis.com/youtube/v3/channels",
    "tls": "",
    "persist": false,
    "proxy": "",
    "insecureHTTPParser": false,
    "authType": "",
    "senderr": false,
    "headers": [],
    "x": 430,
    "y": 120,
    "wires": [
      [
        "f234aae371d72680"
      ]
    ]
  },
  {
    "id": "f234aae371d72680",
    "type": "function",
    "z": "54b42d8d.cda474",
    "g": "2a59d30d07abe14f",
    "name": "parser",
    "func": "var json = msg.payload;\nvar subscriberCount = json.items[0].statistics.subscriberCount;\n\nmsg.payload = { \"text\": subscriberCount, \"icon\": 5029};\nreturn msg;",
    "outputs": 1,
    "noerr": 0,
    "initialize": "",
    "finalize": "",
    "libs": [],
    "x": 590,
    "y": 120,
    "wires": [
      [
        "555bb8624b88c9c3"
      ]
    ]
  },
  {
    "id": "555bb8624b88c9c3",
    "type": "mqtt out",
    "z": "54b42d8d.cda474",
    "g": "2a59d30d07abe14f",
    "name": "",
    "topic": "ulanzi/custom/youtube",
    "qos": "",
    "retain": "",
    "respTopic": "",
    "contentType": "",
    "userProps": "",
    "correl": "",
    "expiry": "",
    "broker": "346df2a95aac5785",
    "x": 800,
    "y": 120,
    "wires": []
  },
  {
    "id": "69c388146e28049d",
    "type": "comment",
    "z": "54b42d8d.cda474",
    "g": "2a59d30d07abe14f",
    "name": "Youtube Follower",
    "info": "Just enter your channelID and Youtube API key in the \"Data\" node  and set your SVITRIX MQTT prefix.\nUses Icon 5029 (LM)",
    "x": 140,
    "y": 80,
    "wires": []
  },
  {
    "id": "a349ade5a57f7537",
    "type": "function",
    "z": "54b42d8d.cda474",
    "g": "2a59d30d07abe14f",
    "name": "Data",
    "func": "msg.payload = { \"id\": \"UCpGLALzRO0uaasWTsm9M99w\", \"key\": \"XXX\", \"part\":\"statistics\"}\nreturn msg;",
    "outputs": 1,
    "noerr": 0,
    "initialize": "",
    "finalize": "",
    "libs": [],
    "x": 270,
    "y": 120,
    "wires": [
      [
        "dc7878f9.4756c8"
      ]
    ]
  },
  {
    "id": "346df2a95aac5785",
    "type": "mqtt-broker",
    "name": "",
    "broker": "localhost",
    "port": "1883",
    "clientid": "",
    "autoConnect": true,
    "usetls": false,
    "protocolVersion": "4",
    "keepalive": "60",
    "cleansession": true,
    "birthTopic": "",
    "birthQos": "0",
    "birthPayload": "",
    "birthMsg": {},
    "closeTopic": "",
    "closeQos": "0",
    "closePayload": "",
    "closeMsg": {},
    "willTopic": "",
    "willQos": "0",
    "willPayload": "",
    "willMsg": {},
    "userProps": "",
    "sessionExpiry": ""
  }
]

Цей flow Node-RED отримує та відображає кількість підписників зазначеного YouTube-каналу на пристрої SVITRIX. Flow складається з наступних вузлів:

Inject: Цей вузол запускає flow періодично (кожну годину) або вручну.
Data (Function): Цей вузол містить ID YouTube-каналу та API-ключ YouTube. Замініть "XXX" на ваш API-ключ YouTube та ID каналу Youtube. Вузол формує payload з ID каналу, API-ключем та необхідною статистикою і надсилає його до вузла "HTTP request".
HTTP request: Цей вузол надсилає GET-запит до YouTube API для отримання статистики каналу. Відповідь повертається як JavaScript-об'єкт і передається до вузла "parser".
parser (Function): Цей вузол витягує кількість підписників з отриманої статистики каналу та формує payload з кількістю та іконкою (Icon 5029). Payload надсилається до вузла "MQTT out".
MQTT out: Цей вузол публікує payload у MQTT-топік "ulanzi/custom/youtube" на локальному MQTT-брокері. Вам також потрібно змінити топік у цьому вузлі відповідно до вашого MQTT-префіксу.
Comment (Youtube Follower): Цей вузол містить додаткову інформацію про flow. Він не впливає на функціональність flow.

Щоб використати цей flow, замініть "XXX" у вузлі "Data" на ваш API-ключ YouTube та переконайтеся, що налаштування MQTT-брокера у вузлі "MQTT out" правильні. Після цього flow отримуватиме кількість підписників зазначеного YouTube-каналу та відображатиме її на вашому пристрої SVITRIX разом з іконкою. Цей flow використовує іконку 5029 з LM (просто завантажте її з веб-інтерфейсу SVITRIX). Ви можете змінити іконку у flow на будь-яку іншу.

Вбудовані застосунки ​

Time ​

Доступні формати часу: ​

Date ​

Доступні формати дати: ​

Temperature ​

Humidity ​

Battery ​

Погодні застосунки ​

Деталізація забруднювачів (Air Quality) ​

Місяць ​

Custom Apps ​

SVITRIX FLOWS ​

Приклад flow з Node-RED ​