Мобільний додаток для IoT provisioning (налаштування пристроїв)

Клієнт приходить з ESP32 і хоче, щоб користувачі налаштовували його через мобільний додаток. Через два тижні з'ясовуємо, що BLE-provisioning не працює на iOS через невідповідність App Store Review Guidelines — Section 4.2 вимагає, щоб додаток працював без зовнішнього пристрою. Таке трапляється в кожному третьому проекті. Ми розробляємо мобільні додатки для IoT provisioning під ключ: від вибору протоколу до публікації в сторах. За 5+ років ми накопичили досвід вирішення таких задач: понад 100 проектів, включаючи складні кейси з мультивендорною підтримкою. Важливо не просто передати Wi-Fi пароль, а зробити це надійно та зручно для користувача — інакше конверсія просяде, а в сторах відхилять.

Що таке IoT Provisioning технічно

Пристрій «з коробки» не знає Wi-Fi пароль і не прив'язаний до облікового запису. Потрібно передати:

• Мережеві credentials (SSID + password)
• Ідентифікатор власника (user_id або token з платформи)
• Початкову конфігурацію (часовий пояс, ім'я пристрою, endpoint сервера)

Технічно це робиться через BLE, Wi-Fi Soft AP, комбо BLE+SoftAP або QR-код. Вибір методу залежить від заліза. Наприклад, Bluetooth Low Energy — стандарт для більшості IoT-модулів, але вимагає правильної реалізації GATT-сервера.

Як вибрати метод передачі credentials: BLE, Soft AP чи QR?

Якщо пристрій на ESP32 — можна будь-який. nRF52 — тільки BLE. RTL8710 — тільки Wi-Fi. Для B2C-пристроїв краще BLE або QR: користувач не перемикає мережі. SoftAP виправданий для промислового обладнання, де важлива надійність з'єднання.

З практики: в проекті з датчиками температури (nRF52) наш клієнт вибрав BLE — provisioning займає 15 секунд, конверсія 92%. Конкуренти використовували SoftAP — 30% користувачів кидали через зміну мережі на Android. Економія часу на підтримку склала близько 40%.

ESP-IDF Provisioning: практичний кейс

Espressif надає готовий esp_prov компонент на стороні прошивки та офіційні SDK. Ми використовували їх в проекті для ESP32-S3. Флоу через BLE з Android SDK:

ESPProvisionManager.getInstance(context).searchBleEspDevices("PROV_") { devices, error ->
    // devices — знайдені пристрої з префіксом PROV_
    val device = devices?.firstOrNull() ?: return@searchBleEspDevices
    device.connectBLEDevice(bleScanResult) { session ->
        device.provision(ssid, passphrase) { status ->
            when (status) {
                ProvisioningStatus.SUCCESS -> onProvisioned()
                ProvisioningStatus.FAILURE -> onFailed(status.error)
                ProvisioningStatus.CONFIG_SENT -> updateProgress(50)
            }
        }
    }
}

Під капотом SDK встановлює зашифровану сесію через Session Security (протокол sec1 — Curve25519 + AES-CTR), передає Wi-Fi credentials через protocomm layer. Протокол Protobuf — бінарний, компактний. На iOS використовуємо ESPProvision через Swift Package Manager.

Типова проблема: searchBleEspDevices не знаходить пристрій — воно вже пройшло provisioning і не рекламує сервіси. Рішення — кнопка «скидання до заводських» в інструкції.

Як налаштувати Wi-Fi Provisioning через Soft AP на Android?

Пристрій піднімає точку PROV_XXXXXX. Телефон має підключитися — це нетривіально, система може вирішити, що мережа «без інтернету», і переключитися назад на стільникові дані. На Android 10+ використовуємо WifiNetworkSpecifier:

val specifier = WifiNetworkSpecifier.Builder()
    .setSsid("PROV_${deviceSuffix}")
    .setWpa2Passphrase(apPassword)
    .build()
val request = NetworkRequest.Builder()
    .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
    .setNetworkSpecifier(specifier)
    .build()
connectivityManager.requestNetwork(request, object : ConnectivityManager.NetworkCallback() {
    override fun onAvailable(network: Network) {
        // Всі HTTP-запити до пристрою через цей network
        val client = OkHttpClient.Builder()
            .socketFactory(network.socketFactory)
            .build()
        sendProvisioningData(client)
    }
})

Без network.socketFactory запити підуть через стільникову мережу — з'єднання не встановиться. На iOS SoftAP не підтримується, тому для крос-платформених проектів вибираємо BLE.

Чому користувачі не можуть підключитися: часті помилки та рішення

• 2.4 vs 5 ГГц: пристрій підтримує тільки 2.4 ГГц, користувач вводить пароль від 5 ГГц мережі. Детектуємо через WifiManager.scanResults — перевіряємо частоту SSID. На Android 30+ потрібен ACCESS_FINE_LOCATION або NEARBY_WIFI_DEVICES.
• BLE не знаходить пристрій: пристрій вже налаштовано або не в режимі provisioning. Додаємо в інтерфейс перевірку стану та кнопку скидання.
• Таймаут підключення: на кожну стадію (пошук, відправка credentials, підключення до Wi-Fi) ставимо таймаут 30 секунд. При помилці — чітке повідомлення та варіанти дій.

Процес розробки: від аналітики до релізу

1. Аналітика: вибір методу, заліза, протоколу. Перевірка вимог App Store (Section 4.2) та Google Play.
2. Проектування: архітектура, дизайн UX (3-4 кроки), прототипи.
3. Реалізація: інтеграція SDK, кастомний flow, обробка помилок.
4. Тестування: реальні пристрої, сценарії з різними мережами, час роботи.
5. Деплой: публікація в сторах, налаштування code signing, push-сповіщення.

Що входить в роботу

• Вихідний код додатку (iOS/Android) з інтеграцією provisioning.
• Документація з налаштування та експлуатації.
• Допомога в публікації в App Store та Google Play.
• Навчання команди замовника (2 години онлайн).
• Підтримка протягом 1 місяця після релізу.

Строки та як ми працюємо

Provisioning через один канал (BLE або SoftAP) з Espressif SDK — від 2 тижнів. Кастомний протокол, мультивендорна підтримка, повний flow з реєстрацією — 5-8 тижнів. 5+ років досвіду в IoT, 100+ проектів. Зв'яжіться з нами для оцінки вашого проекту — ми допоможемо вибрати оптимальний метод і спроектуємо рішення під ваші завдання. Отримайте консультацію по вашому кейсу безкоштовно.

Інтеграція з залізом: 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 дні.