1 /* 2 * Copyright (C) 2016 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 #ifndef ANDROID_HARDWARE_AUDIO_V2_0_STREAMOUT_H 18 #define ANDROID_HARDWARE_AUDIO_V2_0_STREAMOUT_H 19 20 #include <atomic> 21 #include <memory> 22 23 #include <android/hardware/audio/2.0/IStreamOut.h> 24 #include <hidl/MQDescriptor.h> 25 #include <hidl/Status.h> 26 #include <fmq/EventFlag.h> 27 #include <fmq/MessageQueue.h> 28 #include <utils/Thread.h> 29 30 #include "Device.h" 31 #include "Stream.h" 32 33 namespace android { 34 namespace hardware { 35 namespace audio { 36 namespace V2_0 { 37 namespace implementation { 38 39 using ::android::hardware::audio::common::V2_0::AudioChannelMask; 40 using ::android::hardware::audio::common::V2_0::AudioDevice; 41 using ::android::hardware::audio::common::V2_0::AudioFormat; 42 using ::android::hardware::audio::V2_0::AudioDrain; 43 using ::android::hardware::audio::V2_0::DeviceAddress; 44 using ::android::hardware::audio::V2_0::IStream; 45 using ::android::hardware::audio::V2_0::IStreamOut; 46 using ::android::hardware::audio::V2_0::IStreamOutCallback; 47 using ::android::hardware::audio::V2_0::ParameterValue; 48 using ::android::hardware::audio::V2_0::Result; 49 using ::android::hardware::audio::V2_0::TimeSpec; 50 using ::android::hardware::Return; 51 using ::android::hardware::Void; 52 using ::android::hardware::hidl_vec; 53 using ::android::hardware::hidl_string; 54 using ::android::sp; 55 56 struct StreamOut : public IStreamOut { 57 typedef MessageQueue<WriteCommand, kSynchronizedReadWrite> CommandMQ; 58 typedef MessageQueue<uint8_t, kSynchronizedReadWrite> DataMQ; 59 typedef MessageQueue<WriteStatus, kSynchronizedReadWrite> StatusMQ; 60 61 StreamOut(const sp<Device>& device, audio_stream_out_t* stream); 62 63 // Methods from ::android::hardware::audio::V2_0::IStream follow. 64 Return<uint64_t> getFrameSize() override; 65 Return<uint64_t> getFrameCount() override; 66 Return<uint64_t> getBufferSize() override; 67 Return<uint32_t> getSampleRate() override; 68 Return<void> getSupportedSampleRates(getSupportedSampleRates_cb _hidl_cb) override; 69 Return<Result> setSampleRate(uint32_t sampleRateHz) override; 70 Return<AudioChannelMask> getChannelMask() override; 71 Return<void> getSupportedChannelMasks(getSupportedChannelMasks_cb _hidl_cb) override; 72 Return<Result> setChannelMask(AudioChannelMask mask) override; 73 Return<AudioFormat> getFormat() override; 74 Return<void> getSupportedFormats(getSupportedFormats_cb _hidl_cb) override; 75 Return<Result> setFormat(AudioFormat format) override; 76 Return<void> getAudioProperties(getAudioProperties_cb _hidl_cb) override; 77 Return<Result> addEffect(uint64_t effectId) override; 78 Return<Result> removeEffect(uint64_t effectId) override; 79 Return<Result> standby() override; 80 Return<AudioDevice> getDevice() override; 81 Return<Result> setDevice(const DeviceAddress& address) override; 82 Return<Result> setConnectedState(const DeviceAddress& address, bool connected) override; 83 Return<Result> setHwAvSync(uint32_t hwAvSync) override; 84 Return<void> getParameters( 85 const hidl_vec<hidl_string>& keys, getParameters_cb _hidl_cb) override; 86 Return<Result> setParameters(const hidl_vec<ParameterValue>& parameters) override; 87 Return<void> debugDump(const hidl_handle& fd) override; 88 Return<Result> close() override; 89 90 // Methods from ::android::hardware::audio::V2_0::IStreamOut follow. 91 Return<uint32_t> getLatency() override; 92 Return<Result> setVolume(float left, float right) override; 93 Return<void> prepareForWriting( 94 uint32_t frameSize, uint32_t framesCount, prepareForWriting_cb _hidl_cb) override; 95 Return<void> getRenderPosition(getRenderPosition_cb _hidl_cb) override; 96 Return<void> getNextWriteTimestamp(getNextWriteTimestamp_cb _hidl_cb) override; 97 Return<Result> setCallback(const sp<IStreamOutCallback>& callback) override; 98 Return<Result> clearCallback() override; 99 Return<void> supportsPauseAndResume(supportsPauseAndResume_cb _hidl_cb) override; 100 Return<Result> pause() override; 101 Return<Result> resume() override; 102 Return<bool> supportsDrain() override; 103 Return<Result> drain(AudioDrain type) override; 104 Return<Result> flush() override; 105 Return<void> getPresentationPosition(getPresentationPosition_cb _hidl_cb) override; 106 Return<Result> start() override; 107 Return<Result> stop() override; 108 Return<void> createMmapBuffer(int32_t minSizeFrames, createMmapBuffer_cb _hidl_cb) override; 109 Return<void> getMmapPosition(getMmapPosition_cb _hidl_cb) override; 110 111 static Result getPresentationPositionImpl( 112 audio_stream_out_t *stream, uint64_t *frames, TimeSpec *timeStamp); 113 114 private: 115 bool mIsClosed; 116 const sp<Device> mDevice; 117 audio_stream_out_t *mStream; 118 const sp<Stream> mStreamCommon; 119 const sp<StreamMmap<audio_stream_out_t>> mStreamMmap; 120 sp<IStreamOutCallback> mCallback; 121 std::unique_ptr<CommandMQ> mCommandMQ; 122 std::unique_ptr<DataMQ> mDataMQ; 123 std::unique_ptr<StatusMQ> mStatusMQ; 124 EventFlag* mEfGroup; 125 std::atomic<bool> mStopWriteThread; 126 sp<Thread> mWriteThread; 127 128 virtual ~StreamOut(); 129 130 static int asyncCallback(stream_callback_event_t event, void *param, void *cookie); 131 }; 132 133 } // namespace implementation 134 } // namespace V2_0 135 } // namespace audio 136 } // namespace hardware 137 } // namespace android 138 139 #endif // ANDROID_HARDWARE_AUDIO_V2_0_STREAMOUT_H 140