LE: Rename new MTU and connection paramter update APIs (4072da04) · Commits · e / os / android_frameworks_base

api/current.txt

+6 −6

Original line number	Diff line number	Diff line
		@@ -6318,7 +6318,6 @@ package android.bluetooth {
		method public deprecated void abortReliableWrite(android.bluetooth.BluetoothDevice);
		method public boolean beginReliableWrite();
		method public void close();
		method public boolean configureMTU(int);
		method public boolean connect();
		method public void disconnect();
		method public boolean discoverServices();
		@@ -6332,14 +6331,15 @@ package android.bluetooth {
		method public boolean readCharacteristic(android.bluetooth.BluetoothGattCharacteristic);
		method public boolean readDescriptor(android.bluetooth.BluetoothGattDescriptor);
		method public boolean readRemoteRssi();
		method public boolean requestConnectionParameterUpdate(int);
		method public boolean requestConnectionPriority(int);
		method public boolean requestMtu(int);
		method public boolean setCharacteristicNotification(android.bluetooth.BluetoothGattCharacteristic, boolean);
		method public boolean writeCharacteristic(android.bluetooth.BluetoothGattCharacteristic);
		method public boolean writeDescriptor(android.bluetooth.BluetoothGattDescriptor);
		field public static final int GATT_CONNECTION_BALANCED = 0; // 0x0
		field public static final int CONNECTION_PRIORITY_BALANCED = 0; // 0x0
		field public static final int CONNECTION_PRIORITY_HIGH = 1; // 0x1
		field public static final int CONNECTION_PRIORITY_LOW_POWER = 2; // 0x2
		field public static final int GATT_CONNECTION_CONGESTED = 143; // 0x8f
		field public static final int GATT_CONNECTION_HIGH_PRIORITY = 1; // 0x1
		field public static final int GATT_CONNECTION_LOW_POWER = 2; // 0x2
		field public static final int GATT_FAILURE = 257; // 0x101
		field public static final int GATT_INSUFFICIENT_AUTHENTICATION = 5; // 0x5
		field public static final int GATT_INSUFFICIENT_ENCRYPTION = 15; // 0xf
		@@ -6356,11 +6356,11 @@ package android.bluetooth {
		method public void onCharacteristicChanged(android.bluetooth.BluetoothGatt, android.bluetooth.BluetoothGattCharacteristic);
		method public void onCharacteristicRead(android.bluetooth.BluetoothGatt, android.bluetooth.BluetoothGattCharacteristic, int);
		method public void onCharacteristicWrite(android.bluetooth.BluetoothGatt, android.bluetooth.BluetoothGattCharacteristic, int);
		method public void onConfigureMTU(android.bluetooth.BluetoothGatt, int, int);
		method public void onConnectionCongested(android.bluetooth.BluetoothGatt, boolean);
		method public void onConnectionStateChange(android.bluetooth.BluetoothGatt, int, int);
		method public void onDescriptorRead(android.bluetooth.BluetoothGatt, android.bluetooth.BluetoothGattDescriptor, int);
		method public void onDescriptorWrite(android.bluetooth.BluetoothGatt, android.bluetooth.BluetoothGattDescriptor, int);
		method public void onMtuChanged(android.bluetooth.BluetoothGatt, int, int);
		method public void onReadRemoteRssi(android.bluetooth.BluetoothGatt, int, int);
		method public void onReliableWriteCompleted(android.bluetooth.BluetoothGatt, int);
		method public void onServicesDiscovered(android.bluetooth.BluetoothGatt, int);

core/java/android/bluetooth/BluetoothGatt.java

+16 −16

Original line number	Diff line number	Diff line
		@@ -96,19 +96,19 @@ public final class BluetoothGatt implements BluetoothProfile {
		* Bluetooth SIG. This is the default value if no connection parameter update
		* is requested.
		*/
		public static final int GATT_CONNECTION_BALANCED = 0;
		public static final int CONNECTION_PRIORITY_BALANCED = 0;

		/**
		* Connection paramter update - Request a high priority, low latency connection.
		* An application should only request high priority connection paramters to transfer
		* large amounts of data over LE quickly. Once the transfer is complete, the application
		* should request {@link BluetoothGatt#GATT_CONNECTION_BALANCED} connectoin parameters
		* should request {@link BluetoothGatt#CONNECTION_PRIORITY_BALANCED} connectoin parameters
		* to reduce energy use.
		*/
		public static final int GATT_CONNECTION_HIGH_PRIORITY = 1;
		public static final int CONNECTION_PRIORITY_HIGH = 1;

		/** Connection paramter update - Request low power, reduced data rate connection parameters. */
		public static final int GATT_CONNECTION_LOW_POWER = 2;
		public static final int CONNECTION_PRIORITY_LOW_POWER = 2;

		/**
		* No authentication required.
		@@ -601,7 +601,7 @@ public final class BluetoothGatt implements BluetoothProfile {
		return;
		}
		try {
		mCallback.onConfigureMTU(BluetoothGatt.this, mtu, status);
		mCallback.onMtuChanged(BluetoothGatt.this, mtu, status);
		} catch (Exception ex) {
		Log.w(TAG, "Unhandled exception in callback", ex);
		}
		@@ -1239,20 +1239,20 @@ public final class BluetoothGatt implements BluetoothProfile {
		}

		/**
		* Configure the MTU used for a given connection.
		* Request an MTU size used for a given connection.
		*
		* <p>When performing a write request operation (write without response),
		* the data sent is truncated to the MTU size. This function may be used
		* to request a larget MTU size to be able to send more data at once.
		* to request a larger MTU size to be able to send more data at once.
		*
		* <p>A {@link BluetoothGattCallback#onConfigureMTU} callback will indicate
		* <p>A {@link BluetoothGattCallback#onMtuChanged} callback will indicate
		* whether this operation was successful.
		*
		* <p>Requires {@link android.Manifest.permission#BLUETOOTH} permission.
		*
		* @return true, if the new MTU value has been requested successfully
		*/
		public boolean configureMTU(int mtu) {
		public boolean requestMtu(int mtu) {
		if (DBG) Log.d(TAG, "configureMTU() - device: " + mDevice.getAddress()
		+ " mtu: " + mtu);
		if (mService == null \|\| mClientIf == 0) return false;
		@@ -1274,19 +1274,19 @@ public final class BluetoothGatt implements BluetoothProfile {
		* remote device.
		*
		* @param connectionPriority Request a specific connection priority. Must be one of
		* {@link BluetoothGatt#GATT_CONNECTION_BALANCED},
		* {@link BluetoothGatt#GATT_CONNECTION_HIGH_PRIORITY}
		* or {@link BluetoothGatt#GATT_CONNECTION_LOW_POWER}.
		* {@link BluetoothGatt#CONNECTION_PRIORITY_BALANCED},
		* {@link BluetoothGatt#CONNECTION_PRIORITY_HIGH}
		* or {@link BluetoothGatt#CONNECTION_PRIORITY_LOW_POWER}.
		* @throws IllegalArgumentException If the parameters are outside of their
		* specified range.
		*/
		public boolean requestConnectionParameterUpdate(int connectionPriority) {
		if (connectionPriority < GATT_CONNECTION_BALANCED \|\|
		connectionPriority > GATT_CONNECTION_LOW_POWER) {
		public boolean requestConnectionPriority(int connectionPriority) {
		if (connectionPriority < CONNECTION_PRIORITY_BALANCED \|\|
		connectionPriority > CONNECTION_PRIORITY_LOW_POWER) {
		throw new IllegalArgumentException("connectionPriority not within valid range");
		}

		if (DBG) Log.d(TAG, "requestConnectionParameterUpdate() - params: " + connectionPriority);
		if (DBG) Log.d(TAG, "requestConnectionPriority() - params: " + connectionPriority);
		if (mService == null \|\| mClientIf == 0) return false;

		try {

core/java/android/bluetooth/BluetoothGattCallback.java

+3 −3

Original line number	Diff line number	Diff line
		@@ -143,14 +143,14 @@ public abstract class BluetoothGattCallback {
		* Callback indicating the MTU for a given device connection has changed.
		*
		* This callback is triggered in response to the
		* {@link BluetoothGatt#configureMTU} function, or in response to a connection
		* {@link BluetoothGatt#requestMtu} function, or in response to a connection
		* event.
		*
		* @param gatt GATT client invoked {@link BluetoothGatt#configureMTU}
		* @param gatt GATT client invoked {@link BluetoothGatt#requestMtu}
		* @param mtu The new MTU size
		* @param status {@link BluetoothGatt#GATT_SUCCESS} if the MTU has been changed successfully
		*/
		public void onConfigureMTU(BluetoothGatt gatt, int mtu, int status) {
		public void onMtuChanged(BluetoothGatt gatt, int mtu, int status) {
		}

		/**

core/java/android/bluetooth/BluetoothGattServerCallback.java

+1 −1

Original line number	Diff line number	Diff line
		@@ -141,7 +141,7 @@ public abstract class BluetoothGattServerCallback {
		* notifications.
		*
		* @param device The remote device the notification has been sent to
		* @param status 0 if the operation was successful
		* @param status {@link BluetoothGatt#GATT_SUCCESS} if the operation was successful
		*/
		public void onNotificationSent(BluetoothDevice device, int status) {
		}