1 /*
2 * Copyright (C) 2017 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 EGMOCK_VERBOSE 1
18
19 #include <android-base/logging.h>
20 #include <android-base/strings.h>
21 #include <android/hardware/broadcastradio/2.0/IBroadcastRadio.h>
22 #include <android/hardware/broadcastradio/2.0/ITunerCallback.h>
23 #include <android/hardware/broadcastradio/2.0/ITunerSession.h>
24 #include <android/hardware/broadcastradio/2.0/types.h>
25 #include <broadcastradio-utils-2x/Utils.h>
26 #include <broadcastradio-vts-utils/call-barrier.h>
27 #include <broadcastradio-vts-utils/mock-timeout.h>
28 #include <broadcastradio-vts-utils/pointer-utils.h>
29 #include <cutils/bitops.h>
30 #include <gmock/gmock.h>
31 #include <gtest/gtest.h>
32 #include <hidl/GtestPrinter.h>
33 #include <hidl/ServiceManagement.h>
34
35 #include <chrono>
36 #include <optional>
37 #include <regex>
38
39 namespace android {
40 namespace hardware {
41 namespace broadcastradio {
42 namespace V2_0 {
43 namespace vts {
44
45 using namespace std::chrono_literals;
46
47 using std::unordered_set;
48 using std::vector;
49 using testing::_;
50 using testing::AnyNumber;
51 using testing::ByMove;
52 using testing::DoAll;
53 using testing::Invoke;
54 using testing::SaveArg;
55
56 using broadcastradio::vts::CallBarrier;
57 using broadcastradio::vts::clearAndWait;
58 using utils::make_identifier;
59 using utils::make_selector_amfm;
60
61 namespace timeout {
62
63 static constexpr auto tune = 30s;
64 static constexpr auto programListScan = 5min;
65
66 } // namespace timeout
67
68 static constexpr auto gTuneWorkaround = 200ms;
69
70 static const ConfigFlag gConfigFlagValues[] = {
71 ConfigFlag::FORCE_MONO,
72 ConfigFlag::FORCE_ANALOG,
73 ConfigFlag::FORCE_DIGITAL,
74 ConfigFlag::RDS_AF,
75 ConfigFlag::RDS_REG,
76 ConfigFlag::DAB_DAB_LINKING,
77 ConfigFlag::DAB_FM_LINKING,
78 ConfigFlag::DAB_DAB_SOFT_LINKING,
79 ConfigFlag::DAB_FM_SOFT_LINKING,
80 };
81
82 class TunerCallbackMock : public ITunerCallback {
83 public:
84 TunerCallbackMock();
85
86 MOCK_METHOD2(onTuneFailed, Return<void>(Result, const ProgramSelector&));
87 MOCK_TIMEOUT_METHOD1(onCurrentProgramInfoChanged_, Return<void>(const ProgramInfo&));
88 virtual Return<void> onCurrentProgramInfoChanged(const ProgramInfo& info);
89 Return<void> onProgramListUpdated(const ProgramListChunk& chunk);
90 MOCK_METHOD1(onAntennaStateChange, Return<void>(bool connected));
91 MOCK_METHOD1(onParametersUpdated, Return<void>(const hidl_vec<VendorKeyValue>& parameters));
92
93 MOCK_TIMEOUT_METHOD0(onProgramListReady, void());
94
95 std::mutex mLock;
96 utils::ProgramInfoSet mProgramList;
97 };
98
99 struct AnnouncementListenerMock : public IAnnouncementListener {
100 MOCK_METHOD1(onListUpdated, Return<void>(const hidl_vec<Announcement>&));
101 };
102
103 class BroadcastRadioHalTest : public ::testing::TestWithParam<std::string> {
104 protected:
105 virtual void SetUp() override;
106 virtual void TearDown() override;
107
108 bool openSession();
109 bool getAmFmRegionConfig(bool full, AmFmRegionConfig* config);
110 std::optional<utils::ProgramInfoSet> getProgramList();
111
112 sp<IBroadcastRadio> mModule;
113 Properties mProperties;
114 sp<ITunerSession> mSession;
115 sp<TunerCallbackMock> mCallback = new TunerCallbackMock();
116 };
117
printSkipped(std::string msg)118 static void printSkipped(std::string msg) {
119 const auto testInfo = testing::UnitTest::GetInstance()->current_test_info();
120 std::cout << "[ SKIPPED ] " << testInfo->test_case_name() << "." << testInfo->name()
121 << std::endl;
122 std::cout << msg << std::endl;
123 }
124
125 MATCHER_P(InfoHasId, id,
126 std::string(negation ? "does not contain" : "contains") + " " + toString(id)) {
127 auto ids = utils::getAllIds(arg.selector, utils::getType(id));
128 return ids.end() != find(ids.begin(), ids.end(), id.value);
129 }
130
TunerCallbackMock()131 TunerCallbackMock::TunerCallbackMock() {
132 EXPECT_TIMEOUT_CALL(*this, onCurrentProgramInfoChanged_, _).Times(AnyNumber());
133
134 // we expect the antenna is connected through the whole test
135 EXPECT_CALL(*this, onAntennaStateChange(false)).Times(0);
136 }
137
onCurrentProgramInfoChanged(const ProgramInfo & info)138 Return<void> TunerCallbackMock::onCurrentProgramInfoChanged(const ProgramInfo& info) {
139 for (auto&& id : info.selector) {
140 EXPECT_NE(IdentifierType::INVALID, utils::getType(id));
141 }
142
143 auto logically = utils::getType(info.logicallyTunedTo);
144 /* This field is required for currently tuned program and should be INVALID
145 * for entries from the program list.
146 */
147 EXPECT_TRUE(
148 logically == IdentifierType::AMFM_FREQUENCY || logically == IdentifierType::RDS_PI ||
149 logically == IdentifierType::HD_STATION_ID_EXT ||
150 logically == IdentifierType::DAB_SID_EXT || logically == IdentifierType::DRMO_SERVICE_ID ||
151 logically == IdentifierType::SXM_SERVICE_ID ||
152 (logically >= IdentifierType::VENDOR_START && logically <= IdentifierType::VENDOR_END) ||
153 logically > IdentifierType::SXM_CHANNEL);
154
155 auto physically = utils::getType(info.physicallyTunedTo);
156 // ditto (see "logically" above)
157 EXPECT_TRUE(
158 physically == IdentifierType::AMFM_FREQUENCY ||
159 physically == IdentifierType::DAB_ENSEMBLE ||
160 physically == IdentifierType::DRMO_FREQUENCY || physically == IdentifierType::SXM_CHANNEL ||
161 (physically >= IdentifierType::VENDOR_START && physically <= IdentifierType::VENDOR_END) ||
162 physically > IdentifierType::SXM_CHANNEL);
163
164 if (logically == IdentifierType::AMFM_FREQUENCY) {
165 auto ps = utils::getMetadataString(info, MetadataKey::RDS_PS);
166 if (ps.has_value()) {
167 EXPECT_NE("", android::base::Trim(*ps))
168 << "Don't use empty RDS_PS as an indicator of missing RSD PS data.";
169 }
170 }
171
172 return onCurrentProgramInfoChanged_(info);
173 }
174
onProgramListUpdated(const ProgramListChunk & chunk)175 Return<void> TunerCallbackMock::onProgramListUpdated(const ProgramListChunk& chunk) {
176 std::lock_guard<std::mutex> lk(mLock);
177
178 updateProgramList(mProgramList, chunk);
179
180 if (chunk.complete) onProgramListReady();
181
182 return {};
183 }
184
SetUp()185 void BroadcastRadioHalTest::SetUp() {
186 EXPECT_EQ(nullptr, mModule.get()) << "Module is already open";
187
188 // lookup HIDL service (radio module)
189 mModule = IBroadcastRadio::getService(GetParam());
190 ASSERT_NE(nullptr, mModule.get()) << "Couldn't find broadcast radio HAL implementation";
191
192 // get module properties
193 auto propResult = mModule->getProperties([&](const Properties& p) { mProperties = p; });
194 ASSERT_TRUE(propResult.isOk());
195
196 EXPECT_FALSE(mProperties.maker.empty());
197 EXPECT_FALSE(mProperties.product.empty());
198 EXPECT_GT(mProperties.supportedIdentifierTypes.size(), 0u);
199 }
200
TearDown()201 void BroadcastRadioHalTest::TearDown() {
202 mSession.clear();
203 mModule.clear();
204 clearAndWait(mCallback, 1s);
205 }
206
openSession()207 bool BroadcastRadioHalTest::openSession() {
208 EXPECT_EQ(nullptr, mSession.get()) << "Session is already open";
209
210 Result halResult = Result::UNKNOWN_ERROR;
211 auto openCb = [&](Result result, const sp<ITunerSession>& session) {
212 halResult = result;
213 if (result != Result::OK) return;
214 mSession = session;
215 };
216 auto hidlResult = mModule->openSession(mCallback, openCb);
217
218 EXPECT_TRUE(hidlResult.isOk());
219 EXPECT_EQ(Result::OK, halResult);
220 EXPECT_NE(nullptr, mSession.get());
221
222 return nullptr != mSession.get();
223 }
224
getAmFmRegionConfig(bool full,AmFmRegionConfig * config)225 bool BroadcastRadioHalTest::getAmFmRegionConfig(bool full, AmFmRegionConfig* config) {
226 auto halResult = Result::UNKNOWN_ERROR;
227 auto cb = [&](Result result, AmFmRegionConfig configCb) {
228 halResult = result;
229 if (config) *config = configCb;
230 };
231
232 auto hidlResult = mModule->getAmFmRegionConfig(full, cb);
233 EXPECT_TRUE(hidlResult.isOk());
234
235 if (halResult == Result::NOT_SUPPORTED) return false;
236
237 EXPECT_EQ(Result::OK, halResult);
238 return halResult == Result::OK;
239 }
240
getProgramList()241 std::optional<utils::ProgramInfoSet> BroadcastRadioHalTest::getProgramList() {
242 EXPECT_TIMEOUT_CALL(*mCallback, onProgramListReady).Times(AnyNumber());
243
244 auto startResult = mSession->startProgramListUpdates({});
245 if (startResult == Result::NOT_SUPPORTED) {
246 printSkipped("Program list not supported");
247 return std::nullopt;
248 }
249 EXPECT_EQ(Result::OK, startResult);
250 if (startResult != Result::OK) return std::nullopt;
251
252 EXPECT_TIMEOUT_CALL_WAIT(*mCallback, onProgramListReady, timeout::programListScan);
253
254 auto stopResult = mSession->stopProgramListUpdates();
255 EXPECT_TRUE(stopResult.isOk());
256
257 return mCallback->mProgramList;
258 }
259
260 /**
261 * Test session opening.
262 *
263 * Verifies that:
264 * - the method succeeds on a first and subsequent calls;
265 * - the method succeeds when called for the second time without
266 * closing previous session.
267 */
TEST_P(BroadcastRadioHalTest,OpenSession)268 TEST_P(BroadcastRadioHalTest, OpenSession) {
269 // simply open session for the first time
270 ASSERT_TRUE(openSession());
271
272 // drop (without explicit close) and re-open the session
273 mSession.clear();
274 ASSERT_TRUE(openSession());
275
276 // open the second session (the first one should be forcibly closed)
277 auto secondSession = mSession;
278 mSession.clear();
279 ASSERT_TRUE(openSession());
280 }
281
isValidAmFmFreq(uint64_t freq)282 static bool isValidAmFmFreq(uint64_t freq) {
283 auto id = utils::make_identifier(IdentifierType::AMFM_FREQUENCY, freq);
284 return utils::isValid(id);
285 }
286
validateRange(const AmFmBandRange & range)287 static void validateRange(const AmFmBandRange& range) {
288 EXPECT_TRUE(isValidAmFmFreq(range.lowerBound));
289 EXPECT_TRUE(isValidAmFmFreq(range.upperBound));
290 EXPECT_LT(range.lowerBound, range.upperBound);
291 EXPECT_GT(range.spacing, 0u);
292 EXPECT_EQ(0u, (range.upperBound - range.lowerBound) % range.spacing);
293 }
294
supportsFM(const AmFmRegionConfig & config)295 static bool supportsFM(const AmFmRegionConfig& config) {
296 for (auto&& range : config.ranges) {
297 if (utils::getBand(range.lowerBound) == utils::FrequencyBand::FM) return true;
298 }
299 return false;
300 }
301
302 /**
303 * Test fetching AM/FM regional configuration.
304 *
305 * Verifies that:
306 * - AM/FM regional configuration is either set at startup or not supported at all by the hardware;
307 * - there is at least one AM/FM band configured;
308 * - FM Deemphasis and RDS are correctly configured for FM-capable radio;
309 * - all channel grids (frequency ranges and spacings) are valid;
310 * - seek spacing is a multiple of the manual spacing value.
311 */
TEST_P(BroadcastRadioHalTest,GetAmFmRegionConfig)312 TEST_P(BroadcastRadioHalTest, GetAmFmRegionConfig) {
313 AmFmRegionConfig config;
314 bool supported = getAmFmRegionConfig(false, &config);
315 if (!supported) {
316 printSkipped("AM/FM not supported");
317 return;
318 }
319
320 EXPECT_GT(config.ranges.size(), 0u);
321 EXPECT_LE(popcountll(config.fmDeemphasis), 1);
322 EXPECT_LE(popcountll(config.fmRds), 1);
323
324 for (auto&& range : config.ranges) {
325 validateRange(range);
326 EXPECT_EQ(0u, range.scanSpacing % range.spacing);
327 EXPECT_GE(range.scanSpacing, range.spacing);
328 }
329
330 if (supportsFM(config)) {
331 EXPECT_EQ(popcountll(config.fmDeemphasis), 1);
332 }
333 }
334
335 /**
336 * Test fetching AM/FM regional capabilities.
337 *
338 * Verifies that:
339 * - AM/FM regional capabilities are either available or not supported at all by the hardware;
340 * - there is at least one AM/FM range supported;
341 * - there is at least one de-emphasis filter mode supported for FM-capable radio;
342 * - all channel grids (frequency ranges and spacings) are valid;
343 * - seek spacing is not set.
344 */
TEST_P(BroadcastRadioHalTest,GetAmFmRegionConfigCapabilities)345 TEST_P(BroadcastRadioHalTest, GetAmFmRegionConfigCapabilities) {
346 AmFmRegionConfig config;
347 bool supported = getAmFmRegionConfig(true, &config);
348 if (!supported) {
349 printSkipped("AM/FM not supported");
350 return;
351 }
352
353 EXPECT_GT(config.ranges.size(), 0u);
354
355 for (auto&& range : config.ranges) {
356 validateRange(range);
357 EXPECT_EQ(0u, range.scanSpacing);
358 }
359
360 if (supportsFM(config)) {
361 EXPECT_GE(popcountll(config.fmDeemphasis), 1);
362 }
363 }
364
365 /**
366 * Test fetching DAB regional configuration.
367 *
368 * Verifies that:
369 * - DAB regional configuration is either set at startup or not supported at all by the hardware;
370 * - all channel labels match correct format;
371 * - all channel frequencies are in correct range.
372 */
TEST_P(BroadcastRadioHalTest,GetDabRegionConfig)373 TEST_P(BroadcastRadioHalTest, GetDabRegionConfig) {
374 Result halResult;
375 hidl_vec<DabTableEntry> config;
376 auto cb = [&](Result result, hidl_vec<DabTableEntry> configCb) {
377 halResult = result;
378 config = configCb;
379 };
380 auto hidlResult = mModule->getDabRegionConfig(cb);
381 ASSERT_TRUE(hidlResult.isOk());
382
383 if (halResult == Result::NOT_SUPPORTED) {
384 printSkipped("DAB not supported");
385 return;
386 }
387 ASSERT_EQ(Result::OK, halResult);
388
389 std::regex re("^[A-Z0-9][A-Z0-9 ]{0,5}[A-Z0-9]$");
390 // double-check correctness of the test
391 ASSERT_TRUE(std::regex_match("5A", re));
392 ASSERT_FALSE(std::regex_match("5a", re));
393 ASSERT_FALSE(std::regex_match("1234ABCD", re));
394 ASSERT_TRUE(std::regex_match("CN 12D", re));
395 ASSERT_FALSE(std::regex_match(" 5A", re));
396
397 for (auto&& entry : config) {
398 EXPECT_TRUE(std::regex_match(std::string(entry.label), re));
399
400 auto id = utils::make_identifier(IdentifierType::DAB_FREQUENCY, entry.frequency);
401 EXPECT_TRUE(utils::isValid(id));
402 }
403 }
404
405 /**
406 * Test tuning with FM selector.
407 *
408 * Verifies that:
409 * - if AM/FM selector is not supported, the method returns NOT_SUPPORTED;
410 * - if it is supported, the method succeeds;
411 * - after a successful tune call, onCurrentProgramInfoChanged callback is
412 * invoked carrying a proper selector;
413 * - program changes exactly to what was requested.
414 */
TEST_P(BroadcastRadioHalTest,FmTune)415 TEST_P(BroadcastRadioHalTest, FmTune) {
416 ASSERT_TRUE(openSession());
417
418 uint64_t freq = 100100; // 100.1 FM
419 auto sel = make_selector_amfm(freq);
420
421 /* TODO(b/69958777): there is a race condition between tune() and onCurrentProgramInfoChanged
422 * callback setting infoCb, because egmock cannot distinguish calls with different matchers
423 * (there is one here and one in callback constructor).
424 *
425 * This sleep workaround will fix default implementation, but the real HW tests will still be
426 * flaky. We probably need to implement egmock alternative based on actions.
427 */
428 std::this_thread::sleep_for(gTuneWorkaround);
429
430 // try tuning
431 ProgramInfo infoCb = {};
432 EXPECT_TIMEOUT_CALL(*mCallback, onCurrentProgramInfoChanged_,
433 InfoHasId(utils::make_identifier(IdentifierType::AMFM_FREQUENCY, freq)))
434 .Times(AnyNumber())
435 .WillOnce(DoAll(SaveArg<0>(&infoCb), testing::Return(ByMove(Void()))))
436 .WillRepeatedly(testing::InvokeWithoutArgs([] { return Void(); }));
437 auto result = mSession->tune(sel);
438
439 // expect a failure if it's not supported
440 if (!utils::isSupported(mProperties, sel)) {
441 EXPECT_EQ(Result::NOT_SUPPORTED, result);
442 return;
443 }
444
445 // expect a callback if it succeeds
446 EXPECT_EQ(Result::OK, result);
447 EXPECT_TIMEOUT_CALL_WAIT(*mCallback, onCurrentProgramInfoChanged_, timeout::tune);
448
449 LOG(DEBUG) << "current program info: " << toString(infoCb);
450
451 // it should tune exactly to what was requested
452 auto freqs = utils::getAllIds(infoCb.selector, IdentifierType::AMFM_FREQUENCY);
453 EXPECT_NE(freqs.end(), find(freqs.begin(), freqs.end(), freq));
454 }
455
456 /**
457 * Test tuning with invalid selectors.
458 *
459 * Verifies that:
460 * - if the selector is not supported, it's ignored;
461 * - if it is supported, an invalid value results with INVALID_ARGUMENTS;
462 */
TEST_P(BroadcastRadioHalTest,TuneFailsWithInvalid)463 TEST_P(BroadcastRadioHalTest, TuneFailsWithInvalid) {
464 ASSERT_TRUE(openSession());
465
466 vector<ProgramIdentifier> invalid = {
467 make_identifier(IdentifierType::AMFM_FREQUENCY, 0),
468 make_identifier(IdentifierType::RDS_PI, 0x10000),
469 make_identifier(IdentifierType::HD_STATION_ID_EXT, 0x100000000),
470 make_identifier(IdentifierType::DAB_SID_EXT, 0),
471 make_identifier(IdentifierType::DRMO_SERVICE_ID, 0x100000000),
472 make_identifier(IdentifierType::SXM_SERVICE_ID, 0x100000000),
473 };
474
475 for (auto&& id : invalid) {
476 ProgramSelector sel{id, {}};
477
478 auto result = mSession->tune(sel);
479
480 if (utils::isSupported(mProperties, sel)) {
481 EXPECT_EQ(Result::INVALID_ARGUMENTS, result);
482 } else {
483 EXPECT_EQ(Result::NOT_SUPPORTED, result);
484 }
485 }
486 }
487
488 /**
489 * Test tuning with empty program selector.
490 *
491 * Verifies that:
492 * - tune fails with NOT_SUPPORTED when program selector is not initialized.
493 */
TEST_P(BroadcastRadioHalTest,TuneFailsWithEmpty)494 TEST_P(BroadcastRadioHalTest, TuneFailsWithEmpty) {
495 ASSERT_TRUE(openSession());
496
497 // Program type is 1-based, so 0 will always be invalid.
498 ProgramSelector sel = {};
499 auto result = mSession->tune(sel);
500 ASSERT_EQ(Result::NOT_SUPPORTED, result);
501 }
502
503 /**
504 * Test seeking to next/prev station via ITunerSession::scan().
505 *
506 * Verifies that:
507 * - the method succeeds;
508 * - the program info is changed within timeout::tune;
509 * - works both directions and with or without skipping sub-channel.
510 */
TEST_P(BroadcastRadioHalTest,Seek)511 TEST_P(BroadcastRadioHalTest, Seek) {
512 ASSERT_TRUE(openSession());
513
514 // TODO(b/69958777): see FmTune workaround
515 std::this_thread::sleep_for(gTuneWorkaround);
516
517 EXPECT_TIMEOUT_CALL(*mCallback, onCurrentProgramInfoChanged_, _).Times(AnyNumber());
518 auto result = mSession->scan(true /* up */, true /* skip subchannel */);
519 EXPECT_EQ(Result::OK, result);
520 EXPECT_TIMEOUT_CALL_WAIT(*mCallback, onCurrentProgramInfoChanged_, timeout::tune);
521
522 EXPECT_TIMEOUT_CALL(*mCallback, onCurrentProgramInfoChanged_, _).Times(AnyNumber());
523 result = mSession->scan(false /* down */, false /* don't skip subchannel */);
524 EXPECT_EQ(Result::OK, result);
525 EXPECT_TIMEOUT_CALL_WAIT(*mCallback, onCurrentProgramInfoChanged_, timeout::tune);
526 }
527
528 /**
529 * Test step operation.
530 *
531 * Verifies that:
532 * - the method succeeds or returns NOT_SUPPORTED;
533 * - the program info is changed within timeout::tune if the method succeeded;
534 * - works both directions.
535 */
TEST_P(BroadcastRadioHalTest,Step)536 TEST_P(BroadcastRadioHalTest, Step) {
537 ASSERT_TRUE(openSession());
538
539 // TODO(b/69958777): see FmTune workaround
540 std::this_thread::sleep_for(gTuneWorkaround);
541
542 EXPECT_TIMEOUT_CALL(*mCallback, onCurrentProgramInfoChanged_, _).Times(AnyNumber());
543 auto result = mSession->step(true /* up */);
544 if (result == Result::NOT_SUPPORTED) {
545 printSkipped("step not supported");
546 return;
547 }
548 EXPECT_EQ(Result::OK, result);
549 EXPECT_TIMEOUT_CALL_WAIT(*mCallback, onCurrentProgramInfoChanged_, timeout::tune);
550
551 EXPECT_TIMEOUT_CALL(*mCallback, onCurrentProgramInfoChanged_, _).Times(AnyNumber());
552 result = mSession->step(false /* down */);
553 EXPECT_EQ(Result::OK, result);
554 EXPECT_TIMEOUT_CALL_WAIT(*mCallback, onCurrentProgramInfoChanged_, timeout::tune);
555 }
556
557 /**
558 * Test tune cancellation.
559 *
560 * Verifies that:
561 * - the method does not crash after being invoked multiple times.
562 */
TEST_P(BroadcastRadioHalTest,Cancel)563 TEST_P(BroadcastRadioHalTest, Cancel) {
564 ASSERT_TRUE(openSession());
565
566 for (int i = 0; i < 10; i++) {
567 auto result = mSession->scan(true /* up */, true /* skip subchannel */);
568 ASSERT_EQ(Result::OK, result);
569
570 auto cancelResult = mSession->cancel();
571 ASSERT_TRUE(cancelResult.isOk());
572 }
573 }
574
575 /**
576 * Test IBroadcastRadio::get|setParameters() methods called with no parameters.
577 *
578 * Verifies that:
579 * - callback is called for empty parameters set.
580 */
TEST_P(BroadcastRadioHalTest,NoParameters)581 TEST_P(BroadcastRadioHalTest, NoParameters) {
582 ASSERT_TRUE(openSession());
583
584 hidl_vec<VendorKeyValue> halResults = {};
585 bool wasCalled = false;
586 auto cb = [&](hidl_vec<VendorKeyValue> results) {
587 wasCalled = true;
588 halResults = results;
589 };
590
591 auto hidlResult = mSession->setParameters({}, cb);
592 ASSERT_TRUE(hidlResult.isOk());
593 ASSERT_TRUE(wasCalled);
594 ASSERT_EQ(0u, halResults.size());
595
596 wasCalled = false;
597 hidlResult = mSession->getParameters({}, cb);
598 ASSERT_TRUE(hidlResult.isOk());
599 ASSERT_TRUE(wasCalled);
600 ASSERT_EQ(0u, halResults.size());
601 }
602
603 /**
604 * Test IBroadcastRadio::get|setParameters() methods called with unknown parameters.
605 *
606 * Verifies that:
607 * - unknown parameters are ignored;
608 * - callback is called also for empty results set.
609 */
TEST_P(BroadcastRadioHalTest,UnknownParameters)610 TEST_P(BroadcastRadioHalTest, UnknownParameters) {
611 ASSERT_TRUE(openSession());
612
613 hidl_vec<VendorKeyValue> halResults = {};
614 bool wasCalled = false;
615 auto cb = [&](hidl_vec<VendorKeyValue> results) {
616 wasCalled = true;
617 halResults = results;
618 };
619
620 auto hidlResult = mSession->setParameters({{"com.google.unknown", "dummy"}}, cb);
621 ASSERT_TRUE(hidlResult.isOk());
622 ASSERT_TRUE(wasCalled);
623 ASSERT_EQ(0u, halResults.size());
624
625 wasCalled = false;
626 hidlResult = mSession->getParameters({{"com.google.unknown*", "dummy"}}, cb);
627 ASSERT_TRUE(hidlResult.isOk());
628 ASSERT_TRUE(wasCalled);
629 ASSERT_EQ(0u, halResults.size());
630 }
631
632 /**
633 * Test session closing.
634 *
635 * Verifies that:
636 * - the method does not crash after being invoked multiple times.
637 */
TEST_P(BroadcastRadioHalTest,Close)638 TEST_P(BroadcastRadioHalTest, Close) {
639 ASSERT_TRUE(openSession());
640
641 for (int i = 0; i < 10; i++) {
642 auto cancelResult = mSession->close();
643 ASSERT_TRUE(cancelResult.isOk());
644 }
645 }
646
647 /**
648 * Test geting image of invalid ID.
649 *
650 * Verifies that:
651 * - getImage call handles argument 0 gracefully.
652 */
TEST_P(BroadcastRadioHalTest,GetNoImage)653 TEST_P(BroadcastRadioHalTest, GetNoImage) {
654 size_t len = 0;
655 auto result = mModule->getImage(0, [&](hidl_vec<uint8_t> rawImage) { len = rawImage.size(); });
656
657 ASSERT_TRUE(result.isOk());
658 ASSERT_EQ(0u, len);
659 }
660
661 /**
662 * Test getting config flags.
663 *
664 * Verifies that:
665 * - isConfigFlagSet either succeeds or ends with NOT_SUPPORTED or INVALID_STATE;
666 * - call success or failure is consistent with setConfigFlag.
667 */
TEST_P(BroadcastRadioHalTest,FetchConfigFlags)668 TEST_P(BroadcastRadioHalTest, FetchConfigFlags) {
669 ASSERT_TRUE(openSession());
670
671 for (auto flag : gConfigFlagValues) {
672 auto halResult = Result::UNKNOWN_ERROR;
673 auto cb = [&](Result result, bool) { halResult = result; };
674 auto hidlResult = mSession->isConfigFlagSet(flag, cb);
675 EXPECT_TRUE(hidlResult.isOk());
676
677 if (halResult != Result::NOT_SUPPORTED && halResult != Result::INVALID_STATE) {
678 ASSERT_EQ(Result::OK, halResult);
679 }
680
681 // set must fail or succeed the same way as get
682 auto setResult = mSession->setConfigFlag(flag, false);
683 EXPECT_EQ(halResult, setResult);
684 setResult = mSession->setConfigFlag(flag, true);
685 EXPECT_EQ(halResult, setResult);
686 }
687 }
688
689 /**
690 * Test setting config flags.
691 *
692 * Verifies that:
693 * - setConfigFlag either succeeds or ends with NOT_SUPPORTED or INVALID_STATE;
694 * - isConfigFlagSet reflects the state requested immediately after the set call.
695 */
TEST_P(BroadcastRadioHalTest,SetConfigFlags)696 TEST_P(BroadcastRadioHalTest, SetConfigFlags) {
697 ASSERT_TRUE(openSession());
698
699 auto get = [&](ConfigFlag flag) {
700 auto halResult = Result::UNKNOWN_ERROR;
701 bool gotValue = false;
702 auto cb = [&](Result result, bool value) {
703 halResult = result;
704 gotValue = value;
705 };
706 auto hidlResult = mSession->isConfigFlagSet(flag, cb);
707 EXPECT_TRUE(hidlResult.isOk());
708 EXPECT_EQ(Result::OK, halResult);
709 return gotValue;
710 };
711
712 for (auto flag : gConfigFlagValues) {
713 auto result = mSession->setConfigFlag(flag, false);
714 if (result == Result::NOT_SUPPORTED || result == Result::INVALID_STATE) {
715 // setting to true must result in the same error as false
716 auto secondResult = mSession->setConfigFlag(flag, true);
717 EXPECT_EQ(result, secondResult);
718 continue;
719 }
720 ASSERT_EQ(Result::OK, result);
721
722 // verify false is set
723 auto value = get(flag);
724 EXPECT_FALSE(value);
725
726 // try setting true this time
727 result = mSession->setConfigFlag(flag, true);
728 ASSERT_EQ(Result::OK, result);
729 value = get(flag);
730 EXPECT_TRUE(value);
731
732 // false again
733 result = mSession->setConfigFlag(flag, false);
734 ASSERT_EQ(Result::OK, result);
735 value = get(flag);
736 EXPECT_FALSE(value);
737 }
738 }
739
740 /**
741 * Test getting program list.
742 *
743 * Verifies that:
744 * - startProgramListUpdates either succeeds or returns NOT_SUPPORTED;
745 * - the complete list is fetched within timeout::programListScan;
746 * - stopProgramListUpdates does not crash.
747 */
TEST_P(BroadcastRadioHalTest,GetProgramList)748 TEST_P(BroadcastRadioHalTest, GetProgramList) {
749 ASSERT_TRUE(openSession());
750
751 getProgramList();
752 }
753
754 /**
755 * Test HD_STATION_NAME correctness.
756 *
757 * Verifies that if a program on the list contains HD_STATION_NAME identifier:
758 * - the program provides station name in its metadata;
759 * - the identifier matches the name;
760 * - there is only one identifier of that type.
761 */
TEST_P(BroadcastRadioHalTest,HdRadioStationNameId)762 TEST_P(BroadcastRadioHalTest, HdRadioStationNameId) {
763 ASSERT_TRUE(openSession());
764
765 auto list = getProgramList();
766 if (!list) return;
767
768 for (auto&& program : *list) {
769 auto nameIds = utils::getAllIds(program.selector, IdentifierType::HD_STATION_NAME);
770 EXPECT_LE(nameIds.size(), 1u);
771 if (nameIds.size() == 0) continue;
772
773 auto name = utils::getMetadataString(program, MetadataKey::PROGRAM_NAME);
774 if (!name) name = utils::getMetadataString(program, MetadataKey::RDS_PS);
775 ASSERT_TRUE(name.has_value());
776
777 auto expectedId = utils::make_hdradio_station_name(*name);
778 EXPECT_EQ(expectedId.value, nameIds[0]);
779 }
780 }
781
782 /**
783 * Test announcement listener registration.
784 *
785 * Verifies that:
786 * - registerAnnouncementListener either succeeds or returns NOT_SUPPORTED;
787 * - if it succeeds, it returns a valid close handle (which is a nullptr otherwise);
788 * - closing handle does not crash.
789 */
TEST_P(BroadcastRadioHalTest,AnnouncementListenerRegistration)790 TEST_P(BroadcastRadioHalTest, AnnouncementListenerRegistration) {
791 sp<AnnouncementListenerMock> listener = new AnnouncementListenerMock();
792
793 Result halResult = Result::UNKNOWN_ERROR;
794 sp<ICloseHandle> closeHandle = nullptr;
795 auto cb = [&](Result result, const sp<ICloseHandle>& closeHandle_) {
796 halResult = result;
797 closeHandle = closeHandle_;
798 };
799
800 auto hidlResult =
801 mModule->registerAnnouncementListener({AnnouncementType::EMERGENCY}, listener, cb);
802 ASSERT_TRUE(hidlResult.isOk());
803
804 if (halResult == Result::NOT_SUPPORTED) {
805 ASSERT_EQ(nullptr, closeHandle.get());
806 printSkipped("Announcements not supported");
807 return;
808 }
809
810 ASSERT_EQ(Result::OK, halResult);
811 ASSERT_NE(nullptr, closeHandle.get());
812
813 closeHandle->close();
814 }
815
816 GTEST_ALLOW_UNINSTANTIATED_PARAMETERIZED_TEST(BroadcastRadioHalTest);
817 INSTANTIATE_TEST_SUITE_P(
818 PerInstance, BroadcastRadioHalTest,
819 testing::ValuesIn(android::hardware::getAllHalInstanceNames(IBroadcastRadio::descriptor)),
820 android::hardware::PrintInstanceNameToString);
821
822 } // namespace vts
823 } // namespace V2_0
824 } // namespace broadcastradio
825 } // namespace hardware
826 } // namespace android
827
main(int argc,char ** argv)828 int main(int argc, char** argv) {
829 android::base::SetDefaultTag("BcRadio.vts");
830 android::base::SetMinimumLogSeverity(android::base::VERBOSE);
831 ::testing::InitGoogleTest(&argc, argv);
832 return RUN_ALL_TESTS();
833 }
834