aljaz/Android-nRF-Toolbox
1
0
Fork 0
mirror of https://github.com/aljazceru/Android-nRF-Toolbox.git synced 2025-12-22 17:04:23 +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(); protected abstract BleManagerGattCallback getGattCallback();
/** /**
* Returns whether to directly connect to the remote device (false) or to automatically connect as soon as the remote * Returns whether to connect to the remote device just once (false) or to add the address to white list of devices
* device becomes available (true). * 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 * @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 * 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 * @param device the device that got disconnected
*/ */
void onDeviceDisconnected(final BluetoothDevice device); 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 * Returns whether to connect to the remote device just once (false) or to add the address to white list of devices
* device becomes available (true). * 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 * @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 * 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),
* @param device target device * 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); void onDeviceDisconnected(final BluetoothDevice device);