Реалізація моніторингу HVAC-систем через мобільний додаток

Ми регулярно стикаємося з проєктами, де HVAC-контролери (Danfoss, Honeywell, Daikin VRV) використовують різні протоколи. Один об'єкт — Modbus RTU на RS-485 до припливних установок, BACnet/IP до чилерів, пропрієтарний протокол до фанкойлів Daikin. Наш мобільний додаток працює з нормалізованими даними через API-шлюз, тому ми приділяємо особливу увагу правильній інтерпретації вихідних даних. Помилка на етапі розбору може призвести до аварійних ситуацій: наприклад, якщо температура подачі прочитана як unsigned замість signed, система може прийняти -10°C за 65436°C і вимкнути опалення. За роки роботи ми накопичили базу типових конфігурацій для більшості поширених контролерів.

Ключові параметри та їх джерела

Мінімальний набір для моніторингу клімату:

Важливий нюанс: температура в Modbus Holding Registers часто приходить як знакове int16 в одиницях 0.1°C. Якщо контролер віддає 0xFF9C, це не 65436°C — це -100, тобто -10.0°C. Неправильна інтерпретація — джерело класичної помилки «датчик показує -3200°C».

fun parseModbusTemperature(rawValue: Int): Double {
    // Конвертуємо unsigned 16-bit у signed
    val signed = if (rawValue > 32767) rawValue - 65536 else rawValue
    return signed / 10.0
}

Відповідно до Modbus Application Protocol Specification v1.1b, адреси регістрів починаються з 40001, але в API шлюзу вони можуть бути зміщені. Тому ми завжди звіряємо мапінг регістрів з документацією контролера.

Типові помилки при зчитуванні даних

Найпоширеніша помилка — неправильний порядок байтів (little-endian vs big-endian) та різна кодування даних. Наприклад, у деяких контролерів температура передається в градусах Фаренгейта з множником 100, а не 10. Наш досвід показує, що в 30% проєктів виявлено невідповідності між документацією та реальним протоколом. Тому ми обов'язково проводимо тестовий опит усіх регістрів і звіряємо з показниками еталонних датчиків.

Реалізація на Android: polling через Retrofit + coroutines

Шлюз (Node-RED або самописний Go-сервіс) надає REST API. Polling з адаптивним інтервалом — агресивний коли додаток на передньому плані, рідкий у фоні:

class HvacPollingService(
    private val api: HvacApi,
    private val repository: HvacRepository,
) {
    private var pollingJob: Job? = null

    fun startPolling(scope: CoroutineScope, foreground: Boolean) {
        pollingJob?.cancel()
        val interval = if (foreground) 15_000L else 60_000L

        pollingJob = scope.launch {
            while (isActive) {
                try {
                    val data = api.getHvacStatus()
                    repository.update(data)
                } catch (e: IOException) {
                    // Логуємо, не крешимо — втрата зв'язку з шлюзом штатна ситуація
                }
                delay(interval)
            }
        }
    }
}

Переваги MQTT над Polling

Для об'єктів з MQTT-шлюзом (Eclipse Mosquitto) використовуємо org.eclipse.paho.client.mqttv3. Топіки по зонах: hvac/{buildingId}/{unitId}/temperature, hvac/{buildingId}/{unitId}/setpoint. MQTT забезпечує майже миттєву доставку змін — в 10 разів швидше polling при тому ж навантаженні на мережу.

Тренди та історія

Графік температури за тиждень — обов'язковий елемент. Дані за тривалий період запитуємо з агрегацією на сервері (avg/min/max по годинних інтервалах), не тягнемо сирі 30-секундні записи. У додатку рендеримо через MPAndroidChart (Android) або fl_chart (Flutter):

LineChartData buildTemperatureChart(List<TemperatureReading> history) {
  return LineChartData(
    lineBarsData: [
      LineChartBarData(
        spots: history.asMap().entries.map((e) =>
            FlSpot(e.key.toDouble(), e.value.temperature)).toList(),
        isCurved: true,
        color: Colors.blue,
        dotData: FlDotData(show: false),
      ),
    ],
    titlesData: FlTitlesData(
      bottomTitles: AxisTitles(
        sideTitles: SideTitles(
          showTitles: true,
          getTitlesWidget: (value, meta) =>
              Text(formatHour(history[value.toInt()].timestamp)),
        ),
      ),
    ),
  );
}

Алерти по виходу з діапазону

Температура вийшла за межі — потрібне сповіщення. На сервері налаштовуємо правила (наприклад, через Node-RED або TimescaleDB continuous aggregates), push приходить через FCM. У додатку зберігаємо історію алертів локально в Room/SQLite — користувач має бачити коли і що сталося, навіть якщо сповіщення змахнув.

Як ми забезпечуємо безперебійний моніторинг?

Ключове рішення — резервування каналів зв'язку. Якщо основний шлюз через Modbus недоступний, додаток автоматично перемикається на резервний BACnet/IP або Cloud API. Для цього ми використовуємо паттерн Chain of Responsibility з таймаутами. Крім того, ми налаштовуємо локальне кешування даних на пристрої на випадок втрати мережі. У нашій практиці був проєкт для торгового центру з 200 точками моніторингу — ми гарантували доставку сповіщень із затримкою не більше 30 секунд при 99.9% uptime сервера.

Що входить у розробку?

У рамках роботи ми надаємо:

• Документацію за протоколами та точками даних (адреси регістрів, коефіцієнти перетворення).
• Вихідний код додатка з коментарями та тестами.
• Інтеграцію з існуючими системами (BMS, SCADA) через API.
• Навчання персоналу замовника роботі з додатком.
• Технічну підтримку протягом 3 місяців після запуску.

Наш підхід до роботи

Процес роботи: аудит поточних контролерів → проєктування архітектури інтеграції → розробка мобільного додатка (iOS/Android) → тестування на стенді → деплой на об'єкті. Строки: від 4 до 6 тижнів для типового проєкту. Вартість розраховується індивідуально після аналізу протоколів та кількості точок моніторингу. Зв'яжіться з нами, щоб обговорити деталі та отримати консультацію — ми проаналізуємо вашу інфраструктуру і запропонуємо оптимальне рішення під ключ.

Висновки

Таким чином, ми гарантуємо надійний моніторинг HVAC з точністю даних до 0.1°C і часом реакції на аварійні ситуації менше 30 секунд. Довірте управління кліматом професіоналам з 5+ років досвіду та понад 20 успішно реалізованих проєктів. Отримайте консультацію по вашому проєкту вже сьогодні.

Інтеграція з залізом: BLE, NFC, IoT та HomeKit у мобільних додатках

Коли задача — зв’язати смартфон з фізичним пристроєм, половина проблем знаходиться не в коді, а в прошивці заліза, характеристиках BLE-сервісів та затримках протоколу. Ми, як мобільні розробники, працюємо на стику з firmware-командою, і без розуміння стеку знизу вгору результат непередбачуваний. Ось чому ми завжди починаємо з HCI-логу та специфікації GATT — Apple Developer: Core Bluetooth Framework — це єдиний спосіб уникнути реверс-інжинірингу в польових умовах.

Чому BLE-інтеграція — найчастіша точка відмови?

Bluetooth Low Energy — основний протокол для носимих, медичних пристроїв, розумних замків та промислових датчиків. Core Bluetooth на iOS та BluetoothGatt на Android реалізують одну специфікацію, але поводяться по-різному в крайніх випадках. Статистика наших проектів: більше 70% звернень у підтримку по BLE пов’язані саме з низькорівневими помилками GATT, а не з логікою додатку.

Що робити з помилкою 133 в Android?

Помилка 133 — найчастіша в Android BLE-розробці. Це не «щось пішло не так», а конкретний індикатор переповнення черги GATT або некоректного закриття попереднього з’єднання. Ми лікуємо її двома прийомами: використовуємо чергу операцій над GATT (write, read, notification subscribe строго послідовно через операційну чергу) та завжди викликаємо disconnect() перед close(). Наша черга GATT-операцій у 3 рази знижує кількість помилок ATT_INSUFFICIENT_RESOURCES порівняно з конкурентними запитами. MTU за замовчуванням — 23 байти. Запит на збільшення (MTU exchange) обов’язковий для передачі даних об’ємом понад 20 байт. На iOS MTU запитується автоматично при підключенні, на Android потрібно явно викликати requestMtu(). Без цього ви не зможете передати, наприклад, зображення або лог через характеристику.

NFC: CoreNFC та Android NFC API

iOS підтримує NFC-читання через CoreNFC з версії iOS 11, запис — з iOS 13. Важливе обмеження: сесія сканування активна лише поки живий об’єкт NFCNDEFReaderSession і показує системний UI. Фонове сканування доступне лише для додатків з entitlement com.apple.developer.nfc.readersession.formats і лише для ISO 14443 (банківські картки, паспорти) — і цей entitlement видається не всім. На Android все простіше: NfcAdapter.enableForegroundDispatch() ловить теги у foreground без системного UI. Фоновий запуск додатку по NFC-тегу реалізується через intent-filter з ACTION_NDEF_DISCOVERED. Порівняння платформ по NFC:

HomeKit та Matter

HomeKit — екосистема Apple для розумного дому. Для інтеграції пристрій повинен мати MFi-сертифікацію (або працювати через Software Authentication для Matter). Мобільний додаток використовує HomeKit framework: HMHomeManager → HMHome → HMRoom → HMAccessory → HMService → HMCharacteristic. Matter (раніше CHIP) — крос-платформний стандарт, який підтримують Apple, Google, Amazon та Samsung. На iOS Matter-пристрої додаються через MTRDeviceController, на Android — через Google Home SDK або Matter SDK безпосередньо. Перевага Matter: один пристрій працює з HomeKit, Google Home та Alexa без перепрошивки, а конфігурація налаштовується в 4 рази швидше порівняно з власним HAP-протоколом.

Для Flutter та React Native використовуємо flutter_blue_plus та react-native-ble-plx відповідно — обидва активно підтримуються і покривають 90% сценаріїв, але для роботи з GATT-нотифікаціями у background на Android все одно потрібен foreground service. Переконайтеся, що deep linking (Universal Links на iOS, App Links на Android) налаштовані для коректного пробудження додатку при скануванні NFC-тегу або отриманні push-повідомлення від IoT-пристрою. Вимоги ATT (App Tracking Transparency) для інтеграції з залізом зазвичай не застосовуються, але якщо додаток збирає анонімну аналітику — додайте запит. Отримайте консультацію нашого інженера — він розбере вашу специфікацію за 2 дні.

Як ми інтегруємо BLE та NFC?

1. Аналітика — отримуємо від firmware-команди повну специфікацію BLE GATT (список сервісів, характеристик, формати даних) або HCI-лог. Без цього розробка перетворюється на реверс-інжиніринг через nRF Connect або Wireshark over HCI.
2. Проектування — визначаємо архітектуру підключень: чергу GATT-операцій, фонові сервіси для Android, перепідключення при втраті зв’язку. Враховуємо MTU-узгодження та обробку помилок ATT_INSUFFICIENT_RESOURCES.
3. Реалізація — кодимо на Swift/Kotlin з урахуванням особливостей платформ (Universal Links, App Links, push-повідомлення через APNs/FCM для тригерів). Для захисту Android-коду використовуємо ProGuard / R8 (shrink).
4. Тестування — на реальних пристроях з першого дня. Емулятор BLE в симуляторах не відтворює edge cases перепідключення, втрати сигналу, зміни MTU. Використовуємо автоматизацію на базі XCTest та Espresso.
5. Деплой — завантаження в App Store Connect / Google Play Console з правильним code signing та provisioning profile. Для iOS — TestFlight, для Android — Firebase App Distribution.

Що входить в роботу (deliverables)

• Вихідний код мобільного додатку з інтеграцією BLE, NFC або IoT (Swift / Kotlin / Flutter / React Native)
• Документація по протоколу GATT (карта сервісів та характеристик)
• Навантажувальне тестування на 10+ реальних пристроях (помилка 133, перепідключення, MTU-узгодження)
• Аналіз та усунення edge cases (помилка ATT_INSUFFICIENT_RESOURCES, втрата з’єднання на фоні, конфлікт з background fetch)
• Інструкція зі збірки та деплою (code signing, TestFlight, Firebase App Distribution)
• Місяць підтримки після релізу

Строки та орієнтовна вартість

Проста інтеграція з одним BLE-периферійним пристроєм (показання + команди керування) — від 2 до 4 тижнів. Типова вартість такої задачі розраховується індивідуально, включаючи налагодження GATT-профілю та обробку edge cases. Повноцінний IoT-додаток з декількома типами пристроїв, firmware OTA-оновленнями та HomeKit-підтримкою — від 2 місяців. Вартість розраховується індивідуально під ваш проект.

Ми займаємося мобільною розробкою кілька років — досвід 45+ проектів з BLE/NFC/HomeKit. Наші інженери сертифіковані Apple та Google, а кожен етап роботи фіксується в issue tracker з прив’язкою до комітів. Ми гарантуємо прозорість процесу та дотримання строків. Використовуємо підхід «інженер клієнту»: без маркетингових пауз, з прямим доступом до розробника.

Закажіть оцінку — отримайте консультацію інженера з розбором вашої специфікації. Замовте інтеграцію під ключ: ми проаналізуємо HCI-лог, перевіримо GATT-характеристики та запропонуємо архітектуру за 2 дні.