1 /* 2 * Copyright (C) 2017 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef AAUDIO_AAUDIO_SERVICE_STREAM_MMAP_H 18 #define AAUDIO_AAUDIO_SERVICE_STREAM_MMAP_H 19 20 #include <atomic> 21 22 #include <android-base/thread_annotations.h> 23 #include <android-base/unique_fd.h> 24 #include <media/audiohal/StreamHalInterface.h> 25 #include <media/MmapStreamCallback.h> 26 #include <media/MmapStreamInterface.h> 27 #include <utils/RefBase.h> 28 #include <utils/String16.h> 29 #include <utils/Vector.h> 30 31 #include "binding/AAudioServiceMessage.h" 32 #include "AAudioServiceStreamBase.h" 33 #include "binding/AudioEndpointParcelable.h" 34 #include "SharedMemoryProxy.h" 35 #include "TimestampScheduler.h" 36 #include "utility/MonotonicCounter.h" 37 38 namespace aaudio { 39 40 /** 41 * These corresponds to an EXCLUSIVE mode MMAP client stream. 42 * It has exclusive use of one AAudioServiceEndpointMMAP to communicate with the underlying 43 * device or port. 44 */ 45 class AAudioServiceStreamMMAP : public AAudioServiceStreamBase { 46 47 public: 48 AAudioServiceStreamMMAP(android::AAudioService &aAudioService, 49 bool inService); 50 ~AAudioServiceStreamMMAP() override = default; 51 52 aaudio_result_t open(const aaudio::AAudioStreamRequest &request) override 53 EXCLUDES(mUpMessageQueueLock); 54 55 aaudio_result_t startClient(const android::AudioClient& client, 56 const audio_attributes_t *attr, 57 audio_port_handle_t *clientHandle) override; 58 59 aaudio_result_t stopClient(audio_port_handle_t clientHandle) override; 60 getTypeText()61 const char *getTypeText() const override { return "MMAP"; } 62 63 protected: 64 65 /** 66 * Stop the flow of data so that start() can resume without loss of data. 67 * 68 * This is not guaranteed to be synchronous but it currently is. 69 * An AAUDIO_SERVICE_EVENT_PAUSED will be sent to the client when complete. 70 */ 71 aaudio_result_t pause_l() REQUIRES(mLock) override; 72 73 aaudio_result_t stop_l() REQUIRES(mLock) override; 74 75 aaudio_result_t standby_l() REQUIRES(mLock) override; isStandbyImplemented()76 bool isStandbyImplemented() override { 77 return true; 78 } 79 80 aaudio_result_t exitStandby_l(AudioEndpointParcelable* parcelable) REQUIRES(mLock) override; 81 82 aaudio_result_t getAudioDataDescription_l( 83 AudioEndpointParcelable* parcelable) REQUIRES(mLock) override; 84 85 aaudio_result_t getFreeRunningPosition_l(int64_t *positionFrames, 86 int64_t *timeNanos) REQUIRES(mLock) override; 87 88 aaudio_result_t getHardwareTimestamp_l( 89 int64_t *positionFrames, int64_t *timeNanos) REQUIRES(mLock) override; 90 91 int64_t nextDataReportTime_l() REQUIRES(mLock) override; 92 93 void reportData_l() REQUIRES(mLock) override; 94 95 /** 96 * Device specific startup. 97 * @return AAUDIO_OK or negative error. 98 */ 99 aaudio_result_t startDevice_l() REQUIRES(mLock) override; 100 101 aaudio_result_t startClient_l(const android::AudioClient& client, 102 const audio_attributes_t *attr, 103 audio_port_handle_t *clientHandle) REQUIRES(mLock) override; 104 105 aaudio_result_t stopClient_l(audio_port_handle_t clientHandle) REQUIRES(mLock) override; 106 107 private: 108 109 bool mInService = false; 110 }; 111 112 } // namespace aaudio 113 114 #endif //AAUDIO_AAUDIO_SERVICE_STREAM_MMAP_H 115