blob: ec57dd4faa1614a9c58d27f37daaf8656be864a6 [file] [log] [blame]
# Copyright 2019 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.
"""A Batch of of Bluetooth LE sanity tests"""
import time
from autotest_lib.server.cros.bluetooth.bluetooth_adapter_quick_tests import \
BluetoothAdapterQuickTests
from autotest_lib.server.cros.bluetooth.bluetooth_adapter_pairing_tests import \
BluetoothAdapterPairingTests
from autotest_lib.server.cros.bluetooth.bluetooth_adapter_hidreports_tests \
import BluetoothAdapterHIDReportTests
class bluetooth_AdapterLESanity(BluetoothAdapterQuickTests,
BluetoothAdapterPairingTests,
BluetoothAdapterHIDReportTests):
"""A Batch of Bluetooth LE sanity tests. This test is written as a batch
of tests in order to reduce test time, since auto-test ramp up time is
costly. The batch is using BluetoothAdapterQuickTests wrapper methods to
start and end a test and a batch of tests.
This class can be called to run the entire test batch or to run a
specific test only
"""
test_wrapper = BluetoothAdapterQuickTests.quick_test_test_decorator
batch_wrapper = BluetoothAdapterQuickTests.quick_test_batch_decorator
@test_wrapper('Discovery Test', devices={"BLE_MOUSE":1})
def le_discovery_test(self):
"""Performs discovery test with mouse peripheral"""
device = self.devices['BLE_MOUSE'][0]
self.test_discover_device(device.address)
# Removed due to b:149093897 - the raspi peer can't instantly update
# the advertised name, causing this test to fail
# self.test_device_name(device.address, device.name)
@test_wrapper('Connect Disconnect Loop', devices={'BLE_MOUSE':1})
def le_connect_disconnect_loop(self):
"""Run connect/disconnect loop initiated by DUT.
The test also checks that there are no undesired
reconnections.
TODO(ysahvit) - add connection creation attempts
initiated by HID device
"""
device = self.devices['BLE_MOUSE'][0]
self.connect_disconnect_loop(device=device, loops=3)
@test_wrapper('Mouse Reports', devices={'BLE_MOUSE':1})
def le_mouse_reports(self):
"""Run all bluetooth mouse reports tests"""
device = self.devices['BLE_MOUSE'][0]
# Let the adapter pair, and connect to the target device.
self.test_discover_device(device.address)
# self.bluetooth_facade.is_discovering() doesn't work as expected:
# crbug:905374
# self.test_stop_discovery()
self.bluetooth_facade.stop_discovery()
time.sleep(self.TEST_SLEEP_SECS)
self.test_pairing(device.address, device.pin, trusted=True)
time.sleep(self.TEST_SLEEP_SECS)
self.test_connection_by_adapter(device.address)
# With raspberry pi peer, it takes a moment before the device is
# registered as an input device. Without delay, the input recorder
# doesn't find the device
time.sleep(1)
self.run_mouse_tests(device=device)
@test_wrapper('Keyboard Reports', devices={'BLE_KEYBOARD':1})
def le_keyboard_reports(self):
"""Run all bluetooth keyboard reports tests"""
device = self.devices['BLE_KEYBOARD'][0]
# Let the adapter pair, and connect to the target device.
self.test_discover_device(device.address)
# self.bluetooth_facade.is_discovering() doesn't work as expected:
# crbug:905374
# self.test_stop_discovery()
self.bluetooth_facade.stop_discovery()
time.sleep(self.TEST_SLEEP_SECS)
self.test_pairing(device.address, device.pin, trusted=True)
time.sleep(self.TEST_SLEEP_SECS)
self.test_connection_by_adapter(device.address)
# With raspberry pi peer, it takes a moment before the device is
# registered as an input device. Without delay, the input recorder
# doesn't find the device
time.sleep(1)
self.run_keyboard_tests(device=device)
@test_wrapper('Auto Reconnect', devices={'BLE_MOUSE':1})
def le_auto_reconnect(self):
"""LE reconnection loop by reseting HID and check reconnection"""
device = self.devices['BLE_MOUSE'][0]
self.auto_reconnect_loop(device=device,
loops=3,
check_connected_method=\
self.test_mouse_left_click)
@test_wrapper('GATT Client', devices={'BLE_KEYBOARD':1})
def le_gatt_client_attribute_browse_test(self):
"""Browse the whole tree-structured GATT attributes"""
device = self.devices['BLE_KEYBOARD'][0]
self.test_discover_device(device.address)
self.bluetooth_facade.stop_discovery()
time.sleep(self.TEST_SLEEP_SECS)
self.test_pairing(device.address, device.pin, trusted=True)
time.sleep(self.TEST_SLEEP_SECS)
self.test_connection_by_adapter(device.address)
self.test_service_resolved(device.address)
self.test_gatt_browse(device.address)
@batch_wrapper('LE Sanity')
def le_sanity_batch_run(self, num_iterations=1, test_name=None):
"""Run the LE sanity test batch or a specific given test.
The wrapper of this method is implemented in batch_decorator.
Using the decorator a test batch method can implement the only its
core tests invocations and let the decorator handle the wrapper,
which is taking care for whether to run a specific test or the
batch as a whole, and running the batch in iterations
@param num_iterations: how many interations to run
@param test_name: specifc test to run otherwise None to run the
whole batch
"""
self.le_connect_disconnect_loop()
self.le_mouse_reports()
self.le_keyboard_reports()
self.le_auto_reconnect()
self.le_discovery_test()
def run_once(self, host, num_iterations=1, test_name=None,
flag='Quick Sanity'):
"""Run the batch of Bluetooth LE sanity tests
@param host: the DUT, usually a chromebook
@param num_iterations: the number of rounds to execute the test
@test_name: the test to run, or None for all tests
"""
# Initialize and run the test batch or the requested specific test
self.quick_test_init(host, use_btpeer=True, flag=flag)
self.le_sanity_batch_run(num_iterations, test_name)
self.quick_test_cleanup()