Sl4aBluetoothUtil
public
class
Sl4aBluetoothUtil
extends Object
java.lang.Object
|
↳ |
com.android.tradefed.util.Sl4aBluetoothUtil
|
A utility class provides Bluetooth operations on one or two devices using SL4A
Summary
Public methods |
boolean
|
changeProfileAccessPermission(ITestDevice primary, ITestDevice secondary, Sl4aBluetoothUtil.BluetoothProfile profile, Sl4aBluetoothUtil.BluetoothAccessLevel access)
Change Bluetooth profile access permission of secondary device on primary device in order for
secondary device to access primary device on the given profile
|
boolean
|
connect(ITestDevice primary, ITestDevice secondary, profiles)
Connect primary device to secondary device on given Bluetooth profiles
|
boolean
|
disable(ITestDevice device)
Disable Bluetooth on target device
|
boolean
|
disableBluetoothSnoopLog(ITestDevice device)
Disable Bluetooth snoop log
|
boolean
|
disconnect(ITestDevice primary, ITestDevice secondary, profiles)
Disconnect primary device from secondary device
|
boolean
|
enable(ITestDevice device)
Enable Bluetooth on target device
|
boolean
|
enableBluetoothSnoopLog(ITestDevice device)
Enable Bluetooth snoop log
|
String
|
getAddress(ITestDevice device)
Get Bluetooth MAC Address of target device
|
|
getBondedDevices(ITestDevice device)
Get set of Bluetooth MAC addresses of the bonded (paired) devices on the target device
|
boolean
|
pair(ITestDevice primary, ITestDevice secondary)
Pair primary device to secondary device
|
void
|
setBtConnectionTimeout(Duration timeout)
|
void
|
setBtPairTimeout(Duration timeout)
|
boolean
|
setProfilePriority(ITestDevice primary, ITestDevice secondary, profiles, Sl4aBluetoothUtil.BluetoothPriorityLevel priority)
Change priority setting of given profiles on primary device towards secondary device
|
void
|
startSl4a(ITestDevice device, File sl4aApkFile)
Explicitly start SL4A client with the given device and SL4A apk file.
|
void
|
stopSl4a()
Stop SL4A clients that already being opened.
|
boolean
|
unpairAll(ITestDevice device)
Un-pair all paired devices for current device
|
Protected methods |
void
|
finalize()
Clean up all SL4A connections
|
Public constructors
Sl4aBluetoothUtil
public Sl4aBluetoothUtil ()
Public methods
changeProfileAccessPermission
public boolean changeProfileAccessPermission (ITestDevice primary,
ITestDevice secondary,
Sl4aBluetoothUtil.BluetoothProfile profile,
Sl4aBluetoothUtil.BluetoothAccessLevel access)
Change Bluetooth profile access permission of secondary device on primary device in order for
secondary device to access primary device on the given profile
Parameters |
primary |
ITestDevice : device to change permission |
secondary |
ITestDevice : device that accesses primary device on the given profile |
profile |
Sl4aBluetoothUtil.BluetoothProfile : Bluetooth profile to access |
access |
Sl4aBluetoothUtil.BluetoothAccessLevel : level of access, see BluetoothAccessLevel |
Returns |
boolean |
true if permission changed successfully |
connect
public boolean connect (ITestDevice primary,
ITestDevice secondary,
profiles)
Connect primary device to secondary device on given Bluetooth profiles
Parameters |
primary |
ITestDevice : device to connect from |
secondary |
ITestDevice : device to connect to |
profiles |
: A set of Bluetooth profiles are required to be connected |
Returns |
boolean |
true if connection are successful |
disable
public boolean disable (ITestDevice device)
Disable Bluetooth on target device
Parameters |
device |
ITestDevice : target device |
Returns |
boolean |
true if Bluetooth successfully disabled |
disableBluetoothSnoopLog
public boolean disableBluetoothSnoopLog (ITestDevice device)
Disable Bluetooth snoop log
Parameters |
device |
ITestDevice : to disable snoop log |
Returns |
boolean |
true if disabled successfully |
disconnect
public boolean disconnect (ITestDevice primary,
ITestDevice secondary,
profiles)
Disconnect primary device from secondary device
Parameters |
primary |
ITestDevice : device to perform disconnect operation |
secondary |
ITestDevice : device to be disconnected |
profiles |
: Given set of Bluetooth profiles required to be disconnected |
Returns |
boolean |
true if disconnected successfully |
enable
public boolean enable (ITestDevice device)
Enable Bluetooth on target device
Parameters |
device |
ITestDevice : target device |
Returns |
boolean |
true if Bluetooth successfully enabled |
enableBluetoothSnoopLog
public boolean enableBluetoothSnoopLog (ITestDevice device)
Enable Bluetooth snoop log
Parameters |
device |
ITestDevice : to enable snoop log |
Returns |
boolean |
true if enabled successfully |
getAddress
public String getAddress (ITestDevice device)
Get Bluetooth MAC Address of target device
Parameters |
device |
ITestDevice : target device |
Returns |
String |
MAC Address string |
getBondedDevices
public getBondedDevices (ITestDevice device)
Get set of Bluetooth MAC addresses of the bonded (paired) devices on the target device
Parameters |
device |
ITestDevice : target device |
Returns |
|
Set of Bluetooth MAC addresses |
pair
public boolean pair (ITestDevice primary,
ITestDevice secondary)
Pair primary device to secondary device
Parameters |
primary |
ITestDevice : device to pair from |
secondary |
ITestDevice : device to pair to |
Returns |
boolean |
true if pairing is successful |
setBtConnectionTimeout
public void setBtConnectionTimeout (Duration timeout)
Parameters |
timeout |
Duration |
setBtPairTimeout
public void setBtPairTimeout (Duration timeout)
Parameters |
timeout |
Duration |
setProfilePriority
public boolean setProfilePriority (ITestDevice primary,
ITestDevice secondary,
profiles,
Sl4aBluetoothUtil.BluetoothPriorityLevel priority)
Change priority setting of given profiles on primary device towards secondary device
Parameters |
primary |
ITestDevice : device to set priority on |
secondary |
ITestDevice : device to set priority for |
profiles |
: Bluetooth profiles to change priority setting |
priority |
Sl4aBluetoothUtil.BluetoothPriorityLevel : level of priority |
Returns |
boolean |
true if set priority successfully |
startSl4a
public void startSl4a (ITestDevice device,
File sl4aApkFile)
Explicitly start SL4A client with the given device and SL4A apk file. Normally this method is
not required, because SL4A connection will always be established before actual operations.
Parameters |
device |
ITestDevice : the device to be connected using SL4A |
sl4aApkFile |
File : the optional SL4A apk to install and use. |
stopSl4a
public void stopSl4a ()
Stop SL4A clients that already being opened. It basically provide a way to cleanup clients
immediately after they are no longer used
unpairAll
public boolean unpairAll (ITestDevice device)
Un-pair all paired devices for current device
Parameters |
device |
ITestDevice : Current device to perform the action |
Returns |
boolean |
true if un-pair successfully |
Protected methods
finalize
protected void finalize ()
Clean up all SL4A connections