197b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten/* 297b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * Copyright (C) 2012 The Android Open Source Project 397b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * 497b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * Licensed under the Apache License, Version 2.0 (the "License"); 597b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * you may not use this file except in compliance with the License. 697b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * You may obtain a copy of the License at 797b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * 897b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * http://www.apache.org/licenses/LICENSE-2.0 997b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * 1097b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * Unless required by applicable law or agreed to in writing, software 1197b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * distributed under the License is distributed on an "AS IS" BASIS, 1297b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1397b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * See the License for the specific language governing permissions and 1497b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten * limitations under the License. 1597b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten */ 1697b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 1797b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten#ifndef ANDROID_AUDIO_FAST_MIXER_H 1897b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten#define ANDROID_AUDIO_FAST_MIXER_H 1997b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 2009474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten#include <utils/Debug.h> 2197b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten#include <utils/Thread.h> 2297b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kastenextern "C" { 2397b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten#include "../private/bionic_futex.h" 2497b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten} 2597b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten#include "StateQueue.h" 2697b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten#include "FastMixerState.h" 2797b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 2897b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kastennamespace android { 2997b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 3097b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kastentypedef StateQueue<FastMixerState> FastMixerStateQueue; 3197b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 3297b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kastenclass FastMixer : public Thread { 3397b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 3497b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kastenpublic: 3597b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten FastMixer() : Thread(false /*canCallJava*/) { } 3697b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten virtual ~FastMixer() { } 3797b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 3897b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten FastMixerStateQueue* sq() { return &mSQ; } 3997b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 4097b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kastenprivate: 4197b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten virtual bool threadLoop(); 4297b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten FastMixerStateQueue mSQ; 4397b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 4497b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten}; // class FastMixer 4597b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 4609474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten// Describes the underrun status for a single "pull" attempt 4709474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kastenenum FastTrackUnderrunStatus { 4809474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten UNDERRUN_FULL, // framesReady() is full frame count, no underrun 4909474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten UNDERRUN_PARTIAL, // framesReady() is non-zero but < full frame count, partial underrun 5009474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten UNDERRUN_EMPTY, // framesReady() is zero, total underrun 5109474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten}; 5209474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten 5309474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten// Underrun counters are not reset to zero for new tracks or if track generation changes. 5409474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten// This packed representation is used to keep the information atomic. 5509474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kastenunion FastTrackUnderruns { 5609474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten FastTrackUnderruns() { mAtomic = 0; 5709474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten COMPILE_TIME_ASSERT_FUNCTION_SCOPE(sizeof(FastTrackUnderruns) == sizeof(uint32_t)); } 5809474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten FastTrackUnderruns(const FastTrackUnderruns& copyFrom) : mAtomic(copyFrom.mAtomic) { } 5909474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten FastTrackUnderruns& operator=(const FastTrackUnderruns& rhs) 6009474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten { if (this != &rhs) mAtomic = rhs.mAtomic; return *this; } 6109474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten struct { 6209474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten#define UNDERRUN_BITS 10 6309474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten#define UNDERRUN_MASK ((1 << UNDERRUN_BITS) - 1) 6409474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten uint32_t mFull : UNDERRUN_BITS; // framesReady() is full frame count 6509474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten uint32_t mPartial : UNDERRUN_BITS; // framesReady() is non-zero but < full frame count 6609474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten uint32_t mEmpty : UNDERRUN_BITS; // framesReady() is zero 6709474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten FastTrackUnderrunStatus mMostRecent : 2; // status of most recent framesReady() 6809474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten } mBitFields; 6909474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kastenprivate: 7009474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten uint32_t mAtomic; 7109474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten}; 7209474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten 73288ed2103d96f3aabd7e6bea3c080ab6db164049Glenn Kasten// Represents the dump state of a fast track 74288ed2103d96f3aabd7e6bea3c080ab6db164049Glenn Kastenstruct FastTrackDump { 751295bb4dcff7b29c75cd23746816df12a871d72cGlenn Kasten FastTrackDump() : mFramesReady(0) { } 76288ed2103d96f3aabd7e6bea3c080ab6db164049Glenn Kasten /*virtual*/ ~FastTrackDump() { } 7709474df67278c0cd621b57c4aef1deaec4d8447fGlenn Kasten FastTrackUnderruns mUnderruns; 781295bb4dcff7b29c75cd23746816df12a871d72cGlenn Kasten size_t mFramesReady; // most recent value only; no long-term statistics kept 79288ed2103d96f3aabd7e6bea3c080ab6db164049Glenn Kasten}; 80288ed2103d96f3aabd7e6bea3c080ab6db164049Glenn Kasten 8197b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten// The FastMixerDumpState keeps a cache of FastMixer statistics that can be logged by dumpsys. 82288ed2103d96f3aabd7e6bea3c080ab6db164049Glenn Kasten// Each individual native word-sized field is accessed atomically. But the 83288ed2103d96f3aabd7e6bea3c080ab6db164049Glenn Kasten// overall structure is non-atomic, that is there may be an inconsistency between fields. 84288ed2103d96f3aabd7e6bea3c080ab6db164049Glenn Kasten// No barriers or locks are used for either writing or reading. 85288ed2103d96f3aabd7e6bea3c080ab6db164049Glenn Kasten// Only POD types are permitted, and the contents shouldn't be trusted (i.e. do range checks). 8697b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten// It has a different lifetime than the FastMixer, and so it can't be a member of FastMixer. 8797b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kastenstruct FastMixerDumpState { 8897b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten FastMixerDumpState(); 8997b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten /*virtual*/ ~FastMixerDumpState(); 9097b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 9142d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten void dump(int fd); // should only be called on a stable copy, not the original 9297b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 9397b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten FastMixerState::Command mCommand; // current command 9497b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten uint32_t mWriteSequence; // incremented before and after each write() 9597b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten uint32_t mFramesWritten; // total number of frames written successfully 9697b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten uint32_t mNumTracks; // total number of active fast tracks 9797b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten uint32_t mWriteErrors; // total number of write() errors 9897b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten uint32_t mUnderruns; // total number of underruns 9997b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten uint32_t mOverruns; // total number of overruns 10021e8c50bd13ebe44f3088e26c9c6df0e163c469cGlenn Kasten uint32_t mSampleRate; 10121e8c50bd13ebe44f3088e26c9c6df0e163c469cGlenn Kasten size_t mFrameCount; 102288ed2103d96f3aabd7e6bea3c080ab6db164049Glenn Kasten struct timespec mMeasuredWarmupTs; // measured warmup time 103288ed2103d96f3aabd7e6bea3c080ab6db164049Glenn Kasten uint32_t mWarmupCycles; // number of loop cycles required to warmup 1041295bb4dcff7b29c75cd23746816df12a871d72cGlenn Kasten uint32_t mTrackMask; // mask of active tracks 105288ed2103d96f3aabd7e6bea3c080ab6db164049Glenn Kasten FastTrackDump mTracks[FastMixerState::kMaxFastTracks]; 10642d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten 10797b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten#ifdef FAST_MIXER_STATISTICS 10842d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten // Recently collected samples of per-cycle monotonic time, thread CPU time, and CPU frequency. 10942d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten // kSamplingN is the size of the sampling frame, and must be a power of 2 <= 0x8000. 11042d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten static const uint32_t kSamplingN = 0x1000; 11142d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten // The bounds define the interval of valid samples, and are represented as follows: 11242d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten // newest open (excluded) endpoint = lower 16 bits of bounds, modulo N 11342d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten // oldest closed (included) endpoint = upper 16 bits of bounds, modulo N 11442d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten // Number of valid samples is newest - oldest. 11542d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten uint32_t mBounds; // bounds for mMonotonicNs, mThreadCpuNs, and mCpukHz 11642d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten // The elements in the *Ns arrays are in units of nanoseconds <= 3999999999. 11742d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten uint32_t mMonotonicNs[kSamplingN]; // delta monotonic (wall clock) time 11842d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten uint32_t mLoadNs[kSamplingN]; // delta CPU load in time 1190a14c4ce1a41bc09eb7855fa531a3af629a69139Glenn Kasten#ifdef CPU_FREQUENCY_STATISTICS 12042d45cfd0c3d62357a6549c62f535e4d4fe08d91Glenn Kasten uint32_t mCpukHz[kSamplingN]; // absolute CPU clock frequency in kHz, bits 0-3 are CPU# 12197b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten#endif 1220a14c4ce1a41bc09eb7855fa531a3af629a69139Glenn Kasten#endif 12397b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten}; 12497b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 12597b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten} // namespace android 12697b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten 12797b5d0d5b5ef766eb5dd680d05a5d199662d4ae0Glenn Kasten#endif // ANDROID_AUDIO_FAST_MIXER_H 128