Abeeway Mobile APP - FAQ

Abeeway Mobile APP - FAQ

Adding a tracker

You can’t find the tracker as its probably not advertising. Please ensure the following are true:

  1. The MCU Firmware is above 2.2.x
  2. The BLE firmware version is above 3.3.x
  3. The trackers are flashed with this config file

Note:

  • If you are running Abeeway Mobile Version 1.0.2 and below, it is important to run MCU Firmware 2.2.x. 
  • For Abeeway Mobile App Version > 1.0.2, it is important to run MCU Firmware >= 2.3.x on the tracker.  
  • The mobile app version can be found from the Abeeway Mobile app main menu (See screenshot below. The mobile app version in the example below is 0.2):

For micro tracker/Smart Badge, you can simply restart the tracker and it will advertise itself for few minutes. The tracker also plays advertisement melody during this period and stops advertisement after few minutes to save battery lifetime of the tracker. If the tracker does not play advertisement melody even though the firmware/config file is correct, it is because it is bonded. See below for instructions on how to remove BLE bond.

For Compact tracker/Industrial tracker, you have to enable the tracker to advertise itself over BLE by sending the following downlink ff020b0064 (to advertise itself over BLE for 100 seconds) on LoRaWAN port = 2. If you wish to change the duration of the advertisement period, please refer to Abeeway driver user guide.

The BLE bond on the tracker can be removed in one of the following ways:

  1. With the button sequence (easiest): Ensure the device is switched off with long press, followed by the sequence <1 long press , 6 short press, 1 long press> and then restart the device with long press. If the bond removal was successful, you will hear the following BLE advertisement melody (This is applicable only to Micro Tracker/Smart Badge)
  2. Sending the LoRaWAN downlink ff0202 on downlink port = 2 to the Abeeway tracker
  3. Using CLI with the tracker connected over USB port. The tracker can be connected to USB port and then communicate it with serial tool like Tera term. Once connected to Tera term, enter the password “123” as this is the default password to interact with the tracker. Then type “ble clear” to clear the BLE bond on the tracker. For more information, please refer to CLI user guide.

This issue happens due to the Bluetooth connectivity. Please do the following steps and try again to add the tracker:

Step 1: Remove the Bluetooth bond from the phone. 

The BLE bond on the phone can be easily removed by clicking on “FORGET” button on the Abeeway tracker. Abeeway devices always start with prefix ABW followed by last 9 digits of LoRa DEVEUI. DEVEUI can be found on the back of the sticker on the tracker.

Note: The screenshot above is for Android 9. The procedure to remove the Abeeway tracker from phone’s Bluetooth device will be different for iOS or other Android phones.

Step 2: Remove Bluetooth bond on the tracker

The BLE bond on the tracker can be removed in one of the following ways:

  1. With the button sequence (easiest): Ensure the device is switched off with long press, followed by the sequence <1 long press , 6 short press, 1 long press> and then restart the device with long press. If the bond removal was successful, you will hear the following BLE advertisement melody (This is applicable only to Micro Tracker/Smart Badge)
  2. Sending the LoRaWAN downlink ff0202 on downlink port = 2 to the Abeeway tracker
  3. Using CLI with the tracker connected over USB port. The tracker can be connected to USB port and then communicate it with serial tool like Tera term. Once connected to Tera term, enter the password “123” as this is the default password to interact with the tracker. Then type “ble clear” to clear the BLE bond on the tracker. For more information, please refer to CLI user guide.

Step 3: Put your phone in airplane mode and disable airplane mode (This step is optional but it will help clear any issues related to Bluetooth keys)

Step 4: Forcefully kill the mobile APP by clicking “FORCE STOP” and start the mobile APP again.  (This step is optional but it will help clear any issues related to Mobile APP caching Bluetooth keys from earlier interaction with the tracker)

Note: The screenshot above is for Android 9. The procedure to forcefully terminate mobile app will be different for iOS or other Android phones.

Step 5a: Shutdown the tracker with long press and start the tracker again with long press on the button. (Applicable only to Micro tracker/Smart Badge)

Step 5b: Send the LoRaWAN downlink ff020b0384 on port=2 to trigger BLE advertising on the tracker for 15 minutes. You can change the BLE advertisement duration using Asset Tracker Driver documentation, here. (Application for Compact & Industrial Tracker)

Step 7: Try to add the tracker again.

Step 8: Please ensure that during the process to “add a tracker”, you are not doing any heavy activity over Bluetooth (for ex. streaming music, file transfer, etc) that could slow down the connection between the tracker and the mobile APP

Step 9: If the error to add the tracker persists even after following all the steps above, you can try to restart the phone to clear any Bluetooth issues. But, this needs to be done rarely and is not required in most of the cases

This error comes from one of the two reasons:

  1. The tracker is registered on another account. Please contact your local distributor or report a problem from HELP menu to remove this tracker from the other account
  2. The tracker was deleted over LoRaWAN and its added again during the 20 minute timer during which mobile APP backend is trying to send the downlink over LoRaWAN to remove BLE bond of the tracker. If this is your case, please wait for 20 minutes before adding the tracker again.

Firmware update

Bluetooth connectivity issues

  • You can see if the tracker is Bluetooth connected with the Bluetooth icon that is shown on the tracker view page