From 95e0783b250d39f7ea770aa1016105895843c2ec Mon Sep 17 00:00:00 2001 From: Wahaj18 <48466561+Wahaj18@users.noreply.github.com> Date: Tue, 13 Oct 2026 11:03:18 +0500 Subject: [PATCH 1/4] SondeHub: batch telemetry uploads every 15s and send fixed listener position every 3 hours Fixes #2999 --- plugins/feature/radiosonde/radiosondegui.h | 2 +- sdrbase/util/sondehub.cpp | 16 ++++++++++++---- sdrbase/util/sondehub.h | 4 ++++ 3 files changed, 17 insertions(+), 5 deletions(-) diff --git a/plugins/feature/radiosonde/radiosondegui.h b/plugins/feature/radiosonde/radiosondegui.h index e461c25b3..b59985f95 100644 --- a/plugins/feature/radiosonde/radiosondegui.h +++ b/plugins/feature/radiosonde/radiosondegui.h @@ -110,7 +110,7 @@ private: QDateTime m_lastPositionUpdate; QTimer m_positionUpdateTimer; static const int m_minMobilePositionUpdateTime = 30; // In seconds - static const int m_minFixedPositionUpdateTime = 5 * 60; + static const int m_minFixedPositionUpdateTime = 3 * 60 * 60; QTimer m_predicitionTimer; QStringList m_predictions; diff --git a/sdrbase/util/sondehub.cpp b/sdrbase/util/sondehub.cpp index d15e665f7..2f4c28c1c 100644 --- a/sdrbase/util/sondehub.cpp +++ b/sdrbase/util/sondehub.cpp @@ -29,6 +29,8 @@ SondeHub::SondeHub() { m_networkManager = new QNetworkAccessManager(); connect(m_networkManager, &QNetworkAccessManager::finished, this, &SondeHub::handleReply); + connect(&m_uploadTimer, &QTimer::timeout, this, &SondeHub::uploadQueuedTelemetry); + m_uploadTimer.start(m_uploadPeriodMs); } SondeHub::~SondeHub() @@ -128,12 +130,18 @@ void SondeHub::upload( //obj.insert("dev", true); //qDebug() << obj; - QJsonArray payloads { - obj - }; + m_telemetryQueue.append(obj); +} + +void SondeHub::uploadQueuedTelemetry() +{ + if (m_telemetryQueue.isEmpty()) { + return; + } - QJsonDocument doc(payloads); + QJsonDocument doc(m_telemetryQueue); QByteArray data = doc.toJson(); + m_telemetryQueue = QJsonArray(); QUrl url(QString("https://api.v2.sondehub.org/sondes/telemetry")); diff --git a/sdrbase/util/sondehub.h b/sdrbase/util/sondehub.h index 8409ac94b..f15304c2b 100644 --- a/sdrbase/util/sondehub.h +++ b/sdrbase/util/sondehub.h @@ -72,6 +72,7 @@ public: private slots: void handleReply(QNetworkReply* reply); + void uploadQueuedTelemetry(); signals: void prediction(const QString& serial, const QList& path); @@ -79,6 +80,9 @@ signals: private: QNetworkAccessManager *m_networkManager; + QJsonArray m_telemetryQueue; + QTimer m_uploadTimer; + static const int m_uploadPeriodMs = 15000; // SondeHub asks for uploads no more often than every 15s }; From 5a60d971f2cde5eb2bb5bcc3454a746787756312 Mon Sep 17 00:00:00 2001 From: Wahaj18 <48466561+Wahaj18@users.noreply.github.com> Date: Tue, 13 Oct 2026 11:44:41 +0500 Subject: [PATCH 2/4] SondeHub: requeue telemetry batch if upload fails and cap queue size --- sdrbase/util/sondehub.cpp | 31 +++++++++++++++++++++++++++---- sdrbase/util/sondehub.h | 3 +++ 2 files changed, 30 insertions(+), 4 deletions(-) diff --git a/sdrbase/util/sondehub.cpp b/sdrbase/util/sondehub.cpp index 2f4c28c1c..5a0cd2e4a 100644 --- a/sdrbase/util/sondehub.cpp +++ b/sdrbase/util/sondehub.cpp @@ -131,17 +131,21 @@ void SondeHub::upload( //obj.insert("dev", true); //qDebug() << obj; m_telemetryQueue.append(obj); + while (m_telemetryQueue.size() > m_maxQueueSize) { + m_telemetryQueue.removeFirst(); + } } void SondeHub::uploadQueuedTelemetry() { - if (m_telemetryQueue.isEmpty()) { + if (m_telemetryQueue.isEmpty() || m_telemetryReply) { return; } - QJsonDocument doc(m_telemetryQueue); - QByteArray data = doc.toJson(); + m_telemetryInFlight = m_telemetryQueue; m_telemetryQueue = QJsonArray(); + QJsonDocument doc(m_telemetryInFlight); + QByteArray data = doc.toJson(); QUrl url(QString("https://api.v2.sondehub.org/sondes/telemetry")); @@ -150,7 +154,7 @@ void SondeHub::uploadQueuedTelemetry() request.setHeader(QNetworkRequest::UserAgentHeader, "sdrangel"); request.setRawHeader("Date", QDateTime::currentDateTimeUtc().toString(Qt::ISODateWithMs).toLatin1()); - m_networkManager->put(request, data); + m_telemetryReply = m_networkManager->put(request, data); } void SondeHub::updatePosition( @@ -204,6 +208,25 @@ void SondeHub::getPrediction(const QString& serial) void SondeHub::handleReply(QNetworkReply* reply) { + if (reply && (reply == m_telemetryReply)) + { + int status = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute).toInt(); + + if (reply->error() || (status < 200) || (status >= 300)) + { + // Requeue failed batch ahead of newer telemetry + for (const auto& value : m_telemetryQueue) { + m_telemetryInFlight.append(value); + } + m_telemetryQueue = m_telemetryInFlight; + while (m_telemetryQueue.size() > m_maxQueueSize) { + m_telemetryQueue.removeFirst(); + } + } + m_telemetryInFlight = QJsonArray(); + m_telemetryReply = nullptr; + } + if (reply) { if (!reply->error()) diff --git a/sdrbase/util/sondehub.h b/sdrbase/util/sondehub.h index f15304c2b..de77d853a 100644 --- a/sdrbase/util/sondehub.h +++ b/sdrbase/util/sondehub.h @@ -81,8 +81,11 @@ private: QNetworkAccessManager *m_networkManager; QJsonArray m_telemetryQueue; + QJsonArray m_telemetryInFlight; + QNetworkReply *m_telemetryReply = nullptr; QTimer m_uploadTimer; static const int m_uploadPeriodMs = 15000; // SondeHub asks for uploads no more often than every 15s + static const int m_maxQueueSize = 1000; }; From d365101ccd3a277fdfa3740e7befd660f8809a01 Mon Sep 17 00:00:00 2001 From: Jon Beniston Date: Tue, 13 Oct 2026 11:28:13 +0100 Subject: [PATCH 3/4] Add SELCAL demodulator. --- CMakeLists.txt | 1 + doc/img/SELCALDemod_audio_spectrum.png | Bin 0 -> 15530 bytes doc/img/SELCALDemod_audio_tones.png | Bin 0 -> 16762 bytes doc/img/SELCALDemod_calls.png | Bin 0 -> 32853 bytes doc/img/SELCALDemod_plugin.png | Bin 0 -> 24536 bytes plugins/channelrx/CMakeLists.txt | 6 + plugins/channelrx/demodselcal/CMakeLists.txt | 77 ++ plugins/channelrx/demodselcal/readme.md | 260 ++++ .../demodselcal/selcalcarriertracker.cpp | 153 +++ .../demodselcal/selcalcarriertracker.h | 85 ++ .../channelrx/demodselcal/selcaldecoder.cpp | 919 +++++++++++++++ plugins/channelrx/demodselcal/selcaldecoder.h | 268 +++++ plugins/channelrx/demodselcal/selcaldemod.cpp | 727 ++++++++++++ plugins/channelrx/demodselcal/selcaldemod.h | 181 +++ .../demodselcal/selcaldemodbaseband.cpp | 212 ++++ .../demodselcal/selcaldemodbaseband.h | 110 ++ .../channelrx/demodselcal/selcaldemodgui.cpp | 1043 +++++++++++++++++ .../channelrx/demodselcal/selcaldemodgui.h | 169 +++ .../channelrx/demodselcal/selcaldemodgui.ui | 999 ++++++++++++++++ .../demodselcal/selcaldemodplugin.cpp | 91 ++ .../channelrx/demodselcal/selcaldemodplugin.h | 50 + .../demodselcal/selcaldemodsettings.cpp | 397 +++++++ .../demodselcal/selcaldemodsettings.h | 99 ++ .../channelrx/demodselcal/selcaldemodsink.cpp | 536 +++++++++ .../channelrx/demodselcal/selcaldemodsink.h | 128 ++ .../demodselcal/selcaldemodwebapiadapter.cpp | 52 + .../demodselcal/selcaldemodwebapiadapter.h | 50 + .../channelrx/demodselcal/selcalmessages.cpp | 22 + .../channelrx/demodselcal/selcalmessages.h | 97 ++ .../demodanalyzer/demodanalyzersettings.cpp | 1 + plugins/feature/demodanalyzer/readme.md | 1 + plugins/feature/denoiser/denoisersettings.cpp | 1 + plugins/feature/denoiser/readme.md | 1 + sdrbase/CMakeLists.txt | 2 + sdrbase/resources/webapi.qrc | 1 + .../doc/swagger/include/ChannelReport.yaml | 2 + .../doc/swagger/include/ChannelSettings.yaml | 2 + .../doc/swagger/include/SELCALDemod.yaml | 139 +++ sdrbase/util/selcaldb.cpp | 203 ++++ sdrbase/util/selcaldb.h | 80 ++ sdrbase/webapi/webapirequestmapper.cpp | 6 + sdrbase/webapi/webapiutils.cpp | 2 + .../api/swagger/include/ChannelReport.yaml | 2 + .../api/swagger/include/ChannelSettings.yaml | 2 + .../api/swagger/include/SELCALDemod.yaml | 140 +++ .../code/qt5/client/SWGChannelReport.cpp | 27 + .../code/qt5/client/SWGChannelReport.h | 5 + .../code/qt5/client/SWGChannelSettings.cpp | 27 + .../code/qt5/client/SWGChannelSettings.h | 5 + .../code/qt5/client/SWGModelFactory.h | 12 + .../code/qt5/client/SWGSELCALDemodReport.cpp | 109 ++ .../code/qt5/client/SWGSELCALDemodReport.h | 82 ++ .../qt5/client/SWGSELCALDemodSettings.cpp | 174 +++ .../code/qt5/client/SWGSELCALDemodSettings.h | 132 +++ 54 files changed, 7890 insertions(+) create mode 100644 doc/img/SELCALDemod_audio_spectrum.png create mode 100644 doc/img/SELCALDemod_audio_tones.png create mode 100644 doc/img/SELCALDemod_calls.png create mode 100644 doc/img/SELCALDemod_plugin.png create mode 100644 plugins/channelrx/demodselcal/CMakeLists.txt create mode 100644 plugins/channelrx/demodselcal/readme.md create mode 100644 plugins/channelrx/demodselcal/selcalcarriertracker.cpp create mode 100644 plugins/channelrx/demodselcal/selcalcarriertracker.h create mode 100644 plugins/channelrx/demodselcal/selcaldecoder.cpp create mode 100644 plugins/channelrx/demodselcal/selcaldecoder.h create mode 100644 plugins/channelrx/demodselcal/selcaldemod.cpp create mode 100644 plugins/channelrx/demodselcal/selcaldemod.h create mode 100644 plugins/channelrx/demodselcal/selcaldemodbaseband.cpp create mode 100644 plugins/channelrx/demodselcal/selcaldemodbaseband.h create mode 100644 plugins/channelrx/demodselcal/selcaldemodgui.cpp create mode 100644 plugins/channelrx/demodselcal/selcaldemodgui.h create mode 100644 plugins/channelrx/demodselcal/selcaldemodgui.ui create mode 100644 plugins/channelrx/demodselcal/selcaldemodplugin.cpp create mode 100644 plugins/channelrx/demodselcal/selcaldemodplugin.h create mode 100644 plugins/channelrx/demodselcal/selcaldemodsettings.cpp create mode 100644 plugins/channelrx/demodselcal/selcaldemodsettings.h create mode 100644 plugins/channelrx/demodselcal/selcaldemodsink.cpp create mode 100644 plugins/channelrx/demodselcal/selcaldemodsink.h create mode 100644 plugins/channelrx/demodselcal/selcaldemodwebapiadapter.cpp create mode 100644 plugins/channelrx/demodselcal/selcaldemodwebapiadapter.h create mode 100644 plugins/channelrx/demodselcal/selcalmessages.cpp create mode 100644 plugins/channelrx/demodselcal/selcalmessages.h create mode 100644 sdrbase/resources/webapi/doc/swagger/include/SELCALDemod.yaml create mode 100644 sdrbase/util/selcaldb.cpp create mode 100644 sdrbase/util/selcaldb.h create mode 100644 swagger/sdrangel/api/swagger/include/SELCALDemod.yaml create mode 100644 swagger/sdrangel/code/qt5/client/SWGSELCALDemodReport.cpp create mode 100644 swagger/sdrangel/code/qt5/client/SWGSELCALDemodReport.h create mode 100644 swagger/sdrangel/code/qt5/client/SWGSELCALDemodSettings.cpp create mode 100644 swagger/sdrangel/code/qt5/client/SWGSELCALDemodSettings.h diff --git a/CMakeLists.txt b/CMakeLists.txt index 5e0f9acc1..0e9d2460d 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -174,6 +174,7 @@ option(ENABLE_CHANNELRX_DEMODNAVTEX "Enable channelrx demodnavtex plugin" ON) option(ENABLE_CHANNELRX_DEMODRTTY "Enable channelrx demodrtty plugin" ON) option(ENABLE_CHANNELRX_DEMODPSK31 "Enable channelrx demodpsk31 plugin" ON) option(ENABLE_CHANNELRX_DEMODILS "Enable channelrx demodils plugin" ON) +option(ENABLE_CHANNELRX_DEMODSELCAL "Enable channelrx demodselcal plugin" ON) option(ENABLE_CHANNELRX_DEMODDSC "Enable channelrx demoddsc plugin" ON) option(ENABLE_CHANNELRX_HEATMAP "Enable channelrx heatmap plugin" ON) option(ENABLE_CHANNELRX_FREQSCANNER "Enable channelrx freqscanner plugin" ON) diff --git a/doc/img/SELCALDemod_audio_spectrum.png b/doc/img/SELCALDemod_audio_spectrum.png new file mode 100644 index 0000000000000000000000000000000000000000..e497554747c2f4964e5dbda9981be42466e2eb18 GIT binary patch literal 15530 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 MTtTc|G5`Po literal 0 HcmV?d00001 diff --git a/doc/img/SELCALDemod_audio_tones.png b/doc/img/SELCALDemod_audio_tones.png new file mode 100644 index 0000000000000000000000000000000000000000..1b57519bbdea2d6dae5df558761ed79e4aeeeb75 GIT binary patch literal 16762 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 Hdi{R@-{ZLS literal 0 HcmV?d00001 diff --git a/doc/img/SELCALDemod_calls.png b/doc/img/SELCALDemod_calls.png new file mode 100644 index 0000000000000000000000000000000000000000..141ad74f825ccd594b3344b78d811c6231f92561 GIT binary patch literal 32853 zcmb@t1yoz@x-QxlC?4EOa4l|yP^>rZAU z22DC0xZq+kcX6ySDJj`4DY^&zhRN6oc`EezCklgQ*X0R|uAZ`d*a3ygsXH z^t9ON7@unU0ypGq3_ClzVt;v3vjMiq#^OAyZO2MN)QGQE#G_%26Lx9dZ`nvD$IG$T4D|Hr(}m9;3scF=Ew&5(`UesvKL$YL*{)^- zQ>AA^AB=H?#6d4pF>DLAT1O?En6i@X=B~g{RV(^E8^Zt3b0i~r%s><@QiNUD)BI02 z%hSdjgEK->mm??1wh8KddnMd&RmV92Oh!gSgmgfEP2gfd2*~W)g_V8x?wv+8^|!o? zG16v#ozB*8kGJn)y zNQM5oP&XEu1ogeS4ikHOU%jAerh4dov@8IQo^o_J|C(({9$ZzbM$IhpV>RWTcvh!@ zB_~2QM^L0(c3eIM97t0_OP*7td6Vz-pRrM;-g%J>kAX&RAR)2@3f*ITTENgZOR$1S@nw=1pU!~#Yrv=8xZHB$_kc;~(GE+2?q{PS= z0%DMp{NM4upsn}&8-R<5xOjrU|3Jg_FUV?WyoRIurH6R`2KRzZ;J`f(v;^cT>~FY} z3|%|36$_3@zc+tK4E|9Z)VS`^ZP#e3z{1 zy6$!o02>41*A z7h3a81nv@@3Gep^gaw$UmUc06@?%8X|21!cTPQvtZ>j#fB+>bd=Z$t?wx1Tu+@3o2 z<%Ce#@q4D+`rTF0z;m39OYFn6jRjfush(R z#z|CWS4W=Fo!jTvW-6{#`qop=ts3$-JSbDz{B-P(v#TGDy=vAAewqk_2yJqXr_*jB zbm#-UX{yJ>|3)L1KNDavkY-f+7NFe7GLeDkNHTg+XC|PpdnwxZerjt|^1n}`g*>S( zcdyAT#RpZwknB_=TH1KQ_ZQ>H^6uhm+r-mv_=!Lrt9aOnt}c{%z{Xn5^F;42g7Mb5 zO6Y0C)~)kQukk{&%;2HZ_9!|!?NZ-V%dR)c9yOxH|Mq?5l<@?Yi_IpMCM(B$fSW)Z z6fiA3zL>IM#VjR3sf0MS;~Z=xn&@Qc;Xd2?&!lipX@UG6`3?2o!z?HW+@$HemDB}0 zogmK+&QH>QhiGkD;QkxG1%eGFek89(LwWg?p^OaETl-6n2h6WdzG%;`wlYVx7kxsw zp>23ZpI~YKs(;o|vG_Qhhx1(D-`PE9$ZuX^O?W}FZ5MMXx~O`UY%#_M-mcUReDm+Q zaLkVQ%_8`KI=5?OQhMwF$2|+iWzo$oCtv5}Y z#O|(>wo+z6EZUPh-g#EtEdezYK}bzl{`)yn9)c+HzS8=ddTGy=s9&L1YVBI=zw|IS z^yf_Jo!r(BrY7@4EbKEbm#1Mr=?=}iD0~SD>mmGXsNY~7JO6J%p?#149{O=$gG-N!v!0tj>rF{Aw_gPyuVkV2BEg{RYx>o%>)#fSXM%rtK4t93} z|Gw`jVT&j4M+Jm-?EJ3}qVt11`7r+ua}#pn5c&<=v!dzVxWg~nWAC8r0*%eX&JwFW zHR{WI>5MfO_q_@gFc?h&b^U$oC~wtF3oQFyAnRYWHS!R_38Z-Blb^~J^Ah?ms={ObzD*^+_!seVbN_32Y%&Qc@!zD%t@eLDT!RlN_HCWp z#t%mHHz&IR`mmZx)Qx@)Y!s}r>72BwN$e3MarIdM{3h4X? zzjZsQ_$@s6Y$F$RdUSO(q&-n%>zufPD`ijC1s!kvO5&s?JLOot*s9I_Nk_^SHO%sa zW3Si}nWT{($USJqWVs!Ayw3GzD{&AaMf2k2%h;O)xBV{8_I%6iyCAX`r#orO%TI&0 z#tlXZBuSIzIwI*b)Fgw}jcr0_gCB)+m&8%sSKnGBYV}#) z7N7%|$8^Wv?4f6L={P`yfs}_bU|*K%0eb7QBXza zdz)e5x6LP1!DH20T6K^_Q{9m@QXM@X*}2}A)!uC8uE{IV5n7HJ$D>C!ITMf5epqH; zMeM-zvaIKyX1eaM&}^kxPC=pX{#c?_BD`bHw&+Az1n1_{UHsYpm^I&i>kZ7!8Fqp8 z3nFo=E~a7*a*sT%_!y6O;*_1hMiLXX08c5V{fXfAaeaoh^hL1S*N(h7Z_Rm@aKZWJ zJ8!{dM^^V-=d>TcI*u;(8DKunIQP}Nm2Hvv;4vSgOEt0+Tq#*$Z}0g2(3pKP>7EsK z+kd|rZubmaZ$Kx+MCSdPw9&*OU7_7acw=BsOzj#1PB_R2Kihfl z`5W4>HeunJJ!{{1TQ#7$RMPmz+Mfv*XY5YTyKUV1wDwptnw6tD=3JH&WI+pfN23eU zsPW|erWUTON4fG%;Lc`#hV&frs}ebJxZU}ifd|hzk2s{o9d%XcgrIXX)>AbM2N3WR zHD#fxnB@C*Q$jf`y_Y5?R-~q459Y&qhlTVfhr9)W6eFC;te%ImHTOF*zi}Yax%+c8tYq6`xo9OjsY9kfB;BA)J$f6m#coThm1e zw8i<=jlBZbkrPL9becude6mc&VbkTGtZ`nnHu~2tU0vLs-o5_vhgtzfXv+wwiq2V2 zTFYx|q=|WG;unva{Nf?tmIZ@nS8U|o}az{8-9xY08;TEOHQ0dB4-SN zXa{kNv1iYM1y573wCRz%t;Dl!p}9ZDG+6o+FE3BtggfTfg4(T3ENr~?hQ`HG{bLcU z>M|hATZ@#{Z%&x1E`|PyU03$ht-KDo=-IDqN$qnk9oUixEnAL=`U7<~3vTf;=HTF7 zK^OFAVXfPqo~-%3d05r@=04XQJVaqCA>j;eO)_8l_cG?H3I^PxB@a`#;9&FBvQWQF zRNC3rFWSQvKM5xoWG>5zpThgJ=%5egv|JA&Brs{d&jTd3zKVrEy7MvEJ>T-8&Lf)W zFc0JLMIxlnvennjPrI+>ZT-aX=1&(H;?UL6Kr1IUvT_r~&+L=FD+fhHqQcNxK1 z`_~nrJxk5pP6fj6PD?=bS(hyjRnkE_o@B_Bi2=>9Hq7e|oY&EhUZpb%vv%1@ORoX?Kv(BI@>)$7jwZ(K_Yr~Ir;<^X za0Rj8N+yRBNE%hYN)AQ7^X*vK)vnSZ<*KM-@~EiQ$nRHTbQQ2Ji}4UI2>8etcKJ-V zqgSOwq*?KK>ea$tnSJ*hxHl0)c4C!u&zZ59yN;?7WqJ8^;;f@?LdrKV0z8tm<6^p; zw8j$EAu-~T*7hY@R+)}JO1aerq!TOxuH&7YwTp?$Ataa03A0$PkN<-KH}vM#j#t6j z3@+oaLKhBut4XWOR~_6%0=Uv5eNfAgFNe9fO$PQdRWgy3#&Hfjx<(9s3hx~a>6A>W zGR~JcGMK-}>)cT-TeoK1@>On36h}(B36y*Em-ScD&2nfIott#q( z8az#%IB%o7Uz&J+)t;pGeNm%9r`IW#!#nlO5dMzkN28U6&iI?HN`8KhQZ-TFAtqDZ zZl8)pZK3~D;^_}RKT$Q(t})`A2V{%g)HJG&XdxgWjpWp$TvFm+p{qRCN?y~R8?X2}FH@zn z?cFinbWBaWg&7t!g=uD>WZgC)C{sdWqhfc6Pk&R6q!Tqj|F?{p*n)QS&r|*0Xp`8&$vDX&V>!CPpmzAxJ{uXdqo>ueJn8esR`&4uHp` zBxbP6IsK|I$Ww|8(NTQi=QbgTxS{^mQfTw*(`G575pmdGnbu@0(|K0UyZ&-u)DWo7 ziBEFufS!L!8zmQwV|P4}(Jo&;CyAO9Y?6zF{1*Aco1BBcrlJYa-L%fK0(u-G;V#Z+ zIq|pjUW#%rf&RhBv9=(~SB|F&S-rn1&jA@`6!A{Wj4JL`<7J{wEDtZEbJid zjKeKNJYu+{hrX6_yeKSD2{YK5x38z$vN9XFVH=XhNqq^ODi6s~1~Zm$HuPCGG8w!% z4FPgNn|H(nw@c=kOf5Cygb-6na5>RI3#G2RkDPZf({GmJT zZO^;f#HZAUxZ}42MmbVpb51Lnsx9KbI8N*LfzM^MSNH7bvo_KkUlxs@6J3T+=wo`| zFd^d$9k^-~0G1c$(Huigw3`16)xAGJ&#cNtOAGkwdkWEBN>J)=hO{h1S%K1x2ts>AyjNo;hnJeuTvGvtuM)U4eKU$Ag6Z>*C;; zt2NSdP__a;Mftun$u7zaa&acTqw?53=F0fJU-~3V^p<3;@$c|R|Eh5w98_lUX=ul- zbDO-ch`B@QG)IY$ipjdpIgpytZM}#c=(ELvj_Yx)bm@8j^&LgoXyQ&hqw%`1991gL z>tDn{{H(>A0{k5sPt2!VES;j|L{yFx$vJn}M=hNN1qPDDcdfc##Qil>BY*-UrpL*I26zB`Z1IdAKZ>S-3?k8Sad9R7Z} z%~s{?t-@h_=V$g%d~9#CQpO5$H&cFIDMQeHm}(YZafGpE5|)k%RNLXiw16E($rSQZ zeJ2Ju?6VS##`ndp292IN-{enyH0QJkR<~(AWgyAz1@<-KMkMhRKR`rBRu1jZOHCtU z@`mua8K@5TryfwEYsi4X4K~4*Qej-m18D;&|qqoCXglGrejjAFdK`Ia_@f+s4OJpc879K-Rx@-L!4&$c3IBpvJTpNJm z5~I@oSW!V+-MwxW{9sln9q?wQG`1tA&ZEIN_l*Uo#h9JQ(2A17m|J)|T}s$VR+5NbmVF;y#0nCum-gx>-k77I(tj$}oUrt}1k|#{su%Te+Fsb7Z3o5Z|`f zT+G?Gvj&Ek3c8+>Zkl$l0onP~56{3eiz@uSTlY6Sx zbu|ZpE#8{(I2(r}-brfH8Fu~DjEkf5gEBMK{E^&7 zTjSwF$XXz}d+RVM$>KncBrJM$s3iPO@Sm;RlY1KHQx3sDMX}Z|E((U|LIVq%<_E&R zmdo8^D63K~x7z&BI$Z^>$g*?adfc$nnA!XikFBd$18>HrnU3@MUc`3A9QqZNnLCLe zWncR=ND~&HxaviEV$ZEF2U+(mJzTZ4w9 zs{|OX|I{*S`qy`M3OST>a1(czuP@3Kr~~4a(0a+z`E;b)n4H)w^6t5kD!w#Fs3mi3 zbnbe_>n3uKJ3wU-EXjZ493W|RT z>0_WJOf*IxiP_46xNeUa{s`!G9W_Nkt~uXUx#i0Dyjvct7NqMweYkNl+u zi}Tv3eu#yYirEi(nyOAw2+UT-y4`(8AK=&a^iZUoXORrHO85E0*;=hIhawt z^N{!Jd~T#0(|bROS0OnvNo&p!?ic>x57cCacslS!KJVBnLe051XL=qVjd?UFU)Bln z0+(GWFeXx4z@JALh2xh+HiF4V^}H)D1$BDcMKeh1vLr+30TnkSwkE;OJFUK|CXT=F zfvu^J2j~Gp^OHUrbzR}s!*%zHqAy-ge-z5b>o4S+`36oSyI^VrJVoo$mP1++z#qM; zFykL#(Z<&>Z@H=Igb0_ha~P7ZD+_WzD6DUJMQxE5(>4T8MXxusIs9)M2$>OR(Ss9Ig;C3A;20=E^u`F(IC%Xni#jLgZ7G><1>X**r`B)G@rrL0y$vz5dn&bAr>oOvDRJ4lC&y&?4ptN*qTi2<9Ac(JU1t2aXfj(s|I>VtMfr zt7P&2%>XZHv;(BRfC(?vEhYfuSpQPFsGa}({!M>@d|?k!icNB@MSgIX-ak9G`d)Z? ztMhupVk5bAzpT(nF5X=h6DddcGGj4^Fk}?WMNr^u{NimF;?#RQ( zM=Lm(;b&j-0@iyET|cDKv#S)j-$SKR426!EH$VPp_^5y`Mx&r!Z2g^a8a~u`B{KOY zn~&^$OtEx>@*EfPusf^E@!CimdY07F(sKqfys%f22!Ko5$P^r_L>A9?Burwlwe5p3 z#!i4LaNF%Jjyl?+y>rH-tt|9!*jAm}4wIYD?M${x?JVtw2iLbdpGO-+vx7hSNWF~e zYuxDRz%;WKs$XyH6@PAJ$yfda@8VNQyJvmsFx(%yk6&IUmrsuuFBw!qF=Iv}Gd5YZ zRJcU3v-Wru3J49GuWiOMUbJZ|g2036e)>K7NfxAIl~D7xc4@d)#rfiBZ|V9t8t{HM zf=FQgE1-;HHgP_ay{98hc)#uU+JQLO0v&y97gt@h(^Kx+jGn(#$x@+&kiI9T=W*>7 zn4#J_IS}A*J}3>(dn3&z?PAc=U$BvP-jUMtoJTEdpc_Y=pSZ#3z?2-P{`mz zJJ*9AqodHdKPSh?I|V@-B3_m9&&wz&F}8DQ=0&_vTy$^eIN|O!QnW! znPoEX&@Mbrcq^i4Q^fxg|U*`U(tS;1~^=#4*B5~f&Eq2$bDE10mk-BGp}ip z2a^Mdf8`T(E6whLKAIJK=l-z>Jl$2LTi4c=^JAC-AS#;hR}q%PTBWw9xc#hk|9d#j zS>G0ScW(Ne?K;u%=;CzR7wQMISza4LdNoInS335dwxwLO?<{fwr#qB@fK6KUg0NTmUf?>CBBL-0A|7_i zKRLt+Jpz|hrLCVyyY$2mJx1W$8a2PaUBQ;udPr~;Jh`<#T*<7k+1ZnQal`2Q z8QT@0Ys=(${oZUc;O>y)LP7Q9G3@5mF5Errbl{H7YqLba#t`~*%k^bU>_-!r$m2^&6y+&Vcy`h4FTop1_sBx1KYB{lqZDrxiX;Ev(9 z0I{5|4m#;VEVICSB{n{Ww$|=&Uz7!=W%I`FcX5=iyU`L(a}V8lRUH<+27BQL3fX36 z7qv`oZwD@~3~Bk;0i;mrT4(G^`)kreTDiXl5z#^0u?)f%2~O(pm}G|knhz0{ooyWe zhPF-^GV64Kis`B20v7VR^MvT(9ELvhnQ~0DiU0xMo<*6{nreI3Ql-Ov%BZ@f8<5c1 z$Loq1zJhyK_kz|B=np5N(#1mC<1Oar(xUZjGknVQ4)zG_5cYfFYy@lV8Pa>Us4Tt= zNW(1w+xJ;C342S6{RZoPJ5KtMo3;f(FkX@Q2D*>)M|W^rySa7F*Q!^$?=-_O8)Pza za*jhWMF(wtuIL{p3ToOZ$~9O(SDPadE^Jy4bW+1KQWD9fJaxpjYrQXv8#3s114U4D zaWvdkVi)Pf#i^9`iHa}TUsl0-d4BqhzB$^T+$wUKEIr%zoe)PbuzYCoS>Cd|S`3+s zR(B>SjM|j!FH)g9Itr-s^JhO~8q^-#{+uTZrrqU`zr|z^;mc9RJ=KxH-wU3^){r(P z*FZLffl_^H(UZ@gU>+BEJ^P;CG<)|giM3|F4%t;>D(-_M{i)!kt|SGluOQ3H-hb>O zo7O$5a-gaf9;f{K$l{pmw6=<_q(&Pw>jm$$L>e8a+oXQgZ>^3wX?)g|F5Az(agT}Z zA%|3-2#Vq7i$5l2HFXN7C13JyMN?LCH5(mFkStl_CS7vwPs?buDvN08dBoSRKVx=I z(T;DE%5djQZoMqNl42i4Nj)E?9urHUIqA~sVgK0G3D z^YB2RFCyB{f82~Z>T#?yTlwYYgWM&UUuw-T!)X5z+rHm@;jLycdlnXoYIf7QVP=o* z4wbocOWPl_ZqjbkNvvl-pI~$f8OkyM2d_(bbm55X!O`^d*f5Hutb2#VUnXj-Gs2Ht zI8~wncpFbPU{xR0!178m_<}y2RfVzAqW=Bu%bwp6q)8NBBr-&0wrQomd4tHX)dA3F zUJr_YM4^8>xi`oPv+%i5j7=w34eI7x_lPz$K6ZNe=@ofhC6tu4zK!$qX9{z!&P$sD_Ol35RerE=`hD-8BQh#X;A5Pl3vb_k6 zJ7F>CSb6}imxLm%v)9vV#ZgT{^w>t~KS}zp@AVy+EkfkR;Ko zc!XK)Q;E=#HA0S;gQZM5?g zeJZvO+mC4gKLo4DibaI;ChOz7rm}vQ8?G}qyqWUSOcZUUHj8=m^dLfV(#zSkxEy+) zSL-EtCAHvy+8Xa^bi)VPKWnG4LM7&}(qnDSK7IB^BCCr17Su{_YpT*L2)jQh7Gbr0 zdH?Q|Z0T<=6hbRFJMH^E`wt^Aik~lLdvy+5lRw#|Hi+r2=h-}epYefNMZ#l+G+Z;gH$QOn*RME?v5iHNlRZ1$J#06YS2yG5Atk2qg!A*|ijn3wvRzs| z?B^+2SI9YV{#>U2kO7|xChsO?+s)QL1sBxr8+Q^UG;=I>MGps%4++r=4|zG9cZOJg z5bIJ1zKk>!k(5n{4GT0r9zar&5~=FcEl={(=e-z?oKStju`5kSB<94ap(Uui`K_Yc z@9S0qvmPzr@MLw`x9oZ$A?)de+Ol|F77_WRPY)2c2M>P?4I2k3ehUNKiO+JpC+;0j zpm$h_UFYLFq4DA_wM<4LLnt4jENSsgWDg}1`C3IAQ=FT5%HyYEmf^Oa4qZz=C8o%x z-I#pAz({7J^P0O-?5QIBSs6XN)2-pqG|=q6T?id_HkmA}0_j7%(`K+1ILsc;8$ZH5FW^thT0YL|!PaQA0J>ZCQz_F26c#ijxAJQyU3fHB6w8Pqz_Aug8|e zs~bgJ#DUkYox8MWVqUz0eL`goXEmzeT>HmA1}aP(Bsgnn%^%LRulG#lf}$sI3}B6> z$fTfpC>Kh>hP@rwoADuY$72JKC|yc5(razD8vhF)3O-=^;UoNmyr!T8+IVTto#~!H zsbBI%SWdnl2pYo5>?EQKim$abYr{yEYo@I^kCcYnNYoiUdZ!T0zq&fmb6mi3)y4|J zt++xz?~FbK$&fn16u*==+|2~a?+9wtNurH+_MXwuhxiZET9=X&+y4*~+32MOqrYeS znci)6V7im<@yw(2iqAQqp#bJm$lx-3gb| z`{;5U-;<#9s%QTIPeA*Qgi4;LQ~Kl+ZI9`1aIVG7IBsMJhsX~l1rNlg&~@J3__#i4 zK*Q1kI#c~8?Qf0QEcRq*0~zs_0Kt1V3vX{qCNd(Ta2t?_jSST}`I?g*9x?dpDrl{j z@H`EQI-6~Fdc1*;MSP*V!?SJ2^@SsXm&SFI{apq&Hm~m{#8hU405RFTM=_2$`l0Og zTw#Q19k0YlhzrB4x5Rsq{Jkc8x`Lo>{RVs?aW}aF`vcJOBv1nqezA~q9u#(^CEZ3O-Y@;*D8%cfFKb1fGF>l(u+SBjYq{Wo}G; zn3qHBr(BM2qeZa7^OC+w<@p(uXW>%mbY=nJ%S~TSyjfmS!CWc44j5lvS~~T=1e;r6 zQTk)eEtL-8oKvU84es^H6qMQHs4`dJB*D1ip#L}bCSrso(i0T}emHVAfBn3+Q~CKG z0G#!$wi78w+|`T224AglL|>53L(Y`uuJ?J`&kg03F9VoD_Nseed!4A-E;i&)7cQ{~ za?a3obts(4u9V25ow?XN4_Nx1&4bx#o;S9ie{K)KGH7RwEnRX%!%H|I-4n!}$maRz ztSP0-{XeH{lU8O4MqL=%Y2^!gU!TtpepJXEOeGqG1)M)r1fgm4-zrnS`e@Lzyzxsi zcvWBjtt6X#;2LMBs`BdEfchW)(|zz${|^~{FAAOOlH=%^@}~iWJp+ti9>;2_=1mql zyQLTa%h+h{mYlwkfnN>tZuM#=U;rJz>M0(DU(x}*47XUn7(d;;qjC8l$T(>GP+{A$ zL5frmxP1SspPwFln=}tQ>)jlJ4oy4XdlXQqHdZu^F%-O@L0Rm){4~{?Ar2gpN;Kw6 zV?RdUkIu#M#Rt1TL*!=+s8kxwaBz)Syh$*we&ZJE!OB`nr6nbfQn*U$OZS(FE>6#~ z39b<)Cw|-#kGOe_F?$Rg{wO3_pknr!QBzhG%?nJ=@(^YHWwJGyk_`1SK>K07J4Rjo zNV4qMta;-94t>v>#pN53%fPb+x~cpH<#9I!_+qZlTr zl^#w)W$-TcbN!n09Q;;)LGz7YYs-#L2BY+c-X`h(3XpK064B37Bv@j9oB3J(NFsa{ zm|mpFMrHIiCgqol<7Sn7o}x4VSN48*`R88}!K)(r`ETM_4)2(dw`I`=xAR=TGps~esewU13 zdiNF`4eJXA_m43>nRoA%%3PWT$*PpfW;XbuUsyN-4ajip_rK8Vg7ygw+C_9(jC|s9 zU$>{`s<$QU7KX_mF9|8nTtba3-k9F!EfZU^&MKOG6a8E%lUdy^3FjhIdb~4 zDLg?_zmG5}svcUC{ZP7)SAkxH(MP#z_Qy97RA!aoWl{|HENY zTAd11CoDqW-+E9Ry}-Y<8&@beA;8Nn;`kMug&*ehyn24jZ&7K!o7(wDy!zvwn^$2A zn!w3MW|inR7PkwtWb5sTrkx_^xjykSznwc(R&BS%J1)q~Ypv7P%$2iHMHj?5BDRSM zS&R-4oEnbv@VG!e@2xbsbfAmFZaYxKMuJ0AlSuH%ljnCI3vfqz;nVX2)}qbty!iTa z*wanZWigw06z+fu!x4EajV#vzwy2%mvptIII+R z9++~42CO*mi;FHVqEkK=A{JwN!>&?L#tpx-;Cu;rx%o-w=jY$;8=mhG)-6XLEJi7| zMcploa3V!!u_fHZUUF84-q~f5rKiedO?oR|AD$2YplSKFfdn5|^hm5`o?JA4h0zZ! zyEzfX`k*^GOa=+jx}97=#sSpgf;43~`KrT3)sOFY@?%U`c>MN~OTPD?I-V9-3Es8J zvWJ{&23dr=^8u4viXVOo*04~S#tYIF6%n^diMj38{pv^lQhp_K>>-x%H5*2YwQKqh zc3z5GJ^k`Ow6m~nD4%6h6}5O(1YoEp>`q@1_>PgH zd9o`u(D*70;IlbRJ`vn?$F(q6*6?!cEoS=9TIm)M6PHql9P+8+bNN75r-Rt=JUMaV zKo_Hx{-OMgtAwK$&3RBBK5=+l3kI)Z;}VK%pF zhbJc&TIv^q@XEiF=0yAxd?4`Bk_N^96oJ|<87hJIr!r#9O=L?&5W?%Dsa(IQ;7a35 zcb~NQo{E8d|I7EG4%?GZW)**0q(Q-RVpNv)s``>dL_hP>EY>7q0Ye0qN1M}g+cF)z zu9|+DfvCGobe!x^_n&y7;6J@1=lt_^lBDyhY5&i+i5t@V&hT>oJQ;rxewW#_w@bS{ zy}34tY2vNGTw4f(Sli(p8_2*3=F)7U%(V!&f6m_BF8`~}59YPJHmJ6H1;k|x$;&^M z1S5I!Bo0*5fx+TF-&(~V{qjK+TN67Sl#w66h^O~|8L9M&&?C~~3221B@&D%jcA<+e z1E&W``56G^b&Be&&}8UU`Dj*j*MimYz@O(#p5CtZ>=6QdGM2ZgLGHEU6pjAPNE?-b01zW7b?fDpMpEe?b+ove+ zxV`RV6XltEPf2c5w3C7_&NOQqWXdZ(IxY-g{rC2{bT;0mripcsMR$EssM(k!u&|$} zvj{SRtxQxbjP7>$fonUze+TyVq7b@NT%J`_>U(UlIJpzmq2H_{&Gx=N;=;ncCF)7T z>-&_$q8)ho6mntb5FI*3TPZ$F1xZJP^5knpp|XQYXI=%-5R0I;I#&Gez=HE;>4S-1M(PvwxWp~7 zE{X}8Xr6i97EG$A-@(en;;3+KuVyY@5zDp9AQ$hrZDE(2?)i9hq|CzC#vd#swlznW z8)5__%C$|Z7w;s?wVi#x$3G)eNA>lq)B%Dn3tinjhiIN>KgJtfO!!hY4>I_q8Fcar z-&T%z{y*ChVHDcY5p?!ZEkIT|#Z2s&_`+l@M{28IS}g|zQ^`ci{D!!P0R zmJQq4NSUQLEkL8{zqS-qq3Kj9%xnL>=kWi1fNMT!l3hnc`2Wgn|LJO}{=`;n%Pmhyk^gAM`<*x`xB zYH*exUSd?FT!`-hPiDG5;}x{8>gon=k8@(-pp_g<0lC@^-z#Ap88gD~mZ2f|zZozj zO9$wPJUgYp2flq6?NatvFSV0M{=0Y78$#F1f#oiSYV(q>>h`)-^@XBniMy^{84M(>ZzsYb!%pX$Y zf(CCKv&#V1>>*5p-!LJ^9o~w#s5yi65e0&~SmeU*`b(aZ9Af|856ue)(O7%SbEE5c zhU=>#uEOh&(eR(wtCa8YonPFL{~94&$Wa3j;k$Pd;XfW@vbJt7bYVLL=4MW59__NG z<)aK#IjN~Dr)x$kkayPjiBXxH>Ksv zCAAm30-(sSFg}al0HOVgf1xa8ZuGOWw)>#Q)qkBe_4E&~{60-tByDM@_dbU{9^Prn zW|jm4Qu}0=&L)m~#k<&O@bh*)p~QF=wH>UdI^pH+G#78NRo63r>FoQyyf3wbw6EI| z164oJ0$l9_6vSFX1QXNqVpuOTVfQ+;&~qd8{v-F)CH4nNTLLjbHh#UfEw0P@Ho3}V z76S8Gj#T{!%?S!5-vpp1GzmhRbawpk;lr1!`UtB3&JK`5?@wo!VOB3W_IIdM(8ES5 z&ga5>n4S}?q|b;{`=L3JVP}nalZ9E?QAXVUv0m*`k9a7T@K9FCucQ6-BhLfP6QA@S zwz1R5Aw-SRW!-w~80b3Z66!UU_B}F!ul9PsENf|QBRtP$KabI=^z&zyi8*EVXwb<+ zUTh=NAloF9IC%g5nE@a0n{7Cg6mn&0Mh|a@!(RCn`HBs$hY0WX<;CrOE;~5e+U;H6 z4hO9*PW$)0(Dpk^-T)oJt^Mp*fkAu9ghNGJ^h*c`DIIl8$S-RMgWRjkht1f`K+@UE-c2Pc&EN7iv1%mmD)(^o4n(7DVuw| z1hrk~0I`;EP)>CO%XNqq8KYu7nSlKSM~~|=`b2ckNqdLAAi!3o;E$_>R)0V09i{KW z3@+5+&zE3K^u#IbI98y68qg!axbU)5*=E#P0*6^k^PjudTvoBm+59=aXI|_Z!$*5R za`x|oy^S6051NIOI0J2z4OOD4eORPe&dygChSn&$*P*Q~i;3u#{V#1V4vfWcQ#*_W z(P+;0Dc>7&tsDI9W6?L(479p%As46h*Fb`Q3jjDl-R14dke%q&UBf1+r&`myul3`r zOAUC5a8ER^N14eYUt`Oe6BnN0pVDeuJg_<`GM!^C;}-riU`uC~_McK?;FjL|U!d*k zoqq(c7HYnG?`$!+cWy#Fv3E0N$MS?;E7#3bh|sZpIFx!C((oHf#r&mcu~v1`hCJG+ zkE5?&%9WL;H|w3txUKdj1{SczH#R~&cJcb*4_6jso?LnVBc0Xa_q{^TbTfMG(n<@_ z%v0WI*~J1{2FaXY;x4>reH|N|KMyN<)qHUMRbeG2M(q8lat=&tiNR@;gYbqYg5{9FS2yZ4fuchjUZ0AB64I zCSpR%I-w&JK5)B0cKaj+4x9L$wl8%X)zx8s9%8rvJ1U@(`OuCKdU)q&n`FphSyV21 zoa>dOP^2<$Yx^cM)F|${w;zQoE7iI=*O{c+lQI=!&NCVqvAmw+-=({VyH_`Z`UtvGFmtz;ET(GPgy} zC|94ze&Y?6@}e}9Ey?<{*~tD-1-vyvEs>?aiyUnb(;@3%$7{6pGzJ6tFJ?bT&$G~7 z%3OYuyPWKxaJOA-TiwwBJ#`3XOMAd~$mjSX>*w&73CG|>H;e!90IGk8=!vQ8-qHI8 zPZ2a)?T;U8e4qUy>7{hOLHyV==Q=1Ne*Re$X)YuT4isC$>KvIg1hN)gax}51e_CBN z<5--DZK;W~6o2<02$^(-p^v0qMU|xw8SJZexQs*C7R$bpLjBY?)B{C5&ZVAQe@}tK zuB@Ju$JJ$|B|lM#_&Ohc=8NJen2sYEu$!(hz7PaPxG-{1bsk}LS){|??!j2Z;Y_Sg)Eb}D4kLm?#U4j zbu>xhH`88s%VGAIPP#8d8Cq6gKbU1ggvji}Xg+?NPkgIagjBH)Vw3H<9utZNHW`RK`BB z2|aQ<{uazzvmPw0mHs|4Ce-z4NpJfRDRI+McVQrNz_q^3D@9r++k1pP+5>Paruo#H zq3Ngv^e;aok=#-tjkKR;R;2&PSg7;lcVNNEnSviKL2jv+_3^&>Ln&DS0q3I(xy1}t zp9L?MV-V!G!vC?A0{tL+eytv<`qp^b0bWAyd|%-1OILmpSaU>-RxcpkzxrlN{KemwKAC6&@%^i2h-L@iAK; z2Kt-kmG?)y(3>V}T_kog<7Eg&&>DU4%|?2#E$3&bfg}(UhW$s6s@_)`P&bJQf*o`t zDq8p%q0~zee-N>iqC~hmr)}~%=i266KtpQNEgmxB&c0&(!^d^y6^ST=bHHmekz_Sh zdfGdj$N+;sE)?&jSj{5OrfHY6I%g6tUHVaHD%kYx8Eun;16RxDbML2vR?p9~RI=Rl z*ima{_gYS1x-H%_PsL~%RnBe|fJgJ~vRHPir} zT-6$-jgHxFZP`R#`oS2s*B`Otrh++r+FWUO!yOoLL53v=Cu?vUIqVbm2v)Cj3OQmAyYq;AmMmz;{I z)_JNz#05KWRAN%ZZ#>wM_4-amPE?=um~FH9*3JV^o?v`jEpsqg2`8-y$dXq7oDFhh z3qA`$4ng`PIg?~%mkGry4s0)IvMjl9}~B8kyZMOye8w z+(7E_+i1~H2PseeDms-l5e={0MXp1`LD*Q; z^^jg_phudKnN!=%4-on>**;WuOSO(SoqcHgE;DcNqbrqwx*rNeUP)zlaCW-ut>w>T zS7xS2v*|X~wmoFB5};{p8yjB04aeB-A1+%wKk>QHQ2CSDlPD4d-C;xs0xhu@LiB$! z6&uBNtU+~bi9ek>w;XJ|T-CgoR6!(rr(eq_BH|H}{!H_HvV-s9x1jSpodm)HVJ2A| zB^;j7+h5N%W(I?!xXxuRa@JNgITjTrGf^Rk;1^yd|ICO9h#B=N&+kP%W3=eo+;7z* zwNWezWIj#b1;Hd_#QB!g3F`4DQgqlSIm1H8H=(TQvfGV_t@_XrZ`2$3k?_6i3*nuJ zk|!J+EJ;(Pc_FO*t}GsD8c-NQz0P+)1Mks2^CTgjt=X*YLe1(WqF+YdMpH$1-Xz!q zQ%{_B5g(D~IARkG@|1l^ub&DX;fq6Bteq%yUXE_fCP4UN=8$vOLHpG=O8Cy1e(%Zz zm3DJw(!yZm$AdCGurHWeZvNg)*Pu3{X3C<}E_;Z=INurEdShdz z0x*~Q6Pjlo=7=$)6(0hgSU>7aAwH&U4d-IUJ{^!{e4LpGBEmF9z%5{L8{^Zer(h)* zPp2gv?wYGqVlJ?2xP%(bN*2m~+!)BJ@|0=-Cf<1Vg^ESG(2_%8p_}c;{ib1|7ogHjq#Bu0sB-PUG&wZae;p?C3D^^`NskXK@FP(MJMTz zzuAQY#n8J{1ubP@L}!dGer5ANn)~XoD7Urmt#l3DF?0xmh|(cll7fIrgLJoacefx2 zh@fE!?T`Q>t4UQk0G)Fa8RMDF^6LIp=ib zf%$hbm6Qc>2GFP;$)P23>FYHbvLBmKQ<;q7jswmh-yQaQIhGL@_;Cr{$(E&*$aGx~ z7pFIZt?D~8B8+J-XXpmlZ9*a0Xvvl=CPg?j`Qh1?RwAbBBIWXEg)(&o`c^BlUEq&bZ*bk?wH zy~VaeU9pfOXQ_Ts7r7IV4Yu=GX*dW2HfRjAV$Oh%xcN();wdej-4ge0kVc}eS9K`{ z3V7qD1GJB>QO7kkC)1kKw&ME2*1EUGdphH=F@yYiTkM-8^z~-7ZHY+Uo6v~$vh9eU zYfh@xJroCaY&4YSr+OWbkW5J#O~c#Uw3;Huy#sGkG-zqN%I^mvY@Dr?h2-ku2c+y1pJ=y}=n4PN@q!*wWR6Q|N9^MGZ9rzdiPlgs~xBSDObz zCqw<0Usf{%KZs0KM<#m?&TPVOg1wK>gbk~=3NtxMFZww4`Yn|7z8Z4vbw*KUx$V|% z-t{V((FvTa7V-_xbi?vaJ;bYj=EgI)mK65p;Ow=0jh7662}eCPxsNFvHfY1!U)pElc z7k5TM0sgjk?%su#(?4nJh|*QvzpVq>dWO%FG!>dGE>a9@Zvvk=s_#4#pij9byZU>u zsiarMD?O)HZNAJpQKm;r%HE7PG-NS!YVU2NM$D0Dp3a|;`BY+6EXD9Hs!6wVMzZpH zVwox6r=`a?+GShz+)eknIrVDL8nB4M?aHd5hSJq_ckJ}SaM%e7lP|M*X?@ckG(rzjlK7U zcveNdiQN5YTl$j*%C1x=3iIr~u<)!-pwQX6E1%)+N5H?GY{xu-n8ujlLo}aeieOnOzx8x_e~{ zh3BZV!V6IxtioNFTMfJO+k~}d7l!cJa;vqu3!QZLm7=vIFYu*(=c_f3kpbSSr@HA* zDz{W^YHxn&)yP(g4j;ZKKiHiVImfniTUD4;Qh%|s>99w(ntsPbvVGch%jWT*Ibniy zBFQ-);(>RE)Y%9v6S+tb{pA(r%qL4&8ST9HuKxTd`7Hs0>vP|7z>_YG(Gca@GTiB; zS2uNK{rzu~A~n2URJtEU$2S>{9hX_XV|$0=K!7|&4;8h+I?eB9+j;)uJ_oGN8|IHZ zM8XnBKmh>B2s6gTv78iD-)5vh%}!LFx5UHzRn`6_*H+K-wzoa$sjd?vqtQa}P|K9> z)~t)3crS9}Ue_$#;0)AwI3ZQ|v<7rQ#NM^S18Ti3E(HVkWp;Lr-c7Kc@=-|RhK*#? z_V?-rC>S$%tS*ix>%wlnaXrLfX4eUYsk4^ZeIy4U=gHkuixPtaa+}wcg%Qb#36_h8 zlLRFl6-ofVm>!yP|58{mos;0i4P&n>%?3K2JORxmo`hB<>q0Cz67|~qI2Kc@3`g8g zJm_!F`zd;YrAAXHml_Lfx)MEu7AwO~v-;dv)<%o4(c=K-EJ%=uH4X>0C z8%#8MJf%>F&Vmv0fSs4&o41MK44we@T4cx+5C_fZUJ>%7_3=f#?Q z*B#HsM=GI*4CH0Gjd(WAheX_oRuFRIH0Am%%mX4q1BoMg%=!(lHw#`O)}%?HZFFFX zi2$wIJ{~H%ZpF3)EjJk|TWqS-#BiD%FvS1S=fwelaX5I(Q+io7SqeQooKjYW1WHW@ zsb-v)XgA?SpB%(;O$TqDA;U7flJyqHy&*n*aWO)b92x9SLI#Y<_u9^OU>C;=;wKa6 zjR(#Q^DhkXCz^!G<0mk?RxXWs-5~OC!xEH{lYWaB$H&;|o|3xHV(nQKw_Zj(8f--N zhW7=^oLcatdweh>f%ZXAz@CL3I${hI^L-y6)tj3=MpXfYOH!U{p&`Woh&lQy#;c~T zvDDigrrcwRb^P2o0UJHNcye0^bNcXcEgZq+>2 z+n8OMQah!cXy(Uom;i}hc|U|?zHRXlnLA|W*LKE;8>~fqHP}ezeeS?Rf3foH{G`N$ z_T53|Fc%-`Ba?^iA+f@ZS0j1n+As3t87LlKom~Z2ZIN{6$Voi=hwv{k#8-R4^O#b{ z+wAr^Ql0Demu}_8eXT<6Iy{bI?Z`>3@+(+4^ONd?mOkBbFQFt3ZxE|SqYqQY6OgwG zZjx{_CekIX;6cBGtLf;y{)`q>uNELLpy7B^a-f*(am9)KDT_?VBE)Q2|AR&DDW3=7ca8?TJ4IT*V zup7tJ(zIq+CAaz?lBi|$9V5>+1@PtzT*)moE)nFxuL3&{7!8izsH7YX-&uZG3+C#^ zk{)b7);|h}P2u`-V|jogT#^r4A6i(J-bgy#^C}}SkgLmJyOPuOo;PxJQu0z!+~HK| z7Y4zKFMJW&vHlxD3laJV?2tDq2%L6f4+I?-6jIXNnBGP

R==g$430ajwS3rd$pS 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 literal 0 HcmV?d00001 diff --git a/doc/img/SELCALDemod_plugin.png b/doc/img/SELCALDemod_plugin.png new file mode 100644 index 0000000000000000000000000000000000000000..d4c8000e1878a6572f5207ff74a8edb53cdcc19e GIT binary patch literal 24536 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 KLb;q-;C}(KEMyh{ literal 0 HcmV?d00001 diff --git a/plugins/channelrx/CMakeLists.txt b/plugins/channelrx/CMakeLists.txt index b703fa322..0529f9726 100644 --- a/plugins/channelrx/CMakeLists.txt +++ b/plugins/channelrx/CMakeLists.txt @@ -294,3 +294,9 @@ if(NOT SERVER_MODE) message(STATUS "Not building demodatv (ENABLE_CHANNELRX_DEMODATV=${ENABLE_CHANNELRX_DEMODATV})") endif() endif() + +if(ENABLE_CHANNELRX_DEMODSELCAL) + add_subdirectory(demodselcal) +else() + message(STATUS "Not building demodselcal (ENABLE_CHANNELRX_DEMODSELCAL=${ENABLE_CHANNELRX_DEMODSELCAL})") +endif() diff --git a/plugins/channelrx/demodselcal/CMakeLists.txt b/plugins/channelrx/demodselcal/CMakeLists.txt new file mode 100644 index 000000000..bba08e916 --- /dev/null +++ b/plugins/channelrx/demodselcal/CMakeLists.txt @@ -0,0 +1,77 @@ +project(demodselcal) + +set(demodselcal_SOURCES + selcaldemod.cpp + selcaldemodsettings.cpp + selcaldemodbaseband.cpp + selcaldemodsink.cpp + selcalcarriertracker.cpp + selcaldecoder.cpp + selcalmessages.cpp + selcaldemodplugin.cpp + selcaldemodwebapiadapter.cpp +) + +set(demodselcal_HEADERS + selcaldemod.h + selcaldemodsettings.h + selcaldemodbaseband.h + selcaldemodsink.h + selcalcarriertracker.h + selcaldecoder.h + selcalmessages.h + selcaldemodplugin.h + selcaldemodwebapiadapter.h +) + +include_directories( + ${CMAKE_SOURCE_DIR}/swagger/sdrangel/code/qt5/client +) + +if(NOT SERVER_MODE) + set(demodselcal_SOURCES + ${demodselcal_SOURCES} + selcaldemodgui.cpp + selcaldemodgui.ui + ) + set(demodselcal_HEADERS + ${demodselcal_HEADERS} + selcaldemodgui.h + ) + + set(TARGET_NAME ${PLUGINS_PREFIX}demodselcal) + set(TARGET_LIB "Qt::Widgets") + set(TARGET_LIB_GUI "sdrgui") + set(INSTALL_FOLDER ${INSTALL_PLUGINS_DIR}) +else() + set(TARGET_NAME ${PLUGINSSRV_PREFIX}demodselcalsrv) + set(TARGET_LIB "") + set(TARGET_LIB_GUI "") + set(INSTALL_FOLDER ${INSTALL_PLUGINSSRV_DIR}) +endif() + +if(NOT Qt6_FOUND) + add_library(${TARGET_NAME} ${demodselcal_SOURCES}) +else() + qt_add_plugin(${TARGET_NAME} CLASS_NAME SELCALDemodPlugin) + target_sources(${TARGET_NAME} PRIVATE ${demodselcal_SOURCES}) +endif() + +if(NOT BUILD_SHARED_LIBS) + set_property(GLOBAL APPEND PROPERTY STATIC_PLUGINS_PROPERTY ${TARGET_NAME}) +endif() + +target_link_libraries(${TARGET_NAME} PRIVATE + Qt::Core + ${TARGET_LIB} + sdrbase + ${TARGET_LIB_GUI} +) + +install(TARGETS ${TARGET_NAME} DESTINATION ${INSTALL_FOLDER}) + +# Install debug symbols +if (WIN32) + install(FILES $/${TARGET_NAME}stripped.pdb CONFIGURATIONS Release DESTINATION ${INSTALL_FOLDER} RENAME ${TARGET_NAME}.pdb ) + install(FILES $ CONFIGURATIONS Debug RelWithDebInfo DESTINATION ${INSTALL_FOLDER} ) +endif() diff --git a/plugins/channelrx/demodselcal/readme.md b/plugins/channelrx/demodselcal/readme.md new file mode 100644 index 000000000..67ca43bf6 --- /dev/null +++ b/plugins/channelrx/demodselcal/readme.md @@ -0,0 +1,260 @@ +

SELCAL Demodulator Plugin

+ +

Introduction

+ +This plugin decodes aviation SELCAL (selective calling) transmissions from HF USB +and VHF AM signals. It supports the original 12/16-tone system and all 32 tones +listed in the [ASRI SELCAL Users Guide, revision E](https://asri.aero/wp-content/uploads/2021/11/20240910-ASRI-SELCAL-Users-Guide.pdf). + +A call consists of two simultaneous tone pairs, displayed as `AC-BD`. The four +tones must be distinct. The order of the pairs is retained; symbols within each +pair are displayed in tone designation order. Aircraft that have been assigned +a code can be displayed using a downloadable database. SELCAL codes do not +uniquely identify aircraft, so several aircraft may be listed for a code. + +

Interface

+ +The top and bottom bars of the channel window are described [here](../../../sdrgui/channel/readme.md). + +![SELCAL Demodulator plugin GUI](../../../doc/img/SELCALDemod_plugin.png) + +

1: Frequency shift from center frequency of reception

+ +Use the frequency wheels to set the channel offset in Hz from the device center +frequency. Left click a digit to select it, then use the mouse wheel or keyboard +arrows to adjust it. Shift changes the selected digit by five steps and Control +by two steps. Right click a digit to set the digits to its right to zero. + +For USB, tune to the carrier frequency. The channel marker shows the upper +sideband. AM uses a symmetric marker around the carrier. + +

2: Channel power

+ +Displays average received channel power in dB relative to a signal with an +amplitude of 1.0. + +

3: Level meter in dB

+ +- Top bar (green): average power. +- Bottom bar (blue green): instantaneous peak power. +- Bright green vertical marker: peak hold value. + +

4: Modulation

+ +Select **USB** for HF upper-sideband signals or **AM** for VHF amplitude-modulated +signals. Changing modulation selects an initial bandwidth of 3000 Hz for USB or +6000 Hz for AM. + +

5: Bandwidth (BW)

+ +Use the slider to set the bandwidth in 100 Hz steps. For USB, this sets the audio +upper cutoff from 2.0 to 3.6 kHz; the lower cutoff is 100 Hz. For AM, it sets the +full RF bandwidth from 2.0 to 6.0 kHz. The value is displayed beside the slider. + +Keep enough bandwidth for both tones in each pair. The highest SELCAL-32 tone is +1557.8 Hz. An AM bandwidth of 6000 Hz covers the complete tone set. The bandwidth +does not change the decoder's sensitivity, as tone levels are measured relative +to the noise in the SELCAL band. + +

6: Automatic carrier detection

+ +Use the carrier button to enable or disable automatic tone offset correction. +It is enabled by default for USB. A stable residual carrier within ±100 Hz +of the channel tuning supplies the correction automatically. Each tone pair keeps +the offset with which it was acquired. Retuning clears carrier acquisition. + +If the carrier is fully suppressed or cannot be detected reliably, the decoder +searches around the manual tone offset. When a carrier fades or is keyed off, +the search is centred on its last measured offset for a further 10 seconds. This button is inactive in AM, which +always tracks the carrier, within ±1000 Hz, for coherent detection. When +the AM carrier cannot be tracked, envelope detection is used. + +

7: Tone offset

+ +Sets the expected common frequency offset of the received audio tones, from +-100 to +100 Hz. For example, if the tones arrive 20 Hz above their nominal +frequencies, set this to `+20 Hz`. + +When automatic carrier detection has a reliable lock, the measured carrier +offset is used instead. Otherwise, the decoder searches for the tones within +±6 Hz of this setting, so small USB tuning errors need no correction. The +search is limited to ±6 Hz because pairs of adjacent tones resemble their +neighbours shifted by about 17.5 Hz: a wider search could decode the wrong code. +For larger errors, tune more accurately, set this offset, or rely on the carrier. + +

8: Threshold

+ +Sets the minimum level of each tone of a pair above the noise, from 6 to 20 dB. +The default is 8 dB. The noise is measured across the SELCAL band, in the +bandwidth of a single tone (about 15 Hz). Lower values detect weaker calls, but +increase the chance of false detections. The tones must also be within 15 dB of +each other, and no third tone or other signal in the SELCAL band may be +comparable with them. + +

9: Carrier status

+ +The text beside the volume dial shows the measured carrier offset and the +tone offset measured by the decoder, for example `Carrier +6.7 Hz, tones +6.7 Hz`. +Without tones, the tone offset is the offset that the decoder expects. In AM, it +shows whether coherent detection is in use. + +

10: Volume

+ +Use the dial to set the monitoring audio volume from 0.0 (silent) to 10.0 in steps +of 0.1. The default is 1.0, and the value is displayed beside the dial. This does +not change decoder input or detection thresholds. + +

11: Squelch threshold (Sq)

+ +Sets the received RF power threshold for monitoring audio, from -100 to 0 dBFS +in 1 dB steps. The default is -80 dBFS. Audio opens above the threshold, with a +short hold to avoid chatter. The value is displayed beside the dial. + +Squelch only controls monitoring audio. SELCAL decoding continues while the +squelch is closed. + +

12: Audio mute and audio output selection

+ +Left click the speaker button to mute or unmute monitoring audio. The button +turns green while the audio squelch is open, including when audio is muted. +Muting audio does not interrupt decoding. + +Right click the button to select the audio output device. The current device is +shown in the button's tooltip. See the +[audio management documentation](../../../sdrgui/audio.md) for details. + +

13: UDP output

+ +Check **UDP** to enable or disable forwarding decoded +calls to the UDP address and port. Output is disabled by default. Each received +call produces one UTF-8 JSON datagram, independently of the table filter: + +```json +{"code":"AC-BD","utc":"2026-10-02T12:34:56.789Z","frequencyHz":11330000,"rssi":-42.1,"snr":25.0,"toneOffsetHz":6.7} +``` + +UDP output also works in server mode. + +

14: UDP address

+ +Sets the destination IP address or host name for UDP output. The default is +`127.0.0.1`. A host name is looked up when it is set. + +

15: UDP port

+ +Sets the destination UDP port from 1 to 65535. The default is 9999. + +

16: Code filter

+ +Filters the calls table using a case-insensitive substring match. Hyphens are +ignored, so `acbd` matches `AC-BD`. Leave the field empty to display all calls. +Filtering changes table visibility; logging and UDP output still include every +received call. + +

17: Copy calls

+ +The copy button copies selected rows to the clipboard as tab-separated text, +with the columns shown in the order shown. If no rows are selected, it copies +the code shown in the last-call display. + +To copy a single value, right click on its cell in the table and select +**Copy**. For an aircraft image or flag, this copies the registration or +country it represents. + +

18: Export calls to CSV

+ +The export button saves the visible table rows to a selected CSV file. Rows +hidden by the code filter are excluded. The format is the same as the CSV log. + +

19: Start/stop logging calls to CSV

+ +Use the record button to start or stop appending received calls to the selected +CSV log file. Logging is disabled by default. It includes every received call, +independently of the table filter, and also works in server mode. + +The CSV columns and an example row are: + +```text +UTC,Code,FrequencyHz,RSSI,SNR +2026-10-02T12:34:56.789Z,AC-BD,11330000,-42.1,25 +``` + +

20: CSV log filename

+ +Click the save button to select the log filename. The current filename is shown +in its tooltip. The default is `selcal_log.csv`. + +

21: Download SELCAL database

+ +Click the download button to download the database of SELCAL codes assigned to +aircraft, from https://sdrangel.org/downloads/selcal.zip. It is used to display +the registrations, types and images of aircraft assigned a received code. If the +aircraft database used by the ADS-B demodulator has not been downloaded, you are +asked whether to download it too (45MB): it provides aircraft types and images. +The databases are stored in SDRangel's application data directory. + +The aircraft database is read when the channel is created. If it is downloaded +later, for example by the ADS-B demodulator, it is read when the next call is +received. + +

22: Read calls from a CSV log

+ +Click the load button to select an existing CSV log and add its calls to the +table. The file must contain the `UTC`, `Code`, `FrequencyHz`, `RSSI` and `SNR` +columns. Imported calls do not produce logging or UDP output, or increment the +receiver's call count. + +

23: Clear calls

+ +Click the bin button to clear the calls table, including rows hidden by the +filter. This does not erase the log file or reset the receiver's call count. + +

Received calls table

+ +![Received calls table](../../../doc/img/SELCALDemod_calls.png) + +The table contains: + +- **UTC:** approximate start time of the call, using the reception clock and + sample duration. Recording playback uses reception time rather than the + recording's original timestamp. +- **Code:** the two received tone pairs, such as `AC-BD`. +- **Registration:** registrations of aircraft assigned the code, from the SELCAL + database. Codes are not unique, so several aircraft may be listed. The tooltip + gives the manufacturer, model and operator of each from the aircraft database. +- **Type:** ICAO type designators of the listed aircraft, from the aircraft + database. `?` is shown for an aircraft that is not in the aircraft database. +- **Aircraft:** image of the first listed aircraft that is in the aircraft + database. +- **Country:** flag of the country of registration of that aircraft, or of the + first listed aircraft. +- **Frequency (kHz):** the tuned channel frequency when the call was decoded. +- **RSSI (dB):** average channel power during the two tone bursts, in dB + relative to a signal amplitude of 1.0. +- **SNR (dB):** level of the weaker tone above the noise in the bandwidth of a + tone, as for the threshold. Subtract about 22 dB for that tone's SNR in a + 2.5 kHz bandwidth. + +Drag column headers to reorder them and resize their edges to change column +widths. Right click on the table header to select which columns are shown. +Column positions, widths and visibility are saved with the channel settings. +There is no automatic history row limit. + +

Tone levels table

+ +![Audio tones](../../../doc/img/SELCALDemod_audio_tones.png) + +Open or close this panel using its rollup header. It displays the designation, +nominal frequency and level of each of the 32 SELCAL tones, in dB above the +noise in the bandwidth of a tone, measured at the current tone offset. A tone is +detectable when its level exceeds the threshold. + +

Audio spectrum

+ +![Audio spectrum](../../../doc/img/SELCALDemod_audio_spectrum.png) + +Displays the spectrum and waterfall of the audio analysed by the decoder, from +0 to 2 kHz. The 32 tone frequencies, adjusted by the tone offset, are marked at +the top of the spectrum. The tones of a detected pair are marked across the +full height of the spectrum and labelled. The display controls below the +spectrum are described [here](../../../sdrgui/gui/spectrum.md). diff --git a/plugins/channelrx/demodselcal/selcalcarriertracker.cpp b/plugins/channelrx/demodselcal/selcalcarriertracker.cpp new file mode 100644 index 000000000..67c3300b8 --- /dev/null +++ b/plugins/channelrx/demodselcal/selcalcarriertracker.cpp @@ -0,0 +1,153 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#include +#include + +#include "dsp/fftengine.h" + +#include "selcalcarriertracker.h" + +SELCALCarrierTracker::SELCALCarrierTracker() : + m_fft(FFTEngine::create("")), + m_samples(2 * m_windowSize), + m_window(m_windowSize) +{ + m_fft->configure(m_fftSize, false); + for (int i = 0; i < m_windowSize; ++i) + { + m_window[i] = 0.5 - 0.5 * std::cos(2 * M_PI * i / (m_windowSize - 1)); + m_windowSum += m_window[i]; + } + setRange(m_defaultRange); +} + +SELCALCarrierTracker::~SELCALCarrierTracker() = default; + +void SELCALCarrierTracker::reset() +{ + std::fill(m_samples.begin(), m_samples.end(), Complex{}); + m_position = m_count = m_missed = m_stable = 0; + m_candidate = m_offset = 0; + m_locked = false; +} + +void SELCALCarrierTracker::setRange(double range) +{ + range = std::isfinite(range) ? std::clamp(range, 10.0, 1500.0) : m_defaultRange; + if (range != m_range) { + reset(); + } + m_range = range; +} + +void SELCALCarrierTracker::feed(const Complex& sample) +{ + m_samples[m_position] = m_samples[m_position + m_windowSize] = sample; + m_position = (m_position + 1) % m_windowSize; + if (m_count < m_windowSize) { + ++m_count; + } + if (m_count == m_windowSize && m_position % m_hopSize == 0) { + analyse(); + } +} + +void SELCALCarrierTracker::analyse() +{ + // Oldest to newest sample. + const Complex *samples = &m_samples[m_position]; + Complex *input = m_fft->in(); + for (int i = 0; i < m_windowSize; ++i) { + input[i] = samples[i] * m_window[i]; + } + std::fill(input + m_windowSize, input + m_fftSize, Complex{}); + m_fft->transform(); + const Complex *output = m_fft->out(); + double scale = 1.0 / (m_windowSum * m_windowSum); + auto power = [output, scale](int bin) { + return static_cast(std::norm(output[(bin + m_fftSize) % m_fftSize])) * scale; + }; + + // Search past the capture range, so that a carrier just outside it cannot + // be mistaken for a peak at the edge of the search. + int rangeBins = static_cast(std::ceil(m_range / m_binWidth)); + int searchBins = std::min(rangeBins + 26, m_fftSize / 2 - 2); + int noiseBins = std::min(rangeBins + 77, m_fftSize / 2 - 1); + int peak = -searchBins; + for (int bin = -searchBins + 1; bin <= searchBins; ++bin) { + if (power(bin) > power(peak)) { + peak = bin; + } + } + // Excludes the peak's main lobe. + double secondary = 0; + for (int bin = -searchBins; bin <= searchBins; ++bin) { + if (std::abs(bin - peak) > 8) { + secondary = std::max(secondary, power(bin)); + } + } + // The median is robust to the carrier and any tones near it. For noise + // each bin is exponentially distributed, so mean = median / ln 2. + m_noise.resize(2 * noiseBins + 1); + for (int bin = -noiseBins; bin <= noiseBins; ++bin) { + m_noise[bin + noiseBins] = power(bin); + } + auto middle = m_noise.begin() + m_noise.size() / 2; + std::nth_element(m_noise.begin(), middle, m_noise.end()); + double noise = *middle / M_LN2; + + double left = std::log(std::max(power(peak - 1), 1e-30)); + double centre = std::log(std::max(power(peak), 1e-30)); + double right = std::log(std::max(power(peak + 1), 1e-30)); + double curvature = left - 2 * centre + right; + double fraction = curvature < -1e-12 ? 0.5 * (left - right) / curvature : 0; + double frequency = (peak + std::clamp(fraction, -0.5, 0.5)) * m_binWidth; + double carrierPower = power(peak); + bool valid = carrierPower > m_minPower && carrierPower > m_minSnr * noise && secondary < m_maxSecondary * carrierPower && + std::abs(frequency) <= m_range; + bool measured = false; + if (valid) + { + m_stable = std::abs(frequency - m_candidate) < 1 ? std::min(m_stable + 1, 2) : 1; + m_candidate = frequency; + if (m_stable >= 2) + { + m_offset = m_locked && std::abs(frequency - m_offset) < 2 ? m_offset + 0.25 * (frequency - m_offset) : frequency; + m_locked = true; + measured = true; + } + } + else + { + m_stable = 0; + } + // Retain lock across the inter-pair gap, but expire it during silence or + // loss of the carrier instead of applying a stale correction indefinitely. + if (measured) + { + m_missed = 0; + } + else + { + m_missed = std::min(m_missed + 1, m_expiry); + if (m_missed == m_expiry) { + m_locked = false; + } + } +} diff --git a/plugins/channelrx/demodselcal/selcalcarriertracker.h b/plugins/channelrx/demodselcal/selcalcarriertracker.h new file mode 100644 index 000000000..a835fc609 --- /dev/null +++ b/plugins/channelrx/demodselcal/selcalcarriertracker.h @@ -0,0 +1,85 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#ifndef INCLUDE_SELCALCARRIERTRACKER_H +#define INCLUDE_SELCALCARRIERTRACKER_H + +#include +#include + +#include "dsp/dsptypes.h" + +class FFTEngine; + +// Measures the carrier of an 8 kHz channel: a residual USB carrier before the +// audio sideband filter removes it, or an AM carrier for coherent detection. +// The carrier must be the strongest signal within the capture range and stand +// out from the local noise floor. +class SELCALCarrierTracker { +public: + static constexpr int m_sampleRate = 8000; + static constexpr double m_defaultRange = 100.0; + + SELCALCarrierTracker(); + ~SELCALCarrierTracker(); + + void reset(); + // Capture range either side of the channel frequency, in Hz. + void setRange(double range); + void feed(const Complex& sample); + bool locked() const { return m_locked; } + double offset() const { return m_offset; } + + // Samples by which the signal should be delayed so that carrier + // acquisition precedes the corresponding audio. + static constexpr int latency(); + +private: + + static constexpr int m_windowSize = 2048; // 256 ms + static constexpr int m_fftSize = 4096; + static constexpr int m_hopSize = 256; + static constexpr int m_expiry = 6; // Analyses without a carrier before lock is lost + static constexpr double m_binWidth = static_cast(m_sampleRate) / m_fftSize; + static constexpr double m_minSnr = 16.0; // Carrier power relative to the mean noise power in a bin (12 dB) + static constexpr double m_maxSecondary = 0.5; // Any other peak in the capture range must be at least 3 dB weaker + static constexpr double m_minPower = 1e-12; // Absolute floor, so that digital silence cannot acquire lock + + std::unique_ptr m_fft; + std::vector m_samples; + std::vector m_window; + std::vector m_noise; + double m_windowSum = 0; + double m_range = m_defaultRange; + int m_position = 0; + int m_count = 0; + int m_missed = 0; + int m_stable = 0; + double m_candidate = 0; + double m_offset = 0; + bool m_locked = false; + + void analyse(); +}; + +constexpr int SELCALCarrierTracker::latency() +{ + return m_windowSize + 2 * m_hopSize; +} + +#endif diff --git a/plugins/channelrx/demodselcal/selcaldecoder.cpp b/plugins/channelrx/demodselcal/selcaldecoder.cpp new file mode 100644 index 000000000..b8edb760a --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldecoder.cpp @@ -0,0 +1,919 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#include "selcaldecoder.h" +#include "dsp/fftengine.h" +#include +#include +#include + +// Modified Bessel function of the first kind, order 0, for the Kaiser window. +double SELCALDecoder::besselI0(double x) +{ + double sum = 1, term = 1; + for (int m = 1; m < 50; ++m) + { + term *= (x / (2 * m)) * (x / (2 * m)); + sum += term; + if (term < sum * 1e-12) { + break; + } + } + return sum; +} + +// Hz by which the measured offsets of tones of the given frequencies may differ. +double SELCALDecoder::maxOffsetDifference(double frequency1, double frequency2) +{ + return m_toneTolerance * (frequency1 + frequency2) + m_offsetMeasurementError; +} + +double SELCALDecoder::median(std::vector values) +{ + if (values.empty()) { + return 0; + } + auto middle = values.begin() + values.size() / 2; + std::nth_element(values.begin(), middle, values.end()); + return *middle; +} + +const std::array& SELCALDecoder::tones() +{ + // ASRI SELCAL Users Guide, Rev E (10 September 2024), table 2-1. + // Symbol order is deliberately independent of frequency order (SELCAL 32 + // inserts frequencies between the original tones). + static const std::array table{ + {{'A', 312.6}, {'B', 346.7}, {'C', 384.6}, {'D', 426.6}, {'E', 473.2}, {'F', 524.8}, {'G', 582.1}, {'H', 645.7}, + {'J', 716.1}, {'K', 794.3}, {'L', 881.0}, {'M', 977.2}, {'P', 1083.9}, {'Q', 1202.3}, {'R', 1333.5}, {'S', 1479.1}, + {'T', 329.2}, {'U', 365.2}, {'V', 405.0}, {'W', 449.3}, {'X', 498.3}, {'Y', 552.7}, {'Z', 613.1}, {'1', 680.0}, + {'2', 754.2}, {'3', 836.6}, {'4', 927.9}, {'5', 1029.2}, {'6', 1141.6}, {'7', 1266.2}, {'8', 1404.4}, {'9', 1557.8}}}; + return table; +} + +SELCALDecoder::SELCALDecoder() : + m_fft(FFTEngine::create("")) +{ + m_fft->configure(m_fftSize, false); + + // Kaiser windowed halfband lowpass for 8 kHz to 4 kHz decimation: flat to + // 1.7 kHz and more than 65 dB down from 2.3 kHz, where aliases would reach + // the SELCAL band. Even taps other than the centre are zero. + constexpr int centre = m_decimatorTaps / 2; + constexpr double beta = 6.0; + double sum = 0.5; + m_halfbandCentre = 0.5; + for (int j = 0; j < m_halfbandTaps; ++j) + { + int k = 2 * j + 1; + double ratio = static_cast(k) / centre; + double window = besselI0(beta * std::sqrt(std::max(0.0, 1 - ratio * ratio))) / besselI0(beta); + m_halfband[j] = std::sin(M_PI * k / 2) / (M_PI * k) * window; + sum += 2 * m_halfband[j]; + } + m_halfbandCentre /= sum; + for (double& coefficient : m_halfband) { + coefficient /= sum; + } + + double windowSum = 0; + for (int i = 0; i < m_windowSize; ++i) + { + m_window[i] = 0.5 - 0.5 * std::cos(2 * M_PI * i / (m_windowSize - 1)); + windowSum += m_window[i]; + } + // A tone of amplitude A measures A^2 at its centre bin. + m_powerScale = 4 / (windowSum * windowSum); + + double margin = m_maxFrequencyOffset + m_searchRange + 10; + double lowest = tones()[0].m_frequency, highest = tones()[0].m_frequency; + for (int i = 0; i < m_toneCount; ++i) + { + m_toneBins[i] = tones()[i].m_frequency / m_binWidth; + lowest = std::min(lowest, tones()[i].m_frequency); + highest = std::max(highest, tones()[i].m_frequency); + } + m_bandStart = static_cast(std::floor((lowest - margin) / m_binWidth)); + m_bandEnd = static_cast(std::ceil((highest + margin) / m_binWidth)) + 1; + m_hops.resize(m_preRollHops + 1); + for (auto& hop : m_hops) { + hop.m_power.resize(m_bandEnd - m_bandStart); + } + m_scratch.resize(m_bandEnd - m_bandStart); + m_raw.resize(m_bandEnd - m_bandStart); + m_background.resize(m_bandEnd - m_bandStart); + configure(0, m_defaultThreshold); +} + +SELCALDecoder::~SELCALDecoder() = default; + +void SELCALDecoder::configure(double frequencyOffset, double threshold) +{ + threshold = std::isfinite(threshold) ? std::clamp(threshold, 3.0, 30.0) : m_defaultThreshold; + m_threshold = std::pow(10.0, threshold / 10); + setFrequencyOffset(frequencyOffset); + reset(); +} + +void SELCALDecoder::setFrequencyOffset(double frequencyOffset, double uncertainty) +{ + frequencyOffset = std::isfinite(frequencyOffset) ? std::clamp(frequencyOffset, -m_maxFrequencyOffset, m_maxFrequencyOffset) : 0; + uncertainty = std::isfinite(uncertainty) ? std::clamp(uncertainty, 0.0, m_searchRange) : m_searchRange; + m_baseOffset = frequencyOffset / m_binWidth; + m_searchBins = std::max(1, static_cast(std::ceil(uncertainty / m_binWidth))); +} + +void SELCALDecoder::reset() +{ + m_history.fill(0); + m_historyPosition = 0; + m_samples.fill(0); + m_position = 0; + m_levels.fill(-30); + m_inputCount = 0; + m_analysisCount = 0; + m_hopCount = 0; + m_hopIndex = 0; + m_detected = {{-1, -1}}; + m_currentOffset = m_baseOffset; + m_segment = Segment(); + m_pending = Burst(); + m_held = Burst(); + m_holding = false; + m_called = Burst(); + m_blankLevel = 0; + m_blankCount = 0; + m_blankRun = 0; + m_blankQuiet = 0; + std::fill(m_background.begin(), m_background.end(), 0.0); + m_backgroundNoise = 0; + m_backgroundCount = 0; + m_learnAfter = 0; +} + +const char *SELCALDecoder::stateName(State state) +{ + switch (state) + { + case State::FirstPair: + return "First pair"; + case State::Gap: + return "Gap"; + case State::SecondPair: + return "Second pair"; + case State::WaitForSilence: + return "Waiting for silence"; + default: + return "Idle"; + } +} + +SELCALDecoder::State SELCALDecoder::state() const +{ + bool waiting = m_pending.m_valid || (m_holding && !brief(m_held)); + if (m_segment.m_active) { + return m_segment.m_overlong ? State::WaitForSilence : waiting ? State::SecondPair : State::FirstPair; + } + return waiting ? State::Gap : State::Idle; +} + +double SELCALDecoder::frequencyOffset() const +{ + double offset = m_segment.m_active ? m_segment.m_offset : m_holding ? m_held.m_offset : m_pending.m_valid ? m_pending.m_offset : m_currentOffset; + return offset * m_binWidth; +} + +void SELCALDecoder::feed(double sample) +{ + m_history[m_historyPosition] = m_history[m_historyPosition + m_decimatorTaps] = std::isfinite(sample) ? sample : 0; + m_historyPosition = (m_historyPosition + 1) % m_decimatorTaps; + if (++m_inputCount % 2) { + return; + } + // Oldest to newest input. + const double *history = &m_history[m_historyPosition]; + constexpr int centre = m_decimatorTaps / 2; + double output = m_halfbandCentre * history[centre]; + for (int j = 0; j < m_halfbandTaps; ++j) + { + int k = 2 * j + 1; + output += m_halfband[j] * (history[centre - k] + history[centre + k]); + } + if (m_sampleHandler) { + m_sampleHandler(static_cast(output)); + } + blank(output); + m_samples[m_position] = m_samples[m_position + m_windowSize] = output; + m_position = (m_position + 1) % m_windowSize; + if (++m_analysisCount >= m_windowSize && m_analysisCount % m_hopSize == 0) { + analyse(); + } +} + +int SELCALDecoder::bin(int tone, double offset) const +{ + return std::clamp(static_cast(std::lround(m_toneBins[tone] + offset)), m_bandStart, m_bandEnd - 1) - m_bandStart; +} + +const SELCALDecoder::Hop& SELCALDecoder::hop(int age) const +{ + int size = static_cast(m_hops.size()); + return m_hops[(m_hopIndex - age + size) % size]; +} + +double SELCALDecoder::pairPower(const Hop& hop, const Pair& pair, double offset) const +{ + return hop.m_power[bin(pair[0], offset)] + hop.m_power[bin(pair[1], offset)]; +} + +void SELCALDecoder::analyse() +{ + Complex *input = m_fft->in(); + const double *samples = &m_samples[m_position]; + for (int n = 0; n < m_windowSize; ++n) { + input[n] = Complex(static_cast(samples[n] * m_window[n]), 0); + } + std::fill(input + m_windowSize, input + m_fftSize, Complex{}); + m_fft->transform(); + + m_hopIndex = (m_hopIndex + 1) % static_cast(m_hops.size()); + Hop& current = m_hops[m_hopIndex]; + // Window centre in input samples, allowing for the decimator's delay. + current.m_time = 2.0 * static_cast(m_analysisCount) - 431; + const Complex *output = m_fft->out(); + for (int b = m_bandStart; b < m_bandEnd; ++b) { + current.m_power[b - m_bandStart] = static_cast(std::norm(output[b]) * m_powerScale); + } + ++m_hopCount; + + // The median of the band is robust to the tones themselves. For white + // noise each bin is exponentially distributed, so mean = median / ln 2. + std::copy(current.m_power.begin(), current.m_power.end(), m_scratch.begin()); + auto middle = m_scratch.begin() + m_scratch.size() / 2; + std::nth_element(m_scratch.begin(), middle, m_scratch.end()); + current.m_noise = std::max(static_cast(*middle) / M_LN2, m_noiseFloor); + + // Remove steady signals, such as heterodynes, that were present before + // any burst. Otherwise they would be taken as competing tones and prevent + // detection. Tones received on top of them are still measured. + std::copy(current.m_power.begin(), current.m_power.end(), m_raw.begin()); + if (m_backgroundCount > 0) + { + for (std::size_t b = 0; b < current.m_power.size(); ++b) + { + if (m_background[b] > m_steadyLevel * m_backgroundNoise) + { + // A strong steady signal's level varies slightly between analyses, + // so a margin is subtracted to prevent residuals being detected. + double power = current.m_power[b] - m_steadyMargin * (m_background[b] - m_backgroundNoise); + current.m_power[b] = static_cast(std::max(power, 1e-3 * current.m_noise)); + } + } + } + + // Candidate common tone offsets, in bins. While a burst is in progress, + // its own offsets are searched as well as the expected offset, so that a + // spurious burst cannot mask the start of a stronger one elsewhere. + std::array candidates; + std::array inSegment; + int candidateCount = 0; + auto add = [&](double centre, int range, bool segment) { + for (int c = -range; c <= range && candidateCount < static_cast(candidates.size()); ++c) + { + inSegment[candidateCount] = segment; + candidates[candidateCount++] = centre + c; + } + }; + if (m_segment.m_active) { + add(m_segment.m_offset, m_anchorSearch, true); + } + add(m_baseOffset, m_searchBins, false); + const Burst *previous = previousPair(); + if (previous) { + add(previous->m_offset, m_anchorSearch, false); + } + + bool found = false; + Pair bestPair{{-1, -1}}; + double bestOffset = m_segment.m_active ? m_segment.m_offset : previous ? previous->m_offset : m_baseOffset; + double bestSnr = 0; + bool continued = false; // The burst in progress was detected again + double continuedSnr = 0; + double scale = 1.0 / current.m_noise; + Peaks peaks; + findPeaks(current.m_power, peaks); + for (int c = 0; c < candidateCount; ++c) + { + Pair pair; + double snr; + if (!evaluate(current.m_power, peaks, scale, candidates[c], pair, snr)) { + continue; + } + if (inSegment[c] && pair == m_segment.m_pair && snr > continuedSnr) + { + continued = true; + continuedSnr = snr; + } + if (snr > bestSnr) + { + found = true; + bestSnr = snr; + bestOffset = candidates[c]; + bestPair = pair; + } + } + if (continued) + { + m_detected = m_segment.m_pair; + m_currentOffset = m_segment.m_offset; + } + else + { + m_detected = bestPair; + m_currentOffset = bestOffset; + } + for (int i = 0; i < m_toneCount; ++i) { + m_levels[i] = 10 * std::log10(std::max(current.m_power[bin(i, m_currentOffset)] * scale, 1e-3)); + } + + if (m_segment.m_active && m_segment.m_overlong) + { + // Too long for a SELCAL burst, so a steady signal. Its history is no + // longer needed, and it is learnt as background (below) until it no + // longer masks other signals. + if (continued) { + m_segment.m_missed = 0; + } else if (++m_segment.m_missed > m_holdHops) { + closeSegment(); + } + } + else if (m_segment.m_active) + { + m_segment.m_power.push_back(pairPower(current, m_segment.m_pair, m_segment.m_offset)); + m_segment.m_times.push_back(current.m_time); + m_segment.m_detected.push_back(continued); + if (current.m_time - m_segment.m_times[m_segment.m_first] > (m_maxBurst + 0.125) * m_sampleRate) { + m_segment.m_overlong = true; + } + if (continued) + { + m_segment.m_last = static_cast(m_segment.m_power.size()) - 1; + m_segment.m_missed = 0; + m_segment.m_snr.push_back(continuedSnr); + accumulate(current); + } + else if (++m_segment.m_missed > m_holdHops) { + // Ends the burst. A different pair detected in this hop may start the next one. + closeSegment(); + } + } + if (!m_segment.m_active) + { + // The leading edge of a burst can be found up to the pre-roll before it is detected. + double preRoll = m_preRollHops * m_hopSize * 2.0 / m_sampleRate; + if (m_holding && current.m_time - m_held.m_end > (m_maxFadeGap + preRoll) * m_sampleRate) { + releaseHeld(); + } + // While a burst is held, it may be the second pair. + if (m_pending.m_valid && !m_holding && + current.m_time - m_pending.m_end > (m_maxGap + (m_nominalBurst - m_minFadedBurst) + (m_nominalBurst - m_minBurst) + preRoll) * m_sampleRate) { + m_pending.m_valid = false; + } + if (found) { + startSegment(bestPair, bestOffset, bestSnr); + } + } + bool idle = !found && !m_segment.m_active && !m_pending.m_valid && !(m_holding && !brief(m_held)); + bool steady = m_segment.m_active && m_segment.m_overlong; + if ((idle || steady) && (m_inputCount >= m_learnAfter)) { + learnBackground(current.m_noise); + } +} + +void SELCALDecoder::holdLearning(std::uint64_t samples) +{ + m_learnAfter = m_inputCount + samples; +} + +void SELCALDecoder::learnBackground(double noise) +{ + // Running mean initially, then an exponential average. + m_backgroundCount = std::min(m_backgroundCount + 1, m_backgroundHops); + double alpha = 1.0 / m_backgroundCount; + for (std::size_t b = 0; b < m_raw.size(); ++b) { + m_background[b] += (m_raw[b] - m_background[b]) * alpha; + } + m_backgroundNoise += (noise - m_backgroundNoise) * alpha; +} + +std::uint64_t SELCALDecoder::sampleIndex(double time) +{ + return static_cast(std::max(0.0, std::round(time))); +} + +void SELCALDecoder::findPeaks(const std::vector& power, Peaks& peaks) const +{ + // Strongest local maxima of the band, strongest first. + peaks.fill(-1); + for (int b = 1; b + 1 < static_cast(power.size()); ++b) + { + if (power[b] < power[b - 1] || power[b] < power[b + 1] || (peaks[m_peakCount - 1] >= 0 && power[b] <= power[peaks[m_peakCount - 1]])) { + continue; + } + int i = m_peakCount - 1; + while (i > 0 && (peaks[i - 1] < 0 || power[b] > power[peaks[i - 1]])) + { + peaks[i] = peaks[i - 1]; + --i; + } + peaks[i] = b; + } +} + +bool SELCALDecoder::evaluate(const std::vector& power, const Peaks& peaks, double scale, double offset, Pair& pair, double& snr) const +{ + int first = -1, second = -1; + double p1 = -1, p2 = -1, p3 = -1; + for (int i = 0; i < m_toneCount; ++i) + { + double level = power[bin(i, offset)]; + if (level > p1) + { + p3 = p2; + second = first; + p2 = p1; + first = i; + p1 = level; + } + else if (level > p2) + { + p3 = p2; + second = i; + p2 = level; + } + else if (level > p3) + { + p3 = level; + } + } + p1 *= scale; + p2 *= scale; + p3 *= scale; + pair = {{std::min(first, second), std::max(first, second)}}; + snr = p2; + // The strongest other signal in the band, away from the pair's main lobes. + // Unlike the third tone, this does not depend on the offset: at another + // offset, a three-tone chord could otherwise look like a different pair. + double other = 0; + int firstBin = bin(pair[0], offset), secondBin = bin(pair[1], offset); + for (int peak : peaks) + { + if (peak >= 0 && std::abs(peak - firstBin) > m_mainLobeBins && std::abs(peak - secondBin) > m_mainLobeBins) + { + other = power[peak] * scale; + break; + } + } + // Both tones must stand out from the noise, and not differ too greatly in level. + // A third tone or other signal that is itself significant makes the pair + // ambiguous. The noise maximum across the band is allowed for. + if (!(p2 >= m_threshold && p2 >= p1 * m_minBalance && p3 < std::max(p2 * 0.30, m_threshold) && + other < std::max(p2 * 0.30, 2 * m_threshold))) { + return false; + } + // Each tone must be a spectral peak. The main lobe is wider than the + // spacing of adjacent tones, so a single signal between two of them could + // otherwise look like a pair. + return peaked(power, pair[0], pair[1], offset) && peaked(power, pair[1], pair[0], offset); +} + +int SELCALDecoder::peakRange(int tone, int partner) const +{ + // Bins either side of a tone to search for its peak, keeping clear of the + // other tone of the pair. + return std::min(m_anchorSearch + 2, static_cast((std::abs(m_toneBins[partner] - m_toneBins[tone]) - 1) / 2)); +} + +bool SELCALDecoder::peaked(const std::vector& power, int tone, int partner, double offset) const +{ + int range = peakRange(tone, partner); + int centre = bin(tone, offset); + int low = std::max(0, centre - range), high = std::min(static_cast(power.size()) - 1, centre + range); + int peak = low; + for (int b = low; b <= high; ++b) { + if (power[b] > power[peak]) { + peak = b; + } + } + return peak > low && peak < high; +} + +void SELCALDecoder::startSegment(const Pair& pair, double offset, double snr) +{ + m_segment = Segment(); + m_segment.m_active = true; + m_segment.m_pair = pair; + m_segment.m_offset = offset; + m_segment.m_acquired = offset; + // Acquired around the expected offset, or that of the previous pair. + bool expected = std::abs(offset - m_baseOffset) <= m_searchBins + 0.01; + const Burst *previous = previousPair(); + m_segment.m_searchCentre = expected || !previous ? m_baseOffset : previous->m_offset; + m_segment.m_searchBins = expected || !previous ? m_searchBins : m_anchorSearch; + m_segment.m_spectrum.assign(m_bandEnd - m_bandStart, 0.0f); + int history = static_cast(std::min(m_preRollHops, m_hopCount - 1)); + for (int age = history; age >= 0; --age) + { + const Hop& previous = hop(age); + m_segment.m_power.push_back(pairPower(previous, pair, offset)); + m_segment.m_times.push_back(previous.m_time); + m_segment.m_detected.push_back(age == 0); + } + m_segment.m_first = m_segment.m_last = history; + m_segment.m_snr.push_back(snr); + accumulate(hop(0)); +} + +void SELCALDecoder::accumulate(const Hop& current) +{ + double scale = 1.0 / current.m_noise; + for (std::size_t b = 0; b < current.m_power.size(); ++b) { + m_segment.m_spectrum[b] += static_cast(current.m_power[b] * scale); + } + ++m_segment.m_spectrumHops; + + // The acquisition offset is measured on the burst's leading edge and is + // coarse. Follow the tones' measured offset so they stay centred in the search. + double sum = 0, weight = 0; + for (int k = 0; k < 2; ++k) { + measurePeak(current.m_power, m_segment.m_pair[k], m_segment.m_pair[1 - k], m_segment.m_offset, sum, weight); + } + m_segment.m_offsetSum += sum; + m_segment.m_offsetWeight += weight; + if (m_segment.m_offsetWeight > 0) + { + // Stay within the search, so the tones cannot be followed towards another pair. + double range = m_segment.m_searchBins + 1; + m_segment.m_offset = std::clamp(m_segment.m_offsetSum / m_segment.m_offsetWeight, m_segment.m_searchCentre - range, m_segment.m_searchCentre + range); + } +} + +void SELCALDecoder::measurePeak(const std::vector& power, int tone, int partner, double offset, double& sum, double& weight) const +{ + // Interpolated spectral peak near the expected tone frequency, keeping + // clear of the other tone of the pair. + int size = static_cast(power.size()); + int range = peakRange(tone, partner); + int centre = bin(tone, offset); + int low = std::max(1, centre - range), high = std::min(size - 2, centre + range); + if (low > high) { + return; + } + int peak = low; + for (int b = low; b <= high; ++b) { + if (power[b] > power[peak]) { + peak = b; + } + } + double left = std::log(std::max(static_cast(power[peak - 1]), 1e-30)); + double centrePower = std::log(std::max(static_cast(power[peak]), 1e-30)); + double right = std::log(std::max(static_cast(power[peak + 1]), 1e-30)); + double curvature = left - 2 * centrePower + right; + double fraction = curvature < -1e-12 ? std::clamp(0.5 * (left - right) / curvature, -0.5, 0.5) : 0; + sum += power[peak] * (peak + m_bandStart + fraction - m_toneBins[tone]); + weight += power[peak]; +} + +bool SELCALDecoder::identify(Pair& pair, double& offset) const +{ + // Identify the pair again from the spectrum averaged over the burst. Its + // SNR is much higher than any single analysis, so it reliably distinguishes + // the pair from a similar pair at a different offset. + const Segment& s = m_segment; + pair = s.m_pair; + offset = s.m_offset; + if (s.m_spectrumHops == 0) { + return false; + } + double scale = 1.0 / s.m_spectrumHops; + double best = 0; + Peaks peaks; + findPeaks(s.m_spectrum, peaks); + auto consider = [&](double centre, int range) { + for (int c = -range; c <= range; ++c) + { + Pair candidate; + double snr; + if (evaluate(s.m_spectrum, peaks, scale, centre + c, candidate, snr) && snr > best) + { + best = snr; + pair = candidate; + offset = centre + c; + } + } + }; + consider(s.m_searchCentre, s.m_searchBins); + // Both tones of a genuine pair share the offset, to within the tone + // frequency tolerance. When tones are further from the expected offset + // than the search, they can resemble other tones, but rarely with a + // consistent offset. + std::array sums{}, weights{}; + for (int k = 0; k < 2; ++k) { + measurePeak(s.m_spectrum, pair[k], pair[1 - k], offset, sums[k], weights[k]); + } + if (weights[0] <= 0 || weights[1] <= 0) { + return false; + } + double first = sums[0] / weights[0], second = sums[1] / weights[1]; + offset = std::clamp((sums[0] + sums[1]) / (weights[0] + weights[1]), offset - 1, offset + 1); + double allowed = maxOffsetDifference(tones()[pair[0]].m_frequency, tones()[pair[1]].m_frequency); + return std::abs(first - second) <= allowed / m_binWidth; +} + +void SELCALDecoder::closeSegment() +{ + Segment& s = m_segment; + s.m_active = false; + + // Burst edges are where the pair's amplitude is half its typical value: + // the analysis window is then centred on the edge. This is independent of + // signal level, unlike the first and last hops on which a pair is detected. + std::vector detectedPower; + for (int i = s.m_first; i <= s.m_last; ++i) { + if (s.m_detected[i]) { + detectedPower.push_back(s.m_power[i]); + } + } + double threshold = std::sqrt(median(detectedPower)) / 2; + int count = static_cast(s.m_power.size()); + auto amplitude = [&s](int i) { + return std::sqrt(s.m_power[i]); + }; + auto crossing = [&](int a, int b) { + double difference = amplitude(b) - amplitude(a); + double fraction = std::abs(difference) > 1e-30 ? (threshold - amplitude(a)) / difference : 0.5; + return s.m_times[a] + (s.m_times[b] - s.m_times[a]) * std::clamp(fraction, 0.0, 1.0); + }; + + int i = s.m_first; + if (amplitude(i) >= threshold) { + while (i > 0 && amplitude(i - 1) >= threshold) { + --i; + } + } + else + { + while (i < s.m_last && amplitude(i) < threshold) { + ++i; + } + } + double start = i > 0 ? crossing(i - 1, i) : s.m_times[0]; + + int j = s.m_last; + if (amplitude(j) >= threshold) { + while (j + 1 < count && amplitude(j + 1) >= threshold) { + ++j; + } + } + else + { + while (j > s.m_first && amplitude(j) < threshold) { + --j; + } + } + double end = j + 1 < count ? crossing(j, j + 1) : s.m_times[j]; + + Burst burst; + burst.m_consistent = identify(burst.m_pair, burst.m_offset); + burst.m_overlong = s.m_overlong; + burst.m_start = start; + burst.m_end = end; + burst.m_valid = validBurst(burst); + burst.m_snr = 10 * std::log10(std::max(median(s.m_snr), 1e-3)); + burst.m_startSample = sampleIndex(start); + segmentClosed(burst); +} + +// Impulse blanker. Static crashes spread energy across the whole spectrum of an +// analysis window, masking the tones. Samples much larger than the recent mean +// magnitude are removed. An increase lasting longer than an impulse is a new +// signal, such as the start of a call, so is restored. The beats between two +// tones briefly reduce their level, so short gaps between impulses are part of +// the same increase. +void SELCALDecoder::blank(double& sample) +{ + double magnitude = std::abs(sample); + if (m_blankLevel <= 0) + { + m_blankLevel = magnitude; + return; + } + bool impulse = magnitude > m_impulseLevel * m_blankLevel; + if (impulse) + { + m_blankCount = m_impulseHold; + m_blankQuiet = 0; + } + else if ((m_blankRun > 0) && (++m_blankQuiet > m_impulseGap)) + { + m_blankRun = 0; + } + if (impulse || (m_blankRun > 0)) + { + if (m_blankRun == m_maxImpulse) + { + // Restore the samples removed, which haven't yet left the analysis + // window, and follow the new level. + double sum = 0; + for (int i = 0; i < m_blankRun; ++i) + { + int position = (m_position - m_blankRun + i + m_windowSize) % m_windowSize; + m_samples[position] = m_samples[position + m_windowSize] = m_blanked[i]; + sum += std::abs(m_blanked[i]); + } + m_blankLevel = std::max(m_blankLevel, sum / m_blankRun); + m_blankRun = 0; + m_blankCount = 0; + return; + } + m_blanked[m_blankRun++] = sample; + } + else + { + // The mean is held while blanking, so that a new signal continues to be + // blanked until it is recognised, and limited otherwise, so that + // impulses don't raise it much. + m_blankLevel += (std::min(magnitude, m_impulseLevel * m_blankLevel) - m_blankLevel) * m_impulseAveraging; + } + if (m_blankCount > 0) + { + --m_blankCount; + sample = 0; + } +} + +bool SELCALDecoder::validBurst(const Burst& burst) const +{ + double duration = (burst.m_end - burst.m_start) / m_sampleRate; + return burst.m_consistent && !burst.m_overlong && duration >= m_minFadedBurst && duration <= m_maxBurst; +} + +bool SELCALDecoder::brief(const Burst& burst) const +{ + return burst.m_end - burst.m_start < m_minBurst / 2 * m_sampleRate; +} + +// Whether a burst is part of the same burst as an earlier one, split by a fade. +bool SELCALDecoder::continues(const Burst& burst, const Burst& previous) const +{ + return burst.m_pair == previous.m_pair && std::abs(burst.m_offset - previous.m_offset) <= m_anchorSearch + 0.5 && + burst.m_start - previous.m_end <= m_maxFadeGap * m_sampleRate; +} + +// The latest burst that a following pair may complete a call with. +const SELCALDecoder::Burst *SELCALDecoder::previousPair() const +{ + if (m_holding && m_held.m_consistent && !brief(m_held)) { + return &m_held; + } + return m_pending.m_valid ? &m_pending : nullptr; +} + +void SELCALDecoder::segmentClosed(const Burst& burst) +{ + // The rest of a call's second burst, after a fade, was already decoded. + if (m_called.m_valid && continues(burst, m_called)) + { + m_called.m_end = std::max(m_called.m_end, burst.m_end); + return; + } + + if (m_holding) + { + // A fade split the burst: join the parts. + if (continues(burst, m_held)) + { + // The longer part's measurements are the more reliable + bool heldLonger = m_held.m_end - m_held.m_start >= burst.m_end - burst.m_start; + const Burst& longer = heldLonger ? m_held : burst; + Burst joined = burst; + joined.m_start = m_held.m_start; + joined.m_startSample = m_held.m_startSample; + joined.m_offset = longer.m_offset; + joined.m_consistent = longer.m_consistent; + joined.m_overlong = m_held.m_overlong || burst.m_overlong; + joined.m_snr = std::max(m_held.m_snr, burst.m_snr); + joined.m_valid = validBurst(joined); + m_held = joined; + if (completesCall(m_held)) { + releaseHeld(); + } + return; + } + // Brief detections, from noise or the overlap of two pairs within the + // analysis window, don't end a burst that may continue. Of brief + // detections, the longest is the most likely to be part of a burst. + if (brief(burst)) + { + if (brief(m_held) && (burst.m_end - burst.m_start > m_held.m_end - m_held.m_start)) { + m_held = burst; + } + return; + } + releaseHeld(); + } + // A burst that completes a call is decoded without waiting for it to + // continue. Others, including brief ones, are held in case they do. + if (completesCall(burst)) + { + burstEnded(burst); + return; + } + m_held = burst; + m_holding = true; +} + +void SELCALDecoder::releaseHeld() +{ + Burst burst = m_held; + m_holding = false; + m_held = Burst(); + burstEnded(burst); +} + +void SELCALDecoder::burstEnded(const Burst& burst) +{ + if (!burst.m_valid) + { + // Brief detections, from noise or the overlap of two pairs within the + // analysis window, do not interrupt a sequence. + if (burst.m_end - burst.m_start >= m_minBurst / 2 * m_sampleRate) { + m_pending.m_valid = false; + } + return; + } + if (completesCall(burst)) + { + Burst firstBurst = m_pending; + m_pending.m_valid = false; + m_called = burst; + emitCall(firstBurst, burst); + return; + } + m_pending = burst; +} + +bool SELCALDecoder::completesCall(const Burst& burst) const +{ + if (!burst.m_valid || !m_pending.m_valid) { + return false; + } + double gap = (burst.m_start - m_pending.m_end) / m_sampleRate; + double firstDuration = (m_pending.m_end - m_pending.m_start) / m_sampleRate; + double secondDuration = (burst.m_end - burst.m_start) / m_sampleRate; + double shortfall = std::max(0.0, m_nominalBurst - firstDuration) + std::max(0.0, m_nominalBurst - secondDuration); + // A fade may shorten one burst, but not both. + bool durations = std::max(firstDuration, secondDuration) >= m_minBurst; + const Pair& first = m_pending.m_pair; + const Pair& second = burst.m_pair; + bool distinct = second[0] != first[0] && second[0] != first[1] && second[1] != first[0] && second[1] != first[1]; + // Both pairs come from the same transmitter, so share a tone offset. A pair's + // offset is a weighted mean of its tones' offsets, so may differ from the + // transmitter's by up to the tolerance of its higher tone. + double allowed = maxOffsetDifference(std::max(tones()[first[0]].m_frequency, tones()[first[1]].m_frequency), + std::max(tones()[second[0]].m_frequency, tones()[second[1]].m_frequency)); + bool sameOffset = std::abs(burst.m_offset - m_pending.m_offset) <= allowed / m_binWidth; + return gap >= m_minGap && gap <= m_maxGap + shortfall && durations && distinct && sameOffset; +} + +void SELCALDecoder::emitCall(const Burst& first, const Burst& second) +{ + if (!m_handler) { + return; + } + Call call; + call.m_code = {tones()[first.m_pair[0]].m_symbol, tones()[first.m_pair[1]].m_symbol, '-', tones()[second.m_pair[0]].m_symbol, + tones()[second.m_pair[1]].m_symbol}; + call.m_startSample = first.m_startSample; + call.m_firstEndSample = sampleIndex(first.m_end); + call.m_secondStartSample = sampleIndex(second.m_start); + call.m_endSample = sampleIndex(second.m_end); + call.m_snr = std::min(first.m_snr, second.m_snr); + call.m_frequencyOffset = (first.m_offset + second.m_offset) / 2 * m_binWidth; + m_handler(call); +} diff --git a/plugins/channelrx/demodselcal/selcaldecoder.h b/plugins/channelrx/demodselcal/selcaldecoder.h new file mode 100644 index 000000000..122cac21b --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldecoder.h @@ -0,0 +1,268 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#ifndef INCLUDE_SELCALDECODER_H +#define INCLUDE_SELCALDECODER_H + +#include +#include +#include +#include +#include +#include +#include + +class FFTEngine; + +// Audio-only decoder. All timing is measured in samples, independently of the +// caller's block sizes, wall clock and audio output device. +// +// Tone levels are measured relative to the noise floor in the SELCAL band, so +// detection does not depend on the receive bandwidth or on the total audio +// power. A common tone offset is searched for around the expected offset, and +// both tone pairs of a call must share it. +class SELCALDecoder { +public: + static constexpr int m_sampleRate = 8000; + static constexpr int m_toneCount = 32; + static constexpr double m_defaultThreshold = 8.0; // dB above the noise in a tone bin + // Hz either side of the expected offset. Pairs of adjacent tones resemble + // their neighbours shifted by about 17.5 Hz, so a wider search would be + // ambiguous. + static constexpr double m_searchRange = 6.0; + static constexpr double m_maxFrequencyOffset = 100.0; + + struct Tone { + char m_symbol; + double m_frequency; + }; + + struct Call { + std::string m_code; + std::uint64_t m_startSample; + std::uint64_t m_firstEndSample; + std::uint64_t m_secondStartSample; + std::uint64_t m_endSample; + double m_snr; // dB, weaker tone relative to the noise in a tone bin + double m_frequencyOffset; // Hz, common tone offset measured from the tones + }; + enum class State { Idle, FirstPair, Gap, SecondPair, WaitForSilence }; + using Pair = std::array; + + SELCALDecoder(); + ~SELCALDecoder(); + void reset(); + void configure(double frequencyOffset, double threshold); + // Expected common tone offset and its uncertainty, in Hz. A call in + // progress keeps the offset it was acquired with. + void setFrequencyOffset(double frequencyOffset, double uncertainty = m_searchRange); + void feed(double sample); + // Don't learn steady signals from the next samples, e.g. audio received + // before retuning that is still being delivered. + void holdLearning(std::uint64_t samples); + + void setCallHandler(std::function handler) + { + m_handler = std::move(handler); + } + + // Receives the decimated audio analysed by the decoder, for display. + void setSampleHandler(std::function handler) + { + m_sampleHandler = std::move(handler); + } + + State state() const; + + // Tone levels in dB relative to the noise in a tone bin. + const std::array& levels() const + { + return m_levels; + } + + // Pair detected in the latest analysis, or {-1, -1}. + Pair pair() const + { + return m_detected; + } + + // Tone offset of the call in progress, or of the latest analysis, in Hz. + double frequencyOffset() const; + + static const std::array& tones(); + static const char *stateName(State state); + static constexpr int m_analysisSampleRate = m_sampleRate / 2; + +private: + static constexpr int m_decimatorTaps = 63; + static constexpr int m_halfbandTaps = (m_decimatorTaps + 1) / 4; // Non-zero taps either side of the centre + static constexpr int m_windowSize = 400; // 100 ms + static constexpr int m_hopSize = 80; // 20 ms + static constexpr int m_fftSize = 2048; + static constexpr double m_binWidth = static_cast(m_analysisSampleRate) / m_fftSize; + static constexpr int m_holdHops = 3; // Dropouts tolerated within a burst + static constexpr int m_preRollHops = 8; // History kept to locate a burst's leading edge + static constexpr int m_anchorSearch = 2; // Bins either side of a call's offset + static constexpr int m_mainLobeBins = 10; // Half width of a tone's main lobe, and some + static constexpr int m_peakCount = 4; + static constexpr int m_backgroundHops = 50; // Time constant for learning steady signals + static constexpr double m_steadyLevel = 4.0; // Steady signal power relative to noise + static constexpr double m_steadyMargin = 1.25; // Proportion of a steady signal's power removed + // Lower bound for the noise estimate, so digital silence cannot produce tones. + static constexpr double m_noiseFloor = 1e-15; + // Burst and gap limits in seconds, with an allowance for edge measurement. + static constexpr double m_minBurst = 0.725; + static constexpr double m_maxBurst = 1.275; + static constexpr double m_minGap = 0.075; + static constexpr double m_maxGap = 0.325; + // Fades can only shorten bursts and lengthen gaps. One burst of a call may be + // measured as short as this, and the gap may grow by however much each burst + // is shorter than nominal. + static constexpr double m_nominalBurst = 1.0; + static constexpr double m_minFadedBurst = 0.45; + // A fade can split a burst. Parts of the same pair this close are joined. + static constexpr double m_maxFadeGap = 0.45; + // Impulse blanker: samples this much larger than the mean magnitude are + // removed, along with those around them. + static constexpr double m_impulseLevel = 5.0; + static constexpr int m_impulseHold = 8; // 2 ms at 4 kHz + static constexpr int m_impulseGap = 12; // 3 ms at 4 kHz, between impulses of the same rise + static constexpr double m_impulseAveraging = 1.0 / 64; // 16 ms at 4 kHz + static constexpr int m_maxImpulse = 64; // 16 ms, longer increases are new signals + // Each tone may differ from its nominal frequency by this proportion (0.15%), + // so the offsets of two tones may differ by this proportion of the sum of + // their frequencies, plus an allowance in Hz for measuring the offsets. + static constexpr double m_toneTolerance = 0.0015; + static constexpr double m_offsetMeasurementError = 2.5; + // Weaker tone of a pair relative to the stronger (-15 dB). The lowest tones are + // near the low end of SSB audio filters, so can be much weaker than their partner. + static constexpr double m_minBalance = 0.0316; + using Peaks = std::array; + + struct Hop { + double m_time = 0; + double m_noise = 0; + std::vector m_power; + }; + + struct Segment { + bool m_active = false; + bool m_overlong = false; + Pair m_pair{{-1, -1}}; + double m_offset = 0; // Bins, follows the measured tone offset + double m_acquired = 0; // Bins, offset at acquisition + int m_first = 0; + int m_last = 0; + int m_missed = 0; + std::vector m_power; + std::vector m_times; + std::vector m_detected; + std::vector m_snr; + double m_offsetSum = 0; + double m_offsetWeight = 0; + std::vector m_spectrum; // Sum of levels relative to noise + int m_spectrumHops = 0; + double m_searchCentre = 0; // Offsets within which the burst was acquired + int m_searchBins = 0; + }; + + struct Burst { + bool m_valid = false; + bool m_consistent = false; // Both tones have the same offset + bool m_overlong = false; + Pair m_pair{{-1, -1}}; + double m_start = 0; + double m_end = 0; + double m_offset = 0; + double m_snr = 0; + std::uint64_t m_startSample = 0; + }; + + static std::uint64_t sampleIndex(double time); + static double besselI0(double x); + static double median(std::vector values); + static double maxOffsetDifference(double frequency1, double frequency2); + + std::unique_ptr m_fft; + std::array m_halfband{}; + double m_halfbandCentre = 0.5; + std::array m_history{}; + int m_historyPosition = 0; + std::array m_samples{}; + std::array m_window{}; + double m_powerScale = 0; + int m_position = 0; + int m_bandStart = 0; + int m_bandEnd = 0; + std::array m_toneBins{}; + std::vector m_hops; + int m_hopIndex = 0; + std::vector m_scratch; + std::vector m_raw; // Power before background removal + std::vector m_background; // Power of steady signals, learnt while idle + double m_backgroundNoise = 0; + int m_backgroundCount = 0; + std::uint64_t m_learnAfter = 0; + std::array m_levels{}; + std::function m_handler; + std::function m_sampleHandler; + double m_threshold = 0; + double m_baseOffset = 0; // Bins + int m_searchBins = 0; + double m_currentOffset = 0; // Bins + Pair m_detected{{-1, -1}}; + std::uint64_t m_inputCount = 0; + std::uint64_t m_analysisCount = 0; + std::uint64_t m_hopCount = 0; + Segment m_segment; + Burst m_pending; + Burst m_held; // Burst that may continue after a fade + bool m_holding = false; + Burst m_called; // Second burst of the latest call, which may also continue + double m_blankLevel = 0; // Mean magnitude, for the impulse blanker + int m_blankCount = 0; + int m_blankRun = 0; // Samples since blanking started + int m_blankQuiet = 0; // Samples since the last impulse + std::array m_blanked{}; // Samples since blanking started, before blanking + void blank(double& sample); + + void analyse(); + const Hop& hop(int age) const; + double pairPower(const Hop& hop, const Pair& pair, double offset) const; + int bin(int tone, double offset) const; + void startSegment(const Pair& pair, double offset, double snr); + void findPeaks(const std::vector& power, Peaks& peaks) const; + bool evaluate(const std::vector& power, const Peaks& peaks, double scale, double offset, Pair& pair, double& snr) const; + int peakRange(int tone, int partner) const; + bool peaked(const std::vector& power, int tone, int partner, double offset) const; + void accumulate(const Hop& current); + void learnBackground(double noise); + void measurePeak(const std::vector& power, int tone, int partner, double offset, double& sum, double& weight) const; + bool identify(Pair& pair, double& offset) const; + void closeSegment(); + void segmentClosed(const Burst& burst); + void releaseHeld(); + bool validBurst(const Burst& burst) const; + bool completesCall(const Burst& burst) const; + bool continues(const Burst& burst, const Burst& previous) const; + bool brief(const Burst& burst) const; + const Burst *previousPair() const; + void burstEnded(const Burst& burst); + void emitCall(const Burst& first, const Burst& second); +}; +#endif diff --git a/plugins/channelrx/demodselcal/selcaldemod.cpp b/plugins/channelrx/demodselcal/selcaldemod.cpp new file mode 100644 index 000000000..ca189ca80 --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemod.cpp @@ -0,0 +1,727 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include + +#include "SWGChannelSettings.h" +#include "SWGWorkspaceInfo.h" +#include "SWGSELCALDemodSettings.h" +#include "SWGChannelReport.h" + +#include "dsp/dspcommands.h" +#include "device/deviceapi.h" +#include "settings/serializable.h" +#include "util/db.h" +#include "maincore.h" + +#include "selcaldemod.h" + +MESSAGE_CLASS_DEFINITION(SELCALDemod::MsgConfigureSELCALDemod, Message) + +const char *const SELCALDemod::m_channelIdURI = "sdrangel.channel.selcaldemod"; +const char *const SELCALDemod::m_channelId = "SELCALDemod"; + +SELCALDemod::SELCALDemod(DeviceAPI *deviceAPI) : + ChannelAPI(m_channelIdURI, ChannelAPI::StreamSingleSink), + m_deviceAPI(deviceAPI), + m_spectrumVis(SDR_RX_SCALEF), + m_basebandSampleRate(0), + m_centerFrequency(0) +{ + setObjectName(m_channelId); + m_thread.setObjectName("SELCALDemodBB"); + + m_basebandSink = new SELCALDemodBaseband(this); + m_basebandSink->setMessageQueueToChannel(getInputMessageQueue()); + m_basebandSink->setSpectrumSink(&m_spectrumVis); + m_basebandSink->setChannel(this); + m_basebandSink->moveToThread(&m_thread); + + applySettings(QStringList(), m_settings, true); + + m_deviceAPI->addChannelSink(this); + m_deviceAPI->addChannelSinkAPI(this); + + m_networkManager = new QNetworkAccessManager(); + QObject::connect(m_networkManager, &QNetworkAccessManager::finished, this, &SELCALDemod::networkManagerFinished); + QObject::connect(this, &ChannelAPI::indexInDeviceSetChanged, this, &SELCALDemod::handleIndexInDeviceSetChanged); +} + +SELCALDemod::~SELCALDemod() +{ + qDebug("SELCALDemod::~SELCALDemod"); + QObject::disconnect(m_networkManager, &QNetworkAccessManager::finished, this, &SELCALDemod::networkManagerFinished); + delete m_networkManager; + m_deviceAPI->removeChannelSinkAPI(this); + m_deviceAPI->removeChannelSink(this, true, m_settings.m_streamIndex); + + if (m_basebandSink->isRunning()) { + stop(); + } + + delete m_basebandSink; +} + +void SELCALDemod::setDeviceAPI(DeviceAPI *deviceAPI) +{ + if (deviceAPI != m_deviceAPI) + { + m_deviceAPI->removeChannelSinkAPI(this); + m_deviceAPI->removeChannelSink(this, false, m_settings.m_streamIndex); + m_deviceAPI = deviceAPI; + m_deviceAPI->addChannelSink(this, m_settings.m_streamIndex); + m_deviceAPI->addChannelSinkAPI(this); + } +} + +uint32_t SELCALDemod::getNumberOfDeviceStreams() const +{ + return m_deviceAPI->getNbSourceStreams(); +} + +void SELCALDemod::feed(const SampleVector::const_iterator& begin, const SampleVector::const_iterator& end, bool positiveOnly) +{ + (void) positiveOnly; + m_basebandSink->feed(begin, end); +} + +void SELCALDemod::start() +{ + qDebug("SELCALDemod::start"); + + m_basebandSink->reset(); + m_basebandSink->startWork(); + m_thread.start(); + + DSPSignalNotification *dspMsg = new DSPSignalNotification(m_basebandSampleRate, m_centerFrequency); + m_basebandSink->getInputMessageQueue()->push(dspMsg); + + SELCALDemodBaseband::MsgConfigureSELCALDemodBaseband *msg = + SELCALDemodBaseband::MsgConfigureSELCALDemodBaseband::create(QStringList(), m_settings, true); + m_basebandSink->getInputMessageQueue()->push(msg); +} + +void SELCALDemod::stop() +{ + qDebug("SELCALDemod::stop"); + m_basebandSink->stopWork(); + m_thread.quit(); + m_thread.wait(); +} + +bool SELCALDemod::handleMessage(const Message& cmd) +{ + if (MsgConfigureSELCALDemod::match(cmd)) + { + MsgConfigureSELCALDemod& cfg = (MsgConfigureSELCALDemod&)cmd; + qDebug() << "SELCALDemod::handleMessage: MsgConfigureSELCALDemod"; + applySettings(cfg.getSettingsKeys(), cfg.getSettings(), cfg.getForce()); + + return true; + } + else if (DSPSignalNotification::match(cmd)) + { + DSPSignalNotification& notif = (DSPSignalNotification&)cmd; + m_basebandSampleRate = notif.getSampleRate(); + m_centerFrequency = notif.getCenterFrequency(); + // Forward to the sink + DSPSignalNotification *rep = new DSPSignalNotification(notif); // make a copy + qDebug() << "SELCALDemod::handleMessage: DSPSignalNotification"; + m_basebandSink->getInputMessageQueue()->push(rep); + // Forward to GUI if any + if (m_guiMessageQueue) { + m_guiMessageQueue->push(new DSPSignalNotification(notif)); + } + + return true; + } + else if (MsgMessage::match(cmd)) + { + const auto& call = static_cast(cmd).getMessage(); + { + QMutexLocker lock(&m_reportMutex); + m_lastCall = call; + ++m_callCount; + } + if (getMessageQueueToGUI()) { + getMessageQueueToGUI()->push(MsgMessage::create(call)); + } + if (m_settings.m_udpEnabled) + { + QJsonObject json; + json["code"] = call.m_code; + json["utc"] = call.m_dateTime.toString(Qt::ISODateWithMs); + json["frequencyHz"] = call.m_frequency; + json["rssi"] = call.m_rssi; + json["snr"] = call.m_snr; + json["toneOffsetHz"] = call.m_toneFrequencyOffset; + if (m_udpHostAddress.isNull()) { + qWarning() << "SELCALDemod: Unable to send UDP to unresolved address" << m_settings.m_udpAddress; + } else { + m_udpSocket.writeDatagram(QJsonDocument(json).toJson(QJsonDocument::Compact), m_udpHostAddress, m_settings.m_udpPort); + } + } + if (m_logFile.isOpen()) + { + m_logStream << call.m_dateTime.toString(Qt::ISODateWithMs) << "," << call.m_code << "," << call.m_frequency << "," + << call.m_rssi << "," << call.m_snr << "\n"; + m_logStream.flush(); + } + return true; + } + else if (MsgStatus::match(cmd)) + { + const auto& status = static_cast(cmd).getStatus(); + { + QMutexLocker lock(&m_reportMutex); + m_status = status; + } + if (getMessageQueueToGUI()) { + getMessageQueueToGUI()->push(MsgStatus::create(status)); + } + return true; + } + else if (MainCore::MsgChannelDemodQuery::match(cmd)) + { + qDebug() << "SELCALDemod::handleMessage: MsgChannelDemodQuery"; + sendSampleRateToDemodAnalyzer(); + + return true; + } + else + { + return false; + } +} + +void SELCALDemod::setCenterFrequency(qint64 frequency) +{ + SELCALDemodSettings settings = m_settings; + settings.m_inputFrequencyOffset = frequency; + applySettings(QStringList("inputFrequencyOffset"), settings, false); + + if (m_guiMessageQueue) // forward to GUI if any + { + MsgConfigureSELCALDemod *msgToGUI = MsgConfigureSELCALDemod::create(QStringList("inputFrequencyOffset"), settings, false); + m_guiMessageQueue->push(msgToGUI); + } +} + +void SELCALDemod::applySettings(const QStringList& settingsKeys, const SELCALDemodSettings& incomingSettings, bool force) +{ + SELCALDemodSettings settings = incomingSettings; + settings.normalize(); + settings.m_streamIndex = std::min(settings.m_streamIndex, std::max(0, static_cast(getNumberOfDeviceStreams()) - 1)); + qDebug() << "SELCALDemod::applySettings:" << settings.getDebugString(settingsKeys, force); + + if ((settingsKeys.contains("streamIndex") || force) && (settings.m_streamIndex != m_settings.m_streamIndex)) { + if (m_deviceAPI->getSampleMIMO()) // change of stream is possible for MIMO devices only + { + m_deviceAPI->removeChannelSinkAPI(this); + m_deviceAPI->removeChannelSink(this, false, m_settings.m_streamIndex); + m_deviceAPI->addChannelSink(this, settings.m_streamIndex); + m_deviceAPI->addChannelSinkAPI(this); + m_settings.m_streamIndex = settings.m_streamIndex; // make sure ChannelAPI::getStreamIndex() is consistent + emit streamIndexChanged(settings.m_streamIndex); + } + } + + SELCALDemodBaseband::MsgConfigureSELCALDemodBaseband *msg = + SELCALDemodBaseband::MsgConfigureSELCALDemodBaseband::create(settingsKeys, settings, force); + m_basebandSink->getInputMessageQueue()->push(msg); + + if (settings.m_useReverseAPI) + { + bool fullUpdate = + ((settingsKeys.contains("useReverseAPI") && (settings.m_useReverseAPI != m_settings.m_useReverseAPI)) && + settings.m_useReverseAPI) || + (settingsKeys.contains("reverseAPIAddress") && (settings.m_reverseAPIAddress != m_settings.m_reverseAPIAddress)) || + (settingsKeys.contains("reverseAPIPort") && (settings.m_reverseAPIPort != m_settings.m_reverseAPIPort)) || + (settingsKeys.contains("reverseAPIDeviceIndex") && (settings.m_reverseAPIDeviceIndex != m_settings.m_reverseAPIDeviceIndex)) || + (settingsKeys.contains("reverseAPIChannelIndex") && (settings.m_reverseAPIChannelIndex != m_settings.m_reverseAPIChannelIndex)); + webapiReverseSendSettings(settingsKeys, settings, fullUpdate || force); + } + + if ((settingsKeys.contains("logEnabled") && (settings.m_logEnabled != m_settings.m_logEnabled)) || + (settingsKeys.contains("logFilename") && (settings.m_logFilename != m_settings.m_logFilename)) || force) + { + if (m_logFile.isOpen()) + { + m_logStream.flush(); + m_logFile.close(); + } + if (settings.m_logEnabled && !settings.m_logFilename.isEmpty()) + { + m_logFile.setFileName(settings.m_logFilename); + if (m_logFile.open(QIODevice::WriteOnly | QIODevice::Append | QIODevice::Text)) + { + qDebug() << "SELCALDemod::applySettings - Logging to: " << settings.m_logFilename; + bool newFile = m_logFile.size() == 0; + m_logStream.setDevice(&m_logFile); + if (newFile) { + // Write header + m_logStream << "UTC,Code,FrequencyHz,RSSI,SNR\n"; + } + } + else + { + qWarning() << "SELCALDemod::applySettings - Unable to open log file: " << settings.m_logFilename << m_logFile.errorString(); + } + } + } + + bool resolve = (settingsKeys.contains("udpAddress") && (settings.m_udpAddress != m_settings.m_udpAddress)) || force; + + if (force) { + m_settings = settings; + } + else + { + m_settings.applySettings(settingsKeys, settings); + } + + if (resolve) { + resolveUDPAddress(m_settings.m_udpAddress); + } +} + +// The UDP address may be a host name, which is looked up without blocking. +void SELCALDemod::resolveUDPAddress(const QString& address) +{ + m_udpHostAddress = QHostAddress(address); + if (m_udpHostAddress.isNull() && !address.isEmpty()) { + QHostInfo::lookupHost(address, this, &SELCALDemod::udpAddressResolved); + } +} + +void SELCALDemod::udpAddressResolved(const QHostInfo& info) +{ + // Ignore the result of a lookup for an address since replaced + if (info.hostName() != m_settings.m_udpAddress) { + return; + } + if (info.error() != QHostInfo::NoError || info.addresses().isEmpty()) + { + qWarning() << "SELCALDemod::udpAddressResolved: Unable to resolve" << info.hostName() << info.errorString(); + return; + } + // Prefer IPv4, which receivers more commonly listen on + m_udpHostAddress = info.addresses().first(); + for (const auto& address : info.addresses()) + { + if (address.protocol() == QAbstractSocket::IPv4Protocol) + { + m_udpHostAddress = address; + break; + } + } +} + +void SELCALDemod::sendSampleRateToDemodAnalyzer() +{ + QList pipes; + MainCore::instance()->getMessagePipes().getMessagePipes(this, "reportdemod", pipes); + + if (pipes.size() > 0) { + for (const auto& pipe : pipes) + { + MessageQueue *messageQueue = qobject_cast(pipe->m_element); + // Sample rate of the demod stream, which is the audio output rate. + MainCore::MsgChannelDemodReport *msg = MainCore::MsgChannelDemodReport::create(this, getAudioSampleRate()); + messageQueue->push(msg); + } + } +} + +QByteArray SELCALDemod::serialize() const +{ + return m_settings.serialize(); +} + +bool SELCALDemod::deserialize(const QByteArray& data) +{ + if (m_settings.deserialize(data)) + { + MsgConfigureSELCALDemod *msg = MsgConfigureSELCALDemod::create(QStringList(), m_settings, true); + m_inputMessageQueue.push(msg); + return true; + } + else + { + m_settings.resetToDefaults(); + MsgConfigureSELCALDemod *msg = MsgConfigureSELCALDemod::create(QStringList(), m_settings, true); + m_inputMessageQueue.push(msg); + return false; + } +} + +int SELCALDemod::webapiSettingsGet(SWGSDRangel::SWGChannelSettings& response, QString& errorMessage) +{ + (void)errorMessage; + response.setSelcalDemodSettings(new SWGSDRangel::SWGSELCALDemodSettings()); + response.getSelcalDemodSettings()->init(); + webapiFormatChannelSettings(response, m_settings); + return 200; +} + +int SELCALDemod::webapiWorkspaceGet(SWGSDRangel::SWGWorkspaceInfo& response, QString& errorMessage) +{ + (void)errorMessage; + response.setIndex(m_settings.m_workspaceIndex); + return 200; +} + +int SELCALDemod::webapiSettingsPutPatch(bool force, const QStringList& channelSettingsKeys, SWGSDRangel::SWGChannelSettings& response, + QString& errorMessage) +{ + (void)errorMessage; + SELCALDemodSettings settings = m_settings; + webapiUpdateChannelSettings(settings, channelSettingsKeys, response); + settings.m_streamIndex = std::min(settings.m_streamIndex, std::max(0, static_cast(getNumberOfDeviceStreams()) - 1)); + + MsgConfigureSELCALDemod *msg = MsgConfigureSELCALDemod::create(channelSettingsKeys, settings, force); + m_inputMessageQueue.push(msg); + + qDebug("SELCALDemod::webapiSettingsPutPatch: forward to GUI: %p", m_guiMessageQueue); + if (m_guiMessageQueue) // forward to GUI if any + { + MsgConfigureSELCALDemod *msgToGUI = MsgConfigureSELCALDemod::create(channelSettingsKeys, settings, force); + m_guiMessageQueue->push(msgToGUI); + } + + webapiFormatChannelSettings(response, settings); + + return 200; +} + +int SELCALDemod::webapiReportGet(SWGSDRangel::SWGChannelReport& response, QString& errorMessage) +{ + (void)errorMessage; + response.setSelcalDemodReport(new SWGSDRangel::SWGSELCALDemodReport()); + response.getSelcalDemodReport()->init(); + webapiFormatChannelReport(response); + return 200; +} + +void SELCALDemod::webapiUpdateChannelSettings(SELCALDemodSettings& settings, const QStringList& channelSettingsKeys, + SWGSDRangel::SWGChannelSettings& response) +{ + auto *model = response.getSelcalDemodSettings(); + if (!model) { + return; + } + if (channelSettingsKeys.contains("inputFrequencyOffset")) { + settings.m_inputFrequencyOffset = model->getInputFrequencyOffset(); + } + if (channelSettingsKeys.contains("rfBandwidth")) { + settings.m_rfBandwidth = model->getRfBandwidth(); + } + if (channelSettingsKeys.contains("modulation")) { + settings.m_modulation = model->getModulation(); + } + if (channelSettingsKeys.contains("toneFrequencyOffset")) { + settings.m_toneFrequencyOffset = model->getToneFrequencyOffset(); + } + if (channelSettingsKeys.contains("autoToneFrequencyOffset")) { + settings.m_autoToneFrequencyOffset = model->getAutoToneFrequencyOffset() != 0; + } + if (channelSettingsKeys.contains("threshold")) { + settings.m_threshold = model->getThreshold(); + } + if (channelSettingsKeys.contains("volume")) { + settings.m_volume = model->getVolume(); + } + if (channelSettingsKeys.contains("audioMute")) { + settings.m_audioMute = model->getAudioMute(); + } + if (channelSettingsKeys.contains("squelch")) { + settings.m_squelch = model->getSquelch(); + } + if (channelSettingsKeys.contains("audioDeviceName") && model->getAudioDeviceName()) { + settings.m_audioDeviceName = *model->getAudioDeviceName(); + } + if (channelSettingsKeys.contains("filter") && model->getFilter()) { + settings.m_filter = *model->getFilter(); + } + if (channelSettingsKeys.contains("udpEnabled")) { + settings.m_udpEnabled = model->getUdpEnabled(); + } + if (channelSettingsKeys.contains("udpAddress") && model->getUdpAddress()) { + settings.m_udpAddress = *model->getUdpAddress(); + } + if (channelSettingsKeys.contains("udpPort")) { + settings.m_udpPort = model->getUdpPort(); + } + if (channelSettingsKeys.contains("logFilename") && model->getLogFilename()) { + settings.m_logFilename = *model->getLogFilename(); + } + if (channelSettingsKeys.contains("logEnabled")) { + settings.m_logEnabled = model->getLogEnabled(); + } + if (channelSettingsKeys.contains("rgbColor")) { + settings.m_rgbColor = model->getRgbColor(); + } + if (channelSettingsKeys.contains("title") && model->getTitle()) { + settings.m_title = *model->getTitle(); + } + if (channelSettingsKeys.contains("streamIndex")) { + settings.m_streamIndex = model->getStreamIndex(); + } + if (channelSettingsKeys.contains("useReverseAPI")) { + settings.m_useReverseAPI = model->getUseReverseApi(); + } + if (channelSettingsKeys.contains("reverseAPIAddress") && model->getReverseApiAddress()) { + settings.m_reverseAPIAddress = *model->getReverseApiAddress(); + } + if (channelSettingsKeys.contains("reverseAPIPort")) { + settings.m_reverseAPIPort = model->getReverseApiPort(); + } + if (channelSettingsKeys.contains("reverseAPIDeviceIndex")) { + settings.m_reverseAPIDeviceIndex = model->getReverseApiDeviceIndex(); + } + if (channelSettingsKeys.contains("reverseAPIChannelIndex")) { + settings.m_reverseAPIChannelIndex = model->getReverseApiChannelIndex(); + } + if (settings.m_channelMarker && channelSettingsKeys.contains("channelMarker") && model->getChannelMarker()) { + settings.m_channelMarker->updateFrom(channelSettingsKeys, model->getChannelMarker()); + } + if (settings.m_rollupState && channelSettingsKeys.contains("rollupState") && model->getRollupState()) { + settings.m_rollupState->updateFrom(channelSettingsKeys, model->getRollupState()); + } + settings.normalize(); +} + +void SELCALDemod::webapiFormatChannelSettings(SWGSDRangel::SWGChannelSettings& response, const SELCALDemodSettings& settings) +{ + auto *model = response.getSelcalDemodSettings(); + model->setInputFrequencyOffset(settings.m_inputFrequencyOffset); + model->setRfBandwidth(settings.m_rfBandwidth); + model->setModulation(settings.m_modulation); + model->setToneFrequencyOffset(settings.m_toneFrequencyOffset); + model->setAutoToneFrequencyOffset(settings.m_autoToneFrequencyOffset); + model->setThreshold(settings.m_threshold); + model->setVolume(settings.m_volume); + model->setAudioMute(settings.m_audioMute); + model->setSquelch(settings.m_squelch); + model->setAudioDeviceName(new QString(settings.m_audioDeviceName)); + model->setFilter(new QString(settings.m_filter)); + model->setUdpEnabled(settings.m_udpEnabled); + model->setUdpAddress(new QString(settings.m_udpAddress)); + model->setUdpPort(settings.m_udpPort); + model->setLogFilename(new QString(settings.m_logFilename)); + model->setLogEnabled(settings.m_logEnabled); + model->setRgbColor(settings.m_rgbColor); + model->setTitle(new QString(settings.m_title)); + model->setStreamIndex(settings.m_streamIndex); + model->setUseReverseApi(settings.m_useReverseAPI); + model->setReverseApiAddress(new QString(settings.m_reverseAPIAddress)); + model->setReverseApiPort(settings.m_reverseAPIPort); + model->setReverseApiDeviceIndex(settings.m_reverseAPIDeviceIndex); + model->setReverseApiChannelIndex(settings.m_reverseAPIChannelIndex); + if (settings.m_channelMarker) + { + auto *item = new SWGSDRangel::SWGChannelMarker(); + settings.m_channelMarker->formatTo(item); + model->setChannelMarker(item); + } + if (settings.m_rollupState) + { + auto *item = new SWGSDRangel::SWGRollupState(); + settings.m_rollupState->formatTo(item); + model->setRollupState(item); + } +} + +void SELCALDemod::webapiFormatChannelReport(SWGSDRangel::SWGChannelReport& response) +{ + double avg, peak; + int count; + getMagSqLevels(avg, peak, count); + auto *model = response.getSelcalDemodReport(); + model->setChannelPowerDb(CalcDb::dbPower(avg)); + model->setChannelSampleRate(getChannelSampleRate()); + model->setAudioSampleRate(getAudioSampleRate()); + QMutexLocker lock(&m_reportMutex); + model->setState(new QString(SELCALDecoder::stateName(m_status.m_state))); + model->setCarrierLocked(m_status.m_carrierLocked); + model->setSquelchOpen(m_status.m_squelchOpen); + model->setCarrierFrequencyOffset(m_status.m_carrierFrequencyOffset); + model->setToneFrequencyOffset(m_status.m_toneFrequencyOffset); + model->setLastCode(new QString(m_lastCall.m_code)); + model->setLastTimestamp(new QString(m_lastCall.m_dateTime.toString(Qt::ISODateWithMs))); + model->setLastFrequency(m_lastCall.m_frequency); + model->setLastRssi(m_lastCall.m_rssi); + model->setLastSnr(m_lastCall.m_snr); + model->setCallCount(m_callCount); +} + +void SELCALDemod::webapiReverseSendSettings(const QList& channelSettingsKeys, const SELCALDemodSettings& settings, bool force) +{ + SWGSDRangel::SWGChannelSettings *swgChannelSettings = new SWGSDRangel::SWGChannelSettings(); + webapiFormatChannelSettings(channelSettingsKeys, swgChannelSettings, settings, force); + + QString channelSettingsURL = QString("http://%1:%2/sdrangel/deviceset/%3/channel/%4/settings") + .arg(settings.m_reverseAPIAddress) + .arg(settings.m_reverseAPIPort) + .arg(settings.m_reverseAPIDeviceIndex) + .arg(settings.m_reverseAPIChannelIndex); + m_networkRequest.setUrl(QUrl(channelSettingsURL)); + m_networkRequest.setHeader(QNetworkRequest::ContentTypeHeader, "application/json"); + + QBuffer *buffer = new QBuffer(); + buffer->open((QBuffer::ReadWrite)); + buffer->write(swgChannelSettings->asJson().toUtf8()); + buffer->seek(0); + + // Always use PATCH to avoid passing reverse API settings + QNetworkReply *reply = m_networkManager->sendCustomRequest(m_networkRequest, "PATCH", buffer); + buffer->setParent(reply); + + delete swgChannelSettings; +} + +void SELCALDemod::webapiFormatChannelSettings(const QList& channelSettingsKeys, + SWGSDRangel::SWGChannelSettings *swgChannelSettings, const SELCALDemodSettings& settings, + bool force) +{ + swgChannelSettings->setDirection(0); + swgChannelSettings->setOriginatorChannelIndex(getIndexInDeviceSet()); + swgChannelSettings->setOriginatorDeviceSetIndex(getDeviceSetIndex()); + swgChannelSettings->setChannelType(new QString("SELCALDemod")); + auto *model = new SWGSDRangel::SWGSELCALDemodSettings(); + swgChannelSettings->setSelcalDemodSettings(model); + if (force || channelSettingsKeys.contains("inputFrequencyOffset")) { + model->setInputFrequencyOffset(settings.m_inputFrequencyOffset); + } + if (force || channelSettingsKeys.contains("rfBandwidth")) { + model->setRfBandwidth(settings.m_rfBandwidth); + } + if (force || channelSettingsKeys.contains("modulation")) { + model->setModulation(settings.m_modulation); + } + if (force || channelSettingsKeys.contains("toneFrequencyOffset")) { + model->setToneFrequencyOffset(settings.m_toneFrequencyOffset); + } + if (force || channelSettingsKeys.contains("autoToneFrequencyOffset")) { + model->setAutoToneFrequencyOffset(settings.m_autoToneFrequencyOffset); + } + if (force || channelSettingsKeys.contains("threshold")) { + model->setThreshold(settings.m_threshold); + } + if (force || channelSettingsKeys.contains("volume")) { + model->setVolume(settings.m_volume); + } + if (force || channelSettingsKeys.contains("audioMute")) { + model->setAudioMute(settings.m_audioMute); + } + if (force || channelSettingsKeys.contains("squelch")) { + model->setSquelch(settings.m_squelch); + } + if (force || channelSettingsKeys.contains("audioDeviceName")) { + model->setAudioDeviceName(new QString(settings.m_audioDeviceName)); + } + if (force || channelSettingsKeys.contains("filter")) { + model->setFilter(new QString(settings.m_filter)); + } + if (force || channelSettingsKeys.contains("udpEnabled")) { + model->setUdpEnabled(settings.m_udpEnabled); + } + if (force || channelSettingsKeys.contains("udpAddress")) { + model->setUdpAddress(new QString(settings.m_udpAddress)); + } + if (force || channelSettingsKeys.contains("udpPort")) { + model->setUdpPort(settings.m_udpPort); + } + if (force || channelSettingsKeys.contains("logFilename")) { + model->setLogFilename(new QString(settings.m_logFilename)); + } + if (force || channelSettingsKeys.contains("logEnabled")) { + model->setLogEnabled(settings.m_logEnabled); + } + if (force || channelSettingsKeys.contains("rgbColor")) { + model->setRgbColor(settings.m_rgbColor); + } + if (force || channelSettingsKeys.contains("title")) { + model->setTitle(new QString(settings.m_title)); + } + if (force || channelSettingsKeys.contains("streamIndex")) { + model->setStreamIndex(settings.m_streamIndex); + } + if (settings.m_channelMarker && (force || channelSettingsKeys.contains("channelMarker"))) + { + auto *item = new SWGSDRangel::SWGChannelMarker(); + settings.m_channelMarker->formatTo(item); + model->setChannelMarker(item); + } + if (settings.m_rollupState && (force || channelSettingsKeys.contains("rollupState"))) + { + auto *item = new SWGSDRangel::SWGRollupState(); + settings.m_rollupState->formatTo(item); + model->setRollupState(item); + } +} + +void SELCALDemod::networkManagerFinished(QNetworkReply *reply) +{ + QNetworkReply::NetworkError replyError = reply->error(); + + if (replyError) { + qWarning() << "SELCALDemod::networkManagerFinished:" + << " error(" << (int)replyError << "): " << replyError << ": " << reply->errorString(); + } + else + { + QString answer = reply->readAll(); + answer.chop(1); // remove last \n + qDebug("SELCALDemod::networkManagerFinished: reply:\n%s", answer.toStdString().c_str()); + } + + reply->deleteLater(); +} + +void SELCALDemod::handleIndexInDeviceSetChanged(int index) +{ + if (index < 0) { + return; + } + + QString fifoLabel = QString("%1 [%2:%3]").arg(m_channelId).arg(m_deviceAPI->getDeviceSetIndex()).arg(index); + m_basebandSink->setFifoLabel(fifoLabel); +} + +int SELCALDemod::getChannelSampleRate() const +{ + return m_basebandSink ? m_basebandSink->getChannelSampleRate() : 0; +} + +int SELCALDemod::getAudioSampleRate() const +{ + return m_basebandSink->getAudioSampleRate(); +} diff --git a/plugins/channelrx/demodselcal/selcaldemod.h b/plugins/channelrx/demodselcal/selcaldemod.h new file mode 100644 index 000000000..c1667c826 --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemod.h @@ -0,0 +1,181 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#ifndef INCLUDE_SELCALDEMOD_H +#define INCLUDE_SELCALDEMOD_H + +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include "selcalmessages.h" + +#include "dsp/basebandsamplesink.h" +#include "channel/channelapi.h" +#include "dsp/spectrumvis.h" +#include "util/message.h" + +#include "selcaldemodbaseband.h" +#include "selcaldemodsettings.h" + +class QNetworkAccessManager; +class QNetworkReply; +class QThread; +class DeviceAPI; + +class SELCALDemod : public BasebandSampleSink, public ChannelAPI { +public: + class MsgConfigureSELCALDemod : public Message { + MESSAGE_CLASS_DECLARATION + + public: + const SELCALDemodSettings& getSettings() const { return m_settings; } + const QStringList& getSettingsKeys() const { return m_settingsKeys; } + bool getForce() const { return m_force; } + + static MsgConfigureSELCALDemod *create(const QStringList& settingsKeys, const SELCALDemodSettings& settings, bool force) + { + return new MsgConfigureSELCALDemod(settingsKeys, settings, force); + } + + private: + SELCALDemodSettings m_settings; + QStringList m_settingsKeys; + bool m_force; + + MsgConfigureSELCALDemod(const QStringList& settingsKeys, const SELCALDemodSettings& settings, bool force) : + Message(), + m_settings(settings), + m_settingsKeys(settingsKeys), + m_force(force) + { + } + }; + + using MsgMessage = SELCALMessages::MsgCall; + using MsgStatus = SELCALMessages::MsgStatus; + + SELCALDemod(DeviceAPI *deviceAPI); + virtual ~SELCALDemod(); + + virtual void destroy() + { + delete this; + } + + virtual void setDeviceAPI(DeviceAPI *deviceAPI); + + virtual DeviceAPI *getDeviceAPI() + { + return m_deviceAPI; + } + + using BasebandSampleSink::feed; + virtual void feed(const SampleVector::const_iterator& begin, const SampleVector::const_iterator& end, bool po); + virtual void start(); + virtual void stop(); + + virtual void pushMessage(Message *msg) { m_inputMessageQueue.push(msg); } + virtual QString getSinkName() { return objectName(); } + virtual void getIdentifier(QString& id) { id = objectName(); } + virtual QString getIdentifier() const { return objectName(); } + virtual const QString& getURI() const { return getName(); } + virtual void getTitle(QString& title) { title = m_settings.m_title; } + + virtual qint64 getCenterFrequency() const { return m_settings.m_inputFrequencyOffset; } + + int getChannelSampleRate() const override; + int getAudioSampleRate() const override; + virtual void setCenterFrequency(qint64 frequency); + + virtual QByteArray serialize() const; + virtual bool deserialize(const QByteArray& data); + + virtual int getNbSinkStreams() const { return 1; } + virtual int getNbSourceStreams() const { return 0; } + virtual int getStreamIndex() const { return m_settings.m_streamIndex; } + + virtual qint64 getStreamCenterFrequency(int streamIndex, bool sinkElseSource) const + { + (void)streamIndex; + (void)sinkElseSource; + return 0; + } + + virtual int webapiSettingsGet(SWGSDRangel::SWGChannelSettings& response, QString& errorMessage); + virtual int webapiWorkspaceGet(SWGSDRangel::SWGWorkspaceInfo& response, QString& errorMessage); + virtual int webapiSettingsPutPatch(bool force, const QStringList& channelSettingsKeys, SWGSDRangel::SWGChannelSettings& response, + QString& errorMessage); + virtual int webapiReportGet(SWGSDRangel::SWGChannelReport& response, QString& errorMessage); + static void webapiFormatChannelSettings(SWGSDRangel::SWGChannelSettings& response, const SELCALDemodSettings& settings); + static void webapiUpdateChannelSettings(SELCALDemodSettings& settings, const QStringList& channelSettingsKeys, + SWGSDRangel::SWGChannelSettings& response); + + double getMagSq() const { return m_basebandSink->getMagSq(); } + SpectrumVis *getSpectrumVis() { return &m_spectrumVis; } + void getMagSqLevels(double& avg, double& peak, int& nbSamples) { m_basebandSink->getMagSqLevels(avg, peak, nbSamples); } + + uint32_t getNumberOfDeviceStreams() const; + + static const char *const m_channelIdURI; + static const char *const m_channelId; + +private: + DeviceAPI *m_deviceAPI; + QThread m_thread; + SELCALDemodBaseband *m_basebandSink; + SpectrumVis m_spectrumVis; + SELCALDemodSettings m_settings; + int m_basebandSampleRate; //!< stored from device message used when starting baseband sink + qint64 m_centerFrequency; + QUdpSocket m_udpSocket; + QHostAddress m_udpHostAddress; // m_settings.m_udpAddress, resolved + void resolveUDPAddress(const QString& address); + void udpAddressResolved(const QHostInfo& info); + QMutex m_reportMutex; + SELCALMessages::Call m_lastCall; + SELCALMessages::Status m_status; + quint64 m_callCount = 0; + QFile m_logFile; + QTextStream m_logStream; + + QNetworkAccessManager *m_networkManager; + QNetworkRequest m_networkRequest; + + virtual bool handleMessage(const Message& cmd); + void applySettings(const QStringList& settingsKeys, const SELCALDemodSettings& settings, bool force = false); + void sendSampleRateToDemodAnalyzer(); + void webapiReverseSendSettings(const QList& channelSettingsKeys, const SELCALDemodSettings& settings, bool force); + void webapiFormatChannelSettings(const QList& channelSettingsKeys, SWGSDRangel::SWGChannelSettings *swgChannelSettings, + const SELCALDemodSettings& settings, bool force); + void webapiFormatChannelReport(SWGSDRangel::SWGChannelReport& response); + +private slots: + void networkManagerFinished(QNetworkReply *reply); + void handleIndexInDeviceSetChanged(int index); +}; + +#endif // INCLUDE_SELCALDEMOD_H diff --git a/plugins/channelrx/demodselcal/selcaldemodbaseband.cpp b/plugins/channelrx/demodselcal/selcaldemodbaseband.cpp new file mode 100644 index 000000000..8f07efa6f --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodbaseband.cpp @@ -0,0 +1,212 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#include + +#include "dsp/dspcommands.h" +#include "dsp/downchannelizer.h" + +#include "selcaldemodbaseband.h" +#include "dsp/dspengine.h" +#include "audio/audiodevicemanager.h" + +MESSAGE_CLASS_DEFINITION(SELCALDemodBaseband::MsgConfigureSELCALDemodBaseband, Message) + +SELCALDemodBaseband::SELCALDemodBaseband(SELCALDemod *selcalDemod) : + m_sink(selcalDemod), + m_running(false) +{ + qDebug("SELCALDemodBaseband::SELCALDemodBaseband"); + + auto *audio = DSPEngine::instance()->getAudioDeviceManager(); + audio->addAudioSink(m_sink.getAudioFifo(), getInputMessageQueue()); + m_sink.applyAudioSampleRate(audio->getOutputSampleRate()); + m_sampleFifo.setSize(SampleSinkFifo::getSizePolicy(48000)); + m_channelizer = new DownChannelizer(&m_sink); +} + +SELCALDemodBaseband::~SELCALDemodBaseband() +{ + m_inputMessageQueue.clear(); + + DSPEngine::instance()->getAudioDeviceManager()->removeAudioSink(m_sink.getAudioFifo()); + delete m_channelizer; +} + +void SELCALDemodBaseband::reset() +{ + QMutexLocker mutexLocker(&m_mutex); + m_inputMessageQueue.clear(); + m_sampleFifo.reset(); + m_sink.reset(); +} + +void SELCALDemodBaseband::startWork() +{ + QMutexLocker mutexLocker(&m_mutex); + QObject::connect(&m_sampleFifo, &SampleSinkFifo::dataReady, this, &SELCALDemodBaseband::handleData, Qt::QueuedConnection); + connect(&m_inputMessageQueue, SIGNAL(messageEnqueued()), this, SLOT(handleInputMessages())); + m_running = true; +} + +void SELCALDemodBaseband::stopWork() +{ + QMutexLocker mutexLocker(&m_mutex); + disconnect(&m_inputMessageQueue, SIGNAL(messageEnqueued()), this, SLOT(handleInputMessages())); + QObject::disconnect(&m_sampleFifo, &SampleSinkFifo::dataReady, this, &SELCALDemodBaseband::handleData); + m_running = false; +} + +void SELCALDemodBaseband::setChannel(ChannelAPI *channel) +{ + m_sink.setChannel(channel); +} + +void SELCALDemodBaseband::feed(const SampleVector::const_iterator& begin, const SampleVector::const_iterator& end) +{ + m_sampleFifo.write(begin, end); +} + +void SELCALDemodBaseband::handleData() +{ + QMutexLocker mutexLocker(&m_mutex); + + while ((m_sampleFifo.fill() > 0) && (m_inputMessageQueue.size() == 0) && m_channelizer->getBasebandSampleRate()) + { + SampleVector::iterator part1begin; + SampleVector::iterator part1end; + SampleVector::iterator part2begin; + SampleVector::iterator part2end; + + std::size_t count = m_sampleFifo.readBegin(m_sampleFifo.fill(), &part1begin, &part1end, &part2begin, &part2end); + + // first part of FIFO data + if (part1begin != part1end) { + m_channelizer->feed(part1begin, part1end); + } + + // second part of FIFO data (used when block wraps around) + if (part2begin != part2end) { + m_channelizer->feed(part2begin, part2end); + } + + m_sampleFifo.readCommit((unsigned int)count); + } +} + +void SELCALDemodBaseband::handleInputMessages() +{ + Message *message; + + while ((message = m_inputMessageQueue.pop())) + { + if (!handleMessage(*message)) { + qDebug("%s: unhandled message: %s", Q_FUNC_INFO, message->getIdentifier()); + } + delete message; + } +} + +bool SELCALDemodBaseband::handleMessage(const Message& cmd) +{ + if (MsgConfigureSELCALDemodBaseband::match(cmd)) + { + QMutexLocker mutexLocker(&m_mutex); + MsgConfigureSELCALDemodBaseband& cfg = (MsgConfigureSELCALDemodBaseband&)cmd; + qDebug() << "SELCALDemodBaseband::handleMessage: MsgConfigureSELCALDemodBaseband"; + + applySettings(cfg.getSettingsKeys(), cfg.getSettings(), cfg.getForce()); + + return true; + } + else if (DSPSignalNotification::match(cmd)) + { + QMutexLocker mutexLocker(&m_mutex); + DSPSignalNotification& notif = (DSPSignalNotification&)cmd; + qDebug() << "SELCALDemodBaseband::handleMessage: DSPSignalNotification: basebandSampleRate: " << notif.getSampleRate(); + // Queued samples are discarded when the stream changes. The notification sent when the + // channel starts repeats the current stream, and can be handled after the first samples + // have been queued, so they are kept then. + bool changed = (notif.getSampleRate() != m_channelizer->getBasebandSampleRate()) || + (notif.getCenterFrequency() != m_centerFrequency); + m_centerFrequency = notif.getCenterFrequency(); + m_sink.setCenterFrequency(notif.getCenterFrequency()); + setBasebandSampleRate(notif.getSampleRate()); + if (changed) + { + // A call in progress, the carrier measurement and learnt background + // belong to the old stream. + m_sink.reset(); + // We can run with very slow sample rate (E.g. 4k), but we don't want FIFO getting too small + m_sampleFifo.setSize(SampleSinkFifo::getSizePolicy(std::max(notif.getSampleRate(), 48000))); + } + + return true; + } + else if (DSPConfigureAudio::match(cmd)) + { + QMutexLocker lock(&m_mutex); + const auto& audio = static_cast(cmd); + m_sink.applyAudioSampleRate(audio.getSampleRate()); + return true; + } + else + { + return false; + } +} + +void SELCALDemodBaseband::applySettings(const QStringList& settingsKeys, const SELCALDemodSettings& settings, bool force) +{ + if ((settingsKeys.contains("inputFrequencyOffset") && (settings.m_inputFrequencyOffset != m_settings.m_inputFrequencyOffset)) || force) + { + m_channelizer->setChannelization(SELCALDemodSettings::SELCALDEMOD_CHANNEL_SAMPLE_RATE, settings.m_inputFrequencyOffset); + m_sink.applyChannelSettings(m_channelizer->getChannelSampleRate(), m_channelizer->getChannelFrequencyOffset()); + } + + if ((settingsKeys.contains("audioDeviceName") && (settings.m_audioDeviceName != m_settings.m_audioDeviceName)) || force) + { + auto *audio = DSPEngine::instance()->getAudioDeviceManager(); + int index = audio->getOutputDeviceIndex(settings.m_audioDeviceName); + audio->removeAudioSink(m_sink.getAudioFifo()); + audio->addAudioSink(m_sink.getAudioFifo(), getInputMessageQueue(), index); + m_sink.applyAudioSampleRate(audio->getOutputSampleRate(index)); + } + m_sink.applySettings(settingsKeys, settings, force); + + if (force) { + m_settings = settings; + } + else + { + m_settings.applySettings(settingsKeys, settings); + } +} + +int SELCALDemodBaseband::getChannelSampleRate() const +{ + return m_channelizer->getChannelSampleRate(); +} + +void SELCALDemodBaseband::setBasebandSampleRate(int sampleRate) +{ + m_channelizer->setBasebandSampleRate(sampleRate); + m_sink.applyChannelSettings(m_channelizer->getChannelSampleRate(), m_channelizer->getChannelFrequencyOffset()); +} + diff --git a/plugins/channelrx/demodselcal/selcaldemodbaseband.h b/plugins/channelrx/demodselcal/selcaldemodbaseband.h new file mode 100644 index 000000000..bd8fa68ea --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodbaseband.h @@ -0,0 +1,110 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#ifndef INCLUDE_SELCALDEMODBASEBAND_H +#define INCLUDE_SELCALDEMODBASEBAND_H + +#include +#include + +#include "dsp/samplesinkfifo.h" + +#include "util/message.h" +#include "util/messagequeue.h" + +#include "selcaldemodsink.h" + +class DownChannelizer; +class ChannelAPI; +class SELCALDemod; + +class SELCALDemodBaseband : public QObject { + Q_OBJECT +public: + class MsgConfigureSELCALDemodBaseband : public Message { + MESSAGE_CLASS_DECLARATION + + public: + const SELCALDemodSettings& getSettings() const { return m_settings; } + const QStringList& getSettingsKeys() const { return m_settingsKeys; } + bool getForce() const { return m_force; } + + static MsgConfigureSELCALDemodBaseband *create(const QStringList& settingsKeys, const SELCALDemodSettings& settings, bool force) + { + return new MsgConfigureSELCALDemodBaseband(settingsKeys, settings, force); + } + + private: + SELCALDemodSettings m_settings; + QStringList m_settingsKeys; + bool m_force; + + MsgConfigureSELCALDemodBaseband(const QStringList& settingsKeys, const SELCALDemodSettings& settings, bool force) : + Message(), + m_settings(settings), + m_settingsKeys(settingsKeys), + m_force(force) + { + } + }; + + SELCALDemodBaseband(SELCALDemod *selcalDemod); + ~SELCALDemodBaseband(); + void reset(); + void startWork(); + void stopWork(); + void feed(const SampleVector::const_iterator& begin, const SampleVector::const_iterator& end); + + MessageQueue *getInputMessageQueue() { return &m_inputMessageQueue; } //!< Get the queue for asynchronous inbound communication + + // As in other demodulators, these don't wait for the worker, which holds + // the mutex while processing all queued samples. + void getMagSqLevels(double& avg, double& peak, int& nbSamples) { m_sink.getMagSqLevels(avg, peak, nbSamples); } + void setMessageQueueToChannel(MessageQueue *messageQueue) { m_sink.setMessageQueueToChannel(messageQueue); } + void setSpectrumSink(SpectrumVis *spectrumSink) { m_sink.setSpectrumSink(spectrumSink); } + + void setBasebandSampleRate(int sampleRate); + int getChannelSampleRate() const; + int getAudioSampleRate() const { return m_sink.getAudioSampleRate(); } + void setChannel(ChannelAPI *channel); + double getMagSq() const { return m_sink.getMagSq(); } + bool isRunning() const { return m_running; } + + void setFifoLabel(const QString& label) { m_sampleFifo.setLabel(label); } + +private: + SampleSinkFifo m_sampleFifo; + DownChannelizer *m_channelizer; + SELCALDemodSink m_sink; + MessageQueue m_inputMessageQueue; //!< Queue for asynchronous inbound communication + SELCALDemodSettings m_settings; + qint64 m_centerFrequency = -1; //!< From the latest DSPSignalNotification + + bool m_running; + mutable QRecursiveMutex m_mutex; + + bool handleMessage(const Message& cmd); + void applySettings(const QStringList& settingsKeys, const SELCALDemodSettings& settings, bool force = false); + +private slots: + void handleInputMessages(); + void handleData(); //!< Handle data when samples have to be processed +}; + +#endif // INCLUDE_SELCALDEMODBASEBAND_H diff --git a/plugins/channelrx/demodselcal/selcaldemodgui.cpp b/plugins/channelrx/demodselcal/selcaldemodgui.cpp new file mode 100644 index 000000000..5126334dc --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodgui.cpp @@ -0,0 +1,1043 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include + +#include "util/csv.h" +#include "gui/audioselectdialog.h" +#include "gui/crightclickenabler.h" +#include "device/deviceuiset.h" +#include "dsp/dspcommands.h" +#include "dsp/dspengine.h" +#include "audio/audiodevicemanager.h" +#include "gui/basicchannelsettingsdialog.h" +#include "gui/dialogpositioner.h" +#include "gui/messagedialog.h" +#include "gui/glspectrum.h" +#include "dsp/spectrumvis.h" +#include "maincore.h" +#include "util/db.h" + +#include "selcaldemodgui.h" +#include "ui_selcaldemodgui.h" + +SELCALDemodGUI *SELCALDemodGUI::create(PluginAPI *pluginAPI, DeviceUISet *deviceUISet, BasebandSampleSink *rxChannel) +{ + return new SELCALDemodGUI(pluginAPI, deviceUISet, rxChannel); +} + +SELCALDemodGUI::SELCALDemodGUI(PluginAPI *, DeviceUISet *deviceUISet, BasebandSampleSink *rxChannel, QWidget *parent) : + ChannelGUI(parent), + ui(new Ui::SELCALDemodGUI), + m_deviceUISet(deviceUISet), + m_channelMarker(this), + m_selcalDemod(static_cast(rxChannel)) +{ + setAttribute(Qt::WA_DeleteOnClose, true); + m_helpURL = "plugins/channelrx/demodselcal/readme.md"; + ui->setupUi(getRollupContents()); + setSizePolicy(getRollupContents()->sizePolicy()); + m_selcalDemod->setMessageQueueToGUI(getInputMessageQueue()); + + // Spectrum of the audio analysed by the decoder, with the tone frequencies marked. + m_spectrumVis = m_selcalDemod->getSpectrumVis(); + m_spectrumVis->setGLSpectrum(ui->glSpectrum); + ui->spectrumGUI->setBuddies(m_spectrumVis, ui->glSpectrum); + ui->glSpectrum->setCenterFrequency(0); + ui->glSpectrum->setSampleRate(SELCALDemodSettings::SELCALDEMOD_SPECTRUM_SAMPLE_RATE); + ui->glSpectrum->setSsbSpectrum(true); + ui->glSpectrum->setLsbDisplay(false); + SpectrumSettings spectrumSettings = m_spectrumVis->getSettings(); + spectrumSettings.m_ssb = true; + spectrumSettings.m_fftSize = 1024; + spectrumSettings.m_fftWindow = FFTWindow::Hanning; + spectrumSettings.m_averagingMode = SpectrumSettings::AvgModeMoving; + spectrumSettings.m_averagingValue = 1; + spectrumSettings.m_displayWaterfall = true; + spectrumSettings.m_displayMaxHold = false; + spectrumSettings.m_displayHistogram = false; + spectrumSettings.m_displayCurrent = true; + spectrumSettings.m_markersDisplay = SpectrumSettings::MarkersDisplayAnnotations; + m_spectrumVis->getInputMessageQueue()->push(SpectrumVis::MsgConfigureSpectrumVis::create(spectrumSettings, false)); + + ui->deltaFrequency->setColorMapper(ColorMapper(ColorMapper::GrayGold)); + ui->deltaFrequency->setValueRange(false, 7, -9999999, 9999999); + ui->channelPowerMeter->setColorTheme(LevelMeterSignalDB::ColorGreenAndBlue); + auto *audioRightClick = new CRightClickEnabler(ui->audioMute); + connect(audioRightClick, &CRightClickEnabler::rightClick, this, &SELCALDemodGUI::audioSelect); + ui->messages->horizontalHeader()->setSectionsMovable(true); + ui->messages->setColumnWidth(COL_UTC, 175); + ui->messages->setColumnWidth(COL_CODE, 65); + ui->messages->setColumnWidth(COL_REGISTRATION, 90); + ui->messages->setColumnWidth(COL_TYPE, 50); + ui->messages->setColumnWidth(COL_SIDEVIEW, 90); + ui->messages->setColumnWidth(COL_COUNTRY, 45); + ui->messages->setColumnWidth(COL_FREQUENCY, 110); + ui->messages->setColumnWidth(COL_RSSI, 75); + ui->messages->setColumnWidth(COL_SNR, 65); + // Sizes of sideview and flag icons + ui->messages->setIconSize(QSize(85, 20)); + // Keep rows to one line when a code has several aircraft + ui->messages->setWordWrap(false); + ui->messages->setContextMenuPolicy(Qt::CustomContextMenu); + // Right click in the table header to select the columns shown + m_columnMenu = new QMenu(ui->messages); + for (int i = 0; i < SELCALDemodSettings::m_columns; ++i) + { + QAction *action = m_columnMenu->addAction(ui->messages->horizontalHeaderItem(i)->text()); + action->setCheckable(true); + action->setChecked(true); + action->setData(i); + connect(action, &QAction::triggered, this, &SELCALDemodGUI::messages_columnSelectMenuChecked); + } + ui->messages->horizontalHeader()->setContextMenuPolicy(Qt::CustomContextMenu); + AircraftInformation::init(); + connect(&m_selcalDB, &SELCALDB::downloadingURL, this, &SELCALDemodGUI::downloadingURL); + connect(&m_selcalDB, &SELCALDB::downloadError, this, &SELCALDemodGUI::downloadError); + connect(&m_selcalDB, &SELCALDB::downloadProgress, this, &SELCALDemodGUI::downloadProgress); + connect(&m_selcalDB, &SELCALDB::downloadSELCALInformationFinished, this, &SELCALDemodGUI::downloadSELCALInformationFinished); + connect(&m_osnDB, &OsnDB::downloadingURL, this, &SELCALDemodGUI::downloadingURL); + connect(&m_osnDB, &OsnDB::downloadError, this, &SELCALDemodGUI::downloadError); + connect(&m_osnDB, &OsnDB::downloadProgress, this, &SELCALDemodGUI::downloadProgress); + connect(&m_osnDB, &OsnDB::downloadAircraftInformationFinished, this, &SELCALDemodGUI::downloadAircraftInformationFinished); + for (int i = 0; i < SELCALDecoder::m_toneCount; ++i) + { + const auto& tone = SELCALDecoder::tones()[i]; + ui->toneLevels->setItem(i, 0, new QTableWidgetItem(QString(QChar(tone.m_symbol)))); + ui->toneLevels->setItem(i, 1, new QTableWidgetItem(QString::number(tone.m_frequency, 'f', 1))); + ui->toneLevels->setItem(i, 2, new QTableWidgetItem("-")); + } + ui->toneLevels->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch); + m_settings.setChannelMarker(&m_channelMarker); + m_settings.setRollupState(&m_rollupState); + m_settings.setSpectrumGUI(ui->spectrumGUI); + m_channelMarker.setVisible(true); + m_deviceUISet->addChannelMarker(&m_channelMarker); + connect(&m_channelMarker, &ChannelMarker::changedByCursor, this, &SELCALDemodGUI::channelMarkerChangedByCursor); + connect(&m_channelMarker, &ChannelMarker::highlightedByCursor, this, &SELCALDemodGUI::channelMarkerHighlightedByCursor); + connect(getInputMessageQueue(), &MessageQueue::messageEnqueued, this, &SELCALDemodGUI::handleInputMessages); + connect(&MainCore::instance()->getMasterTimer(), &QTimer::timeout, this, &SELCALDemodGUI::tick); + connect(this, &SELCALDemodGUI::customContextMenuRequested, this, &SELCALDemodGUI::onMenuDialogCalled); + // Tone levels start rolled up. The rollup state restores the user's choice. + ui->diagnosticsContainer->hide(); + connect(getRollupContents(), &RollupContents::widgetRolled, this, &SELCALDemodGUI::onWidgetRolled); + displaySettings(); + makeUIConnections(); + applySettings({}, true); + updateToneMarkers(m_settings.m_toneFrequencyOffset, {{-1, -1}}); + loadAircraftInformation(); + getRollupContents()->arrangeRollups(); + m_resizer.enableChildMouseTracking(); +} + +SELCALDemodGUI::~SELCALDemodGUI() +{ + // Rollup child hide events are emitted during QWidget destruction, after + // ChannelGUI has already deleted its title-bar controls. + QObject::disconnect(getRollupContents(), nullptr, this, nullptr); + m_selcalDemod->setMessageQueueToGUI(nullptr); + m_deviceUISet->removeChannelMarker(&m_channelMarker); + delete ui; +} + +void SELCALDemodGUI::destroy() +{ + delete this; +} + +void SELCALDemodGUI::resetToDefaults() +{ + m_settings.resetToDefaults(); + displaySettings(); + applySettings({}, true); +} + +QByteArray SELCALDemodGUI::serialize() const +{ + return m_settings.serialize(); +} + +bool SELCALDemodGUI::deserialize(const QByteArray& data) +{ + bool valid = m_settings.deserialize(data); + displaySettings(); + applySettings({}, true); + return valid; +} + +void SELCALDemodGUI::applySettings(const QStringList& keys, bool force) +{ + if (!m_doApplySettings) { + return; + } + m_settings.normalize(); + { + QSignalBlocker blocker(&m_channelMarker); + m_channelMarker.setCenterFrequency(m_settings.m_inputFrequencyOffset); + bool usb = m_settings.m_modulation == SELCALDemodSettings::USB; + m_channelMarker.setBandwidth(usb ? 2 * m_settings.m_rfBandwidth : m_settings.m_rfBandwidth); + m_channelMarker.setSidebands(usb ? ChannelMarker::usb : ChannelMarker::dsb); + m_channelMarker.setLowCutoff(usb ? 100 : 0); + } + m_selcalDemod->getInputMessageQueue()->push(SELCALDemod::MsgConfigureSELCALDemod::create(keys, m_settings, force)); + updateAbsoluteCenterFrequency(); +} + +void SELCALDemodGUI::displaySettings() +{ + m_doApplySettings = false; + { + QSignalBlocker blocker(&m_channelMarker); + m_channelMarker.setCenterFrequency(m_settings.m_inputFrequencyOffset); + bool usb = m_settings.m_modulation == SELCALDemodSettings::USB; + m_channelMarker.setBandwidth(usb ? 2 * m_settings.m_rfBandwidth : m_settings.m_rfBandwidth); + m_channelMarker.setSidebands(usb ? ChannelMarker::usb : ChannelMarker::dsb); + m_channelMarker.setLowCutoff(usb ? 100 : 0); + m_channelMarker.setTitle(m_settings.m_title); + m_channelMarker.setColor(m_settings.m_rgbColor); + m_channelMarker.clearStreamIndexes(); + m_channelMarker.addStreamIndex(m_settings.m_streamIndex); + } + setTitle(m_settings.m_title); + setWindowTitle(m_settings.m_title); + setTitleColor(m_settings.m_rgbColor); + // Handlers must not change the settings being displayed. For example, the + // modulation handler selects a default bandwidth, and limiting the + // bandwidth slider's range can change its value. + QSignalBlocker deltaFrequencyBlocker(ui->deltaFrequency); + QSignalBlocker modulationBlocker(ui->modulation); + QSignalBlocker rfBandwidthBlocker(ui->rfBandwidth); + QSignalBlocker toneFrequencyOffsetBlocker(ui->toneFrequencyOffset); + QSignalBlocker autoToneFrequencyOffsetBlocker(ui->autoToneFrequencyOffset); + QSignalBlocker thresholdBlocker(ui->threshold); + QSignalBlocker volumeBlocker(ui->volume); + QSignalBlocker audioMuteBlocker(ui->audioMute); + QSignalBlocker squelchBlocker(ui->squelch); + QSignalBlocker filterBlocker(ui->filter); + QSignalBlocker udpEnabledBlocker(ui->udpEnabled); + QSignalBlocker udpPortBlocker(ui->udpPort); + QSignalBlocker logEnableBlocker(ui->logEnable); + ui->deltaFrequency->setValue(m_settings.m_inputFrequencyOffset); + ui->modulation->setCurrentIndex(m_settings.m_modulation); + // Bandwidth in 100 Hz steps + ui->rfBandwidth->setMaximum(m_settings.m_modulation == SELCALDemodSettings::USB ? 36 : 60); + ui->rfBandwidth->setValue(std::lround(m_settings.m_rfBandwidth / 100.0)); + ui->rfBandwidthText->setText(QString("%1 kHz").arg(m_settings.m_rfBandwidth / 1000.0, 0, 'f', 1)); + ui->toneFrequencyOffset->setValue(m_settings.m_toneFrequencyOffset); + ui->autoToneFrequencyOffset->setChecked(m_settings.m_autoToneFrequencyOffset); + ui->autoToneFrequencyOffset->setEnabled(m_settings.m_modulation == SELCALDemodSettings::USB); + SELCALMessages::Status status; + status.m_toneFrequencyOffset = m_settings.m_toneFrequencyOffset; + updateCarrierStatus(status); + ui->threshold->setValue(m_settings.m_threshold); + ui->volume->setValue(std::lround(m_settings.m_volume * 10.0)); + ui->volumeText->setText(QString("%1").arg(m_settings.m_volume, 0, 'f', 1)); + ui->audioMute->setChecked(m_settings.m_audioMute); + ui->squelch->setValue(m_settings.m_squelch); + ui->squelchText->setText(QString("%1 dB").arg(m_settings.m_squelch)); + updateAudioMute(); + ui->filter->setText(m_settings.m_filter); + ui->udpEnabled->setChecked(m_settings.m_udpEnabled); + ui->udpAddress->setText(m_settings.m_udpAddress); + ui->udpPort->setValue(m_settings.m_udpPort); + ui->logEnable->setChecked(m_settings.m_logEnabled); + ui->logFilename->setToolTip(QString(".csv log filename: %1").arg(m_settings.m_logFilename)); + getRollupContents()->restoreState(m_rollupState); + auto *header = ui->messages->horizontalHeader(); + // Place columns in visual order: moving in logical order can displace a + // column restored earlier when the saved permutation contains cycles. + for (int visual = 0; visual < SELCALDemodSettings::m_columns; ++visual) { + for (int logical = 0; logical < SELCALDemodSettings::m_columns; ++logical) { + if (m_settings.m_columnIndexes[logical] == visual) + { + header->moveSection(header->visualIndex(logical), visual); + break; + } + } + } + // Hidden columns have zero size + for (int i = 0; i < SELCALDemodSettings::m_columns; ++i) + { + bool hidden = m_settings.m_columnSizes[i] == 0; + header->setSectionHidden(i, hidden); + m_columnMenu->actions().at(i)->setChecked(!hidden); + if (m_settings.m_columnSizes[i] > 0) { + header->resizeSection(i, m_settings.m_columnSizes[i]); + } + } + filter(); + updateIndexLabel(); + updateAbsoluteCenterFrequency(); + m_doApplySettings = true; +} + +void SELCALDemodGUI::makeUIConnections() +{ + QObject::connect(ui->deltaFrequency, &ValueDialZ::changed, this, &SELCALDemodGUI::on_deltaFrequency_changed); + QObject::connect(ui->modulation, QOverload::of(&QComboBox::currentIndexChanged), this, &SELCALDemodGUI::on_modulation_currentIndexChanged); + QObject::connect(ui->rfBandwidth, &QSlider::valueChanged, this, &SELCALDemodGUI::on_rfBandwidth_valueChanged); + QObject::connect(ui->toneFrequencyOffset, QOverload::of(&QDoubleSpinBox::valueChanged), this, &SELCALDemodGUI::on_toneFrequencyOffset_valueChanged); + QObject::connect(ui->autoToneFrequencyOffset, &ButtonSwitch::toggled, this, &SELCALDemodGUI::on_autoToneFrequencyOffset_toggled); + QObject::connect(ui->threshold, QOverload::of(&QDoubleSpinBox::valueChanged), this, &SELCALDemodGUI::on_threshold_valueChanged); + QObject::connect(ui->volume, &QDial::valueChanged, this, &SELCALDemodGUI::on_volume_valueChanged); + QObject::connect(ui->audioMute, &ButtonSwitch::toggled, this, &SELCALDemodGUI::on_audioMute_toggled); + QObject::connect(ui->squelch, &QDial::valueChanged, this, &SELCALDemodGUI::on_squelch_valueChanged); + QObject::connect(ui->filter, &QLineEdit::textChanged, this, &SELCALDemodGUI::on_filter_textChanged); + QObject::connect(ui->clearTable, &QPushButton::clicked, this, &SELCALDemodGUI::on_clearTable_clicked); + QObject::connect(ui->copy, &QToolButton::clicked, this, &SELCALDemodGUI::copySelection); + QObject::connect(ui->exportCsv, &QToolButton::clicked, this, &SELCALDemodGUI::exportCsv); + QObject::connect(ui->getSELCALDB, &QToolButton::clicked, this, &SELCALDemodGUI::on_getSELCALDB_clicked); + QObject::connect(ui->logEnable, &ButtonSwitch::toggled, this, &SELCALDemodGUI::on_logEnable_toggled); + QObject::connect(ui->logFilename, &QToolButton::clicked, this, &SELCALDemodGUI::on_logFilename_clicked); + QObject::connect(ui->logOpen, &QToolButton::clicked, this, &SELCALDemodGUI::on_logOpen_clicked); + QObject::connect(ui->udpEnabled, &ButtonSwitch::toggled, this, &SELCALDemodGUI::on_udpEnabled_toggled); + QObject::connect(ui->udpAddress, &QLineEdit::editingFinished, this, &SELCALDemodGUI::on_udpAddress_editingFinished); + QObject::connect(ui->udpPort, QOverload::of(&QSpinBox::valueChanged), this, &SELCALDemodGUI::on_udpPort_valueChanged); + QObject::connect(ui->messages->horizontalHeader(), &QHeaderView::sectionMoved, this, &SELCALDemodGUI::messages_sectionMoved); + QObject::connect(ui->messages->horizontalHeader(), &QHeaderView::sectionResized, this, &SELCALDemodGUI::messages_sectionResized); + QObject::connect(ui->messages, &QTableWidget::customContextMenuRequested, this, &SELCALDemodGUI::messages_customContextMenuRequested); + QObject::connect(ui->messages->horizontalHeader(), &QHeaderView::customContextMenuRequested, this, &SELCALDemodGUI::messages_columnSelectMenu); +} + +void SELCALDemodGUI::on_deltaFrequency_changed(qint64 value) +{ + m_settings.m_inputFrequencyOffset = value; + applySettings({"inputFrequencyOffset"}); +} + +void SELCALDemodGUI::on_modulation_currentIndexChanged(int index) +{ + m_settings.m_modulation = index; + m_settings.m_rfBandwidth = index == SELCALDemodSettings::AM ? 6000 : 3000; + displaySettings(); + applySettings({"modulation", "rfBandwidth"}); +} + +void SELCALDemodGUI::on_rfBandwidth_valueChanged(int value) +{ + m_settings.m_rfBandwidth = value * 100; + ui->rfBandwidthText->setText(QString("%1 kHz").arg(value / 10.0, 0, 'f', 1)); + applySettings({"rfBandwidth"}); +} + +void SELCALDemodGUI::on_toneFrequencyOffset_valueChanged(double value) +{ + m_settings.m_toneFrequencyOffset = value; + applySettings({"toneFrequencyOffset"}); +} + +void SELCALDemodGUI::on_autoToneFrequencyOffset_toggled(bool checked) +{ + m_settings.m_autoToneFrequencyOffset = checked; + displaySettings(); + applySettings({"autoToneFrequencyOffset"}); +} + +void SELCALDemodGUI::on_threshold_valueChanged(double value) +{ + m_settings.m_threshold = value; + applySettings({"threshold"}); +} + +void SELCALDemodGUI::on_volume_valueChanged(int value) +{ + m_settings.m_volume = value / 10.0; + ui->volumeText->setText(QString("%1").arg(value / 10.0, 0, 'f', 1)); + applySettings({"volume"}); +} + +void SELCALDemodGUI::on_audioMute_toggled(bool checked) +{ + m_settings.m_audioMute = checked; + applySettings({"audioMute"}); +} + +void SELCALDemodGUI::on_squelch_valueChanged(int value) +{ + m_settings.m_squelch = value; + ui->squelchText->setText(QString("%1 dB").arg(value)); + applySettings({"squelch"}); +} + +void SELCALDemodGUI::on_filter_textChanged(const QString& text) +{ + m_settings.m_filter = text; + filter(); + applySettings({"filter"}); +} + +void SELCALDemodGUI::on_clearTable_clicked() +{ + ui->messages->setRowCount(0); +} + +void SELCALDemodGUI::on_logEnable_toggled(bool checked) +{ + m_settings.m_logEnabled = checked; + applySettings({"logEnabled"}); +} + +void SELCALDemodGUI::on_logFilename_clicked() +{ + QFileDialog dialog(this, "Select file to log received calls to", m_settings.m_logFilename, "CSV files (*.csv)"); + dialog.setDefaultSuffix("csv"); + dialog.setAcceptMode(QFileDialog::AcceptSave); + if (dialog.exec() && !dialog.selectedFiles().isEmpty()) + { + m_settings.m_logFilename = dialog.selectedFiles().first(); + ui->logFilename->setToolTip(QString(".csv log filename: %1").arg(m_settings.m_logFilename)); + applySettings({"logFilename"}); + } +} + +void SELCALDemodGUI::on_logOpen_clicked() +{ + QString filename = QFileDialog::getOpenFileName(this, "Select CSV log to read", m_settings.m_logFilename, "CSV files (*.csv)"); + if (!filename.isEmpty()) { + readLog(filename); + } +} + +void SELCALDemodGUI::on_udpEnabled_toggled(bool checked) +{ + m_settings.m_udpEnabled = checked; + applySettings({"udpEnabled"}); +} + +void SELCALDemodGUI::on_udpAddress_editingFinished() +{ + m_settings.m_udpAddress = ui->udpAddress->text(); + applySettings({"udpAddress"}); +} + +void SELCALDemodGUI::on_udpPort_valueChanged(int value) +{ + m_settings.m_udpPort = value; + applySettings({"udpPort"}); +} + +void SELCALDemodGUI::messages_sectionMoved(int logicalIndex, int oldVisualIndex, int newVisualIndex) +{ + (void) logicalIndex; + (void) oldVisualIndex; + (void) newVisualIndex; + + if (!m_doApplySettings) { + return; + } + for (int i = 0; i < SELCALDemodSettings::m_columns; ++i) { + m_settings.m_columnIndexes[i] = ui->messages->horizontalHeader()->visualIndex(i); + } +} + +void SELCALDemodGUI::messages_sectionResized(int logicalIndex, int oldSize, int newSize) +{ + (void) oldSize; + + if (m_doApplySettings) { + m_settings.m_columnSizes[logicalIndex] = newSize; + } +} + +void SELCALDemodGUI::messageReceived(const SELCALMessages::Call& call, bool update) +{ + ui->lastCode->setText(call.m_code); + ui->lastCode->setToolTip(call.m_dateTime.toString(Qt::ISODateWithMs)); + int row = ui->messages->rowCount(); + ui->messages->insertRow(row); + for (int col = 0; col < SELCALDemodSettings::m_columns; ++col) { + ui->messages->setItem(row, col, new QTableWidgetItem()); + } + // Values are displayed in kHz, but exported in Hz. + auto set = [this, row](int col, const QString& text, const QString& exported) { + ui->messages->item(row, col)->setText(text); + ui->messages->item(row, col)->setData(Qt::UserRole, exported); + }; + QString utc = call.m_dateTime.toString(Qt::ISODateWithMs); + QString rssi = QString::number(call.m_rssi, 'f', 1); + QString snr = QString::number(call.m_snr, 'f', 1); + set(COL_UTC, utc, utc); + set(COL_CODE, call.m_code, call.m_code); + set(COL_FREQUENCY, QString::number(call.m_frequency / 1000.0, 'f', 3), QString::number(call.m_frequency)); + set(COL_RSSI, rssi, rssi); + set(COL_SNR, snr, snr); + lookupAircraft(row); + if (update) + { + filter(); + ui->messages->scrollToBottom(); + } +} + +void SELCALDemodGUI::filter() +{ + QString query = m_settings.m_filter.trimmed().toUpper().remove('-'); + for (int row = 0; row < ui->messages->rowCount(); ++row) + { + QString code = ui->messages->item(row, COL_CODE)->text().remove('-'); + ui->messages->setRowHidden(row, !code.contains(query)); + } +} + +void SELCALDemodGUI::handleInputMessages() +{ + while (auto *message = m_inputMessageQueue.pop()) + { + if (SELCALDemod::MsgConfigureSELCALDemod::match(*message)) + { + const auto& config = static_cast(*message); + if (config.getForce()) + { + // The layout of this window isn't sent to the channel when changed + SELCALDemodSettings settings = config.getSettings(); + settings.m_columnIndexes = m_settings.m_columnIndexes; + settings.m_columnSizes = m_settings.m_columnSizes; + settings.m_workspaceIndex = m_settings.m_workspaceIndex; + settings.m_geometryBytes = m_settings.m_geometryBytes; + settings.m_hidden = m_settings.m_hidden; + m_settings = settings; + } + else + { + m_settings.applySettings(config.getSettingsKeys(), config.getSettings()); + } + // Serializable pointers always belong to this GUI. + m_settings.setChannelMarker(&m_channelMarker); + m_settings.setRollupState(&m_rollupState); + m_settings.setSpectrumGUI(ui->spectrumGUI); + displaySettings(); + } + else if (DSPSignalNotification::match(*message)) + { + const auto& notification = static_cast(*message); + m_deviceCenterFrequency = notification.getCenterFrequency(); + m_basebandSampleRate = notification.getSampleRate(); + ui->deltaFrequency->setValueRange(false, 7, -m_basebandSampleRate / 2, m_basebandSampleRate / 2); + updateAbsoluteCenterFrequency(); + } + else if (SELCALMessages::MsgCall::match(*message)) { + messageReceived(static_cast(*message).getMessage()); + } + else if (SELCALMessages::MsgStatus::match(*message)) + { + const auto& status = static_cast(*message).getStatus(); + m_squelchOpen = status.m_squelchOpen; + updateAudioMute(); + updateCarrierStatus(status); + updateToneMarkers(status.m_toneFrequencyOffset, status.m_pair); + if (!ui->diagnosticsContainer->isHidden()) + { + for (int i = 0; i < SELCALDecoder::m_toneCount; ++i) { + ui->toneLevels->item(i, 2)->setText(QString::number(status.m_levels[i], 'f', 1)); + } + } + } + delete message; + } +} + +QString SELCALDemodGUI::signedHz(double value) +{ + return QString("%1%2 Hz").arg(value >= 0.05 ? "+" : "").arg(value, 0, 'f', 1); +} + +void SELCALDemodGUI::updateCarrierStatus(const SELCALMessages::Status& status) +{ + QString tones = tr("tones %1").arg(signedHz(status.m_toneFrequencyOffset)); + if (m_settings.m_modulation == SELCALDemodSettings::AM) + { + ui->carrierStatus->setText(status.m_carrierLocked ? tr("Coherent AM, carrier %1").arg(signedHz(status.m_carrierFrequencyOffset)) : + tr("Envelope AM, no carrier lock")); + } + else if (!m_settings.m_autoToneFrequencyOffset) { + ui->carrierStatus->setText(tr("Manual, %1").arg(tones)); + } + else if (status.m_carrierLocked) { + ui->carrierStatus->setText(tr("Carrier %1, %2").arg(signedHz(status.m_carrierFrequencyOffset)).arg(tones)); + } + else { + ui->carrierStatus->setText(tr("No carrier, %1").arg(tones)); + } +} + +void SELCALDemodGUI::updateToneMarkers(double offset, const SELCALDecoder::Pair& pair) +{ + // GLSpectrumGUI replaces the markers when its settings change, including + // with markers saved in a preset, so restore them. + const auto& shown = ui->glSpectrum->getAnnotationMarkers(); + bool replaced = shown.size() != m_markers.size(); + for (int i = 0; !replaced && i < shown.size(); ++i) + { + replaced = shown[i].m_startFrequency != m_markers[i].m_startFrequency || shown[i].m_markerColor != m_markers[i].m_markerColor || + shown[i].m_show != m_markers[i].m_show || shown[i].m_text != m_markers[i].m_text; + } + if (!replaced && std::abs(offset - m_markerOffset) < 0.5 && pair == m_markerPair) { + return; + } + m_markerOffset = offset; + m_markerPair = pair; + QList markers; + for (int i = 0; i < SELCALDecoder::m_toneCount; ++i) + { + const auto& tone = SELCALDecoder::tones()[i]; + bool detected = i == pair[0] || i == pair[1]; + markers.append(SpectrumAnnotationMarker(std::llround(tone.m_frequency + offset), 0, detected ? QColor(0, 255, 0) : QColor(160, 160, 160), + detected ? SpectrumAnnotationMarker::ShowFull : SpectrumAnnotationMarker::ShowTop, + QString(QChar(tone.m_symbol)))); + } + ui->glSpectrum->setAnnotationMarkers(markers); + m_markers = markers; +} + +void SELCALDemodGUI::tick() +{ + double avg, peak; + int count; + m_selcalDemod->getMagSqLevels(avg, peak, count); + double power = CalcDb::dbPower(avg); + ui->channelPower->setText(QString::number(power, 'f', 1) + " dB"); + ui->channelPowerMeter->levelChanged((100 + power) / 100, (100 + CalcDb::dbPower(peak)) / 100, count); +} + +void SELCALDemodGUI::updateAbsoluteCenterFrequency() +{ + setStatusFrequency(m_deviceCenterFrequency + m_settings.m_inputFrequencyOffset); +} + +void SELCALDemodGUI::channelMarkerChangedByCursor() +{ + m_settings.m_inputFrequencyOffset = m_channelMarker.getCenterFrequency(); + ui->deltaFrequency->setValue(m_settings.m_inputFrequencyOffset); + applySettings({"inputFrequencyOffset"}); +} + +void SELCALDemodGUI::channelMarkerHighlightedByCursor() +{ + setHighlighted(m_channelMarker.getHighlighted()); +} + +void SELCALDemodGUI::onWidgetRolled(QWidget *widget, bool rollDown) +{ + (void) widget; + (void) rollDown; + + // Rollups change while the saved state is being restored + if (!m_doApplySettings) { + return; + } + + getRollupContents()->saveState(m_rollupState); + applySettings({"rollupState"}); +} + +void SELCALDemodGUI::audioSelect(const QPoint& point) +{ + AudioSelectDialog dialog(DSPEngine::instance()->getAudioDeviceManager(), m_settings.m_audioDeviceName); + dialog.move(point); + new DialogPositioner(&dialog, false); + dialog.exec(); + if (dialog.m_selected) + { + m_settings.m_audioDeviceName = dialog.m_audioDeviceName; + updateAudioMute(); + applySettings({"audioDeviceName"}); + } +} + +void SELCALDemodGUI::updateAudioMute() +{ + ui->audioMute->setToolTip(tr("Mute/unmute audio. Right click to select audio device: %1").arg(m_settings.m_audioDeviceName)); + if (m_squelchOpen) { + ui->audioMute->setColor(QColor(0, 128, 0)); + } + else { + ui->audioMute->resetColor(); + } +} + +void SELCALDemodGUI::readLog(const QString& filename) +{ + QFile file(filename); + if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) + { + QMessageBox::warning(this, "SELCAL log", file.errorString()); + return; + } + QTextStream stream(&file); + QString error; + auto columns = CSV::readHeader(stream, {"UTC", "Code", "FrequencyHz", "RSSI", "SNR"}, error); + if (!error.isEmpty()) + { + QMessageBox::warning(this, "SELCAL log", error); + return; + } + int lastColumn = std::max({columns["UTC"], columns["Code"], columns["FrequencyHz"], columns["RSSI"], columns["SNR"]}); + QStringList values; + ui->messages->setUpdatesEnabled(false); + while (CSV::readRow(stream, &values)) + { + if (values.size() <= lastColumn) { + continue; + } + SELCALMessages::Call call; + call.m_dateTime = QDateTime::fromString(values[columns["UTC"]], Qt::ISODateWithMs); + call.m_code = values[columns["Code"]]; + bool frequencyOK, rssiOK, snrOK; + call.m_frequency = values[columns["FrequencyHz"]].toLongLong(&frequencyOK); + call.m_rssi = values[columns["RSSI"]].toFloat(&rssiOK); + call.m_snr = values[columns["SNR"]].toFloat(&snrOK); + if (call.m_dateTime.isValid() && !call.m_code.isEmpty() && frequencyOK && rssiOK && snrOK && + std::isfinite(call.m_rssi) && std::isfinite(call.m_snr)) { + messageReceived(call, false); + } + } + filter(); + ui->messages->scrollToBottom(); + ui->messages->setUpdatesEnabled(true); +} + +void SELCALDemodGUI::messages_customContextMenuRequested(QPoint pos) +{ + QTableWidgetItem *item = ui->messages->itemAt(pos); + if (!item) { + return; + } + // Image cells have no text, so copy what their tool tip describes + m_cellText = item->text().isEmpty() ? item->toolTip() : item->text(); + if (m_cellText.isEmpty()) { + return; + } + QMenu *menu = new QMenu(ui->messages); + connect(menu, &QMenu::aboutToHide, menu, &QMenu::deleteLater); + QAction *copyAction = menu->addAction("Copy"); + connect(copyAction, &QAction::triggered, this, &SELCALDemodGUI::copyCell); + menu->popup(ui->messages->viewport()->mapToGlobal(pos)); +} + +void SELCALDemodGUI::copyCell() +{ + QGuiApplication::clipboard()->setText(m_cellText); +} + +void SELCALDemodGUI::messages_columnSelectMenu(QPoint pos) +{ + m_columnMenu->popup(ui->messages->horizontalHeader()->viewport()->mapToGlobal(pos)); +} + +// Hiding a column resizes it to zero, which is saved in the settings. +void SELCALDemodGUI::messages_columnSelectMenuChecked(bool checked) +{ + auto *action = qobject_cast(sender()); + if (action) { + ui->messages->setColumnHidden(action->data().toInt(), !checked); + } +} + +void SELCALDemodGUI::copySelection() +{ + QStringList lines; + auto rows = ui->messages->selectionModel()->selectedRows(); + std::sort(rows.begin(), rows.end(), [](const QModelIndex& a, const QModelIndex& b) { + return a.row() < b.row(); + }); + // Columns shown, in the order shown + QList columns; + auto *header = ui->messages->horizontalHeader(); + for (int visual = 0; visual < SELCALDemodSettings::m_columns; ++visual) + { + int col = header->logicalIndex(visual); + // Icons have no text + if (!header->isSectionHidden(col) && (col != COL_SIDEVIEW) && (col != COL_COUNTRY)) { + columns.append(col); + } + } + for (const auto& index : rows) + { + QStringList values; + for (int col : columns) { + values << ui->messages->item(index.row(), col)->text(); + } + lines << values.join('\t'); + } + QApplication::clipboard()->setText(lines.isEmpty() ? ui->lastCode->text() : lines.join('\n')); +} + +void SELCALDemodGUI::exportCsv() +{ + QString filename = QFileDialog::getSaveFileName(this, "Export visible SELCAL calls", "selcal.csv", "CSV files (*.csv)"); + if (filename.isEmpty()) { + return; + } + QFile file(filename); + if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) + { + QMessageBox::warning(this, "SELCAL export", file.errorString()); + return; + } + QTextStream stream(&file); + stream << "UTC,Code,FrequencyHz,RSSI,SNR\n"; + for (int row = 0; row < ui->messages->rowCount(); ++row) + { + if (ui->messages->isRowHidden(row)) { + continue; + } + // Same format as the CSV log + QStringList values; + for (int col : {COL_UTC, COL_CODE, COL_FREQUENCY, COL_RSSI, COL_SNR}) { + values << ui->messages->item(row, col)->data(Qt::UserRole).toString(); + } + stream << values.join(',') << '\n'; + } +} + +// OsnDB caches the aircraft database, and reads it again if it has since been +// downloaded, e.g. by the ADS-B demodulator. It's large, so it's first read +// when the channel is created, rather than when a call is received. +void SELCALDemodGUI::loadAircraftInformation() +{ + m_aircraftInfoByReg = OsnDB::getAircraftInformationByReg(); +} + +void SELCALDemodGUI::lookupAircraft(int row) +{ + loadAircraftInformation(); + + // Codes are not unique, so there can be several aircraft + QStringList registrations = SELCALDB::getRegistrations(ui->messages->item(row, COL_CODE)->text()); + QStringList types; + QStringList details; + const AircraftInformation *first = nullptr; + bool known = false; + + for (const auto& registration : registrations) + { + const AircraftInformation *info = m_aircraftInfoByReg ? m_aircraftInfoByReg->value(registration) : nullptr; + if (info && !info->m_type.isEmpty()) + { + types.append(info->m_type); + known = true; + } + else + { + types.append("?"); + } + if (info) + { + details.append(QString("%1: %2 %3, %4").arg(registration).arg(info->m_manufacturerName).arg(info->m_model).arg(info->m_operator)); + if (!first) { + first = info; + } + } + else + { + details.append(registration); + } + } + + QTableWidgetItem *registrationItem = ui->messages->item(row, COL_REGISTRATION); + QTableWidgetItem *typeItem = ui->messages->item(row, COL_TYPE); + QTableWidgetItem *sideviewItem = ui->messages->item(row, COL_SIDEVIEW); + QTableWidgetItem *countryItem = ui->messages->item(row, COL_COUNTRY); + QString tooltip = details.join("\n"); + registrationItem->setText(registrations.join(", ")); + registrationItem->setToolTip(tooltip); + typeItem->setText(known ? types.join(", ") : QString()); + typeItem->setToolTip(tooltip); + sideviewItem->setIcon(QIcon()); + sideviewItem->setToolTip(QString()); + countryItem->setIcon(QIcon()); + countryItem->setToolTip(QString()); + + if (registrations.isEmpty()) { + return; + } + + // Icons are for the first of the aircraft that is in the aircraft database + if (first) + { + QIcon *icon = AircraftInformation::getSideviewIcon(first->m_registration, first->m_operatorICAO, first->m_type); + if (icon) + { + sideviewItem->setSizeHint(QSize(85, 20)); + sideviewItem->setIcon(*icon); + sideviewItem->setToolTip(first->m_registration); + } + } + + // A flag can be found from the registration prefix alone + AircraftInformation flagInfo; + if (first) { + flagInfo = *first; + } else { + flagInfo.m_registration = registrations.first(); + } + QString flag = flagInfo.getFlag(); + if (!flag.isEmpty()) + { + QIcon *icon = AircraftInformation::getFlagIcon(flag); + if (icon) + { + countryItem->setSizeHint(QSize(40, 20)); + countryItem->setIcon(*icon); + countryItem->setToolTip(flag); + } + } +} + +void SELCALDemodGUI::updateAircraft() +{ + for (int row = 0; row < ui->messages->rowCount(); ++row) { + lookupAircraft(row); + } +} + +void SELCALDemodGUI::on_getSELCALDB_clicked() +{ + // Don't try to download while already in progress + if (m_progressDialog) { + return; + } + + auto download = [this](bool aircraftDB) { + m_downloadAircraftDB = aircraftDB; + m_progressDialog = new QProgressDialog(this); + m_progressDialog->setCancelButton(nullptr); + m_progressDialog->setWindowFlag(Qt::WindowCloseButtonHint, false); + m_selcalDB.downloadSELCALInformation(); + }; + + // Aircraft types and icons also need the aircraft database + loadAircraftInformation(); + if (m_aircraftInfoByReg) + { + download(false); + } + else + { + MessageDialog::question(this, "SELCAL", + "Also download the aircraft database (45MB), to display aircraft types and images?", + QMessageBox::Yes | QMessageBox::No, [download](QMessageBox::StandardButton button) { + download(button == QMessageBox::Yes); + }); + } +} + +void SELCALDemodGUI::downloadingURL(const QString& url) +{ + if (m_progressDialog) + { + m_progressDialog->setLabelText(QString("Downloading %1.").arg(url)); + m_progressDialog->setValue(m_progressDialog->value() + 1); + } +} + +void SELCALDemodGUI::downloadProgress(qint64 bytesRead, qint64 totalBytes) +{ + if (m_progressDialog) + { + m_progressDialog->setMaximum(totalBytes); + m_progressDialog->setValue(bytesRead); + } +} + +void SELCALDemodGUI::downloadError(const QString& error) +{ + MessageDialog::critical(this, "SELCAL", error); + finishDownload(); +} + +void SELCALDemodGUI::downloadSELCALInformationFinished() +{ + if (m_downloadAircraftDB) { + m_osnDB.downloadAircraftInformation(); + } + else + { + finishDownload(); + updateAircraft(); + } +} + +void SELCALDemodGUI::downloadAircraftInformationFinished() +{ + if (m_progressDialog) + { + m_progressDialog->setLabelText("Reading aircraft information."); + QApplication::processEvents(); + } + loadAircraftInformation(); + finishDownload(); + updateAircraft(); +} + +void SELCALDemodGUI::finishDownload() +{ + if (m_progressDialog) + { + m_progressDialog->close(); + delete m_progressDialog; + m_progressDialog = nullptr; + } +} + +void SELCALDemodGUI::onMenuDialogCalled(const QPoint& point) +{ + if (m_contextMenuType == ContextMenuType::ContextMenuChannelSettings) + { + BasicChannelSettingsDialog dialog(&m_channelMarker, this); + dialog.setUseReverseAPI(m_settings.m_useReverseAPI); + dialog.setReverseAPIAddress(m_settings.m_reverseAPIAddress); + dialog.setReverseAPIPort(m_settings.m_reverseAPIPort); + dialog.setReverseAPIDeviceIndex(m_settings.m_reverseAPIDeviceIndex); + dialog.setReverseAPIChannelIndex(m_settings.m_reverseAPIChannelIndex); + dialog.setDefaultTitle(m_displayedName); + if (m_deviceUISet->m_deviceMIMOEngine) + { + dialog.setNumberOfStreams(m_selcalDemod->getNumberOfDeviceStreams()); + dialog.setStreamIndex(m_settings.m_streamIndex); + } + dialog.move(point); + new DialogPositioner(&dialog, false); + dialog.exec(); + m_settings.m_rgbColor = m_channelMarker.getColor().rgb(); + m_settings.m_title = m_channelMarker.getTitle(); + m_settings.m_useReverseAPI = dialog.useReverseAPI(); + m_settings.m_reverseAPIAddress = dialog.getReverseAPIAddress(); + m_settings.m_reverseAPIPort = dialog.getReverseAPIPort(); + m_settings.m_reverseAPIDeviceIndex = dialog.getReverseAPIDeviceIndex(); + m_settings.m_reverseAPIChannelIndex = dialog.getReverseAPIChannelIndex(); + if (m_deviceUISet->m_deviceMIMOEngine) { + m_settings.m_streamIndex = dialog.getSelectedStreamIndex(); + } + displaySettings(); + applySettings({"rgbColor", "title", "useReverseAPI", "reverseAPIAddress", "reverseAPIPort", "reverseAPIDeviceIndex", + "reverseAPIChannelIndex", "streamIndex"}); + } + resetContextMenuType(); +} diff --git a/plugins/channelrx/demodselcal/selcaldemodgui.h b/plugins/channelrx/demodselcal/selcaldemodgui.h new file mode 100644 index 000000000..4c94d7074 --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodgui.h @@ -0,0 +1,169 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#ifndef INCLUDE_SELCALDEMODGUI_H +#define INCLUDE_SELCALDEMODGUI_H + +#include + +#include "channel/channelgui.h" +#include "dsp/channelmarker.h" +#include "dsp/spectrummarkers.h" +#include "util/messagequeue.h" +#include "settings/rollupstate.h" +#include "util/osndb.h" +#include "util/selcaldb.h" +#include "selcaldemod.h" +#include "selcaldemodsettings.h" + +class PluginAPI; +class DeviceUISet; +class BasebandSampleSink; +class SELCALDemod; +class SELCALDemodGUI; + +namespace Ui { +class SELCALDemodGUI; +} +class SpectrumVis; +class QProgressDialog; +class QMenu; +class SELCALDemodGUI; + +class SELCALDemodGUI : public ChannelGUI { + Q_OBJECT + +public: + static SELCALDemodGUI *create(PluginAPI *pluginAPI, DeviceUISet *deviceUISet, BasebandSampleSink *rxChannel); + virtual void destroy(); + + void resetToDefaults(); + QByteArray serialize() const; + bool deserialize(const QByteArray& data); + virtual MessageQueue *getInputMessageQueue() { return &m_inputMessageQueue; } + virtual void setWorkspaceIndex(int index) { m_settings.m_workspaceIndex = index; }; + virtual int getWorkspaceIndex() const { return m_settings.m_workspaceIndex; }; + virtual void setGeometryBytes(const QByteArray& blob) { m_settings.m_geometryBytes = blob; }; + virtual QByteArray getGeometryBytes() const { return m_settings.m_geometryBytes; }; + virtual QString getTitle() const { return m_settings.m_title; }; + virtual QColor getTitleColor() const { return m_settings.m_rgbColor; }; + virtual void zetHidden(bool hidden) { m_settings.m_hidden = hidden; } + virtual bool getHidden() const { return m_settings.m_hidden; } + virtual ChannelMarker& getChannelMarker() { return m_channelMarker; } + virtual int getStreamIndex() const { return m_settings.m_streamIndex; } + virtual void setStreamIndex(int streamIndex) { m_settings.m_streamIndex = streamIndex; } + +public slots: + void channelMarkerChangedByCursor(); + void channelMarkerHighlightedByCursor(); + +private: + // Logical columns of the calls table + enum Column { + COL_UTC, + COL_CODE, + COL_REGISTRATION, + COL_TYPE, + COL_SIDEVIEW, + COL_COUNTRY, + COL_FREQUENCY, + COL_RSSI, + COL_SNR + }; + + Ui::SELCALDemodGUI *ui; + DeviceUISet *m_deviceUISet; + ChannelMarker m_channelMarker; + RollupState m_rollupState; + SELCALDemodSettings m_settings; + SELCALDemod *m_selcalDemod; + SpectrumVis *m_spectrumVis; + MessageQueue m_inputMessageQueue; + double m_markerOffset = 1e9; + SELCALDecoder::Pair m_markerPair{{-1, -1}}; + QList m_markers; // Tone markers last shown + QString m_cellText; // Of the table cell whose context menu is shown + QMenu *m_columnMenu = nullptr; // Selects the table columns shown + qint64 m_deviceCenterFrequency = 0; + int m_basebandSampleRate = 48000; + bool m_doApplySettings = true; + bool m_squelchOpen = false; + SELCALDB m_selcalDB; + OsnDB m_osnDB; + QProgressDialog *m_progressDialog = nullptr; + bool m_downloadAircraftDB = false; + QSharedPointer> m_aircraftInfoByReg; + + explicit SELCALDemodGUI(PluginAPI *pluginAPI, DeviceUISet *deviceUISet, BasebandSampleSink *rxChannel, QWidget *parent = nullptr); + ~SELCALDemodGUI() override; + void applySettings(const QStringList& keys, bool force = false); + void displaySettings(); + void makeUIConnections(); + void loadAircraftInformation(); + void messageReceived(const SELCALMessages::Call& call, bool update = true); + void updateAudioMute(); + void filter(); + void updateAbsoluteCenterFrequency(); + void exportCsv(); + void copySelection(); + void updateCarrierStatus(const SELCALMessages::Status& status); + void updateToneMarkers(double offset, const SELCALDecoder::Pair& pair); + static QString signedHz(double value); + + void lookupAircraft(int row); + void updateAircraft(); + void finishDownload(); +private slots: + void on_getSELCALDB_clicked(); + void downloadingURL(const QString& url); + void downloadProgress(qint64 bytesRead, qint64 totalBytes); + void downloadError(const QString& error); + void downloadSELCALInformationFinished(); + void downloadAircraftInformationFinished(); + void on_deltaFrequency_changed(qint64 value); + void on_modulation_currentIndexChanged(int index); + void on_rfBandwidth_valueChanged(int value); + void on_toneFrequencyOffset_valueChanged(double value); + void on_autoToneFrequencyOffset_toggled(bool checked); + void on_threshold_valueChanged(double value); + void on_volume_valueChanged(int value); + void on_audioMute_toggled(bool checked); + void on_squelch_valueChanged(int value); + void on_filter_textChanged(const QString& text); + void on_clearTable_clicked(); + void on_logEnable_toggled(bool checked); + void on_logFilename_clicked(); + void on_logOpen_clicked(); + void on_udpEnabled_toggled(bool checked); + void on_udpAddress_editingFinished(); + void on_udpPort_valueChanged(int value); + void messages_sectionMoved(int logicalIndex, int oldVisualIndex, int newVisualIndex); + void messages_sectionResized(int logicalIndex, int oldSize, int newSize); + void messages_customContextMenuRequested(QPoint pos); + void copyCell(); + void messages_columnSelectMenu(QPoint pos); + void messages_columnSelectMenuChecked(bool checked); + void handleInputMessages(); + void audioSelect(const QPoint& point); + void readLog(const QString& filename); + void tick(); + void onMenuDialogCalled(const QPoint& point); + void onWidgetRolled(QWidget *widget, bool rollDown); +}; +#endif diff --git a/plugins/channelrx/demodselcal/selcaldemodgui.ui b/plugins/channelrx/demodselcal/selcaldemodgui.ui new file mode 100644 index 000000000..2c720c41d --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodgui.ui @@ -0,0 +1,999 @@ + + + SELCALDemodGUI + + + + 0 + 0 + 640 + 1014 + + + + + 500 + 450 + + + + SELCAL Demodulator + + + + + 0 + 0 + 640 + 218 + + + + + 500 + 200 + + + + Settings + + + + 3 + + + 3 + + + 3 + + + 3 + + + 3 + + + + + + + Δf + + + + + + + + Liberation Mono + 12 + + + + Channel offset from device centre frequency in Hz + + + + + + + Hz + + + + + + + Qt::Orientation::Horizontal + + + + 40 + 20 + + + + + + + + -120.0 dB + + + + + + + + + + + + 0 + 0 + + + + + 170 + 24 + + + + + 16777215 + 24 + + + + + Liberation Mono + 8 + + + + + + + + + + + + + 60 + 0 + + + + + USB + + + + + AM + + + + + + + + BW + + + + + + + USB audio upper cutoff; AM full RF bandwidth + + + 20 + + + 60 + + + 1 + + + 30 + + + Qt::Orientation::Horizontal + + + + + + + + 50 + 0 + + + + USB audio upper cutoff; AM full RF bandwidth + + + 3.0 kHz + + + Qt::AlignmentFlag::AlignRight|Qt::AlignmentFlag::AlignTrailing|Qt::AlignmentFlag::AlignVCenter + + + + + + + + + + + + 24 + 24 + + + + Automatically calculate the USB tone offset from a residual carrier + + + Automatically calculate the USB tone offset from a residual carrier + + + + + + + :/carrier.png:/carrier.png + + + + + + + Tone offset + + + + + + + Expected common offset of the received tones. Without a carrier lock, tones are searched for within +/-6 Hz of this offset. + + + Hz + + + 1 + + + -100.000000000000000 + + + 100.000000000000000 + + + + + + + Threshold + + + + + + + Minimum level of each tone above the noise in a tone bin. Lower values detect weaker calls, but increase false detections. + + + dB + + + 1 + + + 6.000000000000000 + + + 20.000000000000000 + + + 0.500000000000000 + + + 8.000000000000000 + + + + + + + Qt::Orientation::Horizontal + + + + 40 + 20 + + + + + + + + + + + + Searching for carrier + + + + + + + Qt::Orientation::Horizontal + + + + 40 + 20 + + + + + + + + Volume + + + + + + + + 24 + 24 + + + + Monitoring audio volume + + + 100 + + + 1 + + + 1 + + + 10 + + + + + + + + 24 + 0 + + + + Monitoring audio volume + + + 1.0 + + + Qt::AlignmentFlag::AlignRight|Qt::AlignmentFlag::AlignTrailing|Qt::AlignmentFlag::AlignVCenter + + + + + + + Qt::Orientation::Vertical + + + + + + + Sq + + + + + + + + 24 + 24 + + + + Monitoring audio squelch threshold (dBFS) + + + -100 + + + 0 + + + 1 + + + 1 + + + -80 + + + + + + + -80 dB + + + + + + + + 24 + 24 + + + + Mute/unmute audio. Right click to select the audio output device. + + + Mute/unmute audio. Right click to select the audio output device. + + + + + + + :/sound_on.png + :/sound_off.png:/sound_on.png + + + + + + + + + + + + 1000 + 1000 + + + + Send decoded calls via UDP + + + Send decoded calls via UDP + + + UDP + + + + + + + Destination UDP address + + + + + + + : + + + + + + + Destination UDP port + + + 1 + + + 65535 + + + + + + + + + + + Code filter + + + + + + + Enter code to find in table + + + All codes + + + + + + + + 24 + 24 + + + + Copy selected calls + + + Copy selected calls + + + + + + + :/duplicate.png:/duplicate.png + + + + + + + + 24 + 24 + + + + Export visible calls to CSV + + + Export visible calls to CSV + + + + + + + :/export.png:/export.png + + + + + + + + 24 + 16777215 + + + + Start/stop logging of received messages to .csv file + + + + + + + :/record_off.png:/record_off.png + + + + + + + Set log .csv filename + + + + + + + :/save.png:/save.png + + + false + + + + + + + Download the SELCAL code database, used to display the aircraft assigned a code + + + + + + + :/import.png:/import.png + + + + + + + Read messages from .csv log file + + + + + + + :/load.png:/load.png + + + false + + + + + + + + 24 + 24 + + + + Clear received calls + + + Clear received calls + + + + + + + :/bin.png:/bin.png + + + + + + + + + + + 0 + 210 + 640 + 240 + + + + + 500 + 240 + + + + Decoded calls + + + + 3 + + + 3 + + + 3 + + + 3 + + + 3 + + + + + + + + 24 + true + + + + ---- + + + + + + + + + Decoded calls + + + QAbstractItemView::EditTrigger::NoEditTriggers + + + QAbstractItemView::SelectionBehavior::SelectRows + + + + UTC + + + Date and time call was detected + + + + + Code + + + SELCAL code + + + + + Registration + + + Registrations of aircraft assigned the code + + + + + Type + + + Aircraft type designators + + + + + Aircraft + + + + + Country + + + + + Frequency (kHz) + + + Frequency on which code was detected + + + + + RSSI (dB) + + + Received signal strength indication + + + + + SNR (dB) + + + Signal to noise ratio + + + + + + + + + + 0 + 460 + 640 + 260 + + + + + 500 + 260 + + + + Tone levels + + + + 3 + + + 3 + + + 3 + + + 3 + + + 3 + + + + + QAbstractItemView::EditTrigger::NoEditTriggers + + + 32 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Tone + + + + + Frequency (Hz) + + + + + SNR (dB) + + + + + + + + + + 0 + 730 + 640 + 284 + + + + + 0 + 0 + + + + + 500 + 0 + + + + Audio spectrum + + + + 2 + + + 2 + + + 2 + + + 2 + + + 2 + + + + + + 0 + 0 + + + + + 200 + 250 + + + + + Liberation Mono + 8 + + + + + + + + + + + + + RollupContents + QWidget +
gui/rollupcontents.h
+ 1 +
+ + LevelMeterSignalDB + QWidget +
gui/levelmeter.h
+ 1 +
+ + ValueDialZ + QWidget +
gui/valuedialz.h
+ 1 +
+ + ButtonSwitch + QToolButton +
gui/buttonswitch.h
+
+ + GLSpectrum + QWidget +
gui/glspectrum.h
+ 1 +
+ + GLSpectrumGUI + QWidget +
gui/glspectrumgui.h
+ 1 +
+
+ + +
diff --git a/plugins/channelrx/demodselcal/selcaldemodplugin.cpp b/plugins/channelrx/demodselcal/selcaldemodplugin.cpp new file mode 100644 index 000000000..fbd2a83d7 --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodplugin.cpp @@ -0,0 +1,91 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#include +#include "plugin/pluginapi.h" + +#ifndef SERVER_MODE +#include "selcaldemodgui.h" +#endif +#include "selcaldemod.h" +#include "selcaldemodwebapiadapter.h" +#include "selcaldemodplugin.h" + +const PluginDescriptor SELCALDemodPlugin::m_pluginDescriptor = { + SELCALDemod::m_channelId, + QStringLiteral("SELCAL Demodulator"), + QStringLiteral("7.28.0"), + QStringLiteral("(c) Jon Beniston, M7RCE"), + QStringLiteral("https://github.com/f4exb/sdrangel"), + true, + QStringLiteral("https://github.com/f4exb/sdrangel") +}; + +SELCALDemodPlugin::SELCALDemodPlugin(QObject *parent) : + QObject(parent), + m_pluginAPI(0) +{ +} + +const PluginDescriptor& SELCALDemodPlugin::getPluginDescriptor() const +{ + return m_pluginDescriptor; +} + +void SELCALDemodPlugin::initPlugin(PluginAPI *pluginAPI) +{ + m_pluginAPI = pluginAPI; + + m_pluginAPI->registerRxChannel(SELCALDemod::m_channelIdURI, SELCALDemod::m_channelId, this); +} + +void SELCALDemodPlugin::createRxChannel(DeviceAPI *deviceAPI, BasebandSampleSink **bs, ChannelAPI **cs) const +{ + if (bs || cs) + { + SELCALDemod *instance = new SELCALDemod(deviceAPI); + + if (bs) { + *bs = instance; + } + + if (cs) { + *cs = instance; + } + } +} + +#ifdef SERVER_MODE +ChannelGUI *SELCALDemodPlugin::createRxChannelGUI(DeviceUISet *deviceUISet, BasebandSampleSink *rxChannel) const +{ + (void)deviceUISet; + (void)rxChannel; + return 0; +} +#else +ChannelGUI *SELCALDemodPlugin::createRxChannelGUI(DeviceUISet *deviceUISet, BasebandSampleSink *rxChannel) const +{ + return SELCALDemodGUI::create(m_pluginAPI, deviceUISet, rxChannel); +} +#endif + +ChannelWebAPIAdapter *SELCALDemodPlugin::createChannelWebAPIAdapter() const +{ + return new SELCALDemodWebAPIAdapter(); +} diff --git a/plugins/channelrx/demodselcal/selcaldemodplugin.h b/plugins/channelrx/demodselcal/selcaldemodplugin.h new file mode 100644 index 000000000..9215ccd7b --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodplugin.h @@ -0,0 +1,50 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#ifndef INCLUDE_SELCALDEMODPLUGIN_H +#define INCLUDE_SELCALDEMODPLUGIN_H + +#include +#include "plugin/plugininterface.h" + +class DeviceUISet; +class BasebandSampleSink; + +class SELCALDemodPlugin : public QObject, PluginInterface { + Q_OBJECT + Q_INTERFACES(PluginInterface) + Q_PLUGIN_METADATA(IID "sdrangel.channel.selcaldemod") + +public: + explicit SELCALDemodPlugin(QObject *parent = NULL); + + const PluginDescriptor& getPluginDescriptor() const; + void initPlugin(PluginAPI *pluginAPI); + + virtual void createRxChannel(DeviceAPI *deviceAPI, BasebandSampleSink **bs, ChannelAPI **cs) const; + virtual ChannelGUI *createRxChannelGUI(DeviceUISet *deviceUISet, BasebandSampleSink *rxChannel) const; + virtual ChannelWebAPIAdapter *createChannelWebAPIAdapter() const; + +private: + static const PluginDescriptor m_pluginDescriptor; + + PluginAPI *m_pluginAPI; +}; + +#endif // INCLUDE_SELCALDEMODPLUGIN_H diff --git a/plugins/channelrx/demodselcal/selcaldemodsettings.cpp b/plugins/channelrx/demodselcal/selcaldemodsettings.cpp new file mode 100644 index 000000000..67dcb87ca --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodsettings.cpp @@ -0,0 +1,397 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#include + +#include +#include + +#include "audio/audiodevicemanager.h" +#include "settings/serializable.h" +#include "util/simpleserializer.h" + +#include "selcaldemodsettings.h" +#include "selcaldecoder.h" + +SELCALDemodSettings::SELCALDemodSettings() +{ + resetToDefaults(); +} + +void SELCALDemodSettings::resetToDefaults() +{ + m_inputFrequencyOffset = 0; + m_rfBandwidth = 3000.0f; + m_modulation = 0; + m_toneFrequencyOffset = 0.0f; + m_autoToneFrequencyOffset = true; + m_threshold = SELCALDecoder::m_defaultThreshold; + m_volume = 1.0f; + m_audioMute = false; + m_squelch = -80; + m_audioDeviceName = AudioDeviceManager::m_defaultDeviceName; + m_filter = QString(); + m_udpEnabled = false; + m_udpAddress = QStringLiteral("127.0.0.1"); + m_udpPort = 9999; + m_logFilename = QStringLiteral("selcal_log.csv"); + m_logEnabled = false; + m_rgbColor = QColor(181, 230, 29).rgb(); + m_title = QStringLiteral("SELCAL Demodulator"); + m_streamIndex = 0; + m_useReverseAPI = false; + m_reverseAPIAddress = QStringLiteral("127.0.0.1"); + m_reverseAPIPort = 8888; + m_reverseAPIDeviceIndex = 0; + m_reverseAPIChannelIndex = 0; + m_workspaceIndex = 0; + m_geometryBytes = QByteArray(); + m_hidden = false; + m_columnIndexes.clear(); + m_columnSizes.clear(); + for (int i = 0; i < m_columns; ++i) + { + m_columnIndexes.append(i); + m_columnSizes.append(-1); + } +} + +void SELCALDemodSettings::normalize() +{ + m_modulation = m_modulation == AM ? AM : USB; + m_rfBandwidth = std::isfinite(m_rfBandwidth) ? std::clamp(m_rfBandwidth, 2000.0f, 6000.0f) : 3000.0f; + if (m_modulation == USB) { + m_rfBandwidth = std::min(m_rfBandwidth, 3600.0f); + } + m_toneFrequencyOffset = std::isfinite(m_toneFrequencyOffset) ? std::clamp(m_toneFrequencyOffset, -100.0f, 100.0f) : 0; + m_threshold = std::isfinite(m_threshold) ? std::clamp(m_threshold, 6.0f, 20.0f) : static_cast(SELCALDecoder::m_defaultThreshold); + m_volume = std::isfinite(m_volume) ? std::clamp(m_volume, 0.0f, 10.0f) : 1; + m_streamIndex = std::max(0, m_streamIndex); + m_squelch = std::clamp(m_squelch, -100, 0); + + if (!m_udpPort || m_udpPort > 65535) { + m_udpPort = 9999; + } + if (!m_reverseAPIPort || m_reverseAPIPort > 65535) { + m_reverseAPIPort = 8888; + } + + m_reverseAPIDeviceIndex = std::min(m_reverseAPIDeviceIndex, 99u); + m_reverseAPIChannelIndex = std::min(m_reverseAPIChannelIndex, 99u); + if (m_columnIndexes.size() != m_columns || m_columnSizes.size() != m_columns) + { + m_columnIndexes.clear(); + m_columnSizes.clear(); + for (int i = 0; i < m_columns; ++i) + { + m_columnIndexes.append(i); + m_columnSizes.append(-1); + } + } + bool used[m_columns] = {}; + bool valid = true; + for (int i = 0; i < m_columns; ++i) + { + int index = m_columnIndexes[i]; + if (index < 0 || index >= m_columns || used[index]) { + valid = false; + } else { + used[index] = true; + } + m_columnSizes[i] = std::clamp(m_columnSizes[i], -1, 10000); + } + if (!valid) + { + for (int i = 0; i < m_columns; ++i) { + m_columnIndexes[i] = i; + } + } +} + +QByteArray SELCALDemodSettings::serialize() const +{ + SimpleSerializer s(1); + + s.writeS32(1, m_inputFrequencyOffset); + s.writeFloat(2, m_rfBandwidth); + s.writeS32(3, m_modulation); + s.writeFloat(4, m_toneFrequencyOffset); + s.writeBool(30, m_autoToneFrequencyOffset); + s.writeFloat(32, m_threshold); + s.writeFloat(6, m_volume); + s.writeBool(7, m_audioMute); + s.writeS32(31, m_squelch); + s.writeString(8, m_audioDeviceName); + s.writeString(9, m_filter); + s.writeBool(10, m_udpEnabled); + s.writeString(11, m_udpAddress); + s.writeU32(12, m_udpPort); + s.writeString(13, m_logFilename); + s.writeBool(14, m_logEnabled); + s.writeU32(15, m_rgbColor); + s.writeString(16, m_title); + s.writeS32(17, m_streamIndex); + s.writeBool(18, m_useReverseAPI); + s.writeString(19, m_reverseAPIAddress); + s.writeU32(20, m_reverseAPIPort); + s.writeU32(21, m_reverseAPIDeviceIndex); + s.writeU32(22, m_reverseAPIChannelIndex); + s.writeS32(23, m_workspaceIndex); + s.writeBlob(24, m_geometryBytes); + s.writeBool(25, m_hidden); + s.writeList(28, m_columnIndexes); + s.writeList(29, m_columnSizes); + if (m_channelMarker) { + s.writeBlob(40, m_channelMarker->serialize()); + } + if (m_rollupState) { + s.writeBlob(41, m_rollupState->serialize()); + } + if (m_spectrumGUI) { + s.writeBlob(42, m_spectrumGUI->serialize()); + } + return s.final(); +} + +bool SELCALDemodSettings::deserialize(const QByteArray& data) +{ + SimpleDeserializer d(data); + + resetToDefaults(); + + if (!d.isValid() || d.getVersion() != 1) { + return false; + } + + d.readS32(1, &m_inputFrequencyOffset, 0); + d.readFloat(2, &m_rfBandwidth, 3000.0f); + d.readS32(3, &m_modulation, 0); + d.readFloat(4, &m_toneFrequencyOffset, 0.0f); + d.readBool(30, &m_autoToneFrequencyOffset, true); + d.readFloat(32, &m_threshold, SELCALDecoder::m_defaultThreshold); + d.readFloat(6, &m_volume, 1.0f); + d.readBool(7, &m_audioMute, false); + d.readS32(31, &m_squelch, -80); + d.readString(8, &m_audioDeviceName, AudioDeviceManager::m_defaultDeviceName); + d.readString(9, &m_filter, QString()); + d.readBool(10, &m_udpEnabled, false); + d.readString(11, &m_udpAddress, QStringLiteral("127.0.0.1")); + d.readU32(12, &m_udpPort, 9999); + d.readString(13, &m_logFilename, QStringLiteral("selcal_log.csv")); + d.readBool(14, &m_logEnabled, false); + d.readU32(15, &m_rgbColor, QColor(181, 230, 29).rgb()); + d.readString(16, &m_title, QStringLiteral("SELCAL Demodulator")); + d.readS32(17, &m_streamIndex, 0); + d.readBool(18, &m_useReverseAPI, false); + d.readString(19, &m_reverseAPIAddress, QStringLiteral("127.0.0.1")); + d.readU32(20, &m_reverseAPIPort, 8888); + d.readU32(21, &m_reverseAPIDeviceIndex, 0); + d.readU32(22, &m_reverseAPIChannelIndex, 0); + d.readS32(23, &m_workspaceIndex, 0); + d.readBlob(24, &m_geometryBytes); + d.readBool(25, &m_hidden, false); + d.readList(28, &m_columnIndexes); + d.readList(29, &m_columnSizes); + + QByteArray blob; + if (m_channelMarker && d.readBlob(40, &blob)) { + m_channelMarker->deserialize(blob); + } + if (m_rollupState && d.readBlob(41, &blob)) { + m_rollupState->deserialize(blob); + } + if (m_spectrumGUI && d.readBlob(42, &blob)) { + m_spectrumGUI->deserialize(blob); + } + normalize(); + + return true; +} + +void SELCALDemodSettings::applySettings(const QStringList& keys, const SELCALDemodSettings& settings) +{ + if (keys.contains("inputFrequencyOffset")) { + m_inputFrequencyOffset = settings.m_inputFrequencyOffset; + } + if (keys.contains("rfBandwidth")) { + m_rfBandwidth = settings.m_rfBandwidth; + } + if (keys.contains("modulation")) { + m_modulation = settings.m_modulation; + } + if (keys.contains("toneFrequencyOffset")) { + m_toneFrequencyOffset = settings.m_toneFrequencyOffset; + } + if (keys.contains("autoToneFrequencyOffset")) { + m_autoToneFrequencyOffset = settings.m_autoToneFrequencyOffset; + } + if (keys.contains("threshold")) { + m_threshold = settings.m_threshold; + } + if (keys.contains("volume")) { + m_volume = settings.m_volume; + } + if (keys.contains("audioMute")) { + m_audioMute = settings.m_audioMute; + } + if (keys.contains("squelch")) { + m_squelch = settings.m_squelch; + } + if (keys.contains("audioDeviceName")) { + m_audioDeviceName = settings.m_audioDeviceName; + } + if (keys.contains("filter")) { + m_filter = settings.m_filter; + } + if (keys.contains("udpEnabled")) { + m_udpEnabled = settings.m_udpEnabled; + } + if (keys.contains("udpAddress")) { + m_udpAddress = settings.m_udpAddress; + } + if (keys.contains("udpPort")) { + m_udpPort = settings.m_udpPort; + } + if (keys.contains("logFilename")) { + m_logFilename = settings.m_logFilename; + } + if (keys.contains("logEnabled")) { + m_logEnabled = settings.m_logEnabled; + } + if (keys.contains("rgbColor")) { + m_rgbColor = settings.m_rgbColor; + } + if (keys.contains("title")) { + m_title = settings.m_title; + } + if (keys.contains("streamIndex")) { + m_streamIndex = settings.m_streamIndex; + } + if (keys.contains("useReverseAPI")) { + m_useReverseAPI = settings.m_useReverseAPI; + } + if (keys.contains("reverseAPIAddress")) { + m_reverseAPIAddress = settings.m_reverseAPIAddress; + } + if (keys.contains("reverseAPIPort")) { + m_reverseAPIPort = settings.m_reverseAPIPort; + } + if (keys.contains("reverseAPIDeviceIndex")) { + m_reverseAPIDeviceIndex = settings.m_reverseAPIDeviceIndex; + } + if (keys.contains("reverseAPIChannelIndex")) { + m_reverseAPIChannelIndex = settings.m_reverseAPIChannelIndex; + } + if (keys.contains("workspaceIndex")) { + m_workspaceIndex = settings.m_workspaceIndex; + } + if (keys.contains("geometryBytes")) { + m_geometryBytes = settings.m_geometryBytes; + } + if (keys.contains("hidden")) { + m_hidden = settings.m_hidden; + } + normalize(); +} + +QString SELCALDemodSettings::getDebugString(const QStringList& keys, bool force) const +{ + QStringList result; + + if (force || keys.contains("inputFrequencyOffset")) { + result << QString("inputFrequencyOffset: %1").arg(m_inputFrequencyOffset); + } + if (force || keys.contains("rfBandwidth")) { + result << QString("rfBandwidth: %1").arg(m_rfBandwidth); + } + if (force || keys.contains("modulation")) { + result << QString("modulation: %1").arg(m_modulation); + } + if (force || keys.contains("toneFrequencyOffset")) { + result << QString("toneFrequencyOffset: %1").arg(m_toneFrequencyOffset); + } + if (force || keys.contains("autoToneFrequencyOffset")) { + result << QString("autoToneFrequencyOffset: %1").arg(m_autoToneFrequencyOffset); + } + if (force || keys.contains("threshold")) { + result << QString("threshold: %1").arg(m_threshold); + } + if (force || keys.contains("volume")) { + result << QString("volume: %1").arg(m_volume); + } + if (force || keys.contains("audioMute")) { + result << QString("audioMute: %1").arg(m_audioMute); + } + if (force || keys.contains("squelch")) { + result << QString("squelch: %1").arg(m_squelch); + } + if (force || keys.contains("audioDeviceName")) { + result << QString("audioDeviceName: %1").arg(m_audioDeviceName); + } + if (force || keys.contains("filter")) { + result << QString("filter: %1").arg(m_filter); + } + if (force || keys.contains("udpEnabled")) { + result << QString("udpEnabled: %1").arg(m_udpEnabled); + } + if (force || keys.contains("udpAddress")) { + result << QString("udpAddress: %1").arg(m_udpAddress); + } + if (force || keys.contains("udpPort")) { + result << QString("udpPort: %1").arg(m_udpPort); + } + if (force || keys.contains("logFilename")) { + result << QString("logFilename: %1").arg(m_logFilename); + } + if (force || keys.contains("logEnabled")) { + result << QString("logEnabled: %1").arg(m_logEnabled); + } + if (force || keys.contains("rgbColor")) { + result << QString("rgbColor: %1").arg(m_rgbColor); + } + if (force || keys.contains("title")) { + result << QString("title: %1").arg(m_title); + } + if (force || keys.contains("streamIndex")) { + result << QString("streamIndex: %1").arg(m_streamIndex); + } + if (force || keys.contains("useReverseAPI")) { + result << QString("useReverseAPI: %1").arg(m_useReverseAPI); + } + if (force || keys.contains("reverseAPIAddress")) { + result << QString("reverseAPIAddress: %1").arg(m_reverseAPIAddress); + } + if (force || keys.contains("reverseAPIPort")) { + result << QString("reverseAPIPort: %1").arg(m_reverseAPIPort); + } + if (force || keys.contains("reverseAPIDeviceIndex")) { + result << QString("reverseAPIDeviceIndex: %1").arg(m_reverseAPIDeviceIndex); + } + if (force || keys.contains("reverseAPIChannelIndex")) { + result << QString("reverseAPIChannelIndex: %1").arg(m_reverseAPIChannelIndex); + } + if (force || keys.contains("workspaceIndex")) { + result << QString("workspaceIndex: %1").arg(m_workspaceIndex); + } + if (force || keys.contains("hidden")) { + result << QString("hidden: %1").arg(m_hidden); + } + + return result.join(" "); +} diff --git a/plugins/channelrx/demodselcal/selcaldemodsettings.h b/plugins/channelrx/demodselcal/selcaldemodsettings.h new file mode 100644 index 000000000..590f13415 --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodsettings.h @@ -0,0 +1,99 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#ifndef INCLUDE_SELCALDEMODSETTINGS_H +#define INCLUDE_SELCALDEMODSETTINGS_H + +#include +#include +#include + +#include "dsp/dsptypes.h" + +class Serializable; + +struct SELCALDemodSettings { + + enum Modulation { + USB = 0, + AM = 1 + }; + + static constexpr int SELCALDEMOD_CHANNEL_SAMPLE_RATE = 8000; + static constexpr int m_columns = 9; + static constexpr int SELCALDEMOD_SPECTRUM_SAMPLE_RATE = 4000; + + qint32 m_inputFrequencyOffset; + Real m_rfBandwidth; + int m_modulation; + Real m_toneFrequencyOffset; + bool m_autoToneFrequencyOffset; + Real m_threshold; // dB + Real m_volume; + bool m_audioMute; + int m_squelch; + QString m_audioDeviceName; + QString m_filter; + bool m_udpEnabled; + QString m_udpAddress; + quint32 m_udpPort; + QString m_logFilename; + bool m_logEnabled; + quint32 m_rgbColor; + QString m_title; + int m_streamIndex; + bool m_useReverseAPI; + QString m_reverseAPIAddress; + quint32 m_reverseAPIPort; + quint32 m_reverseAPIDeviceIndex; + quint32 m_reverseAPIChannelIndex; + int m_workspaceIndex; + QByteArray m_geometryBytes; + bool m_hidden; + Serializable *m_channelMarker = nullptr; + Serializable *m_rollupState = nullptr; + Serializable *m_spectrumGUI = nullptr; + QList m_columnIndexes; + QList m_columnSizes; + + SELCALDemodSettings(); + void resetToDefaults(); + void normalize(); + QByteArray serialize() const; + bool deserialize(const QByteArray& data); + void applySettings(const QStringList& keys, const SELCALDemodSettings& settings); + QString getDebugString(const QStringList& keys, bool force = false) const; + + void setChannelMarker(Serializable *marker) + { + m_channelMarker = marker; + } + + void setRollupState(Serializable *state) + { + m_rollupState = state; + } + + void setSpectrumGUI(Serializable *spectrumGUI) + { + m_spectrumGUI = spectrumGUI; + } +}; + +#endif diff --git a/plugins/channelrx/demodselcal/selcaldemodsink.cpp b/plugins/channelrx/demodselcal/selcaldemodsink.cpp new file mode 100644 index 000000000..a2c346804 --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodsink.cpp @@ -0,0 +1,536 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#include +#include +#include + +#include "selcaldemodsink.h" +#include "selcalmessages.h" + +#include "dsp/fftfilt.h" +#include "dsp/spectrumvis.h" +#include "util/db.h" +#include "maincore.h" +#include "dsp/datafifo.h" + +SELCALDemodSink::SELCALDemodSink(SELCALDemod *) : + m_audioFifo(48000) +{ + m_demodBuffer.resize(4096); + m_spectrumBuffer.reserve(256); + m_decoder.setSampleHandler([this](float sample) { + if (!m_spectrumSink) { + return; + } + m_spectrumBuffer.emplace_back(static_cast(std::clamp(sample, -1.0f, 1.0f) * SDR_RX_SCALEF), 0); + if (m_spectrumBuffer.size() >= 256) + { + // Real audio, displayed from 0 Hz to half the sample rate (as in FT8DemodSink) + m_spectrumSink->feed(m_spectrumBuffer.begin(), m_spectrumBuffer.end(), true); + m_spectrumBuffer.clear(); + } + }); + m_decoder.setCallHandler([this](const SELCALDecoder::Call& result) { + if (!m_messageQueueToChannel) { + return; + } + SELCALMessages::Call call; + call.m_code = QString::fromStdString(result.m_code); + // Capture frequency at decode time, before a later retune can be applied. + call.m_frequency = m_centerFrequency + m_settings.m_inputFrequencyOffset; + call.m_dateTime = QDateTime::currentDateTimeUtc().addMSecs( + -static_cast((m_audioSampleCount - result.m_startSample) * 1000 / SELCALDecoder::m_sampleRate)); + if (trackingCarrier()) { + call.m_dateTime = call.m_dateTime.addMSecs(-static_cast(m_carrierDelay.size() * 1000 / SELCALDecoder::m_sampleRate)); + } + // Measured over the bursts, excluding the gap. + double first = burstPower(result.m_startSample, result.m_firstEndSample); + double second = burstPower(result.m_secondStartSample, result.m_endSample); + call.m_rssi = CalcDb::dbPower(first > 0 && second > 0 ? (first + second) / 2 : m_lastMagSq); + call.m_snr = result.m_snr; + call.m_toneFrequencyOffset = result.m_frequencyOffset; + m_messageQueueToChannel->push(SELCALMessages::MsgCall::create(call)); + }); + applyChannelSettings(48000, 0, true); + applyAudioSampleRate(48000); +} + +SELCALDemodSink::~SELCALDemodSink() = default; + +void SELCALDemodSink::configureFilter(bool recreate) +{ + // Same fftfilt sideband extraction used by SSBDemodSink. The audio band + // includes the lowest legacy tone and the highest SELCAL-32 tone. Updating + // an existing filter keeps its buffered audio. + if (recreate || !m_filter) { + m_filter = std::make_unique(m_filterLength); + } + if (m_settings.m_modulation == SELCALDemodSettings::USB) { + m_filter->create_filter(100.0f / 8000, m_settings.m_rfBandwidth / 8000); + } + else + { + m_filter->create_dsb_filter(m_settings.m_rfBandwidth / (2 * 8000)); + } +} + +bool SELCALDemodSink::trackingCarrier() const +{ + // AM always has a carrier, used for coherent detection. + return m_settings.m_modulation == SELCALDemodSettings::AM || m_settings.m_autoToneFrequencyOffset; +} + +void SELCALDemodSink::updateDecoderOffset() +{ + double offset = m_settings.m_toneFrequencyOffset; + double uncertainty = 2.0; + if (m_settings.m_modulation == SELCALDemodSettings::USB) + { + // A measured carrier gives the tuning error precisely. Otherwise, + // search for the tones around the manual offset, or around the carrier + // offset for a while after a fade or the end of a transmission. + if (m_settings.m_autoToneFrequencyOffset && m_carrierTracker.locked()) + { + offset = m_carrierOffset; + } + else + { + if (m_settings.m_autoToneFrequencyOffset && m_carrierHoldover > 0) { + offset = m_carrierOffset; + } + uncertainty = SELCALDecoder::m_searchRange; + } + } + if (offset != m_decoderOffset || uncertainty != m_decoderUncertainty) + { + m_decoderOffset = offset; + m_decoderUncertainty = uncertainty; + m_decoder.setFrequencyOffset(offset, uncertainty); + } +} + +void SELCALDemodSink::resetTuning() +{ + // Retuning invalidates the measured carrier and any call in progress, but + // monitoring audio continues uninterrupted. + m_decoderOffset = m_settings.m_toneFrequencyOffset; + m_decoderUncertainty = SELCALDecoder::m_searchRange; + m_decoder.setFrequencyOffset(m_decoderOffset, m_decoderUncertainty); + m_decoder.reset(); + m_carrierTracker.setRange(m_settings.m_modulation == SELCALDemodSettings::AM ? 1000.0 : SELCALCarrierTracker::m_defaultRange); + m_carrierTracker.reset(); + m_carrierOffset = 0; + m_carrierHoldover = 0; + m_carrierTail = 0; + m_carrierNco.setFreq(0, SELCALDecoder::m_sampleRate); + m_carrierPhasor = {}; + m_amCarrier = {}; + restartSampleCount(); + if (m_messageQueueToChannel) + { + SELCALMessages::Status status; + status.m_toneFrequencyOffset = m_decoder.frequencyOffset(); + m_messageQueueToChannel->push(SELCALMessages::MsgStatus::create(status)); + } +} + +void SELCALDemodSink::restartSampleCount() +{ + // Follows a decoder reset, which restarts the decoder's sample count. Keep + // the samples buffered in the receive filter between the counts, and + // discard power history aligned with the old count. + std::uint64_t buffered = m_filterInputCount - m_audioSampleCount; + m_audioSampleCount = 0; + m_filterInputCount = buffered; + m_powerBlocks.fill(0); + m_powerBlockSum = 0; + m_powerBlockSamples = 0; +} + +void SELCALDemodSink::reset() +{ + resetTuning(); + m_carrierDelay.fill({}); + m_carrierDelayPosition = 0; + m_filterInputCount = 0; + m_statusCounter = 0; + m_dc = 0; + m_audioPower = 1e-6; + m_squelchPower = 1e-12; + m_squelchCount = 0; + m_squelchOpen = false; + m_distanceRemain = 0; + m_audioDistanceRemain = 0; + m_demodBufferFill = 0; + m_spectrumBuffer.clear(); + m_audioBuffer.clear(); + m_audioFifo.clear(); + m_magSqSum = m_magSqPeak = 0; + m_magSqCount = 0; + m_lastMagSq = 1e-12; + configureFilter(true); +} + +void SELCALDemodSink::applyChannelSettings(int sampleRate, int frequencyOffset, bool force) +{ + if (sampleRate <= 0) { + return; + } + if (force || sampleRate != m_channelSampleRate) + { + m_channelSampleRate = sampleRate; + m_channelFrequencyOffset = frequencyOffset; + m_nco.setFreq(-frequencyOffset, sampleRate); + m_interpolator.create(16, sampleRate, std::min(3600.0f, sampleRate * 0.45f)); + m_distance = static_cast(sampleRate) / SELCALDecoder::m_sampleRate; + reset(); + } + else if (frequencyOffset != m_channelFrequencyOffset) + { + // As in SSBDemodSink, retuning only moves the NCO. + m_channelFrequencyOffset = frequencyOffset; + m_nco.setFreq(-frequencyOffset, sampleRate); + resetTuning(); + // Audio from before retuning is still in the carrier delay and receive + // filter. Don't learn its steady signals as the new channel's background. + m_decoder.holdLearning((trackingCarrier() ? m_carrierDelay.size() : 0) + 512); + } +} + +void SELCALDemodSink::applySettings(const QStringList& keys, const SELCALDemodSettings& settings, bool force) +{ + SELCALDemodSettings next = m_settings; + + if (force) { + next = settings; + } + else + { + next.applySettings(keys, settings); + } + next.normalize(); + + // Changing modulation or carrier tracking changes the signal path, so restarts it. + // Retuning is applied by applyChannelSettings. + bool changed = force || next.m_modulation != m_settings.m_modulation || next.m_autoToneFrequencyOffset != m_settings.m_autoToneFrequencyOffset || + next.m_streamIndex != m_settings.m_streamIndex; + bool decoderChanged = next.m_toneFrequencyOffset != m_settings.m_toneFrequencyOffset || next.m_threshold != m_settings.m_threshold; + bool bandwidthChanged = next.m_rfBandwidth != m_settings.m_rfBandwidth; + m_squelchLevel = CalcDb::powerFromdB(next.m_squelch); + + m_settings = next; + if (changed) + { + m_decoder.configure(next.m_toneFrequencyOffset, next.m_threshold); + reset(); + } + else + { + if (decoderChanged) + { + // Restarts decoding, keeping the carrier measurement. + m_decoder.configure(next.m_toneFrequencyOffset, next.m_threshold); + restartSampleCount(); + m_decoderOffset = std::numeric_limits::quiet_NaN(); + updateDecoderOffset(); + } + if (bandwidthChanged) { + configureFilter(false); + } + } +} + +void SELCALDemodSink::applyAudioSampleRate(int sampleRate) +{ + if (sampleRate <= 0) { + return; + } + + m_audioSampleRate = sampleRate; + m_audioInterpolator.create(16, 8000, 3300); + m_audioDistance = static_cast(8000) / sampleRate; + m_audioDistanceRemain = 0; + m_demodBufferFill = 0; + m_audioBuffer.clear(); + m_audioFifo.clear(); + + // The demod stream is at the audio rate, so tell the Demod Analyzer and + // Denoiser features of a change, as AMDemodSink does. + if (m_channel) + { + QList pipes; + MainCore::instance()->getMessagePipes().getMessagePipes(m_channel, "reportdemod", pipes); + for (const auto& pipe : pipes) + { + auto *messageQueue = qobject_cast(pipe->m_element); + if (messageQueue) { + messageQueue->push(MainCore::MsgChannelDemodReport::create(m_channel, sampleRate)); + } + } + } +} + +void SELCALDemodSink::feed(const SampleVector::const_iterator& begin, const SampleVector::const_iterator& end) +{ + for (auto it = begin; it != end; ++it) + { + Complex sample(it->real() / static_cast(SDR_RX_SCALEF), it->imag() / static_cast(SDR_RX_SCALEF)); + sample *= m_nco.nextIQ(); + Complex output; + if (m_distance < 1) { + while (!m_interpolator.interpolate(&m_distanceRemain, sample, &output)) + { + processOneSample(output); + m_distanceRemain += m_distance; + } + } + else if (m_interpolator.decimate(&m_distanceRemain, sample, &output)) + { + processOneSample(output); + m_distanceRemain += m_distance; + } + } + if (!m_audioBuffer.empty()) + { + m_audioFifo.write(reinterpret_cast(m_audioBuffer.data()), m_audioBuffer.size()); + m_audioBuffer.clear(); + } +} + +void SELCALDemodSink::processOneSample(const Complex& sample) +{ + bool usb = m_settings.m_modulation == SELCALDemodSettings::USB; + bool tracking = trackingCarrier(); + Complex delayed = sample; + if (tracking) + { + m_carrierTracker.feed(sample); + if (m_carrierTracker.locked() && std::abs(m_carrierTracker.offset() - m_carrierOffset) > 0.05) + { + m_carrierOffset = m_carrierTracker.offset(); + m_carrierNco.setFreq(-m_carrierOffset, SELCALDecoder::m_sampleRate); + } + if (m_carrierTracker.locked()) + { + m_carrierHoldover = m_carrierHoldoverLength; + m_carrierTail = m_carrierDelay.size(); + } + else + { + m_carrierHoldover = std::max(m_carrierHoldover - 1, 0); + m_carrierTail = std::max(m_carrierTail - 1, 0); + } + // Let carrier acquisition precede the corresponding audio. Otherwise + // the first pair could be acquired without the carrier's correction. + delayed = m_carrierDelay[m_carrierDelayPosition]; + m_carrierDelay[m_carrierDelayPosition] = sample; + m_carrierDelayPosition = (m_carrierDelayPosition + 1) % m_carrierDelay.size(); + } + updateDecoderOffset(); + + double power = std::norm(sample); + m_magSqSum += power; + m_magSqPeak = std::max(m_magSqPeak, power); + ++m_magSqCount; + m_lastMagSq += (power - m_lastMagSq) * 0.001; + // Squelch gates the monitoring audio, which is delayed with the carrier. + m_squelchPower += (std::norm(delayed) - m_squelchPower) * 0.01; + + // Power aligned with the decoder's audio, which is delayed with the carrier. + m_powerBlockSum += std::norm(delayed); + ++m_powerBlockSamples; + if (++m_filterInputCount % m_powerBlockSize == 0) + { + m_powerBlocks[(m_filterInputCount / m_powerBlockSize - 1) % m_powerBlocks.size()] = m_powerBlockSum / m_powerBlockSamples; + m_powerBlockSum = 0; + m_powerBlockSamples = 0; + } + + // The carrier is measured ahead of the delayed audio, so the audio still + // contains the carrier for the delay after it is lost. + bool locked = tracking && (m_carrierTracker.locked() || m_carrierTail > 0); + Complex filtered = delayed; + if (locked) + { + Complex rotation = m_carrierNco.nextIQ(); + if (usb) + { + // Remove the measured carrier before sideband extraction. Near +100 Hz + // a strong carrier can otherwise leak through the USB filter's lower + // transition band and overwhelm the two audio tones. + m_carrierPhasor += (filtered * rotation - m_carrierPhasor) * 0.01f; + filtered -= m_carrierPhasor * std::conj(rotation); + } + else + { + // Move the AM carrier to 0 Hz for coherent detection. + filtered *= rotation; + } + } + else + { + m_carrierPhasor = {}; + m_amCarrier = {}; + } + fftfilt::cmplx *output = nullptr; + + int count = usb ? m_filter->runSSB(filtered, &output, true, false) : m_filter->runDSB(filtered, &output, true); + + for (int i = 0; i < count; ++i) + { + float audio; + if (usb) + { + // Recover the real audio from the analytic sideband. + audio = output[i].real() + output[i].imag(); + } + else if (locked) + { + // Coherent AM detection: the component in phase with the carrier. + // Unlike envelope detection, it has no threshold at low SNR and + // rejects the quadrature noise. + m_amCarrier += (output[i] - m_amCarrier) * 0.002f; + float magnitude = std::abs(m_amCarrier); + audio = magnitude > 0 ? (output[i] * std::conj(m_amCarrier)).real() / magnitude : 0; + } + else + { + audio = std::abs(output[i]); + } + // Carrier/DC removal, as in AMDemodSink. + m_dc += (audio - m_dc) * 0.001; + processAudio(audio - m_dc); + } +} + +void SELCALDemodSink::processAudio(float sample) +{ + ++m_audioSampleCount; + m_decoder.feed(sample); + monitor(sample); + + if (++m_statusCounter >= 1600) + { + m_statusCounter = 0; + if (m_messageQueueToChannel) + { + SELCALMessages::Status status; + status.m_state = m_decoder.state(); + status.m_carrierLocked = trackingCarrier() && m_carrierTracker.locked(); + status.m_squelchOpen = m_squelchOpen; + status.m_carrierFrequencyOffset = m_carrierTracker.offset(); + status.m_toneFrequencyOffset = m_decoder.frequencyOffset(); + status.m_pair = m_decoder.pair(); + status.m_levels = m_decoder.levels(); + m_messageQueueToChannel->push(SELCALMessages::MsgStatus::create(status)); + } + } +} + +void SELCALDemodSink::monitor(float sample) +{ + if (m_squelchPower >= m_squelchLevel) { + m_squelchCount = SELCALDecoder::m_sampleRate / 10; + } + else if (m_squelchCount > 0) { + --m_squelchCount; + } + m_squelchOpen = m_squelchCount > 0; + m_audioPower += (sample * sample - m_audioPower) * 0.0005; + float gain = std::min(1000.0, 0.15 / std::sqrt(std::max(m_audioPower, 1e-10))); + Complex input(!m_squelchOpen ? 0 : sample * gain * m_settings.m_volume, 0), output; + auto append = [this](const Complex& value) { + qint16 audio = std::clamp(value.real() * 32768.0f, -32768.0f, 32767.0f); + qint16 heard = m_settings.m_audioMute ? 0 : audio; + m_audioBuffer.push_back({heard, heard}); + if (m_audioBuffer.size() >= 4096) + { + m_audioFifo.write(reinterpret_cast(m_audioBuffer.data()), m_audioBuffer.size()); + m_audioBuffer.clear(); + } + // As in AMDemodSink, the demod stream for the Demod Analyzer and Denoiser + // features carries the monitoring audio before muting. + m_demodBuffer[m_demodBufferFill++] = audio; + if (m_demodBufferFill == m_demodBuffer.size()) { + writeDemod(); + } + }; + if (m_audioDistance < 1) { + while (!m_audioInterpolator.interpolate(&m_audioDistanceRemain, input, &output)) + { + append(output); + m_audioDistanceRemain += m_audioDistance; + } + } + else if (m_audioInterpolator.decimate(&m_audioDistanceRemain, input, &output)) + { + append(output); + m_audioDistanceRemain += m_audioDistance; + } +} + +double SELCALDemodSink::burstPower(std::uint64_t start, std::uint64_t end) const +{ + // Decoder sample indices count the receive filter's output. Overlap-add + // filtering outputs each block for the inputs just received, delayed by the + // linear phase filter's group delay. + constexpr std::uint64_t groupDelay = m_filterLength / 4; + start = start > groupDelay ? start - groupDelay : 0; + end = end > groupDelay ? end - groupDelay : 0; + std::uint64_t blocks = m_filterInputCount / m_powerBlockSize; + std::uint64_t first = start / m_powerBlockSize; + std::uint64_t last = std::min(end / m_powerBlockSize, blocks); + first = std::max(first, blocks > m_powerBlocks.size() ? blocks - m_powerBlocks.size() : 0); + if (end <= start || first >= last) { + return 0; + } + double sum = 0; + for (std::uint64_t block = first; block < last; ++block) { + sum += m_powerBlocks[block % m_powerBlocks.size()]; + } + return sum / (last - first); +} + +void SELCALDemodSink::writeDemod() +{ + if (m_channel) + { + QList pipes; + MainCore::instance()->getDataPipes().getDataPipes(m_channel, "demod", pipes); + for (auto *pipe : pipes) + { + auto *fifo = qobject_cast(pipe->m_element); + if (fifo) { + fifo->write(reinterpret_cast(m_demodBuffer.constData()), m_demodBuffer.size() * sizeof(qint16), + DataFifo::DataTypeI16); + } + } + } + m_demodBufferFill = 0; +} + +void SELCALDemodSink::getMagSqLevels(double& average, double& peak, int& count) +{ + count = m_magSqCount; + average = count ? m_magSqSum / count : m_lastMagSq; + peak = count ? m_magSqPeak : average; + m_magSqSum = m_magSqPeak = 0; + m_magSqCount = 0; +} diff --git a/plugins/channelrx/demodselcal/selcaldemodsink.h b/plugins/channelrx/demodselcal/selcaldemodsink.h new file mode 100644 index 000000000..7db9f23b3 --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodsink.h @@ -0,0 +1,128 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#ifndef INCLUDE_SELCALDEMODSINK_H +#define INCLUDE_SELCALDEMODSINK_H + +#include +#include +#include "dsp/channelsamplesink.h" +#include "dsp/nco.h" +#include "dsp/interpolator.h" +#include "audio/audiofifo.h" +#include "util/messagequeue.h" +#include "selcaldemodsettings.h" +#include "selcaldecoder.h" +#include "selcalcarriertracker.h" + +class fftfilt; +class ChannelAPI; +class SELCALDemod; +class SpectrumVis; + +class SELCALDemodSink : public ChannelSampleSink { +public: + explicit SELCALDemodSink(SELCALDemod *demod = nullptr); + ~SELCALDemodSink(); + + void feed(const SampleVector::const_iterator& begin, const SampleVector::const_iterator& end) override; + void applyChannelSettings(int sampleRate, int frequencyOffset, bool force = false); + void applySettings(const QStringList& keys, const SELCALDemodSettings& settings, bool force = false); + void applyAudioSampleRate(int sampleRate); + void reset(); + + void setMessageQueueToChannel(MessageQueue *queue) { m_messageQueueToChannel = queue; } + void setChannel(ChannelAPI *channel) { m_channel = channel; } + void setCenterFrequency(qint64 frequency) { m_centerFrequency = frequency; } + void setSpectrumSink(SpectrumVis *spectrumSink) { m_spectrumSink = spectrumSink; } + AudioFifo *getAudioFifo() { return &m_audioFifo; } + int getAudioSampleRate() const { return m_audioSampleRate; } + double getMagSq() const { return m_lastMagSq; } + void getMagSqLevels(double& average, double& peak, int& count); + +private: + SELCALDemodSettings m_settings; + ChannelAPI *m_channel = nullptr; + MessageQueue *m_messageQueueToChannel = nullptr; + qint64 m_centerFrequency = 0; + int m_channelSampleRate = 48000; + int m_channelFrequencyOffset = 0; + NCO m_nco; + Interpolator m_interpolator; + Real m_distance = 6; + Real m_distanceRemain = 0; + std::unique_ptr m_filter; + SELCALDecoder m_decoder; + double m_decoderOffset = 0; + double m_decoderUncertainty = 0; + SELCALCarrierTracker m_carrierTracker; + double m_carrierOffset = 0; + int m_carrierHoldover = 0; // Samples for which the last carrier offset is still used + int m_carrierTail = 0; // Delayed samples still to be processed with the lost carrier + NCO m_carrierNco; + Complex m_carrierPhasor{}; + Complex m_amCarrier{}; + std::array m_carrierDelay{}; + int m_carrierDelayPosition = 0; + SpectrumVis *m_spectrumSink = nullptr; + SampleVector m_spectrumBuffer; + double m_dc = 0; + double m_audioPower = 1e-6; + double m_squelchLevel = 1e-8; + double m_squelchPower = 1e-12; + int m_squelchCount = 0; + bool m_squelchOpen = false; + double m_magSqSum = 0; + double m_magSqPeak = 0; + double m_lastMagSq = 1e-12; + int m_magSqCount = 0; + std::uint64_t m_audioSampleCount = 0; + + // Received power in 10 ms blocks, to measure the RSSI of each call's bursts. + static constexpr int m_powerBlockSize = 80; + static constexpr int m_filterLength = 512; // FFT length of the receive filter + static constexpr int m_carrierHoldoverLength = 10 * SELCALDecoder::m_sampleRate; // 10 s + + std::array m_powerBlocks{}; + double m_powerBlockSum = 0; + int m_powerBlockSamples = 0; + std::uint64_t m_filterInputCount = 0; + int m_statusCounter = 0; + AudioFifo m_audioFifo; + AudioVector m_audioBuffer; + int m_audioSampleRate = 48000; + Interpolator m_audioInterpolator; + Real m_audioDistance = 1.0f / 6; + Real m_audioDistanceRemain = 0; + QVector m_demodBuffer; + int m_demodBufferFill = 0; + + void processOneSample(const Complex& sample); + void processAudio(float sample); + void monitor(float sample); + void writeDemod(); + void configureFilter(bool recreate); + void resetTuning(); + void restartSampleCount(); + double burstPower(std::uint64_t start, std::uint64_t end) const; + bool trackingCarrier() const; + void updateDecoderOffset(); +}; + +#endif diff --git a/plugins/channelrx/demodselcal/selcaldemodwebapiadapter.cpp b/plugins/channelrx/demodselcal/selcaldemodwebapiadapter.cpp new file mode 100644 index 000000000..3cfa444c8 --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodwebapiadapter.cpp @@ -0,0 +1,52 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#include "SWGChannelSettings.h" +#include "selcaldemod.h" +#include "selcaldemodwebapiadapter.h" + +SELCALDemodWebAPIAdapter::SELCALDemodWebAPIAdapter() +{ +} + +SELCALDemodWebAPIAdapter::~SELCALDemodWebAPIAdapter() +{ +} + +int SELCALDemodWebAPIAdapter::webapiSettingsGet(SWGSDRangel::SWGChannelSettings& response, QString& errorMessage) +{ + (void)errorMessage; + + response.setSelcalDemodSettings(new SWGSDRangel::SWGSELCALDemodSettings()); + response.getSelcalDemodSettings()->init(); + SELCALDemod::webapiFormatChannelSettings(response, m_settings); + + return 200; +} + +int SELCALDemodWebAPIAdapter::webapiSettingsPutPatch(bool force, const QStringList& channelSettingsKeys, + SWGSDRangel::SWGChannelSettings& response, QString& errorMessage) +{ + (void)force; + (void)errorMessage; + + SELCALDemod::webapiUpdateChannelSettings(m_settings, channelSettingsKeys, response); + + return 200; +} diff --git a/plugins/channelrx/demodselcal/selcaldemodwebapiadapter.h b/plugins/channelrx/demodselcal/selcaldemodwebapiadapter.h new file mode 100644 index 000000000..b2d948cc8 --- /dev/null +++ b/plugins/channelrx/demodselcal/selcaldemodwebapiadapter.h @@ -0,0 +1,50 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#ifndef INCLUDE_SELCALDEMOD_WEBAPIADAPTER_H +#define INCLUDE_SELCALDEMOD_WEBAPIADAPTER_H + +#include "channel/channelwebapiadapter.h" +#include "selcaldemodsettings.h" + +class SELCALDemodWebAPIAdapter : public ChannelWebAPIAdapter { +public: + SELCALDemodWebAPIAdapter(); + virtual ~SELCALDemodWebAPIAdapter(); + + virtual QByteArray serialize() const + { + return m_settings.serialize(); + } + + virtual bool deserialize(const QByteArray& data) + { + return m_settings.deserialize(data); + } + + virtual int webapiSettingsGet(SWGSDRangel::SWGChannelSettings& response, QString& errorMessage); + + virtual int webapiSettingsPutPatch(bool force, const QStringList& channelSettingsKeys, SWGSDRangel::SWGChannelSettings& response, + QString& errorMessage); + +private: + SELCALDemodSettings m_settings; +}; + +#endif // INCLUDE_SELCALDEMOD_WEBAPIADAPTER_H diff --git a/plugins/channelrx/demodselcal/selcalmessages.cpp b/plugins/channelrx/demodselcal/selcalmessages.cpp new file mode 100644 index 000000000..8f41c2211 --- /dev/null +++ b/plugins/channelrx/demodselcal/selcalmessages.cpp @@ -0,0 +1,22 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#include "selcalmessages.h" + +MESSAGE_CLASS_DEFINITION(SELCALMessages::MsgCall, Message) +MESSAGE_CLASS_DEFINITION(SELCALMessages::MsgStatus, Message) diff --git a/plugins/channelrx/demodselcal/selcalmessages.h b/plugins/channelrx/demodselcal/selcalmessages.h new file mode 100644 index 000000000..188711e3b --- /dev/null +++ b/plugins/channelrx/demodselcal/selcalmessages.h @@ -0,0 +1,97 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2021-2022 Edouard Griffiths, F4EXB // +// Copyright (C) 2026 Jon Beniston, M7RCE // +// Some code by AI // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#ifndef INCLUDE_SELCALMESSAGES_H +#define INCLUDE_SELCALMESSAGES_H + +#include +#include + +#include "util/message.h" + +#include "selcaldecoder.h" + +namespace SELCALMessages { + +struct Call { + QString m_code; + QDateTime m_dateTime; + qint64 m_frequency = 0; + float m_rssi = -120; + float m_snr = 0; // dB, weaker tone relative to the noise in a tone bin + float m_toneFrequencyOffset = 0; // Hz, measured from the tones +}; + +struct Status { + SELCALDecoder::State m_state = SELCALDecoder::State::Idle; + std::array m_levels{}; // dB relative to noise + SELCALDecoder::Pair m_pair{{-1, -1}}; + bool m_carrierLocked = false; + bool m_squelchOpen = false; + double m_carrierFrequencyOffset = 0; + double m_toneFrequencyOffset = 0; +}; + +class MsgCall : public Message { + MESSAGE_CLASS_DECLARATION +public: + static MsgCall *create(const Call& call) + { + return new MsgCall(call); + } + + const Call& getMessage() const + { + return m_call; + } + +private: + explicit MsgCall(const Call& call) : + m_call(call) + { + } + + Call m_call; +}; + +class MsgStatus : public Message { + MESSAGE_CLASS_DECLARATION +public: + static MsgStatus *create(const Status& status) + { + return new MsgStatus(status); + } + + const Status& getStatus() const + { + return m_status; + } + +private: + explicit MsgStatus(const Status& status) : + m_status(status) + { + } + + Status m_status; +}; + +} // namespace SELCALMessages + +#endif diff --git a/plugins/feature/demodanalyzer/demodanalyzersettings.cpp b/plugins/feature/demodanalyzer/demodanalyzersettings.cpp index b7f5e9c68..045c1e8e5 100644 --- a/plugins/feature/demodanalyzer/demodanalyzersettings.cpp +++ b/plugins/feature/demodanalyzer/demodanalyzersettings.cpp @@ -42,6 +42,7 @@ const QStringList DemodAnalyzerSettings::m_channelURIs = { QStringLiteral("sdrangel.channel.packetdemod"), QStringLiteral("sdrangel.channeltx.modpacket"), QStringLiteral("sdrangel.channel.radiosondedemod"), + QStringLiteral("sdrangel.channel.selcaldemod"), QStringLiteral("sdrangel.channeltx.modpsk31"), QStringLiteral("sdrangel.channeltx.modrtty"), QStringLiteral("sdrangel.channel.ssbdemod"), diff --git a/plugins/feature/demodanalyzer/readme.md b/plugins/feature/demodanalyzer/readme.md index c24bfbcb1..8291d421b 100644 --- a/plugins/feature/demodanalyzer/readme.md +++ b/plugins/feature/demodanalyzer/readme.md @@ -18,6 +18,7 @@ Rx plugins are: - NFM demodulator - Packet demodulator - Radiosonde demodulator + - SELCAL demodulator - SSB demodulator - WFM demodulator diff --git a/plugins/feature/denoiser/denoisersettings.cpp b/plugins/feature/denoiser/denoisersettings.cpp index bee017736..14d09a385 100644 --- a/plugins/feature/denoiser/denoisersettings.cpp +++ b/plugins/feature/denoiser/denoisersettings.cpp @@ -31,6 +31,7 @@ const QStringList DenoiserSettings::m_channelURIs = { QStringLiteral("sdrangel.channel.dsddemod"), QStringLiteral("sdrangel.channel.m17demod"), QStringLiteral("sdrangel.channel.nfmdemod"), + QStringLiteral("sdrangel.channel.selcaldemod"), QStringLiteral("sdrangel.channel.ssbdemod"), QStringLiteral("sdrangel.channel.wfmdemod"), QStringLiteral("sdrangel.channel.wdsprx"), diff --git a/plugins/feature/denoiser/readme.md b/plugins/feature/denoiser/readme.md index a8c80302c..92a5c1d1f 100644 --- a/plugins/feature/denoiser/readme.md +++ b/plugins/feature/denoiser/readme.md @@ -16,6 +16,7 @@ Supported sources include: - DAB demodulator - DSD demodulator - NFM demodulator + - SELCAL demodulator - SSB demodulator - WFM demodulator - WDSP plugin (multimode) diff --git a/sdrbase/CMakeLists.txt b/sdrbase/CMakeLists.txt index 683309b1b..48ae67509 100644 --- a/sdrbase/CMakeLists.txt +++ b/sdrbase/CMakeLists.txt @@ -268,6 +268,7 @@ set(sdrbase_SOURCES util/radiosonde.cpp util/rainviewer.cpp util/rtpsink.cpp + util/selcaldb.cpp util/syncmessenger.cpp util/samplesourceserializer.cpp util/sdrangelserverlist.cpp @@ -545,6 +546,7 @@ set(sdrbase_HEADERS util/rds.h util/rtpsink.h util/rtty.h + util/selcaldb.h util/syncmessenger.h util/samplesourceserializer.h util/sdrangelserverlist.h diff --git a/sdrbase/resources/webapi.qrc b/sdrbase/resources/webapi.qrc index c961ddbcb..9ab1ae0b4 100644 --- a/sdrbase/resources/webapi.qrc +++ b/sdrbase/resources/webapi.qrc @@ -48,6 +48,7 @@ webapi/doc/swagger/include/DeviceSettings.yaml webapi/doc/swagger/include/DOA2.yaml webapi/doc/swagger/include/DSCDemod.yaml + webapi/doc/swagger/include/SELCALDemod.yaml webapi/doc/swagger/include/DSDDemod.yaml webapi/doc/swagger/include/DroneIDDemod.yaml webapi/doc/swagger/include/EndOfTrainDemod.yaml diff --git a/sdrbase/resources/webapi/doc/swagger/include/ChannelReport.yaml b/sdrbase/resources/webapi/doc/swagger/include/ChannelReport.yaml index 6bf4ca33f..d4fcf6ebd 100644 --- a/sdrbase/resources/webapi/doc/swagger/include/ChannelReport.yaml +++ b/sdrbase/resources/webapi/doc/swagger/include/ChannelReport.yaml @@ -200,3 +200,5 @@ ChannelReport: WFMModReport: $ref: "/doc/swagger/include/WFMMod.yaml#/WFMModReport" description: "Wfm mod report data for Channel." + SELCALDemodReport: + $ref: "/doc/swagger/include/SELCALDemod.yaml#/SELCALDemodReport" diff --git a/sdrbase/resources/webapi/doc/swagger/include/ChannelSettings.yaml b/sdrbase/resources/webapi/doc/swagger/include/ChannelSettings.yaml index 085f6f3b4..e24217c34 100644 --- a/sdrbase/resources/webapi/doc/swagger/include/ChannelSettings.yaml +++ b/sdrbase/resources/webapi/doc/swagger/include/ChannelSettings.yaml @@ -233,3 +233,5 @@ ChannelSettings: WFMModSettings: $ref: "/doc/swagger/include/WFMMod.yaml#/WFMModSettings" description: "Wfm mod settings configuration for Channel." + SELCALDemodSettings: + $ref: "/doc/swagger/include/SELCALDemod.yaml#/SELCALDemodSettings" diff --git a/sdrbase/resources/webapi/doc/swagger/include/SELCALDemod.yaml b/sdrbase/resources/webapi/doc/swagger/include/SELCALDemod.yaml new file mode 100644 index 000000000..c17f8f8e3 --- /dev/null +++ b/sdrbase/resources/webapi/doc/swagger/include/SELCALDemod.yaml @@ -0,0 +1,139 @@ +SELCALDemodSettings: + description: SELCAL settings + type: object + properties: + inputFrequencyOffset: + type: integer + format: int64 + rfBandwidth: + type: number + format: float + modulation: + type: integer + format: int32 + description: "0 = USB, 1 = AM" + enum: [0, 1] + toneFrequencyOffset: + type: number + format: float + description: Common received audio tone offset in Hz + minimum: -100 + maximum: 100 + autoToneFrequencyOffset: + type: integer + format: int32 + description: Use a detected residual USB carrier within +/-100 Hz as the tone offset; otherwise tones are searched for within +/-6 Hz of the manual offset + default: 1 + enum: [0, 1] + threshold: + type: number + format: float + description: Minimum level of each tone above the noise in a tone bin, in dB + default: 8 + minimum: 6 + maximum: 20 + volume: + type: number + format: float + audioMute: + type: integer + format: int32 + squelch: + type: integer + format: int32 + description: Monitoring audio squelch threshold in dBFS; decoding is independent of squelch + default: -80 + minimum: -100 + maximum: 0 + audioDeviceName: + type: string + filter: + type: string + udpEnabled: + type: integer + format: int32 + udpAddress: + type: string + udpPort: + type: integer + format: int32 + logFilename: + type: string + logEnabled: + type: integer + format: int32 + rgbColor: + type: integer + format: int32 + title: + type: string + streamIndex: + type: integer + format: int32 + useReverseAPI: + type: integer + format: int32 + reverseAPIAddress: + type: string + reverseAPIPort: + type: integer + format: int32 + reverseAPIDeviceIndex: + type: integer + format: int32 + reverseAPIChannelIndex: + type: integer + format: int32 + channelMarker: + $ref: "/doc/swagger/include/ChannelMarker.yaml#/ChannelMarker" + rollupState: + $ref: "/doc/swagger/include/RollupState.yaml#/RollupState" +SELCALDemodReport: + description: SELCAL report + type: object + properties: + channelPowerDb: + type: number + format: double + channelSampleRate: + type: integer + format: int32 + audioSampleRate: + type: integer + format: int32 + squelchOpen: + type: integer + format: int32 + description: Monitoring audio squelch is open + carrierLocked: + type: integer + format: int32 + description: A reliable residual USB carrier, or an AM carrier, has been detected + carrierFrequencyOffset: + type: number + format: float + description: Measured carrier error from channel tuning in Hz; valid when carrierLocked is 1 + toneFrequencyOffset: + type: number + format: float + description: Common tone offset measured by the decoder, or the expected offset when no tones are present, in Hz + state: + type: string + lastCode: + type: string + lastTimestamp: + type: string + lastFrequency: + type: integer + format: int64 + lastRssi: + type: number + format: float + description: Average channel power during the tone bursts of the last call, in dB + lastSnr: + type: number + format: float + description: SNR of the weaker tone of the last call, relative to the noise in a tone bin, in dB + callCount: + type: integer + format: int64 diff --git a/sdrbase/util/selcaldb.cpp b/sdrbase/util/selcaldb.cpp new file mode 100644 index 000000000..d7fe89ba8 --- /dev/null +++ b/sdrbase/util/selcaldb.cpp @@ -0,0 +1,203 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2026 Jon Beniston, M7RCE // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#include + +#include +#include +#include +#include +#include + +#if (QT_VERSION < QT_VERSION_CHECK(6, 6, 0)) +#include +#else +#include +#endif + +#include "util/selcaldb.h" +#include "util/osndb.h" +#include "util/corsproxy.h" +#include "util/csv.h" + +QSharedPointer> SELCALDB::m_registrations; +QDateTime SELCALDB::m_modifiedDateTime; +QMutex SELCALDB::m_mutex; + +SELCALDB::SELCALDB(QObject *parent) : + QObject(parent) +{ + connect(&m_dlm, &HttpDownloadManager::downloadComplete, this, &SELCALDB::downloadFinished); +} + +SELCALDB::~SELCALDB() +{ + disconnect(&m_dlm, &HttpDownloadManager::downloadComplete, this, &SELCALDB::downloadFinished); +} + +QString SELCALDB::getZipFilename() +{ + return OsnDB::getDataDir() + "/selcal.zip"; +} + +QString SELCALDB::getCSVFilename() +{ + return OsnDB::getDataDir() + "/selcal.csv"; +} + +void SELCALDB::downloadSELCALInformation() +{ + QString filename = getZipFilename(); + QString urlString = SELCALDB_URL; + QUrl dbURL(CORSProxy::adjustHost(urlString)); + qDebug() << "SELCALDB::downloadSELCALInformation: Downloading " << urlString; + emit downloadingURL(urlString); + QNetworkReply *reply = m_dlm.download(dbURL, filename); + connect(reply, &QNetworkReply::downloadProgress, this, [this](qint64 bytesRead, qint64 totalBytes) { + emit downloadProgress(bytesRead, totalBytes); + }); +} + +void SELCALDB::downloadFinished(const QString& filename, bool success) +{ + if (!success) + { + qWarning() << "SELCALDB::downloadFinished: Failed to download: " << filename; + emit downloadError(QString("Failed to download: %1").arg(filename)); + } + else if (filename == getZipFilename()) + { + // Extract .csv file from .zip file + QZipReader reader(filename); + if (reader.extractAll(OsnDB::getDataDir())) + { + emit downloadSELCALInformationFinished(); + } + else + { + qWarning() << "SELCALDB::downloadFinished - Failed to extract files from " << filename; + emit downloadError(QString("Failed to extract files from %1").arg(filename)); + } + } + else + { + qDebug() << "SELCALDB::downloadFinished: Unexpected filename: " << filename; + emit downloadError(QString("Unexpected filename: %1").arg(filename)); + } +} + +QString SELCALDB::normalizeCode(const QString& code) +{ + // Tone designations, in the order used to write each pair + static const QString order = QStringLiteral("ABCDEFGHJKLMPQRSTUVWXYZ123456789"); + QString symbols = code.toUpper().remove('-').remove(' '); + + if (symbols.size() != 4) { + return QString(); + } + for (const auto& symbol : symbols) + { + if (!order.contains(symbol)) { + return QString(); + } + } + auto pair = [](QString pair) { + std::sort(pair.begin(), pair.end(), [](QChar a, QChar b) { return order.indexOf(a) < order.indexOf(b); }); + return pair; + }; + return pair(symbols.left(2)) + "-" + pair(symbols.mid(2)); +} + +QMultiHash *SELCALDB::readCSV(const QString& filename) +{ + QFile file(filename); + + if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) + { + qDebug() << "SELCALDB::readCSV: Could not open " << filename; + return nullptr; + } + + QTextStream in(&file); + QString error; + QHash columns = CSV::readHeader(in, {"Code", "Registration"}, error); + + if (!error.isEmpty()) + { + qWarning() << "SELCALDB::readCSV: " << filename << ": " << error; + return nullptr; + } + + int codeCol = columns["Code"]; + int registrationCol = columns["Registration"]; + int lastCol = std::max(codeCol, registrationCol); + QMultiHash *registrations = new QMultiHash(); + QStringList row; + + while (CSV::readRow(in, &row)) + { + if (row.size() <= lastCol) { + continue; + } + QString code = normalizeCode(row[codeCol]); + QString registration = row[registrationCol].trimmed(); + if (!code.isEmpty() && !registration.isEmpty()) { + registrations->insert(code, registration); + } + } + + qDebug() << "SELCALDB::readCSV: Read " << registrations->size() << " SELCAL codes from " << filename; + return registrations; +} + +QSharedPointer> SELCALDB::getRegistrations() +{ + QMutexLocker locker(&m_mutex); + QFileInfo fileInfo(getCSVFilename()); + + if (!fileInfo.exists()) { + return m_registrations; + } + + // Reload if the file has been downloaded since it was read + QDateTime modifiedDateTime = fileInfo.lastModified(); + if (!m_registrations || (modifiedDateTime > m_modifiedDateTime)) + { + QMultiHash *registrations = readCSV(getCSVFilename()); + if (registrations) + { + m_registrations = QSharedPointer>(registrations); + m_modifiedDateTime = modifiedDateTime; + } + } + + return m_registrations; +} + +QStringList SELCALDB::getRegistrations(const QString& code) +{ + QSharedPointer> registrations = getRegistrations(); + + if (!registrations) { + return QStringList(); + } + + // values() returns the most recently inserted first + QStringList list = registrations->values(normalizeCode(code)); + std::reverse(list.begin(), list.end()); + return list; +} diff --git a/sdrbase/util/selcaldb.h b/sdrbase/util/selcaldb.h new file mode 100644 index 000000000..0607e662f --- /dev/null +++ b/sdrbase/util/selcaldb.h @@ -0,0 +1,80 @@ +/////////////////////////////////////////////////////////////////////////////////// +// Copyright (C) 2026 Jon Beniston, M7RCE // +// // +// 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 // +// (at your option) any later version. // +// // +// 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 . // +/////////////////////////////////////////////////////////////////////////////////// + +#ifndef INCLUDE_SELCALDB_H +#define INCLUDE_SELCALDB_H + +#include +#include +#include +#include +#include +#include + +#include "util/httpdownloadmanager.h" +#include "export.h" + +#define SELCALDB_URL "https://sdrangel.org/downloads/selcal.zip" + +// Database of SELCAL codes assigned to aircraft, from a CSV file with Code and +// Registration columns. Codes are not unique, so a code can have several +// registrations. +class SDRBASE_API SELCALDB : public QObject { + Q_OBJECT + +public: + + SELCALDB(QObject* parent=nullptr); + ~SELCALDB(); + + void downloadSELCALInformation(); + + // Registrations keyed by normalized code. Reloaded if the file has changed. + // Null if the database has not been downloaded. + static QSharedPointer> getRegistrations(); + + // Registrations of aircraft assigned a code, in file order. + static QStringList getRegistrations(const QString& code); + + // Code in the form AB-CD, with each pair in tone designation order, or an + // empty string if it is not a valid code. + static QString normalizeCode(const QString& code); + + static QMultiHash *readCSV(const QString& filename); + + static QString getZipFilename(); + static QString getCSVFilename(); + +private: + HttpDownloadManager m_dlm; + + static QSharedPointer> m_registrations; + static QDateTime m_modifiedDateTime; + static QMutex m_mutex; + +private slots: + void downloadFinished(const QString& filename, bool success); + +signals: + void downloadingURL(const QString& url); + void downloadError(const QString& error); + void downloadProgress(qint64 bytesReceived, qint64 bytesTotal); + void downloadSELCALInformationFinished(); + +}; + +#endif diff --git a/sdrbase/webapi/webapirequestmapper.cpp b/sdrbase/webapi/webapirequestmapper.cpp index 31e09dbc1..c0b1a4854 100644 --- a/sdrbase/webapi/webapirequestmapper.cpp +++ b/sdrbase/webapi/webapirequestmapper.cpp @@ -4984,6 +4984,12 @@ bool WebAPIRequestMapper::getChannelSettings( channelSettings->getDscDemodSettings()->init(); channelSettings->getDscDemodSettings()->fromJsonObject(settingsJsonObject); } + else if (channelSettingsKey == "SELCALDemodSettings") + { + channelSettings->setSelcalDemodSettings(new SWGSDRangel::SWGSELCALDemodSettings()); + channelSettings->getSelcalDemodSettings()->init(); + channelSettings->getSelcalDemodSettings()->fromJsonObject(settingsJsonObject); + } else if (channelSettingsKey == "DSDDemodSettings") { channelSettings->setDsdDemodSettings(new SWGSDRangel::SWGDSDDemodSettings()); diff --git a/sdrbase/webapi/webapiutils.cpp b/sdrbase/webapi/webapiutils.cpp index 040e1cb69..1ad1be798 100644 --- a/sdrbase/webapi/webapiutils.cpp +++ b/sdrbase/webapi/webapiutils.cpp @@ -48,6 +48,7 @@ const QMap WebAPIUtils::m_channelURIToSettingsKey = { {"sdrangel.channel.dabdemod", "DABDemodSettings"}, {"sdrangel.channel.doa2", "DOA2Settings"}, {"sdrangel.channel.dscdemod", "DSCDemodSettings"}, + {"sdrangel.channel.selcaldemod", "SELCALDemodSettings"}, {"sdrangel.channel.dsddemod", "DSDDemodSettings"}, {"sdrangel.channel.droneiddemod", "DroneIDDemodSettings"}, {"sdrangel.channel.endoftraindemod", "EndOfTrainDemodSettings"}, @@ -184,6 +185,7 @@ const QMap WebAPIUtils::m_channelTypeToSettingsKey = { {"DABDemod", "DABDemodSettings"}, {"DOA2", "DOA2Settings"}, {"DSCDemod", "DSCDemodSettings"}, + {"SELCALDemod", "SELCALDemodSettings"}, {"DSDDemod", "DSDDemodSettings"}, {"DroneIDDemod", "DroneIDDemodSettings"}, {"EndOfTrainDemod", "EndOfTrainDemodSettings"}, diff --git a/swagger/sdrangel/api/swagger/include/ChannelReport.yaml b/swagger/sdrangel/api/swagger/include/ChannelReport.yaml index 087712907..97e56c81f 100644 --- a/swagger/sdrangel/api/swagger/include/ChannelReport.yaml +++ b/swagger/sdrangel/api/swagger/include/ChannelReport.yaml @@ -200,3 +200,5 @@ ChannelReport: WFMModReport: $ref: "http://swgserver:8081/api/swagger/include/WFMMod.yaml#/WFMModReport" description: "Wfm mod report data for Channel." + SELCALDemodReport: + $ref: "http://swgserver:8081/api/swagger/include/SELCALDemod.yaml#/SELCALDemodReport" diff --git a/swagger/sdrangel/api/swagger/include/ChannelSettings.yaml b/swagger/sdrangel/api/swagger/include/ChannelSettings.yaml index 79e9b8c29..016aea4f1 100644 --- a/swagger/sdrangel/api/swagger/include/ChannelSettings.yaml +++ b/swagger/sdrangel/api/swagger/include/ChannelSettings.yaml @@ -233,3 +233,5 @@ ChannelSettings: WFMModSettings: $ref: "http://swgserver:8081/api/swagger/include/WFMMod.yaml#/WFMModSettings" description: "Wfm mod settings configuration for Channel." + SELCALDemodSettings: + $ref: "http://swgserver:8081/api/swagger/include/SELCALDemod.yaml#/SELCALDemodSettings" diff --git a/swagger/sdrangel/api/swagger/include/SELCALDemod.yaml b/swagger/sdrangel/api/swagger/include/SELCALDemod.yaml new file mode 100644 index 000000000..c4becc453 --- /dev/null +++ b/swagger/sdrangel/api/swagger/include/SELCALDemod.yaml @@ -0,0 +1,140 @@ +SELCALDemodSettings: + description: SELCAL settings + type: object + properties: + inputFrequencyOffset: + type: integer + format: int64 + rfBandwidth: + type: number + format: float + modulation: + type: integer + format: int32 + description: "0 = USB, 1 = AM" + enum: [0, 1] + toneFrequencyOffset: + type: number + format: float + description: Common received audio tone offset in Hz + minimum: -100 + maximum: 100 + autoToneFrequencyOffset: + type: integer + format: int32 + description: Use a detected residual USB carrier within +/-100 Hz as the tone offset; otherwise tones are searched for within +/-6 Hz of the manual offset + default: 1 + enum: [0, 1] + threshold: + type: number + format: float + description: Minimum level of each tone above the noise in a tone bin, in dB + default: 8 + minimum: 6 + maximum: 20 + volume: + type: number + format: float + audioMute: + type: integer + format: int32 + squelch: + type: integer + format: int32 + description: Monitoring audio squelch threshold in dBFS; decoding is independent of squelch + default: -80 + minimum: -100 + maximum: 0 + audioDeviceName: + type: string + filter: + type: string + udpEnabled: + type: integer + format: int32 + udpAddress: + type: string + udpPort: + type: integer + format: int32 + logFilename: + type: string + logEnabled: + type: integer + format: int32 + rgbColor: + type: integer + format: int32 + title: + type: string + streamIndex: + type: integer + format: int32 + useReverseAPI: + type: integer + format: int32 + reverseAPIAddress: + type: string + reverseAPIPort: + type: integer + format: int32 + reverseAPIDeviceIndex: + type: integer + format: int32 + reverseAPIChannelIndex: + type: integer + format: int32 + channelMarker: + $ref: "http://swgserver:8081/api/swagger/include/ChannelMarker.yaml#/ChannelMarker" + rollupState: + $ref: "http://swgserver:8081/api/swagger/include/RollupState.yaml#/RollupState" + +SELCALDemodReport: + description: SELCAL report + type: object + properties: + channelPowerDb: + type: number + format: double + channelSampleRate: + type: integer + format: int32 + audioSampleRate: + type: integer + format: int32 + squelchOpen: + type: integer + format: int32 + description: Monitoring audio squelch is open + carrierLocked: + type: integer + format: int32 + description: A reliable residual USB carrier, or an AM carrier, has been detected + carrierFrequencyOffset: + type: number + format: float + description: Measured carrier error from channel tuning in Hz; valid when carrierLocked is 1 + toneFrequencyOffset: + type: number + format: float + description: Common tone offset measured by the decoder, or the expected offset when no tones are present, in Hz + state: + type: string + lastCode: + type: string + lastTimestamp: + type: string + lastFrequency: + type: integer + format: int64 + lastRssi: + type: number + format: float + description: Average channel power during the tone bursts of the last call, in dB + lastSnr: + type: number + format: float + description: SNR of the weaker tone of the last call, relative to the noise in a tone bin, in dB + callCount: + type: integer + format: int64 diff --git a/swagger/sdrangel/code/qt5/client/SWGChannelReport.cpp b/swagger/sdrangel/code/qt5/client/SWGChannelReport.cpp index ed42ee962..b416ffc79 100644 --- a/swagger/sdrangel/code/qt5/client/SWGChannelReport.cpp +++ b/swagger/sdrangel/code/qt5/client/SWGChannelReport.cpp @@ -67,7 +67,9 @@ SWGChannelReport::SWGChannelReport() { doa2_report = nullptr; m_doa2_report_isSet = false; dsc_demod_report = nullptr; + selcal_demod_report = nullptr; m_dsc_demod_report_isSet = false; + m_selcal_demod_report_isSet = false; dsd_demod_report = nullptr; m_dsd_demod_report_isSet = false; drone_id_demod_report = nullptr; @@ -203,7 +205,9 @@ SWGChannelReport::init() { doa2_report = new SWGDOA2Report(); m_doa2_report_isSet = false; dsc_demod_report = new SWGDSCDemodReport(); + selcal_demod_report = new SWGSELCALDemodReport(); m_dsc_demod_report_isSet = false; + m_selcal_demod_report_isSet = false; dsd_demod_report = new SWGDSDDemodReport(); m_dsd_demod_report_isSet = false; drone_id_demod_report = new SWGDroneIDDemodReport(); @@ -354,6 +358,9 @@ SWGChannelReport::cleanup() { if(dsc_demod_report != nullptr) { delete dsc_demod_report; } + if(selcal_demod_report != nullptr) { + delete selcal_demod_report; + } if(dsd_demod_report != nullptr) { delete dsd_demod_report; } @@ -536,6 +543,7 @@ SWGChannelReport::fromJsonObject(QJsonObject &pJson) { ::SWGSDRangel::setValue(&doa2_report, pJson["DOA2Report"], "SWGDOA2Report", "SWGDOA2Report"); ::SWGSDRangel::setValue(&dsc_demod_report, pJson["DSCDemodReport"], "SWGDSCDemodReport", "SWGDSCDemodReport"); + ::SWGSDRangel::setValue(&selcal_demod_report, pJson["SELCALDemodReport"], "SWGSELCALDemodReport", "SWGSELCALDemodReport"); ::SWGSDRangel::setValue(&dsd_demod_report, pJson["DSDDemodReport"], "SWGDSDDemodReport", "SWGDSDDemodReport"); @@ -700,6 +708,9 @@ SWGChannelReport::asJsonObject() { if((dsc_demod_report != nullptr) && (dsc_demod_report->isSet())){ toJsonValue(QString("DSCDemodReport"), dsc_demod_report, obj, QString("SWGDSCDemodReport")); } + if((selcal_demod_report != nullptr) && (selcal_demod_report->isSet())){ + toJsonValue(QString("SELCALDemodReport"), selcal_demod_report, obj, QString("SWGSELCALDemodReport")); + } if((dsd_demod_report != nullptr) && (dsd_demod_report->isSet())){ toJsonValue(QString("DSDDemodReport"), dsd_demod_report, obj, QString("SWGDSDDemodReport")); } @@ -1036,6 +1047,19 @@ SWGChannelReport::setDscDemodReport(SWGDSCDemodReport* dsc_demod_report) { this->m_dsc_demod_report_isSet = true; } +SWGSELCALDemodReport* +SWGChannelReport::getSelcalDemodReport() { + return selcal_demod_report; +} +void +SWGChannelReport::setSelcalDemodReport(SWGSELCALDemodReport* selcal_demod_report) { + if (this->selcal_demod_report != selcal_demod_report) { + delete this->selcal_demod_report; + } + this->selcal_demod_report = selcal_demod_report; + this->m_selcal_demod_report_isSet = true; +} + SWGDSDDemodReport* SWGChannelReport::getDsdDemodReport() { return dsd_demod_report; @@ -1541,6 +1565,9 @@ SWGChannelReport::isSet(){ if(dsc_demod_report && dsc_demod_report->isSet()){ isObjectUpdated = true; break; } + if(selcal_demod_report && selcal_demod_report->isSet()){ + isObjectUpdated = true; break; + } if(dsd_demod_report && dsd_demod_report->isSet()){ isObjectUpdated = true; break; } diff --git a/swagger/sdrangel/code/qt5/client/SWGChannelReport.h b/swagger/sdrangel/code/qt5/client/SWGChannelReport.h index 0a0592a2f..9fc4e347e 100644 --- a/swagger/sdrangel/code/qt5/client/SWGChannelReport.h +++ b/swagger/sdrangel/code/qt5/client/SWGChannelReport.h @@ -40,6 +40,7 @@ #include "SWGDATVModReport.h" #include "SWGDOA2Report.h" #include "SWGDSCDemodReport.h" +#include "SWGSELCALDemodReport.h" #include "SWGDSDDemodReport.h" #include "SWGDroneIDDemodReport.h" #include "SWGEndOfTrainDemodReport.h" @@ -162,7 +163,9 @@ public: void setDoa2Report(SWGDOA2Report* doa2_report); SWGDSCDemodReport* getDscDemodReport(); + SWGSELCALDemodReport* getSelcalDemodReport(); void setDscDemodReport(SWGDSCDemodReport* dsc_demod_report); + void setSelcalDemodReport(SWGSELCALDemodReport* selcal_demod_report); SWGDSDDemodReport* getDsdDemodReport(); void setDsdDemodReport(SWGDSDDemodReport* dsd_demod_report); @@ -358,7 +361,9 @@ private: bool m_doa2_report_isSet; SWGDSCDemodReport* dsc_demod_report; + SWGSELCALDemodReport* selcal_demod_report; bool m_dsc_demod_report_isSet; + bool m_selcal_demod_report_isSet; SWGDSDDemodReport* dsd_demod_report; bool m_dsd_demod_report_isSet; diff --git a/swagger/sdrangel/code/qt5/client/SWGChannelSettings.cpp b/swagger/sdrangel/code/qt5/client/SWGChannelSettings.cpp index c5c90969f..a039a6401 100644 --- a/swagger/sdrangel/code/qt5/client/SWGChannelSettings.cpp +++ b/swagger/sdrangel/code/qt5/client/SWGChannelSettings.cpp @@ -79,7 +79,9 @@ SWGChannelSettings::SWGChannelSettings() { doa2_settings = nullptr; m_doa2_settings_isSet = false; dsc_demod_settings = nullptr; + selcal_demod_settings = nullptr; m_dsc_demod_settings_isSet = false; + m_selcal_demod_settings_isSet = false; dsd_demod_settings = nullptr; m_dsd_demod_settings_isSet = false; drone_id_demod_settings = nullptr; @@ -237,7 +239,9 @@ SWGChannelSettings::init() { doa2_settings = new SWGDOA2Settings(); m_doa2_settings_isSet = false; dsc_demod_settings = new SWGDSCDemodSettings(); + selcal_demod_settings = new SWGSELCALDemodSettings(); m_dsc_demod_settings_isSet = false; + m_selcal_demod_settings_isSet = false; dsd_demod_settings = new SWGDSDDemodSettings(); m_dsd_demod_settings_isSet = false; drone_id_demod_settings = new SWGDroneIDDemodSettings(); @@ -412,6 +416,9 @@ SWGChannelSettings::cleanup() { if(dsc_demod_settings != nullptr) { delete dsc_demod_settings; } + if(selcal_demod_settings != nullptr) { + delete selcal_demod_settings; + } if(dsd_demod_settings != nullptr) { delete dsd_demod_settings; } @@ -621,6 +628,7 @@ SWGChannelSettings::fromJsonObject(QJsonObject &pJson) { ::SWGSDRangel::setValue(&doa2_settings, pJson["DOA2Settings"], "SWGDOA2Settings", "SWGDOA2Settings"); ::SWGSDRangel::setValue(&dsc_demod_settings, pJson["DSCDemodSettings"], "SWGDSCDemodSettings", "SWGDSCDemodSettings"); + ::SWGSDRangel::setValue(&selcal_demod_settings, pJson["SELCALDemodSettings"], "SWGSELCALDemodSettings", "SWGSELCALDemodSettings"); ::SWGSDRangel::setValue(&dsd_demod_settings, pJson["DSDDemodSettings"], "SWGDSDDemodSettings", "SWGDSDDemodSettings"); @@ -813,6 +821,9 @@ SWGChannelSettings::asJsonObject() { if((dsc_demod_settings != nullptr) && (dsc_demod_settings->isSet())){ toJsonValue(QString("DSCDemodSettings"), dsc_demod_settings, obj, QString("SWGDSCDemodSettings")); } + if((selcal_demod_settings != nullptr) && (selcal_demod_settings->isSet())){ + toJsonValue(QString("SELCALDemodSettings"), selcal_demod_settings, obj, QString("SWGSELCALDemodSettings")); + } if((dsd_demod_settings != nullptr) && (dsd_demod_settings->isSet())){ toJsonValue(QString("DSDDemodSettings"), dsd_demod_settings, obj, QString("SWGDSDDemodSettings")); } @@ -1224,6 +1235,19 @@ SWGChannelSettings::setDscDemodSettings(SWGDSCDemodSettings* dsc_demod_settings) this->m_dsc_demod_settings_isSet = true; } +SWGSELCALDemodSettings* +SWGChannelSettings::getSelcalDemodSettings() { + return selcal_demod_settings; +} +void +SWGChannelSettings::setSelcalDemodSettings(SWGSELCALDemodSettings* selcal_demod_settings) { + if (this->selcal_demod_settings != selcal_demod_settings) { + delete this->selcal_demod_settings; + } + this->selcal_demod_settings = selcal_demod_settings; + this->m_selcal_demod_settings_isSet = true; +} + SWGDSDDemodSettings* SWGChannelSettings::getDsdDemodSettings() { return dsd_demod_settings; @@ -1797,6 +1821,9 @@ SWGChannelSettings::isSet(){ if(dsc_demod_settings && dsc_demod_settings->isSet()){ isObjectUpdated = true; break; } + if(selcal_demod_settings && selcal_demod_settings->isSet()){ + isObjectUpdated = true; break; + } if(dsd_demod_settings && dsd_demod_settings->isSet()){ isObjectUpdated = true; break; } diff --git a/swagger/sdrangel/code/qt5/client/SWGChannelSettings.h b/swagger/sdrangel/code/qt5/client/SWGChannelSettings.h index b42b69692..19ec209a5 100644 --- a/swagger/sdrangel/code/qt5/client/SWGChannelSettings.h +++ b/swagger/sdrangel/code/qt5/client/SWGChannelSettings.h @@ -44,6 +44,7 @@ #include "SWGDATVModSettings.h" #include "SWGDOA2Settings.h" #include "SWGDSCDemodSettings.h" +#include "SWGSELCALDemodSettings.h" #include "SWGDSDDemodSettings.h" #include "SWGDroneIDDemodSettings.h" #include "SWGEndOfTrainDemodSettings.h" @@ -189,7 +190,9 @@ public: void setDoa2Settings(SWGDOA2Settings* doa2_settings); SWGDSCDemodSettings* getDscDemodSettings(); + SWGSELCALDemodSettings* getSelcalDemodSettings(); void setDscDemodSettings(SWGDSCDemodSettings* dsc_demod_settings); + void setSelcalDemodSettings(SWGSELCALDemodSettings* selcal_demod_settings); SWGDSDDemodSettings* getDsdDemodSettings(); void setDsdDemodSettings(SWGDSDDemodSettings* dsd_demod_settings); @@ -418,7 +421,9 @@ private: bool m_doa2_settings_isSet; SWGDSCDemodSettings* dsc_demod_settings; + SWGSELCALDemodSettings* selcal_demod_settings; bool m_dsc_demod_settings_isSet; + bool m_selcal_demod_settings_isSet; SWGDSDDemodSettings* dsd_demod_settings; bool m_dsd_demod_settings_isSet; diff --git a/swagger/sdrangel/code/qt5/client/SWGModelFactory.h b/swagger/sdrangel/code/qt5/client/SWGModelFactory.h index 8dc750cab..0737ecf9a 100644 --- a/swagger/sdrangel/code/qt5/client/SWGModelFactory.h +++ b/swagger/sdrangel/code/qt5/client/SWGModelFactory.h @@ -124,7 +124,9 @@ #include "SWGDOA2Report.h" #include "SWGDOA2Settings.h" #include "SWGDSCDemodReport.h" +#include "SWGSELCALDemodReport.h" #include "SWGDSCDemodSettings.h" +#include "SWGSELCALDemodSettings.h" #include "SWGDSDDemodReport.h" #include "SWGDSDDemodSettings.h" #include "SWGDroneIDDemodReport.h" @@ -989,11 +991,21 @@ namespace SWGSDRangel { obj->init(); return obj; } + if(QString("SWGSELCALDemodReport").compare(type) == 0) { + SWGSELCALDemodReport *obj = new SWGSELCALDemodReport(); + obj->init(); + return obj; + } if(QString("SWGDSCDemodSettings").compare(type) == 0) { SWGDSCDemodSettings *obj = new SWGDSCDemodSettings(); obj->init(); return obj; } + if(QString("SWGSELCALDemodSettings").compare(type) == 0) { + SWGSELCALDemodSettings *obj = new SWGSELCALDemodSettings(); + obj->init(); + return obj; + } if(QString("SWGDSDDemodReport").compare(type) == 0) { SWGDSDDemodReport *obj = new SWGDSDDemodReport(); obj->init(); diff --git a/swagger/sdrangel/code/qt5/client/SWGSELCALDemodReport.cpp b/swagger/sdrangel/code/qt5/client/SWGSELCALDemodReport.cpp new file mode 100644 index 000000000..c9c8d5797 --- /dev/null +++ b/swagger/sdrangel/code/qt5/client/SWGSELCALDemodReport.cpp @@ -0,0 +1,109 @@ +// SPDX-License-Identifier: GPL-3.0-or-later +#include "SWGSELCALDemodReport.h" +#include "SWGHelpers.h" +#include +namespace SWGSDRangel { +SWGSELCALDemodReport::SWGSELCALDemodReport() = default; +SWGSELCALDemodReport::SWGSELCALDemodReport(QString* json) { init(); if (json) { fromJson(*json); } } +SWGSELCALDemodReport::~SWGSELCALDemodReport() { cleanup(); } +void SWGSELCALDemodReport::cleanup() +{ + delete m_state; m_state = nullptr; + delete m_lastCode; m_lastCode = nullptr; + delete m_lastTimestamp; m_lastTimestamp = nullptr; +} +void SWGSELCALDemodReport::init() +{ + cleanup(); + m_squelchOpen = 0; m_squelchOpenIsSet = false; + m_toneFrequencyOffset = 0; m_toneFrequencyOffsetIsSet = false; + m_carrierFrequencyOffset = 0; m_carrierFrequencyOffsetIsSet = false; + m_carrierLocked = 0; m_carrierLockedIsSet = false; + m_channelPowerDb = 0; m_channelPowerDbIsSet = false; + m_channelSampleRate = 0; m_channelSampleRateIsSet = false; + m_audioSampleRate = 0; m_audioSampleRateIsSet = false; + m_state = new QString(); m_stateIsSet = false; + m_lastCode = new QString(); m_lastCodeIsSet = false; + m_lastTimestamp = new QString(); m_lastTimestampIsSet = false; + m_lastFrequency = 0; m_lastFrequencyIsSet = false; + m_lastRssi = 0; m_lastRssiIsSet = false; + m_lastSnr = 0; m_lastSnrIsSet = false; + m_callCount = 0; m_callCountIsSet = false; +} +SWGSELCALDemodReport* SWGSELCALDemodReport::fromJson(QString& json) +{ + auto object = QJsonDocument::fromJson(json.toUtf8()).object(); fromJsonObject(object); return this; +} +void SWGSELCALDemodReport::fromJsonObject(QJsonObject& json) +{ + if (json.contains("squelchOpen")) { ::SWGSDRangel::setValue(&m_squelchOpen,json["squelchOpen"],"qint32",""); m_squelchOpenIsSet = true; } + if (json.contains("toneFrequencyOffset")) { ::SWGSDRangel::setValue(&m_toneFrequencyOffset,json["toneFrequencyOffset"],"float",""); m_toneFrequencyOffsetIsSet = true; } + if (json.contains("carrierFrequencyOffset")) { ::SWGSDRangel::setValue(&m_carrierFrequencyOffset,json["carrierFrequencyOffset"],"float",""); m_carrierFrequencyOffsetIsSet = true; } + if (json.contains("carrierLocked")) { ::SWGSDRangel::setValue(&m_carrierLocked,json["carrierLocked"],"qint32",""); m_carrierLockedIsSet = true; } + if (json.contains("channelPowerDb")) { ::SWGSDRangel::setValue(&m_channelPowerDb,json["channelPowerDb"],"double",""); m_channelPowerDbIsSet = true; } + if (json.contains("channelSampleRate")) { ::SWGSDRangel::setValue(&m_channelSampleRate,json["channelSampleRate"],"qint32",""); m_channelSampleRateIsSet = true; } + if (json.contains("audioSampleRate")) { ::SWGSDRangel::setValue(&m_audioSampleRate,json["audioSampleRate"],"qint32",""); m_audioSampleRateIsSet = true; } + if (json.contains("state")) { ::SWGSDRangel::setValue(&m_state,json["state"],"QString","QString"); m_stateIsSet = true; } + if (json.contains("lastCode")) { ::SWGSDRangel::setValue(&m_lastCode,json["lastCode"],"QString","QString"); m_lastCodeIsSet = true; } + if (json.contains("lastTimestamp")) { ::SWGSDRangel::setValue(&m_lastTimestamp,json["lastTimestamp"],"QString","QString"); m_lastTimestampIsSet = true; } + if (json.contains("lastFrequency")) { ::SWGSDRangel::setValue(&m_lastFrequency,json["lastFrequency"],"qint64",""); m_lastFrequencyIsSet = true; } + if (json.contains("lastRssi")) { ::SWGSDRangel::setValue(&m_lastRssi,json["lastRssi"],"float",""); m_lastRssiIsSet = true; } + if (json.contains("lastSnr")) { ::SWGSDRangel::setValue(&m_lastSnr,json["lastSnr"],"float",""); m_lastSnrIsSet = true; } + if (json.contains("callCount")) { ::SWGSDRangel::setValue(&m_callCount,json["callCount"],"qint64",""); m_callCountIsSet = true; } +} +QString SWGSELCALDemodReport::asJson() +{ + auto* object = asJsonObject(); QString result = QJsonDocument(*object).toJson(); delete object; return result; +} +QJsonObject* SWGSELCALDemodReport::asJsonObject() +{ + auto* object = new QJsonObject(); + if (m_squelchOpenIsSet) { object->insert("squelchOpen",QJsonValue(m_squelchOpen)); } + if (m_toneFrequencyOffsetIsSet) { object->insert("toneFrequencyOffset",QJsonValue(m_toneFrequencyOffset)); } + if (m_carrierFrequencyOffsetIsSet) { object->insert("carrierFrequencyOffset",QJsonValue(m_carrierFrequencyOffset)); } + if (m_carrierLockedIsSet) { object->insert("carrierLocked",QJsonValue(m_carrierLocked)); } + if (m_channelPowerDbIsSet) { object->insert("channelPowerDb",QJsonValue(m_channelPowerDb)); } + if (m_channelSampleRateIsSet) { object->insert("channelSampleRate",QJsonValue(m_channelSampleRate)); } + if (m_audioSampleRateIsSet) { object->insert("audioSampleRate",QJsonValue(m_audioSampleRate)); } + if (m_state && (m_stateIsSet || !m_state->isEmpty())) { toJsonValue(QString("state"),m_state,object,QString("QString")); } + if (m_lastCode && (m_lastCodeIsSet || !m_lastCode->isEmpty())) { toJsonValue(QString("lastCode"),m_lastCode,object,QString("QString")); } + if (m_lastTimestamp && (m_lastTimestampIsSet || !m_lastTimestamp->isEmpty())) { toJsonValue(QString("lastTimestamp"),m_lastTimestamp,object,QString("QString")); } + if (m_lastFrequencyIsSet) { object->insert("lastFrequency",QJsonValue(m_lastFrequency)); } + if (m_lastRssiIsSet) { object->insert("lastRssi",QJsonValue(m_lastRssi)); } + if (m_lastSnrIsSet) { object->insert("lastSnr",QJsonValue(m_lastSnr)); } + if (m_callCountIsSet) { object->insert("callCount",QJsonValue(m_callCount)); } + return object; +} +bool SWGSELCALDemodReport::isSet() +{ + return m_squelchOpenIsSet || m_toneFrequencyOffsetIsSet || m_carrierFrequencyOffsetIsSet || m_carrierLockedIsSet || m_channelPowerDbIsSet || m_channelSampleRateIsSet || m_audioSampleRateIsSet || m_stateIsSet || m_lastCodeIsSet || m_lastTimestampIsSet || m_lastFrequencyIsSet || m_lastRssiIsSet || m_lastSnrIsSet || m_callCountIsSet; +} +double SWGSELCALDemodReport::getChannelPowerDb() { return m_channelPowerDb; } +void SWGSELCALDemodReport::setChannelPowerDb(double value) { m_channelPowerDb = value; m_channelPowerDbIsSet = true; } +qint32 SWGSELCALDemodReport::getChannelSampleRate() { return m_channelSampleRate; } +void SWGSELCALDemodReport::setChannelSampleRate(qint32 value) { m_channelSampleRate = value; m_channelSampleRateIsSet = true; } +qint32 SWGSELCALDemodReport::getAudioSampleRate() { return m_audioSampleRate; } +void SWGSELCALDemodReport::setAudioSampleRate(qint32 value) { m_audioSampleRate = value; m_audioSampleRateIsSet = true; } +QString* SWGSELCALDemodReport::getState() { return m_state; } +void SWGSELCALDemodReport::setState(QString* value) { if (m_state != value) { delete m_state; m_state = value; } m_stateIsSet = true; } +QString* SWGSELCALDemodReport::getLastCode() { return m_lastCode; } +void SWGSELCALDemodReport::setLastCode(QString* value) { if (m_lastCode != value) { delete m_lastCode; m_lastCode = value; } m_lastCodeIsSet = true; } +QString* SWGSELCALDemodReport::getLastTimestamp() { return m_lastTimestamp; } +void SWGSELCALDemodReport::setLastTimestamp(QString* value) { if (m_lastTimestamp != value) { delete m_lastTimestamp; m_lastTimestamp = value; } m_lastTimestampIsSet = true; } +qint64 SWGSELCALDemodReport::getLastFrequency() { return m_lastFrequency; } +void SWGSELCALDemodReport::setLastFrequency(qint64 value) { m_lastFrequency = value; m_lastFrequencyIsSet = true; } +float SWGSELCALDemodReport::getLastRssi() { return m_lastRssi; } +void SWGSELCALDemodReport::setLastRssi(float value) { m_lastRssi = value; m_lastRssiIsSet = true; } +float SWGSELCALDemodReport::getLastSnr() { return m_lastSnr; } +void SWGSELCALDemodReport::setLastSnr(float value) { m_lastSnr = value; m_lastSnrIsSet = true; } +qint64 SWGSELCALDemodReport::getCallCount() { return m_callCount; } +void SWGSELCALDemodReport::setCallCount(qint64 value) { m_callCount = value; m_callCountIsSet = true; } +qint32 SWGSELCALDemodReport::getCarrierLocked() { return m_carrierLocked; } +void SWGSELCALDemodReport::setCarrierLocked(qint32 value) { m_carrierLocked = value; m_carrierLockedIsSet = true; } +float SWGSELCALDemodReport::getCarrierFrequencyOffset() { return m_carrierFrequencyOffset; } +void SWGSELCALDemodReport::setCarrierFrequencyOffset(float value) { m_carrierFrequencyOffset = value; m_carrierFrequencyOffsetIsSet = true; } +float SWGSELCALDemodReport::getToneFrequencyOffset() { return m_toneFrequencyOffset; } +void SWGSELCALDemodReport::setToneFrequencyOffset(float value) { m_toneFrequencyOffset = value; m_toneFrequencyOffsetIsSet = true; } +qint32 SWGSELCALDemodReport::getSquelchOpen() { return m_squelchOpen; } +void SWGSELCALDemodReport::setSquelchOpen(qint32 value) { m_squelchOpen = value; m_squelchOpenIsSet = true; } +} diff --git a/swagger/sdrangel/code/qt5/client/SWGSELCALDemodReport.h b/swagger/sdrangel/code/qt5/client/SWGSELCALDemodReport.h new file mode 100644 index 000000000..193ced60e --- /dev/null +++ b/swagger/sdrangel/code/qt5/client/SWGSELCALDemodReport.h @@ -0,0 +1,82 @@ +// SPDX-License-Identifier: GPL-3.0-or-later +// Qt model for SELCALDemod.yaml, following the Swagger client model interface. +#ifndef SWGSELCALDemodReport_H_ +#define SWGSELCALDemodReport_H_ +#include +#include +#include "SWGObject.h" +#include "export.h" + +namespace SWGSDRangel { +class SWG_API SWGSELCALDemodReport : public SWGObject { +public: + SWGSELCALDemodReport(); + explicit SWGSELCALDemodReport(QString* json); + ~SWGSELCALDemodReport() override; + void init(); + void cleanup(); + QString asJson() override; + QJsonObject* asJsonObject() override; + void fromJsonObject(QJsonObject& json) override; + SWGSELCALDemodReport* fromJson(QString& json) override; + bool isSet() override; + double getChannelPowerDb(); + void setChannelPowerDb(double value); + qint32 getChannelSampleRate(); + void setChannelSampleRate(qint32 value); + qint32 getAudioSampleRate(); + void setAudioSampleRate(qint32 value); + QString* getState(); + void setState(QString* value); + QString* getLastCode(); + void setLastCode(QString* value); + QString* getLastTimestamp(); + void setLastTimestamp(QString* value); + qint64 getLastFrequency(); + void setLastFrequency(qint64 value); + float getLastRssi(); + void setLastRssi(float value); + float getLastSnr(); + void setLastSnr(float value); + qint64 getCallCount(); + void setCallCount(qint64 value); + qint32 getCarrierLocked(); + void setCarrierLocked(qint32 value); + float getCarrierFrequencyOffset(); + void setCarrierFrequencyOffset(float value); + float getToneFrequencyOffset(); + void setToneFrequencyOffset(float value); + qint32 getSquelchOpen(); + void setSquelchOpen(qint32 value); +private: + qint32 m_squelchOpen = 0; + bool m_squelchOpenIsSet = false; + float m_toneFrequencyOffset = 0; + bool m_toneFrequencyOffsetIsSet = false; + float m_carrierFrequencyOffset = 0; + bool m_carrierFrequencyOffsetIsSet = false; + qint32 m_carrierLocked = 0; + bool m_carrierLockedIsSet = false; + double m_channelPowerDb = 0; + bool m_channelPowerDbIsSet = false; + qint32 m_channelSampleRate = 0; + bool m_channelSampleRateIsSet = false; + qint32 m_audioSampleRate = 0; + bool m_audioSampleRateIsSet = false; + QString* m_state = nullptr; + bool m_stateIsSet = false; + QString* m_lastCode = nullptr; + bool m_lastCodeIsSet = false; + QString* m_lastTimestamp = nullptr; + bool m_lastTimestampIsSet = false; + qint64 m_lastFrequency = 0; + bool m_lastFrequencyIsSet = false; + float m_lastRssi = 0; + bool m_lastRssiIsSet = false; + float m_lastSnr = 0; + bool m_lastSnrIsSet = false; + qint64 m_callCount = 0; + bool m_callCountIsSet = false; +}; +} +#endif diff --git a/swagger/sdrangel/code/qt5/client/SWGSELCALDemodSettings.cpp b/swagger/sdrangel/code/qt5/client/SWGSELCALDemodSettings.cpp new file mode 100644 index 000000000..5f03f2e75 --- /dev/null +++ b/swagger/sdrangel/code/qt5/client/SWGSELCALDemodSettings.cpp @@ -0,0 +1,174 @@ +// SPDX-License-Identifier: GPL-3.0-or-later +#include "SWGSELCALDemodSettings.h" +#include "SWGHelpers.h" +#include +namespace SWGSDRangel { +SWGSELCALDemodSettings::SWGSELCALDemodSettings() = default; +SWGSELCALDemodSettings::SWGSELCALDemodSettings(QString* json) { init(); if (json) { fromJson(*json); } } +SWGSELCALDemodSettings::~SWGSELCALDemodSettings() { cleanup(); } +void SWGSELCALDemodSettings::cleanup() +{ + delete m_audioDeviceName; m_audioDeviceName = nullptr; + delete m_filter; m_filter = nullptr; + delete m_udpAddress; m_udpAddress = nullptr; + delete m_logFilename; m_logFilename = nullptr; + delete m_title; m_title = nullptr; + delete m_reverseAPIAddress; m_reverseAPIAddress = nullptr; + delete m_channelMarker; m_channelMarker = nullptr; + delete m_rollupState; m_rollupState = nullptr; +} +void SWGSELCALDemodSettings::init() +{ + cleanup(); + m_squelch = 0; m_squelchIsSet = false; + m_autoToneFrequencyOffset = 0; m_autoToneFrequencyOffsetIsSet = false; + m_inputFrequencyOffset = 0; m_inputFrequencyOffsetIsSet = false; + m_rfBandwidth = 0; m_rfBandwidthIsSet = false; + m_modulation = 0; m_modulationIsSet = false; + m_toneFrequencyOffset = 0; m_toneFrequencyOffsetIsSet = false; + m_threshold = 0; m_thresholdIsSet = false; + m_volume = 0; m_volumeIsSet = false; + m_audioMute = 0; m_audioMuteIsSet = false; + m_audioDeviceName = new QString(); m_audioDeviceNameIsSet = false; + m_filter = new QString(); m_filterIsSet = false; + m_udpEnabled = 0; m_udpEnabledIsSet = false; + m_udpAddress = new QString(); m_udpAddressIsSet = false; + m_udpPort = 0; m_udpPortIsSet = false; + m_logFilename = new QString(); m_logFilenameIsSet = false; + m_logEnabled = 0; m_logEnabledIsSet = false; + m_rgbColor = 0; m_rgbColorIsSet = false; + m_title = new QString(); m_titleIsSet = false; + m_streamIndex = 0; m_streamIndexIsSet = false; + m_useReverseAPI = 0; m_useReverseAPIIsSet = false; + m_reverseAPIAddress = new QString(); m_reverseAPIAddressIsSet = false; + m_reverseAPIPort = 0; m_reverseAPIPortIsSet = false; + m_reverseAPIDeviceIndex = 0; m_reverseAPIDeviceIndexIsSet = false; + m_reverseAPIChannelIndex = 0; m_reverseAPIChannelIndexIsSet = false; + m_channelMarker = new SWGChannelMarker(); m_channelMarkerIsSet = false; + m_rollupState = new SWGRollupState(); m_rollupStateIsSet = false; +} +SWGSELCALDemodSettings* SWGSELCALDemodSettings::fromJson(QString& json) +{ + auto object = QJsonDocument::fromJson(json.toUtf8()).object(); fromJsonObject(object); return this; +} +void SWGSELCALDemodSettings::fromJsonObject(QJsonObject& json) +{ + if (json.contains("squelch")) { ::SWGSDRangel::setValue(&m_squelch,json["squelch"],"qint32",""); m_squelchIsSet = true; } + if (json.contains("autoToneFrequencyOffset")) { ::SWGSDRangel::setValue(&m_autoToneFrequencyOffset,json["autoToneFrequencyOffset"],"qint32",""); m_autoToneFrequencyOffsetIsSet = true; } + if (json.contains("inputFrequencyOffset")) { ::SWGSDRangel::setValue(&m_inputFrequencyOffset,json["inputFrequencyOffset"],"qint64",""); m_inputFrequencyOffsetIsSet = true; } + if (json.contains("rfBandwidth")) { ::SWGSDRangel::setValue(&m_rfBandwidth,json["rfBandwidth"],"float",""); m_rfBandwidthIsSet = true; } + if (json.contains("modulation")) { ::SWGSDRangel::setValue(&m_modulation,json["modulation"],"qint32",""); m_modulationIsSet = true; } + if (json.contains("toneFrequencyOffset")) { ::SWGSDRangel::setValue(&m_toneFrequencyOffset,json["toneFrequencyOffset"],"float",""); m_toneFrequencyOffsetIsSet = true; } + if (json.contains("threshold")) { ::SWGSDRangel::setValue(&m_threshold,json["threshold"],"float",""); m_thresholdIsSet = true; } + if (json.contains("volume")) { ::SWGSDRangel::setValue(&m_volume,json["volume"],"float",""); m_volumeIsSet = true; } + if (json.contains("audioMute")) { ::SWGSDRangel::setValue(&m_audioMute,json["audioMute"],"qint32",""); m_audioMuteIsSet = true; } + if (json.contains("audioDeviceName")) { ::SWGSDRangel::setValue(&m_audioDeviceName,json["audioDeviceName"],"QString","QString"); m_audioDeviceNameIsSet = true; } + if (json.contains("filter")) { ::SWGSDRangel::setValue(&m_filter,json["filter"],"QString","QString"); m_filterIsSet = true; } + if (json.contains("udpEnabled")) { ::SWGSDRangel::setValue(&m_udpEnabled,json["udpEnabled"],"qint32",""); m_udpEnabledIsSet = true; } + if (json.contains("udpAddress")) { ::SWGSDRangel::setValue(&m_udpAddress,json["udpAddress"],"QString","QString"); m_udpAddressIsSet = true; } + if (json.contains("udpPort")) { ::SWGSDRangel::setValue(&m_udpPort,json["udpPort"],"qint32",""); m_udpPortIsSet = true; } + if (json.contains("logFilename")) { ::SWGSDRangel::setValue(&m_logFilename,json["logFilename"],"QString","QString"); m_logFilenameIsSet = true; } + if (json.contains("logEnabled")) { ::SWGSDRangel::setValue(&m_logEnabled,json["logEnabled"],"qint32",""); m_logEnabledIsSet = true; } + if (json.contains("rgbColor")) { ::SWGSDRangel::setValue(&m_rgbColor,json["rgbColor"],"qint32",""); m_rgbColorIsSet = true; } + if (json.contains("title")) { ::SWGSDRangel::setValue(&m_title,json["title"],"QString","QString"); m_titleIsSet = true; } + if (json.contains("streamIndex")) { ::SWGSDRangel::setValue(&m_streamIndex,json["streamIndex"],"qint32",""); m_streamIndexIsSet = true; } + if (json.contains("useReverseAPI")) { ::SWGSDRangel::setValue(&m_useReverseAPI,json["useReverseAPI"],"qint32",""); m_useReverseAPIIsSet = true; } + if (json.contains("reverseAPIAddress")) { ::SWGSDRangel::setValue(&m_reverseAPIAddress,json["reverseAPIAddress"],"QString","QString"); m_reverseAPIAddressIsSet = true; } + if (json.contains("reverseAPIPort")) { ::SWGSDRangel::setValue(&m_reverseAPIPort,json["reverseAPIPort"],"qint32",""); m_reverseAPIPortIsSet = true; } + if (json.contains("reverseAPIDeviceIndex")) { ::SWGSDRangel::setValue(&m_reverseAPIDeviceIndex,json["reverseAPIDeviceIndex"],"qint32",""); m_reverseAPIDeviceIndexIsSet = true; } + if (json.contains("reverseAPIChannelIndex")) { ::SWGSDRangel::setValue(&m_reverseAPIChannelIndex,json["reverseAPIChannelIndex"],"qint32",""); m_reverseAPIChannelIndexIsSet = true; } + if (json.contains("channelMarker")) { ::SWGSDRangel::setValue(&m_channelMarker,json["channelMarker"],"SWGChannelMarker","SWGChannelMarker"); m_channelMarkerIsSet = true; } + if (json.contains("rollupState")) { ::SWGSDRangel::setValue(&m_rollupState,json["rollupState"],"SWGRollupState","SWGRollupState"); m_rollupStateIsSet = true; } +} +QString SWGSELCALDemodSettings::asJson() +{ + auto* object = asJsonObject(); QString result = QJsonDocument(*object).toJson(); delete object; return result; +} +QJsonObject* SWGSELCALDemodSettings::asJsonObject() +{ + auto* object = new QJsonObject(); + if (m_squelchIsSet) { object->insert("squelch",QJsonValue(m_squelch)); } + if (m_autoToneFrequencyOffsetIsSet) { object->insert("autoToneFrequencyOffset",QJsonValue(m_autoToneFrequencyOffset)); } + if (m_inputFrequencyOffsetIsSet) { object->insert("inputFrequencyOffset",QJsonValue(m_inputFrequencyOffset)); } + if (m_rfBandwidthIsSet) { object->insert("rfBandwidth",QJsonValue(m_rfBandwidth)); } + if (m_modulationIsSet) { object->insert("modulation",QJsonValue(m_modulation)); } + if (m_toneFrequencyOffsetIsSet) { object->insert("toneFrequencyOffset",QJsonValue(m_toneFrequencyOffset)); } + if (m_thresholdIsSet) { object->insert("threshold",QJsonValue(m_threshold)); } + if (m_volumeIsSet) { object->insert("volume",QJsonValue(m_volume)); } + if (m_audioMuteIsSet) { object->insert("audioMute",QJsonValue(m_audioMute)); } + if (m_audioDeviceName && (m_audioDeviceNameIsSet || !m_audioDeviceName->isEmpty())) { toJsonValue(QString("audioDeviceName"),m_audioDeviceName,object,QString("QString")); } + if (m_filter && (m_filterIsSet || !m_filter->isEmpty())) { toJsonValue(QString("filter"),m_filter,object,QString("QString")); } + if (m_udpEnabledIsSet) { object->insert("udpEnabled",QJsonValue(m_udpEnabled)); } + if (m_udpAddress && (m_udpAddressIsSet || !m_udpAddress->isEmpty())) { toJsonValue(QString("udpAddress"),m_udpAddress,object,QString("QString")); } + if (m_udpPortIsSet) { object->insert("udpPort",QJsonValue(m_udpPort)); } + if (m_logFilename && (m_logFilenameIsSet || !m_logFilename->isEmpty())) { toJsonValue(QString("logFilename"),m_logFilename,object,QString("QString")); } + if (m_logEnabledIsSet) { object->insert("logEnabled",QJsonValue(m_logEnabled)); } + if (m_rgbColorIsSet) { object->insert("rgbColor",QJsonValue(m_rgbColor)); } + if (m_title && (m_titleIsSet || !m_title->isEmpty())) { toJsonValue(QString("title"),m_title,object,QString("QString")); } + if (m_streamIndexIsSet) { object->insert("streamIndex",QJsonValue(m_streamIndex)); } + if (m_useReverseAPIIsSet) { object->insert("useReverseAPI",QJsonValue(m_useReverseAPI)); } + if (m_reverseAPIAddress && (m_reverseAPIAddressIsSet || !m_reverseAPIAddress->isEmpty())) { toJsonValue(QString("reverseAPIAddress"),m_reverseAPIAddress,object,QString("QString")); } + if (m_reverseAPIPortIsSet) { object->insert("reverseAPIPort",QJsonValue(m_reverseAPIPort)); } + if (m_reverseAPIDeviceIndexIsSet) { object->insert("reverseAPIDeviceIndex",QJsonValue(m_reverseAPIDeviceIndex)); } + if (m_reverseAPIChannelIndexIsSet) { object->insert("reverseAPIChannelIndex",QJsonValue(m_reverseAPIChannelIndex)); } + if (m_channelMarker && (m_channelMarkerIsSet || m_channelMarker->isSet())) { toJsonValue(QString("channelMarker"),m_channelMarker,object,QString("SWGChannelMarker")); } + if (m_rollupState && (m_rollupStateIsSet || m_rollupState->isSet())) { toJsonValue(QString("rollupState"),m_rollupState,object,QString("SWGRollupState")); } + return object; +} +bool SWGSELCALDemodSettings::isSet() +{ + return m_squelchIsSet || m_autoToneFrequencyOffsetIsSet || m_inputFrequencyOffsetIsSet || m_rfBandwidthIsSet || m_modulationIsSet || m_toneFrequencyOffsetIsSet || m_thresholdIsSet || m_volumeIsSet || m_audioMuteIsSet || m_audioDeviceNameIsSet || m_filterIsSet || m_udpEnabledIsSet || m_udpAddressIsSet || m_udpPortIsSet || m_logFilenameIsSet || m_logEnabledIsSet || m_rgbColorIsSet || m_titleIsSet || m_streamIndexIsSet || m_useReverseAPIIsSet || m_reverseAPIAddressIsSet || m_reverseAPIPortIsSet || m_reverseAPIDeviceIndexIsSet || m_reverseAPIChannelIndexIsSet || m_channelMarkerIsSet || m_rollupStateIsSet; +} +qint64 SWGSELCALDemodSettings::getInputFrequencyOffset() { return m_inputFrequencyOffset; } +void SWGSELCALDemodSettings::setInputFrequencyOffset(qint64 value) { m_inputFrequencyOffset = value; m_inputFrequencyOffsetIsSet = true; } +float SWGSELCALDemodSettings::getRfBandwidth() { return m_rfBandwidth; } +void SWGSELCALDemodSettings::setRfBandwidth(float value) { m_rfBandwidth = value; m_rfBandwidthIsSet = true; } +qint32 SWGSELCALDemodSettings::getModulation() { return m_modulation; } +void SWGSELCALDemodSettings::setModulation(qint32 value) { m_modulation = value; m_modulationIsSet = true; } +float SWGSELCALDemodSettings::getToneFrequencyOffset() { return m_toneFrequencyOffset; } +void SWGSELCALDemodSettings::setToneFrequencyOffset(float value) { m_toneFrequencyOffset = value; m_toneFrequencyOffsetIsSet = true; } +float SWGSELCALDemodSettings::getThreshold() { return m_threshold; } +void SWGSELCALDemodSettings::setThreshold(float value) { m_threshold = value; m_thresholdIsSet = true; } +float SWGSELCALDemodSettings::getVolume() { return m_volume; } +void SWGSELCALDemodSettings::setVolume(float value) { m_volume = value; m_volumeIsSet = true; } +qint32 SWGSELCALDemodSettings::getAudioMute() { return m_audioMute; } +void SWGSELCALDemodSettings::setAudioMute(qint32 value) { m_audioMute = value; m_audioMuteIsSet = true; } +QString* SWGSELCALDemodSettings::getAudioDeviceName() { return m_audioDeviceName; } +void SWGSELCALDemodSettings::setAudioDeviceName(QString* value) { if (m_audioDeviceName != value) { delete m_audioDeviceName; m_audioDeviceName = value; } m_audioDeviceNameIsSet = true; } +QString* SWGSELCALDemodSettings::getFilter() { return m_filter; } +void SWGSELCALDemodSettings::setFilter(QString* value) { if (m_filter != value) { delete m_filter; m_filter = value; } m_filterIsSet = true; } +qint32 SWGSELCALDemodSettings::getUdpEnabled() { return m_udpEnabled; } +void SWGSELCALDemodSettings::setUdpEnabled(qint32 value) { m_udpEnabled = value; m_udpEnabledIsSet = true; } +QString* SWGSELCALDemodSettings::getUdpAddress() { return m_udpAddress; } +void SWGSELCALDemodSettings::setUdpAddress(QString* value) { if (m_udpAddress != value) { delete m_udpAddress; m_udpAddress = value; } m_udpAddressIsSet = true; } +qint32 SWGSELCALDemodSettings::getUdpPort() { return m_udpPort; } +void SWGSELCALDemodSettings::setUdpPort(qint32 value) { m_udpPort = value; m_udpPortIsSet = true; } +QString* SWGSELCALDemodSettings::getLogFilename() { return m_logFilename; } +void SWGSELCALDemodSettings::setLogFilename(QString* value) { if (m_logFilename != value) { delete m_logFilename; m_logFilename = value; } m_logFilenameIsSet = true; } +qint32 SWGSELCALDemodSettings::getLogEnabled() { return m_logEnabled; } +void SWGSELCALDemodSettings::setLogEnabled(qint32 value) { m_logEnabled = value; m_logEnabledIsSet = true; } +qint32 SWGSELCALDemodSettings::getRgbColor() { return m_rgbColor; } +void SWGSELCALDemodSettings::setRgbColor(qint32 value) { m_rgbColor = value; m_rgbColorIsSet = true; } +QString* SWGSELCALDemodSettings::getTitle() { return m_title; } +void SWGSELCALDemodSettings::setTitle(QString* value) { if (m_title != value) { delete m_title; m_title = value; } m_titleIsSet = true; } +qint32 SWGSELCALDemodSettings::getStreamIndex() { return m_streamIndex; } +void SWGSELCALDemodSettings::setStreamIndex(qint32 value) { m_streamIndex = value; m_streamIndexIsSet = true; } +qint32 SWGSELCALDemodSettings::getUseReverseApi() { return m_useReverseAPI; } +void SWGSELCALDemodSettings::setUseReverseApi(qint32 value) { m_useReverseAPI = value; m_useReverseAPIIsSet = true; } +QString* SWGSELCALDemodSettings::getReverseApiAddress() { return m_reverseAPIAddress; } +void SWGSELCALDemodSettings::setReverseApiAddress(QString* value) { if (m_reverseAPIAddress != value) { delete m_reverseAPIAddress; m_reverseAPIAddress = value; } m_reverseAPIAddressIsSet = true; } +qint32 SWGSELCALDemodSettings::getReverseApiPort() { return m_reverseAPIPort; } +void SWGSELCALDemodSettings::setReverseApiPort(qint32 value) { m_reverseAPIPort = value; m_reverseAPIPortIsSet = true; } +qint32 SWGSELCALDemodSettings::getReverseApiDeviceIndex() { return m_reverseAPIDeviceIndex; } +void SWGSELCALDemodSettings::setReverseApiDeviceIndex(qint32 value) { m_reverseAPIDeviceIndex = value; m_reverseAPIDeviceIndexIsSet = true; } +qint32 SWGSELCALDemodSettings::getReverseApiChannelIndex() { return m_reverseAPIChannelIndex; } +void SWGSELCALDemodSettings::setReverseApiChannelIndex(qint32 value) { m_reverseAPIChannelIndex = value; m_reverseAPIChannelIndexIsSet = true; } +SWGChannelMarker* SWGSELCALDemodSettings::getChannelMarker() { return m_channelMarker; } +void SWGSELCALDemodSettings::setChannelMarker(SWGChannelMarker* value) { if (m_channelMarker != value) { delete m_channelMarker; m_channelMarker = value; } m_channelMarkerIsSet = true; } +SWGRollupState* SWGSELCALDemodSettings::getRollupState() { return m_rollupState; } +void SWGSELCALDemodSettings::setRollupState(SWGRollupState* value) { if (m_rollupState != value) { delete m_rollupState; m_rollupState = value; } m_rollupStateIsSet = true; } +qint32 SWGSELCALDemodSettings::getAutoToneFrequencyOffset() { return m_autoToneFrequencyOffset; } +void SWGSELCALDemodSettings::setAutoToneFrequencyOffset(qint32 value) { m_autoToneFrequencyOffset = value; m_autoToneFrequencyOffsetIsSet = true; } +qint32 SWGSELCALDemodSettings::getSquelch() { return m_squelch; } +void SWGSELCALDemodSettings::setSquelch(qint32 value) { m_squelch = value; m_squelchIsSet = true; } +} diff --git a/swagger/sdrangel/code/qt5/client/SWGSELCALDemodSettings.h b/swagger/sdrangel/code/qt5/client/SWGSELCALDemodSettings.h new file mode 100644 index 000000000..2bf0094d2 --- /dev/null +++ b/swagger/sdrangel/code/qt5/client/SWGSELCALDemodSettings.h @@ -0,0 +1,132 @@ +// SPDX-License-Identifier: GPL-3.0-or-later +// Qt model for SELCALDemod.yaml, following the Swagger client model interface. +#ifndef SWGSELCALDemodSettings_H_ +#define SWGSELCALDemodSettings_H_ +#include +#include +#include "SWGObject.h" +#include "export.h" +#include "SWGChannelMarker.h" +#include "SWGRollupState.h" + +namespace SWGSDRangel { +class SWG_API SWGSELCALDemodSettings : public SWGObject { +public: + SWGSELCALDemodSettings(); + explicit SWGSELCALDemodSettings(QString* json); + ~SWGSELCALDemodSettings() override; + void init(); + void cleanup(); + QString asJson() override; + QJsonObject* asJsonObject() override; + void fromJsonObject(QJsonObject& json) override; + SWGSELCALDemodSettings* fromJson(QString& json) override; + bool isSet() override; + qint64 getInputFrequencyOffset(); + void setInputFrequencyOffset(qint64 value); + float getRfBandwidth(); + void setRfBandwidth(float value); + qint32 getModulation(); + void setModulation(qint32 value); + float getToneFrequencyOffset(); + void setToneFrequencyOffset(float value); + float getThreshold(); + void setThreshold(float value); + float getVolume(); + void setVolume(float value); + qint32 getAudioMute(); + void setAudioMute(qint32 value); + QString* getAudioDeviceName(); + void setAudioDeviceName(QString* value); + QString* getFilter(); + void setFilter(QString* value); + qint32 getUdpEnabled(); + void setUdpEnabled(qint32 value); + QString* getUdpAddress(); + void setUdpAddress(QString* value); + qint32 getUdpPort(); + void setUdpPort(qint32 value); + QString* getLogFilename(); + void setLogFilename(QString* value); + qint32 getLogEnabled(); + void setLogEnabled(qint32 value); + qint32 getRgbColor(); + void setRgbColor(qint32 value); + QString* getTitle(); + void setTitle(QString* value); + qint32 getStreamIndex(); + void setStreamIndex(qint32 value); + qint32 getUseReverseApi(); + void setUseReverseApi(qint32 value); + QString* getReverseApiAddress(); + void setReverseApiAddress(QString* value); + qint32 getReverseApiPort(); + void setReverseApiPort(qint32 value); + qint32 getReverseApiDeviceIndex(); + void setReverseApiDeviceIndex(qint32 value); + qint32 getReverseApiChannelIndex(); + void setReverseApiChannelIndex(qint32 value); + SWGChannelMarker* getChannelMarker(); + void setChannelMarker(SWGChannelMarker* value); + SWGRollupState* getRollupState(); + void setRollupState(SWGRollupState* value); + qint32 getAutoToneFrequencyOffset(); + void setAutoToneFrequencyOffset(qint32 value); + qint32 getSquelch(); + void setSquelch(qint32 value); +private: + qint32 m_squelch = 0; + bool m_squelchIsSet = false; + qint32 m_autoToneFrequencyOffset = 0; + bool m_autoToneFrequencyOffsetIsSet = false; + qint64 m_inputFrequencyOffset = 0; + bool m_inputFrequencyOffsetIsSet = false; + float m_rfBandwidth = 0; + bool m_rfBandwidthIsSet = false; + qint32 m_modulation = 0; + bool m_modulationIsSet = false; + float m_toneFrequencyOffset = 0; + bool m_toneFrequencyOffsetIsSet = false; + float m_threshold = 0; + bool m_thresholdIsSet = false; + float m_volume = 0; + bool m_volumeIsSet = false; + qint32 m_audioMute = 0; + bool m_audioMuteIsSet = false; + QString* m_audioDeviceName = nullptr; + bool m_audioDeviceNameIsSet = false; + QString* m_filter = nullptr; + bool m_filterIsSet = false; + qint32 m_udpEnabled = 0; + bool m_udpEnabledIsSet = false; + QString* m_udpAddress = nullptr; + bool m_udpAddressIsSet = false; + qint32 m_udpPort = 0; + bool m_udpPortIsSet = false; + QString* m_logFilename = nullptr; + bool m_logFilenameIsSet = false; + qint32 m_logEnabled = 0; + bool m_logEnabledIsSet = false; + qint32 m_rgbColor = 0; + bool m_rgbColorIsSet = false; + QString* m_title = nullptr; + bool m_titleIsSet = false; + qint32 m_streamIndex = 0; + bool m_streamIndexIsSet = false; + qint32 m_useReverseAPI = 0; + bool m_useReverseAPIIsSet = false; + QString* m_reverseAPIAddress = nullptr; + bool m_reverseAPIAddressIsSet = false; + qint32 m_reverseAPIPort = 0; + bool m_reverseAPIPortIsSet = false; + qint32 m_reverseAPIDeviceIndex = 0; + bool m_reverseAPIDeviceIndexIsSet = false; + qint32 m_reverseAPIChannelIndex = 0; + bool m_reverseAPIChannelIndexIsSet = false; + SWGChannelMarker* m_channelMarker = nullptr; + bool m_channelMarkerIsSet = false; + SWGRollupState* m_rollupState = nullptr; + bool m_rollupStateIsSet = false; +}; +} +#endif From 6db188ee3acf54e2c68abc1a0764e4cfb2efc715 Mon Sep 17 00:00:00 2001 From: Jon Beniston Date: Tue, 13 Oct 2026 11:43:17 +0100 Subject: [PATCH 4/4] Update readme --- plugins/channelrx/demodselcal/readme.md | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/plugins/channelrx/demodselcal/readme.md b/plugins/channelrx/demodselcal/readme.md index 67ca43bf6..74ea75316 100644 --- a/plugins/channelrx/demodselcal/readme.md +++ b/plugins/channelrx/demodselcal/readme.md @@ -93,10 +93,9 @@ comparable with them.

9: Carrier status

-The text beside the volume dial shows the measured carrier offset and the +The status text shows the measured carrier offset and the tone offset measured by the decoder, for example `Carrier +6.7 Hz, tones +6.7 Hz`. -Without tones, the tone offset is the offset that the decoder expects. In AM, it -shows whether coherent detection is in use. +In AM, it shows whether coherent detection is in use.

10: Volume

@@ -187,16 +186,12 @@ in its tooltip. The default is `selcal_log.csv`.

21: Download SELCAL database

Click the download button to download the database of SELCAL codes assigned to -aircraft, from https://sdrangel.org/downloads/selcal.zip. It is used to display +aircraft. It is used to display the registrations, types and images of aircraft assigned a received code. If the aircraft database used by the ADS-B demodulator has not been downloaded, you are asked whether to download it too (45MB): it provides aircraft types and images. The databases are stored in SDRangel's application data directory. -The aircraft database is read when the channel is created. If it is downloaded -later, for example by the ADS-B demodulator, it is read when the next call is -received. -

22: Read calls from a CSV log

Click the load button to select an existing CSV log and add its calls to the