• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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