BluetoothDevice.java revision 105925376f8d0f6b318c9938c7b83ef7fef094da
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.bluetooth; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.UnsupportedEncodingException; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The Android Bluetooth API is not finalized, and *will* change. Use at your 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * own risk. 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Manages the local Bluetooth device. Scan for devices, create bondings, 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * power up and down the adapter. 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class BluetoothDevice { 34105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project 35105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project public static final int BLUETOOTH_STATE_OFF = 0; 36105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project public static final int BLUETOOTH_STATE_TURNING_ON = 1; 37105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project public static final int BLUETOOTH_STATE_ON = 2; 38105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project public static final int BLUETOOTH_STATE_TURNING_OFF = 3; 39105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Inquiry scan and page scan are both off. 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Device is neither discoverable nor connectable */ 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SCAN_MODE_NONE = 0; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Page scan is on, inquiry scan is off. 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Device is connectable, but not discoverable */ 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SCAN_MODE_CONNECTABLE = 1; 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Page scan and inquiry scan are on. 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Device is connectable and discoverable */ 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int SCAN_MODE_CONNECTABLE_DISCOVERABLE = 3; 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RESULT_FAILURE = -1; 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int RESULT_SUCCESS = 0; 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** We do not have a link key for the remote device, and are therefore not 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bonded */ 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int BOND_NOT_BONDED = 0; 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** We have a link key for the remote device, and are probably bonded. */ 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int BOND_BONDED = 1; 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** We are currently attempting bonding */ 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int BOND_BONDING = 2; 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //TODO: Unify these result codes in BluetoothResult or BluetoothError 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A bond attempt failed because pins did not match, or remote device did 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not respond to pin request in time */ 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int UNBOND_REASON_AUTH_FAILED = 1; 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A bond attempt failed because the other side explicilty rejected 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bonding */ 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int UNBOND_REASON_AUTH_REJECTED = 2; 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A bond attempt failed because we canceled the bonding process */ 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int UNBOND_REASON_AUTH_CANCELED = 3; 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A bond attempt failed because we could not contact the remote device */ 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int UNBOND_REASON_REMOTE_DEVICE_DOWN = 4; 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A bond attempt failed because a discovery is in progress */ 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int UNBOND_REASON_DISCOVERY_IN_PROGRESS = 5; 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** An existing bond was explicitly revoked */ 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int UNBOND_REASON_REMOVED = 6; 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String TAG = "BluetoothDevice"; 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IBluetoothDevice mService; 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide - hide this because it takes a parameter of type 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IBluetoothDevice, which is a System private class. 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Also note that Context.getSystemService is a factory that 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returns a BlueToothDevice. That is the right way to get 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a BluetoothDevice. 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public BluetoothDevice(IBluetoothDevice service) { 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService = service; 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 92105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * Is Bluetooth currently turned on. 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if Bluetooth enabled, false otherwise. 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isEnabled() { 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.isEnabled(); 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 104105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * Get the current state of Bluetooth. 105105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * 106105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * @return One of BLUETOOTH_STATE_ or BluetoothError.ERROR. 107105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project */ 108105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project public int getBluetoothState() { 109105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project try { 110105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project return mService.getBluetoothState(); 111105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 112105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project return BluetoothError.ERROR; 113105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project } 114105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project 115105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project /** 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enable the Bluetooth device. 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Turn on the underlying hardware. 118105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * This is an asynchronous call, 119105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * BluetoothIntent.BLUETOOTH_STATE_CHANGED_ACTION can be used to check if 120105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * and when the device is sucessfully enabled. 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return false if we cannot enable the Bluetooth device. True does not 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * imply the device was enabled, it only implies that so far there were no 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * problems. 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean enable() { 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 127105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project return mService.enable(); 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable the Bluetooth device. 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This turns off the underlying hardware. 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if successful, false otherwise. 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disable() { 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 140105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project return mService.disable(true); 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getAddress() { 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getAddress(); 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the friendly Bluetooth name of this device. 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This name is visible to remote Bluetooth devices. Currently it is only 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * possible to retrieve the Bluetooth name when Bluetooth is enabled. 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the Bluetooth name, or null if there was a problem. 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getName() { 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getName(); 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the friendly Bluetooth name of this device. 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This name is visible to remote Bluetooth devices. The Bluetooth Service 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is responsible for persisting this name. 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param name the name to set 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true, if the name was successfully set. False otherwise. 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean setName(String name) { 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.setName(name); 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getVersion() { 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getVersion(); 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getRevision() { 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getRevision(); 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getManufacturer() { 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getManufacturer(); 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getCompany() { 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getCompany(); 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the current scan mode. 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used to determine if the local device is connectable and/or discoverable 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Scan mode, one of SCAN_MODE_* or an error code 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getScanMode() { 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getScanMode(); 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return BluetoothError.ERROR_IPC; 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the current scan mode. 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used to make the local device connectable and/or discoverable 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param scanMode One of SCAN_MODE_* 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setScanMode(int scanMode) { 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.setScanMode(scanMode); 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getDiscoverableTimeout() { 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getDiscoverableTimeout(); 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setDiscoverableTimeout(int timeout) { 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.setDiscoverableTimeout(timeout); 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean startDiscovery() { 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return startDiscovery(true); 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean startDiscovery(boolean resolveNames) { 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.startDiscovery(resolveNames); 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void cancelDiscovery() { 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.cancelDiscovery(); 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isDiscovering() { 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.isDiscovering(); 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean startPeriodicDiscovery() { 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.startPeriodicDiscovery(); 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean stopPeriodicDiscovery() { 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.stopPeriodicDiscovery(); 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isPeriodicDiscovery() { 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.isPeriodicDiscovery(); 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String[] listRemoteDevices() { 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.listRemoteDevices(); 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * List remote devices that have a low level (ACL) connection. 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * RFCOMM, SDP and L2CAP are all built on ACL connections. Devices can have 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an ACL connection even when not paired - this is common for SDP queries 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or for in-progress pairing requests. 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * In most cases you probably want to test if a higher level protocol is 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connected, rather than testing ACL connections. 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return bluetooth hardware addresses of remote devices with a current 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ACL connection. Array size is 0 if no devices have a 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connection. Null on error. 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String[] listAclConnections() { 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.listAclConnections(); 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check if a specified remote device has a low level (ACL) connection. 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * RFCOMM, SDP and L2CAP are all built on ACL connections. Devices can have 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an ACL connection even when not paired - this is common for SDP queries 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or for in-progress pairing requests. 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * In most cases you probably want to test if a higher level protocol is 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connected, rather than testing ACL connections. 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param address the Bluetooth hardware address you want to check. 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if there is an ACL connection, false otherwise and on 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error. 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isAclConnected(String address) { 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.isAclConnected(address); 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform a low level (ACL) disconnection of a remote device. 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This forcably disconnects the ACL layer connection to a remote device, 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which will cause all RFCOMM, SDP and L2CAP connections to this remote 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * device to close. 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param address the Bluetooth hardware address you want to disconnect. 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the device was disconnected, false otherwise and on 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error. 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disconnectRemoteDeviceAcl(String address) { 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.disconnectRemoteDeviceAcl(address); 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create a bonding with a remote bluetooth device. 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is an asynchronous call. The result of this bonding attempt can be 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * observed through BluetoothIntent.BOND_STATE_CHANGED_ACTION intents. 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param address the remote device Bluetooth address. 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return false If there was an immediate problem creating the bonding, 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * true otherwise. 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean createBond(String address) { 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.createBond(address); 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Cancel an in-progress bonding request started with createBond. 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean cancelBondProcess(String address) { 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.cancelBondProcess(address); 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remove an already exisiting bonding (delete the link key). 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean removeBond(String address) { 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.removeBond(address); 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * List remote devices that are bonded (paired) to the local device. 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bonding (pairing) is the process by which the user enters a pin code for 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the device, which generates a shared link key, allowing for 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * authentication and encryption of future connections. In Android we 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * require bonding before RFCOMM or SCO connections can be made to a remote 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * device. 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This function lists which remote devices we have a link key for. It does 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not cause any RF transmission, and does not check if the remote device 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still has it's link key with us. If the other side no longer has its 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * link key then the RFCOMM or SCO connection attempt will result in an 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error. 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This function does not check if the remote device is in range. 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remote devices that have an in-progress bonding attempt are not 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returned. 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return bluetooth hardware addresses of remote devices that are 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bonded. Array size is 0 if no devices are bonded. Null on error. 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String[] listBonds() { 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.listBonds(); 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the bonding state of a remote device. 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Result is one of: 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * BluetoothError.* 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * BOND_* 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param address Bluetooth hardware address of the remote device to check. 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Result code 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getBondState(String address) { 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getBondState(address); 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return BluetoothError.ERROR_IPC; 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getRemoteName(String address) { 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getRemoteName(address); 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getRemoteVersion(String address) { 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getRemoteVersion(address); 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getRemoteRevision(String address) { 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getRemoteRevision(address); 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getRemoteManufacturer(String address) { 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getRemoteManufacturer(address); 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getRemoteCompany(String address) { 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getRemoteCompany(address); 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the RFCOMM channel associated with the 16-byte UUID on 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the remote Bluetooth address. 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Performs a SDP ServiceSearchAttributeRequest transaction. The provided 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * uuid is verified in the returned record. If there was a problem, or the 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified uuid does not exist, -1 is returned. 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean getRemoteServiceChannel(String address, short uuid16, 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IBluetoothDeviceCallback callback) { 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getRemoteServiceChannel(address, uuid16, callback); 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the major, minor and servics classes of a remote device. 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * These classes are encoded as a 32-bit integer. See BluetoothClass. 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param address remote device 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return 32-bit class suitable for use with BluetoothClass. 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRemoteClass(String address) { 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getRemoteClass(address); 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return BluetoothClass.ERROR; 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public byte[] getRemoteFeatures(String address) { 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getRemoteFeatures(address); 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String lastSeen(String address) { 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.lastSeen(address); 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String lastUsed(String address) { 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.lastUsed(address); 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean setPin(String address, byte[] pin) { 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.setPin(address, pin); 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean cancelPin(String address) { 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.cancelPin(address); 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check that a pin is valid and convert to byte array. 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bluetooth pin's are 1 to 16 bytes of UTF8 characters. 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pin pin as java String 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the pin code as a UTF8 byte array, or null if it is an invalid 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bluetooth pin. 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static byte[] convertPinToBytes(String pin) { 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (pin == null) { 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] pinBytes; 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pinBytes = pin.getBytes("UTF8"); 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (UnsupportedEncodingException uee) { 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "UTF8 not supported?!?"); // this should not happen 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (pinBytes.length <= 0 || pinBytes.length > 16) { 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return pinBytes; 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ADDRESS_LENGTH = 17; 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Sanity check a bluetooth address, such as "00:43:A8:23:10:F0" */ 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static boolean checkBluetoothAddress(String address) { 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (address == null || address.length() != ADDRESS_LENGTH) { 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < ADDRESS_LENGTH; i++) { 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char c = address.charAt(i); 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (i % 3) { 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 0: 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 1: 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Character.digit(c, 16) != -1) { 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; // hex character, OK 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 2: 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (c == ':') { 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; // OK 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 579