1 /*
2 * Copyright (C) 2019 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17 #define LOG_TAG "bluetooth_hidl_hal_test"
18 #include <android-base/logging.h>
19
20 #include <android/hardware/bluetooth/1.0/types.h>
21 #include <android/hardware/bluetooth/1.1/IBluetoothHci.h>
22 #include <android/hardware/bluetooth/1.1/IBluetoothHciCallbacks.h>
23 #include <utils/Log.h>
24
25 #include <VtsHalHidlTargetCallbackBase.h>
26 #include <gtest/gtest.h>
27 #include <hidl/GtestPrinter.h>
28 #include <hidl/ServiceManagement.h>
29
30 #include <chrono>
31 #include <queue>
32 #include <thread>
33
34 using ::android::sp;
35 using ::android::hardware::hidl_death_recipient;
36 using ::android::hardware::hidl_vec;
37 using ::android::hardware::Return;
38 using ::android::hardware::Void;
39 using ::android::hardware::bluetooth::V1_0::Status;
40 using ::android::hardware::bluetooth::V1_1::IBluetoothHci;
41 using ::android::hardware::bluetooth::V1_1::IBluetoothHciCallbacks;
42
43 #define HCI_MINIMUM_HCI_VERSION 5 // Bluetooth Core Specification 3.0 + HS
44 #define HCI_MINIMUM_LMP_VERSION 5 // Bluetooth Core Specification 3.0 + HS
45 #define HCI_BLUETOOTH4_2_HCI_VERSION 8 // Bluetooth 4.2
46 #define HCI_BLUETOOTH4_2_LMP_VERSION 8 // Bluetooth 4.2
47 #define NUM_HCI_COMMANDS_BANDWIDTH 1000
48 #define NUM_SCO_PACKETS_BANDWIDTH 1000
49 #define NUM_ACL_PACKETS_BANDWIDTH 1000
50 #define WAIT_FOR_INIT_TIMEOUT std::chrono::milliseconds(2000)
51 #define WAIT_FOR_HCI_EVENT_TIMEOUT std::chrono::milliseconds(2000)
52 #define WAIT_FOR_SCO_DATA_TIMEOUT std::chrono::milliseconds(1000)
53 #define WAIT_FOR_ACL_DATA_TIMEOUT std::chrono::milliseconds(1000)
54 #define INTERFACE_CLOSE_DELAY_MS std::chrono::milliseconds(200)
55
56 // { OCF, OGF << 2, Length of bytes of command parameters }
57 #define COMMAND_HCI_SHOULD_BE_UNKNOWN \
58 { 0xff, 0x3B, 0x08, 0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07 }
59 #define COMMAND_HCI_READ_LOCAL_VERSION_INFORMATION \
60 { 0x01, 0x10, 0x00 }
61 #define COMMAND_HCI_READ_BUFFER_SIZE \
62 { 0x05, 0x10, 0x00 }
63 #define COMMAND_HCI_WRITE_LOOPBACK_MODE_LOCAL \
64 { 0x02, 0x18, 0x01, 0x01 }
65 #define COMMAND_HCI_RESET \
66 { 0x03, 0x0c, 0x00 }
67 #define COMMAND_HCI_WRITE_LOCAL_NAME \
68 { 0x13, 0x0c, 0xf8 }
69 #define COMMAND_HCI_READ_LOCAL_SUPPORTED_FEATURES \
70 { 0x03, 0x04 << 2, 0x00 } // OGF=0x04, OCF=0x0003 / 7.4 INFORMATIONAL PARAMETERS
71 #define COMMAND_HCI_LE_READ_LOCAL_SUPPORTED_FEATURES \
72 { 0x03, 0x08 << 2, 0x00 } // OGF=0x08, OCF=0x0003 / 7.8 LE CONTROLLER COMMANDS
73 #define HCI_STATUS_SUCCESS 0x00
74 #define HCI_STATUS_UNKNOWN_HCI_COMMAND 0x01
75
76 #define EVENT_CONNECTION_COMPLETE 0x03
77 #define EVENT_COMMAND_COMPLETE 0x0e
78 #define EVENT_COMMAND_STATUS 0x0f
79 #define EVENT_NUMBER_OF_COMPLETED_PACKETS 0x13
80 #define EVENT_LOOPBACK_COMMAND 0x19
81
82 #define EVENT_CODE_BYTE 0
83 #define EVENT_LENGTH_BYTE 1
84 #define EVENT_FIRST_PAYLOAD_BYTE 2
85 #define EVENT_COMMAND_STATUS_STATUS_BYTE 2
86 #define EVENT_COMMAND_STATUS_ALLOWED_PACKETS_BYTE 3
87 #define EVENT_COMMAND_STATUS_OPCODE_LSBYTE 4 // Bytes 4 and 5
88 #define EVENT_COMMAND_COMPLETE_ALLOWED_PACKETS_BYTE 2
89 #define EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE 3 // Bytes 3 and 4
90 #define EVENT_COMMAND_COMPLETE_STATUS_BYTE 5
91 #define EVENT_COMMAND_COMPLETE_FIRST_PARAM_BYTE 6
92 #define EVENT_LOCAL_HCI_VERSION_BYTE EVENT_COMMAND_COMPLETE_FIRST_PARAM_BYTE
93 #define EVENT_LOCAL_LMP_VERSION_BYTE EVENT_LOCAL_HCI_VERSION_BYTE + 3
94 /**
95 * See Bluetooth Spec 5.4, Vol 2, Part C
96 * Link Manager Protocol, 3.3 Feature Mask Definition
97 *
98 * No | Supported Feature | Byte | Bit | Page
99 * ...
100 * 38 | LE Supported (Controller) | 4 | 6 | 0
101 * ...
102 */
103 #define EVENT_LOCAL_SUPPORTED_FEATURES_LE_SUPPORTED_BYTE \
104 (EVENT_COMMAND_COMPLETE_FIRST_PARAM_BYTE + 0x04)
105 #define EVENT_LOCAL_SUPPORTED_FEATURES_LE_SUPPORTED_BITMASK (0x01 << 6)
106 /**
107 * See Bluetooth Spec 5.4, Vol 6, Part B
108 * 4.6 Feature Support
109 *
110 * Bit | Link Layer Feature
111 * ...
112 * 5 | LE Data Packet Length Extension
113 * ...
114 */
115 #define EVENT_LOCAL_LE_SUPPORTED_FEATURES_DATA_LENGTH_EXTENSION_BYTE \
116 (EVENT_COMMAND_COMPLETE_FIRST_PARAM_BYTE + 0x00)
117 #define EVENT_LOCAL_LE_SUPPORTED_FEATURES_DATA_LENGTH_BITMASK (0x01 << 5)
118
119 #define EVENT_CONNECTION_COMPLETE_PARAM_LENGTH 11
120 #define EVENT_CONNECTION_COMPLETE_TYPE 11
121 #define EVENT_CONNECTION_COMPLETE_TYPE_SCO 0
122 #define EVENT_CONNECTION_COMPLETE_TYPE_ACL 1
123 #define EVENT_CONNECTION_COMPLETE_HANDLE_LSBYTE 3
124 #define EVENT_COMMAND_STATUS_LENGTH 4
125
126 #define EVENT_NUMBER_OF_COMPLETED_PACKETS_NUM_HANDLES 2
127
128 #define ACL_BROADCAST_FLAG_OFFSET 6
129 #define ACL_BROADCAST_FLAG_POINT_TO_POINT 0x0
130 #define ACL_BROADCAST_POINT_TO_POINT \
131 (ACL_BROADCAST_FLAG_POINT_TO_POINT << ACL_BROADCAST_FLAG_OFFSET)
132
133 #define ACL_PACKET_BOUNDARY_FLAG_OFFSET 4
134 #define ACL_PACKET_BOUNDARY_FLAG_FIRST_AUTO_FLUSHABLE 0x2
135 #define ACL_PACKET_BOUNDARY_FIRST_AUTO_FLUSHABLE \
136 (ACL_PACKET_BOUNDARY_FLAG_FIRST_AUTO_FLUSHABLE \
137 << ACL_PACKET_BOUNDARY_FLAG_OFFSET)
138
139 // To be removed in VTS release builds
140 #define ACL_HANDLE_QCA_DEBUG_MESSAGE 0xedc
141
142 constexpr char kCallbackNameAclEventReceived[] = "aclDataReceived";
143 constexpr char kCallbackNameHciEventReceived[] = "hciEventReceived";
144 constexpr char kCallbackNameInitializationComplete[] = "initializationComplete";
145 constexpr char kCallbackNameScoEventReceived[] = "scoDataReceived";
146 constexpr char kCallbackNameIsoEventReceived[] = "isoDataReceived";
147
148 class ThroughputLogger {
149 public:
ThroughputLogger(std::string task)150 ThroughputLogger(std::string task)
151 : task_(task), start_time_(std::chrono::steady_clock::now()) {}
152
~ThroughputLogger()153 ~ThroughputLogger() {
154 if (total_bytes_ == 0) return;
155 std::chrono::duration<double> duration =
156 std::chrono::steady_clock::now() - start_time_;
157 double s = duration.count();
158 if (s == 0) return;
159 double rate_kb = (static_cast<double>(total_bytes_) / s) / 1024;
160 ALOGD("%s %.1f KB/s (%zu bytes in %.3fs)", task_.c_str(), rate_kb,
161 total_bytes_, s);
162 }
163
setTotalBytes(size_t total_bytes)164 void setTotalBytes(size_t total_bytes) { total_bytes_ = total_bytes; }
165
166 private:
167 size_t total_bytes_;
168 std::string task_;
169 std::chrono::steady_clock::time_point start_time_;
170 };
171
172 // The main test class for Bluetooth HIDL HAL.
173 class BluetoothHidlTest : public ::testing::TestWithParam<std::string> {
174 public:
SetUp()175 virtual void SetUp() override {
176 // currently test passthrough mode only
177 bluetooth = IBluetoothHci::getService(GetParam());
178 ASSERT_NE(bluetooth, nullptr);
179 ALOGI("%s: getService() for bluetooth is %s", __func__,
180 bluetooth->isRemote() ? "remote" : "local");
181
182 bluetooth_hci_death_recipient = new BluetoothHciDeathRecipient();
183 ASSERT_NE(bluetooth_hci_death_recipient, nullptr);
184 ASSERT_TRUE(
185 bluetooth->linkToDeath(bluetooth_hci_death_recipient, 0).isOk());
186
187 bluetooth_cb = new BluetoothHciCallbacks(*this);
188 ASSERT_NE(bluetooth_cb, nullptr);
189
190 max_acl_data_packet_length = 0;
191 max_sco_data_packet_length = 0;
192 max_acl_data_packets = 0;
193 max_sco_data_packets = 0;
194
195 initialized = false;
196 event_cb_count = 0;
197 acl_cb_count = 0;
198 sco_cb_count = 0;
199
200 ASSERT_FALSE(initialized);
201 // Should not be checked in production code
202 ASSERT_TRUE(bluetooth->initialize(bluetooth_cb).isOk());
203
204 bluetooth_cb->SetWaitTimeout(kCallbackNameInitializationComplete,
205 WAIT_FOR_INIT_TIMEOUT);
206 bluetooth_cb->SetWaitTimeout(kCallbackNameHciEventReceived,
207 WAIT_FOR_HCI_EVENT_TIMEOUT);
208 bluetooth_cb->SetWaitTimeout(kCallbackNameAclEventReceived,
209 WAIT_FOR_ACL_DATA_TIMEOUT);
210 bluetooth_cb->SetWaitTimeout(kCallbackNameScoEventReceived,
211 WAIT_FOR_SCO_DATA_TIMEOUT);
212
213 EXPECT_TRUE(
214 bluetooth_cb->WaitForCallback(kCallbackNameInitializationComplete)
215 .no_timeout);
216
217 ASSERT_TRUE(initialized);
218 }
219
TearDown()220 virtual void TearDown() override {
221 ALOGI("TearDown");
222 // Should not be checked in production code
223 ASSERT_TRUE(bluetooth->close().isOk());
224 std::this_thread::sleep_for(INTERFACE_CLOSE_DELAY_MS);
225 handle_no_ops();
226 EXPECT_EQ(static_cast<size_t>(0), event_queue.size());
227 EXPECT_EQ(static_cast<size_t>(0), sco_queue.size());
228 EXPECT_EQ(static_cast<size_t>(0), acl_queue.size());
229 EXPECT_EQ(static_cast<size_t>(0), iso_queue.size());
230 }
231
232 void setBufferSizes();
233
234 // Functions called from within tests in loopback mode
235 void sendAndCheckHCI(int num_packets);
236 void sendAndCheckSCO(int num_packets, size_t size, uint16_t handle);
237 void sendAndCheckACL(int num_packets, size_t size, uint16_t handle);
238
239 // Helper functions to try to get a handle on verbosity
240 void enterLoopbackMode(std::vector<uint16_t>* sco_handles,
241 std::vector<uint16_t>* acl_handles);
242 void handle_no_ops();
243 void wait_for_event(bool timeout_is_error);
244 hidl_vec<uint8_t> wait_for_command_complete_event(hidl_vec<uint8_t> cmd);
245 int wait_for_completed_packets_event(uint16_t handle);
246
247 class BluetoothHciDeathRecipient : public hidl_death_recipient {
248 public:
serviceDied(uint64_t,const android::wp<::android::hidl::base::V1_0::IBase> &)249 void serviceDied(
250 uint64_t /*cookie*/,
251 const android::wp<::android::hidl::base::V1_0::IBase>& /*who*/)
252 override {
253 FAIL();
254 }
255 };
256
257 // A simple test implementation of BluetoothHciCallbacks.
258 class BluetoothHciCallbacks
259 : public ::testing::VtsHalHidlTargetCallbackBase<BluetoothHidlTest>,
260 public IBluetoothHciCallbacks {
261 BluetoothHidlTest& parent_;
262
263 public:
BluetoothHciCallbacks(BluetoothHidlTest & parent)264 BluetoothHciCallbacks(BluetoothHidlTest& parent) : parent_(parent){};
265
266 virtual ~BluetoothHciCallbacks() = default;
267
initializationComplete(Status status)268 Return<void> initializationComplete(Status status) override {
269 parent_.initialized = (status == Status::SUCCESS);
270 NotifyFromCallback(kCallbackNameInitializationComplete);
271 ALOGV("%s (status = %d)", __func__, static_cast<int>(status));
272 return Void();
273 };
274
hciEventReceived(const::android::hardware::hidl_vec<uint8_t> & event)275 Return<void> hciEventReceived(
276 const ::android::hardware::hidl_vec<uint8_t>& event) override {
277 parent_.event_cb_count++;
278 parent_.event_queue.push(event);
279 NotifyFromCallback(kCallbackNameHciEventReceived);
280 ALOGV("Event received (length = %d)", static_cast<int>(event.size()));
281 return Void();
282 };
283
aclDataReceived(const::android::hardware::hidl_vec<uint8_t> & data)284 Return<void> aclDataReceived(
285 const ::android::hardware::hidl_vec<uint8_t>& data) override {
286 parent_.acl_cb_count++;
287 parent_.acl_queue.push(data);
288 NotifyFromCallback(kCallbackNameAclEventReceived);
289 return Void();
290 };
291
scoDataReceived(const::android::hardware::hidl_vec<uint8_t> & data)292 Return<void> scoDataReceived(
293 const ::android::hardware::hidl_vec<uint8_t>& data) override {
294 parent_.sco_cb_count++;
295 parent_.sco_queue.push(data);
296 NotifyFromCallback(kCallbackNameScoEventReceived);
297 return Void();
298 };
299
isoDataReceived(const::android::hardware::hidl_vec<uint8_t> & data)300 Return<void> isoDataReceived(
301 const ::android::hardware::hidl_vec<uint8_t>& data) override {
302 parent_.iso_cb_count++;
303 parent_.iso_queue.push(data);
304 NotifyFromCallback(kCallbackNameIsoEventReceived);
305 return Void();
306 };
307 };
308
309 sp<IBluetoothHci> bluetooth;
310 sp<BluetoothHciCallbacks> bluetooth_cb;
311 sp<BluetoothHciDeathRecipient> bluetooth_hci_death_recipient;
312 std::queue<hidl_vec<uint8_t>> event_queue;
313 std::queue<hidl_vec<uint8_t>> acl_queue;
314 std::queue<hidl_vec<uint8_t>> sco_queue;
315 std::queue<hidl_vec<uint8_t>> iso_queue;
316
317 bool initialized;
318
319 int event_cb_count;
320 int sco_cb_count;
321 int acl_cb_count;
322 int iso_cb_count;
323
324 int max_acl_data_packet_length;
325 int max_sco_data_packet_length;
326 int max_acl_data_packets;
327 int max_sco_data_packets;
328 };
329
330 // Discard NO-OPs from the event queue.
handle_no_ops()331 void BluetoothHidlTest::handle_no_ops() {
332 while (event_queue.size() > 0) {
333 hidl_vec<uint8_t> event = event_queue.front();
334 EXPECT_GE(event.size(),
335 static_cast<size_t>(EVENT_COMMAND_COMPLETE_STATUS_BYTE));
336 bool event_is_no_op =
337 (event[EVENT_CODE_BYTE] == EVENT_COMMAND_COMPLETE) &&
338 (event[EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE] == 0x00) &&
339 (event[EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE + 1] == 0x00);
340 event_is_no_op |= (event[EVENT_CODE_BYTE] == EVENT_COMMAND_STATUS) &&
341 (event[EVENT_COMMAND_STATUS_OPCODE_LSBYTE] == 0x00) &&
342 (event[EVENT_COMMAND_STATUS_OPCODE_LSBYTE + 1] == 0x00);
343 if (event_is_no_op) {
344 event_queue.pop();
345 } else {
346 break;
347 }
348 }
349 // To be removed in VTS release builds
350 while (acl_queue.size() > 0) {
351 hidl_vec<uint8_t> acl_packet = acl_queue.front();
352 uint16_t connection_handle = acl_packet[1] & 0xF;
353 connection_handle <<= 8;
354 connection_handle |= acl_packet[0];
355 bool packet_is_no_op = connection_handle == ACL_HANDLE_QCA_DEBUG_MESSAGE;
356 if (packet_is_no_op) {
357 acl_queue.pop();
358 } else {
359 break;
360 }
361 }
362 }
363
364 // Receive an event, discarding NO-OPs.
wait_for_event(bool timeout_is_error=true)365 void BluetoothHidlTest::wait_for_event(bool timeout_is_error = true) {
366 hidl_vec<uint8_t> event;
367 do {
368 bool no_timeout =
369 bluetooth_cb->WaitForCallback(kCallbackNameHciEventReceived).no_timeout;
370 EXPECT_TRUE(no_timeout || !timeout_is_error);
371 if (no_timeout && timeout_is_error) {
372 EXPECT_LT(static_cast<size_t>(0), event_queue.size());
373 }
374 if (event_queue.size() == 0) {
375 // WaitForCallback timed out.
376 return;
377 }
378 handle_no_ops();
379 } while (event_queue.size() == 0);
380 }
381
382 // Wait until a COMMAND_COMPLETE is received.
wait_for_command_complete_event(hidl_vec<uint8_t> cmd)383 hidl_vec<uint8_t> BluetoothHidlTest::wait_for_command_complete_event(hidl_vec<uint8_t> cmd) {
384 wait_for_event();
385 hidl_vec<uint8_t> event = event_queue.front();
386 event_queue.pop();
387
388 EXPECT_GT(event.size(),
389 static_cast<size_t>(EVENT_COMMAND_COMPLETE_STATUS_BYTE));
390 EXPECT_EQ(EVENT_COMMAND_COMPLETE, event[EVENT_CODE_BYTE]);
391 EXPECT_EQ(cmd[0], event[EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE]);
392 EXPECT_EQ(cmd[1], event[EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE + 1]);
393 EXPECT_EQ(HCI_STATUS_SUCCESS, event[EVENT_COMMAND_COMPLETE_STATUS_BYTE]);
394
395 return event;
396 }
397
398 // Send the command to read the controller's buffer sizes.
setBufferSizes()399 void BluetoothHidlTest::setBufferSizes() {
400 hidl_vec<uint8_t> cmd = COMMAND_HCI_READ_BUFFER_SIZE;
401 bluetooth->sendHciCommand(cmd);
402
403 wait_for_event();
404 if (event_queue.size() == 0) return;
405
406 hidl_vec<uint8_t> event = event_queue.front();
407 event_queue.pop();
408
409 EXPECT_EQ(EVENT_COMMAND_COMPLETE, event[EVENT_CODE_BYTE]);
410 EXPECT_EQ(cmd[0], event[EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE]);
411 EXPECT_EQ(cmd[1], event[EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE + 1]);
412 EXPECT_EQ(HCI_STATUS_SUCCESS, event[EVENT_COMMAND_COMPLETE_STATUS_BYTE]);
413
414 max_acl_data_packet_length =
415 event[EVENT_COMMAND_COMPLETE_STATUS_BYTE + 1] +
416 (event[EVENT_COMMAND_COMPLETE_STATUS_BYTE + 2] << 8);
417 max_sco_data_packet_length = event[EVENT_COMMAND_COMPLETE_STATUS_BYTE + 3];
418 max_acl_data_packets = event[EVENT_COMMAND_COMPLETE_STATUS_BYTE + 4] +
419 (event[EVENT_COMMAND_COMPLETE_STATUS_BYTE + 5] << 8);
420 max_sco_data_packets = event[EVENT_COMMAND_COMPLETE_STATUS_BYTE + 6] +
421 (event[EVENT_COMMAND_COMPLETE_STATUS_BYTE + 7] << 8);
422
423 ALOGD("%s: ACL max %d num %d SCO max %d num %d", __func__,
424 static_cast<int>(max_acl_data_packet_length),
425 static_cast<int>(max_acl_data_packets),
426 static_cast<int>(max_sco_data_packet_length),
427 static_cast<int>(max_sco_data_packets));
428 }
429
430 // Send an HCI command (in Loopback mode) and check the response.
sendAndCheckHCI(int num_packets)431 void BluetoothHidlTest::sendAndCheckHCI(int num_packets) {
432 ThroughputLogger logger = {__func__};
433 int command_size = 0;
434 for (int n = 0; n < num_packets; n++) {
435 // Send an HCI packet
436 std::vector<uint8_t> write_name = COMMAND_HCI_WRITE_LOCAL_NAME;
437 // With a name
438 char new_name[] = "John Jacob Jingleheimer Schmidt ___________________0";
439 size_t new_name_length = strlen(new_name);
440 for (size_t i = 0; i < new_name_length; i++)
441 write_name.push_back(static_cast<uint8_t>(new_name[i]));
442 // And the packet number
443 size_t i = new_name_length - 1;
444 for (int digits = n; digits > 0; digits = digits / 10, i--)
445 write_name[i] = static_cast<uint8_t>('0' + digits % 10);
446 // And padding
447 for (size_t i = 0; i < 248 - new_name_length; i++)
448 write_name.push_back(static_cast<uint8_t>(0));
449
450 hidl_vec<uint8_t> cmd = write_name;
451 bluetooth->sendHciCommand(cmd);
452
453 // Check the loopback of the HCI packet
454 wait_for_event();
455 if (event_queue.size() == 0) return;
456
457 hidl_vec<uint8_t> event = event_queue.front();
458 event_queue.pop();
459 size_t compare_length =
460 (cmd.size() > static_cast<size_t>(0xff) ? static_cast<size_t>(0xff)
461 : cmd.size());
462 EXPECT_GT(event.size(), compare_length + EVENT_FIRST_PAYLOAD_BYTE - 1);
463
464 EXPECT_EQ(EVENT_LOOPBACK_COMMAND, event[EVENT_CODE_BYTE]);
465 EXPECT_EQ(compare_length, event[EVENT_LENGTH_BYTE]);
466
467 // Don't compare past the end of the event.
468 if (compare_length + EVENT_FIRST_PAYLOAD_BYTE > event.size()) {
469 compare_length = event.size() - EVENT_FIRST_PAYLOAD_BYTE;
470 ALOGE("Only comparing %d bytes", static_cast<int>(compare_length));
471 }
472
473 if (n == num_packets - 1) {
474 command_size = cmd.size();
475 }
476
477 for (size_t i = 0; i < compare_length; i++)
478 EXPECT_EQ(cmd[i], event[EVENT_FIRST_PAYLOAD_BYTE + i]);
479 }
480 logger.setTotalBytes(command_size * num_packets * 2);
481 }
482
483 // Send a SCO data packet (in Loopback mode) and check the response.
sendAndCheckSCO(int num_packets,size_t size,uint16_t handle)484 void BluetoothHidlTest::sendAndCheckSCO(int num_packets, size_t size,
485 uint16_t handle) {
486 ThroughputLogger logger = {__func__};
487 for (int n = 0; n < num_packets; n++) {
488 // Send a SCO packet
489 hidl_vec<uint8_t> sco_packet;
490 std::vector<uint8_t> sco_vector;
491 sco_vector.push_back(static_cast<uint8_t>(handle & 0xff));
492 sco_vector.push_back(static_cast<uint8_t>((handle & 0x0f00) >> 8));
493 sco_vector.push_back(static_cast<uint8_t>(size & 0xff));
494 sco_vector.push_back(static_cast<uint8_t>((size & 0xff00) >> 8));
495 for (size_t i = 0; i < size; i++) {
496 sco_vector.push_back(static_cast<uint8_t>(i + n));
497 }
498 sco_packet = sco_vector;
499 bluetooth->sendScoData(sco_vector);
500
501 // Check the loopback of the SCO packet
502 EXPECT_TRUE(bluetooth_cb->WaitForCallback(kCallbackNameScoEventReceived)
503 .no_timeout);
504 hidl_vec<uint8_t> sco_loopback = sco_queue.front();
505 sco_queue.pop();
506
507 EXPECT_EQ(sco_packet.size(), sco_loopback.size());
508 size_t successful_bytes = 0;
509
510 for (size_t i = 0; i < sco_packet.size(); i++) {
511 if (sco_packet[i] == sco_loopback[i]) {
512 successful_bytes = i;
513 } else {
514 ALOGE("Miscompare at %d (expected %x, got %x)", static_cast<int>(i),
515 sco_packet[i], sco_loopback[i]);
516 ALOGE("At %d (expected %x, got %x)", static_cast<int>(i + 1),
517 sco_packet[i + 1], sco_loopback[i + 1]);
518 break;
519 }
520 }
521 EXPECT_EQ(sco_packet.size(), successful_bytes + 1);
522 }
523 logger.setTotalBytes(num_packets * size * 2);
524 }
525
526 // Send an ACL data packet (in Loopback mode) and check the response.
sendAndCheckACL(int num_packets,size_t size,uint16_t handle)527 void BluetoothHidlTest::sendAndCheckACL(int num_packets, size_t size,
528 uint16_t handle) {
529 ThroughputLogger logger = {__func__};
530 for (int n = 0; n < num_packets; n++) {
531 // Send an ACL packet
532 hidl_vec<uint8_t> acl_packet;
533 std::vector<uint8_t> acl_vector;
534 acl_vector.push_back(static_cast<uint8_t>(handle & 0xff));
535 acl_vector.push_back(static_cast<uint8_t>((handle & 0x0f00) >> 8) |
536 ACL_BROADCAST_POINT_TO_POINT |
537 ACL_PACKET_BOUNDARY_FIRST_AUTO_FLUSHABLE);
538 acl_vector.push_back(static_cast<uint8_t>(size & 0xff));
539 acl_vector.push_back(static_cast<uint8_t>((size & 0xff00) >> 8));
540 for (size_t i = 0; i < size; i++) {
541 acl_vector.push_back(static_cast<uint8_t>(i + n));
542 }
543 acl_packet = acl_vector;
544 bluetooth->sendAclData(acl_vector);
545
546 // Check the loopback of the ACL packet
547 EXPECT_TRUE(bluetooth_cb->WaitForCallback(kCallbackNameAclEventReceived)
548 .no_timeout);
549 hidl_vec<uint8_t> acl_loopback = acl_queue.front();
550 acl_queue.pop();
551
552 EXPECT_EQ(acl_packet.size(), acl_loopback.size());
553 size_t successful_bytes = 0;
554
555 for (size_t i = 0; i < acl_packet.size(); i++) {
556 if (acl_packet[i] == acl_loopback[i]) {
557 successful_bytes = i;
558 } else {
559 ALOGE("Miscompare at %d (expected %x, got %x)", static_cast<int>(i),
560 acl_packet[i], acl_loopback[i]);
561 ALOGE("At %d (expected %x, got %x)", static_cast<int>(i + 1),
562 acl_packet[i + 1], acl_loopback[i + 1]);
563 break;
564 }
565 }
566 EXPECT_EQ(acl_packet.size(), successful_bytes + 1);
567 }
568 logger.setTotalBytes(num_packets * size * 2);
569 }
570
571 // Return the number of completed packets reported by the controller.
wait_for_completed_packets_event(uint16_t handle)572 int BluetoothHidlTest::wait_for_completed_packets_event(uint16_t handle) {
573 int packets_processed = 0;
574 while (true) {
575 // There should be at least one event.
576 wait_for_event(packets_processed == 0);
577 if (event_queue.empty()) {
578 if (packets_processed == 0) {
579 ALOGW("%s: WaitForCallback timed out.", __func__);
580 }
581 return packets_processed;
582 }
583 hidl_vec<uint8_t> event = event_queue.front();
584 event_queue.pop();
585
586 EXPECT_EQ(EVENT_NUMBER_OF_COMPLETED_PACKETS, event[EVENT_CODE_BYTE]);
587 EXPECT_EQ(1, event[EVENT_NUMBER_OF_COMPLETED_PACKETS_NUM_HANDLES]);
588
589 uint16_t event_handle = event[3] + (event[4] << 8);
590 EXPECT_EQ(handle, event_handle);
591
592 packets_processed += event[5] + (event[6] << 8);
593 }
594 return packets_processed;
595 }
596
597 // Send local loopback command and initialize SCO and ACL handles.
enterLoopbackMode(std::vector<uint16_t> * sco_handles,std::vector<uint16_t> * acl_handles)598 void BluetoothHidlTest::enterLoopbackMode(std::vector<uint16_t>* sco_handles,
599 std::vector<uint16_t>* acl_handles) {
600 hidl_vec<uint8_t> cmd = COMMAND_HCI_WRITE_LOOPBACK_MODE_LOCAL;
601 bluetooth->sendHciCommand(cmd);
602
603 // Receive connection complete events with data channels
604 int connection_event_count = 0;
605 bool command_complete_received = false;
606 while (true) {
607 wait_for_event(false);
608 if (event_queue.size() == 0) {
609 // Fail if there was no event received or no connections completed.
610 EXPECT_TRUE(command_complete_received);
611 EXPECT_LT(0, connection_event_count);
612 return;
613 }
614 hidl_vec<uint8_t> event = event_queue.front();
615 event_queue.pop();
616 EXPECT_GT(event.size(),
617 static_cast<size_t>(EVENT_COMMAND_COMPLETE_STATUS_BYTE));
618 if (event[EVENT_CODE_BYTE] == EVENT_CONNECTION_COMPLETE) {
619 EXPECT_GT(event.size(),
620 static_cast<size_t>(EVENT_CONNECTION_COMPLETE_TYPE));
621 EXPECT_EQ(event[EVENT_LENGTH_BYTE],
622 EVENT_CONNECTION_COMPLETE_PARAM_LENGTH);
623 uint8_t connection_type = event[EVENT_CONNECTION_COMPLETE_TYPE];
624
625 EXPECT_TRUE(connection_type == EVENT_CONNECTION_COMPLETE_TYPE_SCO ||
626 connection_type == EVENT_CONNECTION_COMPLETE_TYPE_ACL);
627
628 // Save handles
629 uint16_t handle = event[EVENT_CONNECTION_COMPLETE_HANDLE_LSBYTE] |
630 event[EVENT_CONNECTION_COMPLETE_HANDLE_LSBYTE + 1] << 8;
631 if (connection_type == EVENT_CONNECTION_COMPLETE_TYPE_SCO)
632 sco_handles->push_back(handle);
633 else
634 acl_handles->push_back(handle);
635
636 ALOGD("Connect complete type = %d handle = %d",
637 event[EVENT_CONNECTION_COMPLETE_TYPE], handle);
638 connection_event_count++;
639 } else {
640 EXPECT_EQ(EVENT_COMMAND_COMPLETE, event[EVENT_CODE_BYTE]);
641 EXPECT_EQ(cmd[0], event[EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE]);
642 EXPECT_EQ(cmd[1], event[EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE + 1]);
643 EXPECT_EQ(HCI_STATUS_SUCCESS, event[EVENT_COMMAND_COMPLETE_STATUS_BYTE]);
644 command_complete_received = true;
645 }
646 }
647 }
648
649 // Empty test: Initialize()/Close() are called in SetUp()/TearDown().
TEST_P(BluetoothHidlTest,InitializeAndClose)650 TEST_P(BluetoothHidlTest, InitializeAndClose) {}
651
652 // Send an HCI Reset with sendHciCommand and wait for a command complete event.
TEST_P(BluetoothHidlTest,HciReset)653 TEST_P(BluetoothHidlTest, HciReset) {
654 hidl_vec<uint8_t> cmd = COMMAND_HCI_RESET;
655 bluetooth->sendHciCommand(cmd);
656
657 wait_for_command_complete_event(cmd);
658 }
659
660 // Read and check the HCI version of the controller.
TEST_P(BluetoothHidlTest,HciVersionTest)661 TEST_P(BluetoothHidlTest, HciVersionTest) {
662 hidl_vec<uint8_t> cmd = COMMAND_HCI_READ_LOCAL_VERSION_INFORMATION;
663 bluetooth->sendHciCommand(cmd);
664
665 wait_for_event();
666 if (event_queue.size() == 0) return;
667
668 hidl_vec<uint8_t> event = event_queue.front();
669 event_queue.pop();
670 EXPECT_GT(event.size(), static_cast<size_t>(EVENT_LOCAL_LMP_VERSION_BYTE));
671
672 EXPECT_EQ(EVENT_COMMAND_COMPLETE, event[EVENT_CODE_BYTE]);
673 EXPECT_EQ(cmd[0], event[EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE]);
674 EXPECT_EQ(cmd[1], event[EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE + 1]);
675 EXPECT_EQ(HCI_STATUS_SUCCESS, event[EVENT_COMMAND_COMPLETE_STATUS_BYTE]);
676
677 EXPECT_LE(HCI_MINIMUM_HCI_VERSION, event[EVENT_LOCAL_HCI_VERSION_BYTE]);
678 EXPECT_LE(HCI_MINIMUM_LMP_VERSION, event[EVENT_LOCAL_LMP_VERSION_BYTE]);
679 }
680
681 /**
682 * VSR-5.3.14-007 MUST support Bluetooth 4.2 and Bluetooth LE Data Length Extension.
683 * VSR-5.3.14-008 MUST support Bluetooth Low Energy (BLE).
684 */
685 // @VsrTest = 5.3.14-007
686 // @VsrTest = 5.3.14-008
TEST_P(BluetoothHidlTest,Bluetooth4_2)687 TEST_P(BluetoothHidlTest, Bluetooth4_2) {
688 // Bluetooth 4.2+
689 hidl_vec<uint8_t> cmd = COMMAND_HCI_READ_LOCAL_VERSION_INFORMATION;
690 bluetooth->sendHciCommand(cmd);
691 auto event = wait_for_command_complete_event(cmd);
692
693 EXPECT_LE(HCI_BLUETOOTH4_2_HCI_VERSION, event[EVENT_LOCAL_HCI_VERSION_BYTE]);
694 EXPECT_LE(HCI_BLUETOOTH4_2_LMP_VERSION, event[EVENT_LOCAL_LMP_VERSION_BYTE]);
695
696 // BLE
697 cmd = COMMAND_HCI_READ_LOCAL_SUPPORTED_FEATURES;
698 bluetooth->sendHciCommand(cmd);
699 event = wait_for_command_complete_event(cmd);
700 EXPECT_TRUE(event[EVENT_LOCAL_SUPPORTED_FEATURES_LE_SUPPORTED_BYTE] &
701 EVENT_LOCAL_SUPPORTED_FEATURES_LE_SUPPORTED_BITMASK);
702
703 // BLE Data Length Extension
704 cmd = COMMAND_HCI_LE_READ_LOCAL_SUPPORTED_FEATURES;
705 bluetooth->sendHciCommand(cmd);
706 event = wait_for_command_complete_event(cmd);
707 EXPECT_TRUE(event[EVENT_LOCAL_LE_SUPPORTED_FEATURES_DATA_LENGTH_EXTENSION_BYTE] &
708 EVENT_LOCAL_LE_SUPPORTED_FEATURES_DATA_LENGTH_BITMASK);
709 }
710
711 // Send an unknown HCI command and wait for the error message.
TEST_P(BluetoothHidlTest,HciUnknownCommand)712 TEST_P(BluetoothHidlTest, HciUnknownCommand) {
713 hidl_vec<uint8_t> cmd = COMMAND_HCI_SHOULD_BE_UNKNOWN;
714 bluetooth->sendHciCommand(cmd);
715
716 wait_for_event();
717 if (event_queue.size() == 0) return;
718
719 hidl_vec<uint8_t> event = event_queue.front();
720 event_queue.pop();
721
722 EXPECT_GT(event.size(),
723 static_cast<size_t>(EVENT_COMMAND_COMPLETE_STATUS_BYTE));
724 if (event[EVENT_CODE_BYTE] == EVENT_COMMAND_COMPLETE) {
725 EXPECT_EQ(cmd[0], event[EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE]);
726 EXPECT_EQ(cmd[1], event[EVENT_COMMAND_COMPLETE_OPCODE_LSBYTE + 1]);
727 EXPECT_EQ(HCI_STATUS_UNKNOWN_HCI_COMMAND,
728 event[EVENT_COMMAND_COMPLETE_STATUS_BYTE]);
729 } else {
730 EXPECT_EQ(EVENT_COMMAND_STATUS, event[EVENT_CODE_BYTE]);
731 EXPECT_EQ(cmd[0], event[EVENT_COMMAND_STATUS_OPCODE_LSBYTE]);
732 EXPECT_EQ(cmd[1], event[EVENT_COMMAND_STATUS_OPCODE_LSBYTE + 1]);
733 EXPECT_EQ(HCI_STATUS_UNKNOWN_HCI_COMMAND,
734 event[EVENT_COMMAND_STATUS_STATUS_BYTE]);
735 }
736 }
737
738 // Enter loopback mode, but don't send any packets.
TEST_P(BluetoothHidlTest,WriteLoopbackMode)739 TEST_P(BluetoothHidlTest, WriteLoopbackMode) {
740 std::vector<uint16_t> sco_connection_handles;
741 std::vector<uint16_t> acl_connection_handles;
742 enterLoopbackMode(&sco_connection_handles, &acl_connection_handles);
743 }
744
745 // Enter loopback mode and send single packets.
TEST_P(BluetoothHidlTest,LoopbackModeSinglePackets)746 TEST_P(BluetoothHidlTest, LoopbackModeSinglePackets) {
747 setBufferSizes();
748
749 std::vector<uint16_t> sco_connection_handles;
750 std::vector<uint16_t> acl_connection_handles;
751 enterLoopbackMode(&sco_connection_handles, &acl_connection_handles);
752
753 sendAndCheckHCI(1);
754
755 // This should work, but breaks on some current platforms. Figure out how to
756 // grandfather older devices but test new ones.
757 if (0 && sco_connection_handles.size() > 0) {
758 EXPECT_LT(0, max_sco_data_packet_length);
759 sendAndCheckSCO(1, max_sco_data_packet_length, sco_connection_handles[0]);
760 int sco_packets_sent = 1;
761 int completed_packets =
762 wait_for_completed_packets_event(sco_connection_handles[0]);
763 if (sco_packets_sent != completed_packets) {
764 ALOGW("%s: packets_sent (%d) != completed_packets (%d)", __func__,
765 sco_packets_sent, completed_packets);
766 }
767 }
768
769 if (acl_connection_handles.size() > 0) {
770 EXPECT_LT(0, max_acl_data_packet_length);
771 sendAndCheckACL(1, max_acl_data_packet_length, acl_connection_handles[0]);
772 int acl_packets_sent = 1;
773 int completed_packets =
774 wait_for_completed_packets_event(acl_connection_handles[0]);
775 if (acl_packets_sent != completed_packets) {
776 ALOGW("%s: packets_sent (%d) != completed_packets (%d)", __func__,
777 acl_packets_sent, completed_packets);
778 }
779 }
780 }
781
782 // Enter loopback mode and send packets for bandwidth measurements.
TEST_P(BluetoothHidlTest,LoopbackModeBandwidth)783 TEST_P(BluetoothHidlTest, LoopbackModeBandwidth) {
784 setBufferSizes();
785
786 std::vector<uint16_t> sco_connection_handles;
787 std::vector<uint16_t> acl_connection_handles;
788 enterLoopbackMode(&sco_connection_handles, &acl_connection_handles);
789
790 sendAndCheckHCI(NUM_HCI_COMMANDS_BANDWIDTH);
791
792 // This should work, but breaks on some current platforms. Figure out how to
793 // grandfather older devices but test new ones.
794 if (0 && sco_connection_handles.size() > 0) {
795 EXPECT_LT(0, max_sco_data_packet_length);
796 sendAndCheckSCO(NUM_SCO_PACKETS_BANDWIDTH, max_sco_data_packet_length,
797 sco_connection_handles[0]);
798 int sco_packets_sent = NUM_SCO_PACKETS_BANDWIDTH;
799 int completed_packets =
800 wait_for_completed_packets_event(sco_connection_handles[0]);
801 if (sco_packets_sent != completed_packets) {
802 ALOGW("%s: packets_sent (%d) != completed_packets (%d)", __func__,
803 sco_packets_sent, completed_packets);
804 }
805 }
806
807 if (acl_connection_handles.size() > 0) {
808 EXPECT_LT(0, max_acl_data_packet_length);
809 sendAndCheckACL(NUM_ACL_PACKETS_BANDWIDTH, max_acl_data_packet_length,
810 acl_connection_handles[0]);
811 int acl_packets_sent = NUM_ACL_PACKETS_BANDWIDTH;
812 int completed_packets =
813 wait_for_completed_packets_event(acl_connection_handles[0]);
814 if (acl_packets_sent != completed_packets) {
815 ALOGW("%s: packets_sent (%d) != completed_packets (%d)", __func__,
816 acl_packets_sent, completed_packets);
817 }
818 }
819 }
820
821 GTEST_ALLOW_UNINSTANTIATED_PARAMETERIZED_TEST(BluetoothHidlTest);
822 INSTANTIATE_TEST_SUITE_P(
823 PerInstance, BluetoothHidlTest,
824 testing::ValuesIn(
825 android::hardware::getAllHalInstanceNames(IBluetoothHci::descriptor)),
826 android::hardware::PrintInstanceNameToString);
827