Skip to content

Android Pairing Bonding

Djamil Elaidi edited this page Mar 18, 2021 · 9 revisions

Since PandwaRF Android Release 1.4.0 we have added a new security mechanism to protect your PandwaRF from un-authorized access. The new un-authorized access protection feature uses the BLE bonding process.

You now have to choose whether you want to use this new security feature or not.

Button Short press Long press (>2s)
SW1 Shutdown PandwaRF
SW2 Enter Whitelist bypass mode
SW3 Delete all bonding information
SW4
SW5 Reset

Procedures

Whitelist clear procedure

  1. Press SW3 for 2s, then release
  2. Blue and red LEDs will be ON for 1s, then blink quickly in sync for 2s
  3. Whitelist has now been cleared
  4. Warning: PandwaRF un-authorized access protection is now disabled. Any phone will now be able to bond and thus forbid other phones connection
  5. If your phone was previously bonded to PandwaRF, you need to clear the bonding information from the BLE Params page in the PandwaRF Application

Note: BLE Params page can be found under Developer page, if Developer mode is enabled.

Whitelist bypass mode procedure

  1. Press SW2 for 2s, then release
  2. Blue LED will be ON for 1s, then and it shall blink quickly 4 times (for approx. 2s)
  3. PandwaRF is now in Whitelist Bypass Mode
  4. Warning: any first phone will now be able to connect and bond
  5. Once first phone (any phone) has connected and disconnected, PandwaRF will revert back into the mode it was before Whitelist bypass mode procedure

Enable un-authorized access protection

Add a new phone to whitelist

  1. Execute Whitelist bypass mode procedure
  2. Connect to PandwaRF using Android application
  3. Go to page "BLE Parameters"
  4. Click "Bond"
  5. Phone is bonded and does not require bonding anymore. Other phones cannot connect.
  6. Repeat for each phone allowed to connect to PandwaRF

Disable un-authorized access protection

More details

If Whitelist is empty:

  • Whitelist mode is inactive
  • Every phone can connect to the PandwaRF without pressing SW2.
  • Once connected, a phone must bond with PandwaRF to be allowed to reconnect later without the need to enter Whitelist Bypass Mode again.
  • If phone is connected but doesn't bond with PandwaRF and then disconnect, phone will able to reconnect later using Whitelist Bypass Mode and assuming PandwaRF Whitelist is still empty.
  • As soon as a phone is connected and bonded, the Whitelist is no more empty. New phones can only be connected if SW2 has been pressed before.

If Whitelist is not empty:

  • Whitelist mode is active
  • Only the phones in the whitelist can connect to the PandwaRF without entering Whitelist Bypass Mode.
  • Phones not in the whitelist will have their connection attempts rejected.
  • Phones not in the whitelist can be connected using Whitelist Bypass Mode. This will temporarily disable whitelist advertising for one connection.
  • However, after the device disconnects, the whitelist will take effect again.
  • To permanently disable whitelist advertising, bonding list needs to be cleared by holding SW3 for more than 2s

Project Information

PandwaRF Android Application (Normal Mode)

PandwaRF Android Application (Dev Mode)

Marauder Android Application

iOS Application

Linux

Hardware

For developers

Support

Gimme moar!

Clone this wiki locally