Bluetooth
ServoMote communicates with your ESP32 using Bluetooth Low Energy (BLE). No Wi-Fi or internet connection is needed.
Connecting
- Make sure your ESP32 is powered on and running one of the ServoMote sketches
- Open ServoMote and select a device
- In the device editor, tap the Bluetooth device card to scan for nearby devices
- Select your ESP32 from the list — it advertises as "ServoMote" by default
Once paired, the app connects automatically when you select the device on the control screen.
Scanning
The scan screen shows all nearby BLE devices. By default, only devices advertising the ServoMote service are shown. Toggle Show all devices to see all BLE devices in range.
For each device, the scan screen shows:
- Device name (or "Unknown" if not advertised)
- Signal strength (RSSI bars)
Connection states
| State | Meaning |
|---|---|
| Disconnected | Not connected to any device |
| Scanning | Looking for the configured device |
| Connecting | Found the device, establishing connection |
| Connected | BLE connection established, discovering services |
| Ready | Services discovered, ready to send commands |
Signal strength
When connected, the signal strength indicator in the top bar shows the Bluetooth signal quality. This is based on the RSSI (Received Signal Strength Indicator) value. Move closer to the ESP32 if the signal is weak.
Troubleshooting
- Device not found — Make sure the ESP32 is powered on and the sketch is running. Check that Bluetooth is enabled on your phone.
- Connection drops — Move closer to the ESP32. BLE range is typically 10–30 meters depending on the environment.
- Permission denied — ServoMote needs Bluetooth permission to scan and connect. Check your phone's settings.
- Wrong device — If multiple ESP32s are in range, make sure you select the right one. You can change the device name in the Arduino sketch.
