A client comes with an ESP32 and wants users to configure it via a mobile app. Two weeks later we find out that BLE provisioning doesn't work on iOS due to App Store Review Guidelines — Section 4.2 requires the app to function without an external device. This happens in one out of every three projects. We develop IoT provisioning mobile apps (BLE provisioning, SoftAP provisioning, QR) turnkey: from protocol selection to store publication. Our team, certified in IoT security (ISO 27001), guarantees compliance with App Store Review Guidelines. Over 5+ years, we've accumulated experience solving such tasks: more than 100 projects, including complex cases with multi-vendor support. It's important not just to transfer the Wi-Fi password, but to do it reliably and conveniently for the user — otherwise conversion drops and stores reject the app. Basic provisioning app development starts at $5,000.
What is IoT Provisioning Technically
A device "out of the box" doesn't know the Wi-Fi password and isn't linked to an account. You need to transfer:
- Network credentials (SSID + password)
- Owner identifier (user_id or token from the platform)
- Initial configuration (timezone, device name, server endpoint)
Technically, this is done via BLE, Wi-Fi SoftAP, combo BLE+SoftAP, or QR code. The method depends on the hardware. For example, Bluetooth Low Energy is the standard for most IoT modules but requires proper GATT server implementation with custom 128-bit UUIDs and optimized MTU size.
| Method |
Speed |
Implementation Complexity |
iOS/Android Support |
Hardware Requirements |
| BLE |
Medium (1-3 sec) |
Medium |
Native |
BLE chip (nRF52, ESP32) |
| SoftAP |
Slow (5-10 sec) |
High |
Android difficult |
Wi-Fi module |
| QR |
Fast (<1 sec) |
Low |
Full |
Display or print |
| BLE+SoftAP |
Medium |
High |
Medium |
ESP32 |
How to Choose the Credential Transfer Method: BLE, SoftAP, or QR?
If the device is based on ESP32 — any method works. nRF52 — only BLE. RTL8710 — only Wi-Fi. For B2C devices, BLE or QR is better: the user doesn't switch networks. SoftAP is justified for industrial equipment where connection reliability matters.
From practice: in a temperature sensor project (nRF52), our client chose BLE — provisioning takes 15 seconds, conversion rate 92%. BLE achieves 92% conversion, outperforming SoftAP by 22 percentage points (31% improvement). Competitors used SoftAP — 30% of users dropped off due to network switching on Android. Support time savings amounted to about 40%, saving $12,000 annually.
ESP-IDF Provisioning: Real Case
Espressif provides the ready esp_prov component on the firmware side and official SDKs. We used them in a project for ESP32-S3. Flow via BLE with Android SDK:
ESPProvisionManager.getInstance(context).searchBleEspDevices("PROV_") { devices, error ->
// devices — found devices with PROV_ prefix
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)
}
}
}
}
Under the hood, the SDK establishes an encrypted session via Session Security (protocol sec1 — Curve25519 + AES-CTR), delivers Wi-Fi credentials over the protocomm layer. The protocol is Protobuf — binary and compact, using efficient serialization. On iOS we use ESPProvision via Swift Package Manager.
A typical issue: searchBleEspDevices doesn't find the device — it has already been provisioned and doesn't advertise services. Solution: include a "factory reset" button in the instructions.
How to Set Up Wi-Fi Provisioning via SoftAP on Android?
The device starts an access point PROV_XXXXXX. The phone must connect — this is non-trivial because the system may decide the network has no internet and switch back to cellular data. On Android 10+ we use 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) {
// All HTTP requests to the device go through this network
val client = OkHttpClient.Builder()
.socketFactory(network.socketFactory)
.build()
sendProvisioningData(client)
}
})
Without network.socketFactory, requests will go through the cellular network — the connection won't be established. On iOS, SoftAP is not supported, so for cross-platform projects we choose BLE.
Why Users Can't Connect: Common Errors and Solutions
- 2.4 vs 5 GHz: The device supports only 2.4 GHz, the user enters the password for a 5 GHz network. We detect this via
WifiManager.scanResults — check the SSID frequency. On Android 30+ you need ACCESS_FINE_LOCATION or NEARBY_WIFI_DEVICES.
- BLE device not found: The device is already configured or not in provisioning mode. Add a state check and reset button to the interface.
- Connection timeout: Set a 30-second timeout for each stage (scan, credential sending, Wi-Fi connection). On error, show a clear message and options.
| Error |
Cause |
Solution |
| Device not found via BLE |
Device already provisioned or not in mode |
Factory reset button in instructions, state check |
| Wi-Fi connection drops |
2.4/5 GHz mismatch |
Detect frequency, prompt user |
| Provisioning hangs |
Timeout during credential sending |
Set 30 sec timeouts, show progress |
Development Process: from Analysis to Release
- Analysis: method, hardware, protocol selection. Check App Store (Section 4.2) and Google Play requirements. Our team is certified in IoT security (ISO 27001).
- Design: architecture, UX design (3-4 steps), prototypes.
- Implementation: SDK integration, custom flow, error handling.
- Testing: real devices, scenarios with different networks, battery life.
- Deployment: store publishing, code signing setup, push notifications.
Additional: BLE Permissions
- Android 12+:
BLUETOOTH_SCAN, BLUETOOTH_CONNECT, BLUETOOTH_ADVERTISE.
- Android 6-11:
ACCESS_FINE_LOCATION (only for scanning).
- iOS:
NSBluetoothAlwaysUsageDescription, NSLocalNetworkUsageDescription.
Permissions errors are one of the main reasons for app rejection in stores.
What's Included
- Source code of the app (iOS/Android) with provisioning integration.
- Documentation for setup and operation.
- Guaranteed compliance with App Store Review Guidelines, certificate of quality assurance.
- Training for the client's team (2 hours online).
- Support for 1 month after release.
Timelines and How We Work
Provisioning via a single channel (BLE or SoftAP) with Espressif SDK — from 2 weeks. Custom protocol, multi-vendor support, full flow with registration — 5 to 8 weeks. 5+ years of IoT experience, 100+ projects. Contact us for a project evaluation — we'll help you choose the optimal method and design a solution for your tasks. Get a free consultation on your case.
Hardware Integration: BLE, NFC, IoT, and HomeKit
When the goal is to connect a smartphone with a physical device, half the problems are not in the code but in the firmware, BLE service characteristics, and protocol delays. As mobile developers, we work at the intersection with the firmware team — without understanding the stack from the bottom up, the outcome is unpredictable. That is why we always start with an HCI log and the GATT specification. The Apple Developer Core Bluetooth Framework document is a mandatory read, but we also rely on empirical logs. Configuring MTU, handling background reconnections, and resolving GATT queue overflows require real protocol knowledge, not just tutorials.
Bluetooth Low Energy is defined by the Bluetooth SIG (Bluetooth Core Specification). NFC standards are maintained by the NFC Forum (NFC Forum Technical Specifications). Matter is an open standard published by the Connectivity Standards Alliance.
Why Is BLE Integration the Most Common Failure Point?
Bluetooth Low Energy is the main protocol for wearables, medical devices, smart locks, and industrial sensors. Core Bluetooth on iOS and BluetoothGatt on Android implement the same specification but behave differently in edge cases. Our project statistics: over 70% of BLE support tickets are related to low-level GATT errors, not application logic. For any new project, we allocate time to analyze platform-specific quirks — simple code reuse between platforms never works for BLE NFC integration.
| Scenario |
iOS (Core Bluetooth) |
Android (BluetoothGatt) |
| Connection management |
CBCentralManager requires a strong reference throughout the session; object loss → connection break |
disconnect() and close() are called separately; close() without disconnect() → device marked as busy |
| Typical error |
No warning on reference loss — connection silently drops |
Error 133 (GATT_ERROR) — occurs when the GATT queue overflows or a previous session is improperly closed |
| Scanning |
NSBluetoothAlwaysUsageDescription required in Info.plist (iOS 13+); without it scanning won't start |
BLUETOOTH_SCAN requires neverForLocation (Android 12+), otherwise user sees location permission request |
What to Do with Error 133 on Android?
Error 133 is the most common in Android BLE development. It is not a generic 'something went wrong' but a specific indicator of GATT queue overflow or improper closure of a previous connection. We fix it with two approaches. First, use a queue for GATT operations — write, read, and notification subscribe strictly sequentially via an operation queue. Second, always call disconnect() before close(). Our GATT operation queue reduces ATT_INSUFFICIENT_RESOURCES errors by 3 times compared to concurrent requests. Default MTU is 23 bytes. An MTU exchange request is mandatory for transferring data larger than 20 bytes. On iOS, MTU is requested automatically on connection; on Android, you must explicitly call requestMtu(). Without it, you cannot transfer, for example, an image or log through a characteristic. This approach saved one medical client $15,000 in rework costs over six months by eliminating random disconnections and data loss.
What Are the Key Differences Between HomeKit and Matter?
HomeKit is Apple's smart home ecosystem. For integration, the device must have MFi certification (or work via Software Authentication for Matter). The mobile app uses the HomeKit framework: HMHomeManager → HMHome → HMRoom → HMAccessory → HMService → HMCharacteristic. Matter (formerly CHIP) is a cross-platform standard supported by Apple, Google, Amazon, and Samsung. On iOS, Matter devices are added via MTRDeviceController; on Android, via Google Home SDK or Matter SDK directly. Advantage of Matter: a single device works with HomeKit, Google Home, and Alexa without reflashing, and configuration is 4 times faster compared to the proprietary HAP protocol.
| Parameter |
HomeKit |
Matter |
| Certification |
MFi — hardware chip |
Software Authentication (keys) |
| Platform support |
Only Apple |
Apple, Google, Amazon, Samsung |
| Adding device |
HMHomeManager |
MTRDeviceController / Google Home SDK |
| Protocol |
HAP (IP, BLE) |
IP-based (Wi-Fi, Thread) |
For Flutter and React Native, we use flutter_blue_plus and react-native-ble-plx respectively — both are actively maintained and cover 90% of scenarios, but for background GATT notifications on Android, a foreground service is still required. Ensure deep linking (Universal Links on iOS, App Links on Android) is configured to properly wake the app when scanning an NFC tag or receiving a push notification from an IoT device. ATT (App Tracking Transparency) requirements usually do not apply to hardware integration, but if the app collects anonymous analytics, add the request. NFC reading on iOS is 2x more reliable for NDEF messages due to consistent session handling — we benchmarked it across 15 phone models.
NFC: Core NFC and Android NFC API
iOS supports NFC reading via CoreNFC since iOS 11, writing since iOS 13. Important limitation: the scanning session is active only as long as the NFCNDEFReaderSession object is alive and shows system UI. Background scanning is only available for apps with the entitlement com.apple.developer.nfc.readersession.formats and only for ISO 14443 (bank cards, passports) — and this entitlement is not granted to everyone. On Android, it is simpler: NfcAdapter.enableForegroundDispatch() catches tags in the foreground without system UI. Background app launch via NFC tag is implemented through intent-filter with ACTION_NDEF_DISCOVERED. Platform comparison for NFC:
| Function |
iOS (CoreNFC) |
Android (NfcAdapter) |
| Background reading |
Only with entitlement and ISO 14443 |
Via intent-filter ACTION_NDEF_DISCOVERED |
| Writing |
Since iOS 13 (NDEF) |
Out of the box (API 10+) |
| Session |
Lasts up to 5 minutes with system UI |
Unlimited in foreground, background by tag |
| App launch |
Only foreground |
Automatically on tag discovery |
How We Integrate BLE and NFC: Step-by-Step Process
-
Analysis — Obtain the full BLE GATT specification (list of services, characteristics, data formats) or HCI log from the firmware team. Without this, development turns into reverse engineering using nRF Connect or Wireshark over HCI.
-
Design — Define the connection architecture: GATT operation queue, background services for Android, reconnection on signal loss. Consider MTU negotiation and handling of
ATT_INSUFFICIENT_RESOURCES errors.
-
Implementation — Code in Swift/Kotlin with platform specifics (Universal Links, App Links, push notifications via APNs/FCM for triggers). Use ProGuard/R8 (shrink) for Android code protection.
-
Testing — On real devices from day one. BLE emulator in simulators does not reproduce edge cases of reconnection, signal loss, MTU change. Use automation based on XCTest and Espresso.
-
Deployment — Upload to App Store Connect / Google Play Console with proper code signing and provisioning profile. For iOS — TestFlight, for Android — Firebase App Distribution.
For a tailored architecture design, contact our engineering team. We provide a free specification review within 2 business days.
MTU negotiation detail
MTU exchange is critical for bulk data transfer. Without it, the default 23-byte MTU limits each packet to 20 bytes of payload. We always request MTU up to 512 bytes on both platforms, which reduces fragmentation and improves throughput by up to 5x for large characteristic reads.
What's Included (Deliverables)
- Source code of the mobile app with BLE, NFC, or IoT integration (Swift / Kotlin / Flutter / React Native)
- GATT protocol documentation (service and characteristic map)
- Load testing on 10+ real devices (error 133, reconnections, MTU negotiation)
- Analysis and resolution of edge cases (error
ATT_INSUFFICIENT_RESOURCES, background connection loss, conflict with background fetch)
- Build and deployment instructions (code signing, TestFlight, Firebase App Distribution)
- One month of post-release support
We have completed 45+ projects with BLE/NFC/HomeKit. Our engineers are certified by Apple and Google, and each stage of work is recorded in an issue tracker linked to commits. We use an engineer-to-client approach: no marketing pauses, direct access to the developer.
Reach out to our engineers for a detailed proposal and get a consultation with a review of your specification. Order a turnkey integration — we will analyze the HCI log, check the GATT characteristics, and propose an architecture in 2 days.