AudioFlinger.h revision 72e3f39146fce4686bd96f11057c051bea376dfb
1/* 2** 3** Copyright 2007, 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 ANDROID_AUDIO_FLINGER_H 19#define ANDROID_AUDIO_FLINGER_H 20 21#include "Configuration.h" 22#include <stdint.h> 23#include <sys/types.h> 24#include <limits.h> 25 26#include <common_time/cc_helper.h> 27 28#include <cutils/compiler.h> 29 30#include <media/IAudioFlinger.h> 31#include <media/IAudioFlingerClient.h> 32#include <media/IAudioTrack.h> 33#include <media/IAudioRecord.h> 34#include <media/AudioSystem.h> 35#include <media/AudioTrack.h> 36 37#include <utils/Atomic.h> 38#include <utils/Errors.h> 39#include <utils/threads.h> 40#include <utils/SortedVector.h> 41#include <utils/TypeHelpers.h> 42#include <utils/Vector.h> 43 44#include <binder/BinderService.h> 45#include <binder/MemoryDealer.h> 46 47#include <system/audio.h> 48#include <hardware/audio.h> 49#include <hardware/audio_policy.h> 50 51#include <media/AudioBufferProvider.h> 52#include <media/ExtendedAudioBufferProvider.h> 53 54#include "FastCapture.h" 55#include "FastMixer.h" 56#include <media/nbaio/NBAIO.h> 57#include "AudioWatchdog.h" 58#include "AudioMixer.h" 59#include "AudioStreamOut.h" 60#include "SpdifStreamOut.h" 61#include "AudioHwDevice.h" 62 63#include <powermanager/IPowerManager.h> 64 65#include <media/nbaio/NBLog.h> 66#include <private/media/AudioTrackShared.h> 67 68namespace android { 69 70struct audio_track_cblk_t; 71struct effect_param_cblk_t; 72class AudioMixer; 73class AudioBuffer; 74class AudioResampler; 75class FastMixer; 76class PassthruBufferProvider; 77class ServerProxy; 78 79// ---------------------------------------------------------------------------- 80 81// The macro FCC_2 highlights some (but not all) places where there are are 2-channel assumptions. 82// This is typically due to legacy implementation of stereo input or output. 83// Search also for "2", "left", "right", "[0]", "[1]", ">> 16", "<< 16", etc. 84#define FCC_2 2 // FCC_2 = Fixed Channel Count 2 85// The macro FCC_8 highlights places where there are 8-channel assumptions. 86// This is typically due to audio mixer and resampler limitations. 87#define FCC_8 8 // FCC_8 = Fixed Channel Count 8 88 89static const nsecs_t kDefaultStandbyTimeInNsecs = seconds(3); 90 91#define INCLUDING_FROM_AUDIOFLINGER_H 92 93class AudioFlinger : 94 public BinderService<AudioFlinger>, 95 public BnAudioFlinger 96{ 97 friend class BinderService<AudioFlinger>; // for AudioFlinger() 98public: 99 static const char* getServiceName() ANDROID_API { return "media.audio_flinger"; } 100 101 virtual status_t dump(int fd, const Vector<String16>& args); 102 103 // IAudioFlinger interface, in binder opcode order 104 virtual sp<IAudioTrack> createTrack( 105 audio_stream_type_t streamType, 106 uint32_t sampleRate, 107 audio_format_t format, 108 audio_channel_mask_t channelMask, 109 size_t *pFrameCount, 110 IAudioFlinger::track_flags_t *flags, 111 const sp<IMemory>& sharedBuffer, 112 audio_io_handle_t output, 113 pid_t tid, 114 int *sessionId, 115 int clientUid, 116 status_t *status /*non-NULL*/); 117 118 virtual sp<IAudioRecord> openRecord( 119 audio_io_handle_t input, 120 uint32_t sampleRate, 121 audio_format_t format, 122 audio_channel_mask_t channelMask, 123 const String16& opPackageName, 124 size_t *pFrameCount, 125 IAudioFlinger::track_flags_t *flags, 126 pid_t tid, 127 int clientUid, 128 int *sessionId, 129 size_t *notificationFrames, 130 sp<IMemory>& cblk, 131 sp<IMemory>& buffers, 132 status_t *status /*non-NULL*/); 133 134 virtual uint32_t sampleRate(audio_io_handle_t output) const; 135 virtual audio_format_t format(audio_io_handle_t output) const; 136 virtual size_t frameCount(audio_io_handle_t output) const; 137 virtual uint32_t latency(audio_io_handle_t output) const; 138 139 virtual status_t setMasterVolume(float value); 140 virtual status_t setMasterMute(bool muted); 141 142 virtual float masterVolume() const; 143 virtual bool masterMute() const; 144 145 virtual status_t setStreamVolume(audio_stream_type_t stream, float value, 146 audio_io_handle_t output); 147 virtual status_t setStreamMute(audio_stream_type_t stream, bool muted); 148 149 virtual float streamVolume(audio_stream_type_t stream, 150 audio_io_handle_t output) const; 151 virtual bool streamMute(audio_stream_type_t stream) const; 152 153 virtual status_t setMode(audio_mode_t mode); 154 155 virtual status_t setMicMute(bool state); 156 virtual bool getMicMute() const; 157 158 virtual status_t setParameters(audio_io_handle_t ioHandle, const String8& keyValuePairs); 159 virtual String8 getParameters(audio_io_handle_t ioHandle, const String8& keys) const; 160 161 virtual void registerClient(const sp<IAudioFlingerClient>& client); 162 163 virtual size_t getInputBufferSize(uint32_t sampleRate, audio_format_t format, 164 audio_channel_mask_t channelMask) const; 165 166 virtual status_t openOutput(audio_module_handle_t module, 167 audio_io_handle_t *output, 168 audio_config_t *config, 169 audio_devices_t *devices, 170 const String8& address, 171 uint32_t *latencyMs, 172 audio_output_flags_t flags); 173 174 virtual audio_io_handle_t openDuplicateOutput(audio_io_handle_t output1, 175 audio_io_handle_t output2); 176 177 virtual status_t closeOutput(audio_io_handle_t output); 178 179 virtual status_t suspendOutput(audio_io_handle_t output); 180 181 virtual status_t restoreOutput(audio_io_handle_t output); 182 183 virtual status_t openInput(audio_module_handle_t module, 184 audio_io_handle_t *input, 185 audio_config_t *config, 186 audio_devices_t *device, 187 const String8& address, 188 audio_source_t source, 189 audio_input_flags_t flags); 190 191 virtual status_t closeInput(audio_io_handle_t input); 192 193 virtual status_t invalidateStream(audio_stream_type_t stream); 194 195 virtual status_t setVoiceVolume(float volume); 196 197 virtual status_t getRenderPosition(uint32_t *halFrames, uint32_t *dspFrames, 198 audio_io_handle_t output) const; 199 200 virtual uint32_t getInputFramesLost(audio_io_handle_t ioHandle) const; 201 202 virtual audio_unique_id_t newAudioUniqueId(); 203 204 virtual void acquireAudioSessionId(int audioSession, pid_t pid); 205 206 virtual void releaseAudioSessionId(int audioSession, pid_t pid); 207 208 virtual status_t queryNumberEffects(uint32_t *numEffects) const; 209 210 virtual status_t queryEffect(uint32_t index, effect_descriptor_t *descriptor) const; 211 212 virtual status_t getEffectDescriptor(const effect_uuid_t *pUuid, 213 effect_descriptor_t *descriptor) const; 214 215 virtual sp<IEffect> createEffect( 216 effect_descriptor_t *pDesc, 217 const sp<IEffectClient>& effectClient, 218 int32_t priority, 219 audio_io_handle_t io, 220 int sessionId, 221 const String16& opPackageName, 222 status_t *status /*non-NULL*/, 223 int *id, 224 int *enabled); 225 226 virtual status_t moveEffects(int sessionId, audio_io_handle_t srcOutput, 227 audio_io_handle_t dstOutput); 228 229 virtual audio_module_handle_t loadHwModule(const char *name); 230 231 virtual uint32_t getPrimaryOutputSamplingRate(); 232 virtual size_t getPrimaryOutputFrameCount(); 233 234 virtual status_t setLowRamDevice(bool isLowRamDevice); 235 236 /* List available audio ports and their attributes */ 237 virtual status_t listAudioPorts(unsigned int *num_ports, 238 struct audio_port *ports); 239 240 /* Get attributes for a given audio port */ 241 virtual status_t getAudioPort(struct audio_port *port); 242 243 /* Create an audio patch between several source and sink ports */ 244 virtual status_t createAudioPatch(const struct audio_patch *patch, 245 audio_patch_handle_t *handle); 246 247 /* Release an audio patch */ 248 virtual status_t releaseAudioPatch(audio_patch_handle_t handle); 249 250 /* List existing audio patches */ 251 virtual status_t listAudioPatches(unsigned int *num_patches, 252 struct audio_patch *patches); 253 254 /* Set audio port configuration */ 255 virtual status_t setAudioPortConfig(const struct audio_port_config *config); 256 257 /* Get the HW synchronization source used for an audio session */ 258 virtual audio_hw_sync_t getAudioHwSyncForSession(audio_session_t sessionId); 259 260 /* Indicate JAVA services are ready (scheduling, power management ...) */ 261 virtual status_t systemReady(); 262 263 virtual status_t onTransact( 264 uint32_t code, 265 const Parcel& data, 266 Parcel* reply, 267 uint32_t flags); 268 269 // end of IAudioFlinger interface 270 271 sp<NBLog::Writer> newWriter_l(size_t size, const char *name); 272 void unregisterWriter(const sp<NBLog::Writer>& writer); 273private: 274 static const size_t kLogMemorySize = 40 * 1024; 275 sp<MemoryDealer> mLogMemoryDealer; // == 0 when NBLog is disabled 276 // When a log writer is unregistered, it is done lazily so that media.log can continue to see it 277 // for as long as possible. The memory is only freed when it is needed for another log writer. 278 Vector< sp<NBLog::Writer> > mUnregisteredWriters; 279 Mutex mUnregisteredWritersLock; 280public: 281 282 class SyncEvent; 283 284 typedef void (*sync_event_callback_t)(const wp<SyncEvent>& event) ; 285 286 class SyncEvent : public RefBase { 287 public: 288 SyncEvent(AudioSystem::sync_event_t type, 289 int triggerSession, 290 int listenerSession, 291 sync_event_callback_t callBack, 292 wp<RefBase> cookie) 293 : mType(type), mTriggerSession(triggerSession), mListenerSession(listenerSession), 294 mCallback(callBack), mCookie(cookie) 295 {} 296 297 virtual ~SyncEvent() {} 298 299 void trigger() { Mutex::Autolock _l(mLock); if (mCallback) mCallback(this); } 300 bool isCancelled() const { Mutex::Autolock _l(mLock); return (mCallback == NULL); } 301 void cancel() { Mutex::Autolock _l(mLock); mCallback = NULL; } 302 AudioSystem::sync_event_t type() const { return mType; } 303 int triggerSession() const { return mTriggerSession; } 304 int listenerSession() const { return mListenerSession; } 305 wp<RefBase> cookie() const { return mCookie; } 306 307 private: 308 const AudioSystem::sync_event_t mType; 309 const int mTriggerSession; 310 const int mListenerSession; 311 sync_event_callback_t mCallback; 312 const wp<RefBase> mCookie; 313 mutable Mutex mLock; 314 }; 315 316 sp<SyncEvent> createSyncEvent(AudioSystem::sync_event_t type, 317 int triggerSession, 318 int listenerSession, 319 sync_event_callback_t callBack, 320 wp<RefBase> cookie); 321 322private: 323 324 audio_mode_t getMode() const { return mMode; } 325 326 bool btNrecIsOff() const { return mBtNrecIsOff; } 327 328 AudioFlinger() ANDROID_API; 329 virtual ~AudioFlinger(); 330 331 // call in any IAudioFlinger method that accesses mPrimaryHardwareDev 332 status_t initCheck() const { return mPrimaryHardwareDev == NULL ? 333 NO_INIT : NO_ERROR; } 334 335 // RefBase 336 virtual void onFirstRef(); 337 338 AudioHwDevice* findSuitableHwDev_l(audio_module_handle_t module, 339 audio_devices_t devices); 340 void purgeStaleEffects_l(); 341 342 // Set kEnableExtendedChannels to true to enable greater than stereo output 343 // for the MixerThread and device sink. Number of channels allowed is 344 // FCC_2 <= channels <= AudioMixer::MAX_NUM_CHANNELS. 345 static const bool kEnableExtendedChannels = true; 346 347 // Returns true if channel mask is permitted for the PCM sink in the MixerThread 348 static inline bool isValidPcmSinkChannelMask(audio_channel_mask_t channelMask) { 349 switch (audio_channel_mask_get_representation(channelMask)) { 350 case AUDIO_CHANNEL_REPRESENTATION_POSITION: { 351 uint32_t channelCount = FCC_2; // stereo is default 352 if (kEnableExtendedChannels) { 353 channelCount = audio_channel_count_from_out_mask(channelMask); 354 if (channelCount < FCC_2 // mono is not supported at this time 355 || channelCount > AudioMixer::MAX_NUM_CHANNELS) { 356 return false; 357 } 358 } 359 // check that channelMask is the "canonical" one we expect for the channelCount. 360 return channelMask == audio_channel_out_mask_from_count(channelCount); 361 } 362 default: 363 return false; 364 } 365 } 366 367 // Set kEnableExtendedPrecision to true to use extended precision in MixerThread 368 static const bool kEnableExtendedPrecision = true; 369 370 // Returns true if format is permitted for the PCM sink in the MixerThread 371 static inline bool isValidPcmSinkFormat(audio_format_t format) { 372 switch (format) { 373 case AUDIO_FORMAT_PCM_16_BIT: 374 return true; 375 case AUDIO_FORMAT_PCM_FLOAT: 376 case AUDIO_FORMAT_PCM_24_BIT_PACKED: 377 case AUDIO_FORMAT_PCM_32_BIT: 378 case AUDIO_FORMAT_PCM_8_24_BIT: 379 return kEnableExtendedPrecision; 380 default: 381 return false; 382 } 383 } 384 385 // standby delay for MIXER and DUPLICATING playback threads is read from property 386 // ro.audio.flinger_standbytime_ms or defaults to kDefaultStandbyTimeInNsecs 387 static nsecs_t mStandbyTimeInNsecs; 388 389 // incremented by 2 when screen state changes, bit 0 == 1 means "off" 390 // AudioFlinger::setParameters() updates, other threads read w/o lock 391 static uint32_t mScreenState; 392 393 // Internal dump utilities. 394 static const int kDumpLockRetries = 50; 395 static const int kDumpLockSleepUs = 20000; 396 static bool dumpTryLock(Mutex& mutex); 397 void dumpPermissionDenial(int fd, const Vector<String16>& args); 398 void dumpClients(int fd, const Vector<String16>& args); 399 void dumpInternals(int fd, const Vector<String16>& args); 400 401 // --- Client --- 402 class Client : public RefBase { 403 public: 404 Client(const sp<AudioFlinger>& audioFlinger, pid_t pid); 405 virtual ~Client(); 406 sp<MemoryDealer> heap() const; 407 pid_t pid() const { return mPid; } 408 sp<AudioFlinger> audioFlinger() const { return mAudioFlinger; } 409 410 bool reserveTimedTrack(); 411 void releaseTimedTrack(); 412 413 private: 414 Client(const Client&); 415 Client& operator = (const Client&); 416 const sp<AudioFlinger> mAudioFlinger; 417 const sp<MemoryDealer> mMemoryDealer; 418 const pid_t mPid; 419 420 Mutex mTimedTrackLock; 421 int mTimedTrackCount; 422 }; 423 424 // --- Notification Client --- 425 class NotificationClient : public IBinder::DeathRecipient { 426 public: 427 NotificationClient(const sp<AudioFlinger>& audioFlinger, 428 const sp<IAudioFlingerClient>& client, 429 pid_t pid); 430 virtual ~NotificationClient(); 431 432 sp<IAudioFlingerClient> audioFlingerClient() const { return mAudioFlingerClient; } 433 434 // IBinder::DeathRecipient 435 virtual void binderDied(const wp<IBinder>& who); 436 437 private: 438 NotificationClient(const NotificationClient&); 439 NotificationClient& operator = (const NotificationClient&); 440 441 const sp<AudioFlinger> mAudioFlinger; 442 const pid_t mPid; 443 const sp<IAudioFlingerClient> mAudioFlingerClient; 444 }; 445 446 class TrackHandle; 447 class RecordHandle; 448 class RecordThread; 449 class PlaybackThread; 450 class MixerThread; 451 class DirectOutputThread; 452 class OffloadThread; 453 class DuplicatingThread; 454 class AsyncCallbackThread; 455 class Track; 456 class RecordTrack; 457 class EffectModule; 458 class EffectHandle; 459 class EffectChain; 460 461 struct AudioStreamIn; 462 463 struct stream_type_t { 464 stream_type_t() 465 : volume(1.0f), 466 mute(false) 467 { 468 } 469 float volume; 470 bool mute; 471 }; 472 473 // --- PlaybackThread --- 474 475#include "Threads.h" 476 477#include "Effects.h" 478 479#include "PatchPanel.h" 480 481 // server side of the client's IAudioTrack 482 class TrackHandle : public android::BnAudioTrack { 483 public: 484 TrackHandle(const sp<PlaybackThread::Track>& track); 485 virtual ~TrackHandle(); 486 virtual sp<IMemory> getCblk() const; 487 virtual status_t start(); 488 virtual void stop(); 489 virtual void flush(); 490 virtual void pause(); 491 virtual status_t attachAuxEffect(int effectId); 492 virtual status_t allocateTimedBuffer(size_t size, 493 sp<IMemory>* buffer); 494 virtual status_t queueTimedBuffer(const sp<IMemory>& buffer, 495 int64_t pts); 496 virtual status_t setMediaTimeTransform(const LinearTransform& xform, 497 int target); 498 virtual status_t setParameters(const String8& keyValuePairs); 499 virtual status_t getTimestamp(AudioTimestamp& timestamp); 500 virtual void signal(); // signal playback thread for a change in control block 501 502 virtual status_t onTransact( 503 uint32_t code, const Parcel& data, Parcel* reply, uint32_t flags); 504 505 private: 506 const sp<PlaybackThread::Track> mTrack; 507 }; 508 509 // server side of the client's IAudioRecord 510 class RecordHandle : public android::BnAudioRecord { 511 public: 512 RecordHandle(const sp<RecordThread::RecordTrack>& recordTrack); 513 virtual ~RecordHandle(); 514 virtual status_t start(int /*AudioSystem::sync_event_t*/ event, int triggerSession); 515 virtual void stop(); 516 virtual status_t onTransact( 517 uint32_t code, const Parcel& data, Parcel* reply, uint32_t flags); 518 private: 519 const sp<RecordThread::RecordTrack> mRecordTrack; 520 521 // for use from destructor 522 void stop_nonvirtual(); 523 }; 524 525 526 PlaybackThread *checkPlaybackThread_l(audio_io_handle_t output) const; 527 MixerThread *checkMixerThread_l(audio_io_handle_t output) const; 528 RecordThread *checkRecordThread_l(audio_io_handle_t input) const; 529 sp<RecordThread> openInput_l(audio_module_handle_t module, 530 audio_io_handle_t *input, 531 audio_config_t *config, 532 audio_devices_t device, 533 const String8& address, 534 audio_source_t source, 535 audio_input_flags_t flags); 536 sp<PlaybackThread> openOutput_l(audio_module_handle_t module, 537 audio_io_handle_t *output, 538 audio_config_t *config, 539 audio_devices_t devices, 540 const String8& address, 541 audio_output_flags_t flags); 542 543 void closeOutputFinish(sp<PlaybackThread> thread); 544 void closeInputFinish(sp<RecordThread> thread); 545 546 // no range check, AudioFlinger::mLock held 547 bool streamMute_l(audio_stream_type_t stream) const 548 { return mStreamTypes[stream].mute; } 549 // no range check, doesn't check per-thread stream volume, AudioFlinger::mLock held 550 float streamVolume_l(audio_stream_type_t stream) const 551 { return mStreamTypes[stream].volume; } 552 void ioConfigChanged(audio_io_config_event event, 553 const sp<AudioIoDescriptor>& ioDesc); 554 555 // Allocate an audio_io_handle_t, session ID, effect ID, or audio_module_handle_t. 556 // They all share the same ID space, but the namespaces are actually independent 557 // because there are separate KeyedVectors for each kind of ID. 558 // The return value is uint32_t, but is cast to signed for some IDs. 559 // FIXME This API does not handle rollover to zero (for unsigned IDs), 560 // or from positive to negative (for signed IDs). 561 // Thus it may fail by returning an ID of the wrong sign, 562 // or by returning a non-unique ID. 563 uint32_t nextUniqueId(); 564 565 status_t moveEffectChain_l(int sessionId, 566 PlaybackThread *srcThread, 567 PlaybackThread *dstThread, 568 bool reRegister); 569 // return thread associated with primary hardware device, or NULL 570 PlaybackThread *primaryPlaybackThread_l() const; 571 audio_devices_t primaryOutputDevice_l() const; 572 573 sp<PlaybackThread> getEffectThread_l(int sessionId, int EffectId); 574 575 576 void removeClient_l(pid_t pid); 577 void removeNotificationClient(pid_t pid); 578 bool isNonOffloadableGlobalEffectEnabled_l(); 579 void onNonOffloadableGlobalEffectEnable(); 580 581 // Store an effect chain to mOrphanEffectChains keyed vector. 582 // Called when a thread exits and effects are still attached to it. 583 // If effects are later created on the same session, they will reuse the same 584 // effect chain and same instances in the effect library. 585 // return ALREADY_EXISTS if a chain with the same session already exists in 586 // mOrphanEffectChains. Note that this should never happen as there is only one 587 // chain for a given session and it is attached to only one thread at a time. 588 status_t putOrphanEffectChain_l(const sp<EffectChain>& chain); 589 // Get an effect chain for the specified session in mOrphanEffectChains and remove 590 // it if found. Returns 0 if not found (this is the most common case). 591 sp<EffectChain> getOrphanEffectChain_l(audio_session_t session); 592 // Called when the last effect handle on an effect instance is removed. If this 593 // effect belongs to an effect chain in mOrphanEffectChains, the chain is updated 594 // and removed from mOrphanEffectChains if it does not contain any effect. 595 // Return true if the effect was found in mOrphanEffectChains, false otherwise. 596 bool updateOrphanEffectChains(const sp<EffectModule>& effect); 597 598 void broacastParametersToRecordThreads_l(const String8& keyValuePairs); 599 600 // AudioStreamIn is immutable, so their fields are const. 601 // For emphasis, we could also make all pointers to them be "const *", 602 // but that would clutter the code unnecessarily. 603 604 struct AudioStreamIn { 605 AudioHwDevice* const audioHwDev; 606 audio_stream_in_t* const stream; 607 608 audio_hw_device_t* hwDev() const { return audioHwDev->hwDevice(); } 609 610 AudioStreamIn(AudioHwDevice *dev, audio_stream_in_t *in) : 611 audioHwDev(dev), stream(in) {} 612 }; 613 614 // for mAudioSessionRefs only 615 struct AudioSessionRef { 616 AudioSessionRef(int sessionid, pid_t pid) : 617 mSessionid(sessionid), mPid(pid), mCnt(1) {} 618 const int mSessionid; 619 const pid_t mPid; 620 int mCnt; 621 }; 622 623 mutable Mutex mLock; 624 // protects mClients and mNotificationClients. 625 // must be locked after mLock and ThreadBase::mLock if both must be locked 626 // avoids acquiring AudioFlinger::mLock from inside thread loop. 627 mutable Mutex mClientLock; 628 // protected by mClientLock 629 DefaultKeyedVector< pid_t, wp<Client> > mClients; // see ~Client() 630 631 mutable Mutex mHardwareLock; 632 // NOTE: If both mLock and mHardwareLock mutexes must be held, 633 // always take mLock before mHardwareLock 634 635 // These two fields are immutable after onFirstRef(), so no lock needed to access 636 AudioHwDevice* mPrimaryHardwareDev; // mAudioHwDevs[0] or NULL 637 DefaultKeyedVector<audio_module_handle_t, AudioHwDevice*> mAudioHwDevs; 638 639 // for dump, indicates which hardware operation is currently in progress (but not stream ops) 640 enum hardware_call_state { 641 AUDIO_HW_IDLE = 0, // no operation in progress 642 AUDIO_HW_INIT, // init_check 643 AUDIO_HW_OUTPUT_OPEN, // open_output_stream 644 AUDIO_HW_OUTPUT_CLOSE, // unused 645 AUDIO_HW_INPUT_OPEN, // unused 646 AUDIO_HW_INPUT_CLOSE, // unused 647 AUDIO_HW_STANDBY, // unused 648 AUDIO_HW_SET_MASTER_VOLUME, // set_master_volume 649 AUDIO_HW_GET_ROUTING, // unused 650 AUDIO_HW_SET_ROUTING, // unused 651 AUDIO_HW_GET_MODE, // unused 652 AUDIO_HW_SET_MODE, // set_mode 653 AUDIO_HW_GET_MIC_MUTE, // get_mic_mute 654 AUDIO_HW_SET_MIC_MUTE, // set_mic_mute 655 AUDIO_HW_SET_VOICE_VOLUME, // set_voice_volume 656 AUDIO_HW_SET_PARAMETER, // set_parameters 657 AUDIO_HW_GET_INPUT_BUFFER_SIZE, // get_input_buffer_size 658 AUDIO_HW_GET_MASTER_VOLUME, // get_master_volume 659 AUDIO_HW_GET_PARAMETER, // get_parameters 660 AUDIO_HW_SET_MASTER_MUTE, // set_master_mute 661 AUDIO_HW_GET_MASTER_MUTE, // get_master_mute 662 }; 663 664 mutable hardware_call_state mHardwareStatus; // for dump only 665 666 667 DefaultKeyedVector< audio_io_handle_t, sp<PlaybackThread> > mPlaybackThreads; 668 stream_type_t mStreamTypes[AUDIO_STREAM_CNT]; 669 670 // member variables below are protected by mLock 671 float mMasterVolume; 672 bool mMasterMute; 673 // end of variables protected by mLock 674 675 DefaultKeyedVector< audio_io_handle_t, sp<RecordThread> > mRecordThreads; 676 677 // protected by mClientLock 678 DefaultKeyedVector< pid_t, sp<NotificationClient> > mNotificationClients; 679 680 volatile int32_t mNextUniqueId; // updated by android_atomic_inc 681 // nextUniqueId() returns uint32_t, but this is declared int32_t 682 // because the atomic operations require an int32_t 683 684 audio_mode_t mMode; 685 bool mBtNrecIsOff; 686 687 // protected by mLock 688 Vector<AudioSessionRef*> mAudioSessionRefs; 689 690 float masterVolume_l() const; 691 bool masterMute_l() const; 692 audio_module_handle_t loadHwModule_l(const char *name); 693 694 Vector < sp<SyncEvent> > mPendingSyncEvents; // sync events awaiting for a session 695 // to be created 696 697 // Effect chains without a valid thread 698 DefaultKeyedVector< audio_session_t , sp<EffectChain> > mOrphanEffectChains; 699 700 // list of sessions for which a valid HW A/V sync ID was retrieved from the HAL 701 DefaultKeyedVector< audio_session_t , audio_hw_sync_t >mHwAvSyncIds; 702private: 703 sp<Client> registerPid(pid_t pid); // always returns non-0 704 705 // for use from destructor 706 status_t closeOutput_nonvirtual(audio_io_handle_t output); 707 void closeOutputInternal_l(sp<PlaybackThread> thread); 708 status_t closeInput_nonvirtual(audio_io_handle_t input); 709 void closeInputInternal_l(sp<RecordThread> thread); 710 void setAudioHwSyncForSession_l(PlaybackThread *thread, audio_session_t sessionId); 711 712 status_t checkStreamType(audio_stream_type_t stream) const; 713 714#ifdef TEE_SINK 715 // all record threads serially share a common tee sink, which is re-created on format change 716 sp<NBAIO_Sink> mRecordTeeSink; 717 sp<NBAIO_Source> mRecordTeeSource; 718#endif 719 720public: 721 722#ifdef TEE_SINK 723 // tee sink, if enabled by property, allows dumpsys to write most recent audio to .wav file 724 static void dumpTee(int fd, const sp<NBAIO_Source>& source, audio_io_handle_t id = 0); 725 726 // whether tee sink is enabled by property 727 static bool mTeeSinkInputEnabled; 728 static bool mTeeSinkOutputEnabled; 729 static bool mTeeSinkTrackEnabled; 730 731 // runtime configured size of each tee sink pipe, in frames 732 static size_t mTeeSinkInputFrames; 733 static size_t mTeeSinkOutputFrames; 734 static size_t mTeeSinkTrackFrames; 735 736 // compile-time default size of tee sink pipes, in frames 737 // 0x200000 stereo 16-bit PCM frames = 47.5 seconds at 44.1 kHz, 8 megabytes 738 static const size_t kTeeSinkInputFramesDefault = 0x200000; 739 static const size_t kTeeSinkOutputFramesDefault = 0x200000; 740 static const size_t kTeeSinkTrackFramesDefault = 0x200000; 741#endif 742 743 // This method reads from a variable without mLock, but the variable is updated under mLock. So 744 // we might read a stale value, or a value that's inconsistent with respect to other variables. 745 // In this case, it's safe because the return value isn't used for making an important decision. 746 // The reason we don't want to take mLock is because it could block the caller for a long time. 747 bool isLowRamDevice() const { return mIsLowRamDevice; } 748 749private: 750 bool mIsLowRamDevice; 751 bool mIsDeviceTypeKnown; 752 nsecs_t mGlobalEffectEnableTime; // when a global effect was last enabled 753 754 sp<PatchPanel> mPatchPanel; 755 756 uint32_t mPrimaryOutputSampleRate; // sample rate of the primary output, or zero if none 757 // protected by mHardwareLock 758 bool mSystemReady; 759}; 760 761#undef INCLUDING_FROM_AUDIOFLINGER_H 762 763const char *formatToString(audio_format_t format); 764String8 inputFlagsToString(audio_input_flags_t flags); 765String8 outputFlagsToString(audio_output_flags_t flags); 766String8 devicesToString(audio_devices_t devices); 767const char *sourceToString(audio_source_t source); 768 769// ---------------------------------------------------------------------------- 770 771} // namespace android 772 773#endif // ANDROID_AUDIO_FLINGER_H 774