Misc. enhancements (driven by RSPDuo support needs) (#786)

* Add Device name in main window title bar

* Cleaner stopping of device in case of device loss

src/AppFrame.cpp

@@ -1404,7 +1404,13 @@ bool AppFrame::actionOnMenuReset(wxCommandEvent& event) {
         wxGetApp().getSpectrumProcessor()->setFFTAverageRate(0.65f);
         spectrumAvgMeter->setLevel(0.65f);
 
-        SetTitle(CUBICSDR_TITLE);
+        wxString titleBar = CUBICSDR_TITLE;
+        //append the name of the current Device, if any.
+        if (wxGetApp().getDevice()) {
+            titleBar += " - " + wxGetApp().getDevice()->getName();
+        }
+
+        SetTitle(titleBar);
         currentSessionFile = "";
 		currentBookmarkFile = "";
         bookmarkSplitter->Unsplit(bookmarkView);
@@ -2642,7 +2648,14 @@ void AppFrame::saveSession(std::string fileName) {
     currentSessionFile = fileName;
     std::string filePart = fileName.substr(fileName.find_last_of(filePathSeparator) + 1);
     GetStatusBar()->SetStatusText(wxString::Format(wxT("Saved session: %s"), currentSessionFile.c_str()));
-    SetTitle(wxString::Format(wxT("%s: %s"), CUBICSDR_TITLE, filePart.c_str()));
+
+    wxString titleBar = CUBICSDR_TITLE;
+    //append the name of the current Device, if any.
+    if (wxGetApp().getDevice()) {
+        titleBar += " - " + wxGetApp().getDevice()->getName();
+    }
+    titleBar += ": " + filePart;
+    SetTitle(titleBar);
 }
 
 bool AppFrame::loadSession(std::string fileName) {
@@ -2677,7 +2690,14 @@ bool AppFrame::loadSession(std::string fileName) {
     std::string filePart = fileName.substr(fileName.find_last_of(filePathSeparator) + 1);
 
     GetStatusBar()->SetStatusText(wxString::Format(wxT("Loaded session file: %s"), currentSessionFile.c_str()));
-    SetTitle(wxString::Format(wxT("%s: %s"), CUBICSDR_TITLE, filePart.c_str()));
+
+    wxString titleBar = CUBICSDR_TITLE;
+    //append the name of the current Device, if any.
+    if (wxGetApp().getDevice()) {
+        titleBar += " - " + wxGetApp().getDevice()->getName();
+    }
+    titleBar += ": " + filePart;
+    SetTitle(titleBar);
 
     wxGetApp().getBookmarkMgr().updateActiveList();
 

src/forms/SDRDevices/SDRDevices.cpp

@@ -32,7 +32,6 @@ SDRDevicesDialog::SDRDevicesDialog( wxWindow* parent, const wxPoint &pos): devFr
 #elif _WIN32
     SetIcon(wxICON(frame_icon));
 #endif
-
 }
 
 void SDRDevicesDialog::OnClose( wxCloseEvent& /* event */) {
@@ -395,6 +394,12 @@ void SDRDevicesDialog::OnUseSelected( wxMouseEvent& event) {
         wxGetApp().setDeviceArgs(settingArgs);
         wxGetApp().setStreamArgs(streamArgs);
         wxGetApp().setDevice(dev,0);
+        
+        //update main application title with Device name:
+        wxString titleBar = CUBICSDR_TITLE;
+        titleBar += " - " + wxGetApp().getDevice()->getName();
+        wxGetApp().getAppFrame()->SetTitle(titleBar);
+
         Close();
     }
     event.Skip();

src/sdr/SoapySDRThread.cpp

@@ -10,7 +10,8 @@
 #include <SoapySDR/Logger.h>
 #include <chrono>
 
-#define TARGET_DISPLAY_FPS 60
+#define TARGET_DISPLAY_FPS (60)
+#define SDR_DEVICE_LOST (-666)
 
 SDRThread::SDRThread() : IOThread(), buffers("SDRThreadBuffers") {
     device = nullptr;
@@ -240,6 +241,7 @@ int SDRThread::readStream(SDRThreadIQDataQueuePtr iqDataOutQueue) {
         }
     } //end if numOverflow > 0
     
+    //default means blocking.
     int readStreamCode = 0;
 
     //2. attempt readStream() at most nElems, by mtElems-sized chunks, append in dataOut->data directly.
@@ -257,8 +259,29 @@ int SDRThread::readStream(SDRThreadIQDataQueuePtr iqDataOutQueue) {
              break;
         }
         else if (n_stream_read < 0) {
-            std::cout << "SDRThread::readStream(): 2. SoapySDR read failed with code: " << n_stream_read << std::endl;
-            break;
+
+            //trace here interesting error codes from the Soapy side.
+            switch (n_stream_read) {
+
+            case SOAPY_SDR_TIMEOUT:
+                std::cout << "SDRThread::readStream(): 2. SoapySDR read failed with code SOAPY_SDR_TIMEOUT";
+                break;
+            case SOAPY_SDR_STREAM_ERROR:
+                std::cout << "SDRThread::readStream(): 2. SoapySDR read failed with code SOAPY_SDR_STREAM_ERROR";
+                break;
+
+            case SOAPY_SDR_CORRUPTION:
+                std::cout << "SDRThread::readStream(): 2. SoapySDR read failed with code SOAPY_SDR_CORRUPTION";
+                break;
+
+            case SOAPY_SDR_NOT_SUPPORTED:
+                //return a special code to mean that the device has to be stopped entirely:
+                std::cout << "SDRThread::readStream(): 2. SoapySDR read failed with code SOAPY_SDR_NOT_SUPPORTED => stopping device.";
+                readStreamCode = SDR_DEVICE_LOST;
+                break;
+            default:
+                std::cout << "SDRThread::readStream(): 2. SoapySDR read failed with unknown code: " << n_stream_read << std::endl;
+            }
         }
         
         //sucess read beyond nElems, so with overflow:
@@ -360,7 +383,7 @@ int SDRThread::readStream(SDRThreadIQDataQueuePtr iqDataOutQueue) {
         if (!iqDataOutQueue->try_push(dataOut)) {
             //The rest of the system saturates,
             //finally the push didn't suceeded.
-            readStreamCode = -32;
+            readStreamCode = 0;
             std::cout << "SDRThread::readStream(): 3.2 iqDataOutQueue output queue is full, discard processing of the batch..." << std::endl;
 
             //saturation, let a chance to the other threads to consume the existing samples
@@ -368,7 +391,7 @@ int SDRThread::readStream(SDRThreadIQDataQueuePtr iqDataOutQueue) {
         }
     }
     else {
-        readStreamCode = -31;
+        readStreamCode = 0;
         std::cout << "SDRThread::readStream(): 3.1 iqDataOutQueue output queue is full, discard processing of the batch..." << std::endl;
         //saturation, let a chance to the other threads to consume the existing samples
         std::this_thread::yield();
@@ -388,13 +411,22 @@ void SDRThread::readLoop() {
     
     updateGains();
  
-    while (!stopping.load()) {
+    try {
+        while (!stopping.load()) {
 
-        updateSettings();
+            updateSettings();
 
-        readStream(iqDataOutQueue);
-
-    } //End while
+            if (SDR_DEVICE_LOST == readStream(iqDataOutQueue)) {
+                //stop reading loop:
+                stopping = true;
+            }
+        } //End while
+    }
+    catch (...) {
+        //notify App of device loss:
+        std::cout << "SDRThread::readLoop() exception, stopping device..." << std::endl << std::flush;
+        stopping = true;
+    }
 
     iqDataOutQueue->flush();
 }

src/sdr/SoapySDRThread.h

@@ -49,7 +49,7 @@ private:
     void deinit();
     
     //returns the SoapyDevice readStream return value,
-    //i.e if >= 0 the numbre of samples read, else if < 0 an error code.
+    //i.e if >= 0 the number of samples read, else if < 0 an error code.
     int readStream(SDRThreadIQDataQueuePtr iqDataOutQueue);
 
     void readLoop();