2015-04-19 02:37:29 +02:00
|
|
|
package nodomain.freeyourgadget.gadgetbridge.btle;
|
|
|
|
|
|
|
|
import android.bluetooth.BluetoothGatt;
|
|
|
|
import android.bluetooth.BluetoothGattCharacteristic;
|
|
|
|
|
2015-07-03 21:58:13 +02:00
|
|
|
import java.text.DateFormat;
|
|
|
|
import java.util.Date;
|
|
|
|
|
2015-04-19 02:37:29 +02:00
|
|
|
/**
|
|
|
|
* The Bluedroid implementation only allows performing one GATT request at a time.
|
|
|
|
* As they are asynchronous anyway, we encapsulate every GATT request (read and write)
|
|
|
|
* inside a runnable action.
|
2015-04-19 11:28:03 +02:00
|
|
|
* <p/>
|
2015-04-19 02:37:29 +02:00
|
|
|
* These actions are then executed one after another, ensuring that every action's result
|
|
|
|
* has been posted before invoking the next action.
|
|
|
|
*/
|
|
|
|
public abstract class BtLEAction {
|
|
|
|
private final BluetoothGattCharacteristic characteristic;
|
2015-07-03 21:58:13 +02:00
|
|
|
private final long creationTimestamp;
|
2015-04-19 02:37:29 +02:00
|
|
|
|
|
|
|
public BtLEAction(BluetoothGattCharacteristic characteristic) {
|
|
|
|
this.characteristic = characteristic;
|
2015-07-03 21:58:13 +02:00
|
|
|
creationTimestamp = System.currentTimeMillis();
|
2015-04-19 02:37:29 +02:00
|
|
|
}
|
2015-04-19 11:28:03 +02:00
|
|
|
|
2015-05-17 21:55:02 +02:00
|
|
|
/**
|
|
|
|
* Returns true if this actions expects an (async) result which must
|
|
|
|
* be waited for, before continuing with other actions.
|
2015-05-18 20:56:19 +02:00
|
|
|
* <p/>
|
2015-05-17 21:55:02 +02:00
|
|
|
* This is needed because the current Bluedroid stack can only deal
|
|
|
|
* with one single bluetooth operation at a time.
|
|
|
|
*/
|
|
|
|
public abstract boolean expectsResult();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Executes this action, e.g. reads or write a GATT characteristic.
|
2015-05-18 20:56:19 +02:00
|
|
|
*
|
2015-05-17 21:55:02 +02:00
|
|
|
* @param gatt the characteristic to manipulate, or null if none.
|
|
|
|
* @return true if the action was successful, false otherwise
|
|
|
|
*/
|
2015-04-19 02:37:29 +02:00
|
|
|
public abstract boolean run(BluetoothGatt gatt);
|
2015-04-19 11:28:03 +02:00
|
|
|
|
2015-04-19 02:37:29 +02:00
|
|
|
/**
|
|
|
|
* Returns the GATT characteristic being read/written/...
|
2015-04-19 11:28:03 +02:00
|
|
|
*
|
2015-04-19 02:37:29 +02:00
|
|
|
* @return the GATT characteristic, or <code>null</code>
|
|
|
|
*/
|
|
|
|
public BluetoothGattCharacteristic getCharacteristic() {
|
|
|
|
return characteristic;
|
|
|
|
}
|
2015-04-19 11:28:03 +02:00
|
|
|
|
2015-07-03 21:58:13 +02:00
|
|
|
protected String getCreationTime() {
|
2015-07-10 21:02:03 +02:00
|
|
|
return DateFormat.getTimeInstance().format(new Date(creationTimestamp));
|
2015-07-03 21:58:13 +02:00
|
|
|
}
|
|
|
|
|
2015-04-19 02:37:29 +02:00
|
|
|
public String toString() {
|
|
|
|
BluetoothGattCharacteristic characteristic = getCharacteristic();
|
|
|
|
String uuid = characteristic == null ? "(null)" : characteristic.getUuid().toString();
|
2015-07-03 21:58:13 +02:00
|
|
|
return getCreationTime() + ": " + getClass().getSimpleName() + " on characteristic: " + uuid;
|
2015-04-19 02:37:29 +02:00
|
|
|
}
|
|
|
|
}
|