> ## Documentation Index
> Fetch the complete documentation index at: https://docs.industrialpmr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BLE Provisioning & Commissioning

> Configuring factory Wi-Fi networks and device parameters via secure Bluetooth Low Energy pairing.

Both **`ipmr223m-v1`** and **`ipmr226`** edge controllers include built-in Bluetooth Low Energy (BLE) provisioning. This allows electrical technicians to onboard new hardware units and configure network settings from a mobile tablet or smartphone **without opening high-voltage electrical panels or plugging in serial debug cables**.

***

## Provisioning Workflow

```mermaid theme={null}
sequenceDiagram
    autonumber
    actor Tech as Factory Field Technician
    participant App as iPMR Mobile Setup App
    participant Node as Industrial PMR Edge Node<br/>(ipmr223m-v1 / ipmr226)
    participant Router as Factory Wi-Fi Access Point

    Note over Tech,Node: Cabinet Door Closed & Powered On
    Tech->>App: Launch Technician Setup Utility
    App->>App: Scan for BLE Advertisements
    Node-->>App: Broadcasts: "iPMR-PROV-[MAC]"
    Tech->>App: Tap device to initiate pairing
    App->>Node: Establish encrypted BLE link
    Tech->>App: Select factory Wi-Fi SSID & input WPA2 passphrase
    App->>Node: Transmit configuration payload
    Node->>Router: Attempt 802.11 b/g/n association & DHCP handshake
    Router-->>Node: IP Address & Gateway Assigned
    Node->>Node: Verify internet routing to mqtt.industrialpmr.com
    Node-->>App: Return status: CONNECTED (RSSI: -58 dBm, IP: 192.168.1.145)
    Note over Node: Automatic Security Lockdown
    Node->>Node: Write credentials to non-volatile storage (NVS) & disable BLE radio
```

***

## Step-by-Step Commissioning Procedure

### 1. Power Up the Edge Node

* Ensure 3-phase or single-phase auxiliary control voltage is active.
* Verify the **PWR** LED illuminates solid Green.
* The **WIFI** LED will begin a rapid blue pulse, indicating the device is broadcasting its BLE configuration beacon.

### 2. Connect via Mobile Setup Utility

* Open the **Industrial PMR Technician Setup Tool** on your tablet or smartphone.
* The app automatically filters nearby devices by signal strength, presenting units within range (e.g., `iPMR-PROV-A4CF12`).
* Select the unit matching the machine nameplate MAC address.

### 3. Select Wi-Fi Network & Enter Security Key

* The app queries the edge node to scan 2.4 GHz local Wi-Fi frequencies and displays discovered factory SSIDs with live signal strength ratings.
* Select the designated plant production Wi-Fi network.
* Enter the WPA2/WPA3 enterprise passphrase.
* Confirm the broker address (default: `mqtt.industrialpmr.com`).

### 4. Verify Connection & Signal Strength (RSSI)

* The edge node attempts association with the plant access point.
* The technician app displays the assigned local IP address and live Received Signal Strength Indicator (RSSI):

| Signal RSSI Rating | Indicator Range | Recommended Action |
| :- | :- | :- |
| **Optimal** | -40 dBm to -65 dBm | Ideal signal for 24/7 continuous operation. |
| **Acceptable** | -66 dBm to -75 dBm | Suitable operation; ensure cabinet door closure doesn't attenuate below -75 dBm. |
| **Poor / Unreliable** | -76 dBm to -90 dBm | Relocate external dipole antenna or install an additional plant Wi-Fi repeater. |

***

## Over-The-Air Security Lockdown

To prevent unauthorized tampering on the factory floor, the edge controller enforces strict radio isolation:

* **Automatic Radio Disable**: Once the edge node establishes a successful Wi-Fi link and connects to `mqtt.industrialpmr.com`, the onboard BLE radio **shuts down completely**.
* **Re-Provisioning Trigger**: If network settings must be altered at a later date, a technician must hold the physical hardware setup button for 5 seconds to re-enable BLE advertising mode.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.