/* * Copyright (C) 2016 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #define LOG_TAG "BroadcastRadioHidlHalTest" #include #include #include #include #include #include #include #include #include #include #include using ::android::sp; using ::android::Mutex; using ::android::Condition; using ::android::hardware::Return; using ::android::hardware::Void; using ::android::hardware::broadcastradio::V1_0::IBroadcastRadioFactory; using ::android::hardware::broadcastradio::V1_0::IBroadcastRadio; using ::android::hardware::broadcastradio::V1_0::ITuner; using ::android::hardware::broadcastradio::V1_0::ITunerCallback; using ::android::hardware::broadcastradio::V1_0::Result; using ::android::hardware::broadcastradio::V1_0::Class; using ::android::hardware::broadcastradio::V1_0::Properties; using ::android::hardware::broadcastradio::V1_0::Band; using ::android::hardware::broadcastradio::V1_0::BandConfig; using ::android::hardware::broadcastradio::V1_0::Direction; using ::android::hardware::broadcastradio::V1_0::ProgramInfo; using ::android::hardware::broadcastradio::V1_0::MetaData; // The main test class for Broadcast Radio HIDL HAL. class BroadcastRadioHidlTest : public ::testing::VtsHalHidlTargetTestBase { protected: virtual void SetUp() override { sp factory = ::testing::VtsHalHidlTargetTestBase::getService(); if (factory != 0) { factory->connectModule(Class::AM_FM, [&](Result retval, const ::android::sp& result) { if (retval == Result::OK) { mRadio = result; } }); } mTunerCallback = new MyCallback(this); ASSERT_NE(nullptr, mRadio.get()); ASSERT_NE(nullptr, mTunerCallback.get()); } virtual void TearDown() override { mTuner.clear(); mRadio.clear(); } class MyCallback : public ITunerCallback { public: // ITunerCallback methods (see doc in ITunerCallback.hal) virtual Return hardwareFailure() { ALOGI("%s", __FUNCTION__); mParentTest->onHwFailureCallback(); return Void(); } virtual Return configChange(Result result, const BandConfig& config) { ALOGI("%s result %d", __FUNCTION__, result); mParentTest->onConfigChangeCallback(result, config); return Void(); } virtual Return tuneComplete(Result result, const ProgramInfo& info) { ALOGI("%s result %d", __FUNCTION__, result); mParentTest->onTuneCompleteCallback(result, info); return Void(); } virtual Return afSwitch(const ProgramInfo& info __unused) { return Void(); } virtual Return antennaStateChange(bool connected) { ALOGI("%s connected %d", __FUNCTION__, connected); return Void(); } virtual Return trafficAnnouncement(bool active) { ALOGI("%s active %d", __FUNCTION__, active); return Void(); } virtual Return emergencyAnnouncement(bool active) { ALOGI("%s active %d", __FUNCTION__, active); return Void(); } virtual Return newMetadata(uint32_t channel __unused, uint32_t subChannel __unused, const ::android::hardware::hidl_vec& metadata __unused) { ALOGI("%s", __FUNCTION__); return Void(); } MyCallback(BroadcastRadioHidlTest *parentTest) : mParentTest(parentTest) {} private: // BroadcastRadioHidlTest instance to which callbacks will be notified. BroadcastRadioHidlTest *mParentTest; }; /** * Method called by MyCallback when a callback with no status or boolean value is received */ void onCallback() { Mutex::Autolock _l(mLock); onCallback_l(); } /** * Method called by MyCallback when hardwareFailure() callback is received */ void onHwFailureCallback() { Mutex::Autolock _l(mLock); mHwFailure = true; onCallback_l(); } /** * Method called by MyCallback when configChange() callback is received. */ void onConfigChangeCallback(Result result, const BandConfig& config) { Mutex::Autolock _l(mLock); mResultCallbackData = result; mBandConfigCallbackData = config; onCallback_l(); } /** * Method called by MyCallback when tuneComplete() callback is received. */ void onTuneCompleteCallback(Result result, const ProgramInfo& info) { Mutex::Autolock _l(mLock); mResultCallbackData = result; mProgramInfoCallbackData = info; onCallback_l(); } /** * Method called by MyCallback when a boolean indication is received */ void onBoolCallback(bool result) { Mutex::Autolock _l(mLock); mBoolCallbackData = result; onCallback_l(); } BroadcastRadioHidlTest() : mCallbackCalled(false), mBoolCallbackData(false), mResultCallbackData(Result::OK), mHwFailure(false) {} void onCallback_l() { if (!mCallbackCalled) { mCallbackCalled = true; mCallbackCond.broadcast(); } } bool waitForCallback(nsecs_t reltime = 0) { Mutex::Autolock _l(mLock); nsecs_t endTime = systemTime() + reltime; while (!mCallbackCalled) { if (reltime == 0) { mCallbackCond.wait(mLock); } else { nsecs_t now = systemTime(); if (now > endTime) { return false; } mCallbackCond.waitRelative(mLock, endTime - now); } } return true; } bool getProperties(); bool openTuner(); bool checkAntenna(); static const nsecs_t kConfigCallbacktimeoutNs = seconds_to_nanoseconds(10); static const nsecs_t kTuneCallbacktimeoutNs = seconds_to_nanoseconds(30); sp mRadio; Properties mHalProperties; sp mTuner; sp mTunerCallback; Mutex mLock; Condition mCallbackCond; bool mCallbackCalled; bool mBoolCallbackData; Result mResultCallbackData; ProgramInfo mProgramInfoCallbackData; BandConfig mBandConfigCallbackData; bool mHwFailure; }; // A class for test environment setup (kept since this file is a template). class BroadcastRadioHidlEnvironment : public ::testing::Environment { public: virtual void SetUp() {} virtual void TearDown() {} }; namespace android { namespace hardware { namespace broadcastradio { namespace V1_0 { /** * Compares two BandConfig objects for testing purposes. */ static bool operator==(const BandConfig& l, const BandConfig& r) { if (l.type != r.type) return false; if (l.antennaConnected != r.antennaConnected) return false; if (l.lowerLimit != r.lowerLimit) return false; if (l.upperLimit != r.upperLimit) return false; if (l.spacings != r.spacings) return false; if (l.type == Band::AM || l.type == Band::AM_HD) { return l.ext.am == r.ext.am; } else if (l.type == Band::FM || l.type == Band::FM_HD) { return l.ext.fm == r.ext.fm; } else { // unsupported type return false; } } } // V1_0 } // broadcastradio } // hardware } // android bool BroadcastRadioHidlTest::getProperties() { if (mHalProperties.bands.size() == 0) { Result halResult = Result::NOT_INITIALIZED; Return hidlReturn = mRadio->getProperties([&](Result result, const Properties& properties) { halResult = result; if (result == Result::OK) { mHalProperties = properties; } }); EXPECT_TRUE(hidlReturn.isOk()); EXPECT_EQ(Result::OK, halResult); EXPECT_EQ(Class::AM_FM, mHalProperties.classId); EXPECT_GT(mHalProperties.numTuners, 0u); EXPECT_GT(mHalProperties.bands.size(), 0u); } return mHalProperties.bands.size() > 0; } bool BroadcastRadioHidlTest::openTuner() { if (!getProperties()) { return false; } if (mTuner.get() == nullptr) { Result halResult = Result::NOT_INITIALIZED; Return hidlReturn = mRadio->openTuner(mHalProperties.bands[0], true, mTunerCallback, [&](Result result, const sp& tuner) { halResult = result; if (result == Result::OK) { mTuner = tuner; } }); EXPECT_TRUE(hidlReturn.isOk()); EXPECT_EQ(Result::OK, halResult); EXPECT_EQ(true, waitForCallback(kConfigCallbacktimeoutNs)); } EXPECT_NE(nullptr, mTuner.get()); return nullptr != mTuner.get(); } bool BroadcastRadioHidlTest::checkAntenna() { BandConfig halConfig; Result halResult = Result::NOT_INITIALIZED; Return hidlReturn = mTuner->getConfiguration([&](Result result, const BandConfig& config) { halResult = result; if (result == Result::OK) { halConfig = config; } }); return ((halResult == Result::OK) && (halConfig.antennaConnected == true)); } /** * Test IBroadcastRadio::getProperties() method * * Verifies that: * - the HAL implements the method * - the method returns 0 (no error) * - the implementation class is AM_FM * - the implementation supports at least one tuner * - the implementation supports at one band */ TEST_F(BroadcastRadioHidlTest, GetProperties) { EXPECT_EQ(true, getProperties()); } /** * Test IBroadcastRadio::openTuner() method * * Verifies that: * - the HAL implements the method * - the method returns 0 (no error) and a valid ITuner interface */ TEST_F(BroadcastRadioHidlTest, OpenTuner) { EXPECT_EQ(true, openTuner()); } /** * Test IBroadcastRadio::openTuner() after ITuner disposal. * * Verifies that: * - ITuner destruction gets propagated through HAL * - the openTuner method works well when called for the second time */ TEST_F(BroadcastRadioHidlTest, ReopenTuner) { EXPECT_TRUE(openTuner()); mTuner.clear(); EXPECT_TRUE(openTuner()); } /** * Test IBroadcastRadio::openTuner() method called twice. * * Verifies that: * - the openTuner method fails when called for the second time without deleting previous * ITuner instance */ TEST_F(BroadcastRadioHidlTest, OpenTunerTwice) { EXPECT_TRUE(openTuner()); Result halResult = Result::NOT_INITIALIZED; Return hidlReturn = mRadio->openTuner(mHalProperties.bands[0], true, mTunerCallback, [&](Result result, const sp&) { halResult = result; }); EXPECT_TRUE(hidlReturn.isOk()); EXPECT_EQ(Result::INVALID_STATE, halResult); EXPECT_TRUE(waitForCallback(kConfigCallbacktimeoutNs)); } /** * Test ITuner::setConfiguration() and getConfiguration methods * * Verifies that: * - the HAL implements both methods * - the methods return 0 (no error) * - the configuration callback is received within kConfigCallbacktimeoutNs ns * - the configuration read back from HAl has the same class Id */ TEST_F(BroadcastRadioHidlTest, SetAndGetConfiguration) { ASSERT_EQ(true, openTuner()); // test setConfiguration mCallbackCalled = false; Return hidlResult = mTuner->setConfiguration(mHalProperties.bands[1]); EXPECT_TRUE(hidlResult.isOk()); EXPECT_EQ(Result::OK, hidlResult); EXPECT_EQ(true, waitForCallback(kConfigCallbacktimeoutNs)); EXPECT_EQ(Result::OK, mResultCallbackData); EXPECT_EQ(mHalProperties.bands[1], mBandConfigCallbackData); // test getConfiguration BandConfig halConfig; Result halResult; Return hidlReturn = mTuner->getConfiguration([&](Result result, const BandConfig& config) { halResult = result; if (result == Result::OK) { halConfig = config; } }); EXPECT_TRUE(hidlReturn.isOk()); EXPECT_EQ(Result::OK, halResult); EXPECT_EQ(mHalProperties.bands[1], halConfig); } /** * Test ITuner::setConfiguration() with invalid arguments. * * Verifies that: * - the methods returns INVALID_ARGUMENTS on invalid arguments * - the method recovers and succeeds after passing correct arguments */ TEST_F(BroadcastRadioHidlTest, SetConfigurationFails) { ASSERT_EQ(true, openTuner()); // Let's define a config that's bad for sure. BandConfig badConfig = {}; badConfig.type = Band::FM; badConfig.lowerLimit = 0xFFFFFFFF; badConfig.upperLimit = 0; badConfig.spacings = (std::vector){ 0 }; // Test setConfiguration failing on bad data. mCallbackCalled = false; auto setResult = mTuner->setConfiguration(badConfig); EXPECT_TRUE(setResult.isOk()); EXPECT_EQ(Result::INVALID_ARGUMENTS, setResult); // Test setConfiguration recovering after passing good data. mCallbackCalled = false; setResult = mTuner->setConfiguration(mHalProperties.bands[0]); EXPECT_TRUE(setResult.isOk()); EXPECT_EQ(Result::OK, setResult); EXPECT_EQ(true, waitForCallback(kConfigCallbacktimeoutNs)); EXPECT_EQ(Result::OK, mResultCallbackData); } /** * Test ITuner::scan * * Verifies that: * - the HAL implements the method * - the method returns 0 (no error) * - the tuned callback is received within kTuneCallbacktimeoutNs ns */ TEST_F(BroadcastRadioHidlTest, Scan) { ASSERT_EQ(true, openTuner()); ASSERT_TRUE(checkAntenna()); // test scan UP mCallbackCalled = false; Return hidlResult = mTuner->scan(Direction::UP, true); EXPECT_TRUE(hidlResult.isOk()); EXPECT_EQ(Result::OK, hidlResult); EXPECT_EQ(true, waitForCallback(kTuneCallbacktimeoutNs)); // test scan DOWN mCallbackCalled = false; hidlResult = mTuner->scan(Direction::DOWN, true); EXPECT_TRUE(hidlResult.isOk()); EXPECT_EQ(Result::OK, hidlResult); EXPECT_EQ(true, waitForCallback(kTuneCallbacktimeoutNs)); } /** * Test ITuner::step * * Verifies that: * - the HAL implements the method * - the method returns 0 (no error) * - the tuned callback is received within kTuneCallbacktimeoutNs ns */ TEST_F(BroadcastRadioHidlTest, Step) { ASSERT_EQ(true, openTuner()); ASSERT_TRUE(checkAntenna()); // test step UP mCallbackCalled = false; Return hidlResult = mTuner->step(Direction::UP, true); EXPECT_TRUE(hidlResult.isOk()); EXPECT_EQ(Result::OK, hidlResult); EXPECT_EQ(true, waitForCallback(kTuneCallbacktimeoutNs)); // test step DOWN mCallbackCalled = false; hidlResult = mTuner->step(Direction::DOWN, true); EXPECT_TRUE(hidlResult.isOk()); EXPECT_EQ(Result::OK, hidlResult); EXPECT_EQ(true, waitForCallback(kTuneCallbacktimeoutNs)); } /** * Test ITuner::tune, getProgramInformation and cancel methods * * Verifies that: * - the HAL implements the methods * - the methods return 0 (no error) * - the tuned callback is received within kTuneCallbacktimeoutNs ns after tune() */ TEST_F(BroadcastRadioHidlTest, TuneAndGetProgramInformationAndCancel) { ASSERT_EQ(true, openTuner()); ASSERT_TRUE(checkAntenna()); // test tune ASSERT_GT(mHalProperties.bands[0].spacings.size(), 0u); ASSERT_GT(mHalProperties.bands[0].upperLimit, mHalProperties.bands[0].lowerLimit); // test scan UP uint32_t lowerLimit = mHalProperties.bands[0].lowerLimit; uint32_t upperLimit = mHalProperties.bands[0].upperLimit; uint32_t spacing = mHalProperties.bands[0].spacings[0]; uint32_t channel = lowerLimit + (((upperLimit - lowerLimit) / 2 + spacing - 1) / spacing) * spacing; mCallbackCalled = false; mResultCallbackData = Result::NOT_INITIALIZED; Return hidlResult = mTuner->tune(channel, 0); EXPECT_TRUE(hidlResult.isOk()); EXPECT_EQ(Result::OK, hidlResult); EXPECT_EQ(true, waitForCallback(kTuneCallbacktimeoutNs)); EXPECT_EQ(channel, mProgramInfoCallbackData.channel); // test getProgramInformation ProgramInfo halInfo; Result halResult = Result::NOT_INITIALIZED; Return hidlReturn = mTuner->getProgramInformation( [&](Result result, const ProgramInfo& info) { halResult = result; if (result == Result::OK) { halInfo = info; } }); EXPECT_TRUE(hidlReturn.isOk()); EXPECT_EQ(Result::OK, halResult); if (mResultCallbackData == Result::OK) { EXPECT_EQ(true, halInfo.tuned); EXPECT_LE(halInfo.channel, upperLimit); EXPECT_GE(halInfo.channel, lowerLimit); } else { EXPECT_EQ(false, halInfo.tuned); } // test cancel mTuner->tune(lowerLimit, 0); hidlResult = mTuner->cancel(); EXPECT_TRUE(hidlResult.isOk()); EXPECT_EQ(Result::OK, hidlResult); } /** * Test ITuner::tune failing when channel out of the range is provided. * * Verifies that: * - the method returns INVALID_ARGUMENTS when applicable * - the method recovers and succeeds after passing correct arguments */ TEST_F(BroadcastRadioHidlTest, TuneFailsOutOfBounds) { ASSERT_TRUE(openTuner()); ASSERT_TRUE(checkAntenna()); // get current channel bounds BandConfig halConfig; Result halResult; auto configResult = mTuner->getConfiguration([&](Result result, const BandConfig& config) { halResult = result; halConfig = config; }); ASSERT_TRUE(configResult.isOk()); ASSERT_EQ(Result::OK, halResult); // try to tune slightly above the limit and expect to fail auto badChannel = halConfig.upperLimit + halConfig.spacings[0]; auto tuneResult = mTuner->tune(badChannel, 0); EXPECT_TRUE(tuneResult.isOk()); EXPECT_EQ(Result::INVALID_ARGUMENTS, tuneResult); EXPECT_TRUE(waitForCallback(kTuneCallbacktimeoutNs)); // tuning exactly at the limit should succeed auto goodChannel = halConfig.upperLimit; tuneResult = mTuner->tune(goodChannel, 0); EXPECT_TRUE(tuneResult.isOk()); EXPECT_EQ(Result::OK, tuneResult); EXPECT_TRUE(waitForCallback(kTuneCallbacktimeoutNs)); } int main(int argc, char** argv) { ::testing::AddGlobalTestEnvironment(new BroadcastRadioHidlEnvironment); ::testing::InitGoogleTest(&argc, argv); int status = RUN_ALL_TESTS(); ALOGI("Test result = %d", status); return status; }