Home | History | Annotate | Download | only in linux 
      1 /*
      2  *  Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
      3  *
      4  *  Use of this source code is governed by a BSD-style license
      5  *  that can be found in the LICENSE file in the root of the source
      6  *  tree. An additional intellectual property rights grant can be found
      7  *  in the file PATENTS.  All contributing project authors may
      8  *  be found in the AUTHORS file in the root of the source tree.
      9  */
     10 
     11 #ifndef WEBRTC_AUDIO_DEVICE_AUDIO_DEVICE_ALSA_LINUX_H
     12 #define WEBRTC_AUDIO_DEVICE_AUDIO_DEVICE_ALSA_LINUX_H
     13 
     14 #include "webrtc/modules/audio_device/audio_device_generic.h"
     15 #include "webrtc/modules/audio_device/linux/audio_mixer_manager_alsa_linux.h"
     16 #include "webrtc/system_wrappers/interface/critical_section_wrapper.h"
     17 
     18 #if defined(USE_X11)
     19 #include <X11/Xlib.h>
     20 #endif
     21 #include <alsa/asoundlib.h>
     22 #include <sys/ioctl.h>
     23 #include <sys/soundcard.h>
     24 
     25 
     26 namespace webrtc
     27 {
     28 class EventWrapper;
     29 class ThreadWrapper;
     30 
     31 class AudioDeviceLinuxALSA : public AudioDeviceGeneric
     32 {
     33 public:
     34     AudioDeviceLinuxALSA(const int32_t id);
     35     virtual ~AudioDeviceLinuxALSA();
     36 
     37     // Retrieve the currently utilized audio layer
     38     virtual int32_t ActiveAudioLayer(
     39         AudioDeviceModule::AudioLayer& audioLayer) const OVERRIDE;
     40 
     41     // Main initializaton and termination
     42     virtual int32_t Init() OVERRIDE;
     43     virtual int32_t Terminate() OVERRIDE;
     44     virtual bool Initialized() const OVERRIDE;
     45 
     46     // Device enumeration
     47     virtual int16_t PlayoutDevices() OVERRIDE;
     48     virtual int16_t RecordingDevices() OVERRIDE;
     49     virtual int32_t PlayoutDeviceName(
     50         uint16_t index,
     51         char name[kAdmMaxDeviceNameSize],
     52         char guid[kAdmMaxGuidSize]) OVERRIDE;
     53     virtual int32_t RecordingDeviceName(
     54         uint16_t index,
     55         char name[kAdmMaxDeviceNameSize],
     56         char guid[kAdmMaxGuidSize]) OVERRIDE;
     57 
     58     // Device selection
     59     virtual int32_t SetPlayoutDevice(uint16_t index) OVERRIDE;
     60     virtual int32_t SetPlayoutDevice(
     61         AudioDeviceModule::WindowsDeviceType device) OVERRIDE;
     62     virtual int32_t SetRecordingDevice(uint16_t index) OVERRIDE;
     63     virtual int32_t SetRecordingDevice(
     64         AudioDeviceModule::WindowsDeviceType device) OVERRIDE;
     65 
     66     // Audio transport initialization
     67     virtual int32_t PlayoutIsAvailable(bool& available) OVERRIDE;
     68     virtual int32_t InitPlayout() OVERRIDE;
     69     virtual bool PlayoutIsInitialized() const OVERRIDE;
     70     virtual int32_t RecordingIsAvailable(bool& available) OVERRIDE;
     71     virtual int32_t InitRecording() OVERRIDE;
     72     virtual bool RecordingIsInitialized() const OVERRIDE;
     73 
     74     // Audio transport control
     75     virtual int32_t StartPlayout() OVERRIDE;
     76     virtual int32_t StopPlayout() OVERRIDE;
     77     virtual bool Playing() const OVERRIDE;
     78     virtual int32_t StartRecording() OVERRIDE;
     79     virtual int32_t StopRecording() OVERRIDE;
     80     virtual bool Recording() const OVERRIDE;
     81 
     82     // Microphone Automatic Gain Control (AGC)
     83     virtual int32_t SetAGC(bool enable) OVERRIDE;
     84     virtual bool AGC() const OVERRIDE;
     85 
     86     // Volume control based on the Windows Wave API (Windows only)
     87     virtual int32_t SetWaveOutVolume(uint16_t volumeLeft,
     88                                      uint16_t volumeRight) OVERRIDE;
     89     virtual int32_t WaveOutVolume(uint16_t& volumeLeft,
     90                                   uint16_t& volumeRight) const OVERRIDE;
     91 
     92     // Audio mixer initialization
     93     virtual int32_t InitSpeaker() OVERRIDE;
     94     virtual bool SpeakerIsInitialized() const OVERRIDE;
     95     virtual int32_t InitMicrophone() OVERRIDE;
     96     virtual bool MicrophoneIsInitialized() const OVERRIDE;
     97 
     98     // Speaker volume controls
     99     virtual int32_t SpeakerVolumeIsAvailable(bool& available) OVERRIDE;
    100     virtual int32_t SetSpeakerVolume(uint32_t volume) OVERRIDE;
    101     virtual int32_t SpeakerVolume(uint32_t& volume) const OVERRIDE;
    102     virtual int32_t MaxSpeakerVolume(uint32_t& maxVolume) const OVERRIDE;
    103     virtual int32_t MinSpeakerVolume(uint32_t& minVolume) const OVERRIDE;
    104     virtual int32_t SpeakerVolumeStepSize(uint16_t& stepSize) const OVERRIDE;
    105 
    106     // Microphone volume controls
    107     virtual int32_t MicrophoneVolumeIsAvailable(bool& available) OVERRIDE;
    108     virtual int32_t SetMicrophoneVolume(uint32_t volume) OVERRIDE;
    109     virtual int32_t MicrophoneVolume(uint32_t& volume) const OVERRIDE;
    110     virtual int32_t MaxMicrophoneVolume(uint32_t& maxVolume) const OVERRIDE;
    111     virtual int32_t MinMicrophoneVolume(uint32_t& minVolume) const OVERRIDE;
    112     virtual int32_t MicrophoneVolumeStepSize(
    113         uint16_t& stepSize) const OVERRIDE;
    114 
    115     // Speaker mute control
    116     virtual int32_t SpeakerMuteIsAvailable(bool& available) OVERRIDE;
    117     virtual int32_t SetSpeakerMute(bool enable) OVERRIDE;
    118     virtual int32_t SpeakerMute(bool& enabled) const OVERRIDE;
    119 
    120     // Microphone mute control
    121     virtual int32_t MicrophoneMuteIsAvailable(bool& available) OVERRIDE;
    122     virtual int32_t SetMicrophoneMute(bool enable) OVERRIDE;
    123     virtual int32_t MicrophoneMute(bool& enabled) const OVERRIDE;
    124 
    125     // Microphone boost control
    126     virtual int32_t MicrophoneBoostIsAvailable(bool& available) OVERRIDE;
    127     virtual int32_t SetMicrophoneBoost(bool enable) OVERRIDE;
    128     virtual int32_t MicrophoneBoost(bool& enabled) const OVERRIDE;
    129 
    130     // Stereo support
    131     virtual int32_t StereoPlayoutIsAvailable(bool& available) OVERRIDE;
    132     virtual int32_t SetStereoPlayout(bool enable) OVERRIDE;
    133     virtual int32_t StereoPlayout(bool& enabled) const OVERRIDE;
    134     virtual int32_t StereoRecordingIsAvailable(bool& available) OVERRIDE;
    135     virtual int32_t SetStereoRecording(bool enable) OVERRIDE;
    136     virtual int32_t StereoRecording(bool& enabled) const OVERRIDE;
    137 
    138     // Delay information and control
    139     virtual int32_t SetPlayoutBuffer(
    140         const AudioDeviceModule::BufferType type,
    141         uint16_t sizeMS) OVERRIDE;
    142     virtual int32_t PlayoutBuffer(
    143         AudioDeviceModule::BufferType& type,
    144         uint16_t& sizeMS) const OVERRIDE;
    145     virtual int32_t PlayoutDelay(uint16_t& delayMS) const OVERRIDE;
    146     virtual int32_t RecordingDelay(uint16_t& delayMS) const OVERRIDE;
    147 
    148     // CPU load
    149     virtual int32_t CPULoad(uint16_t& load) const OVERRIDE;
    150 
    151 public:
    152     virtual bool PlayoutWarning() const OVERRIDE;
    153     virtual bool PlayoutError() const OVERRIDE;
    154     virtual bool RecordingWarning() const OVERRIDE;
    155     virtual bool RecordingError() const OVERRIDE;
    156     virtual void ClearPlayoutWarning() OVERRIDE;
    157     virtual void ClearPlayoutError() OVERRIDE;
    158     virtual void ClearRecordingWarning() OVERRIDE;
    159     virtual void ClearRecordingError() OVERRIDE;
    160 
    161 public:
    162     virtual void AttachAudioBuffer(AudioDeviceBuffer* audioBuffer) OVERRIDE;
    163 
    164 private:
    165     int32_t GetDevicesInfo(const int32_t function,
    166                            const bool playback,
    167                            const int32_t enumDeviceNo = 0,
    168                            char* enumDeviceName = NULL,
    169                            const int32_t ednLen = 0) const;
    170     int32_t ErrorRecovery(int32_t error, snd_pcm_t* deviceHandle);
    171 
    172 private:
    173     bool KeyPressed() const;
    174 
    175 private:
    176     void Lock() EXCLUSIVE_LOCK_FUNCTION(_critSect) { _critSect.Enter(); };
    177     void UnLock() UNLOCK_FUNCTION(_critSect) { _critSect.Leave(); };
    178 private:
    179     inline int32_t InputSanityCheckAfterUnlockedPeriod() const;
    180     inline int32_t OutputSanityCheckAfterUnlockedPeriod() const;
    181 
    182 private:
    183     static bool RecThreadFunc(void*);
    184     static bool PlayThreadFunc(void*);
    185     bool RecThreadProcess();
    186     bool PlayThreadProcess();
    187 
    188 private:
    189     AudioDeviceBuffer* _ptrAudioBuffer;
    190 
    191     CriticalSectionWrapper& _critSect;
    192 
    193     ThreadWrapper* _ptrThreadRec;
    194     ThreadWrapper* _ptrThreadPlay;
    195     uint32_t _recThreadID;
    196     uint32_t _playThreadID;
    197 
    198     int32_t _id;
    199 
    200     AudioMixerManagerLinuxALSA _mixerManager;
    201 
    202     uint16_t _inputDeviceIndex;
    203     uint16_t _outputDeviceIndex;
    204     bool _inputDeviceIsSpecified;
    205     bool _outputDeviceIsSpecified;
    206 
    207     snd_pcm_t* _handleRecord;
    208     snd_pcm_t* _handlePlayout;
    209 
    210     snd_pcm_uframes_t _recordingBuffersizeInFrame;
    211     snd_pcm_uframes_t _recordingPeriodSizeInFrame;
    212     snd_pcm_uframes_t _playoutBufferSizeInFrame;
    213     snd_pcm_uframes_t _playoutPeriodSizeInFrame;
    214 
    215     ssize_t _recordingBufferSizeIn10MS;
    216     ssize_t _playoutBufferSizeIn10MS;
    217     uint32_t _recordingFramesIn10MS;
    218     uint32_t _playoutFramesIn10MS;
    219 
    220     uint32_t _recordingFreq;
    221     uint32_t _playoutFreq;
    222     uint8_t _recChannels;
    223     uint8_t _playChannels;
    224 
    225     int8_t* _recordingBuffer; // in byte
    226     int8_t* _playoutBuffer; // in byte
    227     uint32_t _recordingFramesLeft;
    228     uint32_t _playoutFramesLeft;
    229 
    230     AudioDeviceModule::BufferType _playBufType;
    231 
    232 private:
    233     bool _initialized;
    234     bool _recording;
    235     bool _playing;
    236     bool _recIsInitialized;
    237     bool _playIsInitialized;
    238     bool _AGC;
    239 
    240     snd_pcm_sframes_t _recordingDelay;
    241     snd_pcm_sframes_t _playoutDelay;
    242 
    243     uint16_t _playWarning;
    244     uint16_t _playError;
    245     uint16_t _recWarning;
    246     uint16_t _recError;
    247 
    248     uint16_t _playBufDelay;                 // playback delay
    249     uint16_t _playBufDelayFixed;            // fixed playback delay
    250 
    251     char _oldKeyState[32];
    252 #if defined(USE_X11)
    253     Display* _XDisplay;
    254 #endif
    255 };
    256 
    257 }
    258 
    259 #endif  // MODULES_AUDIO_DEVICE_MAIN_SOURCE_LINUX_AUDIO_DEVICE_ALSA_LINUX_H_
    260