2018-10-29 11:39:25 -04:00
///////////////////////////////////////////////////////////////////////////////////
// Copyright (C) 2018 Edouard Griffiths, F4EXB //
// //
// This program is free software; you can redistribute it and/or modify //
// it under the terms of the GNU General Public License as published by //
// the Free Software Foundation as version 3 of the License, or //
// //
// This program is distributed in the hope that it will be useful, //
// but WITHOUT ANY WARRANTY; without even the implied warranty of //
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the //
// GNU General Public License V3 for more details. //
// //
// You should have received a copy of the GNU General Public License //
// along with this program. If not, see <http://www.gnu.org/licenses/>. //
///////////////////////////////////////////////////////////////////////////////////
2018-11-01 21:33:04 -04:00
# include <QDebug>
2018-10-29 11:39:25 -04:00
# include "util/simpleserializer.h"
2018-10-29 20:58:39 -04:00
# include "device/devicesourceapi.h"
# include "device/devicesinkapi.h"
# include "dsp/dspcommands.h"
# include "dsp/filerecord.h"
# include "dsp/dspengine.h"
# include "soapysdr/devicesoapysdr.h"
2018-10-30 15:31:16 -04:00
# include "soapysdrinputthread.h"
2018-10-29 11:39:25 -04:00
# include "soapysdrinput.h"
2018-11-01 21:33:04 -04:00
MESSAGE_CLASS_DEFINITION ( SoapySDRInput : : MsgConfigureSoapySDRInput , Message )
MESSAGE_CLASS_DEFINITION ( SoapySDRInput : : MsgFileRecord , Message )
MESSAGE_CLASS_DEFINITION ( SoapySDRInput : : MsgStartStop , Message )
2018-11-07 17:21:37 -05:00
MESSAGE_CLASS_DEFINITION ( SoapySDRInput : : MsgReportGainChange , Message )
2018-11-01 21:33:04 -04:00
2018-10-29 20:58:39 -04:00
SoapySDRInput : : SoapySDRInput ( DeviceSourceAPI * deviceAPI ) :
m_deviceAPI ( deviceAPI ) ,
2018-11-01 21:33:04 -04:00
m_settings ( ) ,
2018-10-29 20:58:39 -04:00
m_deviceDescription ( " SoapySDRInput " ) ,
2018-11-01 21:33:04 -04:00
m_running ( false ) ,
m_thread ( 0 )
2018-10-29 11:39:25 -04:00
{
2018-10-31 07:22:46 -04:00
openDevice ( ) ;
2018-11-07 17:21:37 -05:00
initGainSettings ( m_settings ) ;
2018-11-01 21:33:04 -04:00
m_fileSink = new FileRecord ( QString ( " test_%1.sdriq " ) . arg ( m_deviceAPI - > getDeviceUID ( ) ) ) ;
m_deviceAPI - > addSink ( m_fileSink ) ;
2018-10-29 11:39:25 -04:00
}
SoapySDRInput : : ~ SoapySDRInput ( )
{
2018-11-04 05:45:59 -05:00
if ( m_running ) {
stop ( ) ;
}
2018-11-01 21:33:04 -04:00
m_deviceAPI - > removeSink ( m_fileSink ) ;
delete m_fileSink ;
2018-11-04 05:45:59 -05:00
closeDevice ( ) ;
2018-10-29 11:39:25 -04:00
}
void SoapySDRInput : : destroy ( )
{
delete this ;
}
2018-10-29 20:58:39 -04:00
bool SoapySDRInput : : openDevice ( )
{
if ( ! m_sampleFifo . setSize ( 96000 * 4 ) )
{
qCritical ( " SoapySDRInput::openDevice: could not allocate SampleFifo " ) ;
return false ;
}
else
{
qDebug ( " SoapySDRInput::openDevice: allocated SampleFifo " ) ;
}
// look for Rx buddies and get reference to the device object
if ( m_deviceAPI - > getSourceBuddies ( ) . size ( ) > 0 ) // look source sibling first
{
qDebug ( " SoapySDRInput::openDevice: look in Rx buddies " ) ;
DeviceSourceAPI * sourceBuddy = m_deviceAPI - > getSourceBuddies ( ) [ 0 ] ;
DeviceSoapySDRShared * deviceSoapySDRShared = ( DeviceSoapySDRShared * ) sourceBuddy - > getBuddySharedPtr ( ) ;
if ( deviceSoapySDRShared = = 0 )
{
qCritical ( " SoapySDRInput::openDevice: the source buddy shared pointer is null " ) ;
return false ;
}
SoapySDR : : Device * device = deviceSoapySDRShared - > m_device ;
if ( device = = 0 )
{
qCritical ( " SoapySDRInput::openDevice: cannot get device pointer from Rx buddy " ) ;
return false ;
}
m_deviceShared . m_device = device ;
2018-10-31 07:22:46 -04:00
m_deviceShared . m_deviceParams = deviceSoapySDRShared - > m_deviceParams ;
2018-10-29 20:58:39 -04:00
}
// look for Tx buddies and get reference to the device object
else if ( m_deviceAPI - > getSinkBuddies ( ) . size ( ) > 0 ) // then sink
{
qDebug ( " SoapySDRInput::openDevice: look in Tx buddies " ) ;
DeviceSinkAPI * sinkBuddy = m_deviceAPI - > getSinkBuddies ( ) [ 0 ] ;
DeviceSoapySDRShared * deviceSoapySDRShared = ( DeviceSoapySDRShared * ) sinkBuddy - > getBuddySharedPtr ( ) ;
if ( deviceSoapySDRShared = = 0 )
{
qCritical ( " SoapySDRInput::openDevice: the sink buddy shared pointer is null " ) ;
return false ;
}
SoapySDR : : Device * device = deviceSoapySDRShared - > m_device ;
if ( device = = 0 )
{
qCritical ( " SoapySDRInput::openDevice: cannot get device pointer from Tx buddy " ) ;
return false ;
}
m_deviceShared . m_device = device ;
2018-10-31 07:22:46 -04:00
m_deviceShared . m_deviceParams = deviceSoapySDRShared - > m_deviceParams ;
2018-10-29 20:58:39 -04:00
}
// There are no buddies then create the first SoapySDR device
else
{
qDebug ( " SoapySDRInput::openDevice: open device here " ) ;
DeviceSoapySDR & deviceSoapySDR = DeviceSoapySDR : : instance ( ) ;
m_deviceShared . m_device = deviceSoapySDR . openSoapySDR ( m_deviceAPI - > getSampleSourceSequence ( ) ) ;
if ( ! m_deviceShared . m_device )
{
qCritical ( " BladeRF2Input::openDevice: cannot open BladeRF2 device " ) ;
return false ;
}
2018-10-31 07:22:46 -04:00
m_deviceShared . m_deviceParams = new DeviceSoapySDRParams ( m_deviceShared . m_device ) ;
2018-10-29 20:58:39 -04:00
}
m_deviceShared . m_channel = m_deviceAPI - > getItemIndex ( ) ; // publicly allocate channel
m_deviceShared . m_source = this ;
m_deviceAPI - > setBuddySharedPtr ( & m_deviceShared ) ; // propagate common parameters to API
return true ;
}
void SoapySDRInput : : closeDevice ( )
{
if ( m_deviceShared . m_device = = 0 ) { // was never open
return ;
}
if ( m_running ) {
stop ( ) ;
}
2018-10-30 15:31:16 -04:00
if ( m_thread ) { // stills own the thread => transfer to a buddy
moveThreadToBuddy ( ) ;
}
2018-10-29 20:58:39 -04:00
m_deviceShared . m_channel = - 1 ; // publicly release channel
m_deviceShared . m_source = 0 ;
2018-10-31 07:22:46 -04:00
// No buddies so effectively close the device and delete parameters
2018-10-29 20:58:39 -04:00
if ( ( m_deviceAPI - > getSinkBuddies ( ) . size ( ) = = 0 ) & & ( m_deviceAPI - > getSourceBuddies ( ) . size ( ) = = 0 ) )
{
2018-10-31 07:22:46 -04:00
delete m_deviceShared . m_deviceParams ;
m_deviceShared . m_deviceParams = 0 ;
2018-10-29 20:58:39 -04:00
DeviceSoapySDR & deviceSoapySDR = DeviceSoapySDR : : instance ( ) ;
deviceSoapySDR . closeSoapySdr ( m_deviceShared . m_device ) ;
m_deviceShared . m_device = 0 ;
}
}
2018-10-31 21:32:26 -04:00
void SoapySDRInput : : getFrequencyRange ( uint64_t & min , uint64_t & max )
{
const DeviceSoapySDRParams : : ChannelSettings * channelSettings = m_deviceShared . m_deviceParams - > getRxChannelSettings ( m_deviceShared . m_channel ) ;
if ( channelSettings & & ( channelSettings - > m_frequencySettings . size ( ) > 0 ) )
{
DeviceSoapySDRParams : : FrequencySetting freqSettings = channelSettings - > m_frequencySettings [ 0 ] ;
SoapySDR : : RangeList rangeList = freqSettings . m_ranges ;
2018-11-06 19:33:17 -05:00
if ( rangeList . size ( ) > 0 )
2018-10-31 21:32:26 -04:00
{
SoapySDR : : Range range = rangeList [ 0 ] ;
min = range . minimum ( ) ;
max = range . maximum ( ) ;
}
else
{
min = 0 ;
max = 0 ;
}
}
else
{
min = 0 ;
max = 0 ;
}
}
2018-11-06 19:33:17 -05:00
void SoapySDRInput : : getGlobalGainRange ( int & min , int & max )
{
const DeviceSoapySDRParams : : ChannelSettings * channelSettings = m_deviceShared . m_deviceParams - > getRxChannelSettings ( m_deviceShared . m_channel ) ;
if ( channelSettings )
{
min = channelSettings - > m_gainRange . minimum ( ) ;
max = channelSettings - > m_gainRange . maximum ( ) ;
}
else
{
min = 0 ;
max = 0 ;
}
}
2018-11-07 19:31:39 -05:00
bool SoapySDRInput : : isAGCSupported ( )
{
const DeviceSoapySDRParams : : ChannelSettings * channelSettings = m_deviceShared . m_deviceParams - > getRxChannelSettings ( m_deviceShared . m_channel ) ;
return channelSettings - > m_hasAGC ;
}
2018-11-04 20:19:40 -05:00
const std : : vector < std : : string > & SoapySDRInput : : getAntennas ( )
{
const DeviceSoapySDRParams : : ChannelSettings * channelSettings = m_deviceShared . m_deviceParams - > getRxChannelSettings ( m_deviceShared . m_channel ) ;
return channelSettings - > m_antennas ;
}
2018-10-31 21:32:26 -04:00
const SoapySDR : : RangeList & SoapySDRInput : : getRateRanges ( )
{
const DeviceSoapySDRParams : : ChannelSettings * channelSettings = m_deviceShared . m_deviceParams - > getRxChannelSettings ( m_deviceShared . m_channel ) ;
return channelSettings - > m_ratesRanges ;
}
2018-11-04 20:19:40 -05:00
const SoapySDR : : RangeList & SoapySDRInput : : getBandwidthRanges ( )
2018-11-04 17:54:16 -05:00
{
const DeviceSoapySDRParams : : ChannelSettings * channelSettings = m_deviceShared . m_deviceParams - > getRxChannelSettings ( m_deviceShared . m_channel ) ;
2018-11-04 20:19:40 -05:00
return channelSettings - > m_bandwidthsRanges ;
2018-11-04 17:54:16 -05:00
}
int SoapySDRInput : : getAntennaIndex ( const std : : string & antenna )
{
const std : : vector < std : : string > & antennaList = getAntennas ( ) ;
std : : vector < std : : string > : : const_iterator it = std : : find ( antennaList . begin ( ) , antennaList . end ( ) , antenna ) ;
if ( it = = antennaList . end ( ) ) {
return - 1 ;
} else {
return it - antennaList . begin ( ) ;
}
}
2018-11-05 11:27:32 -05:00
const std : : vector < DeviceSoapySDRParams : : FrequencySetting > & SoapySDRInput : : getTunableElements ( )
{
const DeviceSoapySDRParams : : ChannelSettings * channelSettings = m_deviceShared . m_deviceParams - > getRxChannelSettings ( m_deviceShared . m_channel ) ;
return channelSettings - > m_frequencySettings ;
}
2018-11-06 19:33:17 -05:00
const std : : vector < DeviceSoapySDRParams : : GainSetting > & SoapySDRInput : : getIndividualGainsRanges ( )
{
const DeviceSoapySDRParams : : ChannelSettings * channelSettings = m_deviceShared . m_deviceParams - > getRxChannelSettings ( m_deviceShared . m_channel ) ;
return channelSettings - > m_gainSettings ;
}
2018-11-07 17:21:37 -05:00
void SoapySDRInput : : initGainSettings ( SoapySDRInputSettings & settings )
{
const DeviceSoapySDRParams : : ChannelSettings * channelSettings = m_deviceShared . m_deviceParams - > getRxChannelSettings ( m_deviceShared . m_channel ) ;
settings . m_individualGains . clear ( ) ;
settings . m_globalGain = 0 ;
for ( const auto & it : channelSettings - > m_gainSettings ) {
settings . m_individualGains [ QString ( it . m_name . c_str ( ) ) ] = 0.0 ;
}
updateGains ( m_deviceShared . m_device , m_deviceShared . m_channel , settings ) ;
}
2018-11-08 08:35:26 -05:00
bool SoapySDRInput : : hasDCAutoCorrection ( )
{
const DeviceSoapySDRParams : : ChannelSettings * channelSettings = m_deviceShared . m_deviceParams - > getRxChannelSettings ( m_deviceShared . m_channel ) ;
return channelSettings - > m_hasDCAutoCorrection ;
}
bool SoapySDRInput : : hasDCCorrectionValue ( )
{
const DeviceSoapySDRParams : : ChannelSettings * channelSettings = m_deviceShared . m_deviceParams - > getRxChannelSettings ( m_deviceShared . m_channel ) ;
return channelSettings - > m_hasDCOffsetValue ;
}
bool SoapySDRInput : : hasIQCorrectionValue ( )
{
const DeviceSoapySDRParams : : ChannelSettings * channelSettings = m_deviceShared . m_deviceParams - > getRxChannelSettings ( m_deviceShared . m_channel ) ;
return channelSettings - > m_hasIQBalanceValue ;
}
2018-10-29 11:39:25 -04:00
void SoapySDRInput : : init ( )
{
2018-11-04 05:45:59 -05:00
applySettings ( m_settings , true ) ;
2018-10-29 11:39:25 -04:00
}
2018-11-01 21:33:04 -04:00
SoapySDRInputThread * SoapySDRInput : : findThread ( )
{
if ( m_thread = = 0 ) // this does not own the thread
{
SoapySDRInputThread * soapySDRInputThread = 0 ;
// find a buddy that has allocated the thread
const std : : vector < DeviceSourceAPI * > & sourceBuddies = m_deviceAPI - > getSourceBuddies ( ) ;
std : : vector < DeviceSourceAPI * > : : const_iterator it = sourceBuddies . begin ( ) ;
for ( ; it ! = sourceBuddies . end ( ) ; + + it )
{
SoapySDRInput * buddySource = ( ( DeviceSoapySDRShared * ) ( * it ) - > getBuddySharedPtr ( ) ) - > m_source ;
if ( buddySource )
{
soapySDRInputThread = buddySource - > getThread ( ) ;
if ( soapySDRInputThread ) {
break ;
}
}
}
return soapySDRInputThread ;
}
else
{
return m_thread ; // own thread
}
}
2018-10-30 15:31:16 -04:00
void SoapySDRInput : : moveThreadToBuddy ( )
{
const std : : vector < DeviceSourceAPI * > & sourceBuddies = m_deviceAPI - > getSourceBuddies ( ) ;
std : : vector < DeviceSourceAPI * > : : const_iterator it = sourceBuddies . begin ( ) ;
for ( ; it ! = sourceBuddies . end ( ) ; + + it )
{
SoapySDRInput * buddySource = ( ( DeviceSoapySDRShared * ) ( * it ) - > getBuddySharedPtr ( ) ) - > m_source ;
if ( buddySource )
{
buddySource - > setThread ( m_thread ) ;
m_thread = 0 ; // zero for others
}
}
}
2018-10-29 11:39:25 -04:00
bool SoapySDRInput : : start ( )
{
2018-11-02 05:16:14 -04:00
// There is a single thread per physical device (Rx side). This thread is unique and referenced by a unique
// buddy in the group of source buddies associated with this physical device.
//
// This start method is responsible for managing the thread and number of channels when the streaming of a Rx channel is started
//
// It checks the following conditions
// - the thread is allocated or not (by itself or one of its buddies). If it is it grabs the thread pointer.
// - the requested channel is the first (0) or the following
//
// There are two possible working modes:
// - Single Input (SI) with only one channel streaming. This HAS to be channel 0.
// - Multiple Input (MI) with two or more channels. It MUST be in this configuration if any channel other than 0
// is used irrespective of what you actually do with samples coming from ignored channels.
2018-11-04 05:45:59 -05:00
// For example When we will run with only channel 2 streaming from the client perspective the channels 0 and 1 will actually
2018-11-02 05:16:14 -04:00
// be enabled and streaming but its samples will just be disregarded.
// This means that all channels up to the highest in index being used are activated.
//
// It manages the transition form SI where only one channel (the first or channel 0) should be running to the
// Multiple Input (MI) if the requested channel is 1 or more. More generally it checks if the requested channel is within the current
// channel range allocated in the thread or past it. To perform the transition it stops the thread, deletes it and creates a new one.
// It marks the thread as needing start.
//
// If the requested channel is within the thread channel range (this thread being already allocated) it simply adds its FIFO reference
// so that the samples are fed to the FIFO and leaves the thread unchanged (no stop, no delete/new)
//
// If there is no thread allocated it creates a new one with a number of channels that fits the requested channel. That is
// 1 if channel 0 is requested (SI mode) and 3 if channel 2 is requested (MI mode). It marks the thread as needing start.
//
// Eventually it registers the FIFO in the thread. If the thread has to be started it enables the channels up to the number of channels
// allocated in the thread and starts the thread.
//
// Note: this is quite similar to the BladeRF2 start handling. The main difference is that the channel allocation (enabling) process is
// done in the thread object.
if ( ! m_deviceShared . m_device )
{
qDebug ( " SoapySDRInput::start: no device object " ) ;
return false ;
}
int requestedChannel = m_deviceAPI - > getItemIndex ( ) ;
SoapySDRInputThread * soapySDRInputThread = findThread ( ) ;
bool needsStart = false ;
if ( soapySDRInputThread ) // if thread is already allocated
{
qDebug ( " SoapySDRInput::start: thread is already allocated " ) ;
int nbOriginalChannels = soapySDRInputThread - > getNbChannels ( ) ;
if ( requestedChannel + 1 > nbOriginalChannels ) // expansion by deleting and re-creating the thread
{
qDebug ( " SoapySDRInput::start: expand channels. Re-allocate thread and take ownership " ) ;
SampleSinkFifo * * fifos = new SampleSinkFifo * [ nbOriginalChannels ] ;
unsigned int * log2Decims = new unsigned int [ nbOriginalChannels ] ;
int * fcPoss = new int [ nbOriginalChannels ] ;
for ( int i = 0 ; i < nbOriginalChannels ; i + + ) // save original FIFO references and data
{
fifos [ i ] = soapySDRInputThread - > getFifo ( i ) ;
log2Decims [ i ] = soapySDRInputThread - > getLog2Decimation ( i ) ;
fcPoss [ i ] = soapySDRInputThread - > getFcPos ( i ) ;
}
soapySDRInputThread - > stopWork ( ) ;
delete soapySDRInputThread ;
soapySDRInputThread = new SoapySDRInputThread ( m_deviceShared . m_device , requestedChannel + 1 ) ;
m_thread = soapySDRInputThread ; // take ownership
for ( int i = 0 ; i < nbOriginalChannels ; i + + ) // restore original FIFO references
{
soapySDRInputThread - > setFifo ( i , fifos [ i ] ) ;
soapySDRInputThread - > setLog2Decimation ( i , log2Decims [ i ] ) ;
soapySDRInputThread - > setFcPos ( i , fcPoss [ i ] ) ;
}
// remove old thread address from buddies (reset in all buddies). The address being held only in the owning source.
const std : : vector < DeviceSourceAPI * > & sourceBuddies = m_deviceAPI - > getSourceBuddies ( ) ;
std : : vector < DeviceSourceAPI * > : : const_iterator it = sourceBuddies . begin ( ) ;
for ( ; it ! = sourceBuddies . end ( ) ; + + it ) {
( ( DeviceSoapySDRShared * ) ( * it ) - > getBuddySharedPtr ( ) ) - > m_source - > setThread ( 0 ) ;
}
needsStart = true ;
}
else
{
qDebug ( " SoapySDRInput::start: keep buddy thread " ) ;
}
}
else // first allocation
{
qDebug ( " SoapySDRInput::start: allocate thread and take ownership " ) ;
soapySDRInputThread = new SoapySDRInputThread ( m_deviceShared . m_device , requestedChannel + 1 ) ;
m_thread = soapySDRInputThread ; // take ownership
needsStart = true ;
}
soapySDRInputThread - > setFifo ( requestedChannel , & m_sampleFifo ) ;
soapySDRInputThread - > setLog2Decimation ( requestedChannel , m_settings . m_log2Decim ) ;
soapySDRInputThread - > setFcPos ( requestedChannel , ( int ) m_settings . m_fcPos ) ;
if ( needsStart )
{
qDebug ( " SoapySDRInput::start: (re)sart buddy thread " ) ;
2018-11-04 12:42:51 -05:00
soapySDRInputThread - > setSampleRate ( m_settings . m_devSampleRate ) ;
2018-11-02 05:16:14 -04:00
soapySDRInputThread - > startWork ( ) ;
}
qDebug ( " SoapySDRInput::start: started " ) ;
m_running = true ;
return true ;
2018-10-29 11:39:25 -04:00
}
void SoapySDRInput : : stop ( )
{
2018-11-02 05:16:14 -04:00
// This stop method is responsible for managing the thread and channel disabling when the streaming of
// a Rx channel is stopped
//
// If the thread is currently managing only one channel (SI mode). The thread can be just stopped and deleted.
// Then the channel is closed (disabled).
//
// If the thread is currently managing many channels (MI mode) and we are removing the last channel. The transition
// or reduction of MI size is handled by stopping the thread, deleting it and creating a new one
2018-11-04 05:45:59 -05:00
// with the maximum number of channels needed if (and only if) there is still a channel active.
2018-11-02 05:16:14 -04:00
//
// If the thread is currently managing many channels (MI mode) but the channel being stopped is not the last
// channel then the FIFO reference is simply removed from the thread so that it will not stream into this FIFO
// anymore. In this case the channel is not closed (this is managed in the thread object) so that other channels
// can continue with the same configuration. The device continues streaming on this channel but the samples are simply
// dropped (by removing FIFO reference).
//
// Note: this is quite similar to the BladeRF2 stop handling. The main difference is that the channel allocation (enabling) process is
// done in the thread object.
if ( ! m_running ) {
return ;
}
int requestedChannel = m_deviceAPI - > getItemIndex ( ) ;
SoapySDRInputThread * soapySDRInputThread = findThread ( ) ;
if ( soapySDRInputThread = = 0 ) { // no thread allocated
return ;
}
int nbOriginalChannels = soapySDRInputThread - > getNbChannels ( ) ;
if ( nbOriginalChannels = = 1 ) // SI mode => just stop and delete the thread
{
qDebug ( " SoapySDRInput::stop: SI mode. Just stop and delete the thread " ) ;
soapySDRInputThread - > stopWork ( ) ;
delete soapySDRInputThread ;
m_thread = 0 ;
// remove old thread address from buddies (reset in all buddies)
const std : : vector < DeviceSourceAPI * > & sourceBuddies = m_deviceAPI - > getSourceBuddies ( ) ;
std : : vector < DeviceSourceAPI * > : : const_iterator it = sourceBuddies . begin ( ) ;
for ( ; it ! = sourceBuddies . end ( ) ; + + it ) {
( ( DeviceSoapySDRShared * ) ( * it ) - > getBuddySharedPtr ( ) ) - > m_source - > setThread ( 0 ) ;
}
}
else if ( requestedChannel = = nbOriginalChannels - 1 ) // remove last MI channel => reduce by deleting and re-creating the thread
{
qDebug ( " SoapySDRInput::stop: MI mode. Reduce by deleting and re-creating the thread " ) ;
soapySDRInputThread - > stopWork ( ) ;
SampleSinkFifo * * fifos = new SampleSinkFifo * [ nbOriginalChannels - 1 ] ;
unsigned int * log2Decims = new unsigned int [ nbOriginalChannels - 1 ] ;
int * fcPoss = new int [ nbOriginalChannels - 1 ] ;
int highestActiveChannelIndex = - 1 ;
for ( int i = 0 ; i < nbOriginalChannels - 1 ; i + + ) // save original FIFO references and get the channel with highest index
{
fifos [ i ] = soapySDRInputThread - > getFifo ( i ) ;
if ( ( soapySDRInputThread - > getFifo ( i ) ! = 0 ) & & ( i > highestActiveChannelIndex ) ) {
highestActiveChannelIndex = i ;
}
log2Decims [ i ] = soapySDRInputThread - > getLog2Decimation ( i ) ;
fcPoss [ i ] = soapySDRInputThread - > getFcPos ( i ) ;
}
delete soapySDRInputThread ;
m_thread = 0 ;
if ( highestActiveChannelIndex > = 0 ) // there is at least one channel still active
{
soapySDRInputThread = new SoapySDRInputThread ( m_deviceShared . m_device , highestActiveChannelIndex + 1 ) ;
m_thread = soapySDRInputThread ; // take ownership
for ( int i = 0 ; i < highestActiveChannelIndex ; i + + ) // restore original FIFO references
{
soapySDRInputThread - > setFifo ( i , fifos [ i ] ) ;
soapySDRInputThread - > setLog2Decimation ( i , log2Decims [ i ] ) ;
soapySDRInputThread - > setFcPos ( i , fcPoss [ i ] ) ;
}
}
else
{
qDebug ( " SoapySDRInput::stop: do not re-create thread as there are no more FIFOs active " ) ;
}
// remove old thread address from buddies (reset in all buddies). The address being held only in the owning source.
const std : : vector < DeviceSourceAPI * > & sourceBuddies = m_deviceAPI - > getSourceBuddies ( ) ;
std : : vector < DeviceSourceAPI * > : : const_iterator it = sourceBuddies . begin ( ) ;
for ( ; it ! = sourceBuddies . end ( ) ; + + it ) {
( ( DeviceSoapySDRShared * ) ( * it ) - > getBuddySharedPtr ( ) ) - > m_source - > setThread ( 0 ) ;
}
2018-11-04 05:45:59 -05:00
if ( highestActiveChannelIndex > = 0 )
{
qDebug ( " SoapySDRInput::stop: restarting the thread " ) ;
2018-11-02 05:16:14 -04:00
soapySDRInputThread - > startWork ( ) ;
}
}
else // remove channel from existing thread
{
qDebug ( " SoapySDRInput::stop: MI mode. Not changing MI configuration. Just remove FIFO reference " ) ;
soapySDRInputThread - > setFifo ( requestedChannel , 0 ) ; // remove FIFO
}
m_running = false ;
2018-10-29 11:39:25 -04:00
}
QByteArray SoapySDRInput : : serialize ( ) const
{
SimpleSerializer s ( 1 ) ;
return s . final ( ) ;
}
2018-10-29 13:27:58 -04:00
bool SoapySDRInput : : deserialize ( const QByteArray & data __attribute__ ( ( unused ) ) )
2018-10-29 11:39:25 -04:00
{
return false ;
}
const QString & SoapySDRInput : : getDeviceDescription ( ) const
{
return m_deviceDescription ;
}
int SoapySDRInput : : getSampleRate ( ) const
{
2018-11-04 12:42:51 -05:00
int rate = m_settings . m_devSampleRate ;
return ( rate / ( 1 < < m_settings . m_log2Decim ) ) ;
2018-10-29 11:39:25 -04:00
}
quint64 SoapySDRInput : : getCenterFrequency ( ) const
{
2018-11-04 12:42:51 -05:00
return m_settings . m_centerFrequency ;
2018-10-29 11:39:25 -04:00
}
2018-10-29 13:27:58 -04:00
void SoapySDRInput : : setCenterFrequency ( qint64 centerFrequency __attribute__ ( ( unused ) ) )
2018-10-29 11:39:25 -04:00
{
2018-11-04 12:42:51 -05:00
SoapySDRInputSettings settings = m_settings ;
settings . m_centerFrequency = centerFrequency ;
MsgConfigureSoapySDRInput * message = MsgConfigureSoapySDRInput : : create ( settings , false ) ;
m_inputMessageQueue . push ( message ) ;
if ( m_guiMessageQueue )
{
MsgConfigureSoapySDRInput * messageToGUI = MsgConfigureSoapySDRInput : : create ( settings , false ) ;
m_guiMessageQueue - > push ( messageToGUI ) ;
}
2018-10-29 11:39:25 -04:00
}
2018-11-01 21:33:04 -04:00
bool SoapySDRInput : : setDeviceCenterFrequency ( SoapySDR : : Device * dev , int requestedChannel , quint64 freq_hz , int loPpmTenths )
{
qint64 df = ( ( qint64 ) freq_hz * loPpmTenths ) / 10000000LL ;
freq_hz + = df ;
try
{
dev - > setFrequency ( SOAPY_SDR_RX ,
requestedChannel ,
m_deviceShared . m_deviceParams - > getRxChannelMainTunableElementName ( requestedChannel ) ,
freq_hz ) ;
qDebug ( " SoapySDRInput::setDeviceCenterFrequency: setFrequency(%llu) " , freq_hz ) ;
return true ;
}
catch ( const std : : exception & ex )
{
qCritical ( " SoapySDRInput::applySettings: could not set frequency: %llu: %s " , freq_hz , ex . what ( ) ) ;
return false ;
}
}
2018-11-07 17:21:37 -05:00
void SoapySDRInput : : updateGains ( SoapySDR : : Device * dev , int requestedChannel , SoapySDRInputSettings & settings )
{
if ( dev = = 0 ) {
return ;
}
settings . m_globalGain = round ( dev - > getGain ( SOAPY_SDR_RX , requestedChannel ) ) ;
for ( const auto & name : settings . m_individualGains . keys ( ) ) {
settings . m_individualGains [ name ] = dev - > getGain ( SOAPY_SDR_RX , requestedChannel , name . toStdString ( ) ) ;
}
}
2018-10-29 13:27:58 -04:00
bool SoapySDRInput : : handleMessage ( const Message & message __attribute__ ( ( unused ) ) )
2018-10-29 11:39:25 -04:00
{
2018-11-01 21:33:04 -04:00
if ( MsgConfigureSoapySDRInput : : match ( message ) )
{
MsgConfigureSoapySDRInput & conf = ( MsgConfigureSoapySDRInput & ) message ;
qDebug ( ) < < " SoapySDRInput::handleMessage: MsgConfigureSoapySDRInput " ;
if ( ! applySettings ( conf . getSettings ( ) , conf . getForce ( ) ) ) {
qDebug ( " SoapySDRInput::handleMessage: MsgConfigureSoapySDRInput config error " ) ;
}
return true ;
}
else if ( MsgFileRecord : : match ( message ) )
{
MsgFileRecord & conf = ( MsgFileRecord & ) message ;
qDebug ( ) < < " SoapySDRInput::handleMessage: MsgFileRecord: " < < conf . getStartStop ( ) ;
if ( conf . getStartStop ( ) )
{
if ( m_settings . m_fileRecordName . size ( ) ! = 0 ) {
m_fileSink - > setFileName ( m_settings . m_fileRecordName ) ;
} else {
m_fileSink - > genUniqueFileName ( m_deviceAPI - > getDeviceUID ( ) ) ;
}
m_fileSink - > startRecording ( ) ;
}
else
{
m_fileSink - > stopRecording ( ) ;
}
return true ;
}
else if ( MsgStartStop : : match ( message ) )
{
MsgStartStop & cmd = ( MsgStartStop & ) message ;
qDebug ( ) < < " SoapySDRInput::handleMessage: MsgStartStop: " < < ( cmd . getStartStop ( ) ? " start " : " stop " ) ;
if ( cmd . getStartStop ( ) )
{
if ( m_deviceAPI - > initAcquisition ( ) )
{
m_deviceAPI - > startAcquisition ( ) ;
}
}
else
{
m_deviceAPI - > stopAcquisition ( ) ;
}
return true ;
}
else if ( DeviceSoapySDRShared : : MsgReportBuddyChange : : match ( message ) )
{
int requestedChannel = m_deviceAPI - > getItemIndex ( ) ;
DeviceSoapySDRShared : : MsgReportBuddyChange & report = ( DeviceSoapySDRShared : : MsgReportBuddyChange & ) message ;
SoapySDRInputSettings settings = m_settings ;
settings . m_fcPos = ( SoapySDRInputSettings : : fcPos_t ) report . getFcPos ( ) ;
2018-11-04 12:42:51 -05:00
//bool fromRxBuddy = report.getRxElseTx();
2018-11-01 21:33:04 -04:00
2018-11-04 13:17:47 -05:00
double centerFrequency = m_deviceShared . m_device - > getFrequency (
2018-11-01 21:33:04 -04:00
SOAPY_SDR_RX ,
requestedChannel ,
m_deviceShared . m_deviceParams - > getRxChannelMainTunableElementName ( requestedChannel ) ) ;
2018-11-04 13:17:47 -05:00
settings . m_centerFrequency = round ( centerFrequency / 1000.0 ) * 1000 ;
settings . m_devSampleRate = round ( m_deviceShared . m_device - > getSampleRate ( SOAPY_SDR_RX , requestedChannel ) ) ;
2018-11-04 20:19:40 -05:00
settings . m_bandwidth = round ( m_deviceShared . m_device - > getBandwidth ( SOAPY_SDR_RX , requestedChannel ) ) ;
2018-11-01 21:33:04 -04:00
SoapySDRInputThread * inputThread = findThread ( ) ;
if ( inputThread )
{
inputThread - > setFcPos ( requestedChannel , ( int ) settings . m_fcPos ) ;
}
m_settings = settings ;
2018-11-04 12:42:51 -05:00
// propagate settings to GUI if any
if ( getMessageQueueToGUI ( ) )
{
MsgConfigureSoapySDRInput * reportToGUI = MsgConfigureSoapySDRInput : : create ( m_settings , false ) ;
getMessageQueueToGUI ( ) - > push ( reportToGUI ) ;
}
2018-11-01 21:33:04 -04:00
return true ;
}
else
{
return false ;
}
}
bool SoapySDRInput : : applySettings ( const SoapySDRInputSettings & settings , bool force )
{
bool forwardChangeOwnDSP = false ;
bool forwardChangeToBuddies = false ;
2018-11-07 17:21:37 -05:00
bool globalGainChanged = false ;
bool individualGainsChanged = false ;
2018-11-01 21:33:04 -04:00
SoapySDR : : Device * dev = m_deviceShared . m_device ;
SoapySDRInputThread * inputThread = findThread ( ) ;
int requestedChannel = m_deviceAPI - > getItemIndex ( ) ;
qint64 xlatedDeviceCenterFrequency = settings . m_centerFrequency ;
xlatedDeviceCenterFrequency - = settings . m_transverterMode ? settings . m_transverterDeltaFrequency : 0 ;
xlatedDeviceCenterFrequency = xlatedDeviceCenterFrequency < 0 ? 0 : xlatedDeviceCenterFrequency ;
2018-11-08 08:35:26 -05:00
if ( ( m_settings . m_softDCCorrection ! = settings . m_softDCCorrection ) | |
( m_settings . m_softIQCorrection ! = settings . m_softIQCorrection ) | | force )
2018-11-01 21:33:04 -04:00
{
2018-11-08 08:35:26 -05:00
m_deviceAPI - > configureCorrections ( settings . m_softDCCorrection , settings . m_softIQCorrection ) ;
2018-11-01 21:33:04 -04:00
}
if ( ( m_settings . m_devSampleRate ! = settings . m_devSampleRate ) | | force )
{
forwardChangeOwnDSP = true ;
forwardChangeToBuddies = true ;
if ( dev ! = 0 )
{
try
{
dev - > setSampleRate ( SOAPY_SDR_RX , requestedChannel , settings . m_devSampleRate ) ;
qDebug ( ) < < " SoapySDRInput::applySettings: setSampleRate OK: " < < settings . m_devSampleRate ;
if ( inputThread )
{
bool wasRunning = inputThread - > isRunning ( ) ;
inputThread - > stopWork ( ) ;
inputThread - > setSampleRate ( settings . m_devSampleRate ) ;
if ( wasRunning ) {
inputThread - > startWork ( ) ;
}
}
}
catch ( const std : : exception & ex )
{
qCritical ( " SoapySDRInput::applySettings: could not set sample rate: %d: %s " ,
settings . m_devSampleRate , ex . what ( ) ) ;
}
}
}
if ( ( m_settings . m_fcPos ! = settings . m_fcPos ) | | force )
{
if ( inputThread ! = 0 )
{
inputThread - > setFcPos ( requestedChannel , ( int ) settings . m_fcPos ) ;
qDebug ( ) < < " SoapySDRInput::applySettings: set fc pos (enum) to " < < ( int ) settings . m_fcPos ;
}
}
if ( ( m_settings . m_log2Decim ! = settings . m_log2Decim ) | | force )
{
forwardChangeOwnDSP = true ;
SoapySDRInputThread * inputThread = findThread ( ) ;
if ( inputThread ! = 0 )
{
inputThread - > setLog2Decimation ( requestedChannel , settings . m_log2Decim ) ;
qDebug ( ) < < " SoapySDRInput::applySettings: set decimation to " < < ( 1 < < settings . m_log2Decim ) ;
}
}
if ( ( m_settings . m_centerFrequency ! = settings . m_centerFrequency )
| | ( m_settings . m_transverterMode ! = settings . m_transverterMode )
| | ( m_settings . m_transverterDeltaFrequency ! = settings . m_transverterDeltaFrequency )
| | ( m_settings . m_LOppmTenths ! = settings . m_LOppmTenths )
| | ( m_settings . m_devSampleRate ! = settings . m_devSampleRate )
| | ( m_settings . m_fcPos ! = settings . m_fcPos )
| | ( m_settings . m_log2Decim ! = settings . m_log2Decim ) | | force )
{
qint64 deviceCenterFrequency = DeviceSampleSource : : calculateDeviceCenterFrequency (
xlatedDeviceCenterFrequency ,
0 ,
settings . m_log2Decim ,
( DeviceSampleSource : : fcPos_t ) settings . m_fcPos ,
settings . m_devSampleRate ) ;
forwardChangeOwnDSP = true ;
forwardChangeToBuddies = true ;
if ( dev ! = 0 ) {
setDeviceCenterFrequency ( dev , requestedChannel , deviceCenterFrequency , settings . m_LOppmTenths ) ;
}
}
2018-11-04 17:54:16 -05:00
if ( ( m_settings . m_antenna ! = settings . m_antenna ) | | force )
{
if ( dev ! = 0 )
{
try
{
dev - > setAntenna ( SOAPY_SDR_RX , requestedChannel , settings . m_antenna . toStdString ( ) ) ;
qDebug ( " SoapySDRInput::applySettings: set antenna to %s " , settings . m_antenna . toStdString ( ) . c_str ( ) ) ;
}
catch ( const std : : exception & ex )
{
qCritical ( " SoapySDRInput::applySettings: cannot set antenna to %s: %s " ,
settings . m_antenna . toStdString ( ) . c_str ( ) , ex . what ( ) ) ;
}
}
}
2018-11-04 20:19:40 -05:00
if ( ( m_settings . m_bandwidth ! = settings . m_bandwidth ) | | force )
{
forwardChangeToBuddies = true ;
if ( dev ! = 0 )
{
try
{
dev - > setBandwidth ( SOAPY_SDR_RX , requestedChannel , settings . m_bandwidth ) ;
qDebug ( " SoapySDRInput::applySettings: bandwidth set to %u " , settings . m_bandwidth ) ;
}
catch ( const std : : exception & ex )
{
qCritical ( " SoapySDRInput::applySettings: cannot set bandwidth to %u: %s " ,
settings . m_bandwidth , ex . what ( ) ) ;
}
}
}
2018-11-06 02:32:47 -05:00
for ( const auto & oname : m_settings . m_tunableElements . keys ( ) )
{
auto nvalue = settings . m_tunableElements . find ( oname ) ;
if ( nvalue ! = settings . m_tunableElements . end ( ) & & ( m_settings . m_tunableElements [ oname ] ! = * nvalue ) )
{
if ( dev ! = 0 )
{
try
{
dev - > setFrequency ( SOAPY_SDR_RX , requestedChannel , oname . toStdString ( ) , * nvalue ) ;
qDebug ( " SoapySDRInput::applySettings: tunable element %s frequency set to %lf " ,
oname . toStdString ( ) . c_str ( ) , * nvalue ) ;
}
catch ( const std : : exception & ex )
{
qCritical ( " SoapySDRInput::applySettings: cannot set tunable element %s to %lf: %s " ,
oname . toStdString ( ) . c_str ( ) , * nvalue , ex . what ( ) ) ;
}
}
m_settings . m_tunableElements [ oname ] = * nvalue ;
}
}
2018-11-06 19:33:17 -05:00
if ( ( m_settings . m_globalGain ! = settings . m_globalGain ) | | force )
{
if ( dev ! = 0 )
{
try
{
dev - > setGain ( SOAPY_SDR_RX , requestedChannel , settings . m_globalGain ) ;
2018-11-07 07:08:35 -05:00
qDebug ( " SoapySDRInput::applySettings: set global gain to %d " , settings . m_globalGain ) ;
2018-11-07 17:21:37 -05:00
globalGainChanged = true ;
2018-11-06 19:33:17 -05:00
}
catch ( const std : : exception & ex )
{
2018-11-07 07:08:35 -05:00
qCritical ( " SoapySDRInput::applySettings: cannot set global gain to %d: %s " ,
2018-11-06 19:33:17 -05:00
settings . m_globalGain , ex . what ( ) ) ;
}
}
}
2018-11-07 07:38:42 -05:00
for ( const auto & oname : m_settings . m_individualGains . keys ( ) )
{
auto nvalue = settings . m_individualGains . find ( oname ) ;
2018-11-07 17:21:37 -05:00
if ( nvalue ! = settings . m_individualGains . end ( ) & & ( ( m_settings . m_individualGains [ oname ] ! = * nvalue ) | | force ) )
2018-11-07 07:38:42 -05:00
{
if ( dev ! = 0 )
{
try
{
dev - > setGain ( SOAPY_SDR_RX , requestedChannel , oname . toStdString ( ) , * nvalue ) ;
qDebug ( " SoapySDRInput::applySettings: individual gain %s set to %lf " ,
oname . toStdString ( ) . c_str ( ) , * nvalue ) ;
2018-11-07 17:21:37 -05:00
individualGainsChanged = true ;
2018-11-07 07:38:42 -05:00
}
catch ( const std : : exception & ex )
{
qCritical ( " SoapySDRInput::applySettings: cannot set individual gain %s to %lf: %s " ,
oname . toStdString ( ) . c_str ( ) , * nvalue , ex . what ( ) ) ;
}
}
m_settings . m_individualGains [ oname ] = * nvalue ;
}
}
2018-11-07 19:31:39 -05:00
if ( ( m_settings . m_autoGain ! = settings . m_autoGain ) | | force )
{
if ( dev ! = 0 )
{
try
{
dev - > setGainMode ( SOAPY_SDR_RX , requestedChannel , settings . m_autoGain ) ;
qDebug ( " SoapySDRInput::applySettings: %s AGC " , settings . m_autoGain ? " set " : " unset " ) ;
}
catch ( const std : : exception & ex )
{
qCritical ( " SoapySDRInput::applySettings: cannot %s AGC " , settings . m_autoGain ? " set " : " unset " ) ;
}
}
}
2018-11-08 10:53:15 -05:00
if ( ( m_settings . m_autoDCCorrection ! = settings . m_autoDCCorrection ) | | force )
{
if ( ( dev ! = 0 ) & & hasDCAutoCorrection ( ) )
{
try
{
dev - > setDCOffsetMode ( SOAPY_SDR_RX , requestedChannel , settings . m_autoDCCorrection ) ;
qDebug ( " SoapySDRInput::applySettings: %s DC auto correction " , settings . m_autoGain ? " set " : " unset " ) ;
}
catch ( const std : : exception & ex )
{
qCritical ( " SoapySDRInput::applySettings: cannot %s DC auto correction " , settings . m_autoGain ? " set " : " unset " ) ;
}
}
}
if ( ( m_settings . m_dcCorrection ! = settings . m_dcCorrection ) | | force )
{
if ( ( dev ! = 0 ) & & hasDCCorrectionValue ( ) )
{
try
{
dev - > setDCOffset ( SOAPY_SDR_RX , requestedChannel , settings . m_dcCorrection ) ;
qDebug ( " SoapySDRInput::applySettings: DC offset correction set to (%lf, %lf) " , settings . m_dcCorrection . real ( ) , settings . m_dcCorrection . imag ( ) ) ;
}
catch ( const std : : exception & ex )
{
qCritical ( " SoapySDRInput::applySettings: cannot set DC offset correction to (%lf, %lf) " , settings . m_dcCorrection . real ( ) , settings . m_dcCorrection . imag ( ) ) ;
}
}
}
if ( ( m_settings . m_iqCorrection ! = settings . m_iqCorrection ) | | force )
{
if ( ( dev ! = 0 ) & & hasIQCorrectionValue ( ) )
{
try
{
dev - > setIQBalance ( SOAPY_SDR_RX , requestedChannel , settings . m_iqCorrection ) ;
qDebug ( " SoapySDRInput::applySettings: IQ balance correction set to (%lf, %lf) " , settings . m_iqCorrection . real ( ) , settings . m_iqCorrection . imag ( ) ) ;
}
catch ( const std : : exception & ex )
{
qCritical ( " SoapySDRInput::applySettings: cannot set IQ balance correction to (%lf, %lf) " , settings . m_iqCorrection . real ( ) , settings . m_iqCorrection . imag ( ) ) ;
}
}
}
2018-11-01 21:33:04 -04:00
if ( forwardChangeOwnDSP )
{
int sampleRate = settings . m_devSampleRate / ( 1 < < settings . m_log2Decim ) ;
DSPSignalNotification * notif = new DSPSignalNotification ( sampleRate , settings . m_centerFrequency ) ;
m_fileSink - > handleMessage ( * notif ) ; // forward to file sink
m_deviceAPI - > getDeviceEngineInputMessageQueue ( ) - > push ( notif ) ;
}
if ( forwardChangeToBuddies )
{
// send to source buddies
const std : : vector < DeviceSourceAPI * > & sourceBuddies = m_deviceAPI - > getSourceBuddies ( ) ;
const std : : vector < DeviceSinkAPI * > & sinkBuddies = m_deviceAPI - > getSinkBuddies ( ) ;
for ( const auto & itSource : sourceBuddies )
{
DeviceSoapySDRShared : : MsgReportBuddyChange * report = DeviceSoapySDRShared : : MsgReportBuddyChange : : create (
settings . m_centerFrequency ,
settings . m_LOppmTenths ,
( int ) settings . m_fcPos ,
settings . m_devSampleRate ,
true ) ;
itSource - > getSampleSourceInputMessageQueue ( ) - > push ( report ) ;
}
for ( const auto & itSink : sinkBuddies )
{
DeviceSoapySDRShared : : MsgReportBuddyChange * report = DeviceSoapySDRShared : : MsgReportBuddyChange : : create (
settings . m_centerFrequency ,
settings . m_LOppmTenths ,
( int ) settings . m_fcPos ,
settings . m_devSampleRate ,
true ) ;
itSink - > getSampleSinkInputMessageQueue ( ) - > push ( report ) ;
}
}
m_settings = settings ;
2018-11-07 17:21:37 -05:00
if ( globalGainChanged | | individualGainsChanged )
{
if ( dev ) {
updateGains ( dev , requestedChannel , m_settings ) ;
}
if ( getMessageQueueToGUI ( ) )
{
MsgReportGainChange * report = MsgReportGainChange : : create ( m_settings , individualGainsChanged , globalGainChanged ) ;
getMessageQueueToGUI ( ) - > push ( report ) ;
}
}
2018-11-01 21:33:04 -04:00
qDebug ( ) < < " SoapySDRInput::applySettings: "
< < " m_transverterMode: " < < m_settings . m_transverterMode
< < " m_transverterDeltaFrequency: " < < m_settings . m_transverterDeltaFrequency
< < " m_centerFrequency: " < < m_settings . m_centerFrequency < < " Hz "
< < " m_LOppmTenths: " < < m_settings . m_LOppmTenths
< < " m_log2Decim: " < < m_settings . m_log2Decim
< < " m_fcPos: " < < m_settings . m_fcPos
< < " m_devSampleRate: " < < m_settings . m_devSampleRate
2018-11-08 08:35:26 -05:00
< < " m_softDCCorrection: " < < m_settings . m_softDCCorrection
< < " m_softIQCorrection: " < < m_settings . m_softIQCorrection
2018-11-04 20:19:40 -05:00
< < " m_antenna: " < < m_settings . m_antenna
2018-11-06 19:33:17 -05:00
< < " m_bandwidth: " < < m_settings . m_bandwidth
< < " m_globalGain: " < < m_settings . m_globalGain ;
2018-11-01 21:33:04 -04:00
return true ;
2018-10-29 11:39:25 -04:00
}