aljaz/Android-nRF-Toolbox
1
0
Fork 0
mirror of https://github.com/aljazceru/Android-nRF-Toolbox.git synced 2025-12-22 08:54:21 +01:00
Code Issues Packages Projects Releases Wiki Activity

Comments regarding autoConnect updated

Browse Source
This commit is contained in:
Aleksander Nowakowski
2016-10-18 15:47:37 +02:00
parent 129cd8b1e3
commit fa3cd61924
4 changed files with 27 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
app/src/main/java/no/nordicsemi/android/nrftoolbox/profile/BleManager.java
View File

@@ -179,8 +179,16 @@ public abstract class BleManager<E extends BleManagerCallbacks> implements ILogg
protected abstract BleManagerGattCallback getGattCallback();
/**
* Returns whether to directly connect to the remote device (false) or to automatically connect as soon as the remote
* device becomes available (true).
* Returns whether to connect to the remote device just once (false) or to add the address to white list of devices
* that will be automatically connect as soon as they become available (true). In the latter case, if
* Bluetooth adapter is enabled, Android scans periodically for devices from the white list and if a advertising packet
* is received from such, it tries to connect to it. When the connection is lost, the system will keep trying to reconnect
* to it in. If true is returned, and the connection to the device is lost the {@link BleManagerCallbacks#onLinklossOccur(BluetoothDevice)}
* callback is called instead of {@link BleManagerCallbacks#onDeviceDisconnected(BluetoothDevice)}.
* <p>This feature works much better on newer Android phone models and many not work on older phones.</p>
* <p>This method should only be used with bonded devices, as otherwise the device may change it's address.
* It will however work also with non-bonded devices with private static address. A connection attempt to
* a device with private resolvable address will fail.</p>
*
* @return autoConnect flag value
*/

4
app/src/main/java/no/nordicsemi/android/nrftoolbox/profile/BleManagerCallbacks.java
View File

@@ -52,7 +52,9 @@ public interface BleManagerCallbacks {
/**
* Called when the device has disconnected (when the callback returned
* {@link BluetoothGattCallback#onConnectionStateChange(BluetoothGatt, int, int)} with state DISCONNECTED.
* {@link BluetoothGattCallback#onConnectionStateChange(BluetoothGatt, int, int)} with state DISCONNECTED),
* but ONLY if the {@link BleManager#shouldAutoConnect()} method returned false for this device when it was connecting.
* Otherwise the {@link #onLinklossOccur(BluetoothDevice)} method will be called instead.
* @param device the device that got disconnected
*/
void onDeviceDisconnected(final BluetoothDevice device);

12
wear/src/main/java/no/nordicsemi/android/nrftoolbox/ble/BleManager.java
View File

@@ -147,8 +147,16 @@ public class BleManager implements BleProfileApi {
}
/**
* Returns whether to directly connect to the remote device (false) or to automatically connect as soon as the remote
* device becomes available (true).
* Returns whether to connect to the remote device just once (false) or to add the address to white list of devices
* that will be automatically connect as soon as they become available (true). In the latter case, if
* Bluetooth adapter is enabled, Android scans periodically for devices from the white list and if a advertising packet
* is received from such, it tries to connect to it. When the connection is lost, the system will keep trying to reconnect
* to it in. If true is returned, and the connection to the device is lost the {@link BleManagerCallbacks#onLinklossOccur(BluetoothDevice)}
* callback is called instead of {@link BleManagerCallbacks#onDeviceDisconnected(BluetoothDevice)}.
* <p>This feature works much better on newer Android phone models and many not work on older phones.</p>
* <p>This method should only be used with bonded devices, as otherwise the device may change it's address.
* It will however work also with non-bonded devices with private static address. A connection attempt to
* a device with private resolvable address will fail.</p>
*
* @return autoConnect flag value
*/

6
wear/src/main/java/no/nordicsemi/android/nrftoolbox/ble/BleManagerCallbacks.java
View File

@@ -70,8 +70,10 @@ public interface BleManagerCallbacks {
/**
* Called when the device has disconnected (when the callback returned
* {@link BluetoothGattCallback#onConnectionStateChange(BluetoothGatt, int, int)} with state DISCONNECTED.
* @param device target device
* {@link BluetoothGattCallback#onConnectionStateChange(BluetoothGatt, int, int)} with state DISCONNECTED),
* but ONLY if the {@link BleManager#shouldAutoConnect()} method returned false for this device when it was connecting.
* Otherwise the {@link #onLinklossOccur(BluetoothDevice)} method will be called instead.
* @param device the device that got disconnected
*/
void onDeviceDisconnected(final BluetoothDevice device);