blob: 27479ffd4647dc908740a4a3d9dbe3b08445d23c [file] [log] [blame]
Kevin Rocardf0357882017-02-10 16:19:28 -08001/*
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 LOG_TAG "VtsHalAudioV2_0TargetTest"
18
19#include <algorithm>
20#include <cmath>
21#include <cstddef>
22#include <cstdio>
23#include <limits>
24#include <list>
25#include <string>
26#include <type_traits>
27#include <vector>
28
Yuexi Ma161b5642017-03-10 13:44:22 -080029#include <VtsHalHidlTargetTestBase.h>
Kevin Rocardf0357882017-02-10 16:19:28 -080030
31#include <android-base/logging.h>
32
33#include <android/hardware/audio/2.0/IDevice.h>
34#include <android/hardware/audio/2.0/IDevicesFactory.h>
Kevin Rocard3c405a72017-03-08 16:46:51 -080035#include <android/hardware/audio/2.0/IPrimaryDevice.h>
Kevin Rocardf0357882017-02-10 16:19:28 -080036#include <android/hardware/audio/2.0/types.h>
37#include <android/hardware/audio/common/2.0/types.h>
38
Kevin Rocardf0357882017-02-10 16:19:28 -080039#include "utility/AssertOk.h"
40#include "utility/PrettyPrintAudioTypes.h"
Kevin Rocard72e50e22017-05-05 14:02:55 -070041#include "utility/ReturnIn.h"
Kevin Rocardf0357882017-02-10 16:19:28 -080042
43using std::string;
44using std::to_string;
45using std::vector;
46
47using ::android::sp;
48using ::android::hardware::Return;
49using ::android::hardware::hidl_handle;
50using ::android::hardware::hidl_string;
51using ::android::hardware::hidl_vec;
Kevin Rocardc9963522017-03-10 18:47:37 -080052using ::android::hardware::MQDescriptorSync;
Kevin Rocard624800c2017-03-10 18:47:37 -080053using ::android::hardware::audio::V2_0::AudioDrain;
Kevin Rocardf0357882017-02-10 16:19:28 -080054using ::android::hardware::audio::V2_0::DeviceAddress;
55using ::android::hardware::audio::V2_0::IDevice;
Kevin Rocard3c405a72017-03-08 16:46:51 -080056using ::android::hardware::audio::V2_0::IPrimaryDevice;
57using TtyMode = ::android::hardware::audio::V2_0::IPrimaryDevice::TtyMode;
Kevin Rocardf0357882017-02-10 16:19:28 -080058using ::android::hardware::audio::V2_0::IDevicesFactory;
59using ::android::hardware::audio::V2_0::IStream;
60using ::android::hardware::audio::V2_0::IStreamIn;
Kevin Rocard624800c2017-03-10 18:47:37 -080061using ::android::hardware::audio::V2_0::TimeSpec;
Kevin Rocard72e50e22017-05-05 14:02:55 -070062using ReadParameters =
63 ::android::hardware::audio::V2_0::IStreamIn::ReadParameters;
Kevin Rocardc9963522017-03-10 18:47:37 -080064using ReadStatus = ::android::hardware::audio::V2_0::IStreamIn::ReadStatus;
Kevin Rocardf0357882017-02-10 16:19:28 -080065using ::android::hardware::audio::V2_0::IStreamOut;
Kevin Rocard624800c2017-03-10 18:47:37 -080066using ::android::hardware::audio::V2_0::IStreamOutCallback;
Kevin Rocard8878b4b2017-03-10 18:47:37 -080067using ::android::hardware::audio::V2_0::MmapBufferInfo;
68using ::android::hardware::audio::V2_0::MmapPosition;
Kevin Rocardf0357882017-02-10 16:19:28 -080069using ::android::hardware::audio::V2_0::ParameterValue;
70using ::android::hardware::audio::V2_0::Result;
71using ::android::hardware::audio::common::V2_0::AudioChannelMask;
72using ::android::hardware::audio::common::V2_0::AudioConfig;
73using ::android::hardware::audio::common::V2_0::AudioDevice;
74using ::android::hardware::audio::common::V2_0::AudioFormat;
75using ::android::hardware::audio::common::V2_0::AudioHandleConsts;
76using ::android::hardware::audio::common::V2_0::AudioInputFlag;
77using ::android::hardware::audio::common::V2_0::AudioIoHandle;
Kevin Rocard3c405a72017-03-08 16:46:51 -080078using ::android::hardware::audio::common::V2_0::AudioMode;
Kevin Rocardf0357882017-02-10 16:19:28 -080079using ::android::hardware::audio::common::V2_0::AudioOffloadInfo;
80using ::android::hardware::audio::common::V2_0::AudioOutputFlag;
81using ::android::hardware::audio::common::V2_0::AudioSource;
Kevin Rocardc9963522017-03-10 18:47:37 -080082using ::android::hardware::audio::common::V2_0::ThreadInfo;
Kevin Rocardf0357882017-02-10 16:19:28 -080083
84using utility::returnIn;
85
Kevin Rocard96f46c42017-05-08 11:53:07 -070086const char* getTestName() {
87 return ::testing::UnitTest::GetInstance()->current_test_info()->name();
88}
89
Kevin Rocardf0357882017-02-10 16:19:28 -080090namespace doc {
91/** Document the current test case.
Kevin Rocard72e50e22017-05-05 14:02:55 -070092 * Eg: calling `doc::test("Dump the state of the hal")` in the "debugDump" test
93 * will output:
94 * <testcase name="debugDump" status="run" time="6"
95 * classname="AudioPrimaryHidlTest"
96 description="Dump the state of the hal." />
97 * see
98 https://github.com/google/googletest/blob/master/googletest/docs/AdvancedGuide.md#logging-additional-information
Kevin Rocardf0357882017-02-10 16:19:28 -080099 */
100void test(const std::string& testCaseDocumentation) {
101 ::testing::Test::RecordProperty("description", testCaseDocumentation);
102}
103
Kevin Rocard72e50e22017-05-05 14:02:55 -0700104/** Document why a test was not fully run. Usually due to an optional feature
105 * not implemented. */
Kevin Rocardf0357882017-02-10 16:19:28 -0800106void partialTest(const std::string& reason) {
Kevin Rocard96f46c42017-05-08 11:53:07 -0700107 LOG(INFO) << "Test " << getTestName() << " partially run: " << reason;
Kevin Rocardf0357882017-02-10 16:19:28 -0800108 ::testing::Test::RecordProperty("partialyRunTest", reason);
109}
Kevin Rocard5e5783d2017-05-02 18:41:46 -0700110
111/** Add a note to the test. */
112void note(const std::string& note) {
Kevin Rocard96f46c42017-05-08 11:53:07 -0700113 LOG(INFO) << "Test " << getTestName() << " noted: " << note;
Kevin Rocard5e5783d2017-05-02 18:41:46 -0700114 ::testing::Test::RecordProperty("note", note);
115}
Kevin Rocardf0357882017-02-10 16:19:28 -0800116}
117
118// Register callback for static object destruction
119// Avoid destroying static objects after main return.
Kevin Rocard72e50e22017-05-05 14:02:55 -0700120// Post main return destruction leads to incorrect gtest timing measurements as
121// well as harder
Kevin Rocardf0357882017-02-10 16:19:28 -0800122// debuging if anything goes wrong during destruction.
123class Environment : public ::testing::Environment {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700124 public:
125 using TearDownFunc = std::function<void()>;
126 void registerTearDown(TearDownFunc&& tearDown) {
127 tearDowns.push_back(std::move(tearDown));
Kevin Rocardf0357882017-02-10 16:19:28 -0800128 }
129
Kevin Rocard72e50e22017-05-05 14:02:55 -0700130 private:
Kevin Rocardf0357882017-02-10 16:19:28 -0800131 void TearDown() override {
132 // Call the tear downs in reverse order of insertion
133 for (auto& tearDown : tearDowns) {
134 tearDown();
135 }
136 }
137 std::list<TearDownFunc> tearDowns;
138};
139// Instance to register global tearDown
140static Environment* environment;
141
Yuexi Ma161b5642017-03-10 13:44:22 -0800142class HidlTest : public ::testing::VtsHalHidlTargetTestBase {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700143 protected:
Kevin Rocardf0357882017-02-10 16:19:28 -0800144 // Convenient member to store results
145 Result res;
146};
147
148//////////////////////////////////////////////////////////////////////////////
149////////////////////// getService audio_devices_factory //////////////////////
150//////////////////////////////////////////////////////////////////////////////
151
152// Test all audio devices
153class AudioHidlTest : public HidlTest {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700154 public:
Kevin Rocardf0357882017-02-10 16:19:28 -0800155 void SetUp() override {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700156 ASSERT_NO_FATAL_FAILURE(HidlTest::SetUp()); // setup base
Kevin Rocardf0357882017-02-10 16:19:28 -0800157
158 if (devicesFactory == nullptr) {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700159 environment->registerTearDown([] { devicesFactory.clear(); });
160 devicesFactory = ::testing::VtsHalHidlTargetTestBase::getService<
161 IDevicesFactory>();
Kevin Rocardf0357882017-02-10 16:19:28 -0800162 }
163 ASSERT_TRUE(devicesFactory != nullptr);
164 }
165
Kevin Rocard72e50e22017-05-05 14:02:55 -0700166 protected:
Kevin Rocardf0357882017-02-10 16:19:28 -0800167 // Cache the devicesFactory retrieval to speed up each test by ~0.5s
168 static sp<IDevicesFactory> devicesFactory;
169};
170sp<IDevicesFactory> AudioHidlTest::devicesFactory;
171
172TEST_F(AudioHidlTest, GetAudioDevicesFactoryService) {
173 doc::test("test the getService (called in SetUp)");
174}
175
Mikhail Naganov8604a732017-04-24 09:29:22 -0700176TEST_F(AudioHidlTest, OpenDeviceInvalidParameter) {
177 doc::test("test passing an invalid parameter to openDevice");
178 IDevicesFactory::Result result;
179 sp<IDevice> device;
180 ASSERT_OK(devicesFactory->openDevice(IDevicesFactory::Device(-1),
181 returnIn(result, device)));
182 ASSERT_EQ(IDevicesFactory::Result::INVALID_ARGUMENTS, result);
183 ASSERT_TRUE(device == nullptr);
184}
185
Kevin Rocardf0357882017-02-10 16:19:28 -0800186//////////////////////////////////////////////////////////////////////////////
187/////////////////////////////// openDevice primary ///////////////////////////
188//////////////////////////////////////////////////////////////////////////////
189
190// Test the primary device
191class AudioPrimaryHidlTest : public AudioHidlTest {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700192 public:
Kevin Rocardf0357882017-02-10 16:19:28 -0800193 /** Primary HAL test are NOT thread safe. */
194 void SetUp() override {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700195 ASSERT_NO_FATAL_FAILURE(AudioHidlTest::SetUp()); // setup base
Kevin Rocardf0357882017-02-10 16:19:28 -0800196
197 if (device == nullptr) {
Kevin Rocardf0357882017-02-10 16:19:28 -0800198 IDevicesFactory::Result result;
Kevin Rocard3c405a72017-03-08 16:46:51 -0800199 sp<IDevice> baseDevice;
Kevin Rocard72e50e22017-05-05 14:02:55 -0700200 ASSERT_OK(
201 devicesFactory->openDevice(IDevicesFactory::Device::PRIMARY,
202 returnIn(result, baseDevice)));
Kevin Rocardfba442a2017-03-31 19:34:41 -0700203 ASSERT_OK(result);
Kevin Rocard3c405a72017-03-08 16:46:51 -0800204 ASSERT_TRUE(baseDevice != nullptr);
205
Kevin Rocard72e50e22017-05-05 14:02:55 -0700206 environment->registerTearDown([] { device.clear(); });
Kevin Rocard3c405a72017-03-08 16:46:51 -0800207 device = IPrimaryDevice::castFrom(baseDevice);
208 ASSERT_TRUE(device != nullptr);
Kevin Rocardf0357882017-02-10 16:19:28 -0800209 }
Kevin Rocardf0357882017-02-10 16:19:28 -0800210 }
211
Kevin Rocard72e50e22017-05-05 14:02:55 -0700212 protected:
Kevin Rocardf0357882017-02-10 16:19:28 -0800213 // Cache the device opening to speed up each test by ~0.5s
Kevin Rocard3c405a72017-03-08 16:46:51 -0800214 static sp<IPrimaryDevice> device;
Kevin Rocardf0357882017-02-10 16:19:28 -0800215};
Kevin Rocard3c405a72017-03-08 16:46:51 -0800216sp<IPrimaryDevice> AudioPrimaryHidlTest::device;
Kevin Rocardf0357882017-02-10 16:19:28 -0800217
218TEST_F(AudioPrimaryHidlTest, OpenPrimaryDevice) {
219 doc::test("Test the openDevice (called in SetUp)");
220}
221
222TEST_F(AudioPrimaryHidlTest, Init) {
223 doc::test("Test that the audio primary hal initialized correctly");
224 ASSERT_OK(device->initCheck());
225}
226
227//////////////////////////////////////////////////////////////////////////////
Kevin Rocard92ce35d2017-03-08 17:17:25 -0800228///////////////////// {set,get}{Master,Mic}{Mute,Volume} /////////////////////
Kevin Rocardf0357882017-02-10 16:19:28 -0800229//////////////////////////////////////////////////////////////////////////////
230
Kevin Rocard3c405a72017-03-08 16:46:51 -0800231template <class Property>
232class AccessorPrimaryHidlTest : public AudioPrimaryHidlTest {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700233 protected:
Kevin Rocard3c405a72017-03-08 16:46:51 -0800234 /** Test a property getter and setter. */
Kevin Rocardf0357882017-02-10 16:19:28 -0800235 template <class Getter, class Setter>
Kevin Rocard72e50e22017-05-05 14:02:55 -0700236 void testAccessors(const string& propertyName,
237 const vector<Property>& valuesToTest, Setter setter,
238 Getter getter,
Kevin Rocard92ce35d2017-03-08 17:17:25 -0800239 const vector<Property>& invalidValues = {}) {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700240 Property initialValue; // Save initial value to restore it at the end
241 // of the test
Kevin Rocard3c405a72017-03-08 16:46:51 -0800242 ASSERT_OK((device.get()->*getter)(returnIn(res, initialValue)));
243 ASSERT_OK(res);
244
245 for (Property setValue : valuesToTest) {
Kevin Rocard92ce35d2017-03-08 17:17:25 -0800246 SCOPED_TRACE("Test " + propertyName + " getter and setter for " +
247 testing::PrintToString(setValue));
Kevin Rocard3c405a72017-03-08 16:46:51 -0800248 ASSERT_OK((device.get()->*setter)(setValue));
249 Property getValue;
250 // Make sure the getter returns the same value just set
251 ASSERT_OK((device.get()->*getter)(returnIn(res, getValue)));
Kevin Rocardf0357882017-02-10 16:19:28 -0800252 ASSERT_OK(res);
Kevin Rocard3c405a72017-03-08 16:46:51 -0800253 EXPECT_EQ(setValue, getValue);
Kevin Rocardf0357882017-02-10 16:19:28 -0800254 }
Kevin Rocard3c405a72017-03-08 16:46:51 -0800255
Kevin Rocard92ce35d2017-03-08 17:17:25 -0800256 for (Property invalidValue : invalidValues) {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700257 SCOPED_TRACE("Try to set " + propertyName +
258 " with the invalid value " +
Kevin Rocard92ce35d2017-03-08 17:17:25 -0800259 testing::PrintToString(invalidValue));
Kevin Rocard72e50e22017-05-05 14:02:55 -0700260 EXPECT_RESULT(Result::INVALID_ARGUMENTS,
261 (device.get()->*setter)(invalidValue));
Kevin Rocard92ce35d2017-03-08 17:17:25 -0800262 }
263
Kevin Rocard72e50e22017-05-05 14:02:55 -0700264 ASSERT_OK(
265 (device.get()->*setter)(initialValue)); // restore initial value
Kevin Rocard3c405a72017-03-08 16:46:51 -0800266 }
267
268 /** Test the getter and setter of an optional feature. */
269 template <class Getter, class Setter>
Kevin Rocard72e50e22017-05-05 14:02:55 -0700270 void testOptionalAccessors(const string& propertyName,
271 const vector<Property>& valuesToTest,
Kevin Rocard92ce35d2017-03-08 17:17:25 -0800272 Setter setter, Getter getter,
273 const vector<Property>& invalidValues = {}) {
Kevin Rocard3c405a72017-03-08 16:46:51 -0800274 doc::test("Test the optional " + propertyName + " getters and setter");
275 {
276 SCOPED_TRACE("Test feature support by calling the getter");
277 Property initialValue;
278 ASSERT_OK((device.get()->*getter)(returnIn(res, initialValue)));
279 if (res == Result::NOT_SUPPORTED) {
280 doc::partialTest(propertyName + " getter is not supported");
281 return;
282 }
Kevin Rocard72e50e22017-05-05 14:02:55 -0700283 ASSERT_OK(res); // If it is supported it must succeed
Kevin Rocard3c405a72017-03-08 16:46:51 -0800284 }
285 // The feature is supported, test it
Kevin Rocard72e50e22017-05-05 14:02:55 -0700286 testAccessors(propertyName, valuesToTest, setter, getter,
287 invalidValues);
Kevin Rocardf0357882017-02-10 16:19:28 -0800288 }
289};
290
Kevin Rocard3c405a72017-03-08 16:46:51 -0800291using BoolAccessorPrimaryHidlTest = AccessorPrimaryHidlTest<bool>;
292
Kevin Rocardf0357882017-02-10 16:19:28 -0800293TEST_F(BoolAccessorPrimaryHidlTest, MicMuteTest) {
294 doc::test("Check that the mic can be muted and unmuted");
Kevin Rocard72e50e22017-05-05 14:02:55 -0700295 testAccessors("mic mute", {true, false, true}, &IDevice::setMicMute,
296 &IDevice::getMicMute);
Kevin Rocardf0357882017-02-10 16:19:28 -0800297 // TODO: check that the mic is really muted (all sample are 0)
298}
299
300TEST_F(BoolAccessorPrimaryHidlTest, MasterMuteTest) {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700301 doc::test(
302 "If master mute is supported, try to mute and unmute the master "
303 "output");
Kevin Rocard3c405a72017-03-08 16:46:51 -0800304 testOptionalAccessors("master mute", {true, false, true},
305 &IDevice::setMasterMute, &IDevice::getMasterMute);
Kevin Rocardf0357882017-02-10 16:19:28 -0800306 // TODO: check that the master volume is really muted
307}
308
Kevin Rocard92ce35d2017-03-08 17:17:25 -0800309using FloatAccessorPrimaryHidlTest = AccessorPrimaryHidlTest<float>;
310TEST_F(FloatAccessorPrimaryHidlTest, MasterVolumeTest) {
311 doc::test("Test the master volume if supported");
Kevin Rocard72e50e22017-05-05 14:02:55 -0700312 testOptionalAccessors("master volume", {0, 0.5, 1},
Kevin Rocard92ce35d2017-03-08 17:17:25 -0800313 &IDevice::setMasterVolume, &IDevice::getMasterVolume,
314 {-0.1, 1.1, NAN, INFINITY, -INFINITY,
315 1 + std::numeric_limits<float>::epsilon()});
316 // TODO: check that the master volume is really changed
317}
318
Kevin Rocardf0357882017-02-10 16:19:28 -0800319//////////////////////////////////////////////////////////////////////////////
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800320//////////////////////////////// AudioPatches ////////////////////////////////
321//////////////////////////////////////////////////////////////////////////////
322
323class AudioPatchPrimaryHidlTest : public AudioPrimaryHidlTest {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700324 protected:
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800325 bool areAudioPatchesSupported() {
326 auto result = device->supportsAudioPatches();
Kevin Rocardf26f67a2017-05-02 19:21:58 -0700327 EXPECT_IS_OK(result);
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800328 return result;
329 }
330};
331
332TEST_F(AudioPatchPrimaryHidlTest, AudioPatches) {
333 doc::test("Test if audio patches are supported");
334 if (!areAudioPatchesSupported()) {
335 doc::partialTest("Audio patches are not supported");
336 return;
337 }
338 // TODO: test audio patches
339}
340
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800341//////////////////////////////////////////////////////////////////////////////
Kevin Rocardf0357882017-02-10 16:19:28 -0800342//////////////// Required and recommended audio format support ///////////////
Kevin Rocard72e50e22017-05-05 14:02:55 -0700343// From:
344// https://source.android.com/compatibility/android-cdd.html#5_4_audio_recording
345// From:
346// https://source.android.com/compatibility/android-cdd.html#5_5_audio_playback
Kevin Rocardf0357882017-02-10 16:19:28 -0800347/////////// TODO: move to the beginning of the file for easier update ////////
348//////////////////////////////////////////////////////////////////////////////
349
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800350class AudioConfigPrimaryTest : public AudioPatchPrimaryHidlTest {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700351 public:
Kevin Rocardf0357882017-02-10 16:19:28 -0800352 // Cache result ?
353 static const vector<AudioConfig> getRequiredSupportPlaybackAudioConfig() {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700354 return combineAudioConfig(
355 {AudioChannelMask::OUT_STEREO, AudioChannelMask::OUT_MONO},
356 {8000, 11025, 16000, 22050, 32000, 44100},
357 {AudioFormat::PCM_16_BIT});
Kevin Rocardf0357882017-02-10 16:19:28 -0800358 }
359
Kevin Rocard72e50e22017-05-05 14:02:55 -0700360 static const vector<AudioConfig>
361 getRecommendedSupportPlaybackAudioConfig() {
362 return combineAudioConfig(
363 {AudioChannelMask::OUT_STEREO, AudioChannelMask::OUT_MONO},
364 {24000, 48000}, {AudioFormat::PCM_16_BIT});
Kevin Rocardf0357882017-02-10 16:19:28 -0800365 }
366
367 static const vector<AudioConfig> getSupportedPlaybackAudioConfig() {
368 // TODO: retrieve audio config supported by the platform
369 // as declared in the policy configuration
370 return {};
371 }
372
373 static const vector<AudioConfig> getRequiredSupportCaptureAudioConfig() {
374 return combineAudioConfig({AudioChannelMask::IN_MONO},
375 {8000, 11025, 16000, 44100},
376 {AudioFormat::PCM_16_BIT});
377 }
378 static const vector<AudioConfig> getRecommendedSupportCaptureAudioConfig() {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700379 return combineAudioConfig({AudioChannelMask::IN_STEREO}, {22050, 48000},
Kevin Rocardf0357882017-02-10 16:19:28 -0800380 {AudioFormat::PCM_16_BIT});
381 }
382 static const vector<AudioConfig> getSupportedCaptureAudioConfig() {
383 // TODO: retrieve audio config supported by the platform
384 // as declared in the policy configuration
385 return {};
386 }
Kevin Rocard72e50e22017-05-05 14:02:55 -0700387
388 private:
Kevin Rocardf0357882017-02-10 16:19:28 -0800389 static const vector<AudioConfig> combineAudioConfig(
Kevin Rocard72e50e22017-05-05 14:02:55 -0700390 vector<AudioChannelMask> channelMasks, vector<uint32_t> sampleRates,
391 vector<AudioFormat> formats) {
Kevin Rocardf0357882017-02-10 16:19:28 -0800392 vector<AudioConfig> configs;
Kevin Rocard72e50e22017-05-05 14:02:55 -0700393 for (auto channelMask : channelMasks) {
Kevin Rocardf0357882017-02-10 16:19:28 -0800394 for (auto sampleRate : sampleRates) {
395 for (auto format : formats) {
396 AudioConfig config{};
397 // leave offloadInfo to 0
398 config.channelMask = channelMask;
399 config.sampleRateHz = sampleRate;
400 config.format = format;
401 // FIXME: leave frameCount to 0 ?
402 configs.push_back(config);
403 }
404 }
405 }
406 return configs;
407 }
408};
409
Kevin Rocard9c369142017-03-08 17:17:25 -0800410/** Generate a test name based on an audio config.
411 *
412 * As the only parameter changing are channel mask and sample rate,
413 * only print those ones in the test name.
414 */
Kevin Rocard72e50e22017-05-05 14:02:55 -0700415static string generateTestName(
416 const testing::TestParamInfo<AudioConfig>& info) {
Kevin Rocard9c369142017-03-08 17:17:25 -0800417 const AudioConfig& config = info.param;
Kevin Rocard72e50e22017-05-05 14:02:55 -0700418 return to_string(info.index) + "__" + to_string(config.sampleRateHz) + "_" +
419 // "MONO" is more clear than "FRONT_LEFT"
420 ((config.channelMask == AudioChannelMask::OUT_MONO ||
421 config.channelMask == AudioChannelMask::IN_MONO)
422 ? "MONO"
423 : toString(config.channelMask));
Kevin Rocard9c369142017-03-08 17:17:25 -0800424}
425
Kevin Rocardf0357882017-02-10 16:19:28 -0800426//////////////////////////////////////////////////////////////////////////////
427///////////////////////////// getInputBufferSize /////////////////////////////
428//////////////////////////////////////////////////////////////////////////////
429
Kevin Rocard72e50e22017-05-05 14:02:55 -0700430// FIXME: execute input test only if platform declares
431// android.hardware.microphone
Kevin Rocardf0357882017-02-10 16:19:28 -0800432// how to get this value ? is it a property ???
433
Kevin Rocard72e50e22017-05-05 14:02:55 -0700434class AudioCaptureConfigPrimaryTest
435 : public AudioConfigPrimaryTest,
436 public ::testing::WithParamInterface<AudioConfig> {
437 protected:
438 void inputBufferSizeTest(const AudioConfig& audioConfig,
439 bool supportRequired) {
Kevin Rocardf0357882017-02-10 16:19:28 -0800440 uint64_t bufferSize;
Kevin Rocard72e50e22017-05-05 14:02:55 -0700441 ASSERT_OK(
442 device->getInputBufferSize(audioConfig, returnIn(res, bufferSize)));
Kevin Rocardf0357882017-02-10 16:19:28 -0800443
444 switch (res) {
445 case Result::INVALID_ARGUMENTS:
446 EXPECT_FALSE(supportRequired);
447 break;
448 case Result::OK:
449 // Check that the buffer is of a sane size
450 // For now only that it is > 0
451 EXPECT_GT(bufferSize, uint64_t(0));
452 break;
453 default:
Kevin Rocard72e50e22017-05-05 14:02:55 -0700454 FAIL() << "Invalid return status: "
455 << ::testing::PrintToString(res);
Kevin Rocardf0357882017-02-10 16:19:28 -0800456 }
457 }
458};
459
Kevin Rocard72e50e22017-05-05 14:02:55 -0700460// Test that the required capture config and those declared in the policy are
461// indeed supported
Kevin Rocardf0357882017-02-10 16:19:28 -0800462class RequiredInputBufferSizeTest : public AudioCaptureConfigPrimaryTest {};
463TEST_P(RequiredInputBufferSizeTest, RequiredInputBufferSizeTest) {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700464 doc::test(
465 "Input buffer size must be retrievable for a format with required "
466 "support.");
Kevin Rocardf0357882017-02-10 16:19:28 -0800467 inputBufferSizeTest(GetParam(), true);
468}
469INSTANTIATE_TEST_CASE_P(
Kevin Rocard72e50e22017-05-05 14:02:55 -0700470 RequiredInputBufferSize, RequiredInputBufferSizeTest,
471 ::testing::ValuesIn(
472 AudioConfigPrimaryTest::getRequiredSupportCaptureAudioConfig()),
473 &generateTestName);
Kevin Rocardf0357882017-02-10 16:19:28 -0800474INSTANTIATE_TEST_CASE_P(
Kevin Rocard72e50e22017-05-05 14:02:55 -0700475 SupportedInputBufferSize, RequiredInputBufferSizeTest,
476 ::testing::ValuesIn(
477 AudioConfigPrimaryTest::getSupportedCaptureAudioConfig()),
478 &generateTestName);
Kevin Rocardf0357882017-02-10 16:19:28 -0800479
Kevin Rocard72e50e22017-05-05 14:02:55 -0700480// Test that the recommended capture config are supported or lead to a
481// INVALID_ARGUMENTS return
Kevin Rocardf0357882017-02-10 16:19:28 -0800482class OptionalInputBufferSizeTest : public AudioCaptureConfigPrimaryTest {};
483TEST_P(OptionalInputBufferSizeTest, OptionalInputBufferSizeTest) {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700484 doc::test(
485 "Input buffer size should be retrievable for a format with recommended "
486 "support.");
Kevin Rocardf0357882017-02-10 16:19:28 -0800487 inputBufferSizeTest(GetParam(), false);
488}
489INSTANTIATE_TEST_CASE_P(
Kevin Rocard72e50e22017-05-05 14:02:55 -0700490 RecommendedCaptureAudioConfigSupport, OptionalInputBufferSizeTest,
491 ::testing::ValuesIn(
492 AudioConfigPrimaryTest::getRecommendedSupportCaptureAudioConfig()),
493 &generateTestName);
Kevin Rocardf0357882017-02-10 16:19:28 -0800494
495//////////////////////////////////////////////////////////////////////////////
496/////////////////////////////// setScreenState ///////////////////////////////
497//////////////////////////////////////////////////////////////////////////////
498
499TEST_F(AudioPrimaryHidlTest, setScreenState) {
500 doc::test("Check that the hal can receive the screen state");
501 for (bool turnedOn : {false, true, true, false, false}) {
502 auto ret = device->setScreenState(turnedOn);
Kevin Rocardf26f67a2017-05-02 19:21:58 -0700503 ASSERT_IS_OK(ret);
Kevin Rocardf0357882017-02-10 16:19:28 -0800504 Result result = ret;
Kevin Rocardf26f67a2017-05-02 19:21:58 -0700505 auto okOrNotSupported = {Result::OK, Result::NOT_SUPPORTED};
506 ASSERT_RESULT(okOrNotSupported, result);
Kevin Rocardf0357882017-02-10 16:19:28 -0800507 }
508}
509
510//////////////////////////////////////////////////////////////////////////////
511//////////////////////////// {get,set}Parameters /////////////////////////////
512//////////////////////////////////////////////////////////////////////////////
513
514TEST_F(AudioPrimaryHidlTest, getParameters) {
515 doc::test("Check that the hal can set and get parameters");
516 hidl_vec<hidl_string> keys;
517 hidl_vec<ParameterValue> values;
518 ASSERT_OK(device->getParameters(keys, returnIn(res, values)));
519 ASSERT_OK(device->setParameters(values));
520 values.resize(0);
521 ASSERT_OK(device->setParameters(values));
522}
523
524//////////////////////////////////////////////////////////////////////////////
525//////////////////////////////// debugDebug //////////////////////////////////
526//////////////////////////////////////////////////////////////////////////////
527
Kevin Rocardb9031242017-03-13 12:20:54 -0700528template <class DebugDump>
529static void testDebugDump(DebugDump debugDump) {
Kevin Rocard5e5783d2017-05-02 18:41:46 -0700530 // Dump in a temporary file
531 // Note that SELinux must be deactivate for this test to work
Kevin Rocardf0357882017-02-10 16:19:28 -0800532 FILE* file = tmpfile();
533 ASSERT_NE(nullptr, file) << errno;
534
Kevin Rocard5e5783d2017-05-02 18:41:46 -0700535 // Wrap the temporary file file descriptor in a native handle
Kevin Rocardf0357882017-02-10 16:19:28 -0800536 auto* nativeHandle = native_handle_create(1, 0);
537 ASSERT_NE(nullptr, nativeHandle);
538 nativeHandle->data[0] = fileno(file);
539
Kevin Rocard5e5783d2017-05-02 18:41:46 -0700540 // Wrap this native handle in a hidl handle
Kevin Rocardf0357882017-02-10 16:19:28 -0800541 hidl_handle handle;
542 handle.setTo(nativeHandle, true /*take ownership*/);
543
Kevin Rocard5e5783d2017-05-02 18:41:46 -0700544 ASSERT_OK(debugDump(handle));
545
546 // Check that at least one bit was written by the hal
Kevin Rocardee771e92017-03-08 17:17:25 -0800547 // TODO: debugDump does not return a Result.
Kevin Rocard72e50e22017-05-05 14:02:55 -0700548 // This mean that the hal can not report that it not implementing the
549 // function.
Kevin Rocard72e50e22017-05-05 14:02:55 -0700550 rewind(file); // can not fail
Kevin Rocardf0357882017-02-10 16:19:28 -0800551 char buff;
Kevin Rocard5e5783d2017-05-02 18:41:46 -0700552 if (fread(&buff, sizeof(buff), 1, file) != 1) {
553 doc::note("debugDump does not seem implemented");
554 }
Kevin Rocardf0357882017-02-10 16:19:28 -0800555 EXPECT_EQ(0, fclose(file)) << errno;
556}
557
Kevin Rocard5e5783d2017-05-02 18:41:46 -0700558TEST_F(AudioPrimaryHidlTest, DebugDump) {
Kevin Rocardb9031242017-03-13 12:20:54 -0700559 doc::test("Check that the hal can dump its state without error");
Chih-Hung Hsieh7eb57b62017-05-15 12:31:25 -0700560 testDebugDump([](const auto& handle) { return device->debugDump(handle); });
Kevin Rocardb9031242017-03-13 12:20:54 -0700561}
562
Kevin Rocard5e5783d2017-05-02 18:41:46 -0700563TEST_F(AudioPrimaryHidlTest, DebugDumpInvalidArguments) {
Mikhail Naganov3e6fe752017-04-24 10:44:08 -0700564 doc::test("Check that the hal dump doesn't crash on invalid arguments");
565 ASSERT_OK(device->debugDump(hidl_handle()));
566}
567
Kevin Rocardf0357882017-02-10 16:19:28 -0800568//////////////////////////////////////////////////////////////////////////////
569////////////////////////// open{Output,Input}Stream //////////////////////////
570//////////////////////////////////////////////////////////////////////////////
571
572template <class Stream>
573class OpenStreamTest : public AudioConfigPrimaryTest,
574 public ::testing::WithParamInterface<AudioConfig> {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700575 protected:
Kevin Rocardf0357882017-02-10 16:19:28 -0800576 template <class Open>
577 void testOpen(Open openStream, const AudioConfig& config) {
578 // FIXME: Open a stream without an IOHandle
579 // This is not required to be accepted by hal implementations
Kevin Rocard72e50e22017-05-05 14:02:55 -0700580 AudioIoHandle ioHandle =
581 (AudioIoHandle)AudioHandleConsts::AUDIO_IO_HANDLE_NONE;
Kevin Rocardf0357882017-02-10 16:19:28 -0800582 AudioConfig suggestedConfig{};
Kevin Rocard72e50e22017-05-05 14:02:55 -0700583 ASSERT_OK(openStream(ioHandle, config,
584 returnIn(res, stream, suggestedConfig)));
Kevin Rocardf0357882017-02-10 16:19:28 -0800585
586 // TODO: only allow failure for RecommendedPlaybackAudioConfig
587 switch (res) {
588 case Result::OK:
589 ASSERT_TRUE(stream != nullptr);
590 audioConfig = config;
591 break;
592 case Result::INVALID_ARGUMENTS:
593 ASSERT_TRUE(stream == nullptr);
594 AudioConfig suggestedConfigRetry;
Kevin Rocard72e50e22017-05-05 14:02:55 -0700595 // Could not open stream with config, try again with the
596 // suggested one
597 ASSERT_OK(
598 openStream(ioHandle, suggestedConfig,
599 returnIn(res, stream, suggestedConfigRetry)));
Kevin Rocardf0357882017-02-10 16:19:28 -0800600 // This time it must succeed
601 ASSERT_OK(res);
Kevin Rocard4aefd1c2017-05-02 18:58:58 -0700602 ASSERT_TRUE(stream != nullptr);
Kevin Rocardf0357882017-02-10 16:19:28 -0800603 audioConfig = suggestedConfig;
604 break;
605 default:
Kevin Rocard72e50e22017-05-05 14:02:55 -0700606 FAIL() << "Invalid return status: "
607 << ::testing::PrintToString(res);
Kevin Rocardf0357882017-02-10 16:19:28 -0800608 }
609 open = true;
610 }
611
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800612 Return<Result> closeStream() {
613 open = false;
614 return stream->close();
615 }
Kevin Rocard72e50e22017-05-05 14:02:55 -0700616
617 private:
Kevin Rocardf0357882017-02-10 16:19:28 -0800618 void TearDown() override {
619 if (open) {
620 ASSERT_OK(stream->close());
621 }
622 }
623
Kevin Rocard72e50e22017-05-05 14:02:55 -0700624 protected:
Kevin Rocardf0357882017-02-10 16:19:28 -0800625 AudioConfig audioConfig;
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800626 DeviceAddress address = {};
Kevin Rocardf0357882017-02-10 16:19:28 -0800627 sp<Stream> stream;
628 bool open = false;
629};
630
631////////////////////////////// openOutputStream //////////////////////////////
632
633class OutputStreamTest : public OpenStreamTest<IStreamOut> {
634 virtual void SetUp() override {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700635 ASSERT_NO_FATAL_FAILURE(OpenStreamTest::SetUp()); // setup base
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800636 address.device = AudioDevice::OUT_DEFAULT;
Kevin Rocardf0357882017-02-10 16:19:28 -0800637 const AudioConfig& config = GetParam();
Kevin Rocard72e50e22017-05-05 14:02:55 -0700638 AudioOutputFlag flags =
639 AudioOutputFlag::NONE; // TODO: test all flag combination
640 testOpen(
641 [&](AudioIoHandle handle, AudioConfig config, auto cb) {
642 return device->openOutputStream(handle, address, config, flags,
643 cb);
644 },
645 config);
Kevin Rocardf0357882017-02-10 16:19:28 -0800646 }
647};
648TEST_P(OutputStreamTest, OpenOutputStreamTest) {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700649 doc::test(
650 "Check that output streams can be open with the required and "
651 "recommended config");
Kevin Rocardf0357882017-02-10 16:19:28 -0800652 // Open done in SetUp
653}
654INSTANTIATE_TEST_CASE_P(
Kevin Rocard72e50e22017-05-05 14:02:55 -0700655 RequiredOutputStreamConfigSupport, OutputStreamTest,
656 ::testing::ValuesIn(
657 AudioConfigPrimaryTest::getRequiredSupportPlaybackAudioConfig()),
658 &generateTestName);
Kevin Rocardf0357882017-02-10 16:19:28 -0800659INSTANTIATE_TEST_CASE_P(
Kevin Rocard72e50e22017-05-05 14:02:55 -0700660 SupportedOutputStreamConfig, OutputStreamTest,
661 ::testing::ValuesIn(
662 AudioConfigPrimaryTest::getSupportedPlaybackAudioConfig()),
663 &generateTestName);
Kevin Rocardf0357882017-02-10 16:19:28 -0800664
665INSTANTIATE_TEST_CASE_P(
Kevin Rocard72e50e22017-05-05 14:02:55 -0700666 RecommendedOutputStreamConfigSupport, OutputStreamTest,
667 ::testing::ValuesIn(
668 AudioConfigPrimaryTest::getRecommendedSupportPlaybackAudioConfig()),
669 &generateTestName);
Kevin Rocardf0357882017-02-10 16:19:28 -0800670
671////////////////////////////// openInputStream //////////////////////////////
672
673class InputStreamTest : public OpenStreamTest<IStreamIn> {
Kevin Rocardf0357882017-02-10 16:19:28 -0800674 virtual void SetUp() override {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700675 ASSERT_NO_FATAL_FAILURE(OpenStreamTest::SetUp()); // setup base
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800676 address.device = AudioDevice::IN_DEFAULT;
Kevin Rocardf0357882017-02-10 16:19:28 -0800677 const AudioConfig& config = GetParam();
Kevin Rocard72e50e22017-05-05 14:02:55 -0700678 AudioInputFlag flags =
679 AudioInputFlag::NONE; // TODO: test all flag combination
680 AudioSource source =
681 AudioSource::DEFAULT; // TODO: test all flag combination
682 testOpen(
683 [&](AudioIoHandle handle, AudioConfig config, auto cb) {
684 return device->openInputStream(handle, address, config, flags,
685 source, cb);
686 },
687 config);
Kevin Rocardf0357882017-02-10 16:19:28 -0800688 }
689};
690
691TEST_P(InputStreamTest, OpenInputStreamTest) {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700692 doc::test(
693 "Check that input streams can be open with the required and "
694 "recommended config");
Kevin Rocardf0357882017-02-10 16:19:28 -0800695 // Open done in setup
696}
697INSTANTIATE_TEST_CASE_P(
Kevin Rocard72e50e22017-05-05 14:02:55 -0700698 RequiredInputStreamConfigSupport, InputStreamTest,
699 ::testing::ValuesIn(
700 AudioConfigPrimaryTest::getRequiredSupportCaptureAudioConfig()),
701 &generateTestName);
Kevin Rocardf0357882017-02-10 16:19:28 -0800702INSTANTIATE_TEST_CASE_P(
Kevin Rocard72e50e22017-05-05 14:02:55 -0700703 SupportedInputStreamConfig, InputStreamTest,
704 ::testing::ValuesIn(
705 AudioConfigPrimaryTest::getSupportedCaptureAudioConfig()),
706 &generateTestName);
Kevin Rocardf0357882017-02-10 16:19:28 -0800707
708INSTANTIATE_TEST_CASE_P(
Kevin Rocard72e50e22017-05-05 14:02:55 -0700709 RecommendedInputStreamConfigSupport, InputStreamTest,
710 ::testing::ValuesIn(
711 AudioConfigPrimaryTest::getRecommendedSupportCaptureAudioConfig()),
712 &generateTestName);
Kevin Rocardf0357882017-02-10 16:19:28 -0800713
714//////////////////////////////////////////////////////////////////////////////
715////////////////////////////// IStream getters ///////////////////////////////
716//////////////////////////////////////////////////////////////////////////////
717
718/** Unpack the provided result.
719 * If the result is not OK, register a failure and return an undefined value. */
720template <class R>
721static R extract(Return<R> ret) {
722 if (!ret.isOk()) {
Kevin Rocardf26f67a2017-05-02 19:21:58 -0700723 EXPECT_IS_OK(ret);
Kevin Rocardf0357882017-02-10 16:19:28 -0800724 return R{};
725 }
726 return ret;
727}
728
Kevin Rocarda7df7fc2017-03-10 18:37:46 -0800729/* Could not find a way to write a test for two parametrized class fixure
730 * thus use this macro do duplicate tests for Input and Output stream */
731#define TEST_IO_STREAM(test_name, documentation, code) \
Kevin Rocard72e50e22017-05-05 14:02:55 -0700732 TEST_P(InputStreamTest, test_name) { \
733 doc::test(documentation); \
734 code; \
735 } \
736 TEST_P(OutputStreamTest, test_name) { \
737 doc::test(documentation); \
738 code; \
Kevin Rocarda7df7fc2017-03-10 18:37:46 -0800739 }
740
Kevin Rocard72e50e22017-05-05 14:02:55 -0700741TEST_IO_STREAM(
742 GetFrameCount,
743 "Check that the stream frame count == the one it was opened with",
744 ASSERT_EQ(audioConfig.frameCount, extract(stream->getFrameCount())))
Kevin Rocarda7df7fc2017-03-10 18:37:46 -0800745
Kevin Rocard07fb7362017-05-26 17:23:07 -0700746TEST_IO_STREAM(GetSampleRate, "Check that the stream sample rate == the one it was opened with",
747 ASSERT_EQ(audioConfig.sampleRateHz, extract(stream->getSampleRate())))
Kevin Rocarda7df7fc2017-03-10 18:37:46 -0800748
Kevin Rocard07fb7362017-05-26 17:23:07 -0700749TEST_IO_STREAM(GetChannelMask, "Check that the stream channel mask == the one it was opened with",
750 ASSERT_EQ(audioConfig.channelMask, extract(stream->getChannelMask())))
Kevin Rocarda7df7fc2017-03-10 18:37:46 -0800751
Kevin Rocard72e50e22017-05-05 14:02:55 -0700752TEST_IO_STREAM(GetFormat,
753 "Check that the stream format == the one it was opened with",
Kevin Rocarda7df7fc2017-03-10 18:37:46 -0800754 ASSERT_EQ(audioConfig.format, extract(stream->getFormat())))
755
756// TODO: for now only check that the framesize is not incoherent
Kevin Rocard72e50e22017-05-05 14:02:55 -0700757TEST_IO_STREAM(GetFrameSize,
758 "Check that the stream frame size == the one it was opened with",
Kevin Rocarda7df7fc2017-03-10 18:37:46 -0800759 ASSERT_GT(extract(stream->getFrameSize()), 0U))
760
Kevin Rocard72e50e22017-05-05 14:02:55 -0700761TEST_IO_STREAM(GetBufferSize,
762 "Check that the stream buffer size== the one it was opened with",
763 ASSERT_GE(extract(stream->getBufferSize()),
764 extract(stream->getFrameSize())));
Kevin Rocarda7df7fc2017-03-10 18:37:46 -0800765
Kevin Rocardf0357882017-02-10 16:19:28 -0800766template <class Property, class CapabilityGetter, class Getter, class Setter>
Kevin Rocard72e50e22017-05-05 14:02:55 -0700767static void testCapabilityGetter(const string& name, IStream* stream,
768 Property currentValue,
769 CapabilityGetter capablityGetter,
770 Getter getter, Setter setter) {
Kevin Rocardf0357882017-02-10 16:19:28 -0800771 hidl_vec<Property> capabilities;
772 ASSERT_OK((stream->*capablityGetter)(returnIn(capabilities)));
773 if (capabilities.size() == 0) {
Kevin Rocard72e50e22017-05-05 14:02:55 -0700774 // The default hal should probably return a NOT_SUPPORTED if the hal
775 // does not expose
776 // capability retrieval. For now it returns an empty list if not
777 // implemented
Kevin Rocardf0357882017-02-10 16:19:28 -0800778 doc::partialTest(name + " is not supported");
779 return;
780 };
Kevin Rocard72e50e22017-05-05 14:02:55 -0700781 // TODO: This code has never been tested on a hal that supports
782 // getSupportedSampleRates
Kevin Rocardf0357882017-02-10 16:19:28 -0800783 EXPECT_NE(std::find(capabilities.begin(), capabilities.end(), currentValue),
Kevin Rocard72e50e22017-05-05 14:02:55 -0700784 capabilities.end())
Kevin Rocardf0357882017-02-10 16:19:28 -0800785 << "current " << name << " is not in the list of the supported ones "
786 << toString(capabilities);
787
788 // Check that all declared supported values are indeed supported
789 for (auto capability : capabilities) {
790 ASSERT_OK((stream->*setter)(capability));
791 ASSERT_EQ(capability, extract((stream->*getter)()));
792 }
793}
794
Kevin Rocard72e50e22017-05-05 14:02:55 -0700795TEST_IO_STREAM(SupportedSampleRate,
796 "Check that the stream sample rate is declared as supported",
797 testCapabilityGetter("getSupportedSampleRate", stream.get(),
798 extract(stream->getSampleRate()),
799 &IStream::getSupportedSampleRates,
800 &IStream::getSampleRate,
801 &IStream::setSampleRate))
Kevin Rocarda7df7fc2017-03-10 18:37:46 -0800802
Kevin Rocard72e50e22017-05-05 14:02:55 -0700803TEST_IO_STREAM(SupportedChannelMask,
804 "Check that the stream channel mask is declared as supported",
805 testCapabilityGetter("getSupportedChannelMask", stream.get(),
806 extract(stream->getChannelMask()),
807 &IStream::getSupportedChannelMasks,
808 &IStream::getChannelMask,
809 &IStream::setChannelMask))
Kevin Rocarda7df7fc2017-03-10 18:37:46 -0800810
Kevin Rocard72e50e22017-05-05 14:02:55 -0700811TEST_IO_STREAM(SupportedFormat,
812 "Check that the stream format is declared as supported",
813 testCapabilityGetter("getSupportedFormat", stream.get(),
814 extract(stream->getFormat()),
815 &IStream::getSupportedFormats,
Kevin Rocarda7df7fc2017-03-10 18:37:46 -0800816 &IStream::getFormat, &IStream::setFormat))
817
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800818static void testGetDevice(IStream* stream, AudioDevice expectedDevice) {
Kevin Rocard8f8730c2017-05-02 19:34:29 -0700819 // Unfortunately the interface does not allow the implementation to return
820 // NOT_SUPPORTED
821 // Thus allow NONE as signaling that the call is not supported.
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800822 auto ret = stream->getDevice();
Kevin Rocardf26f67a2017-05-02 19:21:58 -0700823 ASSERT_IS_OK(ret);
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800824 AudioDevice device = ret;
Kevin Rocard8f8730c2017-05-02 19:34:29 -0700825 ASSERT_TRUE(device == expectedDevice || device == AudioDevice::NONE)
826 << "Expected: " << ::testing::PrintToString(expectedDevice)
827 << "\n Actual: " << ::testing::PrintToString(device);
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800828}
829
Kevin Rocard72e50e22017-05-05 14:02:55 -0700830TEST_IO_STREAM(GetDevice,
831 "Check that the stream device == the one it was opened with",
832 areAudioPatchesSupported()
833 ? doc::partialTest("Audio patches are supported")
834 : testGetDevice(stream.get(), address.device))
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800835
836static void testSetDevice(IStream* stream, const DeviceAddress& address) {
837 DeviceAddress otherAddress = address;
Kevin Rocard72e50e22017-05-05 14:02:55 -0700838 otherAddress.device = (address.device & AudioDevice::BIT_IN) == 0
839 ? AudioDevice::OUT_SPEAKER
840 : AudioDevice::IN_BUILTIN_MIC;
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800841 EXPECT_OK(stream->setDevice(otherAddress));
842
Kevin Rocard72e50e22017-05-05 14:02:55 -0700843 ASSERT_OK(stream->setDevice(address)); // Go back to the original value
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800844}
845
Kevin Rocard72e50e22017-05-05 14:02:55 -0700846TEST_IO_STREAM(
847 SetDevice,
848 "Check that the stream can be rerouted to SPEAKER or BUILTIN_MIC",
849 areAudioPatchesSupported() ? doc::partialTest("Audio patches are supported")
850 : testSetDevice(stream.get(), address))
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800851
Kevin Rocard07fb7362017-05-26 17:23:07 -0700852static void testGetAudioProperties(IStream* stream, AudioConfig expectedConfig) {
Kevin Rocardf0357882017-02-10 16:19:28 -0800853 uint32_t sampleRateHz;
854 AudioChannelMask mask;
855 AudioFormat format;
Kevin Rocard07fb7362017-05-26 17:23:07 -0700856
Kevin Rocardf0357882017-02-10 16:19:28 -0800857 stream->getAudioProperties(returnIn(sampleRateHz, mask, format));
Kevin Rocard07fb7362017-05-26 17:23:07 -0700858
859 // FIXME: the qcom hal it does not currently negotiate the sampleRate &
860 // channel mask
861 EXPECT_EQ(expectedConfig.sampleRateHz, sampleRateHz);
862 EXPECT_EQ(expectedConfig.channelMask, mask);
863 EXPECT_EQ(expectedConfig.format, format);
Kevin Rocardf0357882017-02-10 16:19:28 -0800864}
865
Kevin Rocard07fb7362017-05-26 17:23:07 -0700866TEST_IO_STREAM(GetAudioProperties,
867 "Check that the stream audio properties == the ones it was opened with",
868 testGetAudioProperties(stream.get(), audioConfig))
Kevin Rocardf0357882017-02-10 16:19:28 -0800869
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800870static void testConnectedState(IStream* stream) {
871 DeviceAddress address = {};
872 using AD = AudioDevice;
Kevin Rocard72e50e22017-05-05 14:02:55 -0700873 for (auto device :
874 {AD::OUT_HDMI, AD::OUT_WIRED_HEADPHONE, AD::IN_USB_HEADSET}) {
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800875 address.device = device;
876
877 ASSERT_OK(stream->setConnectedState(address, true));
878 ASSERT_OK(stream->setConnectedState(address, false));
879 }
880}
881TEST_IO_STREAM(SetConnectedState,
Kevin Rocard72e50e22017-05-05 14:02:55 -0700882 "Check that the stream can be notified of device connection and "
883 "deconnection",
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800884 testConnectedState(stream.get()))
885
Kevin Rocardf8500dc2017-05-03 10:43:21 -0700886static auto invalidArgsOrNotSupportedOrOK = {Result::INVALID_ARGUMENTS,
887 Result::NOT_SUPPORTED, Result::OK};
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800888TEST_IO_STREAM(SetHwAvSync, "Try to set hardware sync to an invalid value",
Kevin Rocardf8500dc2017-05-03 10:43:21 -0700889 ASSERT_RESULT(invalidArgsOrNotSupportedOrOK,
Kevin Rocard72e50e22017-05-05 14:02:55 -0700890 stream->setHwAvSync(666)))
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800891
Kevin Rocarde9a8fb72017-03-21 11:39:55 -0700892TEST_IO_STREAM(GetHwAvSync, "Get hardware sync can not fail",
Kevin Rocardf26f67a2017-05-02 19:21:58 -0700893 ASSERT_IS_OK(device->getHwAvSync()));
Kevin Rocarde9a8fb72017-03-21 11:39:55 -0700894
Kevin Rocardfa3b4a92017-05-02 17:38:34 -0700895static void checkGetNoParameter(IStream* stream, hidl_vec<hidl_string> keys,
896 vector<Result> expectedResults) {
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800897 hidl_vec<ParameterValue> parameters;
898 Result res;
899 ASSERT_OK(stream->getParameters(keys, returnIn(res, parameters)));
900 ASSERT_RESULT(expectedResults, res);
901 if (res == Result::OK) {
Kevin Rocard4aefd1c2017-05-02 18:58:58 -0700902 for (auto& parameter : parameters) {
903 ASSERT_EQ(0U, parameter.value.size()) << toString(parameter);
904 }
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800905 }
906}
907
Kevin Rocard72e50e22017-05-05 14:02:55 -0700908/* Get/Set parameter is intended to be an opaque channel between vendors app and
909 * their HALs.
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800910 * Thus can not be meaningfully tested.
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800911 */
912TEST_IO_STREAM(getEmptySetParameter, "Retrieve the values of an empty set",
Kevin Rocardfa3b4a92017-05-02 17:38:34 -0700913 checkGetNoParameter(stream.get(), {} /* keys */, {Result::OK}))
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800914
Kevin Rocard72e50e22017-05-05 14:02:55 -0700915TEST_IO_STREAM(getNonExistingParameter,
916 "Retrieve the values of an non existing parameter",
Kevin Rocardfa3b4a92017-05-02 17:38:34 -0700917 checkGetNoParameter(stream.get(),
918 {"Non existing key"} /* keys */,
919 {Result::NOT_SUPPORTED}))
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800920
Kevin Rocard72e50e22017-05-05 14:02:55 -0700921TEST_IO_STREAM(setEmptySetParameter,
922 "Set the values of an empty set of parameters",
Kevin Rocardf8500dc2017-05-03 10:43:21 -0700923 ASSERT_RESULT(Result::OK, stream->setParameters({})))
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800924
Kevin Rocard72e50e22017-05-05 14:02:55 -0700925TEST_IO_STREAM(
926 setNonExistingParameter, "Set the values of an non existing parameter",
Kevin Rocardf8500dc2017-05-03 10:43:21 -0700927 // Unfortunately, the set_parameter legacy interface did not return any
928 // error code when a key is not supported.
929 // To allow implementation to just wrapped the legacy one, consider OK as a
930 // valid result for setting a non existing parameter.
931 ASSERT_RESULT(invalidArgsOrNotSupportedOrOK,
Kevin Rocard72e50e22017-05-05 14:02:55 -0700932 stream->setParameters({{"non existing key", "0"}})))
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800933
Kevin Rocardb9031242017-03-13 12:20:54 -0700934TEST_IO_STREAM(DebugDump,
935 "Check that a stream can dump its state without error",
Kevin Rocard72e50e22017-05-05 14:02:55 -0700936 testDebugDump([this](const auto& handle) {
937 return stream->debugDump(handle);
938 }))
Kevin Rocardb9031242017-03-13 12:20:54 -0700939
Mikhail Naganov3e6fe752017-04-24 10:44:08 -0700940TEST_IO_STREAM(DebugDumpInvalidArguments,
941 "Check that the stream dump doesn't crash on invalid arguments",
942 ASSERT_OK(stream->debugDump(hidl_handle())))
943
Kevin Rocardf0357882017-02-10 16:19:28 -0800944//////////////////////////////////////////////////////////////////////////////
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800945////////////////////////////// addRemoveEffect ///////////////////////////////
Kevin Rocardf0357882017-02-10 16:19:28 -0800946//////////////////////////////////////////////////////////////////////////////
947
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800948TEST_IO_STREAM(AddNonExistingEffect, "Adding a non existing effect should fail",
949 ASSERT_RESULT(Result::INVALID_ARGUMENTS, stream->addEffect(666)))
Kevin Rocard72e50e22017-05-05 14:02:55 -0700950TEST_IO_STREAM(RemoveNonExistingEffect,
951 "Removing a non existing effect should fail",
952 ASSERT_RESULT(Result::INVALID_ARGUMENTS,
953 stream->removeEffect(666)))
Kevin Rocardf0357882017-02-10 16:19:28 -0800954
Kevin Rocard72e50e22017-05-05 14:02:55 -0700955// TODO: positive tests
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800956
957//////////////////////////////////////////////////////////////////////////////
958/////////////////////////////// Control ////////////////////////////////
959//////////////////////////////////////////////////////////////////////////////
960
961TEST_IO_STREAM(standby, "Make sure the stream can be put in stanby",
Kevin Rocard72e50e22017-05-05 14:02:55 -0700962 ASSERT_OK(stream->standby())) // can not fail
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800963
Kevin Rocard72e50e22017-05-05 14:02:55 -0700964static vector<Result> invalidStateOrNotSupported = {Result::INVALID_STATE,
965 Result::NOT_SUPPORTED};
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800966
Kevin Rocard72e50e22017-05-05 14:02:55 -0700967TEST_IO_STREAM(startNoMmap,
968 "Starting a mmaped stream before mapping it should fail",
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800969 ASSERT_RESULT(invalidStateOrNotSupported, stream->start()))
970
Kevin Rocard72e50e22017-05-05 14:02:55 -0700971TEST_IO_STREAM(stopNoMmap,
972 "Stopping a mmaped stream before mapping it should fail",
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800973 ASSERT_RESULT(invalidStateOrNotSupported, stream->stop()))
974
Kevin Rocard72e50e22017-05-05 14:02:55 -0700975TEST_IO_STREAM(getMmapPositionNoMmap,
976 "Get a stream Mmap position before mapping it should fail",
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800977 ASSERT_RESULT(invalidStateOrNotSupported, stream->stop()))
978
Kevin Rocard72e50e22017-05-05 14:02:55 -0700979TEST_IO_STREAM(close, "Make sure a stream can be closed",
980 ASSERT_OK(closeStream()))
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800981TEST_IO_STREAM(closeTwice, "Make sure a stream can not be closed twice",
Kevin Rocard72e50e22017-05-05 14:02:55 -0700982 ASSERT_OK(closeStream());
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800983 ASSERT_RESULT(Result::INVALID_STATE, closeStream()))
984
Kevin Rocardf8500dc2017-05-03 10:43:21 -0700985static auto invalidArgsOrNotSupported = {Result::INVALID_ARGUMENTS,
986 Result::NOT_SUPPORTED};
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800987static void testCreateTooBigMmapBuffer(IStream* stream) {
988 MmapBufferInfo info;
989 Result res;
990 // Assume that int max is a value too big to be allocated
Kevin Rocard72e50e22017-05-05 14:02:55 -0700991 // This is true currently with a 32bit media server, but might not when it
992 // will run in 64 bit
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800993 auto minSizeFrames = std::numeric_limits<int32_t>::max();
994 ASSERT_OK(stream->createMmapBuffer(minSizeFrames, returnIn(res, info)));
995 ASSERT_RESULT(invalidArgsOrNotSupported, res);
Kevin Rocardf0357882017-02-10 16:19:28 -0800996}
997
Kevin Rocard8878b4b2017-03-10 18:47:37 -0800998TEST_IO_STREAM(CreateTooBigMmapBuffer, "Create mmap buffer too big should fail",
999 testCreateTooBigMmapBuffer(stream.get()))
1000
Kevin Rocard8878b4b2017-03-10 18:47:37 -08001001static void testGetMmapPositionOfNonMmapedStream(IStream* stream) {
1002 Result res;
1003 MmapPosition position;
1004 ASSERT_OK(stream->getMmapPosition(returnIn(res, position)));
1005 ASSERT_RESULT(invalidArgsOrNotSupported, res);
1006}
1007
Kevin Rocard72e50e22017-05-05 14:02:55 -07001008TEST_IO_STREAM(
1009 GetMmapPositionOfNonMmapedStream,
1010 "Retrieving the mmap position of a non mmaped stream should fail",
1011 testGetMmapPositionOfNonMmapedStream(stream.get()))
Kevin Rocard8878b4b2017-03-10 18:47:37 -08001012
Kevin Rocardf0357882017-02-10 16:19:28 -08001013//////////////////////////////////////////////////////////////////////////////
Kevin Rocardc9963522017-03-10 18:47:37 -08001014///////////////////////////////// StreamIn ///////////////////////////////////
1015//////////////////////////////////////////////////////////////////////////////
1016
1017TEST_P(InputStreamTest, GetAudioSource) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001018 doc::test(
1019 "Retrieving the audio source of an input stream should always succeed");
Kevin Rocardc9963522017-03-10 18:47:37 -08001020 AudioSource source;
1021 ASSERT_OK(stream->getAudioSource(returnIn(res, source)));
Kevin Rocard98390a62017-05-03 11:16:05 -07001022 if (res == Result::NOT_SUPPORTED) {
1023 doc::partialTest("getAudioSource is not supported");
1024 return;
1025 }
Kevin Rocardc9963522017-03-10 18:47:37 -08001026 ASSERT_OK(res);
1027 ASSERT_EQ(AudioSource::DEFAULT, source);
1028}
1029
Kevin Rocard72e50e22017-05-05 14:02:55 -07001030static void testUnitaryGain(std::function<Return<Result>(float)> setGain) {
Kevin Rocardc4f1b2f2017-05-03 11:19:25 -07001031 for (float value :
1032 (float[]){-INFINITY, -1.0, 1.0 + std::numeric_limits<float>::epsilon(),
1033 2.0, INFINITY, NAN}) {
Kevin Rocarda1d6ea42017-05-08 17:08:11 -07001034 EXPECT_RESULT(Result::INVALID_ARGUMENTS, setGain(value)) << "value="
1035 << value;
Kevin Rocardc9963522017-03-10 18:47:37 -08001036 }
Kevin Rocardc4f1b2f2017-05-03 11:19:25 -07001037 // Do not consider -0.0 as an invalid value as it is == with 0.0
1038 for (float value : {-0.0, 0.0, 0.01, 0.5, 0.09, 1.0 /* Restore volume*/}) {
Kevin Rocarda1d6ea42017-05-08 17:08:11 -07001039 EXPECT_OK(setGain(value)) << "value=" << value;
Kevin Rocardc4f1b2f2017-05-03 11:19:25 -07001040 }
Kevin Rocardc9963522017-03-10 18:47:37 -08001041}
1042
Kevin Rocard98390a62017-05-03 11:16:05 -07001043static void testOptionalUnitaryGain(
1044 std::function<Return<Result>(float)> setGain, string debugName) {
1045 auto result = setGain(1);
Kevin Rocardf26f67a2017-05-02 19:21:58 -07001046 ASSERT_IS_OK(result);
Kevin Rocard98390a62017-05-03 11:16:05 -07001047 if (result == Result::NOT_SUPPORTED) {
1048 doc::partialTest(debugName + " is not supported");
1049 return;
1050 }
1051 testUnitaryGain(setGain);
1052}
1053
Kevin Rocardc9963522017-03-10 18:47:37 -08001054TEST_P(InputStreamTest, SetGain) {
1055 doc::test("The gain of an input stream should only be set between [0,1]");
Kevin Rocard98390a62017-05-03 11:16:05 -07001056 testOptionalUnitaryGain(
1057 [this](float volume) { return stream->setGain(volume); },
1058 "InputStream::setGain");
Kevin Rocardc9963522017-03-10 18:47:37 -08001059}
1060
Kevin Rocard72e50e22017-05-05 14:02:55 -07001061static void testPrepareForReading(IStreamIn* stream, uint32_t frameSize,
1062 uint32_t framesCount) {
Kevin Rocardc9963522017-03-10 18:47:37 -08001063 Result res;
1064 // Ignore output parameters as the call should fail
Kevin Rocard72e50e22017-05-05 14:02:55 -07001065 ASSERT_OK(stream->prepareForReading(
1066 frameSize, framesCount,
1067 [&res](auto r, auto&, auto&, auto&, auto&) { res = r; }));
Kevin Rocardfcf186b2017-05-03 11:16:05 -07001068 EXPECT_RESULT(Result::INVALID_ARGUMENTS, res);
Kevin Rocardc9963522017-03-10 18:47:37 -08001069}
1070
Kevin Rocard195205b2017-05-02 18:34:59 -07001071TEST_P(InputStreamTest, PrepareForReadingWithZeroBuffer) {
1072 doc::test(
1073 "Preparing a stream for reading with a 0 sized buffer should fail");
1074 testPrepareForReading(stream.get(), 0, 0);
1075}
1076
Kevin Rocardc9963522017-03-10 18:47:37 -08001077TEST_P(InputStreamTest, PrepareForReadingWithHugeBuffer) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001078 doc::test(
1079 "Preparing a stream for reading with a 2^32 sized buffer should fail");
1080 testPrepareForReading(stream.get(), 1,
1081 std::numeric_limits<uint32_t>::max());
Kevin Rocardc9963522017-03-10 18:47:37 -08001082}
1083
1084TEST_P(InputStreamTest, PrepareForReadingCheckOverflow) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001085 doc::test(
1086 "Preparing a stream for reading with a overflowing sized buffer should "
1087 "fail");
Kevin Rocardc9963522017-03-10 18:47:37 -08001088 auto uintMax = std::numeric_limits<uint32_t>::max();
1089 testPrepareForReading(stream.get(), uintMax, uintMax);
1090}
1091
Kevin Rocarde9a8fb72017-03-21 11:39:55 -07001092TEST_P(InputStreamTest, GetInputFramesLost) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001093 doc::test(
1094 "The number of frames lost on a never started stream should be 0");
Kevin Rocarde9a8fb72017-03-21 11:39:55 -07001095 auto ret = stream->getInputFramesLost();
Kevin Rocardf26f67a2017-05-02 19:21:58 -07001096 ASSERT_IS_OK(ret);
Kevin Rocarde9a8fb72017-03-21 11:39:55 -07001097 uint32_t framesLost{ret};
1098 ASSERT_EQ(0U, framesLost);
1099}
1100
Kevin Rocardc9963522017-03-10 18:47:37 -08001101TEST_P(InputStreamTest, getCapturePosition) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001102 doc::test(
1103 "The capture position of a non prepared stream should not be "
1104 "retrievable");
Kevin Rocardc9963522017-03-10 18:47:37 -08001105 uint64_t frames;
1106 uint64_t time;
1107 ASSERT_OK(stream->getCapturePosition(returnIn(res, frames, time)));
1108 ASSERT_RESULT(invalidStateOrNotSupported, res);
1109}
1110
1111//////////////////////////////////////////////////////////////////////////////
Kevin Rocard624800c2017-03-10 18:47:37 -08001112///////////////////////////////// StreamIn ///////////////////////////////////
1113//////////////////////////////////////////////////////////////////////////////
1114
1115TEST_P(OutputStreamTest, getLatency) {
1116 doc::test("Make sure latency is over 0");
1117 auto result = stream->getLatency();
Kevin Rocardf26f67a2017-05-02 19:21:58 -07001118 ASSERT_IS_OK(result);
Kevin Rocard624800c2017-03-10 18:47:37 -08001119 ASSERT_GT(result, 0U);
1120}
1121
1122TEST_P(OutputStreamTest, setVolume) {
1123 doc::test("Try to set the output volume");
Kevin Rocard98390a62017-05-03 11:16:05 -07001124 testOptionalUnitaryGain(
1125 [this](float volume) { return stream->setVolume(volume, volume); },
1126 "setVolume");
Kevin Rocard624800c2017-03-10 18:47:37 -08001127}
1128
Kevin Rocard72e50e22017-05-05 14:02:55 -07001129static void testPrepareForWriting(IStreamOut* stream, uint32_t frameSize,
1130 uint32_t framesCount) {
Kevin Rocard624800c2017-03-10 18:47:37 -08001131 Result res;
1132 // Ignore output parameters as the call should fail
Kevin Rocard72e50e22017-05-05 14:02:55 -07001133 ASSERT_OK(stream->prepareForWriting(
1134 frameSize, framesCount,
1135 [&res](auto r, auto&, auto&, auto&, auto&) { res = r; }));
Kevin Rocardfcf186b2017-05-03 11:16:05 -07001136 EXPECT_RESULT(Result::INVALID_ARGUMENTS, res);
Kevin Rocard624800c2017-03-10 18:47:37 -08001137}
1138
Kevin Rocard195205b2017-05-02 18:34:59 -07001139TEST_P(OutputStreamTest, PrepareForWriteWithZeroBuffer) {
1140 doc::test(
1141 "Preparing a stream for writing with a 0 sized buffer should fail");
1142 testPrepareForWriting(stream.get(), 0, 0);
1143}
1144
Kevin Rocard624800c2017-03-10 18:47:37 -08001145TEST_P(OutputStreamTest, PrepareForWriteWithHugeBuffer) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001146 doc::test(
1147 "Preparing a stream for writing with a 2^32 sized buffer should fail");
1148 testPrepareForWriting(stream.get(), 1,
1149 std::numeric_limits<uint32_t>::max());
Kevin Rocard624800c2017-03-10 18:47:37 -08001150}
1151
1152TEST_P(OutputStreamTest, PrepareForWritingCheckOverflow) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001153 doc::test(
1154 "Preparing a stream for writing with a overflowing sized buffer should "
1155 "fail");
Kevin Rocard624800c2017-03-10 18:47:37 -08001156 auto uintMax = std::numeric_limits<uint32_t>::max();
1157 testPrepareForWriting(stream.get(), uintMax, uintMax);
1158}
1159
1160struct Capability {
1161 Capability(IStreamOut* stream) {
1162 EXPECT_OK(stream->supportsPauseAndResume(returnIn(pause, resume)));
1163 auto ret = stream->supportsDrain();
Kevin Rocardf26f67a2017-05-02 19:21:58 -07001164 EXPECT_IS_OK(ret);
Kevin Rocard624800c2017-03-10 18:47:37 -08001165 if (ret.isOk()) {
1166 drain = ret;
1167 }
1168 }
1169 bool pause = false;
1170 bool resume = false;
1171 bool drain = false;
1172};
1173
1174TEST_P(OutputStreamTest, SupportsPauseAndResumeAndDrain) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001175 doc::test(
1176 "Implementation must expose pause, resume and drain capabilities");
Kevin Rocard624800c2017-03-10 18:47:37 -08001177 Capability(stream.get());
1178}
1179
Kevin Rocard304b6c82017-05-03 10:57:06 -07001180template <class Value>
1181static void checkInvalidStateOr0(Result res, Value value) {
1182 switch (res) {
1183 case Result::INVALID_STATE:
1184 break;
1185 case Result::OK:
1186 ASSERT_EQ(0U, value);
1187 break;
1188 default:
1189 FAIL() << "Unexpected result " << toString(res);
1190 }
1191}
1192
Kevin Rocard624800c2017-03-10 18:47:37 -08001193TEST_P(OutputStreamTest, GetRenderPosition) {
Kevin Rocard304b6c82017-05-03 10:57:06 -07001194 doc::test("A new stream render position should be 0 or INVALID_STATE");
Kevin Rocard624800c2017-03-10 18:47:37 -08001195 uint32_t dspFrames;
1196 ASSERT_OK(stream->getRenderPosition(returnIn(res, dspFrames)));
1197 if (res == Result::NOT_SUPPORTED) {
1198 doc::partialTest("getRenderPosition is not supported");
1199 return;
1200 }
Kevin Rocard304b6c82017-05-03 10:57:06 -07001201 checkInvalidStateOr0(res, dspFrames);
Kevin Rocard624800c2017-03-10 18:47:37 -08001202}
1203
1204TEST_P(OutputStreamTest, GetNextWriteTimestamp) {
Kevin Rocard304b6c82017-05-03 10:57:06 -07001205 doc::test("A new stream next write timestamp should be 0 or INVALID_STATE");
Kevin Rocard624800c2017-03-10 18:47:37 -08001206 uint64_t timestampUs;
Kevin Rocarde9a8fb72017-03-21 11:39:55 -07001207 ASSERT_OK(stream->getNextWriteTimestamp(returnIn(res, timestampUs)));
Kevin Rocard624800c2017-03-10 18:47:37 -08001208 if (res == Result::NOT_SUPPORTED) {
Kevin Rocarde9a8fb72017-03-21 11:39:55 -07001209 doc::partialTest("getNextWriteTimestamp is not supported");
Kevin Rocard624800c2017-03-10 18:47:37 -08001210 return;
1211 }
Kevin Rocard304b6c82017-05-03 10:57:06 -07001212 checkInvalidStateOr0(res, timestampUs);
Kevin Rocard624800c2017-03-10 18:47:37 -08001213}
1214
1215/** Stub implementation of out stream callback. */
1216class MockOutCallbacks : public IStreamOutCallback {
1217 Return<void> onWriteReady() override { return {}; }
1218 Return<void> onDrainReady() override { return {}; }
1219 Return<void> onError() override { return {}; }
1220};
1221
Kevin Rocard72e50e22017-05-05 14:02:55 -07001222static bool isAsyncModeSupported(IStreamOut* stream) {
Kevin Rocard624800c2017-03-10 18:47:37 -08001223 auto res = stream->setCallback(new MockOutCallbacks);
Kevin Rocard72e50e22017-05-05 14:02:55 -07001224 stream->clearCallback(); // try to restore the no callback state, ignore
1225 // any error
1226 auto okOrNotSupported = {Result::OK, Result::NOT_SUPPORTED};
Kevin Rocard624800c2017-03-10 18:47:37 -08001227 EXPECT_RESULT(okOrNotSupported, res);
1228 return res.isOk() ? res == Result::OK : false;
1229}
1230
1231TEST_P(OutputStreamTest, SetCallback) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001232 doc::test(
1233 "If supported, registering callback for async operation should never "
1234 "fail");
Kevin Rocard624800c2017-03-10 18:47:37 -08001235 if (!isAsyncModeSupported(stream.get())) {
1236 doc::partialTest("The stream does not support async operations");
1237 return;
1238 }
1239 ASSERT_OK(stream->setCallback(new MockOutCallbacks));
1240 ASSERT_OK(stream->setCallback(new MockOutCallbacks));
1241}
1242
1243TEST_P(OutputStreamTest, clearCallback) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001244 doc::test(
1245 "If supported, clearing a callback to go back to sync operation should "
1246 "not fail");
Kevin Rocard624800c2017-03-10 18:47:37 -08001247 if (!isAsyncModeSupported(stream.get())) {
1248 doc::partialTest("The stream does not support async operations");
1249 return;
1250 }
1251 // TODO: Clarify if clearing a non existing callback should fail
1252 ASSERT_OK(stream->setCallback(new MockOutCallbacks));
1253 ASSERT_OK(stream->clearCallback());
1254}
1255
1256TEST_P(OutputStreamTest, Resume) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001257 doc::test(
1258 "If supported, a stream should fail to resume if not previously "
1259 "paused");
Kevin Rocard624800c2017-03-10 18:47:37 -08001260 if (!Capability(stream.get()).resume) {
1261 doc::partialTest("The output stream does not support resume");
1262 return;
1263 }
1264 ASSERT_RESULT(Result::INVALID_STATE, stream->resume());
1265}
1266
1267TEST_P(OutputStreamTest, Pause) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001268 doc::test(
1269 "If supported, a stream should fail to pause if not previously "
1270 "started");
Kevin Rocard624800c2017-03-10 18:47:37 -08001271 if (!Capability(stream.get()).pause) {
1272 doc::partialTest("The output stream does not support pause");
1273 return;
1274 }
1275 ASSERT_RESULT(Result::INVALID_STATE, stream->resume());
1276}
1277
Kevin Rocard72e50e22017-05-05 14:02:55 -07001278static void testDrain(IStreamOut* stream, AudioDrain type) {
Kevin Rocard624800c2017-03-10 18:47:37 -08001279 if (!Capability(stream).drain) {
Kevin Rocard6f226802017-04-03 10:29:34 -07001280 doc::partialTest("The output stream does not support drain");
Kevin Rocard624800c2017-03-10 18:47:37 -08001281 return;
1282 }
1283 ASSERT_RESULT(Result::OK, stream->drain(type));
1284}
1285
1286TEST_P(OutputStreamTest, DrainAll) {
Kevin Rocard6f226802017-04-03 10:29:34 -07001287 doc::test("If supported, a stream should always succeed to drain");
Kevin Rocard624800c2017-03-10 18:47:37 -08001288 testDrain(stream.get(), AudioDrain::ALL);
1289}
1290
1291TEST_P(OutputStreamTest, DrainEarlyNotify) {
Kevin Rocard6f226802017-04-03 10:29:34 -07001292 doc::test("If supported, a stream should always succeed to drain");
Kevin Rocard624800c2017-03-10 18:47:37 -08001293 testDrain(stream.get(), AudioDrain::EARLY_NOTIFY);
1294}
1295
1296TEST_P(OutputStreamTest, FlushStop) {
Kevin Rocard6f226802017-04-03 10:29:34 -07001297 doc::test("If supported, a stream should always succeed to flush");
Kevin Rocarde9a8fb72017-03-21 11:39:55 -07001298 auto ret = stream->flush();
Kevin Rocardf26f67a2017-05-02 19:21:58 -07001299 ASSERT_IS_OK(ret);
Kevin Rocarde9a8fb72017-03-21 11:39:55 -07001300 if (ret == Result::NOT_SUPPORTED) {
1301 doc::partialTest("Flush is not supported");
1302 return;
1303 }
1304 ASSERT_OK(ret);
Kevin Rocard624800c2017-03-10 18:47:37 -08001305}
1306
1307TEST_P(OutputStreamTest, GetPresentationPositionStop) {
Kevin Rocard72e50e22017-05-05 14:02:55 -07001308 doc::test(
1309 "If supported, a stream should always succeed to retrieve the "
1310 "presentation position");
Kevin Rocard624800c2017-03-10 18:47:37 -08001311 uint64_t frames;
1312 TimeSpec mesureTS;
1313 ASSERT_OK(stream->getPresentationPosition(returnIn(res, frames, mesureTS)));
1314 if (res == Result::NOT_SUPPORTED) {
1315 doc::partialTest("getpresentationPosition is not supported");
1316 return;
1317 }
1318 ASSERT_EQ(0U, frames);
1319
Kevin Rocard476e38f2017-05-03 10:52:43 -07001320 if (mesureTS.tvNSec == 0 && mesureTS.tvSec == 0) {
1321 // As the stream has never written a frame yet,
1322 // the timestamp does not really have a meaning, allow to return 0
1323 return;
1324 }
1325
1326 // Make sure the return measure is not more than 1s old.
Kevin Rocard624800c2017-03-10 18:47:37 -08001327 struct timespec currentTS;
1328 ASSERT_EQ(0, clock_gettime(CLOCK_MONOTONIC, &currentTS)) << errno;
1329
Kevin Rocard72e50e22017-05-05 14:02:55 -07001330 auto toMicroSec = [](uint64_t sec, auto nsec) {
1331 return sec * 1e+6 + nsec / 1e+3;
1332 };
Kevin Rocard624800c2017-03-10 18:47:37 -08001333 auto currentTime = toMicroSec(currentTS.tv_sec, currentTS.tv_nsec);
1334 auto mesureTime = toMicroSec(mesureTS.tvSec, mesureTS.tvNSec);
Kevin Rocard72e50e22017-05-05 14:02:55 -07001335 ASSERT_PRED2([](auto c, auto m) { return c - m < 1e+6; }, currentTime,
1336 mesureTime);
Kevin Rocard624800c2017-03-10 18:47:37 -08001337}
1338
Kevin Rocard624800c2017-03-10 18:47:37 -08001339//////////////////////////////////////////////////////////////////////////////
Kevin Rocard3c405a72017-03-08 16:46:51 -08001340/////////////////////////////// PrimaryDevice ////////////////////////////////
1341//////////////////////////////////////////////////////////////////////////////
1342
1343TEST_F(AudioPrimaryHidlTest, setVoiceVolume) {
1344 doc::test("Make sure setVoiceVolume only succeed if volume is in [0,1]");
Chih-Hung Hsieh7eb57b62017-05-15 12:31:25 -07001345 testUnitaryGain([](float volume) { return device->setVoiceVolume(volume); });
Kevin Rocard3c405a72017-03-08 16:46:51 -08001346}
1347
1348TEST_F(AudioPrimaryHidlTest, setMode) {
Kevin Rocard04364ed2017-05-02 18:16:00 -07001349 doc::test(
1350 "Make sure setMode always succeeds if mode is valid "
1351 "and fails otherwise");
1352 // Test Invalid values
1353 for (AudioMode mode :
1354 {AudioMode::INVALID, AudioMode::CURRENT, AudioMode::CNT}) {
1355 SCOPED_TRACE("mode=" + toString(mode));
1356 ASSERT_RESULT(Result::INVALID_ARGUMENTS, device->setMode(mode));
1357 }
1358 // Test valid values
Kevin Rocard72e50e22017-05-05 14:02:55 -07001359 for (AudioMode mode :
1360 {AudioMode::IN_CALL, AudioMode::IN_COMMUNICATION, AudioMode::RINGTONE,
Kevin Rocard72e50e22017-05-05 14:02:55 -07001361 AudioMode::NORMAL /* Make sure to leave the test in normal mode */}) {
Kevin Rocard3c405a72017-03-08 16:46:51 -08001362 SCOPED_TRACE("mode=" + toString(mode));
1363 ASSERT_OK(device->setMode(mode));
1364 }
Kevin Rocard3c405a72017-03-08 16:46:51 -08001365}
1366
Kevin Rocard3c405a72017-03-08 16:46:51 -08001367TEST_F(BoolAccessorPrimaryHidlTest, BtScoNrecEnabled) {
1368 doc::test("Query and set the BT SCO NR&EC state");
1369 testOptionalAccessors("BtScoNrecEnabled", {true, false, true},
Kevin Rocard72e50e22017-05-05 14:02:55 -07001370 &IPrimaryDevice::setBtScoNrecEnabled,
1371 &IPrimaryDevice::getBtScoNrecEnabled);
Kevin Rocard3c405a72017-03-08 16:46:51 -08001372}
1373
1374TEST_F(BoolAccessorPrimaryHidlTest, setGetBtScoWidebandEnabled) {
1375 doc::test("Query and set the SCO whideband state");
1376 testOptionalAccessors("BtScoWideband", {true, false, true},
Kevin Rocard72e50e22017-05-05 14:02:55 -07001377 &IPrimaryDevice::setBtScoWidebandEnabled,
1378 &IPrimaryDevice::getBtScoWidebandEnabled);
Kevin Rocard3c405a72017-03-08 16:46:51 -08001379}
1380
1381using TtyModeAccessorPrimaryHidlTest = AccessorPrimaryHidlTest<TtyMode>;
1382TEST_F(TtyModeAccessorPrimaryHidlTest, setGetTtyMode) {
1383 doc::test("Query and set the TTY mode state");
Kevin Rocard72e50e22017-05-05 14:02:55 -07001384 testOptionalAccessors(
1385 "TTY mode", {TtyMode::OFF, TtyMode::HCO, TtyMode::VCO, TtyMode::FULL},
1386 &IPrimaryDevice::setTtyMode, &IPrimaryDevice::getTtyMode);
Kevin Rocard3c405a72017-03-08 16:46:51 -08001387}
1388
1389TEST_F(BoolAccessorPrimaryHidlTest, setGetHac) {
1390 doc::test("Query and set the HAC state");
Kevin Rocard98390a62017-05-03 11:16:05 -07001391 testOptionalAccessors("HAC", {true, false, true},
1392 &IPrimaryDevice::setHacEnabled,
1393 &IPrimaryDevice::getHacEnabled);
Kevin Rocard3c405a72017-03-08 16:46:51 -08001394}
1395
1396//////////////////////////////////////////////////////////////////////////////
Kevin Rocardf0357882017-02-10 16:19:28 -08001397//////////////////// Clean caches on global tear down ////////////////////////
1398//////////////////////////////////////////////////////////////////////////////
1399
1400int main(int argc, char** argv) {
1401 environment = new Environment;
1402 ::testing::AddGlobalTestEnvironment(environment);
1403 ::testing::InitGoogleTest(&argc, argv);
1404 int status = RUN_ALL_TESTS();
1405 LOG(INFO) << "Test result = " << status;
1406 return status;
1407}