DOCS-3498: Add Bluetooth provisioning docs for viam-agent

docs/dev/reference/changelog.md

@@ -58,6 +58,13 @@ You can now use folders on machines and in fragments to organize resources.
 
 {{% /changelog %}}
 
+{{% changelog color="added" title="Bluetooth provisioning" date="2025-07-28" %}}
+
+Added support for Bluetooth Low Energy (BLE) provisioning, allowing devices to be set up over Bluetooth connection.
+For an example implementation, see the [Flutter Provisioning package](https://github.com/viamrobotics/viam_flutter_provisioning/).
+
+{{% /changelog %}}
+
 {{% changelog color="added" title="Annual billing support for subscription billing model" date="2025-07-23" %}}
 
 You can now configure annual billing alongside monthly billing options for your organizations.

docs/manage/fleet/provision/end-user-setup.md

@@ -55,15 +55,17 @@ If you have already created a machine, select it.
 If you have not yet created a machine, click on **Add new smart machine** and give your machine a name.
 {{% /tablestep %}}
 {{% tablestep number=3 %}}
-**Follow the instructions in the app**
+**Turn on your machine and follow the app instructions**
 
 Turn on the smart machine you are attempting to connect to.
 Then leave the app and navigate to your mobile device's WiFi settings and connect to the WiFi hotspot your machine has created.
 You may need to wait a short time for your machine to boot and create its WiFi hotspot.
+
 Your machine's WiFi hotspot name will begin with `viam-setup-`.
 Unless you have been given other instructions, the WiFi password for this hotspot network is `viamsetup`.
 
-Once you are connected to your machine's WiFi hotspot return to the Viam mobile app.
+Return to the Viam mobile app once connected.
+
 {{% /tablestep %}}
 {{% tablestep number=4 %}}
 **Provide the network information for the machine**
@@ -72,6 +74,7 @@ In the mobile app, you will be prompted to provide the network information for t
 
 The machine will now disable the hotspot network and attempt to connect using the provided network information.
 If the machine cannot establish a connection using the provided network information, the machine will create the hotspot again and prompt you to re-enter the network information until a connection is successfully established.
+
 {{% /tablestep %}}
 {{% tablestep number=5 %}}
 **Wait for machine to complete setup**
@@ -135,6 +138,62 @@ Note that any features that require internet access will not function if the con
 {{% /tablestep %}}
 {{< /table >}}
 
+## Set up your machine using a custom Flutter app
+
+If you are building your own app to provide provisioning functionality you have three options for provisioning:
+
+<!-- prettier-ignore -->
+| Provisioning method | Description | Notes | Package |
+| ------------------- | ----------- | ----- | ------- |
+| **Bluetooth with WiFi** | Ask the user to connect to the machine over Bluetooth. The user then provides network credentials for an internet-connected WiFi network, through which machine setup can then occur. | Recommended, if available. | [Example](https://github.com/viamrobotics/viam_flutter_provisioning/) |
+| **WiFi** | Ask the user to connect to the machine's temporary WiFi network. The user then provides network credentials for an internet-connected WiFi network, through which machine setup can then occur. | Slower than Bluetooth with WiFi but faster than Bluetooth tethering. | [Example](https://github.com/viamrobotics/viam_flutter_hotspot_provisioning_widget) |
+ | **Bluetooth tethering** | Ask the user to connect to the machine over Bluetooth. The user shares their mobile device's internet with the machine over Bluetooth. | Slowest | [Example](https://github.com/viamrobotics/viam_flutter_bluetooth_provisioning_widget/) |
+
+You can support any number of these options.
+
+## Troubleshooting
+
+### Bluetooth connection issues
+
+If you're having trouble with Bluetooth provisioning:
+
+1. **Check Bluetooth permissions**: Ensure the app used for provisioning has [Bluetooth permissions enabled](https://github.com/viamrobotics/viam_flutter_bluetooth_provisioning_widget?tab=readme-ov-file#platform-requirements) on your device.
+
+1. **Verify Bluetooth is enabled**: Make sure Bluetooth is turned on in your mobile device settings.
+
+1. **Restart Bluetooth**: Try turning Bluetooth off and on again on your mobile device.
+
+1. **Remove and re-add**: If you've already connected to the machine over Bluetooth, remove or forget the device from your mobile device's settings, and re-add it.
+
+If you can open a terminal on the machine:
+
+1. Check if Bluetooth is available:
+
+   ```sh {class="command-line" data-prompt="$"}
+   bluetoothctl list
+   ```
+
+1. Restart Bluetooth service:
+
+   ```sh {class="command-line" data-prompt="$"}
+   sudo systemctl restart bluetooth
+   ```
+
+1. **Configuration check**: If you set up provisioning, verify that `disable_bt_provisioning` is set to `false` in your configuration.
+
+### WiFi connection issues
+
+If you cannot connect to your machine's temporary WiFi hotspot, confirm you are using the correct password.
+The default password, unless changed by the manufacturer, is `viamsetup`,
+
+If your machine cannot connect to your permanent office or home WiFi network:
+
+1. **Check network credentials**: Verify that the WiFi network name (SSID) and password are correct.
+
+1. **Check network compatibility**: Ensure your WiFi network is compatible with your machine's WiFi band frequency (2.4ghz vs 5ghz).
+
+1. **Try a different network**: If possible, try connecting to a different WiFi network to isolate the issue.
+
 ## Next Steps
 
 You can now use your machine.