1 /*
2  * Copyright (C) 2017 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #define LOG_TAG "AAudioServiceEndpoint"
18 //#define LOG_NDEBUG 0
19 #include <utils/Log.h>
20 
21 #include <algorithm>
22 #include <assert.h>
23 #include <map>
24 #include <mutex>
25 #include <sstream>
26 #include <vector>
27 
28 #include <utils/Singleton.h>
29 
30 
31 #include "core/AudioStreamBuilder.h"
32 
33 #include "AAudioEndpointManager.h"
34 #include "AAudioClientTracker.h"
35 #include "AAudioServiceEndpoint.h"
36 #include "AAudioServiceStreamShared.h"
37 
38 using namespace android;  // TODO just import names needed
39 using namespace aaudio;   // TODO just import names needed
40 
dump() const41 std::string AAudioServiceEndpoint::dump() const {
42     std::stringstream result;
43 
44     const bool isLocked = AAudio_tryUntilTrue(
45             [this]()->bool { return mLockStreams.try_lock(); } /* f */,
46             50 /* times */,
47             20 /* sleepMs */);
48     if (!isLocked) {
49         result << "AAudioServiceEndpoint may be deadlocked\n";
50     }
51 
52     result << "    Direction:            " << ((getDirection() == AAUDIO_DIRECTION_OUTPUT)
53                                    ? "OUTPUT" : "INPUT") << "\n";
54     result << "    Requested Device Id:  " << mRequestedDeviceId << "\n";
55     result << "    Device Id:            " << getDeviceId() << "\n";
56     result << "    Sample Rate:          " << getSampleRate() << "\n";
57     result << "    Channel Count:        " << getSamplesPerFrame() << "\n";
58     result << "    Format:               " << getFormat() << "\n";
59     result << "    Frames Per Burst:     " << mFramesPerBurst << "\n";
60     result << "    Usage:                " << getUsage() << "\n";
61     result << "    ContentType:          " << getContentType() << "\n";
62     result << "    InputPreset:          " << getInputPreset() << "\n";
63     result << "    Reference Count:      " << mOpenCount << "\n";
64     result << "    Session Id:           " << getSessionId() << "\n";
65     result << "    Privacy Sensitive:    " << isPrivacySensitive() << "\n";
66     result << "    Connected:            " << mConnected.load() << "\n";
67     result << "    Registered Streams:" << "\n";
68     result << AAudioServiceStreamShared::dumpHeader() << "\n";
69     for (const auto& stream : mRegisteredStreams) {
70         result << stream->dump() << "\n";
71     }
72 
73     if (isLocked) {
74         mLockStreams.unlock();
75     }
76     return result.str();
77 }
78 
79 // @return true if stream found
isStreamRegistered(audio_port_handle_t portHandle)80 bool AAudioServiceEndpoint::isStreamRegistered(audio_port_handle_t portHandle) {
81     std::lock_guard<std::mutex> lock(mLockStreams);
82     for (const auto& stream : mRegisteredStreams) {
83         if (stream->getPortHandle() == portHandle) {
84             return true;
85         }
86     }
87     return false;
88 }
89 
90 std::vector<android::sp<AAudioServiceStreamBase>>
disconnectRegisteredStreams()91         AAudioServiceEndpoint::disconnectRegisteredStreams() {
92     std::vector<android::sp<AAudioServiceStreamBase>> streamsDisconnected;
93     {
94         std::lock_guard<std::mutex> lock(mLockStreams);
95         mRegisteredStreams.swap(streamsDisconnected);
96     }
97     mConnected.store(false);
98     // We need to stop all the streams before we disconnect them.
99     // Otherwise there is a race condition where the first disconnected app
100     // tries to reopen a stream as MMAP but is blocked by the second stream,
101     // which hasn't stopped yet. Then the first app ends up with a Legacy stream.
102     for (const auto &stream : streamsDisconnected) {
103         ALOGD("%s() - stop(), port = %d", __func__, stream->getPortHandle());
104         stream->stop();
105     }
106     for (const auto &stream : streamsDisconnected) {
107         ALOGD("%s() - disconnect(), port = %d", __func__, stream->getPortHandle());
108         stream->disconnect();
109     }
110     return streamsDisconnected;
111 }
112 
releaseRegisteredStreams()113 void AAudioServiceEndpoint::releaseRegisteredStreams() {
114     // List of streams to be closed after we disconnect everything.
115     std::vector<android::sp<AAudioServiceStreamBase>> streamsToClose
116             = disconnectRegisteredStreams();
117 
118     // Close outside the lock to avoid recursive locks.
119     AAudioService *aaudioService = AAudioClientTracker::getInstance().getAAudioService();
120     for (const auto& serviceStream : streamsToClose) {
121         ALOGD("%s() - close stream 0x%08X", __func__, serviceStream->getHandle());
122         aaudioService->closeStream(serviceStream);
123     }
124 }
125 
registerStream(sp<AAudioServiceStreamBase> stream)126 aaudio_result_t AAudioServiceEndpoint::registerStream(sp<AAudioServiceStreamBase>stream) {
127     std::lock_guard<std::mutex> lock(mLockStreams);
128     mRegisteredStreams.push_back(stream);
129     return AAUDIO_OK;
130 }
131 
unregisterStream(sp<AAudioServiceStreamBase> stream)132 aaudio_result_t AAudioServiceEndpoint::unregisterStream(sp<AAudioServiceStreamBase>stream) {
133     std::lock_guard<std::mutex> lock(mLockStreams);
134     mRegisteredStreams.erase(std::remove(
135             mRegisteredStreams.begin(), mRegisteredStreams.end(), stream),
136                              mRegisteredStreams.end());
137     return AAUDIO_OK;
138 }
139 
matches(const AAudioStreamConfiguration & configuration)140 bool AAudioServiceEndpoint::matches(const AAudioStreamConfiguration& configuration) {
141     if (!mConnected.load()) {
142         return false; // Only use an endpoint if it is connected to a device.
143     }
144     if (configuration.getDirection() != getDirection()) {
145         return false;
146     }
147     if (configuration.getDeviceId() != AAUDIO_UNSPECIFIED &&
148         configuration.getDeviceId() != getDeviceId()) {
149         return false;
150     }
151     if (configuration.getSessionId() != AAUDIO_SESSION_ID_ALLOCATE &&
152         configuration.getSessionId() != getSessionId()) {
153         return false;
154     }
155     if (configuration.getSampleRate() != AAUDIO_UNSPECIFIED &&
156         configuration.getSampleRate() != getSampleRate()) {
157         return false;
158     }
159     if (configuration.getSamplesPerFrame() != AAUDIO_UNSPECIFIED &&
160         configuration.getSamplesPerFrame() != getSamplesPerFrame()) {
161         return false;
162     }
163     return true;
164 }
165 
166 // static
getAudioAttributesFrom(const AAudioStreamParameters * params)167 audio_attributes_t AAudioServiceEndpoint::getAudioAttributesFrom(
168         const AAudioStreamParameters *params) {
169     if (params == nullptr) {
170         return {};
171     }
172     const aaudio_direction_t direction = params->getDirection();
173 
174     const audio_content_type_t contentType =
175             AAudioConvert_contentTypeToInternal(params->getContentType());
176     // Usage only used for OUTPUT
177     const audio_usage_t usage = (direction == AAUDIO_DIRECTION_OUTPUT)
178             ? AAudioConvert_usageToInternal(params->getUsage())
179             : AUDIO_USAGE_UNKNOWN;
180     const audio_source_t source = (direction == AAUDIO_DIRECTION_INPUT)
181             ? AAudioConvert_inputPresetToAudioSource(params->getInputPreset())
182             : AUDIO_SOURCE_DEFAULT;
183     audio_flags_mask_t flags;
184     if (direction == AAUDIO_DIRECTION_OUTPUT) {
185         flags = AUDIO_FLAG_LOW_LATENCY
186             | AAudioConvert_allowCapturePolicyToAudioFlagsMask(params->getAllowedCapturePolicy());
187     } else {
188         flags = AUDIO_FLAG_LOW_LATENCY
189             | AAudioConvert_privacySensitiveToAudioFlagsMask(params->isPrivacySensitive());
190     }
191     return {
192             .content_type = contentType,
193             .usage = usage,
194             .source = source,
195             .flags = flags,
196             .tags = "" };
197 }
198