Threads.h revision 40eb1a1f8871909c272e72afaf7d5af84fea2412
1/* 2** 3** Copyright 2012, The Android Open Source Project 4** 5** Licensed under the Apache License, Version 2.0 (the "License"); 6** you may not use this file except in compliance with the License. 7** You may obtain a copy of the License at 8** 9** http://www.apache.org/licenses/LICENSE-2.0 10** 11** Unless required by applicable law or agreed to in writing, software 12** distributed under the License is distributed on an "AS IS" BASIS, 13** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14** See the License for the specific language governing permissions and 15** limitations under the License. 16*/ 17 18#ifndef INCLUDING_FROM_AUDIOFLINGER_H 19 #error This header file should only be included from AudioFlinger.h 20#endif 21 22class ThreadBase : public Thread { 23public: 24 25#include "TrackBase.h" 26 27 enum type_t { 28 MIXER, // Thread class is MixerThread 29 DIRECT, // Thread class is DirectOutputThread 30 DUPLICATING, // Thread class is DuplicatingThread 31 RECORD, // Thread class is RecordThread 32 OFFLOAD // Thread class is OffloadThread 33 }; 34 35 static const char *threadTypeToString(type_t type); 36 37 ThreadBase(const sp<AudioFlinger>& audioFlinger, audio_io_handle_t id, 38 audio_devices_t outDevice, audio_devices_t inDevice, type_t type, 39 bool systemReady); 40 virtual ~ThreadBase(); 41 42 virtual status_t readyToRun(); 43 44 void dumpBase(int fd, const Vector<String16>& args); 45 void dumpEffectChains(int fd, const Vector<String16>& args); 46 47 void clearPowerManager(); 48 49 // base for record and playback 50 enum { 51 CFG_EVENT_IO, 52 CFG_EVENT_PRIO, 53 CFG_EVENT_SET_PARAMETER, 54 CFG_EVENT_CREATE_AUDIO_PATCH, 55 CFG_EVENT_RELEASE_AUDIO_PATCH, 56 }; 57 58 class ConfigEventData: public RefBase { 59 public: 60 virtual ~ConfigEventData() {} 61 62 virtual void dump(char *buffer, size_t size) = 0; 63 protected: 64 ConfigEventData() {} 65 }; 66 67 // Config event sequence by client if status needed (e.g binder thread calling setParameters()): 68 // 1. create SetParameterConfigEvent. This sets mWaitStatus in config event 69 // 2. Lock mLock 70 // 3. Call sendConfigEvent_l(): Append to mConfigEvents and mWaitWorkCV.signal 71 // 4. sendConfigEvent_l() reads status from event->mStatus; 72 // 5. sendConfigEvent_l() returns status 73 // 6. Unlock 74 // 75 // Parameter sequence by server: threadLoop calling processConfigEvents_l(): 76 // 1. Lock mLock 77 // 2. If there is an entry in mConfigEvents proceed ... 78 // 3. Read first entry in mConfigEvents 79 // 4. Remove first entry from mConfigEvents 80 // 5. Process 81 // 6. Set event->mStatus 82 // 7. event->mCond.signal 83 // 8. Unlock 84 85 class ConfigEvent: public RefBase { 86 public: 87 virtual ~ConfigEvent() {} 88 89 void dump(char *buffer, size_t size) { mData->dump(buffer, size); } 90 91 const int mType; // event type e.g. CFG_EVENT_IO 92 Mutex mLock; // mutex associated with mCond 93 Condition mCond; // condition for status return 94 status_t mStatus; // status communicated to sender 95 bool mWaitStatus; // true if sender is waiting for status 96 bool mRequiresSystemReady; // true if must wait for system ready to enter event queue 97 sp<ConfigEventData> mData; // event specific parameter data 98 99 protected: 100 ConfigEvent(int type, bool requiresSystemReady = false) : 101 mType(type), mStatus(NO_ERROR), mWaitStatus(false), 102 mRequiresSystemReady(requiresSystemReady), mData(NULL) {} 103 }; 104 105 class IoConfigEventData : public ConfigEventData { 106 public: 107 IoConfigEventData(audio_io_config_event event) : 108 mEvent(event) {} 109 110 virtual void dump(char *buffer, size_t size) { 111 snprintf(buffer, size, "IO event: event %d\n", mEvent); 112 } 113 114 const audio_io_config_event mEvent; 115 }; 116 117 class IoConfigEvent : public ConfigEvent { 118 public: 119 IoConfigEvent(audio_io_config_event event) : 120 ConfigEvent(CFG_EVENT_IO) { 121 mData = new IoConfigEventData(event); 122 } 123 virtual ~IoConfigEvent() {} 124 }; 125 126 class PrioConfigEventData : public ConfigEventData { 127 public: 128 PrioConfigEventData(pid_t pid, pid_t tid, int32_t prio) : 129 mPid(pid), mTid(tid), mPrio(prio) {} 130 131 virtual void dump(char *buffer, size_t size) { 132 snprintf(buffer, size, "Prio event: pid %d, tid %d, prio %d\n", mPid, mTid, mPrio); 133 } 134 135 const pid_t mPid; 136 const pid_t mTid; 137 const int32_t mPrio; 138 }; 139 140 class PrioConfigEvent : public ConfigEvent { 141 public: 142 PrioConfigEvent(pid_t pid, pid_t tid, int32_t prio) : 143 ConfigEvent(CFG_EVENT_PRIO, true) { 144 mData = new PrioConfigEventData(pid, tid, prio); 145 } 146 virtual ~PrioConfigEvent() {} 147 }; 148 149 class SetParameterConfigEventData : public ConfigEventData { 150 public: 151 SetParameterConfigEventData(String8 keyValuePairs) : 152 mKeyValuePairs(keyValuePairs) {} 153 154 virtual void dump(char *buffer, size_t size) { 155 snprintf(buffer, size, "KeyValue: %s\n", mKeyValuePairs.string()); 156 } 157 158 const String8 mKeyValuePairs; 159 }; 160 161 class SetParameterConfigEvent : public ConfigEvent { 162 public: 163 SetParameterConfigEvent(String8 keyValuePairs) : 164 ConfigEvent(CFG_EVENT_SET_PARAMETER) { 165 mData = new SetParameterConfigEventData(keyValuePairs); 166 mWaitStatus = true; 167 } 168 virtual ~SetParameterConfigEvent() {} 169 }; 170 171 class CreateAudioPatchConfigEventData : public ConfigEventData { 172 public: 173 CreateAudioPatchConfigEventData(const struct audio_patch patch, 174 audio_patch_handle_t handle) : 175 mPatch(patch), mHandle(handle) {} 176 177 virtual void dump(char *buffer, size_t size) { 178 snprintf(buffer, size, "Patch handle: %u\n", mHandle); 179 } 180 181 const struct audio_patch mPatch; 182 audio_patch_handle_t mHandle; 183 }; 184 185 class CreateAudioPatchConfigEvent : public ConfigEvent { 186 public: 187 CreateAudioPatchConfigEvent(const struct audio_patch patch, 188 audio_patch_handle_t handle) : 189 ConfigEvent(CFG_EVENT_CREATE_AUDIO_PATCH) { 190 mData = new CreateAudioPatchConfigEventData(patch, handle); 191 mWaitStatus = true; 192 } 193 virtual ~CreateAudioPatchConfigEvent() {} 194 }; 195 196 class ReleaseAudioPatchConfigEventData : public ConfigEventData { 197 public: 198 ReleaseAudioPatchConfigEventData(const audio_patch_handle_t handle) : 199 mHandle(handle) {} 200 201 virtual void dump(char *buffer, size_t size) { 202 snprintf(buffer, size, "Patch handle: %u\n", mHandle); 203 } 204 205 audio_patch_handle_t mHandle; 206 }; 207 208 class ReleaseAudioPatchConfigEvent : public ConfigEvent { 209 public: 210 ReleaseAudioPatchConfigEvent(const audio_patch_handle_t handle) : 211 ConfigEvent(CFG_EVENT_RELEASE_AUDIO_PATCH) { 212 mData = new ReleaseAudioPatchConfigEventData(handle); 213 mWaitStatus = true; 214 } 215 virtual ~ReleaseAudioPatchConfigEvent() {} 216 }; 217 218 class PMDeathRecipient : public IBinder::DeathRecipient { 219 public: 220 PMDeathRecipient(const wp<ThreadBase>& thread) : mThread(thread) {} 221 virtual ~PMDeathRecipient() {} 222 223 // IBinder::DeathRecipient 224 virtual void binderDied(const wp<IBinder>& who); 225 226 private: 227 PMDeathRecipient(const PMDeathRecipient&); 228 PMDeathRecipient& operator = (const PMDeathRecipient&); 229 230 wp<ThreadBase> mThread; 231 }; 232 233 virtual status_t initCheck() const = 0; 234 235 // static externally-visible 236 type_t type() const { return mType; } 237 bool isDuplicating() const { return (mType == DUPLICATING); } 238 239 audio_io_handle_t id() const { return mId;} 240 241 // dynamic externally-visible 242 uint32_t sampleRate() const { return mSampleRate; } 243 audio_channel_mask_t channelMask() const { return mChannelMask; } 244 audio_format_t format() const { return mHALFormat; } 245 uint32_t channelCount() const { return mChannelCount; } 246 // Called by AudioFlinger::frameCount(audio_io_handle_t output) and effects, 247 // and returns the [normal mix] buffer's frame count. 248 virtual size_t frameCount() const = 0; 249 size_t frameSize() const { return mFrameSize; } 250 251 // Should be "virtual status_t requestExitAndWait()" and override same 252 // method in Thread, but Thread::requestExitAndWait() is not yet virtual. 253 void exit(); 254 virtual bool checkForNewParameter_l(const String8& keyValuePair, 255 status_t& status) = 0; 256 virtual status_t setParameters(const String8& keyValuePairs); 257 virtual String8 getParameters(const String8& keys) = 0; 258 virtual void ioConfigChanged(audio_io_config_event event) = 0; 259 // sendConfigEvent_l() must be called with ThreadBase::mLock held 260 // Can temporarily release the lock if waiting for a reply from 261 // processConfigEvents_l(). 262 status_t sendConfigEvent_l(sp<ConfigEvent>& event); 263 void sendIoConfigEvent(audio_io_config_event event); 264 void sendIoConfigEvent_l(audio_io_config_event event); 265 void sendPrioConfigEvent(pid_t pid, pid_t tid, int32_t prio); 266 void sendPrioConfigEvent_l(pid_t pid, pid_t tid, int32_t prio); 267 status_t sendSetParameterConfigEvent_l(const String8& keyValuePair); 268 status_t sendCreateAudioPatchConfigEvent(const struct audio_patch *patch, 269 audio_patch_handle_t *handle); 270 status_t sendReleaseAudioPatchConfigEvent(audio_patch_handle_t handle); 271 void processConfigEvents_l(); 272 virtual void cacheParameters_l() = 0; 273 virtual status_t createAudioPatch_l(const struct audio_patch *patch, 274 audio_patch_handle_t *handle) = 0; 275 virtual status_t releaseAudioPatch_l(const audio_patch_handle_t handle) = 0; 276 virtual void getAudioPortConfig(struct audio_port_config *config) = 0; 277 278 279 // see note at declaration of mStandby, mOutDevice and mInDevice 280 bool standby() const { return mStandby; } 281 audio_devices_t outDevice() const { return mOutDevice; } 282 audio_devices_t inDevice() const { return mInDevice; } 283 284 virtual audio_stream_t* stream() const = 0; 285 286 sp<EffectHandle> createEffect_l( 287 const sp<AudioFlinger::Client>& client, 288 const sp<IEffectClient>& effectClient, 289 int32_t priority, 290 int sessionId, 291 effect_descriptor_t *desc, 292 int *enabled, 293 status_t *status /*non-NULL*/); 294 295 // return values for hasAudioSession (bit field) 296 enum effect_state { 297 EFFECT_SESSION = 0x1, // the audio session corresponds to at least one 298 // effect 299 TRACK_SESSION = 0x2 // the audio session corresponds to at least one 300 // track 301 }; 302 303 // get effect chain corresponding to session Id. 304 sp<EffectChain> getEffectChain(int sessionId); 305 // same as getEffectChain() but must be called with ThreadBase mutex locked 306 sp<EffectChain> getEffectChain_l(int sessionId) const; 307 // add an effect chain to the chain list (mEffectChains) 308 virtual status_t addEffectChain_l(const sp<EffectChain>& chain) = 0; 309 // remove an effect chain from the chain list (mEffectChains) 310 virtual size_t removeEffectChain_l(const sp<EffectChain>& chain) = 0; 311 // lock all effect chains Mutexes. Must be called before releasing the 312 // ThreadBase mutex before processing the mixer and effects. This guarantees the 313 // integrity of the chains during the process. 314 // Also sets the parameter 'effectChains' to current value of mEffectChains. 315 void lockEffectChains_l(Vector< sp<EffectChain> >& effectChains); 316 // unlock effect chains after process 317 void unlockEffectChains(const Vector< sp<EffectChain> >& effectChains); 318 // get a copy of mEffectChains vector 319 Vector< sp<EffectChain> > getEffectChains_l() const { return mEffectChains; }; 320 // set audio mode to all effect chains 321 void setMode(audio_mode_t mode); 322 // get effect module with corresponding ID on specified audio session 323 sp<AudioFlinger::EffectModule> getEffect(int sessionId, int effectId); 324 sp<AudioFlinger::EffectModule> getEffect_l(int sessionId, int effectId); 325 // add and effect module. Also creates the effect chain is none exists for 326 // the effects audio session 327 status_t addEffect_l(const sp< EffectModule>& effect); 328 // remove and effect module. Also removes the effect chain is this was the last 329 // effect 330 void removeEffect_l(const sp< EffectModule>& effect); 331 // detach all tracks connected to an auxiliary effect 332 virtual void detachAuxEffect_l(int effectId __unused) {} 333 // returns either EFFECT_SESSION if effects on this audio session exist in one 334 // chain, or TRACK_SESSION if tracks on this audio session exist, or both 335 virtual uint32_t hasAudioSession(int sessionId) const = 0; 336 // the value returned by default implementation is not important as the 337 // strategy is only meaningful for PlaybackThread which implements this method 338 virtual uint32_t getStrategyForSession_l(int sessionId __unused) { return 0; } 339 340 // suspend or restore effect according to the type of effect passed. a NULL 341 // type pointer means suspend all effects in the session 342 void setEffectSuspended(const effect_uuid_t *type, 343 bool suspend, 344 int sessionId = AUDIO_SESSION_OUTPUT_MIX); 345 // check if some effects must be suspended/restored when an effect is enabled 346 // or disabled 347 void checkSuspendOnEffectEnabled(const sp<EffectModule>& effect, 348 bool enabled, 349 int sessionId = AUDIO_SESSION_OUTPUT_MIX); 350 void checkSuspendOnEffectEnabled_l(const sp<EffectModule>& effect, 351 bool enabled, 352 int sessionId = AUDIO_SESSION_OUTPUT_MIX); 353 354 virtual status_t setSyncEvent(const sp<SyncEvent>& event) = 0; 355 virtual bool isValidSyncEvent(const sp<SyncEvent>& event) const = 0; 356 357 // Return a reference to a per-thread heap which can be used to allocate IMemory 358 // objects that will be read-only to client processes, read/write to mediaserver, 359 // and shared by all client processes of the thread. 360 // The heap is per-thread rather than common across all threads, because 361 // clients can't be trusted not to modify the offset of the IMemory they receive. 362 // If a thread does not have such a heap, this method returns 0. 363 virtual sp<MemoryDealer> readOnlyHeap() const { return 0; } 364 365 virtual sp<IMemory> pipeMemory() const { return 0; } 366 367 void systemReady(); 368 369 mutable Mutex mLock; 370 371protected: 372 373 // entry describing an effect being suspended in mSuspendedSessions keyed vector 374 class SuspendedSessionDesc : public RefBase { 375 public: 376 SuspendedSessionDesc() : mRefCount(0) {} 377 378 int mRefCount; // number of active suspend requests 379 effect_uuid_t mType; // effect type UUID 380 }; 381 382 void acquireWakeLock(int uid = -1); 383 void acquireWakeLock_l(int uid = -1); 384 void releaseWakeLock(); 385 void releaseWakeLock_l(); 386 void updateWakeLockUids(const SortedVector<int> &uids); 387 void updateWakeLockUids_l(const SortedVector<int> &uids); 388 void getPowerManager_l(); 389 void setEffectSuspended_l(const effect_uuid_t *type, 390 bool suspend, 391 int sessionId); 392 // updated mSuspendedSessions when an effect suspended or restored 393 void updateSuspendedSessions_l(const effect_uuid_t *type, 394 bool suspend, 395 int sessionId); 396 // check if some effects must be suspended when an effect chain is added 397 void checkSuspendOnAddEffectChain_l(const sp<EffectChain>& chain); 398 399 String16 getWakeLockTag(); 400 401 virtual void preExit() { } 402 403 friend class AudioFlinger; // for mEffectChains 404 405 const type_t mType; 406 407 // Used by parameters, config events, addTrack_l, exit 408 Condition mWaitWorkCV; 409 410 const sp<AudioFlinger> mAudioFlinger; 411 412 // updated by PlaybackThread::readOutputParameters_l() or 413 // RecordThread::readInputParameters_l() 414 uint32_t mSampleRate; 415 size_t mFrameCount; // output HAL, direct output, record 416 audio_channel_mask_t mChannelMask; 417 uint32_t mChannelCount; 418 size_t mFrameSize; 419 // not HAL frame size, this is for output sink (to pipe to fast mixer) 420 audio_format_t mFormat; // Source format for Recording and 421 // Sink format for Playback. 422 // Sink format may be different than 423 // HAL format if Fastmixer is used. 424 audio_format_t mHALFormat; 425 size_t mBufferSize; // HAL buffer size for read() or write() 426 427 Vector< sp<ConfigEvent> > mConfigEvents; 428 Vector< sp<ConfigEvent> > mPendingConfigEvents; // events awaiting system ready 429 430 // These fields are written and read by thread itself without lock or barrier, 431 // and read by other threads without lock or barrier via standby(), outDevice() 432 // and inDevice(). 433 // Because of the absence of a lock or barrier, any other thread that reads 434 // these fields must use the information in isolation, or be prepared to deal 435 // with possibility that it might be inconsistent with other information. 436 bool mStandby; // Whether thread is currently in standby. 437 audio_devices_t mOutDevice; // output device 438 audio_devices_t mInDevice; // input device 439 struct audio_patch mPatch; 440 audio_source_t mAudioSource; 441 442 const audio_io_handle_t mId; 443 Vector< sp<EffectChain> > mEffectChains; 444 445 static const int kThreadNameLength = 16; // prctl(PR_SET_NAME) limit 446 char mThreadName[kThreadNameLength]; // guaranteed NUL-terminated 447 sp<IPowerManager> mPowerManager; 448 sp<IBinder> mWakeLockToken; 449 const sp<PMDeathRecipient> mDeathRecipient; 450 // list of suspended effects per session and per type. The first vector is 451 // keyed by session ID, the second by type UUID timeLow field 452 KeyedVector< int, KeyedVector< int, sp<SuspendedSessionDesc> > > 453 mSuspendedSessions; 454 static const size_t kLogSize = 4 * 1024; 455 sp<NBLog::Writer> mNBLogWriter; 456 bool mSystemReady; 457}; 458 459// --- PlaybackThread --- 460class PlaybackThread : public ThreadBase { 461public: 462 463#include "PlaybackTracks.h" 464 465 enum mixer_state { 466 MIXER_IDLE, // no active tracks 467 MIXER_TRACKS_ENABLED, // at least one active track, but no track has any data ready 468 MIXER_TRACKS_READY, // at least one active track, and at least one track has data 469 MIXER_DRAIN_TRACK, // drain currently playing track 470 MIXER_DRAIN_ALL, // fully drain the hardware 471 // standby mode does not have an enum value 472 // suspend by audio policy manager is orthogonal to mixer state 473 }; 474 475 // retry count before removing active track in case of underrun on offloaded thread: 476 // we need to make sure that AudioTrack client has enough time to send large buffers 477//FIXME may be more appropriate if expressed in time units. Need to revise how underrun is handled 478 // for offloaded tracks 479 static const int8_t kMaxTrackRetriesOffload = 20; 480 481 PlaybackThread(const sp<AudioFlinger>& audioFlinger, AudioStreamOut* output, 482 audio_io_handle_t id, audio_devices_t device, type_t type, bool systemReady); 483 virtual ~PlaybackThread(); 484 485 void dump(int fd, const Vector<String16>& args); 486 487 // Thread virtuals 488 virtual bool threadLoop(); 489 490 // RefBase 491 virtual void onFirstRef(); 492 493protected: 494 // Code snippets that were lifted up out of threadLoop() 495 virtual void threadLoop_mix() = 0; 496 virtual void threadLoop_sleepTime() = 0; 497 virtual ssize_t threadLoop_write(); 498 virtual void threadLoop_drain(); 499 virtual void threadLoop_standby(); 500 virtual void threadLoop_exit(); 501 virtual void threadLoop_removeTracks(const Vector< sp<Track> >& tracksToRemove); 502 503 // prepareTracks_l reads and writes mActiveTracks, and returns 504 // the pending set of tracks to remove via Vector 'tracksToRemove'. The caller 505 // is responsible for clearing or destroying this Vector later on, when it 506 // is safe to do so. That will drop the final ref count and destroy the tracks. 507 virtual mixer_state prepareTracks_l(Vector< sp<Track> > *tracksToRemove) = 0; 508 void removeTracks_l(const Vector< sp<Track> >& tracksToRemove); 509 510 void writeCallback(); 511 void resetWriteBlocked(uint32_t sequence); 512 void drainCallback(); 513 void resetDraining(uint32_t sequence); 514 515 static int asyncCallback(stream_callback_event_t event, void *param, void *cookie); 516 517 virtual bool waitingAsyncCallback(); 518 virtual bool waitingAsyncCallback_l(); 519 virtual bool shouldStandby_l(); 520 virtual void onAddNewTrack_l(); 521 522 // ThreadBase virtuals 523 virtual void preExit(); 524 525public: 526 527 virtual status_t initCheck() const { return (mOutput == NULL) ? NO_INIT : NO_ERROR; } 528 529 // return estimated latency in milliseconds, as reported by HAL 530 uint32_t latency() const; 531 // same, but lock must already be held 532 uint32_t latency_l() const; 533 534 void setMasterVolume(float value); 535 void setMasterMute(bool muted); 536 537 void setStreamVolume(audio_stream_type_t stream, float value); 538 void setStreamMute(audio_stream_type_t stream, bool muted); 539 540 float streamVolume(audio_stream_type_t stream) const; 541 542 sp<Track> createTrack_l( 543 const sp<AudioFlinger::Client>& client, 544 audio_stream_type_t streamType, 545 uint32_t sampleRate, 546 audio_format_t format, 547 audio_channel_mask_t channelMask, 548 size_t *pFrameCount, 549 const sp<IMemory>& sharedBuffer, 550 int sessionId, 551 IAudioFlinger::track_flags_t *flags, 552 pid_t tid, 553 int uid, 554 status_t *status /*non-NULL*/); 555 556 AudioStreamOut* getOutput() const; 557 AudioStreamOut* clearOutput(); 558 virtual audio_stream_t* stream() const; 559 560 // a very large number of suspend() will eventually wraparound, but unlikely 561 void suspend() { (void) android_atomic_inc(&mSuspended); } 562 void restore() 563 { 564 // if restore() is done without suspend(), get back into 565 // range so that the next suspend() will operate correctly 566 if (android_atomic_dec(&mSuspended) <= 0) { 567 android_atomic_release_store(0, &mSuspended); 568 } 569 } 570 bool isSuspended() const 571 { return android_atomic_acquire_load(&mSuspended) > 0; } 572 573 virtual String8 getParameters(const String8& keys); 574 virtual void ioConfigChanged(audio_io_config_event event); 575 status_t getRenderPosition(uint32_t *halFrames, uint32_t *dspFrames); 576 // FIXME rename mixBuffer() to sinkBuffer() and remove int16_t* dependency. 577 // Consider also removing and passing an explicit mMainBuffer initialization 578 // parameter to AF::PlaybackThread::Track::Track(). 579 int16_t *mixBuffer() const { 580 return reinterpret_cast<int16_t *>(mSinkBuffer); }; 581 582 virtual void detachAuxEffect_l(int effectId); 583 status_t attachAuxEffect(const sp<AudioFlinger::PlaybackThread::Track> track, 584 int EffectId); 585 status_t attachAuxEffect_l(const sp<AudioFlinger::PlaybackThread::Track> track, 586 int EffectId); 587 588 virtual status_t addEffectChain_l(const sp<EffectChain>& chain); 589 virtual size_t removeEffectChain_l(const sp<EffectChain>& chain); 590 virtual uint32_t hasAudioSession(int sessionId) const; 591 virtual uint32_t getStrategyForSession_l(int sessionId); 592 593 594 virtual status_t setSyncEvent(const sp<SyncEvent>& event); 595 virtual bool isValidSyncEvent(const sp<SyncEvent>& event) const; 596 597 // called with AudioFlinger lock held 598 void invalidateTracks(audio_stream_type_t streamType); 599 600 virtual size_t frameCount() const { return mNormalFrameCount; } 601 602 // Return's the HAL's frame count i.e. fast mixer buffer size. 603 size_t frameCountHAL() const { return mFrameCount; } 604 605 status_t getTimestamp_l(AudioTimestamp& timestamp); 606 607 void addPatchTrack(const sp<PatchTrack>& track); 608 void deletePatchTrack(const sp<PatchTrack>& track); 609 610 virtual void getAudioPortConfig(struct audio_port_config *config); 611 612protected: 613 // updated by readOutputParameters_l() 614 size_t mNormalFrameCount; // normal mixer and effects 615 616 bool mThreadThrottle; // throttle the thread processing 617 uint32_t mThreadThrottleTimeMs; // throttle time for MIXER threads 618 uint32_t mThreadThrottleEndMs; // notify once per throttling 619 uint32_t mHalfBufferMs; // half the buffer size in milliseconds 620 621 void* mSinkBuffer; // frame size aligned sink buffer 622 623 // TODO: 624 // Rearrange the buffer info into a struct/class with 625 // clear, copy, construction, destruction methods. 626 // 627 // mSinkBuffer also has associated with it: 628 // 629 // mSinkBufferSize: Sink Buffer Size 630 // mFormat: Sink Buffer Format 631 632 // Mixer Buffer (mMixerBuffer*) 633 // 634 // In the case of floating point or multichannel data, which is not in the 635 // sink format, it is required to accumulate in a higher precision or greater channel count 636 // buffer before downmixing or data conversion to the sink buffer. 637 638 // Set to "true" to enable the Mixer Buffer otherwise mixer output goes to sink buffer. 639 bool mMixerBufferEnabled; 640 641 // Storage, 32 byte aligned (may make this alignment a requirement later). 642 // Due to constraints on mNormalFrameCount, the buffer size is a multiple of 16 frames. 643 void* mMixerBuffer; 644 645 // Size of mMixerBuffer in bytes: mNormalFrameCount * #channels * sampsize. 646 size_t mMixerBufferSize; 647 648 // The audio format of mMixerBuffer. Set to AUDIO_FORMAT_PCM_(FLOAT|16_BIT) only. 649 audio_format_t mMixerBufferFormat; 650 651 // An internal flag set to true by MixerThread::prepareTracks_l() 652 // when mMixerBuffer contains valid data after mixing. 653 bool mMixerBufferValid; 654 655 // Effects Buffer (mEffectsBuffer*) 656 // 657 // In the case of effects data, which is not in the sink format, 658 // it is required to accumulate in a different buffer before data conversion 659 // to the sink buffer. 660 661 // Set to "true" to enable the Effects Buffer otherwise effects output goes to sink buffer. 662 bool mEffectBufferEnabled; 663 664 // Storage, 32 byte aligned (may make this alignment a requirement later). 665 // Due to constraints on mNormalFrameCount, the buffer size is a multiple of 16 frames. 666 void* mEffectBuffer; 667 668 // Size of mEffectsBuffer in bytes: mNormalFrameCount * #channels * sampsize. 669 size_t mEffectBufferSize; 670 671 // The audio format of mEffectsBuffer. Set to AUDIO_FORMAT_PCM_16_BIT only. 672 audio_format_t mEffectBufferFormat; 673 674 // An internal flag set to true by MixerThread::prepareTracks_l() 675 // when mEffectsBuffer contains valid data after mixing. 676 // 677 // When this is set, all mixer data is routed into the effects buffer 678 // for any processing (including output processing). 679 bool mEffectBufferValid; 680 681 // suspend count, > 0 means suspended. While suspended, the thread continues to pull from 682 // tracks and mix, but doesn't write to HAL. A2DP and SCO HAL implementations can't handle 683 // concurrent use of both of them, so Audio Policy Service suspends one of the threads to 684 // workaround that restriction. 685 // 'volatile' means accessed via atomic operations and no lock. 686 volatile int32_t mSuspended; 687 688 // FIXME overflows every 6+ hours at 44.1 kHz stereo 16-bit samples 689 // mFramesWritten would be better, or 64-bit even better 690 size_t mBytesWritten; 691private: 692 // mMasterMute is in both PlaybackThread and in AudioFlinger. When a 693 // PlaybackThread needs to find out if master-muted, it checks it's local 694 // copy rather than the one in AudioFlinger. This optimization saves a lock. 695 bool mMasterMute; 696 void setMasterMute_l(bool muted) { mMasterMute = muted; } 697protected: 698 SortedVector< wp<Track> > mActiveTracks; // FIXME check if this could be sp<> 699 SortedVector<int> mWakeLockUids; 700 int mActiveTracksGeneration; 701 wp<Track> mLatestActiveTrack; // latest track added to mActiveTracks 702 703 // Allocate a track name for a given channel mask. 704 // Returns name >= 0 if successful, -1 on failure. 705 virtual int getTrackName_l(audio_channel_mask_t channelMask, 706 audio_format_t format, int sessionId) = 0; 707 virtual void deleteTrackName_l(int name) = 0; 708 709 // Time to sleep between cycles when: 710 virtual uint32_t activeSleepTimeUs() const; // mixer state MIXER_TRACKS_ENABLED 711 virtual uint32_t idleSleepTimeUs() const = 0; // mixer state MIXER_IDLE 712 virtual uint32_t suspendSleepTimeUs() const = 0; // audio policy manager suspended us 713 // No sleep when mixer state == MIXER_TRACKS_READY; relies on audio HAL stream->write() 714 // No sleep in standby mode; waits on a condition 715 716 // Code snippets that are temporarily lifted up out of threadLoop() until the merge 717 void checkSilentMode_l(); 718 719 // Non-trivial for DUPLICATING only 720 virtual void saveOutputTracks() { } 721 virtual void clearOutputTracks() { } 722 723 // Cache various calculated values, at threadLoop() entry and after a parameter change 724 virtual void cacheParameters_l(); 725 726 virtual uint32_t correctLatency_l(uint32_t latency) const; 727 728 virtual status_t createAudioPatch_l(const struct audio_patch *patch, 729 audio_patch_handle_t *handle); 730 virtual status_t releaseAudioPatch_l(const audio_patch_handle_t handle); 731 732 bool usesHwAvSync() const { return (mType == DIRECT) && (mOutput != NULL) 733 && mHwSupportsPause 734 && (mOutput->flags & AUDIO_OUTPUT_FLAG_HW_AV_SYNC); } 735 736private: 737 738 friend class AudioFlinger; // for numerous 739 740 PlaybackThread& operator = (const PlaybackThread&); 741 742 status_t addTrack_l(const sp<Track>& track); 743 bool destroyTrack_l(const sp<Track>& track); 744 void removeTrack_l(const sp<Track>& track); 745 void broadcast_l(); 746 747 void readOutputParameters_l(); 748 749 virtual void dumpInternals(int fd, const Vector<String16>& args); 750 void dumpTracks(int fd, const Vector<String16>& args); 751 752 SortedVector< sp<Track> > mTracks; 753 stream_type_t mStreamTypes[AUDIO_STREAM_CNT]; 754 AudioStreamOut *mOutput; 755 756 float mMasterVolume; 757 nsecs_t mLastWriteTime; 758 int mNumWrites; 759 int mNumDelayedWrites; 760 bool mInWrite; 761 762 // FIXME rename these former local variables of threadLoop to standard "m" names 763 nsecs_t mStandbyTimeNs; 764 size_t mSinkBufferSize; 765 766 // cached copies of activeSleepTimeUs() and idleSleepTimeUs() made by cacheParameters_l() 767 uint32_t mActiveSleepTimeUs; 768 uint32_t mIdleSleepTimeUs; 769 770 uint32_t mSleepTimeUs; 771 772 // mixer status returned by prepareTracks_l() 773 mixer_state mMixerStatus; // current cycle 774 // previous cycle when in prepareTracks_l() 775 mixer_state mMixerStatusIgnoringFastTracks; 776 // FIXME or a separate ready state per track 777 778 // FIXME move these declarations into the specific sub-class that needs them 779 // MIXER only 780 uint32_t sleepTimeShift; 781 782 // same as AudioFlinger::mStandbyTimeInNsecs except for DIRECT which uses a shorter value 783 nsecs_t mStandbyDelayNs; 784 785 // MIXER only 786 nsecs_t maxPeriod; 787 788 // DUPLICATING only 789 uint32_t writeFrames; 790 791 size_t mBytesRemaining; 792 size_t mCurrentWriteLength; 793 bool mUseAsyncWrite; 794 // mWriteAckSequence contains current write sequence on bits 31-1. The write sequence is 795 // incremented each time a write(), a flush() or a standby() occurs. 796 // Bit 0 is set when a write blocks and indicates a callback is expected. 797 // Bit 0 is reset by the async callback thread calling resetWriteBlocked(). Out of sequence 798 // callbacks are ignored. 799 uint32_t mWriteAckSequence; 800 // mDrainSequence contains current drain sequence on bits 31-1. The drain sequence is 801 // incremented each time a drain is requested or a flush() or standby() occurs. 802 // Bit 0 is set when the drain() command is called at the HAL and indicates a callback is 803 // expected. 804 // Bit 0 is reset by the async callback thread calling resetDraining(). Out of sequence 805 // callbacks are ignored. 806 uint32_t mDrainSequence; 807 // A condition that must be evaluated by prepareTrack_l() has changed and we must not wait 808 // for async write callback in the thread loop before evaluating it 809 bool mSignalPending; 810 sp<AsyncCallbackThread> mCallbackThread; 811 812private: 813 // The HAL output sink is treated as non-blocking, but current implementation is blocking 814 sp<NBAIO_Sink> mOutputSink; 815 // If a fast mixer is present, the blocking pipe sink, otherwise clear 816 sp<NBAIO_Sink> mPipeSink; 817 // The current sink for the normal mixer to write it's (sub)mix, mOutputSink or mPipeSink 818 sp<NBAIO_Sink> mNormalSink; 819#ifdef TEE_SINK 820 // For dumpsys 821 sp<NBAIO_Sink> mTeeSink; 822 sp<NBAIO_Source> mTeeSource; 823#endif 824 uint32_t mScreenState; // cached copy of gScreenState 825 static const size_t kFastMixerLogSize = 4 * 1024; 826 sp<NBLog::Writer> mFastMixerNBLogWriter; 827public: 828 virtual bool hasFastMixer() const = 0; 829 virtual FastTrackUnderruns getFastTrackUnderruns(size_t fastIndex __unused) const 830 { FastTrackUnderruns dummy; return dummy; } 831 832protected: 833 // accessed by both binder threads and within threadLoop(), lock on mutex needed 834 unsigned mFastTrackAvailMask; // bit i set if fast track [i] is available 835 bool mHwSupportsPause; 836 bool mHwPaused; 837 bool mFlushPending; 838private: 839 // timestamp latch: 840 // D input is written by threadLoop_write while mutex is unlocked, and read while locked 841 // Q output is written while locked, and read while locked 842 struct { 843 AudioTimestamp mTimestamp; 844 uint32_t mUnpresentedFrames; 845 KeyedVector<Track *, uint32_t> mFramesReleased; 846 } mLatchD, mLatchQ; 847 bool mLatchDValid; // true means mLatchD is valid 848 // (except for mFramesReleased which is filled in later), 849 // and clock it into latch at next opportunity 850 bool mLatchQValid; // true means mLatchQ is valid 851}; 852 853class MixerThread : public PlaybackThread { 854public: 855 MixerThread(const sp<AudioFlinger>& audioFlinger, 856 AudioStreamOut* output, 857 audio_io_handle_t id, 858 audio_devices_t device, 859 bool systemReady, 860 type_t type = MIXER); 861 virtual ~MixerThread(); 862 863 // Thread virtuals 864 865 virtual bool checkForNewParameter_l(const String8& keyValuePair, 866 status_t& status); 867 virtual void dumpInternals(int fd, const Vector<String16>& args); 868 869protected: 870 virtual mixer_state prepareTracks_l(Vector< sp<Track> > *tracksToRemove); 871 virtual int getTrackName_l(audio_channel_mask_t channelMask, 872 audio_format_t format, int sessionId); 873 virtual void deleteTrackName_l(int name); 874 virtual uint32_t idleSleepTimeUs() const; 875 virtual uint32_t suspendSleepTimeUs() const; 876 virtual void cacheParameters_l(); 877 878 // threadLoop snippets 879 virtual ssize_t threadLoop_write(); 880 virtual void threadLoop_standby(); 881 virtual void threadLoop_mix(); 882 virtual void threadLoop_sleepTime(); 883 virtual void threadLoop_removeTracks(const Vector< sp<Track> >& tracksToRemove); 884 virtual uint32_t correctLatency_l(uint32_t latency) const; 885 886 virtual status_t createAudioPatch_l(const struct audio_patch *patch, 887 audio_patch_handle_t *handle); 888 virtual status_t releaseAudioPatch_l(const audio_patch_handle_t handle); 889 890 AudioMixer* mAudioMixer; // normal mixer 891private: 892 // one-time initialization, no locks required 893 sp<FastMixer> mFastMixer; // non-0 if there is also a fast mixer 894 sp<AudioWatchdog> mAudioWatchdog; // non-0 if there is an audio watchdog thread 895 896 // contents are not guaranteed to be consistent, no locks required 897 FastMixerDumpState mFastMixerDumpState; 898#ifdef STATE_QUEUE_DUMP 899 StateQueueObserverDump mStateQueueObserverDump; 900 StateQueueMutatorDump mStateQueueMutatorDump; 901#endif 902 AudioWatchdogDump mAudioWatchdogDump; 903 904 // accessible only within the threadLoop(), no locks required 905 // mFastMixer->sq() // for mutating and pushing state 906 int32_t mFastMixerFutex; // for cold idle 907 908public: 909 virtual bool hasFastMixer() const { return mFastMixer != 0; } 910 virtual FastTrackUnderruns getFastTrackUnderruns(size_t fastIndex) const { 911 ALOG_ASSERT(fastIndex < FastMixerState::kMaxFastTracks); 912 return mFastMixerDumpState.mTracks[fastIndex].mUnderruns; 913 } 914 915}; 916 917class DirectOutputThread : public PlaybackThread { 918public: 919 920 DirectOutputThread(const sp<AudioFlinger>& audioFlinger, AudioStreamOut* output, 921 audio_io_handle_t id, audio_devices_t device, bool systemReady); 922 virtual ~DirectOutputThread(); 923 924 // Thread virtuals 925 926 virtual bool checkForNewParameter_l(const String8& keyValuePair, 927 status_t& status); 928 virtual void flushHw_l(); 929 930protected: 931 virtual int getTrackName_l(audio_channel_mask_t channelMask, 932 audio_format_t format, int sessionId); 933 virtual void deleteTrackName_l(int name); 934 virtual uint32_t activeSleepTimeUs() const; 935 virtual uint32_t idleSleepTimeUs() const; 936 virtual uint32_t suspendSleepTimeUs() const; 937 virtual void cacheParameters_l(); 938 939 // threadLoop snippets 940 virtual mixer_state prepareTracks_l(Vector< sp<Track> > *tracksToRemove); 941 virtual void threadLoop_mix(); 942 virtual void threadLoop_sleepTime(); 943 virtual void threadLoop_exit(); 944 virtual bool shouldStandby_l(); 945 946 virtual void onAddNewTrack_l(); 947 948 // volumes last sent to audio HAL with stream->set_volume() 949 float mLeftVolFloat; 950 float mRightVolFloat; 951 952 DirectOutputThread(const sp<AudioFlinger>& audioFlinger, AudioStreamOut* output, 953 audio_io_handle_t id, uint32_t device, ThreadBase::type_t type, 954 bool systemReady); 955 void processVolume_l(Track *track, bool lastTrack); 956 957 // prepareTracks_l() tells threadLoop_mix() the name of the single active track 958 sp<Track> mActiveTrack; 959 960 wp<Track> mPreviousTrack; // used to detect track switch 961 962public: 963 virtual bool hasFastMixer() const { return false; } 964}; 965 966class OffloadThread : public DirectOutputThread { 967public: 968 969 OffloadThread(const sp<AudioFlinger>& audioFlinger, AudioStreamOut* output, 970 audio_io_handle_t id, uint32_t device, bool systemReady); 971 virtual ~OffloadThread() {}; 972 virtual void flushHw_l(); 973 974protected: 975 // threadLoop snippets 976 virtual mixer_state prepareTracks_l(Vector< sp<Track> > *tracksToRemove); 977 virtual void threadLoop_exit(); 978 979 virtual bool waitingAsyncCallback(); 980 virtual bool waitingAsyncCallback_l(); 981 982private: 983 size_t mPausedWriteLength; // length in bytes of write interrupted by pause 984 size_t mPausedBytesRemaining; // bytes still waiting in mixbuffer after resume 985}; 986 987class AsyncCallbackThread : public Thread { 988public: 989 990 AsyncCallbackThread(const wp<PlaybackThread>& playbackThread); 991 992 virtual ~AsyncCallbackThread(); 993 994 // Thread virtuals 995 virtual bool threadLoop(); 996 997 // RefBase 998 virtual void onFirstRef(); 999 1000 void exit(); 1001 void setWriteBlocked(uint32_t sequence); 1002 void resetWriteBlocked(); 1003 void setDraining(uint32_t sequence); 1004 void resetDraining(); 1005 1006private: 1007 const wp<PlaybackThread> mPlaybackThread; 1008 // mWriteAckSequence corresponds to the last write sequence passed by the offload thread via 1009 // setWriteBlocked(). The sequence is shifted one bit to the left and the lsb is used 1010 // to indicate that the callback has been received via resetWriteBlocked() 1011 uint32_t mWriteAckSequence; 1012 // mDrainSequence corresponds to the last drain sequence passed by the offload thread via 1013 // setDraining(). The sequence is shifted one bit to the left and the lsb is used 1014 // to indicate that the callback has been received via resetDraining() 1015 uint32_t mDrainSequence; 1016 Condition mWaitWorkCV; 1017 Mutex mLock; 1018}; 1019 1020class DuplicatingThread : public MixerThread { 1021public: 1022 DuplicatingThread(const sp<AudioFlinger>& audioFlinger, MixerThread* mainThread, 1023 audio_io_handle_t id, bool systemReady); 1024 virtual ~DuplicatingThread(); 1025 1026 // Thread virtuals 1027 void addOutputTrack(MixerThread* thread); 1028 void removeOutputTrack(MixerThread* thread); 1029 uint32_t waitTimeMs() const { return mWaitTimeMs; } 1030protected: 1031 virtual uint32_t activeSleepTimeUs() const; 1032 1033private: 1034 bool outputsReady(const SortedVector< sp<OutputTrack> > &outputTracks); 1035protected: 1036 // threadLoop snippets 1037 virtual void threadLoop_mix(); 1038 virtual void threadLoop_sleepTime(); 1039 virtual ssize_t threadLoop_write(); 1040 virtual void threadLoop_standby(); 1041 virtual void cacheParameters_l(); 1042 1043private: 1044 // called from threadLoop, addOutputTrack, removeOutputTrack 1045 virtual void updateWaitTime_l(); 1046protected: 1047 virtual void saveOutputTracks(); 1048 virtual void clearOutputTracks(); 1049private: 1050 1051 uint32_t mWaitTimeMs; 1052 SortedVector < sp<OutputTrack> > outputTracks; 1053 SortedVector < sp<OutputTrack> > mOutputTracks; 1054public: 1055 virtual bool hasFastMixer() const { return false; } 1056}; 1057 1058 1059// record thread 1060class RecordThread : public ThreadBase 1061{ 1062public: 1063 1064 class RecordTrack; 1065 1066 /* The ResamplerBufferProvider is used to retrieve recorded input data from the 1067 * RecordThread. It maintains local state on the relative position of the read 1068 * position of the RecordTrack compared with the RecordThread. 1069 */ 1070 class ResamplerBufferProvider : public AudioBufferProvider 1071 { 1072 public: 1073 ResamplerBufferProvider(RecordTrack* recordTrack) : 1074 mRecordTrack(recordTrack), 1075 mRsmpInUnrel(0), mRsmpInFront(0) { } 1076 virtual ~ResamplerBufferProvider() { } 1077 1078 // called to set the ResamplerBufferProvider to head of the RecordThread data buffer, 1079 // skipping any previous data read from the hal. 1080 virtual void reset(); 1081 1082 /* Synchronizes RecordTrack position with the RecordThread. 1083 * Calculates available frames and handle overruns if the RecordThread 1084 * has advanced faster than the ResamplerBufferProvider has retrieved data. 1085 * TODO: why not do this for every getNextBuffer? 1086 * 1087 * Parameters 1088 * framesAvailable: pointer to optional output size_t to store record track 1089 * frames available. 1090 * hasOverrun: pointer to optional boolean, returns true if track has overrun. 1091 */ 1092 1093 virtual void sync(size_t *framesAvailable = NULL, bool *hasOverrun = NULL); 1094 1095 // AudioBufferProvider interface 1096 virtual status_t getNextBuffer(AudioBufferProvider::Buffer* buffer, int64_t pts); 1097 virtual void releaseBuffer(AudioBufferProvider::Buffer* buffer); 1098 private: 1099 RecordTrack * const mRecordTrack; 1100 size_t mRsmpInUnrel; // unreleased frames remaining from 1101 // most recent getNextBuffer 1102 // for debug only 1103 int32_t mRsmpInFront; // next available frame 1104 // rolling counter that is never cleared 1105 }; 1106 1107 /* The RecordBufferConverter is used for format, channel, and sample rate 1108 * conversion for a RecordTrack. 1109 * 1110 * TODO: Self contained, so move to a separate file later. 1111 * 1112 * RecordBufferConverter uses the convert() method rather than exposing a 1113 * buffer provider interface; this is to save a memory copy. 1114 */ 1115 class RecordBufferConverter 1116 { 1117 public: 1118 RecordBufferConverter( 1119 audio_channel_mask_t srcChannelMask, audio_format_t srcFormat, 1120 uint32_t srcSampleRate, 1121 audio_channel_mask_t dstChannelMask, audio_format_t dstFormat, 1122 uint32_t dstSampleRate); 1123 1124 ~RecordBufferConverter(); 1125 1126 /* Converts input data from an AudioBufferProvider by format, channelMask, 1127 * and sampleRate to a destination buffer. 1128 * 1129 * Parameters 1130 * dst: buffer to place the converted data. 1131 * provider: buffer provider to obtain source data. 1132 * frames: number of frames to convert 1133 * 1134 * Returns the number of frames converted. 1135 */ 1136 size_t convert(void *dst, AudioBufferProvider *provider, size_t frames); 1137 1138 // returns NO_ERROR if constructor was successful 1139 status_t initCheck() const { 1140 // mSrcChannelMask set on successful updateParameters 1141 return mSrcChannelMask != AUDIO_CHANNEL_INVALID ? NO_ERROR : NO_INIT; 1142 } 1143 1144 // allows dynamic reconfigure of all parameters 1145 status_t updateParameters( 1146 audio_channel_mask_t srcChannelMask, audio_format_t srcFormat, 1147 uint32_t srcSampleRate, 1148 audio_channel_mask_t dstChannelMask, audio_format_t dstFormat, 1149 uint32_t dstSampleRate); 1150 1151 // called to reset resampler buffers on record track discontinuity 1152 void reset() { 1153 if (mResampler != NULL) { 1154 mResampler->reset(); 1155 } 1156 } 1157 1158 private: 1159 // format conversion when not using resampler 1160 void convertNoResampler(void *dst, const void *src, size_t frames); 1161 1162 // format conversion when using resampler; modifies src in-place 1163 void convertResampler(void *dst, /*not-a-const*/ void *src, size_t frames); 1164 1165 // user provided information 1166 audio_channel_mask_t mSrcChannelMask; 1167 audio_format_t mSrcFormat; 1168 uint32_t mSrcSampleRate; 1169 audio_channel_mask_t mDstChannelMask; 1170 audio_format_t mDstFormat; 1171 uint32_t mDstSampleRate; 1172 1173 // derived information 1174 uint32_t mSrcChannelCount; 1175 uint32_t mDstChannelCount; 1176 size_t mDstFrameSize; 1177 1178 // format conversion buffer 1179 void *mBuf; 1180 size_t mBufFrames; 1181 size_t mBufFrameSize; 1182 1183 // resampler info 1184 AudioResampler *mResampler; 1185 1186 bool mIsLegacyDownmix; // legacy stereo to mono conversion needed 1187 bool mIsLegacyUpmix; // legacy mono to stereo conversion needed 1188 bool mRequiresFloat; // data processing requires float (e.g. resampler) 1189 PassthruBufferProvider *mInputConverterProvider; // converts input to float 1190 int8_t mIdxAry[sizeof(uint32_t) * 8]; // used for channel mask conversion 1191 }; 1192 1193#include "RecordTracks.h" 1194 1195 RecordThread(const sp<AudioFlinger>& audioFlinger, 1196 AudioStreamIn *input, 1197 audio_io_handle_t id, 1198 audio_devices_t outDevice, 1199 audio_devices_t inDevice, 1200 bool systemReady 1201#ifdef TEE_SINK 1202 , const sp<NBAIO_Sink>& teeSink 1203#endif 1204 ); 1205 virtual ~RecordThread(); 1206 1207 // no addTrack_l ? 1208 void destroyTrack_l(const sp<RecordTrack>& track); 1209 void removeTrack_l(const sp<RecordTrack>& track); 1210 1211 void dumpInternals(int fd, const Vector<String16>& args); 1212 void dumpTracks(int fd, const Vector<String16>& args); 1213 1214 // Thread virtuals 1215 virtual bool threadLoop(); 1216 1217 // RefBase 1218 virtual void onFirstRef(); 1219 1220 virtual status_t initCheck() const { return (mInput == NULL) ? NO_INIT : NO_ERROR; } 1221 1222 virtual sp<MemoryDealer> readOnlyHeap() const { return mReadOnlyHeap; } 1223 1224 virtual sp<IMemory> pipeMemory() const { return mPipeMemory; } 1225 1226 sp<AudioFlinger::RecordThread::RecordTrack> createRecordTrack_l( 1227 const sp<AudioFlinger::Client>& client, 1228 uint32_t sampleRate, 1229 audio_format_t format, 1230 audio_channel_mask_t channelMask, 1231 size_t *pFrameCount, 1232 int sessionId, 1233 size_t *notificationFrames, 1234 int uid, 1235 IAudioFlinger::track_flags_t *flags, 1236 pid_t tid, 1237 status_t *status /*non-NULL*/); 1238 1239 status_t start(RecordTrack* recordTrack, 1240 AudioSystem::sync_event_t event, 1241 int triggerSession); 1242 1243 // ask the thread to stop the specified track, and 1244 // return true if the caller should then do it's part of the stopping process 1245 bool stop(RecordTrack* recordTrack); 1246 1247 void dump(int fd, const Vector<String16>& args); 1248 AudioStreamIn* clearInput(); 1249 virtual audio_stream_t* stream() const; 1250 1251 1252 virtual bool checkForNewParameter_l(const String8& keyValuePair, 1253 status_t& status); 1254 virtual void cacheParameters_l() {} 1255 virtual String8 getParameters(const String8& keys); 1256 virtual void ioConfigChanged(audio_io_config_event event); 1257 virtual status_t createAudioPatch_l(const struct audio_patch *patch, 1258 audio_patch_handle_t *handle); 1259 virtual status_t releaseAudioPatch_l(const audio_patch_handle_t handle); 1260 1261 void addPatchRecord(const sp<PatchRecord>& record); 1262 void deletePatchRecord(const sp<PatchRecord>& record); 1263 1264 void readInputParameters_l(); 1265 virtual uint32_t getInputFramesLost(); 1266 1267 virtual status_t addEffectChain_l(const sp<EffectChain>& chain); 1268 virtual size_t removeEffectChain_l(const sp<EffectChain>& chain); 1269 virtual uint32_t hasAudioSession(int sessionId) const; 1270 1271 // Return the set of unique session IDs across all tracks. 1272 // The keys are the session IDs, and the associated values are meaningless. 1273 // FIXME replace by Set [and implement Bag/Multiset for other uses]. 1274 KeyedVector<int, bool> sessionIds() const; 1275 1276 virtual status_t setSyncEvent(const sp<SyncEvent>& event); 1277 virtual bool isValidSyncEvent(const sp<SyncEvent>& event) const; 1278 1279 static void syncStartEventCallback(const wp<SyncEvent>& event); 1280 1281 virtual size_t frameCount() const { return mFrameCount; } 1282 bool hasFastCapture() const { return mFastCapture != 0; } 1283 virtual void getAudioPortConfig(struct audio_port_config *config); 1284 1285private: 1286 // Enter standby if not already in standby, and set mStandby flag 1287 void standbyIfNotAlreadyInStandby(); 1288 1289 // Call the HAL standby method unconditionally, and don't change mStandby flag 1290 void inputStandBy(); 1291 1292 AudioStreamIn *mInput; 1293 SortedVector < sp<RecordTrack> > mTracks; 1294 // mActiveTracks has dual roles: it indicates the current active track(s), and 1295 // is used together with mStartStopCond to indicate start()/stop() progress 1296 SortedVector< sp<RecordTrack> > mActiveTracks; 1297 // generation counter for mActiveTracks 1298 int mActiveTracksGen; 1299 Condition mStartStopCond; 1300 1301 // resampler converts input at HAL Hz to output at AudioRecord client Hz 1302 void *mRsmpInBuffer; // 1303 size_t mRsmpInFrames; // size of resampler input in frames 1304 size_t mRsmpInFramesP2;// size rounded up to a power-of-2 1305 1306 // rolling index that is never cleared 1307 int32_t mRsmpInRear; // last filled frame + 1 1308 1309 // For dumpsys 1310 const sp<NBAIO_Sink> mTeeSink; 1311 1312 const sp<MemoryDealer> mReadOnlyHeap; 1313 1314 // one-time initialization, no locks required 1315 sp<FastCapture> mFastCapture; // non-0 if there is also 1316 // a fast capture 1317 1318 // FIXME audio watchdog thread 1319 1320 // contents are not guaranteed to be consistent, no locks required 1321 FastCaptureDumpState mFastCaptureDumpState; 1322#ifdef STATE_QUEUE_DUMP 1323 // FIXME StateQueue observer and mutator dump fields 1324#endif 1325 // FIXME audio watchdog dump 1326 1327 // accessible only within the threadLoop(), no locks required 1328 // mFastCapture->sq() // for mutating and pushing state 1329 int32_t mFastCaptureFutex; // for cold idle 1330 1331 // The HAL input source is treated as non-blocking, 1332 // but current implementation is blocking 1333 sp<NBAIO_Source> mInputSource; 1334 // The source for the normal capture thread to read from: mInputSource or mPipeSource 1335 sp<NBAIO_Source> mNormalSource; 1336 // If a fast capture is present, the non-blocking pipe sink written to by fast capture, 1337 // otherwise clear 1338 sp<NBAIO_Sink> mPipeSink; 1339 // If a fast capture is present, the non-blocking pipe source read by normal thread, 1340 // otherwise clear 1341 sp<NBAIO_Source> mPipeSource; 1342 // Depth of pipe from fast capture to normal thread and fast clients, always power of 2 1343 size_t mPipeFramesP2; 1344 // If a fast capture is present, the Pipe as IMemory, otherwise clear 1345 sp<IMemory> mPipeMemory; 1346 1347 static const size_t kFastCaptureLogSize = 4 * 1024; 1348 sp<NBLog::Writer> mFastCaptureNBLogWriter; 1349 1350 bool mFastTrackAvail; // true if fast track available 1351}; 1352