/* * 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.Manifest; import android.annotation.RequiresPermission; import android.content.Context; import android.os.RemoteException; import android.util.Log; import java.util.ArrayList; import java.util.List; /** * High level manager used to obtain an instance of an {@link BluetoothAdapter} * and to conduct overall Bluetooth Management. *

* Use {@link android.content.Context#getSystemService(java.lang.String)} * with {@link Context#BLUETOOTH_SERVICE} to create an {@link BluetoothManager}, * then call {@link #getAdapter} to obtain the {@link BluetoothAdapter}. *

* Alternately, you can just call the static helper * {@link BluetoothAdapter#getDefaultAdapter()}. * *

*

Developer Guides

*

* For more information about using BLUETOOTH, read the Bluetooth developer * guide. *

*
* * @see Context#getSystemService * @see BluetoothAdapter#getDefaultAdapter() */ public final class BluetoothManager { private static final String TAG = "BluetoothManager"; private static final boolean DBG = true; private static final boolean VDBG = true; private final BluetoothAdapter mAdapter; /** * @hide */ public BluetoothManager(Context context) { context = context.getApplicationContext(); if (context == null) { throw new IllegalArgumentException( "context not associated with any application (using a mock context?)"); } // Legacy api - getDefaultAdapter does not take in the context mAdapter = BluetoothAdapter.getDefaultAdapter(); } /** * Get the default BLUETOOTH Adapter for this device. * * @return the default BLUETOOTH Adapter */ public BluetoothAdapter getAdapter() { return mAdapter; } /** * Get the current connection state of the profile to the remote device. * *

This is not specific to any application configuration but represents * the connection state of the local Bluetooth adapter for certain profile. * This can be used by applications like status bar which would just like * to know the state of Bluetooth. * *

Requires {@link android.Manifest.permission#BLUETOOTH} permission. * * @param device Remote bluetooth device. * @param profile GATT or GATT_SERVER * @return State of the profile connection. One of * {@link BluetoothProfile#STATE_CONNECTED}, {@link BluetoothProfile#STATE_CONNECTING}, * {@link BluetoothProfile#STATE_DISCONNECTED}, * {@link BluetoothProfile#STATE_DISCONNECTING} */ @RequiresPermission(Manifest.permission.BLUETOOTH) public int getConnectionState(BluetoothDevice device, int profile) { if (DBG) Log.d(TAG,"getConnectionState()"); List connectedDevices = getConnectedDevices(profile); for(BluetoothDevice connectedDevice : connectedDevices) { if (device.equals(connectedDevice)) { return BluetoothProfile.STATE_CONNECTED; } } return BluetoothProfile.STATE_DISCONNECTED; } /** * Get connected devices for the specified profile. * *

Return the set of devices which are in state {@link BluetoothProfile#STATE_CONNECTED} * *

This is not specific to any application configuration but represents * the connection state of Bluetooth for this profile. * This can be used by applications like status bar which would just like * to know the state of Bluetooth. * *

Requires {@link android.Manifest.permission#BLUETOOTH} permission. * * @param profile GATT or GATT_SERVER * @return List of devices. The list will be empty on error. */ @RequiresPermission(Manifest.permission.BLUETOOTH) public List getConnectedDevices(int profile) { if (DBG) Log.d(TAG,"getConnectedDevices"); if (profile != BluetoothProfile.GATT && profile != BluetoothProfile.GATT_SERVER) { throw new IllegalArgumentException("Profile not supported: " + profile); } List connectedDevices = new ArrayList(); try { IBluetoothManager managerService = mAdapter.getBluetoothManager(); IBluetoothGatt iGatt = managerService.getBluetoothGatt(); if (iGatt == null) return connectedDevices; connectedDevices = iGatt.getDevicesMatchingConnectionStates( new int[] { BluetoothProfile.STATE_CONNECTED }); } catch (RemoteException e) { Log.e(TAG,"",e); } return connectedDevices; } /** * * Get a list of devices that match any of the given connection * states. * *

If none of the devices match any of the given states, * an empty list will be returned. * *

This is not specific to any application configuration but represents * the connection state of the local Bluetooth adapter for this profile. * This can be used by applications like status bar which would just like * to know the state of the local adapter. * *

Requires {@link android.Manifest.permission#BLUETOOTH} permission. * * @param profile GATT or GATT_SERVER * @param states Array of states. States can be one of * {@link BluetoothProfile#STATE_CONNECTED}, {@link BluetoothProfile#STATE_CONNECTING}, * {@link BluetoothProfile#STATE_DISCONNECTED}, * {@link BluetoothProfile#STATE_DISCONNECTING}, * @return List of devices. The list will be empty on error. */ @RequiresPermission(Manifest.permission.BLUETOOTH) public List getDevicesMatchingConnectionStates(int profile, int[] states) { if (DBG) Log.d(TAG,"getDevicesMatchingConnectionStates"); if (profile != BluetoothProfile.GATT && profile != BluetoothProfile.GATT_SERVER) { throw new IllegalArgumentException("Profile not supported: " + profile); } List devices = new ArrayList(); try { IBluetoothManager managerService = mAdapter.getBluetoothManager(); IBluetoothGatt iGatt = managerService.getBluetoothGatt(); if (iGatt == null) return devices; devices = iGatt.getDevicesMatchingConnectionStates(states); } catch (RemoteException e) { Log.e(TAG,"",e); } return devices; } /** * Open a GATT Server * The callback is used to deliver results to Caller, such as connection status as well * as the results of any other GATT server operations. * The method returns a BluetoothGattServer instance. You can use BluetoothGattServer * to conduct GATT server operations. * @param context App context * @param callback GATT server callback handler that will receive asynchronous callbacks. * @return BluetoothGattServer instance */ public BluetoothGattServer openGattServer(Context context, BluetoothGattServerCallback callback) { return (openGattServer (context, callback, BluetoothDevice.TRANSPORT_AUTO)); } /** * Open a GATT Server * The callback is used to deliver results to Caller, such as connection status as well * as the results of any other GATT server operations. * The method returns a BluetoothGattServer instance. You can use BluetoothGattServer * to conduct GATT server operations. * @param context App context * @param callback GATT server callback handler that will receive asynchronous callbacks. * @param transport preferred transport for GATT connections to remote dual-mode devices * {@link BluetoothDevice#TRANSPORT_AUTO} or * {@link BluetoothDevice#TRANSPORT_BREDR} or {@link BluetoothDevice#TRANSPORT_LE} * @return BluetoothGattServer instance * @hide */ public BluetoothGattServer openGattServer(Context context, BluetoothGattServerCallback callback,int transport) { if (context == null || callback == null) { throw new IllegalArgumentException("null parameter: " + context + " " + callback); } // TODO(Bluetooth) check whether platform support BLE // Do the check here or in GattServer? try { IBluetoothManager managerService = mAdapter.getBluetoothManager(); IBluetoothGatt iGatt = managerService.getBluetoothGatt(); if (iGatt == null) { Log.e(TAG, "Fail to get GATT Server connection"); return null; } BluetoothGattServer mGattServer = new BluetoothGattServer(iGatt,transport); Boolean regStatus = mGattServer.registerCallback(callback); return regStatus? mGattServer : null; } catch (RemoteException e) { Log.e(TAG,"",e); return null; } } }