AudioTrackShared.h revision 74935e44734c1ec235c2b6677db3e0dbefa5ddb8
15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/* 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Copyright (C) 2007 The Android Open Source Project 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Licensed under the Apache License, Version 2.0 (the "License"); 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * you may not use this file except in compliance with the License. 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * You may obtain a copy of the License at 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * http://www.apache.org/licenses/LICENSE-2.0 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Unless required by applicable law or agreed to in writing, software 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * distributed under the License is distributed on an "AS IS" BASIS, 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * See the License for the specific language governing permissions and 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * limitations under the License. 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef ANDROID_AUDIO_TRACK_SHARED_H 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define ANDROID_AUDIO_TRACK_SHARED_H 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <stdint.h> 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <sys/types.h> 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <utils/threads.h> 24eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#include <utils/Log.h> 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <utils/RefBase.h> 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <media/nbaio/roundup.h> 27c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)#include <media/SingleStateQueue.h> 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <private/media/StaticAudioTrackState.h> 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace android { 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// ---------------------------------------------------------------------------- 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 342a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)// for audio_track_cblk_t::mFlags 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CBLK_UNDERRUN 0x01 // set by server immediately on output underrun, cleared by client 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CBLK_FORCEREADY 0x02 // set: track is considered ready immediately by AudioFlinger, 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // clear: track is ready when buffer full 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CBLK_INVALID 0x04 // track buffer invalidated by AudioFlinger, need to re-create 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CBLK_DISABLED 0x08 // output track disabled by AudioFlinger due to underrun, 405d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // need to re-start. Unlike CBLK_UNDERRUN, this is not set 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // immediately, but only after a long string of underruns. 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 0x10 unused 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CBLK_LOOP_CYCLE 0x20 // set by server each time a loop cycle other than final one completes 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CBLK_LOOP_FINAL 0x40 // set by server when the final loop cycle completes 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CBLK_BUFFER_END 0x80 // set by server when the position reaches end of buffer if not looping 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CBLK_OVERRUN 0x100 // set by server immediately on input overrun, cleared by client 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CBLK_INTERRUPT 0x200 // set by client on interrupt(), cleared by client in obtainBuffer() 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CBLK_STREAM_END_DONE 0x400 // set by server on render completion, cleared by client 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//EL_FIXME 20 seconds may not be enough and must be reconciled with new obtainBuffer implementation 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define MAX_RUN_OFFLOADED_TIMEOUT_MS 20000 // assuming up to a maximum of 20 seconds of offloaded 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct AudioTrackSharedStreaming { 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // similar to NBAIO MonoPipe 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // in continuously incrementing frame units, take modulo buffer size, which must be a power of 2 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) volatile int32_t mFront; // read by server 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) volatile int32_t mRear; // write by client 58a93a17c8d99d686bd4a1511e5504e5e6cc9fcadfTorne (Richard Coles) volatile int32_t mFlush; // incremented by client to indicate a request to flush; 59a93a17c8d99d686bd4a1511e5504e5e6cc9fcadfTorne (Richard Coles) // server notices and discards all data between mFront and mRear 60a93a17c8d99d686bd4a1511e5504e5e6cc9fcadfTorne (Richard Coles) volatile uint32_t mUnderrunFrames; // server increments for each unavailable but desired frame 61a93a17c8d99d686bd4a1511e5504e5e6cc9fcadfTorne (Richard Coles)}; 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)typedef SingleStateQueue<StaticAudioTrackState> StaticAudioTrackSingleStateQueue; 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct AudioTrackSharedStatic { 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) StaticAudioTrackSingleStateQueue::Shared 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) mSingleStateQueue; 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t mBufferPosition; // updated asynchronously by server, 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // "for entertainment purposes only" 705d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)}; 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// ---------------------------------------------------------------------------- 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Important: do not add any virtual methods, including ~ 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct audio_track_cblk_t 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles){ 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Since the control block is always located in shared memory, this constructor 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // is only used for placement new(). It is never used for regular new() or stack. 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) audio_track_cblk_t(); 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /*virtual*/ ~audio_track_cblk_t() { } 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class Proxy; 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class ClientProxy; 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class AudioTrackClientProxy; 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class AudioRecordClientProxy; 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class ServerProxy; 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class AudioTrackServerProxy; 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class AudioRecordServerProxy; 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The data members are grouped so that members accessed frequently and in the same context 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // are in the same line of data cache. 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint32_t mServer; // Number of filled frames consumed by server (mIsOut), 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // or filled frames provided by server (!mIsOut). 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // It is updated asynchronously by server without a barrier. 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The value should be used "for entertainment purposes only", 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // which means don't make important decisions based on it. 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint32_t mPad1; // unused 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) volatile int32_t mFutex; // event flag: down (P) by client, 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // up (V) by server or binderDied() or interrupt() 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CBLK_FUTEX_WAKE 1 // if event flag bit is set, then a deferred wake is pending 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)private: 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t mMinimum; // server wakes up client if available >= mMinimum 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Channel volumes are fixed point U4.12, so 0x1000 means 1.0. 110c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // Left channel is in [0:15], right channel is in [16:31]. 111c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // Always read and write the combined pair atomically. 112c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // For AudioTrack only, not used by AudioRecord. 113c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) uint32_t mVolumeLR; 114c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 115c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) uint32_t mSampleRate; // AudioTrack only: client's requested sample rate in Hz 116c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // or 0 == default. Write-only client, read-only server. 117c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 118c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // client write-only, server read-only 119c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) uint16_t mSendLevel; // Fixed point U4.12 so 0x1000 means 1.0 120c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 121c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) uint16_t mPad2; // unused 122c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 123c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)public: 124c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 125c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) volatile int32_t mFlags; // combinations of CBLK_* 126c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 127c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // Cache line boundary (32 bytes) 128c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 129c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)public: 130c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) union { 131c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) AudioTrackSharedStreaming mStreaming; 132c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) AudioTrackSharedStatic mStatic; 133c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) int mAlign[8]; 134c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) } u; 1355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Cache line boundary (32 bytes) 1375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// ---------------------------------------------------------------------------- 1405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Proxy for shared memory control block, to isolate callers from needing to know the details. 1425d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// There is exactly one ClientProxy and one ServerProxy per shared memory control block. 1435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// The proxies are located in normal memory, and are not multi-thread safe within a given side. 1445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class Proxy : public RefBase { 1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)protected: 1465d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) Proxy(audio_track_cblk_t* cblk, void *buffers, size_t frameCount, size_t frameSize, bool isOut, 1475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool clientInServer); 1485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~Proxy() { } 1491320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci 1501320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tuccipublic: 1511320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci struct Buffer { 1525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t mFrameCount; // number of frames available in this buffer 1535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void* mRaw; // pointer to first frame 1545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t mNonContig; // number of additional non-contiguous frames available 155c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) }; 1565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)protected: 1585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // These refer to shared memory, and are virtual addresses with respect to the current process. 1595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // They may have different virtual addresses within the other process. 1605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) audio_track_cblk_t* const mCblk; // the control block 1615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void* const mBuffers; // starting address of buffers 1625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const size_t mFrameCount; // not necessarily a power of 2 1645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const size_t mFrameSize; // in bytes 1655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const size_t mFrameCountP2; // mFrameCount rounded to power of 2, streaming mode 1665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const bool mIsOut; // true for AudioTrack, false for AudioRecord 1675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const bool mClientInServer; // true for OutputTrack, false for AudioTrack & AudioRecord 1685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool mIsShutdown; // latch set to true when shared memory corruption detected 169c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) size_t mUnreleased; // unreleased frames remaining from most recent obtainBuffer 170c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)}; 171c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 1725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// ---------------------------------------------------------------------------- 1735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Proxy seen by AudioTrack client and AudioRecord client 1755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class ClientProxy : public Proxy { 1765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)protected: 1775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ClientProxy(audio_track_cblk_t* cblk, void *buffers, size_t frameCount, size_t frameSize, 1785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool isOut, bool clientInServer); 1795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~ClientProxy() { } 1805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)public: 1825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static const struct timespec kForever; 1835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static const struct timespec kNonBlocking; 1845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Obtain a buffer with filled frames (reading) or empty frames (writing). 1865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // It is permitted to call obtainBuffer() multiple times in succession, without any intervening 1875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // calls to releaseBuffer(). In that case, the final obtainBuffer() is the one that effectively 1885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // sets or extends the unreleased frame count. 1895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // On entry: 1905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mFrameCount should be initialized to maximum number of desired frames, 1915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // which must be > 0. 1925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mNonContig is unused. 1935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mRaw is unused. 1945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // requested is the requested timeout in local monotonic delta time units: 1955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // NULL or &kNonBlocking means non-blocking (zero timeout). 1965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // &kForever means block forever (infinite timeout). 1975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Other values mean a specific timeout in local monotonic delta time units. 1985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // elapsed is a pointer to a location that will hold the total local monotonic time that 1995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // elapsed while blocked, or NULL if not needed. 2005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // On exit: 2015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mFrameCount has the actual number of contiguous available frames, 2025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // which is always 0 when the return status != NO_ERROR. 2035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mNonContig is the number of additional non-contiguous available frames. 2045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mRaw is a pointer to the first available frame, 205c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // or NULL when buffer->mFrameCount == 0. 206c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // The return status is one of: 207c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // NO_ERROR Success, buffer->mFrameCount > 0. 208c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // WOULD_BLOCK Non-blocking mode and no frames are available. 2095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // TIMED_OUT Timeout occurred before any frames became available. 2105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This can happen even for infinite timeout, due to a spurious wakeup. 2115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // In this case, the caller should investigate and then re-try as appropriate. 212116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch // DEAD_OBJECT Server has died or invalidated, caller should destroy this proxy and re-create. 2135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // -EINTR Call has been interrupted. Look around to see why, and then perhaps try again. 2145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // NO_INIT Shared memory is corrupt. 2155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Assertion failure on entry, if buffer == NULL or buffer->mFrameCount == 0. 2165d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) status_t obtainBuffer(Buffer* buffer, const struct timespec *requested = NULL, 2175d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) struct timespec *elapsed = NULL); 2185d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 2195d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // Release (some of) the frames last obtained. 2205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // On entry, buffer->mFrameCount should have the number of frames to release, 2215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // which must (cumulatively) be <= the number of frames last obtained but not yet released. 2225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mRaw is ignored, but is normally same pointer returned by last obtainBuffer(). 2235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // It is permitted to call releaseBuffer() multiple times to release the frames in chunks. 2245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // On exit: 2255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mFrameCount is zero. 2265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mRaw is NULL. 2275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void releaseBuffer(Buffer* buffer); 2285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Call after detecting server's death 2305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void binderDied(); 2315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Call to force an obtainBuffer() to return quickly with -EINTR 2335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void interrupt(); 2345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t getPosition() { 2365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return mEpoch + mCblk->mServer; 2375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 2385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void setEpoch(size_t epoch) { 2405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) mEpoch = epoch; 2415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 2425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void setMinimum(size_t minimum) { 2445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) mCblk->mMinimum = minimum; 2455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 2465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Return the number of frames that would need to be obtained and released 2485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // in order for the client to be aligned at start of buffer 2495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual size_t getMisalignment(); 2505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t getEpoch() const { 2525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return mEpoch; 2535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 2545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t getFramesFilled(); 256effb81e5f8246d0db0270817048dc992db66e9fbBen Murdoch 257effb81e5f8246d0db0270817048dc992db66e9fbBen Murdochprivate: 258effb81e5f8246d0db0270817048dc992db66e9fbBen Murdoch size_t mEpoch; 259effb81e5f8246d0db0270817048dc992db66e9fbBen Murdoch}; 260effb81e5f8246d0db0270817048dc992db66e9fbBen Murdoch 261effb81e5f8246d0db0270817048dc992db66e9fbBen Murdoch// ---------------------------------------------------------------------------- 2625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Proxy used by AudioTrack client, which also includes AudioFlinger::PlaybackThread::OutputTrack 2645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class AudioTrackClientProxy : public ClientProxy { 2655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)public: 2665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AudioTrackClientProxy(audio_track_cblk_t* cblk, void *buffers, size_t frameCount, 2675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t frameSize, bool clientInServer = false) 2685d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) : ClientProxy(cblk, buffers, frameCount, frameSize, true /*isOut*/, 2695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) clientInServer) { } 2705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~AudioTrackClientProxy() { } 2715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // No barriers on the following operations, so the ordering of loads/stores 2735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // with respect to other parameters is UNPREDICTABLE. That's considered safe. 2745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2755d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // caller must limit to 0.0 <= sendLevel <= 1.0 2765d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) void setSendLevel(float sendLevel) { 2775d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) mCblk->mSendLevel = uint16_t(sendLevel * 0x1000); 2785d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) } 2795d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 2805d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // caller must limit to 0 <= volumeLR <= 0x10001000 2815d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) void setVolumeLR(uint32_t volumeLR) { 2825d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) mCblk->mVolumeLR = volumeLR; 2835d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) } 2845d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) 2855d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) void setSampleRate(uint32_t sampleRate) { 2865d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) mCblk->mSampleRate = sampleRate; 2875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 2885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void flush(); 2905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual uint32_t getUnderrunFrames() const { 2925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return mCblk->u.mStreaming.mUnderrunFrames; 2935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 2945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool clearStreamEndDone(); // and return previous value 2965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool getStreamEndDone() const; 2985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) status_t waitStreamEndDone(const struct timespec *requested); 3005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 3015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class StaticAudioTrackClientProxy : public AudioTrackClientProxy { 3035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)public: 3045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) StaticAudioTrackClientProxy(audio_track_cblk_t* cblk, void *buffers, size_t frameCount, 3055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t frameSize); 3065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~StaticAudioTrackClientProxy() { } 3075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 308116680a4aac90f2aa7413d9095a592090648e557Ben Murdoch virtual void flush(); 3095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define MIN_LOOP 16 // minimum length of each loop iteration in frames 311cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) void setLoop(size_t loopStart, size_t loopEnd, int loopCount); 312cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) size_t getBufferPosition(); 313cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) 314cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) virtual size_t getMisalignment() { 315cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) return 0; 316cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) } 317cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) 318cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) virtual uint32_t getUnderrunFrames() const { 319cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) return 0; 320cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) } 321cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) 322cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles)private: 323cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) StaticAudioTrackSingleStateQueue::Mutator mMutator; 3245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t mBufferPosition; // so that getBufferPosition() appears to be synchronous 3255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 3265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3274e180b6a0b4720a9b8e9e959a882386f690f08ffTorne (Richard Coles)// ---------------------------------------------------------------------------- 3285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3293240926e260ce088908e02ac07a6cf7b0c0cbf44Ben Murdoch// Proxy used by AudioRecord client 3305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class AudioRecordClientProxy : public ClientProxy { 3315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)public: 3325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AudioRecordClientProxy(audio_track_cblk_t* cblk, void *buffers, size_t frameCount, 3335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t frameSize) 3345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : ClientProxy(cblk, buffers, frameCount, frameSize, 3355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) false /*isOut*/, false /*clientInServer*/) { } 3365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~AudioRecordClientProxy() { } 3375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 3385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// ---------------------------------------------------------------------------- 340c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 3415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Proxy used by AudioFlinger server 3425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class ServerProxy : public Proxy { 3435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)protected: 3445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ServerProxy(audio_track_cblk_t* cblk, void *buffers, size_t frameCount, size_t frameSize, 3455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool isOut, bool clientInServer); 3463240926e260ce088908e02ac07a6cf7b0c0cbf44Ben Murdochpublic: 3473240926e260ce088908e02ac07a6cf7b0c0cbf44Ben Murdoch virtual ~ServerProxy() { } 3483240926e260ce088908e02ac07a6cf7b0c0cbf44Ben Murdoch 3495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Obtain a buffer with filled frames (writing) or empty frames (reading). 3505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // It is permitted to call obtainBuffer() multiple times in succession, without any intervening 3515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // calls to releaseBuffer(). In that case, the final obtainBuffer() is the one that effectively 3525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // sets or extends the unreleased frame count. 3535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Always non-blocking. 3545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // On entry: 3555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mFrameCount should be initialized to maximum number of desired frames, 3565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // which must be > 0. 3575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mNonContig is unused. 3585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mRaw is unused. 3595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ackFlush is true iff being called from Track::start to acknowledge a pending flush. 3605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // On exit: 3615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mFrameCount has the actual number of contiguous available frames, 3625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // which is always 0 when the return status != NO_ERROR. 3635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mNonContig is the number of additional non-contiguous available frames. 3645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mRaw is a pointer to the first available frame, 3655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // or NULL when buffer->mFrameCount == 0. 3665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The return status is one of: 3675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // NO_ERROR Success, buffer->mFrameCount > 0. 3685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // WOULD_BLOCK No frames are available. 3695d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) // NO_INIT Shared memory is corrupt. 3705d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles) virtual status_t obtainBuffer(Buffer* buffer, bool ackFlush = false); 3715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Release (some of) the frames last obtained. 3735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // On entry, buffer->mFrameCount should have the number of frames to release, 3745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // which must (cumulatively) be <= the number of frames last obtained but not yet released. 3755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // It is permitted to call releaseBuffer() multiple times to release the frames in chunks. 3765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mRaw is ignored, but is normally same pointer returned by last obtainBuffer(). 3775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // On exit: 3785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mFrameCount is zero. 3795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // buffer->mRaw is NULL. 3805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void releaseBuffer(Buffer* buffer); 3815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)protected: 3835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t mAvailToClient; // estimated frames available to client prior to releaseBuffer() 3845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int32_t mFlush; // our copy of cblk->u.mStreaming.mFlush, for streaming output only 3855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 3865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Proxy used by AudioFlinger for servicing AudioTrack 3885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class AudioTrackServerProxy : public ServerProxy { 3895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)public: 3905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AudioTrackServerProxy(audio_track_cblk_t* cblk, void *buffers, size_t frameCount, 3915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t frameSize, bool clientInServer = false) 3925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : ServerProxy(cblk, buffers, frameCount, frameSize, true /*isOut*/, clientInServer) { } 3935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)protected: 3945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~AudioTrackServerProxy() { } 3955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 39668043e1e95eeb07d5cae7aca370b26518b0867d6Torne (Richard Coles)public: 39768043e1e95eeb07d5cae7aca370b26518b0867d6Torne (Richard Coles) // return value of these methods must be validated by the caller 39868043e1e95eeb07d5cae7aca370b26518b0867d6Torne (Richard Coles) uint32_t getSampleRate() const { return mCblk->mSampleRate; } 39968043e1e95eeb07d5cae7aca370b26518b0867d6Torne (Richard Coles) uint16_t getSendLevel_U4_12() const { return mCblk->mSendLevel; } 40068043e1e95eeb07d5cae7aca370b26518b0867d6Torne (Richard Coles) uint32_t getVolumeLR() const { return mCblk->mVolumeLR; } 4015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // estimated total number of filled frames available to server to read, 4035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // which may include non-contiguous frames 4045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual size_t framesReady(); 4055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Currently AudioFlinger will call framesReady() for a fast track from two threads: 4075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // FastMixer thread, and normal mixer thread. This is dangerous, as the proxy is intended 4085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // to be called from at most one thread of server, and one thread of client. 4095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // As a temporary workaround, this method informs the proxy implementation that it 4105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // should avoid doing a state queue poll from within framesReady(). 4115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // FIXME Change AudioFlinger to not call framesReady() from normal mixer thread. 4125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void framesReadyIsCalledByMultipleThreads() { } 4135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool setStreamEndDone(); // and return previous value 4155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Add to the tally of underrun frames, and inform client of underrun 4175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void tallyUnderrunFrames(uint32_t frameCount); 4185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Return the total number of frames which AudioFlinger desired but were unavailable, 4205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // and thus which resulted in an underrun. 4215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual uint32_t getUnderrunFrames() const { return mCblk->u.mStreaming.mUnderrunFrames; } 422c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 423c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // Return the total number of frames that AudioFlinger has obtained and released 424c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) virtual size_t framesReleased() const { return mCblk->mServer; } 4255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 4265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class StaticAudioTrackServerProxy : public AudioTrackServerProxy { 4285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)public: 4295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) StaticAudioTrackServerProxy(audio_track_cblk_t* cblk, void *buffers, size_t frameCount, 4305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t frameSize); 4315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)protected: 4325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~StaticAudioTrackServerProxy() { } 4335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)public: 4355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual size_t framesReady(); 4365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void framesReadyIsCalledByMultipleThreads(); 4375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual status_t obtainBuffer(Buffer* buffer, bool ackFlush); 4385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void releaseBuffer(Buffer* buffer); 4393240926e260ce088908e02ac07a6cf7b0c0cbf44Ben Murdoch virtual void tallyUnderrunFrames(uint32_t frameCount); 4403240926e260ce088908e02ac07a6cf7b0c0cbf44Ben Murdoch virtual uint32_t getUnderrunFrames() const { return 0; } 4413240926e260ce088908e02ac07a6cf7b0c0cbf44Ben Murdoch 4425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)private: 4435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ssize_t pollPosition(); // poll for state queue update, and return current position 4445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) StaticAudioTrackSingleStateQueue::Observer mObserver; 4455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t mPosition; // server's current play position in frames, relative to 0 4465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t mEnd; // cached value computed from mState, safe for asynchronous read 4475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool mFramesReadyIsCalledByMultipleThreads; 4485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) StaticAudioTrackState mState; 4495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 4505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Proxy used by AudioFlinger for servicing AudioRecord 4525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class AudioRecordServerProxy : public ServerProxy { 4535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)public: 4545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AudioRecordServerProxy(audio_track_cblk_t* cblk, void *buffers, size_t frameCount, 4555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t frameSize) 4565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : ServerProxy(cblk, buffers, frameCount, frameSize, false /*isOut*/, 4575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) false /*clientInServer*/) { } 4585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)protected: 4595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~AudioRecordServerProxy() { } 460c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles)}; 461c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) 4625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// ---------------------------------------------------------------------------- 4635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; // namespace android 4655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // ANDROID_AUDIO_TRACK_SHARED_H 4675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)