Connection Troubleshooting
If your device cannot be found, cannot connect, or disconnects frequently, follow this checklist. Confirm the path first, then check permissions and device state.
1. Confirm the Connection Method
Different connection methods fail for different reasons:
| Connection method | Check first |
|---|---|
| BLE | Bluetooth permission, distance, whether another app is using the device |
| SPP | Whether Windows has paired the device; whether the device is discoverable on macOS |
| Serial | Whether the correct port is selected; whether another serial tool is using it |
| Wi-Fi | Whether the IP is correct and both devices are on the same LAN |
If unsure, read Connection Methods.
2. Basic Checks
- Keep the device close to the phone/computer, ideally within 1-2 meters.
- Make sure it is powered on and in the mode required by its manual.
- Turn system Bluetooth off and on once.
- Restart HiBean.
- Restart the device.
3. Check Permissions
iOS / iPadOS
Open system Settings → HiBean and make sure Bluetooth is enabled.
Android
Open system Settings → Apps → HiBean → Permissions and allow Nearby devices. Some older Android versions also require location permission.
macOS / Windows
Make sure system Bluetooth is enabled. For SPP or Serial, also check system pairing, port, and permission state.
4. Windows SPP: Pair in Windows First
On Windows, HiBean’s SPP list usually comes from system-paired devices. Even if the device is discoverable, it may not appear in HiBean until it is paired in Windows.
5. macOS SPP: Keep the Device Discoverable
On macOS, HiBean’s SPP list comes from nearby inquiry scan. If the device is not discoverable/pairable, the list may be empty.
6. Avoid Device Occupation
During troubleshooting, close other apps that might use the same device:
- Other roasting software
- Bluetooth debug tools
- Serial monitors
- Vendor apps
7. “Not Configured / Bluetooth Not Configured”
This usually happens when using a synced device on a new platform: the device object exists, but this platform has not saved its Bluetooth identifier yet.
- Explanation: Use Devices Across Platforms
- Operation: Update Connection Settings
8. When Contacting Support
Please include:
- OS and version: iOS / Android / macOS / Windows.
- Device brand and model.
- Connection method: BLE / SPP / Serial / Wi-Fi.
- Symptom: cannot find, pairing failed, connection failed, disconnects, not configured, etc.
- Screenshots or error messages.