bluetooth_AdapterLEAdvertising: BLE advertising intervals autotest
Verify that the bluetooth adapter of a DUT could behave as a bluetooth
low-energy device and advertise with correct data and parameters.
Specifically, the following subtests are executed in this autotest.
- test_register_advertisement
- test_set_advertising_intervals
- test_reset_advertising
Note that testing about multi-advertisements is not included. The two
control files provide two distinct advertisement data cannot be run
in parallel for now. We may support multi-advertisements testing later.
CQ-DEPEND=CL:390191
BUG=chromium:602461
TEST=Conduct the autotest as follows:
(cr) $ test_that --board=$BOARD $DUT_IP bluetooth_AdapterLEAdvertising
or
(cr) $ test_that --board=$BOARD $DUT_IP bluetooth_AdapterLEAdvertising.case2
Change-Id: I7713e3c322ef74ec59ae401f9b6d67c3718c2568
Reviewed-on: https://chromium-review.googlesource.com/394578
Commit-Ready: Shyh-In Hwang <josephsih@chromium.org>
Tested-by: Shyh-In Hwang <josephsih@chromium.org>
Tested-by: Miao-chen Chou <mcchou@chromium.org>
Reviewed-by: Miao-chen Chou <mcchou@chromium.org>
diff --git a/client/cros/bluetooth/advertisement.py b/client/cros/bluetooth/advertisement.py
new file mode 100755
index 0000000..0f94fc1
--- /dev/null
+++ b/client/cros/bluetooth/advertisement.py
@@ -0,0 +1,150 @@
+# Copyright 2016 The Chromium OS Authors. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Construction of an Advertisement object from an advertisement data
+dictionary.
+
+Much of this module refers to the code of test/example-advertisement in
+bluez project.
+"""
+
+import dbus
+import dbus.mainloop.glib
+import dbus.service
+import gobject
+import logging
+
+
+DBUS_PROP_IFACE = 'org.freedesktop.DBus.Properties'
+LE_ADVERTISEMENT_IFACE = 'org.bluez.LEAdvertisement1'
+
+
+class Advertisement(dbus.service.Object):
+ """An advertisement object."""
+
+ def __init__(self, bus, advertisement_data):
+ """Construction of an Advertisement object.
+
+ @param bus: a dbus system bus.
+ @param advertisement_data: advertisement data dictionary.
+
+ """
+ self.bus = bus
+ self._get_advertising_data(advertisement_data)
+ super(Advertisement, self).__init__(self.bus, self.path)
+
+
+ def _get_advertising_data(self, advertisement_data):
+ """Get advertising data from the advertisement_data dictionary.
+
+ @param bus: a dbus system bus.
+
+ """
+ self.path = advertisement_data.get('Path')
+ self.type = advertisement_data.get('Type')
+ self.service_uuids = advertisement_data.get('ServiceUUIDs', [])
+ self.solicit_uuids = advertisement_data.get('SolicitUUIDs', [])
+
+ # Should convert the key of manufacturer_data from string to hex value.
+ # It is due to xmlrpclib limitation which only allows string key.
+ self.manufacturer_data = {}
+ manufacturer_data = advertisement_data.get('ManufacturerData', {})
+ for key, value in manufacturer_data.items():
+ self.manufacturer_data[int(key, 16)] = value
+
+ self.service_data = advertisement_data.get('ServiceData')
+ self.include_tx_power = advertisement_data.get('IncludeTxPower')
+
+
+ def get_path(self):
+ """Get the dbus object path of the advertisement.
+
+ @returns: the advertisement object path.
+
+ """
+ return dbus.ObjectPath(self.path)
+
+
+ @dbus.service.method(DBUS_PROP_IFACE, in_signature='s',
+ out_signature='a{sv}')
+ def GetAll(self, interface):
+ """Get the properties dictionary of the advertisement.
+
+ @param interface: the bluetooth dbus interface.
+
+ @returns: the advertisement properties dictionary.
+
+ """
+ if interface != LE_ADVERTISEMENT_IFACE:
+ raise InvalidArgsException()
+
+ properties = dict()
+ properties['Type'] = dbus.String(self.type)
+
+ if self.service_uuids is not None:
+ properties['ServiceUUIDs'] = dbus.Array(self.service_uuids,
+ signature='s')
+ if self.solicit_uuids is not None:
+ properties['SolicitUUIDs'] = dbus.Array(self.solicit_uuids,
+ signature='s')
+ if self.manufacturer_data is not None:
+ properties['ManufacturerData'] = dbus.Dictionary(
+ self.manufacturer_data, signature='qay')
+
+ if self.service_data is not None:
+ properties['ServiceData'] = dbus.Dictionary(self.service_data,
+ signature='say')
+ if self.include_tx_power is not None:
+ properties['IncludeTxPower'] = dbus.Boolean(self.include_tx_power)
+
+ return properties
+
+
+ @dbus.service.method(LE_ADVERTISEMENT_IFACE, in_signature='',
+ out_signature='')
+ def Release(self):
+ """The method callback at release."""
+ logging.info('%s: Advertisement Release() called.', self.path)
+
+
+def example_advertisement():
+ """A demo example of creating an Advertisement object.
+
+ @returns: the Advertisement object.
+
+ """
+ ADVERTISEMENT_DATA = {
+ 'Path': '/org/bluez/test/advertisement1',
+
+ # Could be 'central' or 'peripheral'.
+ 'Type': 'peripheral',
+
+ # Refer to the specification for a list of service assgined numbers:
+ # https://www.bluetooth.com/specifications/gatt/services
+ # e.g., 180D represents "Heart Reate" service, and
+ # 180F "Battery Service".
+ 'ServiceUUIDs': ['180D', '180F'],
+
+ # Service solicitation UUIDs.
+ 'SolicitUUIDs': [],
+
+ # Two bytes of manufacturer id followed by manufacturer specific data.
+ 'ManufacturerData': {'0xff00': [0xa1, 0xa2, 0xa3, 0xa4, 0xa5]},
+
+ # service UUID followed by additional service data.
+ 'ServiceData': {'9999': [0x10, 0x20, 0x30, 0x40, 0x50]},
+
+ # Does it include transmit power level?
+ 'IncludeTxPower': True}
+
+ return Advertisement(bus, ADVERTISEMENT_DATA)
+
+
+if __name__ == '__main__':
+ # It is required to set the mainloop before creating the system bus object.
+ dbus.mainloop.glib.DBusGMainLoop(set_as_default=True)
+ bus = dbus.SystemBus()
+
+ adv = example_advertisement()
+ print adv.GetAll(LE_ADVERTISEMENT_IFACE)