[PANDORA_TEST] Add GATT/CL/GAD tests (3ae2d689) · Commits · e / os / android_packages_modules_Bluetooth

android/pandora/mmi2grpc/mmi2grpc/gatt.py

+417 −9

Original line number	Diff line number	Diff line
		@@ -20,6 +20,12 @@ from mmi2grpc._proxy import ProfileProxy
		from pandora.gatt_grpc import GATT
		from pandora.host_grpc import Host

		# Tests that need GATT cache cleared before discovering services.
		NEEDS_CACHE_CLEARED = {
		"GATT/CL/GAD/BV-01-C",
		"GATT/CL/GAD/BV-06-C",
		}


		class GATTProxy(ProfileProxy):

		@@ -28,9 +34,12 @@ class GATTProxy(ProfileProxy):
		self.gatt = GATT(channel)
		self.host = Host(channel)
		self.connection = None
		self.services = None
		self.characteristics = None
		self.descriptors = None

		@assert_description
		def MMI_IUT_INITIATE_CONNECTION(self, pts_addr: bytes, **kwargs):
		def MMI_IUT_INITIATE_CONNECTION(self, test, pts_addr: bytes, **kwargs):
		"""
		Please initiate a GATT connection to the PTS.

		@@ -40,6 +49,26 @@ class GATTProxy(ProfileProxy):
		"""

		self.connection = self.host.ConnectLE(address=pts_addr).connection
		if test in NEEDS_CACHE_CLEARED:
		self.gatt.ClearCache(connection=self.connection)
		return "OK"

		@assert_description
		def MMI_IUT_INITIATE_DISCONNECTION(self, **kwargs):
		"""
		Please initiate a GATT disconnection to the PTS.

		Description: Verify
		that the Implementation Under Test (IUT) can initiate GATT disconnect
		request to PTS.
		"""

		assert self.connection is not None
		self.host.DisconnectLE(connection=self.connection)
		self.connection = None
		self.services = None
		self.characteristics = None
		self.descriptors = None
		return "OK"

		@assert_description
		@@ -58,7 +87,7 @@ class GATTProxy(ProfileProxy):

		def MMI_IUT_SEND_PREPARE_WRITE_REQUEST_VALID_SIZE(self, description: str, **kwargs):
		"""
		Please send prepare write request with handle = 'FFFF'O and size = 'XXX'
		Please send prepare write request with handle = 'XXXX'O and size = 'XXX'
		to the PTS.

		Description: Verify that the Implementation Under Test
		@@ -69,20 +98,399 @@ class GATTProxy(ProfileProxy):
		matches = re.findall("'([a0-Z9])'O and size = '([a0-Z9])'", description)
		handle = int(matches[0][0], 16)
		data = bytes([1]) * int(matches[0][1])
		self.gatt.WriteCharacteristicFromHandle(connection=self.connection, handle=handle, value=data)
		self.gatt.WriteCharacteristicFromHandle(connection=self.connection,\
		handle=handle, value=data)
		return "OK"

		@assert_description
		def MMI_IUT_INITIATE_DISCONNECTION(self, **kwargs):
		def MMI_IUT_DISCOVER_PRIMARY_SERVICES(self, **kwargs):
		"""
		Please send discover all primary services command to the PTS.
		Description: Verify that the Implementation Under Test (IUT) can send
		Discover All Primary Services.
		"""

		assert self.connection is not None
		self.services = self.gatt.DiscoverServices(connection=self.connection).services
		return "OK"

		def MMI_SEND_PRIMARY_SERVICE_UUID(self, description: str, **kwargs):
		"""
		Please send discover primary services with UUID value set to 'XXXX'O to
		the PTS.

		Description: Verify that the Implementation Under Test (IUT)
		can send Discover Primary Services UUID = 'XXXX'O.
		"""

		assert self.connection is not None
		uuid = formatUuid(re.findall("'([a0-Z9]*)'O", description)[0])
		self.services = self.gatt.DiscoverServiceByUuid(connection=self.connection,\
		uuid=uuid).services
		return "OK"

		def MMI_SEND_PRIMARY_SERVICE_UUID_128(self, description: str, **kwargs):
		"""
		Please send discover primary services with UUID value set to
		'XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX'O to the PTS.

		Description:
		Verify that the Implementation Under Test (IUT) can send Discover
		Primary Services UUID = 'XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX'O.
		"""

		assert self.connection is not None
		uuid = formatUuid(re.findall("'([a0-Z9-]*)'O", description)[0])
		self.services = self.gatt.DiscoverServiceByUuid(connection=self.connection,\
		uuid=uuid).services
		return "OK"

		def MMI_CONFIRM_PRIMARY_SERVICE_UUID(self, **kwargs):
		"""
		Please confirm IUT received primary services uuid = 'XXXX'O , Service
		start handle = 'XXXX'O, end handle = 'XXXX'O in database. Click Yes if
		IUT received it, otherwise click No.

		Description: Verify that the
		Implementation Under Test (IUT) can send Discover primary service by
		UUID in database.
		"""
		Please initiate a GATT disconnection to the PTS.

		# Android doesn't store services discovered by UUID.
		return "Yes"

		@assert_description
		def MMI_CONFIRM_NO_PRIMARY_SERVICE_SMALL(self, **kwargs):
		"""
		Please confirm that IUT received NO service uuid found in the small
		database file. Click Yes if NO service found, otherwise click No.
		Description: Verify that the Implementation Under Test (IUT) can send
		Discover primary service by UUID in small database.
		"""

		# Android doesn't store services discovered by UUID.
		return "Yes"

		def MMI_CONFIRM_PRIMARY_SERVICE_UUID_128(self, **kwargs):
		"""
		Please confirm IUT received primary services uuid=
		'XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX'O, Service start handle =
		'XXXX'O, end handle = 'XXXX'O in database. Click Yes if IUT received it,
		otherwise click No.

		Description: Verify that the Implementation Under
		Test (IUT) can send Discover primary service by UUID in database.
		"""

		# Android doesn't store services discovered by UUID.
		return "Yes"

		def MMI_CONFIRM_PRIMARY_SERVICE(self, description: str, **kwargs):
		"""
		Please confirm IUT received primary services Primary Service = 'XXXX'O
		Primary Service = 'XXXX'O in database. Click Yes if IUT received it,
		otherwise click No.

		Description: Verify that the Implementation Under
		Test (IUT) can send Discover all primary services in database.
		"""

		assert self.services is not None
		all_matches = list(map(formatUuid, re.findall("'([a0-Z9]*)'O", description)))
		assert all(uuid in list(map(lambda service: service.uuid, self.services))\
		for uuid in all_matches)
		return "OK"

		@assert_description
		def MMI_IUT_FIND_INCLUDED_SERVICES(self, **kwargs):
		"""
		Please send discover all include services to the PTS to discover all
		Include Service supported in the PTS. Discover primary service if
		needed.

		Description: Verify that the Implementation Under Test (IUT)
		can send Discover all include services command.
		"""

		assert self.connection is not None
		self.services = self.gatt.DiscoverServices(connection=self.connection).services
		return "OK"

		@assert_description
		def MMI_CONFIRM_NO_INCLUDE_SERVICE(self, **kwargs):
		"""
		There is no include service in the database file.

		Description: Verify
		that the Implementation Under Test (IUT) can initiate GATT disconnect
		request to PTS.
		that the Implementation Under Test (IUT) can send Discover all include
		services in database.
		"""

		assert self.connection is not None
		self.host.DisconnectLE(connection=self.connection)
		self.connection = None
		assert self.services is not None
		for service in self.services:
		assert len(service.included_services) is 0
		return "OK"

		def MMI_CONFIRM_INCLUDE_SERVICE(self, description: str, **kwargs):
		"""
		Please confirm IUT received include services:

		Attribute Handle = 'XXXX'O, Included Service Attribute handle = 'XXXX'O,
		End Group Handle = 'XXXX'O, Service UUID = 'XXXX'O

		Click Yes if IUT received it, otherwise click No.

		Description: Verify
		that the Implementation Under Test (IUT) can send Discover all include
		services in database.
		"""

		assert self.connection is not None
		assert self.services is not None
		"""
		Number of checks can vary but information is always the same,
		so we need to iterate through the services and check if its included
		services match one of these.
		"""
		all_matches = re.findall("'([a0-Z9]*)'O", description)
		found_services = 0
		for service in self.services:
		for i in range(0, len(all_matches), 4):
		if compareIncludedServices(service,\
		(stringHandleToInt(all_matches[i])),\
		stringHandleToInt(all_matches[i + 1]),\
		formatUuid(all_matches[i + 3])):
		found_services += 1
		assert found_services == (len(all_matches) / 4)
		return "OK"

		def MMI_IUT_DISCOVER_SERVICE_UUID(self, description: str, **kwargs):
		"""
		Discover all characteristics of service UUID= 'XXXX'O, Service start
		handle = 'XXXX'O, end handle = 'XXXX'O.

		Description: Verify that the
		Implementation Under Test (IUT) can send Discover all charactieristics
		of a service.
		"""

		assert self.connection is not None
		service_uuid = formatUuid(re.findall("'([a0-Z9]*)'O", description)[0])
		self.services = self.gatt.DiscoverServices(connection=self.connection).services
		self.characteristics = getCharacteristicsForServiceUuid(self.services, service_uuid)
		return "OK"

		def MMI_CONFIRM_ALL_CHARACTERISTICS_SERVICE(self, description: str, **kwargs):
		"""
		Please confirm IUT received all characteristics of service
		handle='XXXX'O handle='XXXX'O handle='XXXX'O handle='XXXX'O
		handle='XXXX'O handle='XXXX'O handle='XXXX'O handle='XXXX'O
		handle='XXXX'O handle='XXXX'O handle='XXXX'O in database. Click Yes if
		IUT received it, otherwise click No.

		Description: Verify that the
		Implementation Under Test (IUT) can send Discover all characteristics of
		a service in database.
		"""

		assert self.characteristics is not None
		all_matches = list(map(stringCharHandleToInt, re.findall("'([a0-Z9]*)'O", description)))
		assert all(handle in list(map(lambda char: char.handle, self.characteristics))\
		for handle in all_matches)
		return "Yes"

		def MMI_IUT_DISCOVER_SERVICE_UUID_RANGE(self, description: str, **kwargs):
		"""
		Please send discover characteristics by UUID. Range start from handle =
		'XXXX'O end handle = 'XXXX'O characteristics UUID = 0xXXXX'O.
		Description: Verify that the Implementation Under Test (IUT) can send
		Discover characteristics by UUID.
		"""

		assert self.connection is not None
		handles = re.findall("'([a0-Z9]*)'O", description)
		"""
		PTS sends UUIDS description formatted differently in this MMI,
		so we need to check for each known format.
		"""
		uuid_match = re.findall("0x([a0-Z9]*)'O", description)
		if len(uuid_match) == 0:
		uuid_match = re.search("UUID = (.*)'O", description)
		uuid = formatUuid(uuid_match[1])
		else:
		uuid = formatUuid(uuid_match[0])
		self.services = self.gatt.DiscoverServices(connection=self.connection).services
		self.characteristics = getCharacteristicsRange(self.services,\
		stringHandleToInt(handles[0]), stringHandleToInt(handles[1]), uuid)
		return "OK"

		def MMI_CONFIRM_CHARACTERISTICS(self, description: str, **kwargs):
		"""
		Please confirm IUT received characteristic handle='XXXX'O UUID='XXXX'O
		in database. Click Yes if IUT received it, otherwise click No.
		Description: Verify that the Implementation Under Test (IUT) can send
		Discover primary service by UUID in database.
		"""

		assert self.characteristics is not None
		all_matches = re.findall("'([a0-Z9-]*)'O", description)
		for characteristic in self.characteristics:
		if characteristic.handle == stringHandleToInt(all_matches[0])\
		and characteristic.uuid == formatUuid(all_matches[1]):
		return "Yes"
		return "No"

		@assert_description
		def MMI_CONFIRM_NO_CHARACTERISTICSUUID_SMALL(self, **kwargs):
		"""
		Please confirm that IUT received NO 128 bit uuid in the small database
		file. Click Yes if NO handle found, otherwise click No.

		Description:
		Verify that the Implementation Under Test (IUT) can discover
		characteristics by UUID in small database.
		"""

		assert self.characteristics is not None
		assert len(self.characteristics) == 0
		return "OK"

		def MMI_IUT_DISCOVER_DESCRIPTOR_RANGE(self, description: str, **kwargs):
		"""
		Please send discover characteristics descriptor range start from handle
		= 'XXXX'O end handle = 'XXXX'O to the PTS.

		Description: Verify that the
		Implementation Under Test (IUT) can send Discover characteristics
		descriptor.
		"""

		assert self.connection is not None
		handles = re.findall("'([a0-Z9]*)'O", description)
		self.services = self.gatt.DiscoverServices(connection=self.connection).services
		self.descriptors = getDescriptorsRange(self.services,\
		stringHandleToInt(handles[0]), stringHandleToInt(handles[1]))
		return "OK"

		def MMI_CONFIRM_CHARACTERISTICS_DESCRIPTORS(self, description: str, **kwargs):
		"""
		Please confirm IUT received characteristic descriptors handle='XXXX'O
		UUID=0xXXXX in database. Click Yes if IUT received it, otherwise click
		No.

		Description: Verify that the Implementation Under Test (IUT) can
		send Discover characteristic descriptors in database.
		"""

		assert self.descriptors is not None
		handle = stringHandleToInt(re.findall("'([a0-Z9]*)'O", description)[0])
		uuid = formatUuid(re.search("UUID=0x(.*) ", description)[1])
		for descriptor in self.descriptors:
		if descriptor.handle == handle and descriptor.uuid == uuid:
		return "Yes"
		return "No"

		def MMI_IUT_DISCOVER_ALL_SERVICE_RECORD(self, pts_addr: bytes, description: str, **kwargs):
		"""
		Please send Service Discovery to discover all primary Services. Click
		YES if GATT='XXXX'O services are discovered, otherwise click No.
		Description: Verify that the Implementation Under Test (IUT) can
		discover basic rate all primary services.
		"""

		uuid = formatUuid(re.findall("'([a0-Z9]*)'O", description))
		self.services = self.gatt.DiscoverServicesSdp(address=pts_addr).service_uuids
		if uuid in self.services:
		return "Yes"
		return "No"


		common_uuid = "0000XXXX-0000-1000-8000-00805f9b34fb"


		def stringHandleToInt(handle: str):
		return int(handle, 16)


		# Discovered characteristics handles are 1 more than PTS handles in one test.
		def stringCharHandleToInt(handle: str):
		return (int(handle, 16) + 1)


		def formatUuid(uuid: str):
		"""
		Formats PTS described UUIDs to be of the right format.
		Right format is: 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
		PTS described format can be:
		- 'XXXX'
		- 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
		- 'XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX'
		"""
		uuid_len = len(uuid)
		if uuid_len == 4:
		return common_uuid.replace(common_uuid[4:8], uuid.lower())
		elif uuid_len == 32 or uuid_len == 39:
		uuidCharList = list(uuid.replace('-', '').lower())
		uuidCharList.insert(20, '-')
		uuidCharList.insert(16, '-')
		uuidCharList.insert(12, '-')
		uuidCharList.insert(8, '-')
		return ''.join(uuidCharList)
		else:
		return uuid


		def compareIncludedServices(service, service_handle, included_handle, included_uuid):
		"""
		Compares included services with given values.
		The service_handle passed by the PTS is
		[primary service handle] + [included service number].
		"""
		included_service_count = 1
		for included_service in service.included_services:
		if service.handle == (service_handle - included_service_count)\
		and included_service.handle == included_handle\
		and included_service.uuid == included_uuid:
		return True
		included_service_count += 1
		return False


		def getCharacteristicsForServiceUuid(services, uuid):
		"""
		Return an array of characteristics for matching service uuid.
		"""
		for service in services:
		if service.uuid == uuid:
		return service.characteristics
		return []


		def getCharacteristicsRange(services, start_handle, end_handle, uuid):
		"""
		Return an array of characteristics of which handles are
		between start_handle and end_handle and uuid matches.
		"""
		characteristics_list = []
		for service in services:
		for characteristic in service.characteristics:
		if characteristic.handle >= start_handle\
		and characteristic.handle <= end_handle\
		and characteristic.uuid == uuid:
		characteristics_list.append(characteristic)
		return characteristics_list


		def getDescriptorsRange(services, start_handle, end_handle):
		"""
		Return an array of descriptors of which handles are
		between start_handle and end_handle.
		"""
		descriptors_list = []
		for service in services:
		for characteristic in service.characteristics:
		for descriptor in characteristic.descriptors:
		if descriptor.handle >= start_handle and descriptor.handle <= end_handle:
		descriptors_list.append(descriptor)
		return descriptors_list
		No newline at end of file

android/pandora/server/configs/PtsBotTest.xml

+1 −0

Original line number	Diff line number	Diff line
		@@ -23,6 +23,7 @@
		<option name="profile" value="A2DP/SRC" />
		<option name="profile" value="AVDTP/SRC" />
		<option name="profile" value="GATT/CL/GAC" />
		<option name="profile" value="GATT/CL/GAD" />
		<option name="profile" value="HFP/AG/DIS" />
		<option name="profile" value="HFP/AG/HFI" />
		<option name="profile" value="HFP/AG/SLC" />

android/pandora/server/configs/pts_bot_tests_config.json

+11 −3

Original line number	Diff line number	Diff line
		@@ -42,6 +42,14 @@
		"AVDTP/SRC/INT/SIG/SYN/BV-05-C",
		"AVDTP/SRC/INT/TRA/BTR/BV-01-C",
		"GATT/CL/GAC/BV-01-C",
		"GATT/CL/GAD/BV-01-C",
		"GATT/CL/GAD/BV-02-C",
		"GATT/CL/GAD/BV-03-C",
		"GATT/CL/GAD/BV-04-C",
		"GATT/CL/GAD/BV-05-C",
		"GATT/CL/GAD/BV-06-C",
		"GATT/CL/GAD/BV-07-C",
		"GATT/CL/GAD/BV-08-C",
		"HFP/AG/DIS/BV-01-I",
		"HFP/AG/HFI/BI-03-I",
		"HFP/AG/HFI/BV-02-I",
		@@ -569,10 +577,10 @@
		"TSPC_GATT_1_1": true,
		"TSPC_GATT_1_2": true,
		"TSPC_GATT_1a_1": true,
		"TSPC_GATT_1a_2": true,
		"TSPC_GATT_1a_2": false,
		"TSPC_GATT_1a_3": true,
		"TSPC_GATT_1a_4": true,
		"TSPC_GATT_2_1": true,
		"TSPC_GATT_1a_4": false,
		"TSPC_GATT_2_1": false,
		"TSPC_GATT_2_2": true,
		"TSPC_GATT_3_1": true,
		"TSPC_GATT_3_2": true,

android/pandora/server/proto/pandora/gatt.proto

+70 −2

Original line number	Diff line number	Diff line
		@@ -13,17 +13,85 @@ service GATT {

		// Writes on a characteristic.
		rpc WriteCharacteristicFromHandle(WriteCharacteristicRequest) returns (google.protobuf.Empty);

		// Starts service discovery for given uuid.
		rpc DiscoverServiceByUuid(DiscoverServiceByUuidRequest) returns (DiscoverServicesResponse);

		// Starts services discovery.
		rpc DiscoverServices(DiscoverServicesRequest) returns (DiscoverServicesResponse);

		// Starts services discovery using SDP.
		rpc DiscoverServicesSdp(DiscoverServicesSdpRequest) returns (DiscoverServicesSdpResponse);

		// Clears DUT GATT cache.
		rpc ClearCache(ClearCacheRequest) returns (google.protobuf.Empty);
		}

		// Request for the `ExchangeMTU` method.
		// A message representing a GATT service.
		message GattService {
		uint32 handle = 1;
		uint32 type = 2;
		string uuid = 3;
		repeated GattService included_services = 4;
		repeated GattCharacteristic characteristics = 5;
		}

		// A message representing a GATT characteristic.
		message GattCharacteristic {
		uint32 properties = 1;
		uint32 permissions = 2;
		string uuid = 3;
		uint32 handle = 4;
		repeated GattDescriptor descriptors = 5;
		}

		// A message representing a GATT descriptors.
		message GattDescriptor {
		uint32 handle = 1;
		uint32 permissions = 2;
		string uuid = 3;
		}

		// Request for the `ExchangeMTU` rpc.
		message ExchangeMTURequest {
		Connection connection = 1;
		int32 mtu = 2;
		}

		// Request for the `writeCharacteristicFromHandle` method.
		// Request for the `writeCharacteristicFromHandle` rpc.
		message WriteCharacteristicRequest {
		Connection connection = 1;
		uint32 handle = 2;
		bytes value = 3;
		}

		// Request for the `DiscoverServiceByUuid` rpc.
		message DiscoverServiceByUuidRequest {
		Connection connection = 1;
		string uuid = 2;
		}

		// Request for the `DiscoverServices` rpc.
		message DiscoverServicesRequest {
		Connection connection = 1;
		}

		// Response for the `DiscoverServices` rpc.
		message DiscoverServicesResponse {
		repeated GattService services = 1;
		}

		// Request for the `DiscoverServicesSdp` rpc.
		message DiscoverServicesSdpRequest {
		bytes address = 1;
		}

		// Response for the `DiscoverServicesSdp` rpc.
		message DiscoverServicesSdpResponse {
		repeated string service_uuids = 1;
		}

		// Request for the `ClearCache` rpc.
		message ClearCacheRequest {
		Connection connection = 1;
		}

android/pandora/server/src/com/android/pandora/Gatt.kt

+127 −2

File changed.

Preview size limit exceeded, changes collapsed.