Мобильное приложение для 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 или Soft AP) с 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) для интеграции с железом обычно не применяются, но если приложение собирает анонимную аналитику — добавьте запрос.

Как мы интегрируем 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 недель. Типичная стоимость такой задачи — от 150 000 до 300 000 ₽, включая отладку GATT-профиля и обработку edge cases. Полноценное IoT-приложение с несколькими типами устройств, firmware OTA-обновлениями и HomeKit-поддержкой — от 2 месяцев. Стоимость рассчитывается индивидуально под ваш проект.

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

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