BLE testing guide

Requirements

You need two or more phone devices (iOS or Android 6+). Android 10+ is required for L2cap socket testing (not for this testing session).

Activate the Bluetooth on your phones.

Installation

Normal usage

  1. Start the Berty app.
  2. iOS only: accept the Bluetooth permission request (temporary behaviour)
Image Not Showing Possible Reasons
  • The image was uploaded to a note which you don't have access to
  • The note which the image was originally uploaded to has been deleted
Learn More โ†’
  1. On the Onboarding screen, select Performance.
Image Not Showing Possible Reasons
  • The image was uploaded to a note which you don't have access to
  • The note which the image was originally uploaded to has been deleted
Learn More โ†’
  1. Android only: after the Setup finished screen, a popup should inform you why Berty needs the location permission. Click to OK and accept the system permission request.
Image Not Showing Possible Reasons
  • The image was uploaded to a note which you don't have access to
  • The note which the image was originally uploaded to has been deleted
Learn More โ†’
Image Not Showing Possible Reasons
  • The image was uploaded to a note which you don't have access to
  • The note which the image was originally uploaded to has been deleted
Learn More โ†’
  1. Go to your profile (top right corner) and the Bluetooth screen. Toogle off the Android Nearby (Android) and Multipeer Connectivity (iOS).
Image Not Showing Possible Reasons
  • The image was uploaded to a note which you don't have access to
  • The note which the image was originally uploaded to has been deleted
Learn More โ†’
Image Not Showing Possible Reasons
  • The image was uploaded to a note which you don't have access to
  • The note which the image was originally uploaded to has been deleted
Learn More โ†’
Image Not Showing Possible Reasons
  • The image was uploaded to a note which you don't have access to
  • The note which the image was originally uploaded to has been deleted
Learn More โ†’
  1. Close the Berty app.

  2. Disable mobile data and Wifi.

    • Android: drag down from the top screen
    Image Not Showing Possible Reasons
    • The image was uploaded to a note which you don't have access to
    • The note which the image was originally uploaded to has been deleted
    Learn More โ†’
    • iOS: drag up from the bottom screen
    Image Not Showing Possible Reasons
    • The image was uploaded to a note which you don't have access to
    • The note which the image was originally uploaded to has been deleted
    Learn More โ†’
  3. Start the Berty app.

  4. Make a contact request:

    • if the second phone received it, BLE connection works. You can chat between devices over BLE.
    • if the second phone didn't receive it, you should wait more time that BLE drivers retry connections. You can also stop/start the Berty app and check if the contact request is correctly received.

Other things to test

Permission system

  • Disable mobile data and Wifi.
  • After the onboarding process, try to refuse one of:
    • the permission explanation popup
    • the system permission system
  • Check that the BLE driver didn't start
  • In the Bluetooth screen, try to enable/disable the Bluetooth driver when the permission is not granted:
    • if the permission can be requested again, you should see the same popup that in the onboarding
    • if the permission is blocked, you should be redirected in the app setting to granted manually the location permission

Bluetooth setting screen

  • Disable mobile data and Wifi.
  • In the Bluetooth screen, try to enable/disable the Bluetooth driver.
  • Restart the Berty app.
  • Check that the BLE driver is enabled/disabled.

libp2p transport switching

  • Enable mobile data, Wifi and Bluetooth in settings.
  • Start the Berty app.
  • Check that you can communicate with other devices.
  • Disable mobile data and Wifi.
  • Check that you can communicate with other devices over BLE.

Multi drivers cohabitation

  • Disable mobile data.
  • Try to enable Android Nearby or Multipeer Connectivity in the Bluetooth screen.
  • Check if you can communicate with other devices (contact request, chat) without mobile data and Wifi.