Aidlab Docs

Troubleshooting ​

Use this checklist when a sample app builds but does not discover a device or does not receive data.

No device found ​

  • Use a physical phone or computer with Bluetooth 4.0+ support. Simulators and emulators cannot connect to supported devices.
  • Make sure the device is charged, awake, and close to the computer or phone.
  • Wear the device correctly. Some streams start only when the device detects a valid signal.
  • Disconnect the device from other apps before scanning from your integration.
  • On mobile, make sure Bluetooth is enabled and the app has Bluetooth permissions.

Permission denied ​

  • Android requires the runtime Bluetooth permissions BLUETOOTH_SCAN and BLUETOOTH_CONNECT.
  • Apple platforms require NSBluetoothAlwaysUsageDescription in Info.plist.
  • Unity requests the Android Bluetooth permissions itself; its post-build step adds the Bluetooth usage string to iOS and macOS builds that have none.

Connected, but no samples ​

  • After receiving the connection event, start data collection with the data types you want to receive.
  • Confirm that your device supports the requested data type in Data Types and Events.
  • Check whether the stream needs the device to be worn, whether electrodes have contact, or whether the sensor is enabled.
  • In Python, set the aidlab logger to DEBUG to confirm that the connection and collection command are being sent.

Device disconnects ​

  • Return quickly from SDK callbacks. Aidlab 2 disconnects when the SDK acknowledges data late; see Callback threads.
  • Keep the device close to the phone or computer and avoid connecting from multiple apps at the same time.
  • Add reconnect and backoff logic in production apps.
  • On Android, account for battery optimization and background execution limits.
  • On iOS, configure the required Bluetooth background modes if your app must continue in the background.

Stale pairing or Bluetooth cache ​

  • Turn Bluetooth off and on, then restart scanning.
  • Remove the device from the OS Bluetooth settings if it was previously paired manually.
  • Restart the phone or computer when the OS Bluetooth stack keeps reporting stale devices.
  • Reinstall the sample app if mobile permissions were denied permanently.