Представьте: пользователь включает новое IoT-устройство, но не может его настроить, потому что приложение не видит устройство на Android 12. Ошибка в WifiNetworkSpecifier — и на поддержку уходит час. Такие кейсы — наша рутина. Wi-Fi Provisioning — передача сетевых credentials (SSID, пароль) от мобильного приложения к IoT-устройству, которое ещё не знает, к какой сети подключаться. Звучит просто, но Android-фрагментация, отличия в поведении ConnectivityManager между версиями и особенности конкретных чипов делают это нетривиальной задачей. Например, на Android 10+ необходимо явно указывать removeCapability(NET_CAPABILITY_INTERNET), иначе система не разрешит подключение к SoftAP без интернета. Мы решаем эту задачу под ключ, опираясь на 5+ лет опыта в IoT-разработке и 20+ реализованных проектов. Это снижает затраты на поддержку и уменьшает бюджет на отладку. Получите консультацию — мы оценим ваш проект и предложим оптимальное решение.
Методы Wi-Fi Provisioning: сравнение
| Метод | Принцип | Надёжность | Лучше применять |
|---|---|---|---|
| Soft AP | Устройство создаёт Wi-Fi точку, телефон подключается и передаёт данные через HTTP/UDP | Высокая на Android 9, средняя на 10+ (требуется WifiNetworkSpecifier) |
Универсальный вариант, когда нет BLE |
| SmartConfig / EZ Connect | Телефон отправляет credentials зашифрованными UDP-пакетами широковещательно | Низкая при AP-изоляции, на 5 ГГц не работает | Простая настройка дома, не для B2B |
| BLE + Wi-Fi комбо | BLE передаёт credentials, Wi-Fi включается после | Наивысшая, не требует переключения сети | Всегда, когда устройство имеет BLE |
| QR-код с credentials | Credentials зашиты в QR на производстве | Высокая | Enterprise-деплой, единичные устройства |
Soft AP надёжнее SmartConfig в 2–3 раза, но уступает BLE-комбо по UX.
Как правильно выбрать метод Provisioning?
Выбор зависит от:
- Наличия BLE на устройстве (если есть — делайте BLE-комбо)
- Целевой аудитории (потребительский или корпоративный сегмент)
- Требований к безопасности (при BLE можно использовать шифрование на уровне соединения)
Для B2B-устройств мы всегда рекомендуем BLE-комбо или SoftAP, так как SmartConfig блокируется корпоративными роутерами в 95% случаев. В любом случае, мы проектируем мультиметодный подход с fallback.
Soft AP Provisioning на Android 10+: детали реализации
Основная сложность — явное привязывание HTTP-запросов к нужной сети. Без этого OkHttp использует дефолтный маршрут (мобильные данные):
val specifier = WifiNetworkSpecifier.Builder() .setSsid("MyDevice_AP") .setWpa2Passphrase("provisioning_key") .build() val request = NetworkRequest.Builder() .addTransportType(NetworkCapabilities.TRANSPORT_WIFI) .addCapability(NetworkCapabilities.NET_CAPABILITY_NOT_RESTRICTED) .removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET) .setNetworkSpecifier(specifier) .build() val callback = object : ConnectivityManager.NetworkCallback() { override fun onAvailable(network: Network) { val client = OkHttpClient.Builder() .socketFactory(network.socketFactory) .dns { hostname -> network.getAllByName(hostname).toList() } .build() postWifiCredentials(client, ssid, password) } override fun onUnavailable() { onProvisioningFailed("Не удалось подключиться к устройству") } } connectivityManager.requestNetwork(request, callback, 30_000) // 30 сек таймаут removeCapability(NET_CAPABILITY_INTERNET) — критично. Без этого Android 10 отклонит запрос на подключение к AP без интернета.
На Android 9 и ниже — WifiManager.enableNetwork() + WifiManager.disconnect(). API устарел, но работает.
ESP-IDF SoftAP Provisioning: официальный подход
Для Espressif устройств — esp_wifi_prov_mgr компонент + официальный provisioning-android SDK от Espressif (документация ESP-IDF):
val wifiProvisioningManager = ESPProvisionManager.getInstance(context) val device = wifiProvisioningManager.createESPDevice( ESPConstants.TransportType.TRANSPORT_SOFTAP, ESPConstants.SecurityType.SECURITY_1 ) device.connectWiFiDevice { isConnected -> if (isConnected) { device.scanNetworks { networks, _ -> // Показать список сетей пользователю } } } SDK шифрует transport через sec1 (Curve25519 key exchange). Сканирование сетей через устройство — ценная фича: устройство само сканирует окружение и возвращает список, снижая ошибки ввода.
Когда SmartConfig работает, а когда нет?
Ti SmartConfig и Espressif ESP-TOUCH работают только если:
- Роутер не включил AP-изоляцию клиентов
- Телефон подключён к 2.4 ГГц (не 5 ГГц)
- Устройство находится в зоне уверенного приёма
В корпоративных сетях AP-изоляция включена в 80% случаев. SmartConfig здесь не работает. Мягко говоря, это плохой выбор для B2B-устройств.
Типичные ошибки пользователей и как их перехватить
Пользователи часто вводят пароль от 5 ГГц сети, а ESP32 поддерживает только 2.4 ГГц. Проверить заранее:
val wifiManager = context.getSystemService(Context.WIFI_SERVICE) as WifiManager val currentNetwork = wifiManager.connectionInfo val is5Ghz = currentNetwork.frequency > 4000 // 5 ГГц > 4000 МГц if (is5Ghz) showWarning("Убедитесь, что IoT-устройство поддерживает 5 ГГц, иначе используйте 2.4 ГГц") На Android 10+: WifiInfo доступен только с разрешением ACCESS_FINE_LOCATION — запрашивайте явно.
Проверка частоты экономит до 40% времени на поддержку, так как пользователь не тратит 10 минут на ввод неправильного пароля.
Сравнение платформ: Android vs iOS
| Параметр | Android | iOS |
|---|---|---|
| SoftAP | Требует WifiNetworkSpecifier (10+) или enableNetwork (9-). Работает на всех версиях |
Требует NEHotspotConfiguration. Работает на всех версиях |
| SmartConfig | Работает, но нестабильно под Android 12+ из-за ограничений | Не поддерживается (iOS ограничивает широковещательную отправку) |
| BLE-комбо | Полная поддержка Core Bluetooth | Полная поддержка Core Bluetooth |
| QR-код | Простая реализация через камеру | Простая реализация через AVFoundation |
Что входит в работу?
- Анализ требований и выбор оптимального метода Provisioning (SoftAP, SmartConfig, BLE-комбо)
- Интеграция SDK для конкретной платформы (Android, iOS, Flutter)
- Реализация UX: сканирование устройств, ввод/выбор сети, обработка ошибок
- Тестирование на 10+ моделях роутеров и версиях ОС
- Документация и передача исходного кода
- Поддержка после запуска (в рамках гарантии)
Закажите консультацию для анализа вашего устройства — мы разберём конфигурацию и подберём best practice. Свяжитесь с нами для оценки проекта.