BluetoothDevice.java revision b0eca41de0bb6747d8648b134912782e45e4cbef
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 77b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh /* The user will be prompted to enter a pin */ 78b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh public static final int PAIRING_VARIANT_PIN = 0; 79b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh /* The user will be prompted to enter a passkey */ 80b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh public static final int PAIRING_VARIANT_PASSKEY = 1; 81b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh /* The user will be prompted to confirm the passkey displayed on the screen */ 82b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh public static final int PAIRING_VARIANT_CONFIRMATION = 2; 83b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh 84b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String TAG = "BluetoothDevice"; 86d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IBluetoothDevice mService; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide - hide this because it takes a parameter of type 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IBluetoothDevice, which is a System private class. 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Also note that Context.getSystemService is a factory that 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returns a BlueToothDevice. That is the right way to get 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a BluetoothDevice. 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public BluetoothDevice(IBluetoothDevice service) { 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService = service; 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 100105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * Is Bluetooth currently turned on. 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if Bluetooth enabled, false otherwise. 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isEnabled() { 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.isEnabled(); 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 112105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * Get the current state of Bluetooth. 113105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * 114105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * @return One of BLUETOOTH_STATE_ or BluetoothError.ERROR. 115105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project */ 116105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project public int getBluetoothState() { 117105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project try { 118105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project return mService.getBluetoothState(); 119105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 120105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project return BluetoothError.ERROR; 121105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project } 122105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project 123105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project /** 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enable the Bluetooth device. 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Turn on the underlying hardware. 126105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * This is an asynchronous call, 127105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * BluetoothIntent.BLUETOOTH_STATE_CHANGED_ACTION can be used to check if 128105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project * and when the device is sucessfully enabled. 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return false if we cannot enable the Bluetooth device. True does not 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * imply the device was enabled, it only implies that so far there were no 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * problems. 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean enable() { 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 135105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project return mService.enable(); 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable the Bluetooth device. 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This turns off the underlying hardware. 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if successful, false otherwise. 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disable() { 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 148105925376f8d0f6b318c9938c7b83ef7fef094daThe Android Open Source Project return mService.disable(true); 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getAddress() { 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getAddress(); 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the friendly Bluetooth name of this device. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This name is visible to remote Bluetooth devices. Currently it is only 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * possible to retrieve the Bluetooth name when Bluetooth is enabled. 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the Bluetooth name, or null if there was a problem. 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getName() { 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getName(); 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the friendly Bluetooth name of this device. 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This name is visible to remote Bluetooth devices. The Bluetooth Service 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is responsible for persisting this name. 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param name the name to set 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true, if the name was successfully set. False otherwise. 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean setName(String name) { 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.setName(name); 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the current scan mode. 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used to determine if the local device is connectable and/or discoverable 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Scan mode, one of SCAN_MODE_* or an error code 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getScanMode() { 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getScanMode(); 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return BluetoothError.ERROR_IPC; 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the current scan mode. 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Used to make the local device connectable and/or discoverable 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param scanMode One of SCAN_MODE_* 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setScanMode(int scanMode) { 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.setScanMode(scanMode); 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getDiscoverableTimeout() { 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getDiscoverableTimeout(); 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setDiscoverableTimeout(int timeout) { 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.setDiscoverableTimeout(timeout); 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean startDiscovery() { 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 228d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh return mService.startDiscovery(); 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void cancelDiscovery() { 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.cancelDiscovery(); 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isDiscovering() { 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.isDiscovering(); 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 247d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh * Removes the remote device and the pairing information associated 248d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh * with it. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param address the Bluetooth hardware address you want to disconnect. 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the device was disconnected, false otherwise and on 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error. 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 254d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh public boolean removeBond(String address) { 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 256d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh return mService.removeBond(address); 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create a bonding with a remote bluetooth device. 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is an asynchronous call. The result of this bonding attempt can be 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * observed through BluetoothIntent.BOND_STATE_CHANGED_ACTION intents. 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param address the remote device Bluetooth address. 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return false If there was an immediate problem creating the bonding, 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * true otherwise. 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean createBond(String address) { 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.createBond(address); 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Cancel an in-progress bonding request started with createBond. 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean cancelBondProcess(String address) { 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.cancelBondProcess(address); 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * List remote devices that are bonded (paired) to the local device. 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bonding (pairing) is the process by which the user enters a pin code for 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the device, which generates a shared link key, allowing for 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * authentication and encryption of future connections. In Android we 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * require bonding before RFCOMM or SCO connections can be made to a remote 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * device. 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This function lists which remote devices we have a link key for. It does 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not cause any RF transmission, and does not check if the remote device 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still has it's link key with us. If the other side no longer has its 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * link key then the RFCOMM or SCO connection attempt will result in an 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error. 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This function does not check if the remote device is in range. 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remote devices that have an in-progress bonding attempt are not 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returned. 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return bluetooth hardware addresses of remote devices that are 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bonded. Array size is 0 if no devices are bonded. Null on error. 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String[] listBonds() { 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.listBonds(); 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the bonding state of a remote device. 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Result is one of: 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * BluetoothError.* 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * BOND_* 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param address Bluetooth hardware address of the remote device to check. 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Result code 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getBondState(String address) { 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getBondState(address); 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return BluetoothError.ERROR_IPC; 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getRemoteName(String address) { 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getRemoteName(address); 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRemoteClass(String address) { 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getRemoteClass(address); 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 346d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh return BluetoothError.ERROR_IPC; 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 349d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh public String[] getRemoteUuids(String address) { 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 351d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh return mService.getRemoteUuids(address); 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 355d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh 356d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh public int getRemoteServiceChannel(String address, String uuid) { 357d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh try { 358d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh return mService.getRemoteServiceChannel(address, uuid); 359d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh } catch (RemoteException e) {Log.e(TAG, "", e);} 360d5ac1ae36b4e096eb97984334f86d0c68abea2f7Jaikumar Ganesh return BluetoothError.ERROR_IPC; 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean setPin(String address, byte[] pin) { 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.setPin(address, pin); 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 369b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh 370b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh public boolean setPasskey(String address, int passkey) { 371b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh try { 372b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh return mService.setPasskey(address, passkey); 373b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh } catch (RemoteException e) {Log.e(TAG, "", e);} 374b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh return false; 375b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh } 376b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh 377b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh public boolean setPairingConfirmation(String address, boolean confirm) { 378b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh try { 379b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh return mService.setPairingConfirmation(address, confirm); 380b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh } catch (RemoteException e) {Log.e(TAG, "", e);} 381b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh return false; 382b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh } 383b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh 384b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh public boolean cancelPairingUserInput(String address) { 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 386b0eca41de0bb6747d8648b134912782e45e4cbefJaikumar Ganesh return mService.cancelPairingUserInput(address); 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) {Log.e(TAG, "", e);} 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check that a pin is valid and convert to byte array. 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bluetooth pin's are 1 to 16 bytes of UTF8 characters. 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pin pin as java String 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the pin code as a UTF8 byte array, or null if it is an invalid 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Bluetooth pin. 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static byte[] convertPinToBytes(String pin) { 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (pin == null) { 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] pinBytes; 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project pinBytes = pin.getBytes("UTF8"); 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (UnsupportedEncodingException uee) { 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.e(TAG, "UTF8 not supported?!?"); // this should not happen 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (pinBytes.length <= 0 || pinBytes.length > 16) { 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return pinBytes; 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int ADDRESS_LENGTH = 17; 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Sanity check a bluetooth address, such as "00:43:A8:23:10:F0" */ 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static boolean checkBluetoothAddress(String address) { 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (address == null || address.length() != ADDRESS_LENGTH) { 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < ADDRESS_LENGTH; i++) { 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char c = address.charAt(i); 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (i % 3) { 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 0: 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 1: 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Character.digit(c, 16) != -1) { 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; // hex character, OK 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case 2: 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (c == ':') { 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; // OK 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return true; 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 441