1/*
2 * Copyright (C) 2009 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17
18#include <stdint.h>
19#include <sys/types.h>
20#include <cutils/config_utils.h>
21#include <cutils/misc.h>
22#include <utils/Timers.h>
23#include <utils/Errors.h>
24#include <utils/KeyedVector.h>
25#include <utils/SortedVector.h>
26#include <hardware_legacy/AudioPolicyInterface.h>
27
28
29namespace android_audio_legacy {
30    using android::KeyedVector;
31    using android::DefaultKeyedVector;
32    using android::SortedVector;
33
34// ----------------------------------------------------------------------------
35
36#define MAX_DEVICE_ADDRESS_LEN 20
37// Attenuation applied to STRATEGY_SONIFICATION streams when a headset is connected: 6dB
38#define SONIFICATION_HEADSET_VOLUME_FACTOR 0.5
39// Min volume for STRATEGY_SONIFICATION streams when limited by music volume: -36dB
40#define SONIFICATION_HEADSET_VOLUME_MIN  0.016
41// Time in milliseconds during which we consider that music is still active after a music
42// track was stopped - see computeVolume()
43#define SONIFICATION_HEADSET_MUSIC_DELAY  5000
44// Time in milliseconds after media stopped playing during which we consider that the
45// sonification should be as unobtrusive as during the time media was playing.
46#define SONIFICATION_RESPECTFUL_AFTER_MUSIC_DELAY 5000
47// Time in milliseconds during witch some streams are muted while the audio path
48// is switched
49#define MUTE_TIME_MS 2000
50
51#define NUM_TEST_OUTPUTS 5
52
53#define NUM_VOL_CURVE_KNEES 2
54
55// Default minimum length allowed for offloading a compressed track
56// Can be overridden by the audio.offload.min.duration.secs property
57#define OFFLOAD_DEFAULT_MIN_DURATION_SECS 60
58
59// ----------------------------------------------------------------------------
60// AudioPolicyManagerBase implements audio policy manager behavior common to all platforms.
61// Each platform must implement an AudioPolicyManager class derived from AudioPolicyManagerBase
62// and override methods for which the platform specific behavior differs from the implementation
63// in AudioPolicyManagerBase. Even if no specific behavior is required, the AudioPolicyManager
64// class must be implemented as well as the class factory function createAudioPolicyManager()
65// and provided in a shared library libaudiopolicy.so.
66// ----------------------------------------------------------------------------
67
68class AudioPolicyManagerBase: public AudioPolicyInterface
69#ifdef AUDIO_POLICY_TEST
70    , public Thread
71#endif //AUDIO_POLICY_TEST
72{
73
74public:
75                AudioPolicyManagerBase(AudioPolicyClientInterface *clientInterface);
76        virtual ~AudioPolicyManagerBase();
77
78        // AudioPolicyInterface
79        virtual status_t setDeviceConnectionState(audio_devices_t device,
80                                                          AudioSystem::device_connection_state state,
81                                                          const char *device_address);
82        virtual AudioSystem::device_connection_state getDeviceConnectionState(audio_devices_t device,
83                                                                              const char *device_address);
84        virtual void setPhoneState(int state);
85        virtual void setForceUse(AudioSystem::force_use usage, AudioSystem::forced_config config);
86        virtual AudioSystem::forced_config getForceUse(AudioSystem::force_use usage);
87        virtual void setSystemProperty(const char* property, const char* value);
88        virtual status_t initCheck();
89        virtual audio_io_handle_t getOutput(AudioSystem::stream_type stream,
90                                            uint32_t samplingRate,
91                                            audio_format_t format,
92                                            audio_channel_mask_t channelMask,
93                                            AudioSystem::output_flags flags,
94                                            const audio_offload_info_t *offloadInfo);
95        virtual status_t startOutput(audio_io_handle_t output,
96                                     AudioSystem::stream_type stream,
97                                     int session = 0);
98        virtual status_t stopOutput(audio_io_handle_t output,
99                                    AudioSystem::stream_type stream,
100                                    int session = 0);
101        virtual void releaseOutput(audio_io_handle_t output);
102        virtual audio_io_handle_t getInput(int inputSource,
103                                            uint32_t samplingRate,
104                                            audio_format_t format,
105                                            audio_channel_mask_t channelMask,
106                                            AudioSystem::audio_in_acoustics acoustics);
107
108        // indicates to the audio policy manager that the input starts being used.
109        virtual status_t startInput(audio_io_handle_t input);
110
111        // indicates to the audio policy manager that the input stops being used.
112        virtual status_t stopInput(audio_io_handle_t input);
113        virtual void releaseInput(audio_io_handle_t input);
114        virtual void closeAllInputs();
115        virtual void initStreamVolume(AudioSystem::stream_type stream,
116                                                    int indexMin,
117                                                    int indexMax);
118        virtual status_t setStreamVolumeIndex(AudioSystem::stream_type stream,
119                                              int index,
120                                              audio_devices_t device);
121        virtual status_t getStreamVolumeIndex(AudioSystem::stream_type stream,
122                                              int *index,
123                                              audio_devices_t device);
124
125        // return the strategy corresponding to a given stream type
126        virtual uint32_t getStrategyForStream(AudioSystem::stream_type stream);
127
128        // return the enabled output devices for the given stream type
129        virtual audio_devices_t getDevicesForStream(AudioSystem::stream_type stream);
130
131        virtual audio_io_handle_t getOutputForEffect(const effect_descriptor_t *desc = NULL);
132        virtual status_t registerEffect(const effect_descriptor_t *desc,
133                                        audio_io_handle_t io,
134                                        uint32_t strategy,
135                                        int session,
136                                        int id);
137        virtual status_t unregisterEffect(int id);
138        virtual status_t setEffectEnabled(int id, bool enabled);
139
140        virtual bool isStreamActive(int stream, uint32_t inPastMs = 0) const;
141        // return whether a stream is playing remotely, override to change the definition of
142        //   local/remote playback, used for instance by notification manager to not make
143        //   media players lose audio focus when not playing locally
144        virtual bool isStreamActiveRemotely(int stream, uint32_t inPastMs = 0) const;
145        virtual bool isSourceActive(audio_source_t source) const;
146
147        virtual status_t dump(int fd);
148
149        virtual bool isOffloadSupported(const audio_offload_info_t& offloadInfo);
150
151protected:
152
153        enum routing_strategy {
154            STRATEGY_MEDIA,
155            STRATEGY_PHONE,
156            STRATEGY_SONIFICATION,
157            STRATEGY_SONIFICATION_RESPECTFUL,
158            STRATEGY_DTMF,
159            STRATEGY_ENFORCED_AUDIBLE,
160            NUM_STRATEGIES
161        };
162
163        // 4 points to define the volume attenuation curve, each characterized by the volume
164        // index (from 0 to 100) at which they apply, and the attenuation in dB at that index.
165        // we use 100 steps to avoid rounding errors when computing the volume in volIndexToAmpl()
166
167        enum { VOLMIN = 0, VOLKNEE1 = 1, VOLKNEE2 = 2, VOLMAX = 3, VOLCNT = 4};
168
169        class VolumeCurvePoint
170        {
171        public:
172            int mIndex;
173            float mDBAttenuation;
174        };
175
176        // device categories used for volume curve management.
177        enum device_category {
178            DEVICE_CATEGORY_HEADSET,
179            DEVICE_CATEGORY_SPEAKER,
180            DEVICE_CATEGORY_EARPIECE,
181            DEVICE_CATEGORY_CNT
182        };
183
184        class IOProfile;
185
186        class HwModule {
187        public:
188                    HwModule(const char *name);
189                    ~HwModule();
190
191            void dump(int fd);
192
193            const char *const mName; // base name of the audio HW module (primary, a2dp ...)
194            audio_module_handle_t mHandle;
195            Vector <IOProfile *> mOutputProfiles; // output profiles exposed by this module
196            Vector <IOProfile *> mInputProfiles;  // input profiles exposed by this module
197        };
198
199        // the IOProfile class describes the capabilities of an output or input stream.
200        // It is currently assumed that all combination of listed parameters are supported.
201        // It is used by the policy manager to determine if an output or input is suitable for
202        // a given use case,  open/close it accordingly and connect/disconnect audio tracks
203        // to/from it.
204        class IOProfile
205        {
206        public:
207            IOProfile(HwModule *module);
208            ~IOProfile();
209
210            bool isCompatibleProfile(audio_devices_t device,
211                                     uint32_t samplingRate,
212                                     audio_format_t format,
213                                     audio_channel_mask_t channelMask,
214                                     audio_output_flags_t flags) const;
215
216            void dump(int fd);
217            void log();
218
219            // by convention, "0' in the first entry in mSamplingRates, mChannelMasks or mFormats
220            // indicates the supported parameters should be read from the output stream
221            // after it is opened for the first time
222            Vector <uint32_t> mSamplingRates; // supported sampling rates
223            Vector <audio_channel_mask_t> mChannelMasks; // supported channel masks
224            Vector <audio_format_t> mFormats; // supported audio formats
225            audio_devices_t mSupportedDevices; // supported devices (devices this output can be
226                                               // routed to)
227            audio_output_flags_t mFlags; // attribute flags (e.g primary output,
228                                                // direct output...). For outputs only.
229            HwModule *mModule;                     // audio HW module exposing this I/O stream
230        };
231
232        // default volume curve
233        static const VolumeCurvePoint sDefaultVolumeCurve[AudioPolicyManagerBase::VOLCNT];
234        // default volume curve for media strategy
235        static const VolumeCurvePoint sDefaultMediaVolumeCurve[AudioPolicyManagerBase::VOLCNT];
236        // volume curve for media strategy on speakers
237        static const VolumeCurvePoint sSpeakerMediaVolumeCurve[AudioPolicyManagerBase::VOLCNT];
238        // volume curve for sonification strategy on speakers
239        static const VolumeCurvePoint sSpeakerSonificationVolumeCurve[AudioPolicyManagerBase::VOLCNT];
240        static const VolumeCurvePoint sSpeakerSonificationVolumeCurveDrc[AudioPolicyManagerBase::VOLCNT];
241        static const VolumeCurvePoint sDefaultSystemVolumeCurve[AudioPolicyManagerBase::VOLCNT];
242        static const VolumeCurvePoint sDefaultSystemVolumeCurveDrc[AudioPolicyManagerBase::VOLCNT];
243        static const VolumeCurvePoint sHeadsetSystemVolumeCurve[AudioPolicyManagerBase::VOLCNT];
244        static const VolumeCurvePoint sDefaultVoiceVolumeCurve[AudioPolicyManagerBase::VOLCNT];
245        static const VolumeCurvePoint sSpeakerVoiceVolumeCurve[AudioPolicyManagerBase::VOLCNT];
246        // default volume curves per stream and device category. See initializeVolumeCurves()
247        static const VolumeCurvePoint *sVolumeProfiles[AudioSystem::NUM_STREAM_TYPES][DEVICE_CATEGORY_CNT];
248
249        // descriptor for audio outputs. Used to maintain current configuration of each opened audio output
250        // and keep track of the usage of this output by each audio stream type.
251        class AudioOutputDescriptor
252        {
253        public:
254            AudioOutputDescriptor(const IOProfile *profile);
255
256            status_t    dump(int fd);
257
258            audio_devices_t device() const;
259            void changeRefCount(AudioSystem::stream_type stream, int delta);
260
261            bool isDuplicated() const { return (mOutput1 != NULL && mOutput2 != NULL); }
262            audio_devices_t supportedDevices();
263            uint32_t latency();
264            bool sharesHwModuleWith(const AudioOutputDescriptor *outputDesc);
265            bool isActive(uint32_t inPastMs = 0) const;
266            bool isStreamActive(AudioSystem::stream_type stream,
267                                uint32_t inPastMs = 0,
268                                nsecs_t sysTime = 0) const;
269            bool isStrategyActive(routing_strategy strategy,
270                             uint32_t inPastMs = 0,
271                             nsecs_t sysTime = 0) const;
272
273            audio_io_handle_t mId;              // output handle
274            uint32_t mSamplingRate;             //
275            audio_format_t mFormat;             //
276            audio_channel_mask_t mChannelMask;     // output configuration
277            uint32_t mLatency;                  //
278            audio_output_flags_t mFlags;   //
279            audio_devices_t mDevice;                   // current device this output is routed to
280            uint32_t mRefCount[AudioSystem::NUM_STREAM_TYPES]; // number of streams of each type using this output
281            nsecs_t mStopTime[AudioSystem::NUM_STREAM_TYPES];
282            AudioOutputDescriptor *mOutput1;    // used by duplicated outputs: first output
283            AudioOutputDescriptor *mOutput2;    // used by duplicated outputs: second output
284            float mCurVolume[AudioSystem::NUM_STREAM_TYPES];   // current stream volume
285            int mMuteCount[AudioSystem::NUM_STREAM_TYPES];     // mute request counter
286            const IOProfile *mProfile;          // I/O profile this output derives from
287            bool mStrategyMutedByDevice[NUM_STRATEGIES]; // strategies muted because of incompatible
288                                                // device selection. See checkDeviceMuteStrategies()
289            uint32_t mDirectOpenCount; // number of clients using this output (direct outputs only)
290        };
291
292        // descriptor for audio inputs. Used to maintain current configuration of each opened audio input
293        // and keep track of the usage of this input.
294        class AudioInputDescriptor
295        {
296        public:
297            AudioInputDescriptor(const IOProfile *profile);
298
299            status_t    dump(int fd);
300
301            audio_io_handle_t mId;                      // input handle
302            uint32_t mSamplingRate;                     //
303            audio_format_t mFormat;                     // input configuration
304            audio_channel_mask_t mChannelMask;             //
305            audio_devices_t mDevice;                    // current device this input is routed to
306            uint32_t mRefCount;                         // number of AudioRecord clients using this output
307            int      mInputSource;                      // input source selected by application (mediarecorder.h)
308            const IOProfile *mProfile;                  // I/O profile this output derives from
309        };
310
311        // stream descriptor used for volume control
312        class StreamDescriptor
313        {
314        public:
315            StreamDescriptor();
316
317            int getVolumeIndex(audio_devices_t device);
318            void dump(int fd);
319
320            int mIndexMin;      // min volume index
321            int mIndexMax;      // max volume index
322            KeyedVector<audio_devices_t, int> mIndexCur;   // current volume index per device
323            bool mCanBeMuted;   // true is the stream can be muted
324
325            const VolumeCurvePoint *mVolumeCurve[DEVICE_CATEGORY_CNT];
326        };
327
328        // stream descriptor used for volume control
329        class EffectDescriptor
330        {
331        public:
332
333            status_t dump(int fd);
334
335            int mIo;                // io the effect is attached to
336            routing_strategy mStrategy; // routing strategy the effect is associated to
337            int mSession;               // audio session the effect is on
338            effect_descriptor_t mDesc;  // effect descriptor
339            bool mEnabled;              // enabled state: CPU load being used or not
340        };
341
342        void addOutput(audio_io_handle_t id, AudioOutputDescriptor *outputDesc);
343        void addInput(audio_io_handle_t id, AudioInputDescriptor *inputDesc);
344
345        // return the strategy corresponding to a given stream type
346        static routing_strategy getStrategy(AudioSystem::stream_type stream);
347
348        // return appropriate device for streams handled by the specified strategy according to current
349        // phone state, connected devices...
350        // if fromCache is true, the device is returned from mDeviceForStrategy[],
351        // otherwise it is determine by current state
352        // (device connected,phone state, force use, a2dp output...)
353        // This allows to:
354        //  1 speed up process when the state is stable (when starting or stopping an output)
355        //  2 access to either current device selection (fromCache == true) or
356        // "future" device selection (fromCache == false) when called from a context
357        //  where conditions are changing (setDeviceConnectionState(), setPhoneState()...) AND
358        //  before updateDevicesAndOutputs() is called.
359        virtual audio_devices_t getDeviceForStrategy(routing_strategy strategy,
360                                                     bool fromCache);
361
362        // change the route of the specified output. Returns the number of ms we have slept to
363        // allow new routing to take effect in certain cases.
364        uint32_t setOutputDevice(audio_io_handle_t output,
365                             audio_devices_t device,
366                             bool force = false,
367                             int delayMs = 0);
368
369        // select input device corresponding to requested audio source
370        virtual audio_devices_t getDeviceForInputSource(int inputSource);
371
372        // return io handle of active input or 0 if no input is active
373        //    Only considers inputs from physical devices (e.g. main mic, headset mic) when
374        //    ignoreVirtualInputs is true.
375        audio_io_handle_t getActiveInput(bool ignoreVirtualInputs = true);
376
377        // initialize volume curves for each strategy and device category
378        void initializeVolumeCurves();
379
380        // compute the actual volume for a given stream according to the requested index and a particular
381        // device
382        virtual float computeVolume(int stream, int index, audio_io_handle_t output, audio_devices_t device);
383
384        // check that volume change is permitted, compute and send new volume to audio hardware
385        status_t checkAndSetVolume(int stream, int index, audio_io_handle_t output, audio_devices_t device, int delayMs = 0, bool force = false);
386
387        // apply all stream volumes to the specified output and device
388        void applyStreamVolumes(audio_io_handle_t output, audio_devices_t device, int delayMs = 0, bool force = false);
389
390        // Mute or unmute all streams handled by the specified strategy on the specified output
391        void setStrategyMute(routing_strategy strategy,
392                             bool on,
393                             audio_io_handle_t output,
394                             int delayMs = 0,
395                             audio_devices_t device = (audio_devices_t)0);
396
397        // Mute or unmute the stream on the specified output
398        void setStreamMute(int stream,
399                           bool on,
400                           audio_io_handle_t output,
401                           int delayMs = 0,
402                           audio_devices_t device = (audio_devices_t)0);
403
404        // handle special cases for sonification strategy while in call: mute streams or replace by
405        // a special tone in the device used for communication
406        void handleIncallSonification(int stream, bool starting, bool stateChange);
407
408        // true if device is in a telephony or VoIP call
409        virtual bool isInCall();
410
411        // true if given state represents a device in a telephony or VoIP call
412        virtual bool isStateInCall(int state);
413
414        // when a device is connected, checks if an open output can be routed
415        // to this device. If none is open, tries to open one of the available outputs.
416        // Returns an output suitable to this device or 0.
417        // when a device is disconnected, checks if an output is not used any more and
418        // returns its handle if any.
419        // transfers the audio tracks and effects from one output thread to another accordingly.
420        status_t checkOutputsForDevice(audio_devices_t device,
421                                       AudioSystem::device_connection_state state,
422                                       SortedVector<audio_io_handle_t>& outputs,
423                                       const String8 paramStr);
424
425        status_t checkInputsForDevice(audio_devices_t device,
426                                      AudioSystem::device_connection_state state,
427                                      SortedVector<audio_io_handle_t>& inputs,
428                                      const String8 paramStr);
429
430        // close an output and its companion duplicating output.
431        void closeOutput(audio_io_handle_t output);
432
433        // checks and if necessary changes outputs used for all strategies.
434        // must be called every time a condition that affects the output choice for a given strategy
435        // changes: connected device, phone state, force use...
436        // Must be called before updateDevicesAndOutputs()
437        void checkOutputForStrategy(routing_strategy strategy);
438
439        // Same as checkOutputForStrategy() but for a all strategies in order of priority
440        void checkOutputForAllStrategies();
441
442        // manages A2DP output suspend/restore according to phone state and BT SCO usage
443        void checkA2dpSuspend();
444
445        // returns the A2DP output handle if it is open or 0 otherwise
446        audio_io_handle_t getA2dpOutput();
447
448        // selects the most appropriate device on output for current state
449        // must be called every time a condition that affects the device choice for a given output is
450        // changed: connected device, phone state, force use, output start, output stop..
451        // see getDeviceForStrategy() for the use of fromCache parameter
452
453        audio_devices_t getNewDevice(audio_io_handle_t output, bool fromCache);
454        // updates cache of device used by all strategies (mDeviceForStrategy[])
455        // must be called every time a condition that affects the device choice for a given strategy is
456        // changed: connected device, phone state, force use...
457        // cached values are used by getDeviceForStrategy() if parameter fromCache is true.
458         // Must be called after checkOutputForAllStrategies()
459
460        void updateDevicesAndOutputs();
461
462        virtual uint32_t getMaxEffectsCpuLoad();
463        virtual uint32_t getMaxEffectsMemory();
464#ifdef AUDIO_POLICY_TEST
465        virtual     bool        threadLoop();
466                    void        exit();
467        int testOutputIndex(audio_io_handle_t output);
468#endif //AUDIO_POLICY_TEST
469
470        status_t setEffectEnabled(EffectDescriptor *pDesc, bool enabled);
471
472        // returns the category the device belongs to with regard to volume curve management
473        static device_category getDeviceCategory(audio_devices_t device);
474
475        // extract one device relevant for volume control from multiple device selection
476        static audio_devices_t getDeviceForVolume(audio_devices_t device);
477
478        SortedVector<audio_io_handle_t> getOutputsForDevice(audio_devices_t device,
479                        DefaultKeyedVector<audio_io_handle_t, AudioOutputDescriptor *> openOutputs);
480        bool vectorsEqual(SortedVector<audio_io_handle_t>& outputs1,
481                                           SortedVector<audio_io_handle_t>& outputs2);
482
483        // mute/unmute strategies using an incompatible device combination
484        // if muting, wait for the audio in pcm buffer to be drained before proceeding
485        // if unmuting, unmute only after the specified delay
486        // Returns the number of ms waited
487        uint32_t  checkDeviceMuteStrategies(AudioOutputDescriptor *outputDesc,
488                                            audio_devices_t prevDevice,
489                                            uint32_t delayMs);
490
491        audio_io_handle_t selectOutput(const SortedVector<audio_io_handle_t>& outputs,
492                                       AudioSystem::output_flags flags);
493        IOProfile *getInputProfile(audio_devices_t device,
494                                   uint32_t samplingRate,
495                                   audio_format_t format,
496                                   audio_channel_mask_t channelMask);
497        IOProfile *getProfileForDirectOutput(audio_devices_t device,
498                                                       uint32_t samplingRate,
499                                                       audio_format_t format,
500                                                       audio_channel_mask_t channelMask,
501                                                       audio_output_flags_t flags);
502
503        audio_io_handle_t selectOutputForEffects(const SortedVector<audio_io_handle_t>& outputs);
504
505        bool isNonOffloadableEffectEnabled();
506
507        //
508        // Audio policy configuration file parsing (audio_policy.conf)
509        //
510        static uint32_t stringToEnum(const struct StringToEnum *table,
511                                     size_t size,
512                                     const char *name);
513        static bool stringToBool(const char *value);
514        static audio_output_flags_t parseFlagNames(char *name);
515        static audio_devices_t parseDeviceNames(char *name);
516        void loadSamplingRates(char *name, IOProfile *profile);
517        void loadFormats(char *name, IOProfile *profile);
518        void loadOutChannels(char *name, IOProfile *profile);
519        void loadInChannels(char *name, IOProfile *profile);
520        status_t loadOutput(cnode *root,  HwModule *module);
521        status_t loadInput(cnode *root,  HwModule *module);
522        void loadHwModule(cnode *root);
523        void loadHwModules(cnode *root);
524        void loadGlobalConfig(cnode *root);
525        status_t loadAudioPolicyConfig(const char *path);
526        void defaultAudioPolicyConfig(void);
527
528
529        AudioPolicyClientInterface *mpClientInterface;  // audio policy client interface
530        audio_io_handle_t mPrimaryOutput;              // primary output handle
531        // list of descriptors for outputs currently opened
532        DefaultKeyedVector<audio_io_handle_t, AudioOutputDescriptor *> mOutputs;
533        // copy of mOutputs before setDeviceConnectionState() opens new outputs
534        // reset to mOutputs when updateDevicesAndOutputs() is called.
535        DefaultKeyedVector<audio_io_handle_t, AudioOutputDescriptor *> mPreviousOutputs;
536
537        // list of input descriptors currently opened
538        DefaultKeyedVector<audio_io_handle_t, AudioInputDescriptor *> mInputs;
539
540        audio_devices_t mAvailableOutputDevices; // bit field of all available output devices
541        audio_devices_t mAvailableInputDevices; // bit field of all available input devices
542                                                // without AUDIO_DEVICE_BIT_IN to allow direct bit
543                                                // field comparisons
544        int mPhoneState;                                                    // current phone state
545        AudioSystem::forced_config mForceUse[AudioSystem::NUM_FORCE_USE];   // current forced use configuration
546
547        StreamDescriptor mStreams[AudioSystem::NUM_STREAM_TYPES];           // stream descriptors for volume control
548        String8 mA2dpDeviceAddress;                                         // A2DP device MAC address
549        String8 mScoDeviceAddress;                                          // SCO device MAC address
550        String8 mUsbOutCardAndDevice;                                       // USB audio ALSA card and device numbers:
551                                                                            // card=<card_number>;device=<><device_number>
552        bool    mLimitRingtoneVolume;                                       // limit ringtone volume to music volume if headset connected
553        audio_devices_t mDeviceForStrategy[NUM_STRATEGIES];
554        float   mLastVoiceVolume;                                           // last voice volume value sent to audio HAL
555
556        // Maximum CPU load allocated to audio effects in 0.1 MIPS (ARMv5TE, 0 WS memory) units
557        static const uint32_t MAX_EFFECTS_CPU_LOAD = 1000;
558        // Maximum memory allocated to audio effects in KB
559        static const uint32_t MAX_EFFECTS_MEMORY = 512;
560        uint32_t mTotalEffectsCpuLoad; // current CPU load used by effects
561        uint32_t mTotalEffectsMemory;  // current memory used by effects
562        KeyedVector<int, EffectDescriptor *> mEffects;  // list of registered audio effects
563        bool    mA2dpSuspended;  // true if A2DP output is suspended
564        bool mHasA2dp; // true on platforms with support for bluetooth A2DP
565        bool mHasUsb; // true on platforms with support for USB audio
566        bool mHasRemoteSubmix; // true on platforms with support for remote presentation of a submix
567        audio_devices_t mAttachedOutputDevices; // output devices always available on the platform
568        audio_devices_t mDefaultOutputDevice; // output device selected by default at boot time
569                                              // (must be in mAttachedOutputDevices)
570        bool mSpeakerDrcEnabled;// true on devices that use DRC on the DEVICE_CATEGORY_SPEAKER path
571                                // to boost soft sounds, used to adjust volume curves accordingly
572
573        Vector <HwModule *> mHwModules;
574
575#ifdef AUDIO_POLICY_TEST
576        Mutex   mLock;
577        Condition mWaitWorkCV;
578
579        int             mCurOutput;
580        bool            mDirectOutput;
581        audio_io_handle_t mTestOutputs[NUM_TEST_OUTPUTS];
582        int             mTestInput;
583        uint32_t        mTestDevice;
584        uint32_t        mTestSamplingRate;
585        uint32_t        mTestFormat;
586        uint32_t        mTestChannels;
587        uint32_t        mTestLatencyMs;
588#endif //AUDIO_POLICY_TEST
589
590private:
591        static float volIndexToAmpl(audio_devices_t device, const StreamDescriptor& streamDesc,
592                int indexInUi);
593        // updates device caching and output for streams that can influence the
594        //    routing of notifications
595        void handleNotificationRoutingForStream(AudioSystem::stream_type stream);
596        static bool isVirtualInputDevice(audio_devices_t device);
597};
598
599};
600