Home | History | Annotate | Download | only in hardware_legacy
      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 
     29 namespace 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 
     68 class AudioPolicyManagerBase: public AudioPolicyInterface
     69 #ifdef AUDIO_POLICY_TEST
     70     , public Thread
     71 #endif //AUDIO_POLICY_TEST
     72 {
     73 
     74 public:
     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 = 0,
     91                                             uint32_t format = AudioSystem::FORMAT_DEFAULT,
     92                                             uint32_t channels = 0,
     93                                             AudioSystem::output_flags flags =
     94                                                     AudioSystem::OUTPUT_FLAG_INDIRECT,
     95                                             const audio_offload_info_t *offloadInfo = NULL);
     96         virtual status_t startOutput(audio_io_handle_t output,
     97                                      AudioSystem::stream_type stream,
     98                                      int session = 0);
     99         virtual status_t stopOutput(audio_io_handle_t output,
    100                                     AudioSystem::stream_type stream,
    101                                     int session = 0);
    102         virtual void releaseOutput(audio_io_handle_t output);
    103         virtual audio_io_handle_t getInput(int inputSource,
    104                                             uint32_t samplingRate,
    105                                             uint32_t format,
    106                                             uint32_t channels,
    107                                             AudioSystem::audio_in_acoustics acoustics);
    108 
    109         // indicates to the audio policy manager that the input starts being used.
    110         virtual status_t startInput(audio_io_handle_t input);
    111 
    112         // indicates to the audio policy manager that the input stops being used.
    113         virtual status_t stopInput(audio_io_handle_t input);
    114         virtual void releaseInput(audio_io_handle_t input);
    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 
    151 protected:
    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                                      uint32_t format,
    213                                      uint32_t channelMask,
    214                                      audio_output_flags_t flags) const;
    215 
    216             void dump(int fd);
    217 
    218             // by convention, "0' in the first entry in mSamplingRates, mChannelMasks or mFormats
    219             // indicates the supported parameters should be read from the output stream
    220             // after it is opened for the first time
    221             Vector <uint32_t> mSamplingRates; // supported sampling rates
    222             Vector <audio_channel_mask_t> mChannelMasks; // supported channel masks
    223             Vector <audio_format_t> mFormats; // supported audio formats
    224             audio_devices_t mSupportedDevices; // supported devices (devices this output can be
    225                                                // routed to)
    226             audio_output_flags_t mFlags; // attribute flags (e.g primary output,
    227                                                 // direct output...). For outputs only.
    228             HwModule *mModule;                     // audio HW module exposing this I/O stream
    229         };
    230 
    231         // default volume curve
    232         static const VolumeCurvePoint sDefaultVolumeCurve[AudioPolicyManagerBase::VOLCNT];
    233         // default volume curve for media strategy
    234         static const VolumeCurvePoint sDefaultMediaVolumeCurve[AudioPolicyManagerBase::VOLCNT];
    235         // volume curve for media strategy on speakers
    236         static const VolumeCurvePoint sSpeakerMediaVolumeCurve[AudioPolicyManagerBase::VOLCNT];
    237         // volume curve for sonification strategy on speakers
    238         static const VolumeCurvePoint sSpeakerSonificationVolumeCurve[AudioPolicyManagerBase::VOLCNT];
    239         static const VolumeCurvePoint sSpeakerSonificationVolumeCurveDrc[AudioPolicyManagerBase::VOLCNT];
    240         static const VolumeCurvePoint sDefaultSystemVolumeCurve[AudioPolicyManagerBase::VOLCNT];
    241         static const VolumeCurvePoint sDefaultSystemVolumeCurveDrc[AudioPolicyManagerBase::VOLCNT];
    242         static const VolumeCurvePoint sHeadsetSystemVolumeCurve[AudioPolicyManagerBase::VOLCNT];
    243         static const VolumeCurvePoint sDefaultVoiceVolumeCurve[AudioPolicyManagerBase::VOLCNT];
    244         static const VolumeCurvePoint sSpeakerVoiceVolumeCurve[AudioPolicyManagerBase::VOLCNT];
    245         // default volume curves per stream and device category. See initializeVolumeCurves()
    246         static const VolumeCurvePoint *sVolumeProfiles[AUDIO_STREAM_CNT][DEVICE_CATEGORY_CNT];
    247 
    248         // descriptor for audio outputs. Used to maintain current configuration of each opened audio output
    249         // and keep track of the usage of this output by each audio stream type.
    250         class AudioOutputDescriptor
    251         {
    252         public:
    253             AudioOutputDescriptor(const IOProfile *profile);
    254 
    255             status_t    dump(int fd);
    256 
    257             audio_devices_t device() const;
    258             void changeRefCount(AudioSystem::stream_type stream, int delta);
    259 
    260             bool isDuplicated() const { return (mOutput1 != NULL && mOutput2 != NULL); }
    261             audio_devices_t supportedDevices();
    262             uint32_t latency();
    263             bool sharesHwModuleWith(const AudioOutputDescriptor *outputDesc);
    264             bool isActive(uint32_t inPastMs = 0) const;
    265             bool isStreamActive(AudioSystem::stream_type stream,
    266                                 uint32_t inPastMs = 0,
    267                                 nsecs_t sysTime = 0) const;
    268             bool isStrategyActive(routing_strategy strategy,
    269                              uint32_t inPastMs = 0,
    270                              nsecs_t sysTime = 0) const;
    271 
    272             audio_io_handle_t mId;              // output handle
    273             uint32_t mSamplingRate;             //
    274             audio_format_t mFormat;             //
    275             audio_channel_mask_t mChannelMask;     // output configuration
    276             uint32_t mLatency;                  //
    277             audio_output_flags_t mFlags;   //
    278             audio_devices_t mDevice;                   // current device this output is routed to
    279             uint32_t mRefCount[AudioSystem::NUM_STREAM_TYPES]; // number of streams of each type using this output
    280             nsecs_t mStopTime[AudioSystem::NUM_STREAM_TYPES];
    281             AudioOutputDescriptor *mOutput1;    // used by duplicated outputs: first output
    282             AudioOutputDescriptor *mOutput2;    // used by duplicated outputs: second output
    283             float mCurVolume[AudioSystem::NUM_STREAM_TYPES];   // current stream volume
    284             int mMuteCount[AudioSystem::NUM_STREAM_TYPES];     // mute request counter
    285             const IOProfile *mProfile;          // I/O profile this output derives from
    286             bool mStrategyMutedByDevice[NUM_STRATEGIES]; // strategies muted because of incompatible
    287                                                 // device selection. See checkDeviceMuteStrategies()
    288             uint32_t mDirectOpenCount; // number of clients using this output (direct outputs only)
    289         };
    290 
    291         // descriptor for audio inputs. Used to maintain current configuration of each opened audio input
    292         // and keep track of the usage of this input.
    293         class AudioInputDescriptor
    294         {
    295         public:
    296             AudioInputDescriptor(const IOProfile *profile);
    297 
    298             status_t    dump(int fd);
    299 
    300             uint32_t mSamplingRate;                     //
    301             audio_format_t mFormat;                     // input configuration
    302             audio_channel_mask_t mChannelMask;             //
    303             audio_devices_t mDevice;                    // current device this input is routed to
    304             uint32_t mRefCount;                         // number of AudioRecord clients using this output
    305             int      mInputSource;                      // input source selected by application (mediarecorder.h)
    306             const IOProfile *mProfile;                  // I/O profile this output derives from
    307         };
    308 
    309         // stream descriptor used for volume control
    310         class StreamDescriptor
    311         {
    312         public:
    313             StreamDescriptor();
    314 
    315             int getVolumeIndex(audio_devices_t device);
    316             void dump(int fd);
    317 
    318             int mIndexMin;      // min volume index
    319             int mIndexMax;      // max volume index
    320             KeyedVector<audio_devices_t, int> mIndexCur;   // current volume index per device
    321             bool mCanBeMuted;   // true is the stream can be muted
    322 
    323             const VolumeCurvePoint *mVolumeCurve[DEVICE_CATEGORY_CNT];
    324         };
    325 
    326         // stream descriptor used for volume control
    327         class EffectDescriptor
    328         {
    329         public:
    330 
    331             status_t dump(int fd);
    332 
    333             int mIo;                // io the effect is attached to
    334             routing_strategy mStrategy; // routing strategy the effect is associated to
    335             int mSession;               // audio session the effect is on
    336             effect_descriptor_t mDesc;  // effect descriptor
    337             bool mEnabled;              // enabled state: CPU load being used or not
    338         };
    339 
    340         void addOutput(audio_io_handle_t id, AudioOutputDescriptor *outputDesc);
    341 
    342         // return the strategy corresponding to a given stream type
    343         static routing_strategy getStrategy(AudioSystem::stream_type stream);
    344 
    345         // return appropriate device for streams handled by the specified strategy according to current
    346         // phone state, connected devices...
    347         // if fromCache is true, the device is returned from mDeviceForStrategy[],
    348         // otherwise it is determine by current state
    349         // (device connected,phone state, force use, a2dp output...)
    350         // This allows to:
    351         //  1 speed up process when the state is stable (when starting or stopping an output)
    352         //  2 access to either current device selection (fromCache == true) or
    353         // "future" device selection (fromCache == false) when called from a context
    354         //  where conditions are changing (setDeviceConnectionState(), setPhoneState()...) AND
    355         //  before updateDevicesAndOutputs() is called.
    356         virtual audio_devices_t getDeviceForStrategy(routing_strategy strategy,
    357                                                      bool fromCache);
    358 
    359         // change the route of the specified output. Returns the number of ms we have slept to
    360         // allow new routing to take effect in certain cases.
    361         uint32_t setOutputDevice(audio_io_handle_t output,
    362                              audio_devices_t device,
    363                              bool force = false,
    364                              int delayMs = 0);
    365 
    366         // select input device corresponding to requested audio source
    367         virtual audio_devices_t getDeviceForInputSource(int inputSource);
    368 
    369         // return io handle of active input or 0 if no input is active
    370         //    Only considers inputs from physical devices (e.g. main mic, headset mic) when
    371         //    ignoreVirtualInputs is true.
    372         audio_io_handle_t getActiveInput(bool ignoreVirtualInputs = true);
    373 
    374         // initialize volume curves for each strategy and device category
    375         void initializeVolumeCurves();
    376 
    377         // compute the actual volume for a given stream according to the requested index and a particular
    378         // device
    379         virtual float computeVolume(int stream, int index, audio_io_handle_t output, audio_devices_t device);
    380 
    381         // check that volume change is permitted, compute and send new volume to audio hardware
    382         status_t checkAndSetVolume(int stream, int index, audio_io_handle_t output, audio_devices_t device, int delayMs = 0, bool force = false);
    383 
    384         // apply all stream volumes to the specified output and device
    385         void applyStreamVolumes(audio_io_handle_t output, audio_devices_t device, int delayMs = 0, bool force = false);
    386 
    387         // Mute or unmute all streams handled by the specified strategy on the specified output
    388         void setStrategyMute(routing_strategy strategy,
    389                              bool on,
    390                              audio_io_handle_t output,
    391                              int delayMs = 0,
    392                              audio_devices_t device = (audio_devices_t)0);
    393 
    394         // Mute or unmute the stream on the specified output
    395         void setStreamMute(int stream,
    396                            bool on,
    397                            audio_io_handle_t output,
    398                            int delayMs = 0,
    399                            audio_devices_t device = (audio_devices_t)0);
    400 
    401         // handle special cases for sonification strategy while in call: mute streams or replace by
    402         // a special tone in the device used for communication
    403         void handleIncallSonification(int stream, bool starting, bool stateChange);
    404 
    405         // true if device is in a telephony or VoIP call
    406         virtual bool isInCall();
    407 
    408         // true if given state represents a device in a telephony or VoIP call
    409         virtual bool isStateInCall(int state);
    410 
    411         // when a device is connected, checks if an open output can be routed
    412         // to this device. If none is open, tries to open one of the available outputs.
    413         // Returns an output suitable to this device or 0.
    414         // when a device is disconnected, checks if an output is not used any more and
    415         // returns its handle if any.
    416         // transfers the audio tracks and effects from one output thread to another accordingly.
    417         status_t checkOutputsForDevice(audio_devices_t device,
    418                                        AudioSystem::device_connection_state state,
    419                                        SortedVector<audio_io_handle_t>& outputs);
    420 
    421         // close an output and its companion duplicating output.
    422         void closeOutput(audio_io_handle_t output);
    423 
    424         // checks and if necessary changes outputs used for all strategies.
    425         // must be called every time a condition that affects the output choice for a given strategy
    426         // changes: connected device, phone state, force use...
    427         // Must be called before updateDevicesAndOutputs()
    428         void checkOutputForStrategy(routing_strategy strategy);
    429 
    430         // Same as checkOutputForStrategy() but for a all strategies in order of priority
    431         void checkOutputForAllStrategies();
    432 
    433         // manages A2DP output suspend/restore according to phone state and BT SCO usage
    434         void checkA2dpSuspend();
    435 
    436         // returns the A2DP output handle if it is open or 0 otherwise
    437         audio_io_handle_t getA2dpOutput();
    438 
    439         // selects the most appropriate device on output for current state
    440         // must be called every time a condition that affects the device choice for a given output is
    441         // changed: connected device, phone state, force use, output start, output stop..
    442         // see getDeviceForStrategy() for the use of fromCache parameter
    443 
    444         audio_devices_t getNewDevice(audio_io_handle_t output, bool fromCache);
    445         // updates cache of device used by all strategies (mDeviceForStrategy[])
    446         // must be called every time a condition that affects the device choice for a given strategy is
    447         // changed: connected device, phone state, force use...
    448         // cached values are used by getDeviceForStrategy() if parameter fromCache is true.
    449          // Must be called after checkOutputForAllStrategies()
    450 
    451         void updateDevicesAndOutputs();
    452 
    453         virtual uint32_t getMaxEffectsCpuLoad();
    454         virtual uint32_t getMaxEffectsMemory();
    455 #ifdef AUDIO_POLICY_TEST
    456         virtual     bool        threadLoop();
    457                     void        exit();
    458         int testOutputIndex(audio_io_handle_t output);
    459 #endif //AUDIO_POLICY_TEST
    460 
    461         status_t setEffectEnabled(EffectDescriptor *pDesc, bool enabled);
    462 
    463         // returns the category the device belongs to with regard to volume curve management
    464         static device_category getDeviceCategory(audio_devices_t device);
    465 
    466         // extract one device relevant for volume control from multiple device selection
    467         static audio_devices_t getDeviceForVolume(audio_devices_t device);
    468 
    469         SortedVector<audio_io_handle_t> getOutputsForDevice(audio_devices_t device,
    470                         DefaultKeyedVector<audio_io_handle_t, AudioOutputDescriptor *> openOutputs);
    471         bool vectorsEqual(SortedVector<audio_io_handle_t>& outputs1,
    472                                            SortedVector<audio_io_handle_t>& outputs2);
    473 
    474         // mute/unmute strategies using an incompatible device combination
    475         // if muting, wait for the audio in pcm buffer to be drained before proceeding
    476         // if unmuting, unmute only after the specified delay
    477         // Returns the number of ms waited
    478         uint32_t  checkDeviceMuteStrategies(AudioOutputDescriptor *outputDesc,
    479                                             audio_devices_t prevDevice,
    480                                             uint32_t delayMs);
    481 
    482         audio_io_handle_t selectOutput(const SortedVector<audio_io_handle_t>& outputs,
    483                                        AudioSystem::output_flags flags);
    484         IOProfile *getInputProfile(audio_devices_t device,
    485                                    uint32_t samplingRate,
    486                                    uint32_t format,
    487                                    uint32_t channelMask);
    488         IOProfile *getProfileForDirectOutput(audio_devices_t device,
    489                                                        uint32_t samplingRate,
    490                                                        uint32_t format,
    491                                                        uint32_t channelMask,
    492                                                        audio_output_flags_t flags);
    493 
    494         audio_io_handle_t selectOutputForEffects(const SortedVector<audio_io_handle_t>& outputs);
    495 
    496         bool isNonOffloadableEffectEnabled();
    497 
    498         //
    499         // Audio policy configuration file parsing (audio_policy.conf)
    500         //
    501         static uint32_t stringToEnum(const struct StringToEnum *table,
    502                                      size_t size,
    503                                      const char *name);
    504         static bool stringToBool(const char *value);
    505         static audio_output_flags_t parseFlagNames(char *name);
    506         static audio_devices_t parseDeviceNames(char *name);
    507         void loadSamplingRates(char *name, IOProfile *profile);
    508         void loadFormats(char *name, IOProfile *profile);
    509         void loadOutChannels(char *name, IOProfile *profile);
    510         void loadInChannels(char *name, IOProfile *profile);
    511         status_t loadOutput(cnode *root,  HwModule *module);
    512         status_t loadInput(cnode *root,  HwModule *module);
    513         void loadHwModule(cnode *root);
    514         void loadHwModules(cnode *root);
    515         void loadGlobalConfig(cnode *root);
    516         status_t loadAudioPolicyConfig(const char *path);
    517         void defaultAudioPolicyConfig(void);
    518 
    519 
    520         AudioPolicyClientInterface *mpClientInterface;  // audio policy client interface
    521         audio_io_handle_t mPrimaryOutput;              // primary output handle
    522         // list of descriptors for outputs currently opened
    523         DefaultKeyedVector<audio_io_handle_t, AudioOutputDescriptor *> mOutputs;
    524         // copy of mOutputs before setDeviceConnectionState() opens new outputs
    525         // reset to mOutputs when updateDevicesAndOutputs() is called.
    526         DefaultKeyedVector<audio_io_handle_t, AudioOutputDescriptor *> mPreviousOutputs;
    527         DefaultKeyedVector<audio_io_handle_t, AudioInputDescriptor *> mInputs;     // list of input descriptors
    528         audio_devices_t mAvailableOutputDevices; // bit field of all available output devices
    529         audio_devices_t mAvailableInputDevices; // bit field of all available input devices
    530                                                 // without AUDIO_DEVICE_BIT_IN to allow direct bit
    531                                                 // field comparisons
    532         int mPhoneState;                                                    // current phone state
    533         AudioSystem::forced_config mForceUse[AudioSystem::NUM_FORCE_USE];   // current forced use configuration
    534 
    535         StreamDescriptor mStreams[AudioSystem::NUM_STREAM_TYPES];           // stream descriptors for volume control
    536         String8 mA2dpDeviceAddress;                                         // A2DP device MAC address
    537         String8 mScoDeviceAddress;                                          // SCO device MAC address
    538         String8 mUsbCardAndDevice; // USB audio ALSA card and device numbers:
    539                                    // card=<card_number>;device=<><device_number>
    540         bool    mLimitRingtoneVolume;                                       // limit ringtone volume to music volume if headset connected
    541         audio_devices_t mDeviceForStrategy[NUM_STRATEGIES];
    542         float   mLastVoiceVolume;                                           // last voice volume value sent to audio HAL
    543 
    544         // Maximum CPU load allocated to audio effects in 0.1 MIPS (ARMv5TE, 0 WS memory) units
    545         static const uint32_t MAX_EFFECTS_CPU_LOAD = 1000;
    546         // Maximum memory allocated to audio effects in KB
    547         static const uint32_t MAX_EFFECTS_MEMORY = 512;
    548         uint32_t mTotalEffectsCpuLoad; // current CPU load used by effects
    549         uint32_t mTotalEffectsMemory;  // current memory used by effects
    550         KeyedVector<int, EffectDescriptor *> mEffects;  // list of registered audio effects
    551         bool    mA2dpSuspended;  // true if A2DP output is suspended
    552         bool mHasA2dp; // true on platforms with support for bluetooth A2DP
    553         bool mHasUsb; // true on platforms with support for USB audio
    554         bool mHasRemoteSubmix; // true on platforms with support for remote presentation of a submix
    555         audio_devices_t mAttachedOutputDevices; // output devices always available on the platform
    556         audio_devices_t mDefaultOutputDevice; // output device selected by default at boot time
    557                                               // (must be in mAttachedOutputDevices)
    558         bool mSpeakerDrcEnabled;// true on devices that use DRC on the DEVICE_CATEGORY_SPEAKER path
    559                                 // to boost soft sounds, used to adjust volume curves accordingly
    560 
    561         Vector <HwModule *> mHwModules;
    562 
    563 #ifdef AUDIO_POLICY_TEST
    564         Mutex   mLock;
    565         Condition mWaitWorkCV;
    566 
    567         int             mCurOutput;
    568         bool            mDirectOutput;
    569         audio_io_handle_t mTestOutputs[NUM_TEST_OUTPUTS];
    570         int             mTestInput;
    571         uint32_t        mTestDevice;
    572         uint32_t        mTestSamplingRate;
    573         uint32_t        mTestFormat;
    574         uint32_t        mTestChannels;
    575         uint32_t        mTestLatencyMs;
    576 #endif //AUDIO_POLICY_TEST
    577 
    578 private:
    579         static float volIndexToAmpl(audio_devices_t device, const StreamDescriptor& streamDesc,
    580                 int indexInUi);
    581         // updates device caching and output for streams that can influence the
    582         //    routing of notifications
    583         void handleNotificationRoutingForStream(AudioSystem::stream_type stream);
    584         static bool isVirtualInputDevice(audio_devices_t device);
    585 };
    586 
    587 };
    588