Initial version of BLE support for Bluedroid (40b98951) · Commits · e / os / android_packages_modules_Bluetooth

framework/java/android/bluetooth/BluetoothAdapter.java

100755 → 100644

+17 −2

Original line number	Diff line number	Diff line
		@@ -1136,8 +1136,9 @@ public final class BluetoothAdapter {
		/**
		* Get the profile proxy object associated with the profile.
		*
		* <p>Profile can be one of {@link BluetoothProfile#HEALTH}, {@link BluetoothProfile#HEADSET} or
		* {@link BluetoothProfile#A2DP}. Clients must implements
		* <p>Profile can be one of {@link BluetoothProfile#HEALTH}, {@link BluetoothProfile#HEADSET},
		* {@link BluetoothProfile#A2DP}, {@link BluetoothProfile#GATT},
		* or {@link BluetoothProfile#GATT_SERVER}. Clients must implements
		* {@link BluetoothProfile.ServiceListener} to get notified of
		* the connection status and to get the proxy object.
		*
		@@ -1166,6 +1167,12 @@ public final class BluetoothAdapter {
		} else if (profile == BluetoothProfile.HEALTH) {
		BluetoothHealth health = new BluetoothHealth(context, listener);
		return true;
		} else if (profile == BluetoothProfile.GATT) {
		BluetoothGatt gatt = new BluetoothGatt(context, listener);
		return true;
		} else if (profile == BluetoothProfile.GATT_SERVER) {
		BluetoothGattServer gattServer = new BluetoothGattServer(context, listener);
		return true;
		} else {
		return false;
		}
		@@ -1206,6 +1213,14 @@ public final class BluetoothAdapter {
		BluetoothHealth health = (BluetoothHealth)proxy;
		health.close();
		break;
		case BluetoothProfile.GATT:
		BluetoothGatt gatt = (BluetoothGatt)proxy;
		gatt.close();
		break;
		case BluetoothProfile.GATT_SERVER:
		BluetoothGattServer gattServer = (BluetoothGattServer)proxy;
		gattServer.close();
		break;
		}
		}

framework/java/android/bluetooth/BluetoothGatt.java

0 → 100644

+1309 −0

File added.

Preview size limit exceeded, changes collapsed.

framework/java/android/bluetooth/BluetoothGattCallback.java

0 → 100644

+157 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2013 The Android Open Source Project
		*
		* Licensed under the Apache License, Version 2.0 (the "License");
		* you may not use this file except in compliance with the License.
		* You may obtain a copy of the License at
		*
		* http://www.apache.org/licenses/LICENSE-2.0
		*
		* Unless required by applicable law or agreed to in writing, software
		* distributed under the License is distributed on an "AS IS" BASIS,
		* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
		* See the License for the specific language governing permissions and
		* limitations under the License.
		*/

		package android.bluetooth;

		import android.bluetooth.BluetoothDevice;

		import android.util.Log;

		/**
		* This abstract class is used to implement {@link BluetoothGatt} callbacks.
		* @hide
		*/
		public abstract class BluetoothGattCallback {
		/**
		* Callback to inform change in registration state of the application.
		*
		* @param status Returns {@link BluetoothGatt#GATT_SUCCESS} if the application
		* was successfully registered.
		*/
		public void onAppRegistered(int status) {
		}

		/**
		* Callback reporting an LE device found during a device scan initiated
		* by the {@link BluetoothGatt#startScan} function.
		*
		* @param device Identifies the remote device
		* @param rssi The RSSI value for the remote device as reported by the
		* Bluetooth hardware. 0 if no RSSI value is available.
		* @param scanRecord The content of the advertisement record offered by
		* the remote device.
		*/
		public void onScanResult(BluetoothDevice device, int rssi, byte[] scanRecord) {
		}

		/**
		* Callback indicating when a remote device has been connected or disconnected.
		*
		* @param device Remote device that has been connected or disconnected.
		* @param status Status of the connect or disconnect operation.
		* @param newState Returns the new connection state. Can be one of
		* {@link BluetoothProfile#STATE_DISCONNECTED} or
		* {@link BluetoothProfile#STATE_CONNECTED}
		*/
		public void onConnectionStateChange(BluetoothDevice device, int status,
		int newState) {
		}

		/**
		* Callback invoked when the list of remote services, characteristics and
		* descriptors for the remote device have been updated.
		*
		* @param device Remote device
		* @param status {@link BluetoothGatt#GATT_SUCCESS} if the remote device
		* has been explored successfully.
		*/
		public void onServicesDiscovered(BluetoothDevice device, int status) {
		}

		/**
		* Callback reporting the result of a characteristic read operation.
		*
		* @param characteristic Characteristic that was read from the associated
		* remote device.
		* @param status {@link BluetoothGatt#GATT_SUCCESS} if the read operation
		* was completed successfully.
		*/
		public void onCharacteristicRead(BluetoothGattCharacteristic characteristic,
		int status) {
		}

		/**
		* Callback indicating the result of a characteristic write operation.
		*
		* <p>If this callback is invoked while a reliable write transaction is
		* in progress, the value of the characteristic represents the value
		* reported by the remote device. An application should compare this
		* value to the desired value to be written. If the values don't match,
		* the application must abort the reliable write transaction.
		*
		* @param characteristic Characteristic that was written to the associated
		* remote device.
		* @param status The result of the write operation
		*/
		public void onCharacteristicWrite(BluetoothGattCharacteristic characteristic,
		int status) {
		}

		/**
		* Callback triggered as a result of a remote characteristic notification.
		*
		* @param characteristic Characteristic that has been updated as a result
		* of a remote notification event.
		*/
		public void onCharacteristicChanged(BluetoothGattCharacteristic characteristic) {
		}

		/**
		* Callback reporting the result of a descriptor read operation.
		*
		* @param descriptor Descriptor that was read from the associated
		* remote device.
		* @param status {@link BluetoothGatt#GATT_SUCCESS} if the read operation
		* was completed successfully
		*/
		public void onDescriptorRead(BluetoothGattDescriptor descriptor,
		int status) {
		}

		/**
		* Callback indicating the result of a descriptor write operation.
		*
		* @param descriptor Descriptor that was writte to the associated
		* remote device.
		* @param status The result of the write operation
		*/
		public void onDescriptorWrite(BluetoothGattDescriptor descriptor,
		int status) {
		}

		/**
		* Callback invoked when a reliable write transaction has been completed.
		*
		* @param device Remote device
		* @param status {@link BluetoothGatt#GATT_SUCCESS} if the reliable write
		* transaction was executed successfully
		*/
		public void onReliableWriteCompleted(BluetoothDevice device, int status) {
		}

		/**
		* Callback reporting the RSSI for a remote device connection.
		*
		* This callback is triggered in response to the
		* {@link BluetoothGatt#readRemoteRssi} function.
		*
		* @param device Identifies the remote device
		* @param rssi The RSSI value for the remote device
		* @param status 0 if the RSSI was read successfully
		*/
		public void onReadRemoteRssi(BluetoothDevice device, int rssi, int status) {
		}
		}

framework/java/android/bluetooth/BluetoothGattCharacteristic.java

0 → 100644

+670 −0

File added.

Preview size limit exceeded, changes collapsed.

framework/java/android/bluetooth/BluetoothGattDescriptor.java

0 → 100644

+185 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2013 The Android Open Source Project
		*
		* Licensed under the Apache License, Version 2.0 (the "License");
		* you may not use this file except in compliance with the License.
		* You may obtain a copy of the License at
		*
		* http://www.apache.org/licenses/LICENSE-2.0
		*
		* Unless required by applicable law or agreed to in writing, software
		* distributed under the License is distributed on an "AS IS" BASIS,
		* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
		* See the License for the specific language governing permissions and
		* limitations under the License.
		*/

		package android.bluetooth;

		import java.util.UUID;

		/**
		* Represents a Bluetooth Gatt Descriptor
		* @hide
		*/
		public class BluetoothGattDescriptor {

		/**
		* Value used to enable notification for a client configuration descriptor
		*/
		public static final byte[] ENABLE_NOTIFICATION_VALUE = {0x01, 0x00};

		/**
		* Value used to enable indication for a client configuration descriptor
		*/
		public static final byte[] ENABLE_INDICATION_VALUE = {0x02, 0x00};

		/**
		* Value used to disable notifications or indicatinos
		*/
		public static final byte[] DISABLE_NOTIFICATION_VALUE = {0x00, 0x00};

		/**
		* Descriptor read permission
		*/
		public static final int PERMISSION_READ = 0x01;

		/**
		* Descriptor permission: Allow encrypted read operations
		*/
		public static final int PERMISSION_READ_ENCRYPTED = 0x02;

		/**
		* Descriptor permission: Allow reading with man-in-the-middle protection
		*/
		public static final int PERMISSION_READ_ENCRYPTED_MITM = 0x04;

		/**
		* Descriptor write permission
		*/
		public static final int PERMISSION_WRITE = 0x10;

		/**
		* Descriptor permission: Allow encrypted writes
		*/
		public static final int PERMISSION_WRITE_ENCRYPTED = 0x20;

		/**
		* Descriptor permission: Allow encrypted writes with man-in-the-middle
		* protection
		*/
		public static final int PERMISSION_WRITE_ENCRYPTED_MITM = 0x40;

		/**
		* Descriptor permission: Allow signed write operations
		*/
		public static final int PERMISSION_WRITE_SIGNED = 0x80;

		/**
		* Descriptor permission: Allow signed write operations with
		* man-in-the-middle protection
		*/
		public static final int PERMISSION_WRITE_SIGNED_MITM = 0x100;

		/**
		* The UUID of this descriptor.
		* @hide
		*/
		protected UUID mUuid;

		/**
		* Permissions for this descriptor
		* @hide
		*/
		protected int mPermissions;

		/**
		* Back-reference to the characteristic this descriptor belongs to.
		* @hide
		*/
		protected BluetoothGattCharacteristic mCharacteristic;

		/**
		* The value for this descriptor.
		* @hide
		*/
		protected byte[] mValue;

		/**
		* Create a new BluetoothGattDescriptor.
		* <p>Requires {@link android.Manifest.permission#BLUETOOTH} permission.
		*
		* @param characteristic The characteristic this descriptor belongs to
		* @param uuid The UUID for this descriptor
		* @param permissions Permissions for this descriptor
		*/
		/package/ BluetoothGattDescriptor(BluetoothGattCharacteristic characteristic, UUID uuid,
		int permissions) {
		mCharacteristic = characteristic;
		mUuid = uuid;
		mPermissions = permissions;
		}

		/**
		* Returns the characteristic this descriptor belongs to.
		* @return The characteristic.
		*/
		public BluetoothGattCharacteristic getCharacteristic() {
		return mCharacteristic;
		}

		/**
		* Returns the UUID of this descriptor.
		* <p>Requires {@link android.Manifest.permission#BLUETOOTH} permission.
		*
		* @return UUID of this descriptor
		*/
		public UUID getUuid() {
		return mUuid;
		}

		/**
		* Returns the permissions for this descriptor.
		* <p>Requires {@link android.Manifest.permission#BLUETOOTH} permission.
		*
		* @return Permissions of this descriptor
		*/
		public int getPermissions() {
		return mPermissions;
		}

		/**
		* Returns the stored value for this descriptor
		*
		* <p>This function returns the stored value for this descriptor as
		* retrieved by calling {@link BluetoothGatt#readDescriptor}. To cached
		* value of the descriptor is updated as a result of a descriptor read
		* operation.
		*
		* <p>Requires {@link android.Manifest.permission#BLUETOOTH} permission.
		*
		* @return Cached value of the descriptor
		*/
		public byte[] getValue() {
		return mValue;
		}

		/**
		* Updates the locally stored value of this descriptor.
		*
		* <p>This function modifies the locally stored cached value of this
		* descriptor. To send the value to the remote device, call
		* {@link BluetoothGatt#writeDescriptor} to send the value to the
		* remote device.
		*
		* <p>Requires {@link android.Manifest.permission#BLUETOOTH} permission.
		*
		* @param value New value for this descriptor
		* @return true if the locally stored value has been set, false if the
		* requested value could not be stored locally.
		*/
		public boolean setValue(byte[] value) {
		mValue = value;
		return true;
		}
		}