blob: c25a1524f36b6a2e8a03322135c7a6a51a1c47ec [file] [log] [blame]
Phil Burk2355edb2016-12-26 13:54:02 -08001/*
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
Eric Laurentcb4dae22017-07-01 19:39:32 -070017#define LOG_TAG "AAudioServiceStreamBase"
Phil Burk2355edb2016-12-26 13:54:02 -080018//#define LOG_NDEBUG 0
19#include <utils/Log.h>
20
Phil Burka5222e22017-07-28 13:31:14 -070021#include <iomanip>
22#include <iostream>
Phil Burkc0c70e32017-02-09 13:18:38 -080023#include <mutex>
Phil Burk2355edb2016-12-26 13:54:02 -080024
Phil Burka9876702020-04-20 18:16:15 -070025#include <media/MediaMetricsItem.h>
26#include <media/TypeConverter.h>
Phil Burk7ebbc112020-05-13 15:55:17 -070027#include <mediautils/SchedulingPolicyService.h>
Phil Burka9876702020-04-20 18:16:15 -070028
Phil Burkc0c70e32017-02-09 13:18:38 -080029#include "binding/AAudioServiceMessage.h"
Phil Burka9876702020-04-20 18:16:15 -070030#include "core/AudioGlobal.h"
Phil Burkc0c70e32017-02-09 13:18:38 -080031#include "utility/AudioClock.h"
32
Phil Burk39f02dd2017-08-04 09:13:31 -070033#include "AAudioEndpointManager.h"
34#include "AAudioService.h"
35#include "AAudioServiceEndpoint.h"
Phil Burkc0c70e32017-02-09 13:18:38 -080036#include "AAudioServiceStreamBase.h"
37#include "TimestampScheduler.h"
38
39using namespace android; // TODO just import names needed
40using namespace aaudio; // TODO just import names needed
Phil Burk2355edb2016-12-26 13:54:02 -080041
Philip P. Moltmannbda45752020-07-17 16:41:18 -070042using media::permission::Identity;
43
Phil Burk2355edb2016-12-26 13:54:02 -080044/**
Phil Burkc0c70e32017-02-09 13:18:38 -080045 * Base class for streams in the service.
46 * @return
Phil Burk2355edb2016-12-26 13:54:02 -080047 */
48
Phil Burk39f02dd2017-08-04 09:13:31 -070049AAudioServiceStreamBase::AAudioServiceStreamBase(AAudioService &audioService)
Phil Burk8f4fe502020-07-15 23:54:50 +000050 : mTimestampThread("AATime")
Phil Burka53ffa62018-10-10 16:21:37 -070051 , mAtomicStreamTimestamp()
Phil Burk39f02dd2017-08-04 09:13:31 -070052 , mAudioService(audioService) {
Philip P. Moltmannbda45752020-07-17 16:41:18 -070053 mMmapClient.identity = Identity();
Phil Burk2355edb2016-12-26 13:54:02 -080054}
55
Phil Burk5ed503c2017-02-01 09:38:15 -080056AAudioServiceStreamBase::~AAudioServiceStreamBase() {
Phil Burk8f4fe502020-07-15 23:54:50 +000057 ALOGD("%s() called", __func__);
58
Phil Burka9876702020-04-20 18:16:15 -070059 // May not be set if open failed.
60 if (mMetricsId.size() > 0) {
61 mediametrics::LogItem(mMetricsId)
62 .set(AMEDIAMETRICS_PROP_EVENT, AMEDIAMETRICS_PROP_EVENT_VALUE_DTOR)
63 .set(AMEDIAMETRICS_PROP_STATE, AudioGlobal_convertStreamStateToText(getState()))
64 .record();
65 }
66
Phil Burk5a26e662017-07-07 12:44:48 -070067 // If the stream is deleted when OPEN or in use then audio resources will leak.
68 // This would indicate an internal error. So we want to find this ASAP.
Phil Burkbcc36742017-08-31 17:24:51 -070069 LOG_ALWAYS_FATAL_IF(!(getState() == AAUDIO_STREAM_STATE_CLOSED
70 || getState() == AAUDIO_STREAM_STATE_UNINITIALIZED
71 || getState() == AAUDIO_STREAM_STATE_DISCONNECTED),
Phil Burk8b4e05e2019-12-17 12:12:09 -080072 "service stream %p still open, state = %d",
73 this, getState());
Phil Burk2355edb2016-12-26 13:54:02 -080074}
75
Phil Burka5222e22017-07-28 13:31:14 -070076std::string AAudioServiceStreamBase::dumpHeader() {
Phil Burkbbd52862018-04-13 11:37:42 -070077 return std::string(" T Handle UId Port Run State Format Burst Chan Capacity");
Phil Burka5222e22017-07-28 13:31:14 -070078}
79
Phil Burk4501b352017-06-29 18:12:36 -070080std::string AAudioServiceStreamBase::dump() const {
81 std::stringstream result;
82
Phil Burka5222e22017-07-28 13:31:14 -070083 result << " 0x" << std::setfill('0') << std::setw(8) << std::hex << mHandle
84 << std::dec << std::setfill(' ') ;
Philip P. Moltmannbda45752020-07-17 16:41:18 -070085 result << std::setw(6) << mMmapClient.identity.uid;
Phil Burkbbd52862018-04-13 11:37:42 -070086 result << std::setw(7) << mClientHandle;
Phil Burka5222e22017-07-28 13:31:14 -070087 result << std::setw(4) << (isRunning() ? "yes" : " no");
Phil Burkbcc36742017-08-31 17:24:51 -070088 result << std::setw(6) << getState();
Phil Burk39f02dd2017-08-04 09:13:31 -070089 result << std::setw(7) << getFormat();
Phil Burka5222e22017-07-28 13:31:14 -070090 result << std::setw(6) << mFramesPerBurst;
Phil Burk39f02dd2017-08-04 09:13:31 -070091 result << std::setw(5) << getSamplesPerFrame();
92 result << std::setw(9) << getBufferCapacity();
Phil Burk4501b352017-06-29 18:12:36 -070093
94 return result.str();
95}
96
Phil Burka9876702020-04-20 18:16:15 -070097void AAudioServiceStreamBase::logOpen(aaudio_handle_t streamHandle) {
98 // This is the first log sent from the AAudio Service for a stream.
99 mMetricsId = std::string(AMEDIAMETRICS_KEY_PREFIX_AUDIO_STREAM)
100 + std::to_string(streamHandle);
101
102 audio_attributes_t attributes = AAudioServiceEndpoint::getAudioAttributesFrom(this);
103
104 // Once this item is logged by the server, the client with the same PID, UID
105 // can also log properties.
106 mediametrics::LogItem(mMetricsId)
107 .setPid(getOwnerProcessId())
108 .setUid(getOwnerUserId())
Andy Hungd203eb62020-04-27 09:12:46 -0700109 .set(AMEDIAMETRICS_PROP_ALLOWUID, (int32_t)getOwnerUserId())
Phil Burka9876702020-04-20 18:16:15 -0700110 .set(AMEDIAMETRICS_PROP_EVENT, AMEDIAMETRICS_PROP_EVENT_VALUE_OPEN)
111 // the following are immutable
112 .set(AMEDIAMETRICS_PROP_BUFFERCAPACITYFRAMES, (int32_t)getBufferCapacity())
113 .set(AMEDIAMETRICS_PROP_BURSTFRAMES, (int32_t)getFramesPerBurst())
114 .set(AMEDIAMETRICS_PROP_CHANNELCOUNT, (int32_t)getSamplesPerFrame())
115 .set(AMEDIAMETRICS_PROP_CONTENTTYPE, toString(attributes.content_type).c_str())
116 .set(AMEDIAMETRICS_PROP_DIRECTION,
117 AudioGlobal_convertDirectionToText(getDirection()))
118 .set(AMEDIAMETRICS_PROP_ENCODING, toString(getFormat()).c_str())
119 .set(AMEDIAMETRICS_PROP_ROUTEDDEVICEID, (int32_t)getDeviceId())
120 .set(AMEDIAMETRICS_PROP_SAMPLERATE, (int32_t)getSampleRate())
121 .set(AMEDIAMETRICS_PROP_SESSIONID, (int32_t)getSessionId())
122 .set(AMEDIAMETRICS_PROP_SOURCE, toString(attributes.source).c_str())
123 .set(AMEDIAMETRICS_PROP_USAGE, toString(attributes.usage).c_str())
124 .record();
125}
126
Phil Burk15f97c92018-09-04 14:06:27 -0700127aaudio_result_t AAudioServiceStreamBase::open(const aaudio::AAudioStreamRequest &request) {
Phil Burk39f02dd2017-08-04 09:13:31 -0700128 AAudioEndpointManager &mEndpointManager = AAudioEndpointManager::getInstance();
129 aaudio_result_t result = AAUDIO_OK;
Eric Laurentcb4dae22017-07-01 19:39:32 -0700130
Philip P. Moltmannbda45752020-07-17 16:41:18 -0700131 mMmapClient.identity = request.getIdentity();
132 // TODO b/182392769: use identity util
133 mMmapClient.identity.uid = VALUE_OR_FATAL(
134 legacy2aidl_uid_t_int32_t(IPCThreadState::self()->getCallingUid()));
135 mMmapClient.identity.pid = VALUE_OR_FATAL(
136 legacy2aidl_pid_t_int32_t(IPCThreadState::self()->getCallingPid()));
Eric Laurentcb4dae22017-07-01 19:39:32 -0700137
Phil Burk39f02dd2017-08-04 09:13:31 -0700138 // Limit scope of lock to avoid recursive lock in close().
139 {
140 std::lock_guard<std::mutex> lock(mUpMessageQueueLock);
141 if (mUpMessageQueue != nullptr) {
Phil Burk19e990e2018-03-22 13:59:34 -0700142 ALOGE("%s() called twice", __func__);
Phil Burk39f02dd2017-08-04 09:13:31 -0700143 return AAUDIO_ERROR_INVALID_STATE;
144 }
145
Phil Burk8f4fe502020-07-15 23:54:50 +0000146 mUpMessageQueue = std::make_shared<SharedRingBuffer>();
Phil Burk39f02dd2017-08-04 09:13:31 -0700147 result = mUpMessageQueue->allocate(sizeof(AAudioServiceMessage),
148 QUEUE_UP_CAPACITY_COMMANDS);
149 if (result != AAUDIO_OK) {
150 goto error;
151 }
152
Phil Burk6e2770e2018-05-01 13:03:52 -0700153 // This is not protected by a lock because the stream cannot be
154 // referenced until the service returns a handle to the client.
155 // So only one thread can open a stream.
Phil Burk39f02dd2017-08-04 09:13:31 -0700156 mServiceEndpoint = mEndpointManager.openEndpoint(mAudioService,
Phil Burk15f97c92018-09-04 14:06:27 -0700157 request);
Phil Burk39f02dd2017-08-04 09:13:31 -0700158 if (mServiceEndpoint == nullptr) {
Phil Burk39f02dd2017-08-04 09:13:31 -0700159 result = AAUDIO_ERROR_UNAVAILABLE;
160 goto error;
161 }
Phil Burk6e2770e2018-05-01 13:03:52 -0700162 // Save a weak pointer that we will use to access the endpoint.
163 mServiceEndpointWeak = mServiceEndpoint;
164
Phil Burk39f02dd2017-08-04 09:13:31 -0700165 mFramesPerBurst = mServiceEndpoint->getFramesPerBurst();
166 copyFrom(*mServiceEndpoint);
Phil Burkc0c70e32017-02-09 13:18:38 -0800167 }
Phil Burk39f02dd2017-08-04 09:13:31 -0700168 return result;
169
170error:
171 close();
172 return result;
Phil Burkc0c70e32017-02-09 13:18:38 -0800173}
Phil Burkdec33ab2017-01-17 14:48:16 -0800174
Phil Burkc0c70e32017-02-09 13:18:38 -0800175aaudio_result_t AAudioServiceStreamBase::close() {
Phil Burk7ebbc112020-05-13 15:55:17 -0700176 std::lock_guard<std::mutex> lock(mLock);
177 return close_l();
178}
179
180aaudio_result_t AAudioServiceStreamBase::close_l() {
Phil Burkbcc36742017-08-31 17:24:51 -0700181 if (getState() == AAUDIO_STREAM_STATE_CLOSED) {
Phil Burk39f02dd2017-08-04 09:13:31 -0700182 return AAUDIO_OK;
183 }
184
Phil Burk8f4fe502020-07-15 23:54:50 +0000185 // This will call stopTimestampThread() and also stop the stream,
186 // just in case it was not already stopped.
Phil Burk7ebbc112020-05-13 15:55:17 -0700187 stop_l();
Phil Burk39f02dd2017-08-04 09:13:31 -0700188
Phil Burk8b4e05e2019-12-17 12:12:09 -0800189 aaudio_result_t result = AAUDIO_OK;
Phil Burk6e2770e2018-05-01 13:03:52 -0700190 sp<AAudioServiceEndpoint> endpoint = mServiceEndpointWeak.promote();
191 if (endpoint == nullptr) {
Phil Burk39f02dd2017-08-04 09:13:31 -0700192 result = AAUDIO_ERROR_INVALID_STATE;
193 } else {
Phil Burk6e2770e2018-05-01 13:03:52 -0700194 endpoint->unregisterStream(this);
195 AAudioEndpointManager &endpointManager = AAudioEndpointManager::getInstance();
196 endpointManager.closeEndpoint(endpoint);
197
198 // AAudioService::closeStream() prevents two threads from closing at the same time.
Phil Burk7ebbc112020-05-13 15:55:17 -0700199 mServiceEndpoint.clear(); // endpoint will hold the pointer after this method returns.
Phil Burk39f02dd2017-08-04 09:13:31 -0700200 }
201
Phil Burkbcc36742017-08-31 17:24:51 -0700202 setState(AAUDIO_STREAM_STATE_CLOSED);
Phil Burka9876702020-04-20 18:16:15 -0700203
204 mediametrics::LogItem(mMetricsId)
205 .set(AMEDIAMETRICS_PROP_EVENT, AMEDIAMETRICS_PROP_EVENT_VALUE_CLOSE)
206 .record();
Phil Burk39f02dd2017-08-04 09:13:31 -0700207 return result;
Phil Burkc0c70e32017-02-09 13:18:38 -0800208}
209
Phil Burkbcc36742017-08-31 17:24:51 -0700210aaudio_result_t AAudioServiceStreamBase::startDevice() {
211 mClientHandle = AUDIO_PORT_HANDLE_NONE;
Phil Burk6e2770e2018-05-01 13:03:52 -0700212 sp<AAudioServiceEndpoint> endpoint = mServiceEndpointWeak.promote();
213 if (endpoint == nullptr) {
214 ALOGE("%s() has no endpoint", __func__);
215 return AAUDIO_ERROR_INVALID_STATE;
216 }
217 return endpoint->startStream(this, &mClientHandle);
Phil Burkbcc36742017-08-31 17:24:51 -0700218}
219
Phil Burk39f02dd2017-08-04 09:13:31 -0700220/**
221 * Start the flow of audio data.
222 *
223 * An AAUDIO_SERVICE_EVENT_STARTED will be sent to the client when complete.
224 */
Phil Burkc0c70e32017-02-09 13:18:38 -0800225aaudio_result_t AAudioServiceStreamBase::start() {
Phil Burk7ebbc112020-05-13 15:55:17 -0700226 std::lock_guard<std::mutex> lock(mLock);
227
Phil Burka9876702020-04-20 18:16:15 -0700228 const int64_t beginNs = AudioClock::getNanoseconds();
Phil Burkbcc36742017-08-31 17:24:51 -0700229 aaudio_result_t result = AAUDIO_OK;
Phil Burk6e2770e2018-05-01 13:03:52 -0700230
Phil Burk7ebbc112020-05-13 15:55:17 -0700231 if (auto state = getState();
232 state == AAUDIO_STREAM_STATE_CLOSED || state == AAUDIO_STREAM_STATE_DISCONNECTED) {
233 ALOGW("%s() already CLOSED, returns INVALID_STATE, handle = %d",
234 __func__, getHandle());
235 return AAUDIO_ERROR_INVALID_STATE;
236 }
237
Phil Burka9876702020-04-20 18:16:15 -0700238 mediametrics::Defer defer([&] {
239 mediametrics::LogItem(mMetricsId)
240 .set(AMEDIAMETRICS_PROP_EVENT, AMEDIAMETRICS_PROP_EVENT_VALUE_START)
Andy Hungea840382020-05-05 21:50:17 -0700241 .set(AMEDIAMETRICS_PROP_EXECUTIONTIMENS, (int64_t)(AudioClock::getNanoseconds() - beginNs))
Phil Burka9876702020-04-20 18:16:15 -0700242 .set(AMEDIAMETRICS_PROP_STATE, AudioGlobal_convertStreamStateToText(getState()))
243 .set(AMEDIAMETRICS_PROP_STATUS, (int32_t)result)
244 .record(); });
245
Eric Laurentcb4dae22017-07-01 19:39:32 -0700246 if (isRunning()) {
Phil Burk7ebbc112020-05-13 15:55:17 -0700247 return result;
Eric Laurentcb4dae22017-07-01 19:39:32 -0700248 }
Phil Burk39f02dd2017-08-04 09:13:31 -0700249
Phil Burk23296382017-11-20 15:45:11 -0800250 setFlowing(false);
Phil Burk762365c2018-12-10 16:02:16 -0800251 setSuspended(false);
Phil Burk23296382017-11-20 15:45:11 -0800252
Phil Burkbcc36742017-08-31 17:24:51 -0700253 // Start with fresh presentation timestamps.
Phil Burka53ffa62018-10-10 16:21:37 -0700254 mAtomicStreamTimestamp.clear();
Phil Burkbcc36742017-08-31 17:24:51 -0700255
Phil Burk39f02dd2017-08-04 09:13:31 -0700256 mClientHandle = AUDIO_PORT_HANDLE_NONE;
Phil Burkbcc36742017-08-31 17:24:51 -0700257 result = startDevice();
258 if (result != AAUDIO_OK) goto error;
259
260 // This should happen at the end of the start.
261 sendServiceEvent(AAUDIO_SERVICE_EVENT_STARTED);
262 setState(AAUDIO_STREAM_STATE_STARTED);
263 mThreadEnabled.store(true);
264 result = mTimestampThread.start(this);
265 if (result != AAUDIO_OK) goto error;
266
267 return result;
268
269error:
Phil Burk7ebbc112020-05-13 15:55:17 -0700270 disconnect_l();
Phil Burk39f02dd2017-08-04 09:13:31 -0700271 return result;
Phil Burkc0c70e32017-02-09 13:18:38 -0800272}
273
274aaudio_result_t AAudioServiceStreamBase::pause() {
Phil Burk7ebbc112020-05-13 15:55:17 -0700275 std::lock_guard<std::mutex> lock(mLock);
276 return pause_l();
277}
278
279aaudio_result_t AAudioServiceStreamBase::pause_l() {
Phil Burk11e8d332017-05-24 09:59:02 -0700280 aaudio_result_t result = AAUDIO_OK;
Eric Laurentcb4dae22017-07-01 19:39:32 -0700281 if (!isRunning()) {
282 return result;
Phil Burkc0c70e32017-02-09 13:18:38 -0800283 }
Phil Burk7ebbc112020-05-13 15:55:17 -0700284 const int64_t beginNs = AudioClock::getNanoseconds();
Phil Burk73af62a2017-10-26 12:11:47 -0700285
Phil Burka9876702020-04-20 18:16:15 -0700286 mediametrics::Defer defer([&] {
287 mediametrics::LogItem(mMetricsId)
288 .set(AMEDIAMETRICS_PROP_EVENT, AMEDIAMETRICS_PROP_EVENT_VALUE_PAUSE)
Andy Hungea840382020-05-05 21:50:17 -0700289 .set(AMEDIAMETRICS_PROP_EXECUTIONTIMENS, (int64_t)(AudioClock::getNanoseconds() - beginNs))
Phil Burka9876702020-04-20 18:16:15 -0700290 .set(AMEDIAMETRICS_PROP_STATE, AudioGlobal_convertStreamStateToText(getState()))
291 .set(AMEDIAMETRICS_PROP_STATUS, (int32_t)result)
292 .record(); });
293
Phil Burk73af62a2017-10-26 12:11:47 -0700294 result = stopTimestampThread();
295 if (result != AAUDIO_OK) {
Phil Burk7ebbc112020-05-13 15:55:17 -0700296 disconnect_l();
Phil Burk73af62a2017-10-26 12:11:47 -0700297 return result;
298 }
299
Phil Burk6e2770e2018-05-01 13:03:52 -0700300 sp<AAudioServiceEndpoint> endpoint = mServiceEndpointWeak.promote();
301 if (endpoint == nullptr) {
302 ALOGE("%s() has no endpoint", __func__);
Phil Burka9876702020-04-20 18:16:15 -0700303 result = AAUDIO_ERROR_INVALID_STATE; // for MediaMetric tracking
304 return result;
Phil Burk6e2770e2018-05-01 13:03:52 -0700305 }
306 result = endpoint->stopStream(this, mClientHandle);
Phil Burk39f02dd2017-08-04 09:13:31 -0700307 if (result != AAUDIO_OK) {
Phil Burk19e990e2018-03-22 13:59:34 -0700308 ALOGE("%s() mServiceEndpoint returned %d, %s", __func__, result, getTypeText());
Phil Burk7ebbc112020-05-13 15:55:17 -0700309 disconnect_l(); // TODO should we return or pause Base first?
Phil Burk39f02dd2017-08-04 09:13:31 -0700310 }
311
Eric Laurentcb4dae22017-07-01 19:39:32 -0700312 sendServiceEvent(AAUDIO_SERVICE_EVENT_PAUSED);
Phil Burkbcc36742017-08-31 17:24:51 -0700313 setState(AAUDIO_STREAM_STATE_PAUSED);
Phil Burkc0c70e32017-02-09 13:18:38 -0800314 return result;
315}
316
Phil Burk71f35bb2017-04-13 16:05:07 -0700317aaudio_result_t AAudioServiceStreamBase::stop() {
Phil Burk7ebbc112020-05-13 15:55:17 -0700318 std::lock_guard<std::mutex> lock(mLock);
319 return stop_l();
320}
321
322aaudio_result_t AAudioServiceStreamBase::stop_l() {
Phil Burk11e8d332017-05-24 09:59:02 -0700323 aaudio_result_t result = AAUDIO_OK;
Eric Laurentcb4dae22017-07-01 19:39:32 -0700324 if (!isRunning()) {
325 return result;
Phil Burk71f35bb2017-04-13 16:05:07 -0700326 }
Phil Burk7ebbc112020-05-13 15:55:17 -0700327 const int64_t beginNs = AudioClock::getNanoseconds();
Phil Burk39f02dd2017-08-04 09:13:31 -0700328
Phil Burka9876702020-04-20 18:16:15 -0700329 mediametrics::Defer defer([&] {
330 mediametrics::LogItem(mMetricsId)
331 .set(AMEDIAMETRICS_PROP_EVENT, AMEDIAMETRICS_PROP_EVENT_VALUE_STOP)
Andy Hungea840382020-05-05 21:50:17 -0700332 .set(AMEDIAMETRICS_PROP_EXECUTIONTIMENS, (int64_t)(AudioClock::getNanoseconds() - beginNs))
Phil Burka9876702020-04-20 18:16:15 -0700333 .set(AMEDIAMETRICS_PROP_STATE, AudioGlobal_convertStreamStateToText(getState()))
334 .set(AMEDIAMETRICS_PROP_STATUS, (int32_t)result)
335 .record(); });
336
Phil Burk83fb8442017-10-05 16:55:17 -0700337 setState(AAUDIO_STREAM_STATE_STOPPING);
338
Phil Burkd50ae622021-04-15 23:40:25 +0000339 // Temporarily unlock because we are joining the timestamp thread and it may try
340 // to acquire mLock.
341 mLock.unlock();
Eric Laurentcb4dae22017-07-01 19:39:32 -0700342 result = stopTimestampThread();
Phil Burkd50ae622021-04-15 23:40:25 +0000343 mLock.lock();
344
Eric Laurentcb4dae22017-07-01 19:39:32 -0700345 if (result != AAUDIO_OK) {
Phil Burk7ebbc112020-05-13 15:55:17 -0700346 disconnect_l();
Eric Laurentcb4dae22017-07-01 19:39:32 -0700347 return result;
348 }
Phil Burk39f02dd2017-08-04 09:13:31 -0700349
Phil Burk6e2770e2018-05-01 13:03:52 -0700350 sp<AAudioServiceEndpoint> endpoint = mServiceEndpointWeak.promote();
351 if (endpoint == nullptr) {
352 ALOGE("%s() has no endpoint", __func__);
Phil Burka9876702020-04-20 18:16:15 -0700353 result = AAUDIO_ERROR_INVALID_STATE; // for MediaMetric tracking
354 return result;
Phil Burk6e2770e2018-05-01 13:03:52 -0700355 }
Phil Burk39f02dd2017-08-04 09:13:31 -0700356 // TODO wait for data to be played out
Phil Burk6e2770e2018-05-01 13:03:52 -0700357 result = endpoint->stopStream(this, mClientHandle);
Phil Burk39f02dd2017-08-04 09:13:31 -0700358 if (result != AAUDIO_OK) {
Phil Burk6e2770e2018-05-01 13:03:52 -0700359 ALOGE("%s() stopStream returned %d, %s", __func__, result, getTypeText());
Phil Burk7ebbc112020-05-13 15:55:17 -0700360 disconnect_l();
Phil Burk39f02dd2017-08-04 09:13:31 -0700361 // TODO what to do with result here?
362 }
363
Eric Laurentcb4dae22017-07-01 19:39:32 -0700364 sendServiceEvent(AAUDIO_SERVICE_EVENT_STOPPED);
Phil Burkbcc36742017-08-31 17:24:51 -0700365 setState(AAUDIO_STREAM_STATE_STOPPED);
Phil Burk71f35bb2017-04-13 16:05:07 -0700366 return result;
367}
368
Phil Burk98d6d922017-07-06 11:52:45 -0700369aaudio_result_t AAudioServiceStreamBase::stopTimestampThread() {
370 aaudio_result_t result = AAUDIO_OK;
371 // clear flag that tells thread to loop
372 if (mThreadEnabled.exchange(false)) {
Phil Burkbcc36742017-08-31 17:24:51 -0700373 result = mTimestampThread.stop();
Phil Burk98d6d922017-07-06 11:52:45 -0700374 }
375 return result;
376}
377
Phil Burk71f35bb2017-04-13 16:05:07 -0700378aaudio_result_t AAudioServiceStreamBase::flush() {
Phil Burk7ebbc112020-05-13 15:55:17 -0700379 std::lock_guard<std::mutex> lock(mLock);
Phil Burk5cc83c32017-11-28 15:43:18 -0800380 aaudio_result_t result = AAudio_isFlushAllowed(getState());
381 if (result != AAUDIO_OK) {
382 return result;
Phil Burk39f02dd2017-08-04 09:13:31 -0700383 }
Phil Burk7ebbc112020-05-13 15:55:17 -0700384 const int64_t beginNs = AudioClock::getNanoseconds();
Phil Burk5cc83c32017-11-28 15:43:18 -0800385
Phil Burka9876702020-04-20 18:16:15 -0700386 mediametrics::Defer defer([&] {
387 mediametrics::LogItem(mMetricsId)
388 .set(AMEDIAMETRICS_PROP_EVENT, AMEDIAMETRICS_PROP_EVENT_VALUE_FLUSH)
Andy Hungea840382020-05-05 21:50:17 -0700389 .set(AMEDIAMETRICS_PROP_EXECUTIONTIMENS, (int64_t)(AudioClock::getNanoseconds() - beginNs))
Phil Burka9876702020-04-20 18:16:15 -0700390 .set(AMEDIAMETRICS_PROP_STATE, AudioGlobal_convertStreamStateToText(getState()))
391 .set(AMEDIAMETRICS_PROP_STATUS, (int32_t)result)
392 .record(); });
393
Phil Burk39f02dd2017-08-04 09:13:31 -0700394 // Data will get flushed when the client receives the FLUSHED event.
Phil Burk71f35bb2017-04-13 16:05:07 -0700395 sendServiceEvent(AAUDIO_SERVICE_EVENT_FLUSHED);
Phil Burkbcc36742017-08-31 17:24:51 -0700396 setState(AAUDIO_STREAM_STATE_FLUSHED);
Phil Burk71f35bb2017-04-13 16:05:07 -0700397 return AAUDIO_OK;
398}
399
Phil Burkcf5f6d22017-05-26 12:35:07 -0700400// implement Runnable, periodically send timestamps to client
Phil Burka53ffa62018-10-10 16:21:37 -0700401__attribute__((no_sanitize("integer")))
Phil Burkc0c70e32017-02-09 13:18:38 -0800402void AAudioServiceStreamBase::run() {
Phil Burk19e990e2018-03-22 13:59:34 -0700403 ALOGD("%s() %s entering >>>>>>>>>>>>>> TIMESTAMPS", __func__, getTypeText());
Phil Burkc0c70e32017-02-09 13:18:38 -0800404 TimestampScheduler timestampScheduler;
Phil Burk39f02dd2017-08-04 09:13:31 -0700405 timestampScheduler.setBurstPeriod(mFramesPerBurst, getSampleRate());
Phil Burkc0c70e32017-02-09 13:18:38 -0800406 timestampScheduler.start(AudioClock::getNanoseconds());
407 int64_t nextTime = timestampScheduler.nextAbsoluteTime();
Phil Burka53ffa62018-10-10 16:21:37 -0700408 int32_t loopCount = 0;
Phil Burk45da1b72021-04-07 06:30:50 +0000409 aaudio_result_t result = AAUDIO_OK;
Phil Burkc0c70e32017-02-09 13:18:38 -0800410 while(mThreadEnabled.load()) {
Phil Burka53ffa62018-10-10 16:21:37 -0700411 loopCount++;
Phil Burkc0c70e32017-02-09 13:18:38 -0800412 if (AudioClock::getNanoseconds() >= nextTime) {
Phil Burk45da1b72021-04-07 06:30:50 +0000413 result = sendCurrentTimestamp();
Phil Burkc0c70e32017-02-09 13:18:38 -0800414 if (result != AAUDIO_OK) {
Phil Burka53ffa62018-10-10 16:21:37 -0700415 ALOGE("%s() timestamp thread got result = %d", __func__, result);
Phil Burkc0c70e32017-02-09 13:18:38 -0800416 break;
417 }
418 nextTime = timestampScheduler.nextAbsoluteTime();
419 } else {
420 // Sleep until it is time to send the next timestamp.
Phil Burk98d6d922017-07-06 11:52:45 -0700421 // TODO Wait for a signal with a timeout so that we can stop more quickly.
Phil Burkc0c70e32017-02-09 13:18:38 -0800422 AudioClock::sleepUntilNanoTime(nextTime);
423 }
424 }
Phil Burk45da1b72021-04-07 06:30:50 +0000425 // This was moved from the calls in stop_l() and pause_l(), which could cause a deadlock
426 // if it resulted in a call to disconnect.
427 if (result == AAUDIO_OK) {
428 (void) sendCurrentTimestamp();
429 }
Phil Burka53ffa62018-10-10 16:21:37 -0700430 ALOGD("%s() %s exiting after %d loops <<<<<<<<<<<<<< TIMESTAMPS",
431 __func__, getTypeText(), loopCount);
Phil Burkc0c70e32017-02-09 13:18:38 -0800432}
433
Phil Burk5ef003b2017-06-30 11:43:37 -0700434void AAudioServiceStreamBase::disconnect() {
Phil Burk7ebbc112020-05-13 15:55:17 -0700435 std::lock_guard<std::mutex> lock(mLock);
436 disconnect_l();
437}
438
439void AAudioServiceStreamBase::disconnect_l() {
440 if (getState() != AAUDIO_STREAM_STATE_DISCONNECTED
441 && getState() != AAUDIO_STREAM_STATE_CLOSED) {
442
Phil Burka9876702020-04-20 18:16:15 -0700443 mediametrics::LogItem(mMetricsId)
444 .set(AMEDIAMETRICS_PROP_EVENT, AMEDIAMETRICS_PROP_EVENT_VALUE_DISCONNECT)
445 .set(AMEDIAMETRICS_PROP_STATE, AudioGlobal_convertStreamStateToText(getState()))
446 .record();
Phil Burk7ebbc112020-05-13 15:55:17 -0700447
Phil Burk5ef003b2017-06-30 11:43:37 -0700448 sendServiceEvent(AAUDIO_SERVICE_EVENT_DISCONNECTED);
Phil Burkbcc36742017-08-31 17:24:51 -0700449 setState(AAUDIO_STREAM_STATE_DISCONNECTED);
Phil Burk5ef003b2017-06-30 11:43:37 -0700450 }
Phil Burkc0c70e32017-02-09 13:18:38 -0800451}
452
Phil Burk7ebbc112020-05-13 15:55:17 -0700453aaudio_result_t AAudioServiceStreamBase::registerAudioThread(pid_t clientThreadId,
454 int priority) {
455 std::lock_guard<std::mutex> lock(mLock);
456 aaudio_result_t result = AAUDIO_OK;
457 if (getRegisteredThread() != AAudioServiceStreamBase::ILLEGAL_THREAD_ID) {
458 ALOGE("AAudioService::registerAudioThread(), thread already registered");
459 result = AAUDIO_ERROR_INVALID_STATE;
460 } else {
461 const pid_t ownerPid = IPCThreadState::self()->getCallingPid(); // TODO review
462 setRegisteredThread(clientThreadId);
463 int err = android::requestPriority(ownerPid, clientThreadId,
464 priority, true /* isForApp */);
465 if (err != 0) {
466 ALOGE("AAudioService::registerAudioThread(%d) failed, errno = %d, priority = %d",
467 clientThreadId, errno, priority);
468 result = AAUDIO_ERROR_INTERNAL;
469 }
470 }
471 return result;
472}
473
474aaudio_result_t AAudioServiceStreamBase::unregisterAudioThread(pid_t clientThreadId) {
475 std::lock_guard<std::mutex> lock(mLock);
476 aaudio_result_t result = AAUDIO_OK;
477 if (getRegisteredThread() != clientThreadId) {
478 ALOGE("%s(), wrong thread", __func__);
479 result = AAUDIO_ERROR_ILLEGAL_ARGUMENT;
480 } else {
481 setRegisteredThread(0);
482 }
483 return result;
484}
485
486void AAudioServiceStreamBase::setState(aaudio_stream_state_t state) {
487 // CLOSED is a final state.
488 if (mState != AAUDIO_STREAM_STATE_CLOSED) {
489 mState = state;
490 } else {
491 ALOGW_IF(mState != state, "%s(%d) when already CLOSED", __func__, state);
492 }
493}
494
Phil Burkc0c70e32017-02-09 13:18:38 -0800495aaudio_result_t AAudioServiceStreamBase::sendServiceEvent(aaudio_service_event_t event,
Phil Burk23296382017-11-20 15:45:11 -0800496 double dataDouble) {
Phil Burk5ed503c2017-02-01 09:38:15 -0800497 AAudioServiceMessage command;
498 command.what = AAudioServiceMessage::code::EVENT;
Phil Burk2355edb2016-12-26 13:54:02 -0800499 command.event.event = event;
Phil Burkc0c70e32017-02-09 13:18:38 -0800500 command.event.dataDouble = dataDouble;
Phil Burk23296382017-11-20 15:45:11 -0800501 return writeUpMessageQueue(&command);
502}
503
504aaudio_result_t AAudioServiceStreamBase::sendServiceEvent(aaudio_service_event_t event,
505 int64_t dataLong) {
506 AAudioServiceMessage command;
507 command.what = AAudioServiceMessage::code::EVENT;
508 command.event.event = event;
Phil Burkc0c70e32017-02-09 13:18:38 -0800509 command.event.dataLong = dataLong;
510 return writeUpMessageQueue(&command);
511}
512
Phil Burkf878a8d2019-03-29 17:23:00 -0700513bool AAudioServiceStreamBase::isUpMessageQueueBusy() {
514 std::lock_guard<std::mutex> lock(mUpMessageQueueLock);
515 if (mUpMessageQueue == nullptr) {
516 ALOGE("%s(): mUpMessageQueue null! - stream not open", __func__);
517 return true;
518 }
Phil Burkf878a8d2019-03-29 17:23:00 -0700519 // Is it half full or more
Phil Burk8f4fe502020-07-15 23:54:50 +0000520 return mUpMessageQueue->getFractionalFullness() >= 0.5;
Phil Burkf878a8d2019-03-29 17:23:00 -0700521}
522
Phil Burkc0c70e32017-02-09 13:18:38 -0800523aaudio_result_t AAudioServiceStreamBase::writeUpMessageQueue(AAudioServiceMessage *command) {
Phil Burk39f02dd2017-08-04 09:13:31 -0700524 std::lock_guard<std::mutex> lock(mUpMessageQueueLock);
Phil Burk71f35bb2017-04-13 16:05:07 -0700525 if (mUpMessageQueue == nullptr) {
Phil Burk19e990e2018-03-22 13:59:34 -0700526 ALOGE("%s(): mUpMessageQueue null! - stream not open", __func__);
Phil Burk71f35bb2017-04-13 16:05:07 -0700527 return AAUDIO_ERROR_NULL;
528 }
Phil Burkc0c70e32017-02-09 13:18:38 -0800529 int32_t count = mUpMessageQueue->getFifoBuffer()->write(command, 1);
530 if (count != 1) {
Phil Burk762365c2018-12-10 16:02:16 -0800531 ALOGW("%s(): Queue full. Did client stop? Suspending stream. what = %u, %s",
532 __func__, command->what, getTypeText());
533 setSuspended(true);
Phil Burkc0c70e32017-02-09 13:18:38 -0800534 return AAUDIO_ERROR_WOULD_BLOCK;
535 } else {
536 return AAUDIO_OK;
537 }
538}
539
Phil Burk23296382017-11-20 15:45:11 -0800540aaudio_result_t AAudioServiceStreamBase::sendXRunCount(int32_t xRunCount) {
541 return sendServiceEvent(AAUDIO_SERVICE_EVENT_XRUN, (int64_t) xRunCount);
542}
543
Phil Burkc0c70e32017-02-09 13:18:38 -0800544aaudio_result_t AAudioServiceStreamBase::sendCurrentTimestamp() {
545 AAudioServiceMessage command;
Phil Burkf878a8d2019-03-29 17:23:00 -0700546 // It is not worth filling up the queue with timestamps.
547 // That can cause the stream to get suspended.
548 // So just drop the timestamp if the queue is getting full.
549 if (isUpMessageQueueBusy()) {
550 return AAUDIO_OK;
551 }
552
Phil Burk97350f92017-07-21 15:59:44 -0700553 // Send a timestamp for the clock model.
Phil Burkc0c70e32017-02-09 13:18:38 -0800554 aaudio_result_t result = getFreeRunningPosition(&command.timestamp.position,
555 &command.timestamp.timestamp);
556 if (result == AAUDIO_OK) {
Phil Burk19e990e2018-03-22 13:59:34 -0700557 ALOGV("%s() SERVICE %8lld at %lld", __func__,
Phil Burkbcc36742017-08-31 17:24:51 -0700558 (long long) command.timestamp.position,
559 (long long) command.timestamp.timestamp);
Phil Burk97350f92017-07-21 15:59:44 -0700560 command.what = AAudioServiceMessage::code::TIMESTAMP_SERVICE;
Phil Burkc0c70e32017-02-09 13:18:38 -0800561 result = writeUpMessageQueue(&command);
Phil Burk97350f92017-07-21 15:59:44 -0700562
563 if (result == AAUDIO_OK) {
564 // Send a hardware timestamp for presentation time.
565 result = getHardwareTimestamp(&command.timestamp.position,
566 &command.timestamp.timestamp);
567 if (result == AAUDIO_OK) {
Phil Burk19e990e2018-03-22 13:59:34 -0700568 ALOGV("%s() HARDWARE %8lld at %lld", __func__,
Phil Burkbcc36742017-08-31 17:24:51 -0700569 (long long) command.timestamp.position,
570 (long long) command.timestamp.timestamp);
Phil Burk97350f92017-07-21 15:59:44 -0700571 command.what = AAudioServiceMessage::code::TIMESTAMP_HARDWARE;
572 result = writeUpMessageQueue(&command);
573 }
574 }
575 }
576
Phil Burkbcc36742017-08-31 17:24:51 -0700577 if (result == AAUDIO_ERROR_UNAVAILABLE) { // TODO review best error code
Phil Burk940083c2017-07-17 17:00:02 -0700578 result = AAUDIO_OK; // just not available yet, try again later
Phil Burkc0c70e32017-02-09 13:18:38 -0800579 }
580 return result;
Phil Burk2355edb2016-12-26 13:54:02 -0800581}
582
Phil Burkc0c70e32017-02-09 13:18:38 -0800583/**
584 * Get an immutable description of the in-memory queues
585 * used to communicate with the underlying HAL or Service.
586 */
587aaudio_result_t AAudioServiceStreamBase::getDescription(AudioEndpointParcelable &parcelable) {
Phil Burk7ebbc112020-05-13 15:55:17 -0700588 std::lock_guard<std::mutex> lock(mLock);
Phil Burk523b3042017-09-13 13:03:08 -0700589 {
590 std::lock_guard<std::mutex> lock(mUpMessageQueueLock);
591 if (mUpMessageQueue == nullptr) {
Phil Burk19e990e2018-03-22 13:59:34 -0700592 ALOGE("%s(): mUpMessageQueue null! - stream not open", __func__);
Phil Burk523b3042017-09-13 13:03:08 -0700593 return AAUDIO_ERROR_NULL;
594 }
595 // Gather information on the message queue.
596 mUpMessageQueue->fillParcelable(parcelable,
597 parcelable.mUpMessageQueueParcelable);
598 }
599 return getAudioDataDescription(parcelable);
Phil Burk11e8d332017-05-24 09:59:02 -0700600}
Phil Burk39f02dd2017-08-04 09:13:31 -0700601
602void AAudioServiceStreamBase::onVolumeChanged(float volume) {
603 sendServiceEvent(AAUDIO_SERVICE_EVENT_VOLUME, volume);
604}