From 868b86a44f25201f955ba5e73ff71d3ca767b01f Mon Sep 17 00:00:00 2001 From: Jon Beniston Date: Thu, 15 Oct 2026 18:03:45 +0100 Subject: [PATCH 1/4] Add 802.15.4 demodulator. --- CMakeLists.txt | 1 + doc/img/IEEE_802_15_4_Demod_frames.png | Bin 0 -> 141078 bytes doc/img/IEEE_802_15_4_Demod_plugin.png | Bin 0 -> 22013 bytes plugins/channelrx/CMakeLists.txt | 6 + .../channelrx/demod802.15.4/CMakeLists.txt | 73 ++ .../demod802.15.4/ieee_802_15_4_demod.cpp | 898 ++++++++++++++ .../demod802.15.4/ieee_802_15_4_demod.h | 231 ++++ .../ieee_802_15_4_demodbaseband.cpp | 188 +++ .../ieee_802_15_4_demodbaseband.h | 103 ++ .../demod802.15.4/ieee_802_15_4_demodgui.cpp | 930 +++++++++++++++ .../demod802.15.4/ieee_802_15_4_demodgui.h | 160 +++ .../demod802.15.4/ieee_802_15_4_demodgui.ui | 1050 +++++++++++++++++ .../ieee_802_15_4_demodplugin.cpp | 92 ++ .../demod802.15.4/ieee_802_15_4_demodplugin.h | 49 + .../ieee_802_15_4_demodreceiver.cpp | 935 +++++++++++++++ .../ieee_802_15_4_demodreceiver.h | 273 +++++ .../ieee_802_15_4_demodsettings.cpp | 468 ++++++++ .../ieee_802_15_4_demodsettings.h | 108 ++ .../demod802.15.4/ieee_802_15_4_demodsink.cpp | 246 ++++ .../demod802.15.4/ieee_802_15_4_demodsink.h | 116 ++ .../ieee_802_15_4_demodwebapiadapter.cpp | 54 + .../ieee_802_15_4_demodwebapiadapter.h | 50 + plugins/channelrx/demod802.15.4/readme.md | 202 ++++ plugins/feature/mcpserver/mcpdocs.cpp | 1 + sdrbase/CMakeLists.txt | 2 + sdrbase/resources/webapi.qrc | 1 + .../doc/swagger/include/ChannelReport.yaml | 2 + .../doc/swagger/include/ChannelSettings.yaml | 2 + .../swagger/include/IEEE_802_15_4_Demod.yaml | 120 ++ sdrbase/util/ieee_802_15_4.cpp | 717 +++++++++++ sdrbase/util/ieee_802_15_4.h | 165 +++ sdrbase/webapi/webapirequestmapper.cpp | 6 + sdrbase/webapi/webapiutils.cpp | 2 + .../api/swagger/include/ChannelReport.yaml | 2 + .../api/swagger/include/ChannelSettings.yaml | 2 + .../swagger/include/IEEE_802_15_4_Demod.yaml | 120 ++ .../code/qt5/client/SWGChannelReport.cpp | 25 + .../code/qt5/client/SWGChannelReport.h | 7 + .../code/qt5/client/SWGChannelSettings.cpp | 25 + .../code/qt5/client/SWGChannelSettings.h | 7 + .../client/SWGIEEE_802_15_4_DemodReport.cpp | 178 +++ .../qt5/client/SWGIEEE_802_15_4_DemodReport.h | 77 ++ .../client/SWGIEEE_802_15_4_DemodSettings.cpp | 750 ++++++++++++ .../client/SWGIEEE_802_15_4_DemodSettings.h | 225 ++++ .../code/qt5/client/SWGModelFactory.h | 12 + 45 files changed, 8681 insertions(+) create mode 100644 doc/img/IEEE_802_15_4_Demod_frames.png create mode 100644 doc/img/IEEE_802_15_4_Demod_plugin.png create mode 100644 plugins/channelrx/demod802.15.4/CMakeLists.txt create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demod.cpp create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demod.h create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodbaseband.cpp create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodbaseband.h create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodgui.cpp create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodgui.h create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodgui.ui create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodplugin.cpp create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodplugin.h create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodreceiver.cpp create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodreceiver.h create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsettings.cpp create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsettings.h create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsink.cpp create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsink.h create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodwebapiadapter.cpp create mode 100644 plugins/channelrx/demod802.15.4/ieee_802_15_4_demodwebapiadapter.h create mode 100644 plugins/channelrx/demod802.15.4/readme.md create mode 100644 sdrbase/resources/webapi/doc/swagger/include/IEEE_802_15_4_Demod.yaml create mode 100644 sdrbase/util/ieee_802_15_4.cpp create mode 100644 sdrbase/util/ieee_802_15_4.h create mode 100644 swagger/sdrangel/api/swagger/include/IEEE_802_15_4_Demod.yaml create mode 100644 swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodReport.cpp create mode 100644 swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodReport.h create mode 100644 swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodSettings.cpp create mode 100644 swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodSettings.h diff --git a/CMakeLists.txt b/CMakeLists.txt index fa8d84225..d6a42b481 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -176,6 +176,7 @@ 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_DEMOD802.15.4 "Enable channelrx demod802.15.4 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/IEEE_802_15_4_Demod_frames.png b/doc/img/IEEE_802_15_4_Demod_frames.png new file mode 100644 index 0000000000000000000000000000000000000000..7dd032f13e865ecf5f57e333dceb2a14323671b8 GIT binary patch literal 141078 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 D%sdem literal 0 HcmV?d00001 diff --git a/doc/img/IEEE_802_15_4_Demod_plugin.png b/doc/img/IEEE_802_15_4_Demod_plugin.png new file mode 100644 index 0000000000000000000000000000000000000000..96a12bacb8011c40acf906e2ec1dffb148887221 GIT binary patch literal 22013 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 literal 0 HcmV?d00001 diff --git a/plugins/channelrx/CMakeLists.txt b/plugins/channelrx/CMakeLists.txt index 4b9c3a11f..58a60c440 100644 --- a/plugins/channelrx/CMakeLists.txt +++ b/plugins/channelrx/CMakeLists.txt @@ -306,3 +306,9 @@ if(ENABLE_CHANNELRX_DEMODSELCAL) else() message(STATUS "Not building demodselcal (ENABLE_CHANNELRX_DEMODSELCAL=${ENABLE_CHANNELRX_DEMODSELCAL})") endif() + +if (ENABLE_CHANNELRX_DEMOD802.15.4) + add_subdirectory(demod802.15.4) +else() + message(STATUS "Not building demod802.15.4 (ENABLE_CHANNELRX_DEMOD802.15.4=${ENABLE_CHANNELRX_DEMOD802.15.4})") +endif() diff --git a/plugins/channelrx/demod802.15.4/CMakeLists.txt b/plugins/channelrx/demod802.15.4/CMakeLists.txt new file mode 100644 index 000000000..47d47dda7 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/CMakeLists.txt @@ -0,0 +1,73 @@ +project(demod_ieee_802_15_4) + +set(demod_ieee_802_15_4_SOURCES + ieee_802_15_4_demod.cpp + ieee_802_15_4_demodsettings.cpp + ieee_802_15_4_demodbaseband.cpp + ieee_802_15_4_demodsink.cpp + ieee_802_15_4_demodreceiver.cpp + ieee_802_15_4_demodplugin.cpp + ieee_802_15_4_demodwebapiadapter.cpp +) + +set(demod_ieee_802_15_4_HEADERS + ieee_802_15_4_demod.h + ieee_802_15_4_demodsettings.h + ieee_802_15_4_demodbaseband.h + ieee_802_15_4_demodsink.h + ieee_802_15_4_demodreceiver.h + ieee_802_15_4_demodplugin.h + ieee_802_15_4_demodwebapiadapter.h +) + +include_directories( + ${CMAKE_SOURCE_DIR}/swagger/sdrangel/code/qt5/client +) + +if(NOT SERVER_MODE) + set(demod_ieee_802_15_4_SOURCES + ${demod_ieee_802_15_4_SOURCES} + ieee_802_15_4_demodgui.cpp + ieee_802_15_4_demodgui.ui + ) + set(demod_ieee_802_15_4_HEADERS + ${demod_ieee_802_15_4_HEADERS} + ieee_802_15_4_demodgui.h + ) + set(TARGET_NAME ${PLUGINS_PREFIX}demodieee_802_15_4) + set(TARGET_LIB "Qt::Widgets") + set(TARGET_LIB_GUI "sdrgui") + set(INSTALL_FOLDER ${INSTALL_PLUGINS_DIR}) +else() + set(TARGET_NAME ${PLUGINSSRV_PREFIX}demodieee_802_15_4srv) + set(TARGET_LIB "") + set(TARGET_LIB_GUI "") + set(INSTALL_FOLDER ${INSTALL_PLUGINSSRV_DIR}) +endif() + +if(NOT Qt6_FOUND) + add_library(${TARGET_NAME} ${demod_ieee_802_15_4_SOURCES}) +else() + qt_add_plugin(${TARGET_NAME} CLASS_NAME IEEE_802_15_4_DemodPlugin) + target_sources(${TARGET_NAME} PRIVATE ${demod_ieee_802_15_4_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} + swagger +) + +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/demod802.15.4/ieee_802_15_4_demod.cpp b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demod.cpp new file mode 100644 index 000000000..7bb7bc121 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demod.cpp @@ -0,0 +1,898 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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 "SWGChannelSettings.h" +#include "SWGWorkspaceInfo.h" +#include "SWGIEEE_802_15_4_DemodSettings.h" +#include "SWGChannelReport.h" + +#include "dsp/dspcommands.h" +#include "device/deviceapi.h" +#include "settings/serializable.h" +#include "util/db.h" +#include "util/ieee_802_15_4.h" +#include "maincore.h" + +#include "ieee_802_15_4_demod.h" + +MESSAGE_CLASS_DEFINITION(IEEE_802_15_4_Demod::MsgConfigureIEEE_802_15_4_Demod, Message) +MESSAGE_CLASS_DEFINITION(IEEE_802_15_4_Demod::MsgFrame, Message) + +const char * const IEEE_802_15_4_Demod::m_channelIdURI = "sdrangel.channelrx.demod802.15.4"; +const char * const IEEE_802_15_4_Demod::m_channelId = "IEEE_802_15_4_Demod"; + +IEEE_802_15_4_Demod::IEEE_802_15_4_Demod(DeviceAPI *deviceAPI) : + ChannelAPI(m_channelIdURI, ChannelAPI::StreamSingleSink), + m_deviceAPI(deviceAPI), + m_basebandSampleRate(0), + m_centerFrequency(0), + m_zepSequenceNumber(0), + m_logPCAP(false), + m_framesOK(0), + m_framesBad(0) +{ + setObjectName(m_channelId); + m_thread.setObjectName("802154DemodBB"); + + m_basebandSink = new IEEE_802_15_4_DemodBaseband(this); + m_basebandSink->setMessageQueueToChannel(getInputMessageQueue()); + 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, + &IEEE_802_15_4_Demod::networkManagerFinished + ); + QObject::connect( + this, + &ChannelAPI::indexInDeviceSetChanged, + this, + &IEEE_802_15_4_Demod::handleIndexInDeviceSetChanged + ); +} + +IEEE_802_15_4_Demod::~IEEE_802_15_4_Demod() +{ + QObject::disconnect( + m_networkManager, + &QNetworkAccessManager::finished, + this, + &IEEE_802_15_4_Demod::networkManagerFinished + ); + delete m_networkManager; + m_deviceAPI->removeChannelSinkAPI(this); + m_deviceAPI->removeChannelSink(this, true); + + if (m_basebandSink->isRunning()) { + stop(); + } + + delete m_basebandSink; + + if (m_logFile.isOpen()) + { + m_logStream.flush(); + m_logFile.close(); + } +} + +void IEEE_802_15_4_Demod::setDeviceAPI(DeviceAPI *deviceAPI) +{ + if (deviceAPI != m_deviceAPI) + { + m_deviceAPI->removeChannelSinkAPI(this); + m_deviceAPI->removeChannelSink(this, false); + m_deviceAPI = deviceAPI; + m_deviceAPI->addChannelSink(this); + m_deviceAPI->addChannelSinkAPI(this); + } +} + +uint32_t IEEE_802_15_4_Demod::getNumberOfDeviceStreams() const +{ + return m_deviceAPI->getNbSourceStreams(); +} + +void IEEE_802_15_4_Demod::feed(const SampleVector::const_iterator& begin, const SampleVector::const_iterator& end, bool firstOfBurst) +{ + (void) firstOfBurst; + m_basebandSink->feed(begin, end); +} + +void IEEE_802_15_4_Demod::start() +{ + qDebug("IEEE_802_15_4_Demod::start"); + + m_basebandSink->reset(); + m_basebandSink->startWork(); + m_thread.start(); + + DSPSignalNotification *dspMsg = new DSPSignalNotification(m_basebandSampleRate, m_centerFrequency); + m_basebandSink->getInputMessageQueue()->push(dspMsg); + + IEEE_802_15_4_DemodBaseband::MsgConfigureIEEE_802_15_4_DemodBaseband *msg = IEEE_802_15_4_DemodBaseband::MsgConfigureIEEE_802_15_4_DemodBaseband::create(QStringList(), m_settings, true); + m_basebandSink->getInputMessageQueue()->push(msg); +} + +void IEEE_802_15_4_Demod::stop() +{ + qDebug("IEEE_802_15_4_Demod::stop"); + m_basebandSink->stopWork(); + m_thread.quit(); + m_thread.wait(); +} + +bool IEEE_802_15_4_Demod::handleMessage(const Message& cmd) +{ + if (MsgConfigureIEEE_802_15_4_Demod::match(cmd)) + { + MsgConfigureIEEE_802_15_4_Demod& cfg = (MsgConfigureIEEE_802_15_4_Demod&) cmd; + qDebug() << "IEEE_802_15_4_Demod::handleMessage: MsgConfigureIEEE_802_15_4_Demod"; + 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() << "IEEE_802_15_4_Demod::handleMessage: DSPSignalNotification"; + m_basebandSink->getInputMessageQueue()->push(rep); + + if (getMessageQueueToGUI()) { + getMessageQueueToGUI()->push(new DSPSignalNotification(notif)); + } + + return true; + } + else if (MsgFrame::match(cmd)) + { + const MsgFrame& frame = (const MsgFrame&) cmd; + + if (frame.getFCSOK()) { + m_framesOK++; + } else { + m_framesBad++; + } + + if (!frame.getFCSOK() && !m_settings.m_showBadFCS) { + return true; + } + + // Forward to GUI + if (getMessageQueueToGUI()) { + getMessageQueueToGUI()->push(new MsgFrame(frame)); + } + + // Forward via UDP + if (m_settings.m_udpEnabled) + { + if (m_settings.m_udpFormat == IEEE_802_15_4_DemodSettings::ZEP) + { + int channel = getChannelNumber(m_centerFrequency + m_settings.m_inputFrequencyOffset); + int lqi = std::max(0, std::min(255, (int) std::round(frame.getLQI() * 255.0f))); + QByteArray zep = encodeZEP(frame.getPSDU(), frame.getDateTime(), channel < 0 ? 0 : channel, lqi, m_zepSequenceNumber++); + m_udpSocket.writeDatagram(zep, QHostAddress(m_settings.m_udpAddress), m_settings.m_udpPort); + } + else + { + m_udpSocket.writeDatagram(frame.getPSDU(), QHostAddress(m_settings.m_udpAddress), m_settings.m_udpPort); + } + } + + // Write to log file + if (m_logFile.isOpen()) { + logFrame(frame); + } + + return true; + } + else + { + return false; + } +} + +int IEEE_802_15_4_Demod::getChannelNumber(qint64 frequency) +{ + // 10.1.2.2 - Channel numbering for 868 MHz, 915 MHz, and 2450 MHz bands + const qint64 tolerance = 100000; + + if (std::abs(frequency - 868300000LL) <= tolerance) { + return 0; + } + for (int k = 1; k <= 10; k++) + { + if (std::abs(frequency - (906000000LL + 2000000LL * (k - 1))) <= tolerance) { + return k; + } + } + for (int k = 11; k <= 26; k++) + { + if (std::abs(frequency - (2405000000LL + 5000000LL * (k - 11))) <= tolerance) { + return k; + } + } + + return -1; +} + +QByteArray IEEE_802_15_4_Demod::encodeZEP(const QByteArray& psdu, const QDateTime& dateTime, int channel, int lqi, quint32 sequenceNumber) +{ + QByteArray zep; + QDataStream s(&zep, QIODevice::WriteOnly); + s.setByteOrder(QDataStream::BigEndian); + + // NTP timestamp: seconds since 1900 and fraction + const quint64 ntpEpochOffset = 2208988800ULL; + qint64 ms = dateTime.toMSecsSinceEpoch(); + quint32 seconds = (quint32) (ms / 1000 + ntpEpochOffset); + quint32 fraction = (quint32) (((ms % 1000) * 4294967296ULL) / 1000); + + s << (quint8) 'E' << (quint8) 'X'; // Preamble + s << (quint8) 2; // Version + s << (quint8) 1; // Type: Data + s << (quint8) channel; // Channel ID + s << (quint16) 0; // Device ID + s << (quint8) 1; // CRC mode: PSDU includes FCS + s << (quint8) lqi; // LQI + s << seconds << fraction; // Timestamp + s << sequenceNumber; + for (int i = 0; i < 10; i++) { + s << (quint8) 0; // Reserved + } + s << (quint8) psdu.size(); // Length + zep.append(psdu); + + return zep; +} + +void IEEE_802_15_4_Demod::openLog(const QString& filename) +{ + m_logFile.setFileName(filename); + m_logPCAP = filename.endsWith(".pcap", Qt::CaseInsensitive); + + // Only append to an existing PCAP file if it has the same link type, otherwise + // the frames would be misinterpreted, or the file wouldn't be readable at all + if (m_logPCAP && (m_logFile.size() > 0)) + { + bool valid = false; + QFile existing(filename); + + if (existing.open(QIODevice::ReadOnly)) + { + QByteArray header = existing.read(24); + + if (header.size() == 24) + { + quint32 magic = qFromLittleEndian(header.constData()); + quint32 linkType = qFromLittleEndian(header.constData() + 20); + valid = (magic == 0xa1b2c3d4) && (linkType == m_pcapLinkTypeIEEE802154WithFCS); + } + } + + if (!valid) + { + qWarning() << "IEEE_802_15_4_Demod::openLog - Not logging to" << filename << "as it is not a PCAP file with IEEE 802.15.4 link type"; + return; + } + } + + if (m_logFile.open(QIODevice::WriteOnly | QIODevice::Append | (m_logPCAP ? QIODevice::NotOpen : QIODevice::Text))) + { + qDebug() << "IEEE_802_15_4_Demod::openLog - Logging to: " << filename; + bool newFile = m_logFile.size() == 0; + + if (m_logPCAP) + { + if (newFile) + { + // PCAP global header + QDataStream s(&m_logFile); + s.setByteOrder(QDataStream::LittleEndian); + s << (quint32) 0xa1b2c3d4 << (quint16) 2 << (quint16) 4 << (qint32) 0 << (quint32) 0 + << (quint32) 65535 << m_pcapLinkTypeIEEE802154WithFCS; + } + } + else + { + m_logStream.setDevice(&m_logFile); + + if (newFile) { + m_logStream << "Date,Time,Data,FCS,Type,Seq,Dst PAN,Dst Addr,Src PAN,Src Addr,Info,Payload,Power,SNR,LQI,Freq Offset\n"; + } + } + } + else + { + qDebug() << "IEEE_802_15_4_Demod::openLog - Unable to open log file: " << filename; + } +} + +void IEEE_802_15_4_Demod::logFrame(const MsgFrame& frame) +{ + if (m_logPCAP) + { + QDataStream s(&m_logFile); + s.setByteOrder(QDataStream::LittleEndian); + qint64 ms = frame.getDateTime().toMSecsSinceEpoch(); + s << (quint32) (ms / 1000) << (quint32) ((ms % 1000) * 1000) + << (quint32) frame.getPSDU().size() << (quint32) frame.getPSDU().size(); + s.writeRawData(frame.getPSDU().data(), frame.getPSDU().size()); + m_logFile.flush(); + } + else + { + IEEE_802_15_4_FrameDecoder mac; + mac.decode(frame.getPSDU()); + + m_logStream << frame.getDateTime().date().toString() << "," + << frame.getDateTime().time().toString() << "," + << frame.getPSDU().toHex() << "," + << (frame.getFCSOK() ? "OK" : "Bad") << "," + << mac.getFrameTypeString() << "," + << (mac.m_hasSeqNo ? QString::number(mac.m_seqNo) : "") << "," + << mac.getDestPANIDString() << "," + << mac.getDestAddressString() << "," + << mac.getSrcPANIDString() << "," + << mac.getSrcAddressString() << "," + << "\"" << mac.toString() << "\"," + << mac.m_payload.toHex() << "," + << QString::number(frame.getPowerDB(), 'f', 1) << "," + << QString::number(frame.getSNR(), 'f', 1) << "," + << QString::number(frame.getLQI(), 'f', 2) << "," + << QString::number(frame.getFrequencyOffset(), 'f', 0) << "\n"; + m_logStream.flush(); + } +} + +ScopeVis *IEEE_802_15_4_Demod::getScopeSink() +{ + return m_basebandSink->getScopeSink(); +} + +void IEEE_802_15_4_Demod::setCenterFrequency(qint64 frequency) +{ + IEEE_802_15_4_DemodSettings settings = m_settings; + settings.m_inputFrequencyOffset = frequency; + applySettings(QStringList("inputFrequencyOffset"), settings, false); + + if (m_guiMessageQueue) // forward to GUI if any + { + MsgConfigureIEEE_802_15_4_Demod *msgToGUI = MsgConfigureIEEE_802_15_4_Demod::create(QStringList("inputFrequencyOffset"), settings, false); + m_guiMessageQueue->push(msgToGUI); + } +} + +void IEEE_802_15_4_Demod::applySettings(const QStringList& settingsKeys, const IEEE_802_15_4_DemodSettings& settings, bool force) +{ + qDebug() << "IEEE_802_15_4_Demod::applySettings:" << settings.getDebugString(settingsKeys, force); + + if (settingsKeys.contains("streamIndex") && (m_settings.m_streamIndex != settings.m_streamIndex)) + { + if (m_deviceAPI->getSampleMIMO()) // change of stream is possible for MIMO devices only + { + m_deviceAPI->removeChannelSinkAPI(this); + m_deviceAPI->removeChannelSink(this, 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); + } + } + + IEEE_802_15_4_DemodBaseband::MsgConfigureIEEE_802_15_4_DemodBaseband *msg = IEEE_802_15_4_DemodBaseband::MsgConfigureIEEE_802_15_4_DemodBaseband::create(settingsKeys, settings, force); + m_basebandSink->getInputMessageQueue()->push(msg); + + // Forward all settings changes when reverse API is enabled, not just changes to the reverse API settings + bool useReverseAPI = (settingsKeys.contains("useReverseAPI") || force) ? settings.m_useReverseAPI : m_settings.m_useReverseAPI; + + if (useReverseAPI) + { + bool fullUpdate = ((settingsKeys.contains("useReverseAPI") && (m_settings.m_useReverseAPI != settings.m_useReverseAPI)) && settings.m_useReverseAPI) || + (settingsKeys.contains("reverseAPIAddress") && (m_settings.m_reverseAPIAddress != settings.m_reverseAPIAddress)) || + (settingsKeys.contains("reverseAPIPort") && (m_settings.m_reverseAPIPort != settings.m_reverseAPIPort)) || + (settingsKeys.contains("reverseAPIDeviceIndex") && (m_settings.m_reverseAPIDeviceIndex != settings.m_reverseAPIDeviceIndex)) || + (settingsKeys.contains("reverseAPIChannelIndex") && (m_settings.m_reverseAPIChannelIndex != 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()) { + openLog(settings.m_logFilename); + } + } + + if (force) { + m_settings = settings; + } else { + m_settings.applySettings(settingsKeys, settings); + } +} + +QByteArray IEEE_802_15_4_Demod::serialize() const +{ + return m_settings.serialize(); +} + +bool IEEE_802_15_4_Demod::deserialize(const QByteArray& data) +{ + if (m_settings.deserialize(data)) + { + MsgConfigureIEEE_802_15_4_Demod *msg = MsgConfigureIEEE_802_15_4_Demod::create(QStringList(), m_settings, true); + m_inputMessageQueue.push(msg); + return true; + } + else + { + m_settings.resetToDefaults(); + MsgConfigureIEEE_802_15_4_Demod *msg = MsgConfigureIEEE_802_15_4_Demod::create(QStringList(), m_settings, true); + m_inputMessageQueue.push(msg); + return false; + } +} + +int IEEE_802_15_4_Demod::webapiSettingsGet( + SWGSDRangel::SWGChannelSettings& response, + QString& errorMessage) +{ + (void) errorMessage; + response.setIeee802154DemodSettings(new SWGSDRangel::SWGIEEE_802_15_4_DemodSettings()); + response.getIeee802154DemodSettings()->init(); + webapiFormatChannelSettings(response, m_settings); + return 200; +} + +int IEEE_802_15_4_Demod::webapiWorkspaceGet( + SWGSDRangel::SWGWorkspaceInfo& response, + QString& errorMessage) +{ + (void) errorMessage; + response.setIndex(m_settings.m_workspaceIndex); + return 200; +} + +int IEEE_802_15_4_Demod::webapiSettingsPutPatch( + bool force, + const QStringList& channelSettingsKeys, + SWGSDRangel::SWGChannelSettings& response, + QString& errorMessage) +{ + if (channelSettingsKeys.contains("phy")) + { + IEEE_802_15_4_PHY phy; + QString *phyName = response.getIeee802154DemodSettings()->getPhy(); + + if (!phyName || !phy.fromString(*phyName) || phy.toString().isEmpty()) + { + errorMessage = QString("phy must be one of: %1").arg(IEEE_802_15_4_PHY::getPHYNames().join(", ")); + return 400; + } + } + + IEEE_802_15_4_DemodSettings settings = m_settings; + webapiUpdateChannelSettings(settings, channelSettingsKeys, response); + + MsgConfigureIEEE_802_15_4_Demod *msg = MsgConfigureIEEE_802_15_4_Demod::create(channelSettingsKeys, settings, force); + m_inputMessageQueue.push(msg); + + if (m_guiMessageQueue) // forward to GUI if any + { + MsgConfigureIEEE_802_15_4_Demod *msgToGUI = MsgConfigureIEEE_802_15_4_Demod::create(channelSettingsKeys, settings, force); + m_guiMessageQueue->push(msgToGUI); + } + + webapiFormatChannelSettings(response, settings); + + return 200; +} + +int IEEE_802_15_4_Demod::webapiReportGet( + SWGSDRangel::SWGChannelReport& response, + QString& errorMessage) +{ + (void) errorMessage; + response.setIeee802154DemodReport(new SWGSDRangel::SWGIEEE_802_15_4_DemodReport()); + response.getIeee802154DemodReport()->init(); + webapiFormatChannelReport(response); + return 200; +} + +void IEEE_802_15_4_Demod::webapiUpdateChannelSettings( + IEEE_802_15_4_DemodSettings& settings, + const QStringList& channelSettingsKeys, + SWGSDRangel::SWGChannelSettings& response) +{ + SWGSDRangel::SWGIEEE_802_15_4_DemodSettings *s = response.getIeee802154DemodSettings(); + + if (channelSettingsKeys.contains("inputFrequencyOffset")) { + settings.m_inputFrequencyOffset = s->getInputFrequencyOffset(); + } + if (channelSettingsKeys.contains("phy")) { + settings.m_phy = *s->getPhy(); + } + if (channelSettingsKeys.contains("rfBandwidth")) { + settings.m_rfBandwidth = s->getRfBandwidth(); + } + if (channelSettingsKeys.contains("samplesPerChip")) { + settings.m_samplesPerChip = std::max(2, std::min(16, s->getSamplesPerChip())); + } + if (channelSettingsKeys.contains("maxFrequencyOffset")) { + settings.m_maxFrequencyOffset = s->getMaxFrequencyOffset(); + } + if (channelSettingsKeys.contains("threshold")) { + settings.m_threshold = std::max(IEEE_802_15_4_DemodSettings::m_minThreshold, + std::min(IEEE_802_15_4_DemodSettings::m_maxThreshold, s->getThreshold())); + } + if (channelSettingsKeys.contains("showBadFCS")) { + settings.m_showBadFCS = s->getShowBadFcs() != 0; + } + if (channelSettingsKeys.contains("filterFrameType")) { + settings.m_filterFrameType = (IEEE_802_15_4_DemodSettings::FrameTypeFilter) std::max(0, std::min(5, s->getFilterFrameType())); + } + if (channelSettingsKeys.contains("filterPANID")) { + settings.m_filterPANID = *s->getFilterPanid(); + } + if (channelSettingsKeys.contains("filterAddress")) { + settings.m_filterAddress = *s->getFilterAddress(); + } + if (channelSettingsKeys.contains("udpEnabled")) { + settings.m_udpEnabled = s->getUdpEnabled() != 0; + } + if (channelSettingsKeys.contains("udpAddress")) { + settings.m_udpAddress = *s->getUdpAddress(); + } + if (channelSettingsKeys.contains("udpPort")) { + settings.m_udpPort = s->getUdpPort(); + } + if (channelSettingsKeys.contains("udpFormat")) { + settings.m_udpFormat = s->getUdpFormat() == 1 ? IEEE_802_15_4_DemodSettings::Raw : IEEE_802_15_4_DemodSettings::ZEP; + } + if (channelSettingsKeys.contains("logFilename")) { + settings.m_logFilename = *s->getLogFilename(); + } + if (channelSettingsKeys.contains("logEnabled")) { + settings.m_logEnabled = s->getLogEnabled() != 0; + } + if (channelSettingsKeys.contains("useFileTime")) { + settings.m_useFileTime = s->getUseFileTime() != 0; + } + if (channelSettingsKeys.contains("rgbColor")) { + settings.m_rgbColor = s->getRgbColor(); + } + if (channelSettingsKeys.contains("title")) { + settings.m_title = *s->getTitle(); + } + if (channelSettingsKeys.contains("streamIndex")) { + settings.m_streamIndex = s->getStreamIndex(); + } + if (channelSettingsKeys.contains("useReverseAPI")) { + settings.m_useReverseAPI = s->getUseReverseApi() != 0; + } + if (channelSettingsKeys.contains("reverseAPIAddress")) { + settings.m_reverseAPIAddress = *s->getReverseApiAddress(); + } + if (channelSettingsKeys.contains("reverseAPIPort")) { + settings.m_reverseAPIPort = s->getReverseApiPort(); + } + if (channelSettingsKeys.contains("reverseAPIDeviceIndex")) { + settings.m_reverseAPIDeviceIndex = s->getReverseApiDeviceIndex(); + } + if (channelSettingsKeys.contains("reverseAPIChannelIndex")) { + settings.m_reverseAPIChannelIndex = s->getReverseApiChannelIndex(); + } + if (settings.m_scopeGUI && channelSettingsKeys.contains("scopeConfig")) { + settings.m_scopeGUI->updateFrom(channelSettingsKeys, s->getScopeConfig()); + } + if (settings.m_channelMarker && channelSettingsKeys.contains("channelMarker")) { + settings.m_channelMarker->updateFrom(channelSettingsKeys, s->getChannelMarker()); + } + if (settings.m_rollupState && channelSettingsKeys.contains("rollupState")) { + settings.m_rollupState->updateFrom(channelSettingsKeys, s->getRollupState()); + } +} + +static void setString(QString *(SWGSDRangel::SWGIEEE_802_15_4_DemodSettings::*get)(), + void (SWGSDRangel::SWGIEEE_802_15_4_DemodSettings::*set)(QString*), + SWGSDRangel::SWGIEEE_802_15_4_DemodSettings *s, + const QString& value) +{ + if ((s->*get)()) { + *(s->*get)() = value; + } else { + (s->*set)(new QString(value)); + } +} + +void IEEE_802_15_4_Demod::webapiFormatChannelSettings(SWGSDRangel::SWGChannelSettings& response, const IEEE_802_15_4_DemodSettings& settings) +{ + typedef SWGSDRangel::SWGIEEE_802_15_4_DemodSettings S; + S *s = response.getIeee802154DemodSettings(); + + s->setInputFrequencyOffset(settings.m_inputFrequencyOffset); + setString(&S::getPhy, &S::setPhy, s, settings.m_phy); + s->setRfBandwidth(settings.m_rfBandwidth); + s->setSamplesPerChip(settings.m_samplesPerChip); + s->setMaxFrequencyOffset(settings.m_maxFrequencyOffset); + s->setThreshold(settings.m_threshold); + s->setShowBadFcs(settings.m_showBadFCS ? 1 : 0); + s->setFilterFrameType((int) settings.m_filterFrameType); + setString(&S::getFilterPanid, &S::setFilterPanid, s, settings.m_filterPANID); + setString(&S::getFilterAddress, &S::setFilterAddress, s, settings.m_filterAddress); + s->setUdpEnabled(settings.m_udpEnabled ? 1 : 0); + setString(&S::getUdpAddress, &S::setUdpAddress, s, settings.m_udpAddress); + s->setUdpPort(settings.m_udpPort); + s->setUdpFormat((int) settings.m_udpFormat); + setString(&S::getLogFilename, &S::setLogFilename, s, settings.m_logFilename); + s->setLogEnabled(settings.m_logEnabled ? 1 : 0); + s->setUseFileTime(settings.m_useFileTime ? 1 : 0); + s->setRgbColor(settings.m_rgbColor); + setString(&S::getTitle, &S::setTitle, s, settings.m_title); + s->setStreamIndex(settings.m_streamIndex); + s->setUseReverseApi(settings.m_useReverseAPI ? 1 : 0); + setString(&S::getReverseApiAddress, &S::setReverseApiAddress, s, settings.m_reverseAPIAddress); + s->setReverseApiPort(settings.m_reverseAPIPort); + s->setReverseApiDeviceIndex(settings.m_reverseAPIDeviceIndex); + s->setReverseApiChannelIndex(settings.m_reverseAPIChannelIndex); + + if (settings.m_scopeGUI) + { + if (s->getScopeConfig()) + { + settings.m_scopeGUI->formatTo(s->getScopeConfig()); + } + else + { + SWGSDRangel::SWGGLScope *swgGLScope = new SWGSDRangel::SWGGLScope(); + settings.m_scopeGUI->formatTo(swgGLScope); + s->setScopeConfig(swgGLScope); + } + } + + if (settings.m_channelMarker) + { + if (s->getChannelMarker()) + { + settings.m_channelMarker->formatTo(s->getChannelMarker()); + } + else + { + SWGSDRangel::SWGChannelMarker *swgChannelMarker = new SWGSDRangel::SWGChannelMarker(); + settings.m_channelMarker->formatTo(swgChannelMarker); + s->setChannelMarker(swgChannelMarker); + } + } + + if (settings.m_rollupState) + { + if (s->getRollupState()) + { + settings.m_rollupState->formatTo(s->getRollupState()); + } + else + { + SWGSDRangel::SWGRollupState *swgRollupState = new SWGSDRangel::SWGRollupState(); + settings.m_rollupState->formatTo(swgRollupState); + s->setRollupState(swgRollupState); + } + } +} + +void IEEE_802_15_4_Demod::webapiFormatChannelReport(SWGSDRangel::SWGChannelReport& response) +{ + double magsqAvg, magsqPeak; + int nbMagsqSamples; + getMagSqLevels(magsqAvg, magsqPeak, nbMagsqSamples); + + response.getIeee802154DemodReport()->setChannelPowerDb(CalcDb::dbPower(magsqAvg)); + response.getIeee802154DemodReport()->setChannelSampleRate(m_basebandSink->getChannelSampleRate()); + response.getIeee802154DemodReport()->setFramesOk((qint32) m_framesOK); + response.getIeee802154DemodReport()->setFramesBadFcs((qint32) m_framesBad); +} + +void IEEE_802_15_4_Demod::webapiReverseSendSettings(const QList& channelSettingsKeys, const IEEE_802_15_4_DemodSettings& 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 IEEE_802_15_4_Demod::webapiFormatChannelSettings( + const QList& channelSettingsKeys, + SWGSDRangel::SWGChannelSettings *swgChannelSettings, + const IEEE_802_15_4_DemodSettings& settings, + bool force +) +{ + typedef SWGSDRangel::SWGIEEE_802_15_4_DemodSettings S; + + swgChannelSettings->setDirection(0); // Single sink (Rx) + swgChannelSettings->setOriginatorChannelIndex(getIndexInDeviceSet()); + swgChannelSettings->setOriginatorDeviceSetIndex(getDeviceSetIndex()); + swgChannelSettings->setChannelType(new QString(m_channelId)); + swgChannelSettings->setIeee802154DemodSettings(new S()); + S *s = swgChannelSettings->getIeee802154DemodSettings(); + + // transfer data that has been modified. When force is on transfer all data except reverse API data + + if (channelSettingsKeys.contains("inputFrequencyOffset") || force) { + s->setInputFrequencyOffset(settings.m_inputFrequencyOffset); + } + if (channelSettingsKeys.contains("phy") || force) { + s->setPhy(new QString(settings.m_phy)); + } + if (channelSettingsKeys.contains("rfBandwidth") || force) { + s->setRfBandwidth(settings.m_rfBandwidth); + } + if (channelSettingsKeys.contains("samplesPerChip") || force) { + s->setSamplesPerChip(settings.m_samplesPerChip); + } + if (channelSettingsKeys.contains("maxFrequencyOffset") || force) { + s->setMaxFrequencyOffset(settings.m_maxFrequencyOffset); + } + if (channelSettingsKeys.contains("threshold") || force) { + s->setThreshold(settings.m_threshold); + } + if (channelSettingsKeys.contains("showBadFCS") || force) { + s->setShowBadFcs(settings.m_showBadFCS ? 1 : 0); + } + if (channelSettingsKeys.contains("filterFrameType") || force) { + s->setFilterFrameType((int) settings.m_filterFrameType); + } + if (channelSettingsKeys.contains("filterPANID") || force) { + s->setFilterPanid(new QString(settings.m_filterPANID)); + } + if (channelSettingsKeys.contains("filterAddress") || force) { + s->setFilterAddress(new QString(settings.m_filterAddress)); + } + if (channelSettingsKeys.contains("udpEnabled") || force) { + s->setUdpEnabled(settings.m_udpEnabled ? 1 : 0); + } + if (channelSettingsKeys.contains("udpAddress") || force) { + s->setUdpAddress(new QString(settings.m_udpAddress)); + } + if (channelSettingsKeys.contains("udpPort") || force) { + s->setUdpPort(settings.m_udpPort); + } + if (channelSettingsKeys.contains("udpFormat") || force) { + s->setUdpFormat((int) settings.m_udpFormat); + } + if (channelSettingsKeys.contains("logFilename") || force) { + s->setLogFilename(new QString(settings.m_logFilename)); + } + if (channelSettingsKeys.contains("logEnabled") || force) { + s->setLogEnabled(settings.m_logEnabled ? 1 : 0); + } + if (channelSettingsKeys.contains("useFileTime") || force) { + s->setUseFileTime(settings.m_useFileTime ? 1 : 0); + } + if (channelSettingsKeys.contains("rgbColor") || force) { + s->setRgbColor(settings.m_rgbColor); + } + if (channelSettingsKeys.contains("title") || force) { + s->setTitle(new QString(settings.m_title)); + } + if (channelSettingsKeys.contains("streamIndex") || force) { + s->setStreamIndex(settings.m_streamIndex); + } + + if (settings.m_scopeGUI && (channelSettingsKeys.contains("scopeConfig") || force)) + { + SWGSDRangel::SWGGLScope *swgGLScope = new SWGSDRangel::SWGGLScope(); + settings.m_scopeGUI->formatTo(swgGLScope); + s->setScopeConfig(swgGLScope); + } + + if (settings.m_channelMarker && (channelSettingsKeys.contains("channelMarker") || force)) + { + SWGSDRangel::SWGChannelMarker *swgChannelMarker = new SWGSDRangel::SWGChannelMarker(); + settings.m_channelMarker->formatTo(swgChannelMarker); + s->setChannelMarker(swgChannelMarker); + } + + if (settings.m_rollupState && (channelSettingsKeys.contains("rollupState") || force)) + { + SWGSDRangel::SWGRollupState *swgRollupState = new SWGSDRangel::SWGRollupState(); + settings.m_rollupState->formatTo(swgRollupState); + s->setRollupState(swgRollupState); + } +} + +void IEEE_802_15_4_Demod::networkManagerFinished(QNetworkReply *reply) +{ + QNetworkReply::NetworkError replyError = reply->error(); + + if (replyError) + { + qWarning() << "IEEE_802_15_4_Demod::networkManagerFinished:" + << " error(" << (int) replyError + << "): " << replyError + << ": " << reply->errorString(); + } + else + { + QString answer = reply->readAll(); + answer.chop(1); // remove last \n + qDebug("IEEE_802_15_4_Demod::networkManagerFinished: reply:\n%s", answer.toStdString().c_str()); + } + + reply->deleteLater(); +} + +void IEEE_802_15_4_Demod::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 IEEE_802_15_4_Demod::getChannelSampleRate() const +{ + return m_basebandSink ? m_basebandSink->getChannelSampleRate() : 0; +} diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demod.h b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demod.h new file mode 100644 index 000000000..a3b76c02d --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demod.h @@ -0,0 +1,231 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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_IEEE_802_15_4_DEMOD_H +#define INCLUDE_IEEE_802_15_4_DEMOD_H + +#include +#include +#include +#include +#include +#include + +#include "dsp/basebandsamplesink.h" +#include "channel/channelapi.h" +#include "util/message.h" + +#include "ieee_802_15_4_demodbaseband.h" +#include "ieee_802_15_4_demodsettings.h" + +class QNetworkAccessManager; +class QNetworkReply; +class DeviceAPI; +class ScopeVis; + +class IEEE_802_15_4_Demod : public BasebandSampleSink, public ChannelAPI { +public: + class MsgConfigureIEEE_802_15_4_Demod : public Message { + MESSAGE_CLASS_DECLARATION + + public: + const IEEE_802_15_4_DemodSettings& getSettings() const { return m_settings; } + const QStringList& getSettingsKeys() const { return m_settingsKeys; } + bool getForce() const { return m_force; } + + static MsgConfigureIEEE_802_15_4_Demod* create(const QStringList& settingsKeys, const IEEE_802_15_4_DemodSettings& settings, bool force) + { + return new MsgConfigureIEEE_802_15_4_Demod(settingsKeys, settings, force); + } + + private: + IEEE_802_15_4_DemodSettings m_settings; + QStringList m_settingsKeys; + bool m_force; + + MsgConfigureIEEE_802_15_4_Demod(const QStringList& settingsKeys, const IEEE_802_15_4_DemodSettings& settings, bool force) : + Message(), + m_settings(settings), + m_settingsKeys(settingsKeys), + m_force(force) + { } + }; + + //! A received frame + class MsgFrame : public Message { + MESSAGE_CLASS_DECLARATION + + public: + const QByteArray& getPSDU() const { return m_psdu; } + QDateTime getDateTime() const { return m_dateTime; } + bool getFCSOK() const { return m_fcsOK; } + bool getCoherent() const { return m_coherent; } + float getFrequencyOffset() const { return m_frequencyOffset; } + float getLQI() const { return m_lqi; } + float getPowerDB() const { return m_powerDB; } + float getSNR() const { return m_snr; } + + static MsgFrame* create(const QByteArray& psdu, const QDateTime& dateTime, bool fcsOK, bool coherent, + float frequencyOffset, float lqi, float powerDB, float snr) + { + return new MsgFrame(psdu, dateTime, fcsOK, coherent, frequencyOffset, lqi, powerDB, snr); + } + + private: + QByteArray m_psdu; //!< MAC frame including FCS + QDateTime m_dateTime; + bool m_fcsOK; + bool m_coherent; //!< Received by coherent rather than non-coherent detector + float m_frequencyOffset; //!< Hz + float m_lqi; //!< 0-1 + float m_powerDB; + float m_snr; //!< dB + + MsgFrame(const QByteArray& psdu, const QDateTime& dateTime, bool fcsOK, bool coherent, + float frequencyOffset, float lqi, float powerDB, float snr) : + Message(), + m_psdu(psdu), + m_dateTime(dateTime), + m_fcsOK(fcsOK), + m_coherent(coherent), + m_frequencyOffset(frequencyOffset), + m_lqi(lqi), + m_powerDB(powerDB), + m_snr(snr) + { } + }; + + IEEE_802_15_4_Demod(DeviceAPI *deviceAPI); + virtual ~IEEE_802_15_4_Demod(); + 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 { return 0; } + 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 IEEE_802_15_4_DemodSettings& settings); + + static void webapiUpdateChannelSettings( + IEEE_802_15_4_DemodSettings& settings, + const QStringList& channelSettingsKeys, + SWGSDRangel::SWGChannelSettings& response); + + ScopeVis *getScopeSink(); + double getMagSq() const { return m_basebandSink->getMagSq(); } + + void getMagSqLevels(double& avg, double& peak, int& nbSamples) { + m_basebandSink->getMagSqLevels(avg, peak, nbSamples); + } + + uint32_t getNumberOfDeviceStreams() const; + + //! 802.15.4 channel number for a frequency, or -1 if not a channel centre frequency + static int getChannelNumber(qint64 frequency); + //! Encapsulate frame in ZEP v2, for Wireshark + static QByteArray encodeZEP(const QByteArray& psdu, const QDateTime& dateTime, int channel, int lqi, quint32 sequenceNumber); + + static const char * const m_channelIdURI; + static const char * const m_channelId; + +private: + static constexpr quint32 m_pcapLinkTypeIEEE802154WithFCS = 195; //!< PCAP link type for IEEE 802.15.4 frames including FCS + + DeviceAPI *m_deviceAPI; + QThread m_thread; + IEEE_802_15_4_DemodBaseband* m_basebandSink; + IEEE_802_15_4_DemodSettings m_settings; + int m_basebandSampleRate; //!< stored from device message used when starting baseband sink + qint64 m_centerFrequency; + QUdpSocket m_udpSocket; + quint32 m_zepSequenceNumber; + QFile m_logFile; + QTextStream m_logStream; + bool m_logPCAP; + quint64 m_framesOK; + quint64 m_framesBad; + + QNetworkAccessManager *m_networkManager; + QNetworkRequest m_networkRequest; + + virtual bool handleMessage(const Message& cmd); + void applySettings(const QStringList& settingsKeys, const IEEE_802_15_4_DemodSettings& settings, bool force = false); + void openLog(const QString& filename); + void logFrame(const MsgFrame& frame); + void webapiFormatChannelReport(SWGSDRangel::SWGChannelReport& response); + void webapiReverseSendSettings(const QList& channelSettingsKeys, const IEEE_802_15_4_DemodSettings& settings, bool force); + void webapiFormatChannelSettings( + const QList& channelSettingsKeys, + SWGSDRangel::SWGChannelSettings *swgChannelSettings, + const IEEE_802_15_4_DemodSettings& settings, + bool force + ); + +private slots: + void networkManagerFinished(QNetworkReply *reply); + void handleIndexInDeviceSetChanged(int index); +}; + +#endif // INCLUDE_IEEE_802_15_4_DEMOD_H diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodbaseband.cpp b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodbaseband.cpp new file mode 100644 index 000000000..89f4ab852 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodbaseband.cpp @@ -0,0 +1,188 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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 "ieee_802_15_4_demodbaseband.h" + +MESSAGE_CLASS_DEFINITION(IEEE_802_15_4_DemodBaseband::MsgConfigureIEEE_802_15_4_DemodBaseband, Message) + +IEEE_802_15_4_DemodBaseband::IEEE_802_15_4_DemodBaseband(IEEE_802_15_4_Demod *demod) : + m_sink(demod), + m_running(false) +{ + qDebug("IEEE_802_15_4_DemodBaseband::IEEE_802_15_4_DemodBaseband"); + + m_scopeSink.setNbStreams(IEEE_802_15_4_DemodSettings::m_scopeStreams); + m_sink.setScopeSink(&m_scopeSink); + m_sampleFifo.setSize(SampleSinkFifo::getSizePolicy(48000)); + m_channelizer = new DownChannelizer(&m_sink); +} + +IEEE_802_15_4_DemodBaseband::~IEEE_802_15_4_DemodBaseband() +{ + m_inputMessageQueue.clear(); + + delete m_channelizer; +} + +void IEEE_802_15_4_DemodBaseband::reset() +{ + QMutexLocker mutexLocker(&m_mutex); + m_inputMessageQueue.clear(); + m_sampleFifo.reset(); +} + +void IEEE_802_15_4_DemodBaseband::startWork() +{ + QMutexLocker mutexLocker(&m_mutex); + QObject::connect( + &m_sampleFifo, + &SampleSinkFifo::dataReady, + this, + &IEEE_802_15_4_DemodBaseband::handleData, + Qt::QueuedConnection + ); + connect(&m_inputMessageQueue, SIGNAL(messageEnqueued()), this, SLOT(handleInputMessages())); + m_running = true; +} + +void IEEE_802_15_4_DemodBaseband::stopWork() +{ + QMutexLocker mutexLocker(&m_mutex); + disconnect(&m_inputMessageQueue, SIGNAL(messageEnqueued()), this, SLOT(handleInputMessages())); + QObject::disconnect( + &m_sampleFifo, + &SampleSinkFifo::dataReady, + this, + &IEEE_802_15_4_DemodBaseband::handleData + ); + m_running = false; +} + +void IEEE_802_15_4_DemodBaseband::setChannel(ChannelAPI *channel) +{ + m_sink.setChannel(channel); +} + +void IEEE_802_15_4_DemodBaseband::feed(const SampleVector::const_iterator& begin, const SampleVector::const_iterator& end) +{ + m_sampleFifo.write(begin, end); +} + +void IEEE_802_15_4_DemodBaseband::handleData() +{ + QMutexLocker mutexLocker(&m_mutex); + + while ((m_sampleFifo.fill() > 0) && (m_inputMessageQueue.size() == 0)) + { + 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 IEEE_802_15_4_DemodBaseband::handleInputMessages() +{ + Message* message; + + while ((message = m_inputMessageQueue.pop())) + { + if (!handleMessage(*message)) { + qDebug("%s: unhandled message: %s", Q_FUNC_INFO, message->getIdentifier()); + } + delete message; + } +} + +bool IEEE_802_15_4_DemodBaseband::handleMessage(const Message& cmd) +{ + if (MsgConfigureIEEE_802_15_4_DemodBaseband::match(cmd)) + { + QMutexLocker mutexLocker(&m_mutex); + MsgConfigureIEEE_802_15_4_DemodBaseband& cfg = (MsgConfigureIEEE_802_15_4_DemodBaseband&) cmd; + qDebug() << "IEEE_802_15_4_DemodBaseband::handleMessage: MsgConfigureIEEE_802_15_4_DemodBaseband"; + + applySettings(cfg.getSettingsKeys(), cfg.getSettings(), cfg.getForce()); + + return true; + } + else if (DSPSignalNotification::match(cmd)) + { + QMutexLocker mutexLocker(&m_mutex); + DSPSignalNotification& notif = (DSPSignalNotification&) cmd; + qDebug() << "IEEE_802_15_4_DemodBaseband::handleMessage: DSPSignalNotification: basebandSampleRate: " << notif.getSampleRate(); + setBasebandSampleRate(notif.getSampleRate()); + m_sampleFifo.setSize(SampleSinkFifo::getSizePolicy(notif.getSampleRate())); + + return true; + } + else + { + return false; + } +} + +void IEEE_802_15_4_DemodBaseband::applySettings(const QStringList& settingsKeys, const IEEE_802_15_4_DemodSettings& settings, bool force) +{ + if ((settingsKeys.contains("inputFrequencyOffset") && (settings.m_inputFrequencyOffset != m_settings.m_inputFrequencyOffset)) + || (settingsKeys.contains("phy") && (settings.m_phy != m_settings.m_phy)) + || (settingsKeys.contains("samplesPerChip") && (settings.m_samplesPerChip != m_settings.m_samplesPerChip)) + || force) + { + m_channelizer->setChannelization(settings.getChannelSampleRate(), settings.m_inputFrequencyOffset); + m_sink.applyChannelSettings(m_channelizer->getChannelSampleRate(), m_channelizer->getChannelFrequencyOffset()); + } + + m_sink.applySettings(settingsKeys, settings, force); + + if (force) { + m_settings = settings; + } else { + m_settings.applySettings(settingsKeys, settings); + } +} + +int IEEE_802_15_4_DemodBaseband::getChannelSampleRate() const +{ + return m_channelizer->getChannelSampleRate(); +} + +void IEEE_802_15_4_DemodBaseband::setBasebandSampleRate(int sampleRate) +{ + m_channelizer->setBasebandSampleRate(sampleRate); + m_sink.applyChannelSettings(m_channelizer->getChannelSampleRate(), m_channelizer->getChannelFrequencyOffset()); +} diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodbaseband.h b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodbaseband.h new file mode 100644 index 000000000..4a65048a7 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodbaseband.h @@ -0,0 +1,103 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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_IEEE_802_15_4_DEMODBASEBAND_H +#define INCLUDE_IEEE_802_15_4_DEMODBASEBAND_H + +#include +#include + +#include "dsp/samplesinkfifo.h" +#include "dsp/scopevis.h" +#include "util/message.h" +#include "util/messagequeue.h" + +#include "ieee_802_15_4_demodsink.h" + +class DownChannelizer; +class ChannelAPI; +class IEEE_802_15_4_Demod; + +class IEEE_802_15_4_DemodBaseband : public QObject +{ + Q_OBJECT +public: + class MsgConfigureIEEE_802_15_4_DemodBaseband : public Message { + MESSAGE_CLASS_DECLARATION + + public: + const IEEE_802_15_4_DemodSettings& getSettings() const { return m_settings; } + const QStringList& getSettingsKeys() const { return m_settingsKeys; } + bool getForce() const { return m_force; } + + static MsgConfigureIEEE_802_15_4_DemodBaseband* create(const QStringList& settingsKeys, const IEEE_802_15_4_DemodSettings& settings, bool force) + { + return new MsgConfigureIEEE_802_15_4_DemodBaseband(settingsKeys, settings, force); + } + + private: + IEEE_802_15_4_DemodSettings m_settings; + QStringList m_settingsKeys; + bool m_force; + + MsgConfigureIEEE_802_15_4_DemodBaseband(const QStringList& settingsKeys, const IEEE_802_15_4_DemodSettings& settings, bool force) : + Message(), + m_settings(settings), + m_settingsKeys(settingsKeys), + m_force(force) + { } + }; + + IEEE_802_15_4_DemodBaseband(IEEE_802_15_4_Demod *demod); + ~IEEE_802_15_4_DemodBaseband(); + 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 + void getMagSqLevels(double& avg, double& peak, int& nbSamples) { + m_sink.getMagSqLevels(avg, peak, nbSamples); + } + void setMessageQueueToChannel(MessageQueue *messageQueue) { m_sink.setMessageQueueToChannel(messageQueue); } + void setBasebandSampleRate(int sampleRate); + int getChannelSampleRate() const; + 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); } + ScopeVis *getScopeSink() { return &m_scopeSink; } + +private: + SampleSinkFifo m_sampleFifo; + DownChannelizer *m_channelizer; + IEEE_802_15_4_DemodSink m_sink; + MessageQueue m_inputMessageQueue; //!< Queue for asynchronous inbound communication + IEEE_802_15_4_DemodSettings m_settings; + ScopeVis m_scopeSink; + bool m_running; + QRecursiveMutex m_mutex; + + bool handleMessage(const Message& cmd); + void applySettings(const QStringList& settingsKeys, const IEEE_802_15_4_DemodSettings& settings, bool force = false); + +private slots: + void handleInputMessages(); + void handleData(); //!< Handle data when samples have to be processed +}; + +#endif // INCLUDE_IEEE_802_15_4_DEMODBASEBAND_H diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodgui.cpp b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodgui.cpp new file mode 100644 index 000000000..d93aca40e --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodgui.cpp @@ -0,0 +1,930 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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 "ieee_802_15_4_demodgui.h" + +#include "device/deviceuiset.h" +#include "dsp/dspcommands.h" +#include "dsp/glscopesettings.h" +#include "dsp/scopevis.h" +#include "ui_ieee_802_15_4_demodgui.h" +#include "plugin/pluginapi.h" +#include "util/csv.h" +#include "util/db.h" +#include "util/ieee_802_15_4.h" +#include "gui/messagedialog.h" +#include "gui/basicchannelsettingsdialog.h" +#include "gui/datetimedelegate.h" +#include "gui/dialpopup.h" +#include "gui/dialogpositioner.h" +#include "gui/tabletapandhold.h" +#include "maincore.h" + +#include "ieee_802_15_4_demod.h" + +void IEEE_802_15_4_DemodGUI::resizeTable() +{ + // Fill table with a row of dummy data that will size the columns nicely + // Trailing spaces are for sort arrow + int row = ui->frames->rowCount(); + ui->frames->setRowCount(row + 1); + ui->frames->setItem(row, FRAME_COL_DATE_TIME, new QTableWidgetItem("2016/04/15 10:17:00-")); + ui->frames->setItem(row, FRAME_COL_TYPE, new QTableWidgetItem("Command-")); + ui->frames->setItem(row, FRAME_COL_SEQ, new QTableWidgetItem("255-")); + ui->frames->setItem(row, FRAME_COL_DST_PAN, new QTableWidgetItem("0xffff-")); + ui->frames->setItem(row, FRAME_COL_DST_ADDR, new QTableWidgetItem("00:11:22:33:44:55:66:77-")); + ui->frames->setItem(row, FRAME_COL_SRC_PAN, new QTableWidgetItem("0xffff-")); + ui->frames->setItem(row, FRAME_COL_SRC_ADDR, new QTableWidgetItem("00:11:22:33:44:55:66:77-")); + ui->frames->setItem(row, FRAME_COL_INFO, new QTableWidgetItem("Association Request")); + ui->frames->setItem(row, FRAME_COL_LENGTH, new QTableWidgetItem("127-")); + ui->frames->setItem(row, FRAME_COL_PAYLOAD, new QTableWidgetItem("000102030405060708090a0b0c0d0e0f")); + ui->frames->setItem(row, FRAME_COL_PSDU, new QTableWidgetItem("000102030405060708090a0b0c0d0e0f")); + ui->frames->setItem(row, FRAME_COL_FCS, new QTableWidgetItem("Bad-")); + ui->frames->setItem(row, FRAME_COL_POWER, new QTableWidgetItem("-100.0-")); + ui->frames->setItem(row, FRAME_COL_SNR, new QTableWidgetItem("30.0-")); + ui->frames->setItem(row, FRAME_COL_LQI, new QTableWidgetItem("0.00-")); + ui->frames->setItem(row, FRAME_COL_FREQUENCY_OFFSET, new QTableWidgetItem("-200000-")); + ui->frames->resizeColumnsToContents(); + ui->frames->removeRow(row); +} + +// Columns in table reordered +void IEEE_802_15_4_DemodGUI::frames_sectionMoved(int logicalIndex, int oldVisualIndex, int newVisualIndex) +{ + (void) oldVisualIndex; + + m_settings.m_columnIndexes[logicalIndex] = newVisualIndex; +} + +// Column in table resized (when hidden size is 0) +void IEEE_802_15_4_DemodGUI::frames_sectionResized(int logicalIndex, int oldSize, int newSize) +{ + (void) oldSize; + + m_settings.m_columnSizes[logicalIndex] = newSize; +} + +// Right click in table header - show column select menu +void IEEE_802_15_4_DemodGUI::framesColumnSelectMenu(QPoint pos) +{ + m_framesMenu->popup(ui->frames->horizontalHeader()->viewport()->mapToGlobal(pos)); +} + +// Hide/show column when menu selected +void IEEE_802_15_4_DemodGUI::framesColumnSelectMenuChecked(bool checked) +{ + (void) checked; + + QAction* action = qobject_cast(sender()); + + if (action != nullptr) + { + int idx = action->data().toInt(nullptr); + ui->frames->setColumnHidden(idx, !action->isChecked()); + } +} + +// Create column select menu item +QAction *IEEE_802_15_4_DemodGUI::createCheckableItem(QString &text, int idx, bool checked, const char *slot) +{ + QAction *action = new QAction(text, this); + action->setCheckable(true); + action->setChecked(checked); + action->setData(QVariant(idx)); + connect(action, SIGNAL(triggered()), this, slot); + return action; +} + +IEEE_802_15_4_DemodGUI* IEEE_802_15_4_DemodGUI::create(PluginAPI* pluginAPI, DeviceUISet *deviceUISet, BasebandSampleSink *rxChannel) +{ + IEEE_802_15_4_DemodGUI* gui = new IEEE_802_15_4_DemodGUI(pluginAPI, deviceUISet, rxChannel); + return gui; +} + +void IEEE_802_15_4_DemodGUI::destroy() +{ + delete this; +} + +void IEEE_802_15_4_DemodGUI::resetToDefaults() +{ + m_settings.resetToDefaults(); + displaySettings(); + applySettings(QStringList(), true); +} + +QByteArray IEEE_802_15_4_DemodGUI::serialize() const +{ + return m_settings.serialize(); +} + +bool IEEE_802_15_4_DemodGUI::deserialize(const QByteArray& data) +{ + if (m_settings.deserialize(data)) + { + displaySettings(); + applySettings(QStringList(), true); + return true; + } + else + { + resetToDefaults(); + return false; + } +} + +// Add row to table +void IEEE_802_15_4_DemodGUI::frameReceived(const QByteArray& psdu, const QDateTime& dateTime, bool fcsOK, float frequencyOffset, + float lqi, float powerDB, float snr) +{ + IEEE_802_15_4_FrameDecoder mac; + mac.decode(psdu); + + // Is scroll bar at bottom + QScrollBar *sb = ui->frames->verticalScrollBar(); + bool scrollToBottom = sb->value() == sb->maximum(); + + ui->frames->setSortingEnabled(false); + int row = ui->frames->rowCount(); + ui->frames->setRowCount(row + 1); + + QTableWidgetItem *items[IEEE_802_15_4_DEMOD_COLUMNS]; + for (int i = 0; i < IEEE_802_15_4_DEMOD_COLUMNS; i++) + { + items[i] = new QTableWidgetItem(); + ui->frames->setItem(row, i, items[i]); + } + + items[FRAME_COL_DATE_TIME]->setData(Qt::DisplayRole, dateTime); + items[FRAME_COL_TYPE]->setText(mac.m_valid ? mac.getFrameTypeString() : "Invalid"); + items[FRAME_COL_TYPE]->setData(Qt::UserRole, (int) mac.m_frameType); + if (mac.m_hasSeqNo) { + items[FRAME_COL_SEQ]->setData(Qt::DisplayRole, (int) mac.m_seqNo); + } + items[FRAME_COL_DST_PAN]->setText(mac.getDestPANIDString()); + items[FRAME_COL_DST_ADDR]->setText(mac.getDestAddressString()); + items[FRAME_COL_SRC_PAN]->setText(mac.getSrcPANIDString()); + items[FRAME_COL_SRC_ADDR]->setText(mac.getSrcAddressString()); + items[FRAME_COL_INFO]->setText(mac.toString()); + items[FRAME_COL_LENGTH]->setData(Qt::DisplayRole, (int) psdu.size()); + items[FRAME_COL_PAYLOAD]->setText(mac.m_payload.toHex()); + items[FRAME_COL_PSDU]->setText(psdu.toHex()); + items[FRAME_COL_FCS]->setText(fcsOK ? "OK" : "Bad"); + items[FRAME_COL_POWER]->setData(Qt::DisplayRole, std::round(powerDB * 10.0) / 10.0); + items[FRAME_COL_SNR]->setData(Qt::DisplayRole, std::round(snr * 10.0) / 10.0); + items[FRAME_COL_LQI]->setData(Qt::DisplayRole, std::round(lqi * 100.0) / 100.0); + items[FRAME_COL_FREQUENCY_OFFSET]->setData(Qt::DisplayRole, (int) std::round(frequencyOffset)); + + if (!fcsOK) + { + for (int i = 0; i < IEEE_802_15_4_DEMOD_COLUMNS; i++) { + items[i]->setForeground(QBrush(Qt::red)); + } + } + + if (!m_loadingData) + { + filterRow(row); + ui->frames->setSortingEnabled(true); + + if (scrollToBottom) { + ui->frames->scrollToBottom(); + } + } +} + +bool IEEE_802_15_4_DemodGUI::handleMessage(const Message& message) +{ + if (IEEE_802_15_4_Demod::MsgConfigureIEEE_802_15_4_Demod::match(message)) + { + qDebug("IEEE_802_15_4_DemodGUI::handleMessage: IEEE_802_15_4_Demod::MsgConfigureIEEE_802_15_4_Demod"); + const IEEE_802_15_4_Demod::MsgConfigureIEEE_802_15_4_Demod& cfg = (IEEE_802_15_4_Demod::MsgConfigureIEEE_802_15_4_Demod&) message; + + if (cfg.getForce()) { + m_settings = cfg.getSettings(); + } else { + m_settings.applySettings(cfg.getSettingsKeys(), cfg.getSettings()); + } + + blockApplySettings(true); + ui->scopeGUI->updateSettings(); + m_channelMarker.updateSettings(static_cast(m_settings.m_channelMarker)); + displaySettings(); + blockApplySettings(false); + return true; + } + else if (IEEE_802_15_4_Demod::MsgFrame::match(message)) + { + const IEEE_802_15_4_Demod::MsgFrame& frame = (const IEEE_802_15_4_Demod::MsgFrame&) message; + frameReceived(frame.getPSDU(), frame.getDateTime(), frame.getFCSOK(), frame.getFrequencyOffset(), + frame.getLQI(), frame.getPowerDB(), frame.getSNR()); + return true; + } + else if (DSPSignalNotification::match(message)) + { + const DSPSignalNotification& notif = (const DSPSignalNotification&) message; + m_deviceCenterFrequency = notif.getCenterFrequency(); + m_basebandSampleRate = notif.getSampleRate(); + ui->deltaFrequency->setValueRange(false, 8, -m_basebandSampleRate/2, m_basebandSampleRate/2); + ui->deltaFrequencyLabel->setToolTip(tr("Range %1 %L2 Hz").arg(QChar(0xB1)).arg(m_basebandSampleRate/2)); + updateAbsoluteCenterFrequency(); + checkSampleRate(); + return true; + } + + return false; +} + +void IEEE_802_15_4_DemodGUI::handleInputMessages() +{ + Message* message; + + while ((message = getInputMessageQueue()->pop())) + { + if (!handleMessage(*message)) { + qDebug("%s: unhandled message: %s", Q_FUNC_INFO, message->getIdentifier()); + } + delete message; + } +} + +void IEEE_802_15_4_DemodGUI::channelMarkerChangedByCursor() +{ + ui->deltaFrequency->setValue(m_channelMarker.getCenterFrequency()); + m_settings.m_inputFrequencyOffset = m_channelMarker.getCenterFrequency(); + applySettings(QStringList({"inputFrequencyOffset"})); +} + +void IEEE_802_15_4_DemodGUI::channelMarkerHighlightedByCursor() +{ + setHighlighted(m_channelMarker.getHighlighted()); +} + +void IEEE_802_15_4_DemodGUI::on_deltaFrequency_changed(qint64 value) +{ + m_channelMarker.setCenterFrequency(value); + m_settings.m_inputFrequencyOffset = m_channelMarker.getCenterFrequency(); + updateAbsoluteCenterFrequency(); + applySettings(QStringList({"inputFrequencyOffset"})); +} + +void IEEE_802_15_4_DemodGUI::on_phy_currentIndexChanged(int index) +{ + (void) index; + + // Also sets RF bandwidth and maximum frequency offset to defaults for the PHY + m_settings.setPHY(ui->phy->currentText()); + displayPHYDependent(); + applySettings(QStringList({"phy", "rfBandwidth", "maxFrequencyOffset"})); +} + +void IEEE_802_15_4_DemodGUI::on_samplesPerChip_valueChanged(int value) +{ + m_settings.m_samplesPerChip = value; + displayPHYDependent(); + applySettings(QStringList({"samplesPerChip"})); +} + +void IEEE_802_15_4_DemodGUI::on_rfBW_valueChanged(int value) +{ + m_settings.m_rfBandwidth = value * 10000.0f; + ui->rfBWText->setText(QString("%1M").arg(m_settings.m_rfBandwidth / 1e6, 0, 'f', 2)); + m_channelMarker.setBandwidth(m_settings.m_rfBandwidth); + checkSampleRate(); + applySettings(QStringList({"rfBandwidth"})); +} + +void IEEE_802_15_4_DemodGUI::on_maxFrequencyOffset_valueChanged(int value) +{ + m_settings.m_maxFrequencyOffset = value * 1000.0f; + applySettings(QStringList({"maxFrequencyOffset"})); +} + +void IEEE_802_15_4_DemodGUI::on_threshold_valueChanged(int value) +{ + m_settings.m_threshold = value / 100.0f; + ui->thresholdText->setText(QString("%1").arg(m_settings.m_threshold, 0, 'f', 2)); + applySettings(QStringList({"threshold"})); +} + +void IEEE_802_15_4_DemodGUI::on_udpEnabled_clicked(bool checked) +{ + m_settings.m_udpEnabled = checked; + applySettings(QStringList({"udpEnabled"})); +} + +void IEEE_802_15_4_DemodGUI::on_udpAddress_editingFinished() +{ + m_settings.m_udpAddress = ui->udpAddress->text(); + applySettings(QStringList({"udpAddress"})); +} + +void IEEE_802_15_4_DemodGUI::on_udpPort_editingFinished() +{ + m_settings.m_udpPort = ui->udpPort->text().toInt(); + applySettings(QStringList({"udpPort"})); +} + +void IEEE_802_15_4_DemodGUI::on_udpFormat_currentIndexChanged(int index) +{ + m_settings.m_udpFormat = (IEEE_802_15_4_DemodSettings::UDPFormat) index; + applySettings(QStringList({"udpFormat"})); +} + +void IEEE_802_15_4_DemodGUI::on_filterFrameType_currentIndexChanged(int index) +{ + m_settings.m_filterFrameType = (IEEE_802_15_4_DemodSettings::FrameTypeFilter) index; + filter(); + applySettings(QStringList({"filterFrameType"})); +} + +void IEEE_802_15_4_DemodGUI::on_filterPANID_editingFinished() +{ + m_settings.m_filterPANID = ui->filterPANID->text(); + filter(); + applySettings(QStringList({"filterPANID"})); +} + +void IEEE_802_15_4_DemodGUI::on_filterAddress_editingFinished() +{ + m_settings.m_filterAddress = ui->filterAddress->text(); + filter(); + applySettings(QStringList({"filterAddress"})); +} + +void IEEE_802_15_4_DemodGUI::on_showBadFCS_toggled(bool checked) +{ + m_settings.m_showBadFCS = checked; + filter(); + applySettings(QStringList({"showBadFCS"})); +} + +void IEEE_802_15_4_DemodGUI::on_useFileTime_toggled(bool checked) +{ + m_settings.m_useFileTime = checked; + applySettings(QStringList({"useFileTime"})); +} + +void IEEE_802_15_4_DemodGUI::on_clearTable_clicked() +{ + ui->frames->setRowCount(0); +} + +void IEEE_802_15_4_DemodGUI::filterRow(int row) +{ + bool hidden = false; + + if (m_settings.m_filterFrameType != IEEE_802_15_4_DemodSettings::FilterAll) + { + int type = ui->frames->item(row, FRAME_COL_TYPE)->data(Qt::UserRole).toInt(); + int filterType; + + switch (m_settings.m_filterFrameType) + { + case IEEE_802_15_4_DemodSettings::FilterBeacon: + filterType = IEEE_802_15_4_FrameDecoder::Beacon; + break; + case IEEE_802_15_4_DemodSettings::FilterData: + filterType = IEEE_802_15_4_FrameDecoder::Data; + break; + case IEEE_802_15_4_DemodSettings::FilterAck: + filterType = IEEE_802_15_4_FrameDecoder::Ack; + break; + case IEEE_802_15_4_DemodSettings::FilterCommand: + filterType = IEEE_802_15_4_FrameDecoder::Command; + break; + default: + filterType = -1; + break; + } + + if (filterType >= 0) { + hidden = type != filterType; + } else { + hidden = type <= IEEE_802_15_4_FrameDecoder::Command; + } + } + + if (!hidden && !m_settings.m_filterPANID.isEmpty()) + { + QRegularExpression re(QRegularExpression::anchoredPattern(m_settings.m_filterPANID), QRegularExpression::CaseInsensitiveOption); + bool match = re.match(ui->frames->item(row, FRAME_COL_DST_PAN)->text()).hasMatch() + || re.match(ui->frames->item(row, FRAME_COL_SRC_PAN)->text()).hasMatch(); + hidden = !match; + } + + if (!hidden && !m_settings.m_filterAddress.isEmpty()) + { + QRegularExpression re(QRegularExpression::anchoredPattern(m_settings.m_filterAddress), QRegularExpression::CaseInsensitiveOption); + bool match = re.match(ui->frames->item(row, FRAME_COL_DST_ADDR)->text()).hasMatch() + || re.match(ui->frames->item(row, FRAME_COL_SRC_ADDR)->text()).hasMatch(); + hidden = !match; + } + + if (!hidden && !m_settings.m_showBadFCS) { + hidden = ui->frames->item(row, FRAME_COL_FCS)->text() != "OK"; + } + + ui->frames->setRowHidden(row, hidden); +} + +void IEEE_802_15_4_DemodGUI::filter() +{ + for (int i = 0; i < ui->frames->rowCount(); i++) { + filterRow(i); + } +} + +void IEEE_802_15_4_DemodGUI::onWidgetRolled(QWidget* widget, bool rollDown) +{ + (void) widget; + (void) rollDown; + + getRollupContents()->saveState(m_rollupState); + applySettings(QStringList({"rollupState"})); +} + +void IEEE_802_15_4_DemodGUI::onMenuDialogCalled(const QPoint &p) +{ + 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_demod->getNumberOfDeviceStreams()); + dialog.setStreamIndex(m_settings.m_streamIndex); + } + + dialog.move(p); + new DialogPositioner(&dialog, true); + 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(); + + setWindowTitle(m_settings.m_title); + setTitle(m_channelMarker.getTitle()); + setTitleColor(m_settings.m_rgbColor); + + if (m_deviceUISet->m_deviceMIMOEngine) + { + m_settings.m_streamIndex = dialog.getSelectedStreamIndex(); + m_channelMarker.clearStreamIndexes(); + m_channelMarker.addStreamIndex(m_settings.m_streamIndex); + updateIndexLabel(); + } + + applySettings(QStringList({"title", "rgbColor", "useReverseAPI", "reverseAPIAddress", + "reverseAPIPort", "reverseAPIDeviceIndex", "reverseAPIChannelIndex", "streamIndex"})); + } + + resetContextMenuType(); +} + +IEEE_802_15_4_DemodGUI::IEEE_802_15_4_DemodGUI(PluginAPI* pluginAPI, DeviceUISet *deviceUISet, BasebandSampleSink *rxChannel, QWidget* parent) : + ChannelGUI(parent), + ui(new Ui::IEEE_802_15_4_DemodGUI), + m_pluginAPI(pluginAPI), + m_deviceUISet(deviceUISet), + m_channelMarker(this), + m_deviceCenterFrequency(0), + m_basebandSampleRate(1), + m_doApplySettings(true), + m_tickCount(0), + m_loadingData(false) +{ + setAttribute(Qt::WA_DeleteOnClose, true); + m_helpURL = "plugins/channelrx/demod802.15.4/readme.md"; + RollupContents *rollupContents = getRollupContents(); + ui->setupUi(rollupContents); + setSizePolicy(rollupContents->sizePolicy()); + rollupContents->arrangeRollups(); + connect(rollupContents, SIGNAL(widgetRolled(QWidget*,bool)), this, SLOT(onWidgetRolled(QWidget*,bool))); + connect(this, SIGNAL(customContextMenuRequested(const QPoint &)), this, SLOT(onMenuDialogCalled(const QPoint &))); + + m_demod = reinterpret_cast(rxChannel); + m_demod->setMessageQueueToGUI(getInputMessageQueue()); + + connect(&MainCore::instance()->getMasterTimer(), SIGNAL(timeout()), this, SLOT(tick())); // 50 ms + + m_scopeVis = m_demod->getScopeSink(); + m_scopeVis->setGLScope(ui->glScope); + ui->glScope->connectTimer(MainCore::instance()->getMasterTimer()); + ui->scopeGUI->setBuddies(m_scopeVis->getInputMessageQueue(), m_scopeVis, ui->glScope); + ui->scopeGUI->setStreams(QStringList({"IQ", "MagSq", "Detect", "Correlation", "Chip", "Phase", "State", "FCS"})); + + // Scope settings to display the IQ waveforms + ui->scopeGUI->setPreTrigger(1); + GLScopeSettings::TraceData traceDataI, traceDataQ; + traceDataI.m_projectionType = Projector::ProjectionReal; + traceDataI.m_amp = 1.0; // for -1 to +1 + traceDataI.m_ofs = 0.0; // vertical offset + traceDataQ.m_projectionType = Projector::ProjectionImag; + traceDataQ.m_amp = 1.0; + traceDataQ.m_ofs = 0.0; + ui->scopeGUI->changeTrace(0, traceDataI); + ui->scopeGUI->addTrace(traceDataQ); + ui->scopeGUI->setDisplayMode(GLScopeSettings::DisplayXYV); + ui->scopeGUI->focusOnTrace(0); // re-focus to take changes into account in the GUI + + GLScopeSettings::TriggerData triggerData; + triggerData.m_triggerLevel = 0.1; + triggerData.m_triggerLevelCoarse = 10; + triggerData.m_triggerPositiveEdge = true; + ui->scopeGUI->changeTrigger(0, triggerData); + ui->scopeGUI->focusOnTrigger(0); // re-focus to take changes into account in the GUI + + ui->deltaFrequencyLabel->setText(QString("%1f").arg(QChar(0x94, 0x03))); + ui->deltaFrequency->setColorMapper(ColorMapper(ColorMapper::GrayGold)); + ui->deltaFrequency->setValueRange(false, 8, -99999999, 99999999); + ui->channelPowerMeter->setColorTheme(LevelMeterSignalDB::ColorGreenAndBlue); + + m_channelMarker.blockSignals(true); + m_channelMarker.setColor(QColor(255, 0, 255)); + m_channelMarker.setBandwidth(m_settings.m_rfBandwidth); + m_channelMarker.setCenterFrequency(m_settings.m_inputFrequencyOffset); + m_channelMarker.setTitle("802.15.4 Demodulator"); + m_channelMarker.blockSignals(false); + m_channelMarker.setVisible(true); // activate signal on the last setting only + + setTitleColor(m_channelMarker.getColor()); + m_settings.setChannelMarker(&m_channelMarker); + m_settings.setScopeGUI(ui->scopeGUI); + m_settings.setRollupState(&m_rollupState); + + m_deviceUISet->addChannelMarker(&m_channelMarker); + + connect(&m_channelMarker, SIGNAL(changedByCursor()), this, SLOT(channelMarkerChangedByCursor())); + connect(&m_channelMarker, SIGNAL(highlightedByCursor()), this, SLOT(channelMarkerHighlightedByCursor())); + connect(getInputMessageQueue(), SIGNAL(messageEnqueued()), this, SLOT(handleInputMessages())); + + // Display date and time in a single column, which sorts chronologically + ui->frames->setItemDelegateForColumn(FRAME_COL_DATE_TIME, new DateTimeDelegate("yyyy/MM/dd hh:mm:ss", ui->frames)); + + // Resize the table using dummy data + resizeTable(); + // Allow user to reorder columns + ui->frames->horizontalHeader()->setSectionsMovable(true); + // Allow user to sort table by clicking on headers + ui->frames->setSortingEnabled(true); + // Add context menu to allow hiding/showing of columns + m_framesMenu = new QMenu(ui->frames); + for (int i = 0; i < ui->frames->horizontalHeader()->count(); i++) + { + QString text = ui->frames->horizontalHeaderItem(i)->text(); + m_framesMenu->addAction(createCheckableItem(text, i, true, SLOT(framesColumnSelectMenuChecked()))); + } + ui->frames->horizontalHeader()->setContextMenuPolicy(Qt::CustomContextMenu); + connect(ui->frames->horizontalHeader(), SIGNAL(customContextMenuRequested(QPoint)), SLOT(framesColumnSelectMenu(QPoint))); + // Get signals when columns change + connect(ui->frames->horizontalHeader(), SIGNAL(sectionMoved(int, int, int)), SLOT(frames_sectionMoved(int, int, int))); + connect(ui->frames->horizontalHeader(), SIGNAL(sectionResized(int, int, int)), SLOT(frames_sectionResized(int, int, int))); + ui->frames->setContextMenuPolicy(Qt::CustomContextMenu); + connect(ui->frames, SIGNAL(customContextMenuRequested(QPoint)), SLOT(customContextMenuRequested(QPoint))); + TableTapAndHold *tableTapAndHold = new TableTapAndHold(ui->frames); + connect(tableTapAndHold, &TableTapAndHold::tapAndHold, this, &IEEE_802_15_4_DemodGUI::customContextMenuRequested); + + ui->scopeContainer->setVisible(false); + + displaySettings(); + makeUIConnections(); + applySettings(QStringList(), true); + DialPopup::addPopupsToChildDials(this); + m_resizer.enableChildMouseTracking(); +} + +void IEEE_802_15_4_DemodGUI::customContextMenuRequested(QPoint pos) +{ + QTableWidgetItem *item = ui->frames->itemAt(pos); + + if (item) + { + QMenu* tableContextMenu = new QMenu(ui->frames); + connect(tableContextMenu, &QMenu::aboutToHide, tableContextMenu, &QMenu::deleteLater); + QAction* copyAction = new QAction("Copy", tableContextMenu); + const QString text = item->text(); + connect(copyAction, &QAction::triggered, this, [text]()->void { + QClipboard *clipboard = QGuiApplication::clipboard(); + clipboard->setText(text); + }); + tableContextMenu->addAction(copyAction); + tableContextMenu->popup(ui->frames->viewport()->mapToGlobal(pos)); + } +} + +IEEE_802_15_4_DemodGUI::~IEEE_802_15_4_DemodGUI() +{ + delete ui; +} + +void IEEE_802_15_4_DemodGUI::blockApplySettings(bool block) +{ + m_doApplySettings = !block; +} + +void IEEE_802_15_4_DemodGUI::applySettings(const QStringList& settingsKeys, bool force) +{ + if (m_doApplySettings) + { + IEEE_802_15_4_Demod::MsgConfigureIEEE_802_15_4_Demod* message = IEEE_802_15_4_Demod::MsgConfigureIEEE_802_15_4_Demod::create(settingsKeys, m_settings, force); + m_demod->getInputMessageQueue()->push(message); + } +} + +// Display settings that depend on the PHY or samples per chip +void IEEE_802_15_4_DemodGUI::displayPHYDependent() +{ + bool block = !m_doApplySettings; + blockApplySettings(true); + + // Don't let the widgets' slots round the settings to the widgets' resolution + QSignalBlocker rfBWBlocker(ui->rfBW); + QSignalBlocker maxFrequencyOffsetBlocker(ui->maxFrequencyOffset); + + IEEE_802_15_4_PHY phy = m_settings.getPHY(); + ui->chipRate->setText(QString("%1k").arg(phy.getChipRate() / 1000)); + ui->sampleRate->setText(QString("%1M").arg(m_settings.getChannelSampleRate() / 1e6, 0, 'f', 1)); + ui->rfBW->setValue((int) std::round(m_settings.m_rfBandwidth / 10000.0f)); + ui->rfBWText->setText(QString("%1M").arg(m_settings.m_rfBandwidth / 1e6, 0, 'f', 2)); + ui->maxFrequencyOffset->setValue((int) std::round(m_settings.m_maxFrequencyOffset / 1000.0f)); + m_channelMarker.setBandwidth(m_settings.m_rfBandwidth); + m_scopeVis->setLiveRate(m_settings.getChannelSampleRate()); + checkSampleRate(); + + blockApplySettings(block); +} + +// Warn if the device sample rate is too low for the RF bandwidth +void IEEE_802_15_4_DemodGUI::checkSampleRate() +{ + if (m_basebandSampleRate < m_settings.m_rfBandwidth) + { + ui->rfBWText->setStyleSheet("QLabel { background-color : red; }"); + ui->rfBWText->setToolTip(QString("Device sample rate (%1 MSa/s) is lower than the RF bandwidth").arg(m_basebandSampleRate / 1e6, 0, 'f', 2)); + } + else + { + ui->rfBWText->setStyleSheet(""); + ui->rfBWText->setToolTip(""); + } +} + +void IEEE_802_15_4_DemodGUI::displaySettings() +{ + m_channelMarker.blockSignals(true); + m_channelMarker.setBandwidth(m_settings.m_rfBandwidth); + m_channelMarker.setCenterFrequency(m_settings.m_inputFrequencyOffset); + m_channelMarker.setTitle(m_settings.m_title); + m_channelMarker.blockSignals(false); + m_channelMarker.setColor(m_settings.m_rgbColor); // activate signal on the last setting only + + setTitleColor(m_settings.m_rgbColor); + setWindowTitle(m_channelMarker.getTitle()); + setTitle(m_channelMarker.getTitle()); + + blockApplySettings(true); + + // Widget slots modify m_settings (E.g. selecting a PHY sets the RF bandwidth to the + // default for it), so must not be run when displaying settings + QSignalBlocker phyBlocker(ui->phy); + QSignalBlocker samplesPerChipBlocker(ui->samplesPerChip); + QSignalBlocker thresholdBlocker(ui->threshold); + QSignalBlocker udpFormatBlocker(ui->udpFormat); + QSignalBlocker filterFrameTypeBlocker(ui->filterFrameType); + QSignalBlocker showBadFCSBlocker(ui->showBadFCS); + QSignalBlocker useFileTimeBlocker(ui->useFileTime); + + ui->deltaFrequency->setValue(m_channelMarker.getCenterFrequency()); + + int phyIndex = ui->phy->findText(m_settings.m_phy); + ui->phy->setCurrentIndex(phyIndex >= 0 ? phyIndex : ui->phy->count() - 1); + ui->samplesPerChip->setValue(m_settings.m_samplesPerChip); + displayPHYDependent(); + + ui->thresholdText->setText(QString("%1").arg(m_settings.m_threshold, 0, 'f', 2)); + ui->threshold->setValue((int) std::round(m_settings.m_threshold * 100.0f)); + + updateIndexLabel(); + + ui->udpEnabled->setChecked(m_settings.m_udpEnabled); + ui->udpAddress->setText(m_settings.m_udpAddress); + ui->udpPort->setText(QString::number(m_settings.m_udpPort)); + ui->udpFormat->setCurrentIndex((int) m_settings.m_udpFormat); + + ui->filterFrameType->setCurrentIndex((int) m_settings.m_filterFrameType); + ui->filterPANID->setText(m_settings.m_filterPANID); + ui->filterAddress->setText(m_settings.m_filterAddress); + ui->showBadFCS->setChecked(m_settings.m_showBadFCS); + + ui->logFilename->setToolTip(QString(".csv/.pcap log filename: %1").arg(m_settings.m_logFilename)); + ui->logEnable->setChecked(m_settings.m_logEnabled); + ui->useFileTime->setChecked(m_settings.m_useFileTime); + + // Order and size columns + QHeaderView *header = ui->frames->horizontalHeader(); + for (int i = 0; i < IEEE_802_15_4_DEMOD_COLUMNS; i++) + { + bool hidden = m_settings.m_columnSizes[i] == 0; + header->setSectionHidden(i, hidden); + m_framesMenu->actions().at(i)->setChecked(!hidden); + if (m_settings.m_columnSizes[i] > 0) { + ui->frames->setColumnWidth(i, m_settings.m_columnSizes[i]); + } + header->moveSection(header->visualIndex(i), m_settings.m_columnIndexes[i]); + } + + filter(); + + getRollupContents()->restoreState(m_rollupState); + updateAbsoluteCenterFrequency(); + blockApplySettings(false); +} + +void IEEE_802_15_4_DemodGUI::leaveEvent(QEvent* event) +{ + m_channelMarker.setHighlighted(false); + ChannelGUI::leaveEvent(event); +} + +void IEEE_802_15_4_DemodGUI::enterEvent(EnterEventType* event) +{ + m_channelMarker.setHighlighted(true); + ChannelGUI::enterEvent(event); +} + +void IEEE_802_15_4_DemodGUI::tick() +{ + double magsqAvg, magsqPeak; + int nbMagsqSamples; + m_demod->getMagSqLevels(magsqAvg, magsqPeak, nbMagsqSamples); + double powDbAvg = CalcDb::dbPower(magsqAvg); + double powDbPeak = CalcDb::dbPower(magsqPeak); + + ui->channelPowerMeter->levelChanged( + (100.0f + powDbAvg) / 100.0f, + (100.0f + powDbPeak) / 100.0f, + nbMagsqSamples); + + if (m_tickCount % 4 == 0) { + ui->channelPower->setText(QString::number(powDbAvg, 'f', 1)); + } + + m_tickCount++; +} + +void IEEE_802_15_4_DemodGUI::on_logEnable_clicked(bool checked) +{ + m_settings.m_logEnabled = checked; + applySettings(QStringList({"logEnabled"})); +} + +void IEEE_802_15_4_DemodGUI::on_logFilename_clicked() +{ + // Get filename to save to + QFileDialog fileDialog(nullptr, "Select file to log received frames to", "", "*.csv *.pcap"); + fileDialog.setDefaultSuffix("csv"); + fileDialog.setAcceptMode(QFileDialog::AcceptSave); + + if (fileDialog.exec()) + { + QStringList fileNames = fileDialog.selectedFiles(); + + if (fileNames.size() > 0) + { + m_settings.m_logFilename = fileNames[0]; + ui->logFilename->setToolTip(QString(".csv/.pcap log filename: %1").arg(m_settings.m_logFilename)); + applySettings(QStringList({"logFilename"})); + } + } +} + +// Read .csv log and process as received frames +void IEEE_802_15_4_DemodGUI::on_logOpen_clicked() +{ + QFileDialog fileDialog(nullptr, "Select .csv log file to read", "", "*.csv"); + + if (fileDialog.exec()) + { + QStringList fileNames = fileDialog.selectedFiles(); + + if (fileNames.size() > 0) + { + QFile file(fileNames[0]); + + if (file.open(QIODevice::ReadOnly | QIODevice::Text)) + { + m_loadingData = true; + QTextStream in(&file); + QString error; + QHash colIndexes = CSV::readHeader(in, {"Date", "Time", "Data", "FCS"}, error); + + if (error.isEmpty()) + { + int dateCol = colIndexes.value("Date"); + int timeCol = colIndexes.value("Time"); + int dataCol = colIndexes.value("Data"); + int fcsCol = colIndexes.value("FCS"); + int powerCol = colIndexes.value("Power", -1); + int snrCol = colIndexes.value("SNR", -1); + int lqiCol = colIndexes.value("LQI", -1); + int freqCol = colIndexes.value("Freq Offset", -1); + int maxCol = std::max({dateCol, timeCol, dataCol, fcsCol}); + QStringList cols; + + while (CSV::readRow(in, &cols)) + { + if (cols.size() > maxCol) + { + QDate date = QDate::fromString(cols[dateCol]); + QTime time = QTime::fromString(cols[timeCol]); + QDateTime dateTime(date, time); + QByteArray bytes = QByteArray::fromHex(cols[dataCol].toLatin1()); + bool fcsOK = cols[fcsCol] == "OK"; + auto value = [&cols](int col) -> float { + return (col >= 0) && (col < cols.size()) ? cols[col].toFloat() : 0.0f; + }; + + frameReceived(bytes, dateTime, fcsOK, value(freqCol), value(lqiCol), value(powerCol), value(snrCol)); + } + } + } + else + { + MessageDialog::critical(this, "802.15.4 Demod", error); + } + + m_loadingData = false; + ui->frames->setSortingEnabled(true); + filter(); + } + else + { + MessageDialog::critical(this, "802.15.4 Demod", QString("Failed to open file %1").arg(fileNames[0])); + } + } + } +} + +void IEEE_802_15_4_DemodGUI::makeUIConnections() +{ + QObject::connect(ui->deltaFrequency, &ValueDialZ::changed, this, &IEEE_802_15_4_DemodGUI::on_deltaFrequency_changed); + QObject::connect(ui->phy, QOverload::of(&QComboBox::currentIndexChanged), this, &IEEE_802_15_4_DemodGUI::on_phy_currentIndexChanged); + QObject::connect(ui->samplesPerChip, QOverload::of(&QSpinBox::valueChanged), this, &IEEE_802_15_4_DemodGUI::on_samplesPerChip_valueChanged); + QObject::connect(ui->rfBW, &QSlider::valueChanged, this, &IEEE_802_15_4_DemodGUI::on_rfBW_valueChanged); + QObject::connect(ui->maxFrequencyOffset, QOverload::of(&QSpinBox::valueChanged), this, &IEEE_802_15_4_DemodGUI::on_maxFrequencyOffset_valueChanged); + QObject::connect(ui->threshold, &QDial::valueChanged, this, &IEEE_802_15_4_DemodGUI::on_threshold_valueChanged); + QObject::connect(ui->udpEnabled, &QCheckBox::clicked, this, &IEEE_802_15_4_DemodGUI::on_udpEnabled_clicked); + QObject::connect(ui->udpAddress, &QLineEdit::editingFinished, this, &IEEE_802_15_4_DemodGUI::on_udpAddress_editingFinished); + QObject::connect(ui->udpPort, &QLineEdit::editingFinished, this, &IEEE_802_15_4_DemodGUI::on_udpPort_editingFinished); + QObject::connect(ui->udpFormat, QOverload::of(&QComboBox::currentIndexChanged), this, &IEEE_802_15_4_DemodGUI::on_udpFormat_currentIndexChanged); + QObject::connect(ui->filterFrameType, QOverload::of(&QComboBox::currentIndexChanged), this, &IEEE_802_15_4_DemodGUI::on_filterFrameType_currentIndexChanged); + QObject::connect(ui->filterPANID, &QLineEdit::editingFinished, this, &IEEE_802_15_4_DemodGUI::on_filterPANID_editingFinished); + QObject::connect(ui->filterAddress, &QLineEdit::editingFinished, this, &IEEE_802_15_4_DemodGUI::on_filterAddress_editingFinished); + QObject::connect(ui->showBadFCS, &ButtonSwitch::toggled, this, &IEEE_802_15_4_DemodGUI::on_showBadFCS_toggled); + QObject::connect(ui->useFileTime, &ButtonSwitch::toggled, this, &IEEE_802_15_4_DemodGUI::on_useFileTime_toggled); + QObject::connect(ui->logEnable, &ButtonSwitch::clicked, this, &IEEE_802_15_4_DemodGUI::on_logEnable_clicked); + QObject::connect(ui->logFilename, &QToolButton::clicked, this, &IEEE_802_15_4_DemodGUI::on_logFilename_clicked); + QObject::connect(ui->logOpen, &QToolButton::clicked, this, &IEEE_802_15_4_DemodGUI::on_logOpen_clicked); + QObject::connect(ui->clearTable, &QPushButton::clicked, this, &IEEE_802_15_4_DemodGUI::on_clearTable_clicked); +} + +void IEEE_802_15_4_DemodGUI::updateAbsoluteCenterFrequency() +{ + setStatusFrequency(m_deviceCenterFrequency + m_settings.m_inputFrequencyOffset); +} diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodgui.h b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodgui.h new file mode 100644 index 000000000..860c86fba --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodgui.h @@ -0,0 +1,160 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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_IEEE_802_15_4_DEMODGUI_H +#define INCLUDE_IEEE_802_15_4_DEMODGUI_H + +#include +#include + +#include "channel/channelgui.h" +#include "dsp/channelmarker.h" +#include "util/messagequeue.h" +#include "settings/rollupstate.h" + +#include "ieee_802_15_4_demodsettings.h" +#include "ieee_802_15_4_demod.h" + +class PluginAPI; +class DeviceUISet; +class BasebandSampleSink; +class ScopeVis; + +namespace Ui { + class IEEE_802_15_4_DemodGUI; +} + +class IEEE_802_15_4_DemodGUI : public ChannelGUI { + Q_OBJECT + +public: + static IEEE_802_15_4_DemodGUI* 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: + Ui::IEEE_802_15_4_DemodGUI* ui; + PluginAPI* m_pluginAPI; + DeviceUISet* m_deviceUISet; + ChannelMarker m_channelMarker; + RollupState m_rollupState; + IEEE_802_15_4_DemodSettings m_settings; + qint64 m_deviceCenterFrequency; + int m_basebandSampleRate; + bool m_doApplySettings; + ScopeVis* m_scopeVis; + + IEEE_802_15_4_Demod* m_demod; + uint32_t m_tickCount; + MessageQueue m_inputMessageQueue; + bool m_loadingData; + + QMenu *m_framesMenu; // Column select context menu + + enum FrameCol { + FRAME_COL_DATE_TIME, + FRAME_COL_TYPE, + FRAME_COL_SEQ, + FRAME_COL_DST_PAN, + FRAME_COL_DST_ADDR, + FRAME_COL_SRC_PAN, + FRAME_COL_SRC_ADDR, + FRAME_COL_INFO, + FRAME_COL_LENGTH, + FRAME_COL_PAYLOAD, + FRAME_COL_PSDU, + FRAME_COL_FCS, + FRAME_COL_POWER, + FRAME_COL_SNR, + FRAME_COL_LQI, + FRAME_COL_FREQUENCY_OFFSET + }; + + explicit IEEE_802_15_4_DemodGUI(PluginAPI* pluginAPI, DeviceUISet *deviceUISet, BasebandSampleSink *rxChannel, QWidget* parent = nullptr); + virtual ~IEEE_802_15_4_DemodGUI(); + + void blockApplySettings(bool block); + void applySettings(const QStringList& settingsKeys, bool force = false); + void displaySettings(); + void displayPHYDependent(); + void frameReceived(const QByteArray& psdu, const QDateTime& dateTime, bool fcsOK, float frequencyOffset, + float lqi, float powerDB, float snr); + bool handleMessage(const Message& message); + void makeUIConnections(); + void updateAbsoluteCenterFrequency(); + void checkSampleRate(); + + void leaveEvent(QEvent*); + void enterEvent(EnterEventType*); + + void resizeTable(); + QAction *createCheckableItem(QString& text, int idx, bool checked, const char *slot); + +private slots: + void on_deltaFrequency_changed(qint64 value); + void on_phy_currentIndexChanged(int index); + void on_samplesPerChip_valueChanged(int value); + void on_rfBW_valueChanged(int value); + void on_maxFrequencyOffset_valueChanged(int value); + void on_threshold_valueChanged(int value); + void on_udpEnabled_clicked(bool checked); + void on_udpAddress_editingFinished(); + void on_udpPort_editingFinished(); + void on_udpFormat_currentIndexChanged(int index); + void on_filterFrameType_currentIndexChanged(int index); + void on_filterPANID_editingFinished(); + void on_filterAddress_editingFinished(); + void on_showBadFCS_toggled(bool checked); + void on_useFileTime_toggled(bool checked); + void on_logEnable_clicked(bool checked = false); + void on_logFilename_clicked(); + void on_logOpen_clicked(); + void on_clearTable_clicked(); + void filterRow(int row); + void filter(); + void frames_sectionMoved(int logicalIndex, int oldVisualIndex, int newVisualIndex); + void frames_sectionResized(int logicalIndex, int oldSize, int newSize); + void framesColumnSelectMenu(QPoint pos); + void framesColumnSelectMenuChecked(bool checked = false); + void customContextMenuRequested(QPoint point); + void onWidgetRolled(QWidget* widget, bool rollDown); + void onMenuDialogCalled(const QPoint& p); + void handleInputMessages(); + void tick(); +}; + +#endif // INCLUDE_IEEE_802_15_4_DEMODGUI_H diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodgui.ui b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodgui.ui new file mode 100644 index 000000000..62cd777e2 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodgui.ui @@ -0,0 +1,1050 @@ + + + IEEE_802_15_4_DemodGUI + + + + 0 + 0 + 420 + 900 + + + + + 0 + 0 + + + + + 400 + 0 + + + + + Liberation Sans + 9 + + + + Qt::FocusPolicy::StrongFocus + + + 802.15.4 Demodulator + + + + + 0 + 0 + 420 + 191 + + + + + 400 + 0 + + + + Settings + + + + 3 + + + 2 + + + 2 + + + 2 + + + 2 + + + + + 2 + + + + + + 16 + 0 + + + + Df + + + + + + + + 0 + 0 + + + + + 32 + 16 + + + + + Liberation Mono + 12 + + + + PointingHandCursor + + + Qt::FocusPolicy::StrongFocus + + + Demod shift frequency from center in Hz + + + + + + + Hz + + + + + + + Qt::Orientation::Vertical + + + + + + + Qt::Orientation::Horizontal + + + + 40 + 20 + + + + + + + + Channel power + + + 0.0 + + + + + + + dB + + + + + + + + + + + dB + + + + + + + + 0 + 0 + + + + + 0 + 24 + + + + + Liberation Mono + 8 + + + + Level meter (dB) top trace: average, bottom trace: instantaneous peak, tip: peak hold + + + + + + + + + Qt::Orientation::Horizontal + + + + + + + + + PHY + + + + + + + + 170 + 0 + + + + PHY bit rate and modulation + + + + 20kbps BPSK + + + + + 40kbps BPSK + + + + + 100kbps <1GHz O-QPSK + + + + + 250kbps <1GHz O-QPSK (Sine) + + + + + 250kbps <1GHz O-QPSK (RC) + + + + + 250kbps >2GHz O-QPSK + + + + + + + + Qt::Orientation::Vertical + + + + + + + CR + + + + + + + + 40 + 0 + + + + Chip rate + + + 2000k + + + + + + + Qt::Orientation::Vertical + + + + + + + SPC + + + + + + + Samples per chip. The channel sample rate is this multiplied by the chip rate + + + 2 + + + 16 + + + 4 + + + + + + + + 40 + 0 + + + + Channel sample rate + + + 8.0M + + + + + + + Qt::Orientation::Horizontal + + + + 40 + 20 + + + + + + + + + + + + BW + + + + + + + + 0 + 0 + + + + RF bandwidth of the channel filter + + + 10 + + + 400 + + + 1 + + + 300 + + + Qt::Orientation::Horizontal + + + + + + + + 40 + 0 + + + + 3.00M + + + + + + + Qt::Orientation::Vertical + + + + + + + Max ΔF + + + + + + + Maximum carrier frequency offset to search for during acquisition, in kHz + + + k + + + 0 + + + 1000 + + + + + + + Qt::Orientation::Vertical + + + + + + + TH + + + + + + + + 24 + 24 + + + + Preamble detection threshold. Lower values detect weaker signals, at the cost of more CPU spent on false detections + + + 1 + + + 50 + + + 5 + + + 5 + + + + + + + + 28 + 0 + + + + 0.05 + + + + + + + + + Qt::Orientation::Horizontal + + + + + + + + + UDP + + + + + + + Forward received frames via UDP + + + Qt::LayoutDirection::RightToLeft + + + + + + + + + + + 120 + 0 + + + + Qt::FocusPolicy::ClickFocus + + + Destination UDP address + + + 000.000.000.000 + + + 127.0.0.1 + + + + + + + : + + + + + + + + 50 + 0 + + + + + 50 + 16777215 + + + + Qt::FocusPolicy::ClickFocus + + + Destination UDP port. Wireshark decodes ZEP on port 17754 + + + 00000 + + + 17754 + + + + + + + Format + + + + + + + Format used to forward frames: ZEP (ZigBee Encapsulation Protocol, which Wireshark decodes) or raw MAC frame + + + + ZEP + + + + + Raw + + + + + + + + Qt::Orientation::Horizontal + + + + 40 + 20 + + + + + + + + + + Qt::Orientation::Horizontal + + + + + + + + + Display only frames of this type + + + + All + + + + + Beacon + + + + + Data + + + + + Ack + + + + + Command + + + + + Other + + + + + + + + PAN + + + + + + + Display only frames where a PAN ID matches the specified regular expression (E.g. 0x1a62) + + + + + + + Addr + + + + + + + Display only frames where the source or destination address matches the specified regular expression + + + + + + + Show frames with invalid FCS + + + FCS + + + true + + + + + + + Check to use date and time from input file. Uncheck to use date and time from clock. + + + + + + + :/clockcurrent.png + :/clockfile.png:/clockcurrent.png + + + + + + + Start/stop logging of received frames to .csv or .pcap file + + + + + + + :/record_off.png:/record_off.png + + + + + + + Set log filename. Use .pcap extension to log in PCAP format for Wireshark, otherwise .csv format is used + + + + + + + :/save.png:/save.png + + + false + + + + + + + Read frames from .csv log file + + + + + + + :/load.png:/load.png + + + false + + + + + + + Clear frames from table + + + + + + + :/bin.png:/bin.png + + + + + + + + + + + 0 + 200 + 420 + 300 + + + + + 0 + 0 + + + + Received Frames + + + + 2 + + + 0 + + + 0 + + + 0 + + + 0 + + + + + Received frames + + + QAbstractItemView::EditTrigger::NoEditTriggers + + + + Date/Time + + + Date and time frame was received + + + + + Type + + + MAC frame type + + + + + Seq + + + Sequence number + + + + + Dst PAN + + + Destination PAN ID + + + + + Dst Addr + + + Destination address + + + + + Src PAN + + + Source PAN ID + + + + + Src Addr + + + Source address + + + + + Info + + + Command, security and information elements + + + + + Len + + + PSDU length in bytes, including FCS + + + + + Payload + + + MAC payload as hex + + + + + PSDU + + + Complete MAC frame (PSDU), including FCS, as hex + + + + + FCS + + + Whether the frame check sequence is valid + + + + + Power + + + Received power during the frame in dB + + + + + SNR + + + Estimated symbol signal to noise ratio (Es/N0) in dB, after despreading + + + + + LQI + + + Link quality indicator: mean normalised correlation of symbols, from 0 to 1 + + + + + ΔF + + + Estimated carrier frequency offset in Hz + + + + + + + + + + 0 + 510 + 716 + 341 + + + + + 714 + 0 + + + + Waveforms + + + + 2 + + + 3 + + + 3 + + + 3 + + + 3 + + + + + + 200 + 250 + + + + + Liberation Mono + 8 + + + + + + + + + + + + + RollupContents + QWidget +
gui/rollupcontents.h
+ 1 +
+ + ValueDialZ + QWidget +
gui/valuedialz.h
+ 1 +
+ + LevelMeterSignalDB + QWidget +
gui/levelmeter.h
+ 1 +
+ + ButtonSwitch + QToolButton +
gui/buttonswitch.h
+
+ + GLScope + QWidget +
gui/glscope.h
+ 1 +
+ + GLScopeGUI + QWidget +
gui/glscopegui.h
+ 1 +
+
+ + + + +
diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodplugin.cpp b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodplugin.cpp new file mode 100644 index 000000000..c6f8f3126 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodplugin.cpp @@ -0,0 +1,92 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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 "ieee_802_15_4_demodgui.h" +#endif +#include "ieee_802_15_4_demod.h" +#include "ieee_802_15_4_demodwebapiadapter.h" +#include "ieee_802_15_4_demodplugin.h" + +const PluginDescriptor IEEE_802_15_4_DemodPlugin::m_pluginDescriptor = { + IEEE_802_15_4_Demod::m_channelId, + QStringLiteral("802.15.4 Demodulator"), + QStringLiteral("7.28.0"), + QStringLiteral("(c) Jon Beniston, M7RCE"), + QStringLiteral("https://github.com/f4exb/sdrangel"), + true, + QStringLiteral("https://github.com/f4exb/sdrangel") +}; + +IEEE_802_15_4_DemodPlugin::IEEE_802_15_4_DemodPlugin(QObject* parent) : + QObject(parent), + m_pluginAPI(nullptr) +{ +} + +const PluginDescriptor& IEEE_802_15_4_DemodPlugin::getPluginDescriptor() const +{ + return m_pluginDescriptor; +} + +void IEEE_802_15_4_DemodPlugin::initPlugin(PluginAPI* pluginAPI) +{ + m_pluginAPI = pluginAPI; + + m_pluginAPI->registerRxChannel(IEEE_802_15_4_Demod::m_channelIdURI, IEEE_802_15_4_Demod::m_channelId, this); +} + +void IEEE_802_15_4_DemodPlugin::createRxChannel(DeviceAPI *deviceAPI, BasebandSampleSink **bs, ChannelAPI **cs) const +{ + if (bs || cs) + { + IEEE_802_15_4_Demod *instance = new IEEE_802_15_4_Demod(deviceAPI); + + if (bs) { + *bs = instance; + } + + if (cs) { + *cs = instance; + } + } +} + +#ifdef SERVER_MODE +ChannelGUI* IEEE_802_15_4_DemodPlugin::createRxChannelGUI( + DeviceUISet *deviceUISet, + BasebandSampleSink *rxChannel) const +{ + (void) deviceUISet; + (void) rxChannel; + return nullptr; +} +#else +ChannelGUI* IEEE_802_15_4_DemodPlugin::createRxChannelGUI(DeviceUISet *deviceUISet, BasebandSampleSink *rxChannel) const +{ + return IEEE_802_15_4_DemodGUI::create(m_pluginAPI, deviceUISet, rxChannel); +} +#endif + +ChannelWebAPIAdapter* IEEE_802_15_4_DemodPlugin::createChannelWebAPIAdapter() const +{ + return new IEEE_802_15_4_DemodWebAPIAdapter(); +} diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodplugin.h b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodplugin.h new file mode 100644 index 000000000..2f1167a88 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodplugin.h @@ -0,0 +1,49 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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_IEEE_802_15_4_DEMODPLUGIN_H +#define INCLUDE_IEEE_802_15_4_DEMODPLUGIN_H + +#include +#include "plugin/plugininterface.h" + +class DeviceUISet; +class BasebandSampleSink; + +class IEEE_802_15_4_DemodPlugin : public QObject, PluginInterface { + Q_OBJECT + Q_INTERFACES(PluginInterface) + Q_PLUGIN_METADATA(IID "sdrangel.channelrx.demod802.15.4") + +public: + explicit IEEE_802_15_4_DemodPlugin(QObject* parent = nullptr); + + 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_IEEE_802_15_4_DEMODPLUGIN_H diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodreceiver.cpp b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodreceiver.cpp new file mode 100644 index 000000000..7fbe8a942 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodreceiver.cpp @@ -0,0 +1,935 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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 "ieee_802_15_4_demodreceiver.h" + +IEEE_802_15_4_DemodReceiver::IEEE_802_15_4_DemodReceiver() : + m_bpsk(false), + m_spc(4), + m_chipsPerSymbol(32), + m_numSymbols(16), + m_P(128), + m_window(4), + m_threshold(0.1f), + m_maxFrequencyOffset(200000.0f), + m_maxOmega(0.0), + m_pulseLength(0), + m_coherentLane(true), + m_nonCoherentLane(true), + m_mask(0), + m_n(0), + m_crcScopeCount(0) +{ + m_stats = Statistics{0, 0, 0, 0, 0, 0}; + configure(m_phy, m_spc, m_maxFrequencyOffset, m_threshold); +} + +void IEEE_802_15_4_DemodReceiver::configure(const IEEE_802_15_4_PHY& phy, int samplesPerChip, float maxFrequencyOffset, float threshold) +{ + m_phy = phy; + m_bpsk = phy.m_modulation == IEEE_802_15_4_PHY::BPSK; + m_spc = std::max(2, samplesPerChip); + m_chipsPerSymbol = phy.getChipsPerSymbol(); + m_numSymbols = m_bpsk ? 1 : 16; + m_P = m_chipsPerSymbol * m_spc; + // BPSK has a 32 bit preamble, O-QPSK 8 symbols. The detector needs m_window + 1 symbols + // of preamble to fill, and the longer the window, the lower the false alarm rate + m_window = m_bpsk ? 16 : 6; + m_verifyThreshold = m_chipsPerSymbol >= 32 ? m_verifyThreshold32 : m_verifyThreshold16; + m_lostThreshold = m_lostThresholdFactor * std::sqrt(M_PI / 4.0) / std::sqrt((double) m_chipsPerSymbol); + m_threshold = threshold; + m_pulse = phy.getPulse(m_spc); + m_pulseLength = (int) m_pulse.size(); + + // Normalise pulse energy, so correlation values are comparable between PHYs + double energy = 0.0; + for (auto p : m_pulse) { + energy += p * p; + } + for (auto& p : m_pulse) { + p /= std::sqrt(energy); + } + + m_chipSigns.resize(m_numSymbols); + for (int s = 0; s < m_numSymbols; s++) + { + m_chipSigns[s].resize(m_chipsPerSymbol); + for (int k = 0; k < m_chipsPerSymbol; k++) { + m_chipSigns[s][k] = phy.getChip(s, k) ? 1.0f : -1.0f; + } + } + + m_chipValues.resize(m_chipsPerSymbol); + + // O-QPSK: even chips on I, odd chips on Q + m_chipRotation.resize(m_chipsPerSymbol); + for (int k = 0; k < m_chipsPerSymbol; k++) { + m_chipRotation[k] = (m_bpsk || !(k & 1)) ? Cf(1.0f, 0.0f) : Cf(0.0f, -1.0f); + } + + setMaxFrequencyOffset(maxFrequencyOffset); + allocate(); + reset(); +} + +void IEEE_802_15_4_DemodReceiver::setMaxFrequencyOffset(float maxFrequencyOffset) +{ + m_maxFrequencyOffset = maxFrequencyOffset; + m_maxOmega = 2.0 * M_PI * maxFrequencyOffset / (double) getSampleRate(); +} + +void IEEE_802_15_4_DemodReceiver::allocate() +{ + // Enough history for the detector window, the acquisition segment and the matched filter + int64_t required = (2 * m_window + 6) * (int64_t) m_P + m_pulseLength + 64; + int64_t size = 1; + + while (size < required) { + size <<= 1; + } + + m_x.assign(size, Cf(0.0f, 0.0f)); + m_xf.assign(size, Cf(0.0f, 0.0f)); + m_d.assign(size, Cf(0.0f, 0.0f)); + m_y.assign(size, Cf(0.0f, 0.0f)); + m_mask = size - 1; +} + +void IEEE_802_15_4_DemodReceiver::reset() +{ + std::fill(m_x.begin(), m_x.end(), Cf(0.0f, 0.0f)); + std::fill(m_xf.begin(), m_xf.end(), Cf(0.0f, 0.0f)); + m_n = 0; + m_R = Cd(0.0, 0.0); + m_E1 = 0.0; + m_E2 = 0.0; + m_detectorPeakEnergy = 0.0; + m_state = Search; + m_waitUntil = 0; + m_holdoffUntil = 0; + m_frames.clear(); + m_scope = Scope{0.0f, 0.0f, 0.0f, 0.0f, 0.0f, 0.0f}; + m_crcScopeCount = 0; +} + +IEEE_802_15_4_DemodReceiver::Frame IEEE_802_15_4_DemodReceiver::popFrame() +{ + Frame frame = m_frames.front(); + m_frames.pop_front(); + return frame; +} + +void IEEE_802_15_4_DemodReceiver::process(const Cf& x) +{ + m_x[m_n & m_mask] = x; + + // Detector input is averaged over a chip, so its noise bandwidth is close to the signal + // bandwidth, whatever the number of samples per chip + Cf xf(0.0f, 0.0f); + for (int i = 0; i < m_spc; i++) { + xf += m_x[(m_n - i) & m_mask]; + } + m_xf[m_n & m_mask] = xf; + + updateDetector(); + m_n++; + + if (m_crcScopeCount > 0) + { + m_crcScopeCount--; + if (m_crcScopeCount == 0) { + m_scope.m_crc = 0.0f; + } + } + + if (m_state == Receive) + { + m_powerSum += std::norm(x); + m_powerCount++; + + // If we haven't found the SFD yet, the acquisition may have been false (E.g. on a + // run of zeros at the end of a BPSK frame, with the next frame following shortly + // after), so allow a fresh detection, or one from a detector window that is entirely + // after the acquisition, to restart acquisition + if (m_scope.m_detectMetric < m_threshold / 2.0f) { + m_detectorCleared = true; + } + bool newWindow = m_n - m_acquisitionN >= (int64_t) (m_window + 1) * m_P; + if ((m_detectorCleared || newWindow) && (m_scope.m_detectMetric >= m_threshold) && searchingForSFD()) + { + m_stats.m_detections++; + m_state = Wait; + m_waitUntil = m_n + (m_window + 2) * m_P; + m_waitMax = m_scope.m_detectMetric; + m_waitMaxN = m_n; + m_waitR = m_R; + } + else + { + processReceive(); + } + } + else if (m_state == Wait) + { + // Acquire once the detector has peaked, which is when its window is inside the + // preamble, so the acquisition segment that ends a symbol later is too + if (m_scope.m_detectMetric > m_waitMax) + { + m_waitMax = m_scope.m_detectMetric; + m_waitMaxN = m_n; + m_waitR = m_R; + } + if ((m_n - m_waitMaxN >= m_P) || (m_n >= m_waitUntil)) + { + if (!acquire()) + { + m_state = Search; + m_holdoffUntil = m_n + m_P; + } + } + } + else if ((m_n >= m_holdoffUntil) && (m_scope.m_detectMetric >= m_threshold)) + { + // Wait for more of the preamble to arrive, so the acquisition segment is + // inside the preamble even for a signal that has only just crossed the threshold + m_stats.m_detections++; + m_state = Wait; + m_waitUntil = m_n + (m_window + 2) * m_P; + m_waitMax = m_scope.m_detectMetric; + m_waitMaxN = m_n; + m_waitR = m_R; + } + + m_scope.m_state = (float) m_state; +} + +// Delay-and-correlate over one symbol period, summed over m_window symbols +void IEEE_802_15_4_DemodReceiver::updateDetector() +{ + int64_t windowSamples = (int64_t) m_window * m_P; + + if (m_n < windowSamples + m_P) + { + m_scope.m_detectMetric = 0.0f; + if (m_n == windowSamples + m_P - 1) { + recalculateDetector(); + } + return; + } + + // Periodically recalculate, to stop rounding errors accumulating + if ((m_n & 0xffff) == 0) + { + recalculateDetector(); + } + else + { + Cd x0(m_xf[m_n & m_mask]); + Cd x1(m_xf[(m_n - m_P) & m_mask]); + int64_t l = m_n - windowSamples; + Cd l0(m_xf[l & m_mask]); + Cd l1(m_xf[(l - m_P) & m_mask]); + + m_R += x0 * std::conj(x1) - l0 * std::conj(l1); + m_E1 += std::norm(x0) - std::norm(l0); + m_E2 += std::norm(x1) - std::norm(l1); + + // The running sums have rounding errors relative to the largest energy they've held. + // If the energy has since fallen to near that level (E.g. a strong frame followed by + // zero samples), the errors dominate and can give a large metric, so recalculate + m_detectorPeakEnergy = std::max(m_detectorPeakEnergy, std::max(m_E1, m_E2)); + if ((m_E1 < m_detectorRelativeError * m_detectorPeakEnergy) || (m_E2 < m_detectorRelativeError * m_detectorPeakEnergy)) { + recalculateDetector(); + } + } + + double denom = m_E1 * m_E2; + m_scope.m_detectMetric = ((m_E1 > 0.0) && (m_E2 > 0.0) && (denom > 1e-30)) ? (float) (std::norm(m_R) / denom) : 0.0f; +} + +void IEEE_802_15_4_DemodReceiver::recalculateDetector() +{ + int64_t windowSamples = (int64_t) m_window * m_P; + + m_R = Cd(0.0, 0.0); + m_E1 = 0.0; + m_E2 = 0.0; + + for (int64_t i = m_n - windowSamples + 1; i <= m_n; i++) + { + Cd x0(m_xf[i & m_mask]); + Cd x1(m_xf[(i - m_P) & m_mask]); + m_R += x0 * std::conj(x1); + m_E1 += std::norm(x0); + m_E2 += std::norm(x1); + } + + m_detectorPeakEnergy = std::max(m_E1, m_E2); +} + +// Find frequency offset and symbol timing from the preamble +bool IEEE_802_15_4_DemodReceiver::acquire() +{ + const int64_t newest = m_n - 1; + const int segLength = (m_window + 2) * m_P; + const int64_t segStart = newest - segLength + 1; + const int N = m_chipsPerSymbol; + + if (segStart - m_pulseLength < 0) { + return false; + } + + // Frequency, modulo the symbol rate, from the detector at its peak + const double omegaFine = std::arg(m_waitR) / m_P; + const double omegaStep = 2.0 * M_PI / m_P; + int mMax = (int) std::ceil((m_maxOmega + omegaStep / 2.0) / omegaStep); + + std::vector d(segLength + m_pulseLength - 1); + std::vector y(segLength); + std::vector bestY; + std::vector metric(m_P); + std::vector bestMetric; + double bestValue = -1.0; + int bestO = 0; + double bestOmega = 0.0; + + for (int m = -mMax; m <= mMax; m++) + { + double omega = omegaFine + m * omegaStep; + + if ((std::abs(omega) > m_maxOmega + omegaStep / 2.0) && (m != 0)) { + continue; + } + + // De-rotate and matched filter the segment + int64_t dStart = segStart - m_pulseLength + 1; + for (int i = 0; i < (int) d.size(); i++) + { + double a = -omega * (double) (dStart + i - segStart); + d[i] = m_x[(dStart + i) & m_mask] * Cf((float) std::cos(a), (float) std::sin(a)); + } + for (int i = 0; i < segLength; i++) + { + Cf acc(0.0f, 0.0f); + for (int j = 0; j < m_pulseLength; j++) { + acc += m_pulse[j] * d[i + j]; + } + y[i] = acc; + } + + // Correlate against the preamble symbol at each timing offset, + // combining symbols non-coherently + double maxValue = -1.0; + int maxO = 0; + + for (int o = 0; o < m_P; o++) + { + double sum = 0.0; + + for (int j = 0; j <= m_window; j++) + { + int idx = o + j * m_P; + Cf c(0.0f, 0.0f); + for (int k = 0; k < N; k++) { + c += m_chipSigns[0][k] * (y[idx + k * m_spc] * m_chipRotation[k]); + } + sum += std::abs(c); + } + + metric[o] = sum; + if (sum > maxValue) + { + maxValue = sum; + maxO = o; + } + } + + if (maxValue > bestValue) + { + bestValue = maxValue; + bestO = maxO; + bestOmega = omega; + bestY = y; + bestMetric = metric; + } + } + + if (bestValue <= 0.0) { + return false; + } + + // Normalised correlation of each symbol at the best timing + std::vector C; + std::vector q; + double qMax = 0.0; + + for (int j = 0; j <= m_window; j++) + { + int idx = bestO + j * m_P; + Cf c(0.0f, 0.0f); + double energy = 0.0; + + for (int k = 0; k < N; k++) + { + Cf u = bestY[idx + k * m_spc] * m_chipRotation[k]; + c += m_chipSigns[0][k] * u; + energy += std::norm(u); + } + + double qj = std::abs(c) / std::sqrt(N * energy + 1e-30); + C.push_back(Cd(c)); + q.push_back(qj); + qMax = std::max(qMax, qj); + } + + // BPSK data also correlates with the preamble chips, as a 1 is just the inverse + // sequence, so also check the differentially decoded bits are 0 + int good = 0; + std::vector preamble(q.size()); + for (int j = 0; j < (int) q.size(); j++) + { + bool zero = !m_bpsk || ((j > 0) && ((C[j] * std::conj(C[j - 1])).real() > 0.0)); + good += (q[j] >= m_verifyThreshold) && zero ? 1 : 0; + preamble[j] = (q[j] >= m_verifyThreshold * 0.8) && zero; + } + + if (good < m_verifySymbols) + { + if (m_debug) + { + fprintf(stderr, "acquire failed: n %lld omega %f good %d q:", (long long) m_n, bestOmega, good); + for (auto v : q) fprintf(stderr, " %.2f", v); + fprintf(stderr, "\n"); + } + return false; + } + + // Start decoding at the start of the longest run of preamble symbols. Starting before + // it, on noise, would use up the number of symbols the framer allows to find the SFD, + // and the segment may end with symbols after the preamble that happen to correlate, + // such as the zero bits in a BPSK SFD + int j0 = 0; + int bestRun = 0; + for (int j = 0; j < (int) q.size(); ) + { + if (preamble[j]) + { + int k = j; + while ((k < (int) q.size()) && preamble[k]) { + k++; + } + if (k - j >= bestRun) + { + bestRun = k - j; + j0 = j; + } + j = k; + } + else + { + j++; + } + } + // For BPSK, preamble[] marks a symbol whose differential with the previous is 0, so + // the previous symbol is part of the preamble too + if (m_bpsk && (j0 > 0)) { + j0--; + } + + // Fractional timing from the shape of the correlation peak + double mm = bestMetric[(bestO + m_P - 1) % m_P]; + double m0 = bestMetric[bestO]; + double mp = bestMetric[(bestO + 1) % m_P]; + double denom = mm - 2.0 * m0 + mp; + double delta = (std::abs(denom) > 1e-30) ? 0.5 * (mm - mp) / denom : 0.0; + delta = std::max(-0.5, std::min(0.5, delta)); + + // Refine frequency from the phase change between consecutive preamble symbols + Cd acc(0.0, 0.0); + for (int j = j0 + 1; j < (int) C.size(); j++) + { + if ((q[j] >= m_verifyThreshold * 0.8) && (q[j - 1] >= m_verifyThreshold * 0.8)) { + acc += C[j] * std::conj(C[j - 1]); + } + } + if (std::abs(acc) > 0.0) { + bestOmega += std::arg(acc) / m_P; + } + + m_stats.m_acquisitions++; + if (m_debug) { + fprintf(stderr, "acquire: n %lld omega %f (%.0f Hz) o %d delta %.2f j0 %d qMax %.2f q:", (long long) m_n, bestOmega, bestOmega * getSampleRate() / (2.0 * M_PI), bestO, delta, j0, qMax); + for (auto v : q) fprintf(stderr, " %.2f", v); + fprintf(stderr, "\n"); + } + startReceive(bestOmega, segStart, segStart + bestO + delta + j0 * m_P); + + return true; +} + +void IEEE_802_15_4_DemodReceiver::startReceive(double omega, int64_t segStart, double tau) +{ + m_state = Receive; + m_omega = omega; + m_ncoRef = segStart; + // Start a little before the segment, so early-late and the interpolator have history + m_yNext = segStart - m_spc - 2; + m_dNext = m_yNext - m_pulseLength + 1; + m_rot = std::polar(1.0, -omega * (double) (m_dNext - m_ncoRef)); + m_rotStep = std::polar(1.0, -omega); + m_tau = tau; + m_phi = 0.0; + m_dphi = 0.0; + m_phaseInit = false; + m_frameStart = segStart; + m_powerSum = 0.0; + m_powerCount = 0; + m_qSum = 0.0; + m_qCount = 0; + m_ampSum = 0.0; + m_ampSumSq = 0.0; + m_ampCount = 0; + m_recentQ.clear(); + m_detectorCleared = false; + m_acquisitionN = m_n; + + m_framers[0].reset(); + m_framers[1].reset(); + m_prevECoh = -1; + m_prevC = Cd(0.0, 0.0); + + for (int64_t i = segStart; i < m_n; i++) { + m_powerSum += std::norm(m_x[i & m_mask]); + m_powerCount++; + } + + processReceive(); +} + +// Cubic (Catmull-Rom) interpolation of matched filter output +IEEE_802_15_4_DemodReceiver::Cf IEEE_802_15_4_DemodReceiver::yAt(double t) const +{ + int64_t i = (int64_t) std::floor(t); + float mu = (float) (t - (double) i); + Cf p0 = m_y[(i - 1) & m_mask]; + Cf p1 = m_y[i & m_mask]; + Cf p2 = m_y[(i + 1) & m_mask]; + Cf p3 = m_y[(i + 2) & m_mask]; + Cf a = -0.5f * p0 + 1.5f * p1 - 1.5f * p2 + 0.5f * p3; + Cf b = p0 - 2.5f * p1 + 2.0f * p2 - 0.5f * p3; + Cf c = -0.5f * p0 + 0.5f * p2; + + return ((a * mu + b) * mu + c) * mu + p1; +} + +void IEEE_802_15_4_DemodReceiver::processReceive() +{ + // De-rotate and matched filter all samples received so far + while (m_dNext < m_n) + { + m_d[m_dNext & m_mask] = m_x[m_dNext & m_mask] * Cf((float) m_rot.real(), (float) m_rot.imag()); + m_rot *= m_rotStep; + if ((m_dNext & 0x3ff) == 0) { + m_rot /= std::abs(m_rot); + } + m_dNext++; + } + + while (m_yNext < m_dNext) + { + Cf acc(0.0f, 0.0f); + int64_t start = m_yNext - m_pulseLength + 1; + for (int j = 0; j < m_pulseLength; j++) { + acc += m_pulse[j] * m_d[(start + j) & m_mask]; + } + m_y[m_yNext & m_mask] = acc; + m_yNext++; + } + + // Decode all symbols for which we have samples, including early-late margin and interpolator + while ((m_state == Receive) && (m_tau + (m_chipsPerSymbol - 1) * m_spc + m_spc / 2.0 + 3.0 < (double) m_yNext)) { + decodeSymbol(); + } +} + +IEEE_802_15_4_DemodReceiver::Cd IEEE_802_15_4_DemodReceiver::correlate(double tau, int symbol) const +{ + Cf c(0.0f, 0.0f); + const std::vector& signs = m_chipSigns[symbol]; + + for (int k = 0; k < m_chipsPerSymbol; k++) { + c += signs[k] * (yAt(tau + k * m_spc) * m_chipRotation[k]); + } + + return Cd(c); +} + +void IEEE_802_15_4_DemodReceiver::decodeSymbol() +{ + const int N = m_chipsPerSymbol; + std::vector& u = m_chipValues; + double energy = 0.0; + + for (int k = 0; k < N; k++) + { + u[k] = yAt(m_tau + k * m_spc) * m_chipRotation[k]; + energy += std::norm(u[k]); + } + + Cd rot; + double q; + double phaseError; + int decided; // Symbol (O-QPSK) or chip sequence (BPSK) used for timing + + if (!m_bpsk) + { + Cd C[16]; + int bestNC = 0; + double bestNCValue = -1.0; + + for (int s = 0; s < 16; s++) + { + Cf c(0.0f, 0.0f); + const std::vector& signs = m_chipSigns[s]; + for (int k = 0; k < N; k++) { + c += signs[k] * u[k]; + } + C[s] = Cd(c); + double mag = std::abs(C[s]); + if (mag > bestNCValue) + { + bestNCValue = mag; + bestNC = s; + } + } + + if (!m_phaseInit) + { + m_phi = std::arg(C[bestNC]); + m_phaseInit = true; + } + + rot = std::polar(1.0, -m_phi); + int bestCoh = 0; + double bestCohValue = -1e30; + + for (int s = 0; s < 16; s++) + { + double v = (C[s] * rot).real(); + if (v > bestCohValue) + { + bestCohValue = v; + bestCoh = s; + } + } + + Cd cr = C[bestCoh] * rot; + phaseError = std::arg(cr); + q = bestNCValue / std::sqrt(N * energy + 1e-30); + decided = bestCoh; + + // SNR estimate from the in-phase component of the decided correlation. The + // quadrature component also contains ISI between the I and Q chips, so isn't used + m_ampSum += cr.real(); + m_ampSumSq += cr.real() * cr.real(); + m_ampCount++; + + frameSymbol(m_coherentLane ? bestCoh : bestNC, m_nonCoherentLane ? bestNC : bestCoh); + } + else + { + Cf c(0.0f, 0.0f); + const std::vector& signs = m_chipSigns[0]; + for (int k = 0; k < N; k++) { + c += signs[k] * u[k]; + } + Cd C(c); + + if (!m_phaseInit) + { + m_phi = std::arg(C); + m_phaseInit = true; + m_prevC = C; + } + + rot = std::polar(1.0, -m_phi); + Cd cr = C * rot; + int eCoh = cr.real() < 0.0 ? 1 : 0; + if (m_prevECoh < 0) { + m_prevECoh = eCoh; + } + int bitCoh = eCoh ^ m_prevECoh; + m_prevECoh = eCoh; + int bitNC = (C * std::conj(m_prevC)).real() < 0.0 ? 1 : 0; + m_prevC = C; + + if (eCoh) { + cr = -cr; + } + phaseError = std::arg(cr); + q = std::abs(C) / std::sqrt(N * energy + 1e-30); + decided = 0; + + m_ampSum += cr.real(); + m_ampSumSq += cr.real() * cr.real(); + m_ampCount++; + + frameBits(m_coherentLane ? bitCoh : bitNC, m_nonCoherentLane ? bitNC : bitCoh); + } + + if (m_debug) { + fprintf(stderr, "sym tau %.2f q %.2f dec %d phi %.2f perr %.2f\n", m_tau, q, decided, m_phi, phaseError); + } + m_scope.m_correlation = (float) q; + Cf chip = u[N - 1] * Cf((float) rot.real(), (float) rot.imag()); + m_scope.m_chip = std::sqrt(energy / N) > 0.0 ? (chip.real() / (float) std::sqrt(energy / N)) : 0.0f; + m_qSum += q; + m_qCount++; + + // Abandon frame quickly if signal lost, as an acknowledgement can follow a frame + // after only 12 symbol periods + const int lostSymbols = m_bpsk ? 8 : 4; + m_recentQ.push_back(q); + if ((int) m_recentQ.size() > lostSymbols) { + m_recentQ.pop_front(); + } + bool lost = false; + if ((int) m_recentQ.size() == lostSymbols) + { + double sum = 0.0; + for (auto v : m_recentQ) { + sum += v; + } + lost = sum / lostSymbols < m_lostThreshold; + } + + if (m_state != Receive) { + return; // Frame finished + } + + // Carrier phase loop + m_dphi += m_phaseFreqGain * phaseError; + m_phi += m_dphi + m_phaseGain * phaseError; + m_phi = std::remainder(m_phi, 2.0 * M_PI); + m_scope.m_phase = (float) (m_phi / M_PI); + + // Early-late timing + double offset = m_spc / 2.0; + double early = std::abs(correlate(m_tau - offset, decided)); + double late = std::abs(correlate(m_tau + offset, decided)); + double timingError = (early + late) > 0.0 ? (late - early) / (late + early) : 0.0; + + m_tau += m_P + m_timingGain * timingError * m_spc; + + if (lost) { + abortFrame(); + } +} + +void IEEE_802_15_4_DemodReceiver::frameSymbol(int symCoh, int symNC) +{ + // Least significant bit first + for (int i = 0; (i < 4) && (m_state == Receive); i++) { + frameBits((symCoh >> i) & 1, (symNC >> i) & 1); + } +} + +void IEEE_802_15_4_DemodReceiver::Framer::reset() +{ + m_state = FramerPreamble; + m_preambleBits = 0; + m_sfd = 0xffff; + m_bitCount = 0; + m_phr = 0; + m_length = 0; + m_bits.clear(); + m_psdu.clear(); + m_fcsOK = false; + m_checked = false; +} + +void IEEE_802_15_4_DemodReceiver::Framer::addBit(int bit) +{ + switch (m_state) + { + case FramerPreamble: + // Look for 8 zero bits followed by SFD (0xa7), received LSB first + m_sfd = (m_sfd >> 1) | (bit << 15); + m_preambleBits++; + if (m_sfd == 0xa700) + { + m_state = FramerPHR; + m_bitCount = 0; + m_phr = 0; + } + else if (m_preambleBits > 32 + 8 + 4) + { + m_state = FramerFailed; + } + break; + + case FramerPHR: + m_phr |= bit << m_bitCount; + m_bitCount++; + if (m_bitCount == 8) + { + m_length = m_phr & 0x7f; + if (lengthValid(m_length)) + { + m_bits.clear(); + m_bits.reserve(m_length * 8); + m_state = FramerPSDU; + } + else + { + m_state = FramerFailed; + } + } + break; + + case FramerPSDU: + m_bits.push_back(bit); + if ((int) m_bits.size() >= m_length * 8) + { + m_psdu.assign(m_length, 0); + for (int i = 0; i < m_length * 8; i++) { + m_psdu[i / 8] |= m_bits[i] << (i % 8); + } + uint16_t fcs = IEEE_802_15_4_FrameDecoder::calcFCS(m_psdu.data(), m_length - 2); + m_fcsOK = (m_psdu[m_length - 2] == (fcs & 0xff)) && (m_psdu[m_length - 1] == (fcs >> 8)); + m_state = FramerDone; + } + break; + + default: + break; + } +} + +bool IEEE_802_15_4_DemodReceiver::searchingForSFD() const +{ + for (const auto& framer : m_framers) + { + if ((framer.m_state == FramerPHR) || (framer.m_state == FramerPSDU) || (framer.m_state == FramerDone)) { + return false; + } + } + + return true; +} + +void IEEE_802_15_4_DemodReceiver::frameBits(int bitCoh, int bitNC) +{ + m_framers[0].addBit(bitCoh); + m_framers[1].addBit(bitNC); + + // Output as soon as either lane has a frame with a valid FCS + for (int lane = 0; lane < 2; lane++) + { + Framer& framer = m_framers[lane]; + + if ((framer.m_state == FramerDone) && !framer.m_checked) + { + framer.m_checked = true; + + if (framer.m_fcsOK) + { + finishFrame(lane); + return; + } + } + } + + // Neither lane has a valid frame, and neither will + if (!m_framers[0].active() && !m_framers[1].active()) { + abortFrame(); + } +} + +void IEEE_802_15_4_DemodReceiver::finishFrame(int lane) +{ + Frame frame; + const Framer& framer = m_framers[lane]; + + frame.m_psdu = framer.m_psdu; + frame.m_fcsOK = framer.m_fcsOK; + frame.m_coherent = lane == 0; + + if (frame.m_fcsOK) + { + m_stats.m_framesOK++; + if (frame.m_coherent) { + m_stats.m_framesCoherent++; + } else { + m_stats.m_framesNonCoherent++; + } + } + else + { + m_stats.m_framesBad++; + } + + if (!frame.m_psdu.empty()) + { + frame.m_frequencyOffset = (float) ((m_omega + m_dphi / m_P) * getSampleRate() / (2.0 * M_PI)); + frame.m_lqi = m_qCount > 0 ? (float) (m_qSum / m_qCount) : 0.0f; + frame.m_power = m_powerCount > 0 ? (float) (m_powerSum / m_powerCount) : 0.0f; + if (m_ampCount > 1) + { + double mean = m_ampSum / m_ampCount; + double var = m_ampSumSq / m_ampCount - mean * mean; + frame.m_snr = (var > 0.0) ? (float) (10.0 * std::log10(mean * mean / (2.0 * var))) : 99.0f; + } + else + { + frame.m_snr = 0.0f; + } + frame.m_startSample = m_frameStart; + frame.m_endSample = m_n - 1; + m_frames.push_back(frame); + m_scope.m_crc = frame.m_fcsOK ? 1.0f : -1.0f; + m_crcScopeCount = 4 * m_P; + } + + endReceive(); +} + +// Stop receiving, outputting a complete frame from either lane if there is one, +// even though its FCS is invalid. The other lane may still be active if it decoded +// a different (longer) length, and has now lost the signal +void IEEE_802_15_4_DemodReceiver::abortFrame() +{ + if (m_framers[0].m_state == FramerDone) { + finishFrame(0); + } else if (m_framers[1].m_state == FramerDone) { + finishFrame(1); + } else { + endReceive(); + } +} + +void IEEE_802_15_4_DemodReceiver::endReceive() +{ + m_state = Search; + // Allow detector window to clear of the frame just received + m_holdoffUntil = m_n + m_P; +} diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodreceiver.h b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodreceiver.h new file mode 100644 index 000000000..d37669dc4 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodreceiver.h @@ -0,0 +1,273 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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_IEEE_802_15_4_DEMODRECEIVER_H +#define INCLUDE_IEEE_802_15_4_DEMODRECEIVER_H + +#include +#include +#include +#include + +#include "util/ieee_802_15_4.h" + +// Receiver for the IEEE 802.15.4 O-QPSK and BPSK DSSS PHYs. +// +// O-QPSK with half-sine pulses is MSK, and could be received non-coherently with an FM +// discriminator, but the chip tables are defined on the O-QPSK chips, so a discriminator +// effectively detects each chip XORed with its neighbour - a product of two noisy samples - +// and does so at a chip SNR of Eb/N0 - 9 dB (2.4 GHz), well below its FM threshold. +// Instead this receiver correlates against the transmitted waveform: a matched filter for +// the chip pulse (half-sine or RC), sampled at each chip time, then despread against the +// 16 (or 2 for BPSK) chip sequences. That correlation is exactly the inner product of the +// received signal with the reference waveform of each symbol, so it is the matched filter +// for the whole symbol, ISI between chips included. +// +// Acquisition: +// 1. The preamble is a symbol (O-QPSK) or bit (BPSK) repeated, so it is detected with a +// delay-and-correlate (Schmidl-Cox) metric over one symbol period, which is insensitive +// to carrier frequency offset, and whose phase gives the frequency offset modulo the +// symbol rate. +// 2. The ambiguity is resolved, and symbol timing found, by correlating against the +// preamble symbol for each candidate frequency within the configured maximum offset and +// each sample offset within a symbol, combining symbols non-coherently. +// +// Tracking: the input is de-rotated by the estimated offset, and a second order +// decision-directed loop tracks the carrier phase using the decided symbol's correlation, +// which benefits from the full processing gain of the spreading so is far more reliable +// than chip decisions. Symbol timing is tracked with an early-late correlator. +// +// Detection is done in two lanes. The coherent lane picks the symbol whose correlation has +// the largest real part after phase correction. The non-coherent lane picks the largest +// magnitude (O-QPSK) or uses differential detection (BPSK), so needs no phase lock, and still +// works if the phase loop slips. The frame from the first lane to pass the FCS is used. +class IEEE_802_15_4_DemodReceiver +{ +public: + typedef std::complex Cf; + typedef std::complex Cd; + + struct Frame + { + std::vector m_psdu; //!< PSDU (MAC frame including FCS) + bool m_fcsOK; + bool m_coherent; //!< Frame from coherent lane (true) or non-coherent lane (false) + float m_frequencyOffset; //!< Estimated carrier frequency offset in Hz + float m_lqi; //!< Mean normalised symbol correlation, 0-1 + float m_power; //!< Mean power during frame (linear) + float m_snr; //!< Estimated SNR in dB (Es/N0 per symbol, after despreading) + int64_t m_startSample; //!< Index of first sample of acquisition window + int64_t m_endSample; //!< Index of last sample of frame + }; + + struct Scope + { + float m_detectMetric; //!< Preamble detection metric + float m_correlation; //!< Normalised correlation of last symbol + float m_phase; //!< Tracked carrier phase / pi + float m_state; //!< 0 = searching, 1 = acquiring, 2 = receiving frame + float m_crc; //!< 1 = FCS OK, -1 = FCS bad, briefly at end of frame + float m_chip; //!< Phase corrected soft value of last chip (I/Q) + }; + + struct Statistics + { + uint64_t m_detections; //!< Preamble detections + uint64_t m_acquisitions; //!< Successful acquisitions + uint64_t m_framesOK; //!< Frames with valid FCS + uint64_t m_framesBad; //!< Frames with invalid FCS + uint64_t m_framesCoherent; //!< Frames with valid FCS from coherent lane + uint64_t m_framesNonCoherent; //!< Frames with valid FCS only from non-coherent lane + }; + + IEEE_802_15_4_DemodReceiver(); + + //! Configure for a PHY. Sample rate must be samplesPerChip * PHY chip rate. + //! maxFrequencyOffset in Hz. threshold is the preamble detection threshold (0-1). + void configure(const IEEE_802_15_4_PHY& phy, int samplesPerChip, float maxFrequencyOffset, float threshold); + void setThreshold(float threshold) { m_threshold = threshold; } + void setMaxFrequencyOffset(float maxFrequencyOffset); + void reset(); + + int getSampleRate() const { return m_spc * m_phy.getChipRate(); } + + //! Process one sample + void process(const Cf& x); + + bool frameAvailable() const { return !m_frames.empty(); } + Frame popFrame(); + + const Scope& getScope() const { return m_scope; } + const Statistics& getStatistics() const { return m_stats; } + + //! For diagnostics: enable/disable lanes + void setLanes(bool coherent, bool nonCoherent) { m_coherentLane = coherent; m_nonCoherentLane = nonCoherent; } + + static const int m_maxPSDULength = 127; + + void setDebug(bool debug) { m_debug = debug; } + +private: + // Normalised correlation preamble symbols must reach at acquisition, and how many must. + // Noise alone gives a Rayleigh distributed value with mean sqrt(pi/4)/sqrt(chips per symbol): + // 0.16 for 32 chips, 0.22 for 16 and 15, and P(q > x) = exp(-chips * x^2). A symbol at + // Ec/N0 = -4 dB, around the sensitivity limit, gives about 0.53. + static constexpr double m_verifyThreshold32 = 0.4; + static constexpr double m_verifyThreshold16 = 0.5; + static constexpr int m_verifySymbols = 3; + // A frame is abandoned when the mean normalised correlation of recent symbols falls below + // this multiple of the mean for noise + static constexpr double m_lostThresholdFactor = 1.6; + // Carrier phase loop gains, per symbol + static constexpr double m_phaseGain = 0.25; + static constexpr double m_phaseFreqGain = 0.02; + // Symbol timing loop gain, in samples per unit early-late error per chip + static constexpr double m_timingGain = 0.1; + // Detector running sums are recalculated when an energy falls below this fraction of the + // largest energy since the last recalculation, before rounding errors become significant + static constexpr double m_detectorRelativeError = 1e-9; + + enum State { + Search, + Wait, + Receive + }; + + enum FramerState { + FramerPreamble, //!< Looking for SFD + FramerPHR, + FramerPSDU, + FramerDone, //!< Frame complete + FramerFailed //!< No SFD found or invalid length + }; + + // Each detection lane has its own framer, so a symbol error in one lane, such as a false + // SFD, can't misalign the other + struct Framer + { + FramerState m_state; + int m_preambleBits; + uint32_t m_sfd; + int m_bitCount; + uint32_t m_phr; + int m_length; + std::vector m_bits; + std::vector m_psdu; + bool m_fcsOK; + bool m_checked; + + void reset(); + void addBit(int bit); + bool active() const { return (m_state != FramerDone) && (m_state != FramerFailed); } + }; + + // Configuration + IEEE_802_15_4_PHY m_phy; + bool m_bpsk; + int m_spc; //!< Samples per chip + int m_chipsPerSymbol; + int m_numSymbols; //!< 16 for O-QPSK, 1 (+inverse) for BPSK + int m_P; //!< Samples per symbol + int m_window; //!< Detection window in symbols + float m_threshold; + float m_maxFrequencyOffset; + double m_maxOmega; //!< Max offset in radians per sample + std::vector m_pulse; + int m_pulseLength; + std::vector> m_chipSigns; //!< +-1 for each chip of each symbol + std::vector m_chipRotation; //!< Conjugate of chip carrier: 1 for I chips, -j for Q chips + std::vector m_chipValues; //!< Matched filter output for each chip of the symbol being decoded, with the I/Q chip carrier removed + bool m_coherentLane; + bool m_nonCoherentLane; + bool m_debug = false; + + // Sample history + std::vector m_x; //!< Input + std::vector m_xf; //!< Input averaged over a chip, for the detector + std::vector m_d; //!< Input de-rotated by frequency estimate (receive state) + std::vector m_y; //!< Matched filter output of m_d (receive state) + int64_t m_mask; + int64_t m_n; //!< Number of samples processed + + // Preamble detection + Cd m_R; + double m_E1; + double m_E2; + double m_detectorPeakEnergy; //!< Largest of m_E1 and m_E2 since last recalculation + State m_state; + int64_t m_waitUntil; + float m_waitMax; //!< Peak detector metric while waiting + int64_t m_waitMaxN; //!< Sample index of peak + Cd m_waitR; //!< Detector correlation at peak + double m_verifyThreshold; + double m_lostThreshold; + int64_t m_holdoffUntil; + + // Receive state + double m_omega; //!< Frequency offset in radians per sample + int64_t m_ncoRef; //!< Sample index where de-rotation phase is 0 + int64_t m_dNext; //!< Next index of m_d to calculate + int64_t m_yNext; //!< Next index of m_y to calculate + Cd m_rot; //!< De-rotation phasor for m_dNext + Cd m_rotStep; + double m_tau; //!< Sample index (in m_y) of first chip of next symbol + double m_phi; //!< Carrier phase + double m_dphi; //!< Carrier phase change per symbol + bool m_phaseInit; + int64_t m_frameStart; + double m_powerSum; + int64_t m_powerCount; + double m_qSum; + int m_qCount; + double m_ampSum; //!< For SNR estimate + double m_ampSumSq; + int m_ampCount; + std::deque m_recentQ; //!< Normalised correlation of recent symbols + int64_t m_acquisitionN; //!< Sample index when acquired + bool m_detectorCleared; //!< Detector has dropped below threshold since acquisition + + // Framers for coherent [0] and non-coherent [1] lanes + Framer m_framers[2]; + int m_prevECoh; //!< BPSK previous coherent (differentially encoded) bit + Cd m_prevC; //!< BPSK previous correlation for differential detection + + // Outputs + std::deque m_frames; + Scope m_scope; + Statistics m_stats; + int m_crcScopeCount; + + void allocate(); + Cf yAt(double t) const; + void updateDetector(); + void recalculateDetector(); + bool acquire(); + void startReceive(double omega, int64_t segStart, double tau); + void processReceive(); + void decodeSymbol(); + Cd correlate(double tau, int symbol) const; + void frameSymbol(int symCoh, int symNC); + void frameBits(int bitCoh, int bitNC); + void finishFrame(int lane); + bool searchingForSFD() const; + void abortFrame(); + void endReceive(); + static bool lengthValid(int length) { return (length >= 4) && (length <= m_maxPSDULength); } +}; + +#endif // INCLUDE_IEEE_802_15_4_DEMODRECEIVER_H diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsettings.cpp b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsettings.cpp new file mode 100644 index 000000000..df2e315a0 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsettings.cpp @@ -0,0 +1,468 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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 "util/simpleserializer.h" +#include "settings/serializable.h" +#include "ieee_802_15_4_demodsettings.h" + +IEEE_802_15_4_DemodSettings::IEEE_802_15_4_DemodSettings() : + m_channelMarker(nullptr), + m_scopeGUI(nullptr), + m_rollupState(nullptr) +{ + resetToDefaults(); +} + +void IEEE_802_15_4_DemodSettings::resetToDefaults() +{ + m_inputFrequencyOffset = 0; + setPHY("250kbps >2GHz O-QPSK"); + m_samplesPerChip = 4; + m_threshold = 0.05f; + m_showBadFCS = false; + m_filterFrameType = FilterAll; + m_filterPANID = ""; + m_filterAddress = ""; + m_udpEnabled = false; + m_udpAddress = "127.0.0.1"; + m_udpPort = m_zepPort; + m_udpFormat = ZEP; + m_logFilename = "802_15_4_log.csv"; + m_logEnabled = false; + m_useFileTime = false; + m_rgbColor = QColor(255, 0, 255).rgb(); + m_title = "802.15.4 Demodulator"; + m_streamIndex = 0; + m_useReverseAPI = false; + m_reverseAPIAddress = "127.0.0.1"; + m_reverseAPIPort = 8888; + m_reverseAPIDeviceIndex = 0; + m_reverseAPIChannelIndex = 0; + m_workspaceIndex = 0; + m_hidden = false; + + for (int i = 0; i < IEEE_802_15_4_DEMOD_COLUMNS; i++) + { + m_columnIndexes[i] = i; + m_columnSizes[i] = -1; // Autosize + } +} + +IEEE_802_15_4_PHY IEEE_802_15_4_DemodSettings::getPHY() const +{ + IEEE_802_15_4_PHY phy; + + if (!phy.fromString(m_phy)) { + phy.fromString("250kbps >2GHz O-QPSK"); + } + + return phy; +} + +int IEEE_802_15_4_DemodSettings::getChannelSampleRate() const +{ + return m_samplesPerChip * getPHY().getChipRate(); +} + +Real IEEE_802_15_4_DemodSettings::getDefaultMaxFrequencyOffset(const IEEE_802_15_4_PHY& phy) +{ + double frequency; + + if (phy.m_modulation == IEEE_802_15_4_PHY::BPSK) { + frequency = phy.m_bitRate == 20000 ? 868.6e6 : 928e6; + } else if (!phy.m_subGHzBand) { + frequency = 2483.5e6; + } else if (phy.m_bitRate == 100000) { + frequency = 868.6e6; + } else if (phy.m_pulseShaping == IEEE_802_15_4_PHY::RC) { + frequency = 787e6; + } else { + frequency = 928e6; + } + + return (Real) (frequency * 80e-6); +} + +bool IEEE_802_15_4_DemodSettings::setPHY(const QString& phyName) +{ + IEEE_802_15_4_PHY phy; + + if (!phy.fromString(phyName)) { + return false; + } + + m_phy = phy.toString().isEmpty() ? phyName : phy.toString(); + m_rfBandwidth = phy.getOccupiedBandwidth(); + m_maxFrequencyOffset = getDefaultMaxFrequencyOffset(phy); + + return true; +} + +QByteArray IEEE_802_15_4_DemodSettings::serialize() const +{ + SimpleSerializer s(1); + + s.writeS64(1, m_inputFrequencyOffset); + s.writeString(2, m_phy); + s.writeFloat(3, m_rfBandwidth); + s.writeS32(4, m_samplesPerChip); + s.writeFloat(5, m_maxFrequencyOffset); + s.writeFloat(6, m_threshold); + s.writeBool(7, m_showBadFCS); + s.writeS32(8, (int) m_filterFrameType); + s.writeString(9, m_filterPANID); + s.writeString(10, m_filterAddress); + s.writeBool(11, m_udpEnabled); + s.writeString(12, m_udpAddress); + s.writeU32(13, m_udpPort); + s.writeS32(14, (int) m_udpFormat); + s.writeString(15, m_logFilename); + s.writeBool(16, m_logEnabled); + s.writeBool(17, m_useFileTime); + + s.writeU32(20, m_rgbColor); + s.writeString(21, m_title); + + if (m_channelMarker) { + s.writeBlob(22, m_channelMarker->serialize()); + } + + s.writeS32(23, m_streamIndex); + s.writeBool(24, m_useReverseAPI); + s.writeString(25, m_reverseAPIAddress); + s.writeU32(26, m_reverseAPIPort); + s.writeU32(27, m_reverseAPIDeviceIndex); + s.writeU32(28, m_reverseAPIChannelIndex); + + if (m_scopeGUI) { + s.writeBlob(29, m_scopeGUI->serialize()); + } + if (m_rollupState) { + s.writeBlob(30, m_rollupState->serialize()); + } + + s.writeS32(31, m_workspaceIndex); + s.writeBlob(32, m_geometryBytes); + s.writeBool(33, m_hidden); + + for (int i = 0; i < IEEE_802_15_4_DEMOD_COLUMNS; i++) { + s.writeS32(100 + i, m_columnIndexes[i]); + } + for (int i = 0; i < IEEE_802_15_4_DEMOD_COLUMNS; i++) { + s.writeS32(200 + i, m_columnSizes[i]); + } + + return s.final(); +} + +bool IEEE_802_15_4_DemodSettings::deserialize(const QByteArray& data) +{ + SimpleDeserializer d(data); + + if (!d.isValid()) + { + resetToDefaults(); + return false; + } + + if (d.getVersion() == 1) + { + QByteArray bytetmp; + uint32_t utmp; + int itmp; + + d.readS64(1, &m_inputFrequencyOffset, 0); + d.readString(2, &m_phy, "250kbps >2GHz O-QPSK"); + IEEE_802_15_4_PHY phy = getPHY(); + d.readFloat(3, &m_rfBandwidth, phy.getOccupiedBandwidth()); + d.readS32(4, &m_samplesPerChip, 4); + m_samplesPerChip = std::max(2, std::min(16, m_samplesPerChip)); + d.readFloat(5, &m_maxFrequencyOffset, getDefaultMaxFrequencyOffset(phy)); + d.readFloat(6, &m_threshold, 0.05f); + m_threshold = std::max(m_minThreshold, std::min(m_maxThreshold, m_threshold)); + d.readBool(7, &m_showBadFCS, false); + d.readS32(8, &itmp, (int) FilterAll); + m_filterFrameType = (FrameTypeFilter) std::max((int) FilterAll, std::min((int) FilterOther, itmp)); + d.readString(9, &m_filterPANID, ""); + d.readString(10, &m_filterAddress, ""); + d.readBool(11, &m_udpEnabled, false); + d.readString(12, &m_udpAddress, "127.0.0.1"); + d.readU32(13, &utmp, m_zepPort); + + if ((utmp > 1023) && (utmp <= 65535)) { + m_udpPort = utmp; + } else { + m_udpPort = m_zepPort; + } + + d.readS32(14, &itmp, (int) ZEP); + m_udpFormat = itmp == (int) Raw ? Raw : ZEP; + d.readString(15, &m_logFilename, "802_15_4_log.csv"); + d.readBool(16, &m_logEnabled, false); + d.readBool(17, &m_useFileTime, false); + + d.readU32(20, &m_rgbColor, QColor(255, 0, 255).rgb()); + d.readString(21, &m_title, "802.15.4 Demodulator"); + + if (m_channelMarker) + { + d.readBlob(22, &bytetmp); + m_channelMarker->deserialize(bytetmp); + } + + d.readS32(23, &m_streamIndex, 0); + d.readBool(24, &m_useReverseAPI, false); + d.readString(25, &m_reverseAPIAddress, "127.0.0.1"); + d.readU32(26, &utmp, 0); + + if ((utmp > 1023) && (utmp <= 65535)) { + m_reverseAPIPort = utmp; + } else { + m_reverseAPIPort = 8888; + } + + d.readU32(27, &utmp, 0); + m_reverseAPIDeviceIndex = utmp > 99 ? 99 : utmp; + d.readU32(28, &utmp, 0); + m_reverseAPIChannelIndex = utmp > 99 ? 99 : utmp; + + if (m_scopeGUI) + { + d.readBlob(29, &bytetmp); + m_scopeGUI->deserialize(bytetmp); + } + + if (m_rollupState) + { + d.readBlob(30, &bytetmp); + m_rollupState->deserialize(bytetmp); + } + + d.readS32(31, &m_workspaceIndex, 0); + d.readBlob(32, &m_geometryBytes); + d.readBool(33, &m_hidden, false); + + for (int i = 0; i < IEEE_802_15_4_DEMOD_COLUMNS; i++) { + d.readS32(100 + i, &m_columnIndexes[i], i); + } + for (int i = 0; i < IEEE_802_15_4_DEMOD_COLUMNS; i++) { + d.readS32(200 + i, &m_columnSizes[i], -1); + } + + return true; + } + else + { + resetToDefaults(); + return false; + } +} + +void IEEE_802_15_4_DemodSettings::applySettings(const QStringList& settingsKeys, const IEEE_802_15_4_DemodSettings& settings) +{ + if (settingsKeys.contains("inputFrequencyOffset")) { + m_inputFrequencyOffset = settings.m_inputFrequencyOffset; + } + if (settingsKeys.contains("phy")) { + m_phy = settings.m_phy; + } + if (settingsKeys.contains("rfBandwidth")) { + m_rfBandwidth = settings.m_rfBandwidth; + } + if (settingsKeys.contains("samplesPerChip")) { + m_samplesPerChip = settings.m_samplesPerChip; + } + if (settingsKeys.contains("maxFrequencyOffset")) { + m_maxFrequencyOffset = settings.m_maxFrequencyOffset; + } + if (settingsKeys.contains("threshold")) { + m_threshold = settings.m_threshold; + } + if (settingsKeys.contains("showBadFCS")) { + m_showBadFCS = settings.m_showBadFCS; + } + if (settingsKeys.contains("filterFrameType")) { + m_filterFrameType = settings.m_filterFrameType; + } + if (settingsKeys.contains("filterPANID")) { + m_filterPANID = settings.m_filterPANID; + } + if (settingsKeys.contains("filterAddress")) { + m_filterAddress = settings.m_filterAddress; + } + if (settingsKeys.contains("udpEnabled")) { + m_udpEnabled = settings.m_udpEnabled; + } + if (settingsKeys.contains("udpAddress")) { + m_udpAddress = settings.m_udpAddress; + } + if (settingsKeys.contains("udpPort")) { + m_udpPort = settings.m_udpPort; + } + if (settingsKeys.contains("udpFormat")) { + m_udpFormat = settings.m_udpFormat; + } + if (settingsKeys.contains("logFilename")) { + m_logFilename = settings.m_logFilename; + } + if (settingsKeys.contains("logEnabled")) { + m_logEnabled = settings.m_logEnabled; + } + if (settingsKeys.contains("useFileTime")) { + m_useFileTime = settings.m_useFileTime; + } + if (settingsKeys.contains("rgbColor")) { + m_rgbColor = settings.m_rgbColor; + } + if (settingsKeys.contains("title")) { + m_title = settings.m_title; + } + if (settingsKeys.contains("streamIndex")) { + m_streamIndex = settings.m_streamIndex; + } + if (settingsKeys.contains("useReverseAPI")) { + m_useReverseAPI = settings.m_useReverseAPI; + } + if (settingsKeys.contains("reverseAPIAddress")) { + m_reverseAPIAddress = settings.m_reverseAPIAddress; + } + if (settingsKeys.contains("reverseAPIPort")) { + m_reverseAPIPort = settings.m_reverseAPIPort; + } + if (settingsKeys.contains("reverseAPIDeviceIndex")) { + m_reverseAPIDeviceIndex = settings.m_reverseAPIDeviceIndex; + } + if (settingsKeys.contains("reverseAPIChannelIndex")) { + m_reverseAPIChannelIndex = settings.m_reverseAPIChannelIndex; + } + if (settingsKeys.contains("workspaceIndex")) { + m_workspaceIndex = settings.m_workspaceIndex; + } + if (settingsKeys.contains("geometryBytes")) { + m_geometryBytes = settings.m_geometryBytes; + } + if (settingsKeys.contains("hidden")) { + m_hidden = settings.m_hidden; + } + if (settingsKeys.contains("columnIndexes")) + { + for (int i = 0; i < IEEE_802_15_4_DEMOD_COLUMNS; i++) { + m_columnIndexes[i] = settings.m_columnIndexes[i]; + } + } + if (settingsKeys.contains("columnSizes")) + { + for (int i = 0; i < IEEE_802_15_4_DEMOD_COLUMNS; i++) { + m_columnSizes[i] = settings.m_columnSizes[i]; + } + } +} + +QString IEEE_802_15_4_DemodSettings::getDebugString(const QStringList& settingsKeys, bool force) const +{ + std::ostringstream ostr; + + if (settingsKeys.contains("inputFrequencyOffset") || force) { + ostr << " m_inputFrequencyOffset: " << m_inputFrequencyOffset; + } + if (settingsKeys.contains("phy") || force) { + ostr << " m_phy: " << m_phy.toStdString(); + } + if (settingsKeys.contains("rfBandwidth") || force) { + ostr << " m_rfBandwidth: " << m_rfBandwidth; + } + if (settingsKeys.contains("samplesPerChip") || force) { + ostr << " m_samplesPerChip: " << m_samplesPerChip; + } + if (settingsKeys.contains("maxFrequencyOffset") || force) { + ostr << " m_maxFrequencyOffset: " << m_maxFrequencyOffset; + } + if (settingsKeys.contains("threshold") || force) { + ostr << " m_threshold: " << m_threshold; + } + if (settingsKeys.contains("showBadFCS") || force) { + ostr << " m_showBadFCS: " << m_showBadFCS; + } + if (settingsKeys.contains("filterFrameType") || force) { + ostr << " m_filterFrameType: " << m_filterFrameType; + } + if (settingsKeys.contains("filterPANID") || force) { + ostr << " m_filterPANID: " << m_filterPANID.toStdString(); + } + if (settingsKeys.contains("filterAddress") || force) { + ostr << " m_filterAddress: " << m_filterAddress.toStdString(); + } + if (settingsKeys.contains("udpEnabled") || force) { + ostr << " m_udpEnabled: " << m_udpEnabled; + } + if (settingsKeys.contains("udpAddress") || force) { + ostr << " m_udpAddress: " << m_udpAddress.toStdString(); + } + if (settingsKeys.contains("udpPort") || force) { + ostr << " m_udpPort: " << m_udpPort; + } + if (settingsKeys.contains("udpFormat") || force) { + ostr << " m_udpFormat: " << m_udpFormat; + } + if (settingsKeys.contains("logFilename") || force) { + ostr << " m_logFilename: " << m_logFilename.toStdString(); + } + if (settingsKeys.contains("logEnabled") || force) { + ostr << " m_logEnabled: " << m_logEnabled; + } + if (settingsKeys.contains("useFileTime") || force) { + ostr << " m_useFileTime: " << m_useFileTime; + } + if (settingsKeys.contains("rgbColor") || force) { + ostr << " m_rgbColor: " << m_rgbColor; + } + if (settingsKeys.contains("title") || force) { + ostr << " m_title: " << m_title.toStdString(); + } + if (settingsKeys.contains("streamIndex") || force) { + ostr << " m_streamIndex: " << m_streamIndex; + } + if (settingsKeys.contains("useReverseAPI") || force) { + ostr << " m_useReverseAPI: " << m_useReverseAPI; + } + if (settingsKeys.contains("reverseAPIAddress") || force) { + ostr << " m_reverseAPIAddress: " << m_reverseAPIAddress.toStdString(); + } + if (settingsKeys.contains("reverseAPIPort") || force) { + ostr << " m_reverseAPIPort: " << m_reverseAPIPort; + } + if (settingsKeys.contains("reverseAPIDeviceIndex") || force) { + ostr << " m_reverseAPIDeviceIndex: " << m_reverseAPIDeviceIndex; + } + if (settingsKeys.contains("reverseAPIChannelIndex") || force) { + ostr << " m_reverseAPIChannelIndex: " << m_reverseAPIChannelIndex; + } + if (settingsKeys.contains("workspaceIndex") || force) { + ostr << " m_workspaceIndex: " << m_workspaceIndex; + } + if (settingsKeys.contains("hidden") || force) { + ostr << " m_hidden: " << m_hidden; + } + + return QString(ostr.str().c_str()); +} diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsettings.h b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsettings.h new file mode 100644 index 000000000..78f165166 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsettings.h @@ -0,0 +1,108 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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_IEEE_802_15_4_DEMODSETTINGS_H +#define INCLUDE_IEEE_802_15_4_DEMODSETTINGS_H + +#include +#include + +#include "dsp/dsptypes.h" +#include "util/ieee_802_15_4.h" + +class Serializable; + +#define IEEE_802_15_4_DEMOD_COLUMNS 16 + +struct IEEE_802_15_4_DemodSettings +{ + enum UDPFormat { + ZEP, //!< ZigBee Encapsulation Protocol v2, as decoded by Wireshark + Raw //!< PSDU (MAC frame including FCS) + }; + + enum FrameTypeFilter { + FilterAll, + FilterBeacon, + FilterData, + FilterAck, + FilterCommand, + FilterOther + }; + + qint64 m_inputFrequencyOffset; + QString m_phy; //!< PHY name, as in IEEE_802_15_4_PHY::getPHYNames() + Real m_rfBandwidth; + int m_samplesPerChip; //!< Channel sample rate is this multiplied by the chip rate + Real m_maxFrequencyOffset; //!< Maximum carrier frequency offset to search for during acquisition in Hz + Real m_threshold; //!< Preamble detection threshold (0-1) + bool m_showBadFCS; //!< Show frames with invalid FCS + FrameTypeFilter m_filterFrameType; + QString m_filterPANID; //!< Regular expression to match against PAN IDs + QString m_filterAddress; //!< Regular expression to match against source or destination address + bool m_udpEnabled; + QString m_udpAddress; + uint16_t m_udpPort; + UDPFormat m_udpFormat; + QString m_logFilename; //!< .csv or .pcap + bool m_logEnabled; + bool m_useFileTime; + + quint32 m_rgbColor; + QString m_title; + Serializable *m_channelMarker; + int m_streamIndex; //!< MIMO channel. Not relevant when connected to SI (single Rx). + bool m_useReverseAPI; + QString m_reverseAPIAddress; + uint16_t m_reverseAPIPort; + uint16_t m_reverseAPIDeviceIndex; + uint16_t m_reverseAPIChannelIndex; + Serializable *m_scopeGUI; + Serializable *m_rollupState; + int m_workspaceIndex; + QByteArray m_geometryBytes; + bool m_hidden; + + int m_columnIndexes[IEEE_802_15_4_DEMOD_COLUMNS]; //!< How the columns are ordered in the table + int m_columnSizes[IEEE_802_15_4_DEMOD_COLUMNS]; //!< Size of the columns in the table + + static const int m_scopeStreams = 8; + //! Range of preamble detection threshold. Too low a value results in continuous detections + static constexpr float m_minThreshold = 0.005f; + static constexpr float m_maxThreshold = 1.0f; + static const int m_zepPort = 17754; + + IEEE_802_15_4_DemodSettings(); + void resetToDefaults(); + void setChannelMarker(Serializable *channelMarker) { m_channelMarker = channelMarker; } + void setRollupState(Serializable *rollupState) { m_rollupState = rollupState; } + void setScopeGUI(Serializable *scopeGUI) { m_scopeGUI = scopeGUI; } + QByteArray serialize() const; + bool deserialize(const QByteArray& data); + void applySettings(const QStringList& settingsKeys, const IEEE_802_15_4_DemodSettings& settings); + QString getDebugString(const QStringList& settingsKeys, bool force=false) const; + + IEEE_802_15_4_PHY getPHY() const; + int getChannelSampleRate() const; + //! Set m_phy and parameters that depend on it to default values + bool setPHY(const QString& phy); + //! Default maximum frequency offset for a PHY: +-40ppm at each end at the highest frequency band the PHY is used in + static Real getDefaultMaxFrequencyOffset(const IEEE_802_15_4_PHY& phy); +}; + +#endif /* INCLUDE_IEEE_802_15_4_DEMODSETTINGS_H */ diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsink.cpp b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsink.cpp new file mode 100644 index 000000000..9d8915a6b --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsink.cpp @@ -0,0 +1,246 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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/scopevis.h" +#include "device/deviceapi.h" +#include "channel/channelwebapiutils.h" + +#include "ieee_802_15_4_demod.h" +#include "ieee_802_15_4_demodsink.h" + +IEEE_802_15_4_DemodSink::IEEE_802_15_4_DemodSink(IEEE_802_15_4_Demod *demod) : + m_scopeSink(nullptr), + m_demod(demod), + m_channel(nullptr), + m_channelSampleRate(8000000), + m_channelFrequencyOffset(0), + m_sampleRate(8000000), + m_interpolatorDistance(1.0f), + m_interpolatorDistanceRemain(1.0f), + m_magsq(0.0), + m_magsqSum(0.0), + m_magsqPeak(0.0), + m_magsqCount(0), + m_messageQueueToChannel(nullptr), + m_sampleBufferIndex(0) +{ + for (int i = 0; i < IEEE_802_15_4_DemodSettings::m_scopeStreams; i++) { + m_sampleBuffer[i].resize(m_sampleBufferSize); + } + + applySettings(QStringList(), m_settings, true); + applyChannelSettings(m_channelSampleRate, m_channelFrequencyOffset, true); +} + +IEEE_802_15_4_DemodSink::~IEEE_802_15_4_DemodSink() +{ +} + +void IEEE_802_15_4_DemodSink::sampleToScope(Complex sample, Real magsq) +{ + if (m_scopeSink) + { + const IEEE_802_15_4_DemodReceiver::Scope& scope = m_receiver.getScope(); + + m_sampleBuffer[0][m_sampleBufferIndex] = sample; + m_sampleBuffer[1][m_sampleBufferIndex] = Complex(magsq, 0.0f); + m_sampleBuffer[2][m_sampleBufferIndex] = Complex(scope.m_detectMetric, 0.0f); + m_sampleBuffer[3][m_sampleBufferIndex] = Complex(scope.m_correlation, 0.0f); + m_sampleBuffer[4][m_sampleBufferIndex] = Complex(scope.m_chip, 0.0f); + m_sampleBuffer[5][m_sampleBufferIndex] = Complex(scope.m_phase, 0.0f); + m_sampleBuffer[6][m_sampleBufferIndex] = Complex(scope.m_state, 0.0f); + m_sampleBuffer[7][m_sampleBufferIndex] = Complex(scope.m_crc, 0.0f); + m_sampleBufferIndex++; + + if (m_sampleBufferIndex == m_sampleBufferSize) + { + std::vector vbegin; + + for (int i = 0; i < IEEE_802_15_4_DemodSettings::m_scopeStreams; i++) { + vbegin.push_back(m_sampleBuffer[i].begin()); + } + + m_scopeSink->feed(vbegin, m_sampleBufferSize); + m_sampleBufferIndex = 0; + } + } +} + +void IEEE_802_15_4_DemodSink::feed(const SampleVector::const_iterator& begin, const SampleVector::const_iterator& end) +{ + Complex ci; + + for (SampleVector::const_iterator it = begin; it != end; ++it) + { + Complex c(it->real(), it->imag()); + c *= m_nco.nextIQ(); + + if (m_interpolatorDistance < 1.0f) // interpolate + { + while (!m_interpolator.interpolate(&m_interpolatorDistanceRemain, c, &ci)) + { + processOneSample(ci); + m_interpolatorDistanceRemain += m_interpolatorDistance; + } + } + else // decimate + { + if (m_interpolator.decimate(&m_interpolatorDistanceRemain, c, &ci)) + { + processOneSample(ci); + m_interpolatorDistanceRemain += m_interpolatorDistance; + } + } + } +} + +void IEEE_802_15_4_DemodSink::processOneSample(Complex &ci) +{ + Complex x = ci / SDR_RX_SCALEF; + Real magsq = std::norm(x); + + // Calculate average and peak levels for level meter + m_movingAverage(magsq); + m_magsq = m_movingAverage.asDouble(); + m_magsqSum += magsq; + if (magsq > m_magsqPeak) { + m_magsqPeak = magsq; + } + m_magsqCount++; + + m_receiver.process(IEEE_802_15_4_DemodReceiver::Cf(x.real(), x.imag())); + + while (m_receiver.frameAvailable()) { + sendFrame(m_receiver.popFrame()); + } + + sampleToScope(x, magsq); +} + +void IEEE_802_15_4_DemodSink::sendFrame(const IEEE_802_15_4_DemodReceiver::Frame& frame) +{ + if (!getMessageQueueToChannel()) { + return; + } + + QDateTime dateTime = QDateTime::currentDateTime(); + + if (m_settings.m_useFileTime) + { + QString hardwareId = m_demod->getDeviceAPI()->getHardwareId(); + + if ((hardwareId == "FileInput") || (hardwareId == "SigMFFileInput")) + { + QString dateTimeStr; + int deviceIdx = m_demod->getDeviceSetIndex(); + + if (ChannelWebAPIUtils::getDeviceReportValue(deviceIdx, "absoluteTime", dateTimeStr)) + { + QDateTime fileTime = QDateTime::fromString(dateTimeStr, Qt::ISODateWithMs); + + if (fileTime.isValid()) { + dateTime = fileTime; + } + } + } + } + + QByteArray psdu((const char *) frame.m_psdu.data(), (int) frame.m_psdu.size()); + float powerDB = frame.m_power > 0.0f ? 10.0f * std::log10(frame.m_power) : -150.0f; + + IEEE_802_15_4_Demod::MsgFrame *msg = IEEE_802_15_4_Demod::MsgFrame::create( + psdu, dateTime, frame.m_fcsOK, frame.m_coherent, frame.m_frequencyOffset, frame.m_lqi, powerDB, frame.m_snr); + getMessageQueueToChannel()->push(msg); +} + +void IEEE_802_15_4_DemodSink::configureResampler() +{ + m_sampleRate = m_settings.getChannelSampleRate(); + // Filter to the RF bandwidth, but keep the cutoff below the Nyquist frequency of the + // lower of the input and output sample rates, so nothing aliases on to the signal + double cutoff = std::min(m_settings.m_rfBandwidth / 2.0, 0.45 * std::min(m_channelSampleRate, m_sampleRate)); + m_interpolator.create(16, m_channelSampleRate, cutoff); + m_interpolatorDistance = (Real) m_channelSampleRate / (Real) m_sampleRate; + m_interpolatorDistanceRemain = m_interpolatorDistance; +} + +void IEEE_802_15_4_DemodSink::configureReceiver() +{ + m_receiver.configure(m_settings.getPHY(), m_settings.m_samplesPerChip, m_settings.m_maxFrequencyOffset, m_settings.m_threshold); +} + +void IEEE_802_15_4_DemodSink::applyChannelSettings(int channelSampleRate, int channelFrequencyOffset, bool force) +{ + qDebug() << "IEEE_802_15_4_DemodSink::applyChannelSettings:" + << " channelSampleRate: " << channelSampleRate + << " channelFrequencyOffset: " << channelFrequencyOffset; + + if ((m_channelFrequencyOffset != channelFrequencyOffset) || + (m_channelSampleRate != channelSampleRate) || force) + { + m_nco.setFreq(-channelFrequencyOffset, channelSampleRate); + } + + if ((m_channelSampleRate != channelSampleRate) || force) + { + m_channelSampleRate = channelSampleRate; + configureResampler(); + } + + m_channelSampleRate = channelSampleRate; + m_channelFrequencyOffset = channelFrequencyOffset; +} + +void IEEE_802_15_4_DemodSink::applySettings(const QStringList& settingsKeys, const IEEE_802_15_4_DemodSettings& settings, bool force) +{ + qDebug() << "IEEE_802_15_4_DemodSink::applySettings:" << settings.getDebugString(settingsKeys, force); + + bool resampler = (settingsKeys.contains("rfBandwidth") && (settings.m_rfBandwidth != m_settings.m_rfBandwidth)) + || (settingsKeys.contains("phy") && (settings.m_phy != m_settings.m_phy)) + || (settingsKeys.contains("samplesPerChip") && (settings.m_samplesPerChip != m_settings.m_samplesPerChip)) + || force; + bool receiver = (settingsKeys.contains("phy") && (settings.m_phy != m_settings.m_phy)) + || (settingsKeys.contains("samplesPerChip") && (settings.m_samplesPerChip != m_settings.m_samplesPerChip)) + || force; + + if (force) { + m_settings = settings; + } else { + m_settings.applySettings(settingsKeys, settings); + } + + if (resampler) { + configureResampler(); + } + + if (receiver) + { + configureReceiver(); + } + else + { + if (settingsKeys.contains("maxFrequencyOffset")) { + m_receiver.setMaxFrequencyOffset(m_settings.m_maxFrequencyOffset); + } + if (settingsKeys.contains("threshold")) { + m_receiver.setThreshold(m_settings.m_threshold); + } + } +} diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsink.h b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsink.h new file mode 100644 index 000000000..45fd4c50b --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodsink.h @@ -0,0 +1,116 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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_IEEE_802_15_4_DEMODSINK_H +#define INCLUDE_IEEE_802_15_4_DEMODSINK_H + +#include "dsp/channelsamplesink.h" +#include "dsp/nco.h" +#include "dsp/interpolator.h" +#include "util/movingaverage.h" +#include "util/messagequeue.h" + +#include "ieee_802_15_4_demodsettings.h" +#include "ieee_802_15_4_demodreceiver.h" + +class ChannelAPI; +class IEEE_802_15_4_Demod; +class ScopeVis; + +class IEEE_802_15_4_DemodSink : public ChannelSampleSink { +public: + IEEE_802_15_4_DemodSink(IEEE_802_15_4_Demod *demod); + ~IEEE_802_15_4_DemodSink(); + + virtual void feed(const SampleVector::const_iterator& begin, const SampleVector::const_iterator& end); + + void setScopeSink(ScopeVis* scopeSink) { m_scopeSink = scopeSink; } + void applyChannelSettings(int channelSampleRate, int channelFrequencyOffset, bool force = false); + void applySettings(const QStringList& settingsKeys, const IEEE_802_15_4_DemodSettings& settings, bool force = false); + void setMessageQueueToChannel(MessageQueue *messageQueue) { m_messageQueueToChannel = messageQueue; } + void setChannel(ChannelAPI *channel) { m_channel = channel; } + + double getMagSq() const { return m_magsq; } + + void getMagSqLevels(double& avg, double& peak, int& nbSamples) + { + if (m_magsqCount > 0) + { + m_magsq = m_magsqSum / m_magsqCount; + m_magSqLevelStore.m_magsq = m_magsq; + m_magSqLevelStore.m_magsqPeak = m_magsqPeak; + } + + avg = m_magSqLevelStore.m_magsq; + peak = m_magSqLevelStore.m_magsqPeak; + nbSamples = m_magsqCount == 0 ? 1 : m_magsqCount; + + m_magsqSum = 0.0f; + m_magsqPeak = 0.0f; + m_magsqCount = 0; + } + +private: + struct MagSqLevelsStore + { + MagSqLevelsStore() : + m_magsq(1e-12), + m_magsqPeak(1e-12) + {} + double m_magsq; + double m_magsqPeak; + }; + + ScopeVis* m_scopeSink; + IEEE_802_15_4_Demod *m_demod; + IEEE_802_15_4_DemodSettings m_settings; + ChannelAPI *m_channel; + int m_channelSampleRate; + int m_channelFrequencyOffset; + int m_sampleRate; //!< Receiver sample rate (samples per chip * chip rate) + + NCO m_nco; + Interpolator m_interpolator; + Real m_interpolatorDistance; + Real m_interpolatorDistanceRemain; + + double m_magsq; + double m_magsqSum; + double m_magsqPeak; + int m_magsqCount; + MagSqLevelsStore m_magSqLevelStore; + + MessageQueue *m_messageQueueToChannel; + + MovingAverageUtil m_movingAverage; + + IEEE_802_15_4_DemodReceiver m_receiver; + + ComplexVector m_sampleBuffer[IEEE_802_15_4_DemodSettings::m_scopeStreams]; + static const int m_sampleBufferSize = 4096; + int m_sampleBufferIndex; + + void processOneSample(Complex &ci); + void configureResampler(); + void configureReceiver(); + void sendFrame(const IEEE_802_15_4_DemodReceiver::Frame& frame); + MessageQueue *getMessageQueueToChannel() { return m_messageQueueToChannel; } + void sampleToScope(Complex sample, Real magsq); +}; + +#endif // INCLUDE_IEEE_802_15_4_DEMODSINK_H diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodwebapiadapter.cpp b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodwebapiadapter.cpp new file mode 100644 index 000000000..35b0f2238 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodwebapiadapter.cpp @@ -0,0 +1,54 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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 "ieee_802_15_4_demod.h" +#include "ieee_802_15_4_demodwebapiadapter.h" + +IEEE_802_15_4_DemodWebAPIAdapter::IEEE_802_15_4_DemodWebAPIAdapter() +{ +} + +IEEE_802_15_4_DemodWebAPIAdapter::~IEEE_802_15_4_DemodWebAPIAdapter() +{ +} + +int IEEE_802_15_4_DemodWebAPIAdapter::webapiSettingsGet( + SWGSDRangel::SWGChannelSettings& response, + QString& errorMessage) +{ + (void) errorMessage; + response.setIeee802154DemodSettings(new SWGSDRangel::SWGIEEE_802_15_4_DemodSettings()); + response.getIeee802154DemodSettings()->init(); + IEEE_802_15_4_Demod::webapiFormatChannelSettings(response, m_settings); + + return 200; +} + +int IEEE_802_15_4_DemodWebAPIAdapter::webapiSettingsPutPatch( + bool force, + const QStringList& channelSettingsKeys, + SWGSDRangel::SWGChannelSettings& response, + QString& errorMessage) +{ + (void) force; + (void) errorMessage; + IEEE_802_15_4_Demod::webapiUpdateChannelSettings(m_settings, channelSettingsKeys, response); + + return 200; +} diff --git a/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodwebapiadapter.h b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodwebapiadapter.h new file mode 100644 index 000000000..8087a5ac3 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/ieee_802_15_4_demodwebapiadapter.h @@ -0,0 +1,50 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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_IEEE_802_15_4_DEMOD_WEBAPIADAPTER_H +#define INCLUDE_IEEE_802_15_4_DEMOD_WEBAPIADAPTER_H + +#include "channel/channelwebapiadapter.h" +#include "ieee_802_15_4_demodsettings.h" + +/** + * Standalone API adapter only for the settings + */ +class IEEE_802_15_4_DemodWebAPIAdapter : public ChannelWebAPIAdapter { +public: + IEEE_802_15_4_DemodWebAPIAdapter(); + virtual ~IEEE_802_15_4_DemodWebAPIAdapter(); + + 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: + IEEE_802_15_4_DemodSettings m_settings; +}; + +#endif // INCLUDE_IEEE_802_15_4_DEMOD_WEBAPIADAPTER_H diff --git a/plugins/channelrx/demod802.15.4/readme.md b/plugins/channelrx/demod802.15.4/readme.md new file mode 100644 index 000000000..b2ab1db12 --- /dev/null +++ b/plugins/channelrx/demod802.15.4/readme.md @@ -0,0 +1,202 @@ +

IEEE 802.15.4 demodulator plugin

+ +

Introduction

+ +This plugin can be used to demodulate IEEE 802.15.4 frames. The 802.15.4 PHY & MAC layers are used by networking protocols such as ZigBee, Thread, 6LoWPAN, WirelessHART and others. + +The demodulator supports the same PHYs as the [802.15.4 modulator](../../channeltx/mod802.15.4/readme.md): the BPSK PHYs (clause 13 of IEEE 802.15.4-2015) and the O-QPSK PHYs (clause 12), including the 2.4GHz O-QPSK PHY used by ZigBee and Thread. + +Received frames are displayed in a table, with the MAC header decoded. Frames can be forwarded via UDP, either as raw MAC frames or encapsulated in ZEP (ZigBee Encapsulation Protocol), which Wireshark can decode, or logged to a .csv or .pcap file. + +

Receiver

+ +All supported PHYs use DSSS (Direct Sequence Spread Spectrum), where each symbol (4 bits for O-QPSK, 1 bit for BPSK) is transmitted as a sequence of 32, 16 or 15 chips. + +The frequency tolerance of 802.15.4 devices is +/-40ppm, so two devices can be up to 80ppm apart: around +/-200kHz at 2.4GHz and +/-70kHz at 868/915MHz. The demodulator handles this, as well as clock offsets of 80ppm. + +When tested with the 802.15.4 modulator over a simulated AWGN channel with a frequency offset of 40ppm and clock offset of 20ppm, the packet error rate for a 20 octet PSDU (as used for the receiver sensitivity definition in 10.1.7 of the specification) was 1% at approximately the following Eb/N0: + +PHY | Both lanes | Coherent lane only | Non-coherent lane only +----------------------------|------------|--------------------|----------------------- +20kbps BPSK | 9dB | 9.5dB | 9.5dB +40kbps BPSK | 9.5dB | 9.5dB | 10dB +100kbps <1GHz O-QPSK | 6.5dB | 7dB | 8dB +250kbps <1GHz O-QPSK (Sine) | 7dB | 7dB | 8dB +250kbps <1GHz O-QPSK (RC) | 6dB | 6.5dB | 7.5dB +250kbps >2GHz O-QPSK | 7dB | 7dB | 7dB + +These were measured with 200 frames per 1dB step of Eb/N0, so are approximate. + +

Interface

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

1: Frequency shift from center frequency of reception

+ +Use the wheels to adjust the frequency shift in Hz from the center frequency of reception. Left click on a digit sets the cursor position at this digit. Right click on a digit sets all digits on the right to zero. This effectively floors value at the digit position. Wheels are moved with the mousewheel while pointing at the wheel or by selecting the wheel with the left mouse click and using the keyboard arrows. Pressing shift simultaneously moves digit by 5 and pressing control moves it by 2. + +

2: Channel power

+ +Average total power in dB relative to a +/- 1.0 amplitude signal received in the pass band. + +

3: Level meter in dB

+ + - top bar (green): average value + - bottom bar (blue green): instantaneous peak value + - tip vertical bar (bright green): peak hold value + +

4: PHY

+ +Specifies the PHY (physical layer), which determines the bit rate, modulation and spreading. Each PHY is applicable only to specific frequency bands, as detailed below: + +Channel Page | Channels | Frequencies (MHz) | PHY | Bit rate (kbps) | Chip rate (kcps) | Modulation | Shaping +-------------|----------|--------------------|-----------------------------|-----------------|------------------|------------|--------- +0 | 0 | 868.3 | 20kbps BPSK | 20 | 300 | BPSK | RC r=1 +0 | 1-10 | 906, 908... 924 | 40kbps BPSK | 40 | 600 | BPSK | RC r=1 +0 | 11-26 | 2405, 2410... 2480 | 250kbps >2GHz O-QPSK | 250 | 2000 | O-QPSK | Sine +2 | 0 | 868.3 | 100kbps <1GHz O-QPSK | 100 | 400 | O-QPSK | Sine +2 | 1-10 | 906, 908... 924 | 250kbps <1GHz O-QPSK (Sine) | 250 | 1000 | O-QPSK | Sine +5 | 0-3 | 780, 782... 786 | 250kbps <1GHz O-QPSK (RC) | 250 | 1000 | O-QPSK | RC r=0.8 +11 | 0-13 | 2363... 2397 | 250kbps >2GHz O-QPSK | 250 | 2000 | O-QPSK | Sine + +Changing the PHY sets the RF bandwidth (7) and maximum frequency offset (8) to default values for the PHY. + +

5: CR - Chip rate

+ +Displays the chip rate for the selected PHY. + +

6: SPC - Samples per chip

+ +The number of samples per chip the demodulator works at. The channel sample rate, which is displayed to the right, is the chip rate multiplied by this value. +4 is a good choice. 2 gives a small loss of sensitivity, but halves the CPU usage. Larger values use more CPU without any real benefit. + +The device's sample rate needs to be at least the RF bandwidth, but doesn't need to be a multiple of the chip rate, as the signal is resampled. +So for the 2.4GHz PHY, a device sample rate of 4MSa/s or more is suitable. When the device sample rate is lower than the RF bandwidth, the RF bandwidth value will be displayed with a red background. + +

7: BW - RF Bandwidth

+ +Specifies the bandwidth of the channel filter applied to the received signal. + +

8: Max ΔF - Maximum frequency offset

+ +The maximum carrier frequency offset in kHz to search for when acquiring a frame. The default is 80ppm of the highest frequency the PHY is used at. +If the frequency offset of the transmitter is known to be smaller (E.g. after adjusting the channel frequency (1) by the ΔF displayed in the table), reducing this slightly reduces the CPU used per preamble detection. + +

9: TH - Detection threshold

+ +Sets the threshold for detecting a preamble. Lower values allow weaker signals to be detected, but increase the number of false detections, each of which uses some CPU while the preamble is verified. +The default is 0.05. + +

10: UDP

+ +When checked, received frames are forwarded to the specified UDP address (11) and port (12). + +

11: UDP address

+ +IP address of the host to forward received frames to via UDP. + +

12: UDP port

+ +UDP port number to forward received frames to. + +

13: UDP format

+ +The format frames are forwarded in via UDP: + +* ZEP - Frames are encapsulated using ZigBee Encapsulation Protocol v2, which includes the channel number, LQI and a timestamp. Wireshark decodes ZEP on UDP port 17754. +* Raw - The MAC frame (PSDU), including the FCS. + +To view frames in Wireshark, set the UDP format to ZEP and the port to 17754, and capture on the loopback interface (which on Windows requires Npcap's loopback adapter). For ZigBee networks, you may need to enter the network key in Wireshark's ZigBee protocol preferences, to decrypt the NWK layer. + +

14: Frame type filter

+ +Display only frames of the selected type in the table (Beacon, Data, Ack, Command or Other). + +

15: PAN - PAN ID filter

+ +Entering a regular expression displays only frames where the source or destination PAN ID matches. PAN IDs are displayed as 0x followed by 4 hex digits. E.g. 0x1a62. + +

16: Addr - Address filter

+ +Entering a regular expression displays only frames where the source or destination address matches. Short addresses are displayed as 0x followed by 4 hex digits. +Extended addresses are displayed as 8 colon separated bytes, most significant byte first. E.g. 00:12:4b:00:01:02:03:04. + +

17: FCS - Show frames with invalid FCS

+ +When checked, frames with an invalid FCS (Frame Check Sequence - a CRC) are displayed in the table in red, logged and forwarded via UDP. When unchecked, only frames with a valid FCS are. + +

18: Use Date and Time from File

+ +When checked, if the source device is a File Input device, the date and time used for frame reception time is taken from the file playback time. Otherwise, the current system clock time is used. + +

19: Start/stop Logging Frames to File

+ +When checked, writes all received frames to a file. If the filename has a .pcap extension, frames are written in PCAP format (with link type 195, IEEE 802.15.4 with FCS), which can be opened in Wireshark. Otherwise, a .csv file is written. + +

20: Log Filename

+ +Click to specify the name of the file which received frames are logged to. + +

21: Read Data from .csv File

+ +Click to specify a previously written .csv log file, which is read and used to update the table. + +

22: Clear Frames from table

+ +Pressing this button clears all frames from the table. + +

Received Frames Table

+ +The received frames table displays information about each frame received. + +![802.15.4 Demodulator received frames table](../../../doc/img/IEEE_802_15_4_Demod_frames.png) + +* Date/Time - The date and time the frame was received. +* Type - MAC frame type: Beacon, Data, Ack, Command, Multipurpose, Fragment or Extended. +* Seq - Sequence number. +* Dst PAN - Destination PAN ID. +* Dst Addr - Destination address. +* Src PAN - Source PAN ID. +* Src Addr - Source address. +* Info - Command name, security level, acknowledgement request (AR), frame pending (FP), frame version and information elements. +* Len - Length of the PSDU (MAC frame) in bytes, including the FCS. +* Payload - MAC payload as hex. This is encrypted if security is enabled. +* PSDU - The complete MAC frame as hex, including the FCS. +* FCS - Whether the FCS is valid. +* Power - Received power during the frame in dB. +* SNR - Estimated symbol signal to noise ratio (Es/N0) in dB, after despreading. Eb/N0 is 6dB less for the O-QPSK PHYs. +* LQI - Link quality indicator. The mean normalised correlation of the received symbols, from 0 to 1. +* ΔF - Estimated carrier frequency offset in Hz. + +Right clicking on the table header allows you to select which columns to show. The columns can be reordered by left clicking and dragging the column header. Right clicking on an item in the table allows you to copy the value to the clipboard. + +

Waveforms

+ +The waveforms display shows signals within the demodulator, which may be useful for debugging. The available signals are: + +* IQ - The received signal, at the channel sample rate. +* MagSq - Magnitude squared of the received signal. +* Detect - Preamble detection metric, compared against the threshold (9). +* Correlation - Normalised correlation of the most recently decoded symbol. +* Chip - Phase corrected soft value of the last chip of the most recently decoded symbol. +* Phase - Tracked carrier phase / pi. +* State - 0 for searching, 1 for acquiring and 2 for receiving a frame. +* FCS - 1 after a frame with a valid FCS is received, -1 after a frame with an invalid FCS. + +

API

+ +Full details of the API can be found in the Swagger documentation. Below are a few examples: + +To set the PHY to 20kbps BPSK: + + curl -X PATCH "http://127.0.0.1:8091/sdrangel/deviceset/0/channel/0/settings" -d '{"channelType": "IEEE_802_15_4_Demod", "direction": 0, "IEEE_802_15_4_DemodSettings": { "phy": "20kbps BPSK" }}' + +To forward frames to Wireshark via ZEP: + + curl -X PATCH "http://127.0.0.1:8091/sdrangel/deviceset/0/channel/0/settings" -d '{"channelType": "IEEE_802_15_4_Demod", "direction": 0, "IEEE_802_15_4_DemodSettings": { "udpEnabled": 1, "udpAddress": "127.0.0.1", "udpPort": 17754, "udpFormat": 0 }}' + +To get the number of frames received: + + curl -X GET "http://127.0.0.1:8091/sdrangel/deviceset/0/channel/0/report" diff --git a/plugins/feature/mcpserver/mcpdocs.cpp b/plugins/feature/mcpserver/mcpdocs.cpp index 5164adbab..2a95cd710 100644 --- a/plugins/feature/mcpserver/mcpdocs.cpp +++ b/plugins/feature/mcpserver/mcpdocs.cpp @@ -404,6 +404,7 @@ const MCPDocs::Readme *MCPDocs::match(const QStringList& groups, const QString& // Plugins whose directory, id and title all differ static const QMap overrides = { {"ChannelAnalyzer", "chanalyzer"}, + {"IEEE_802_15_4_Demod", "demod802.15.4"}, {"IEEE_802_15_4_Mod", "mod802.15.4"}, }; diff --git a/sdrbase/CMakeLists.txt b/sdrbase/CMakeLists.txt index 48ae67509..6a799958a 100644 --- a/sdrbase/CMakeLists.txt +++ b/sdrbase/CMakeLists.txt @@ -243,6 +243,7 @@ set(sdrbase_SOURCES util/golay2312.cpp util/grb.cpp util/httpdownloadmanager.cpp + util/ieee_802_15_4.cpp util/interpolation.cpp util/jplhorizons.cpp util/kiwisdrlist.cpp @@ -514,6 +515,7 @@ set(sdrbase_HEADERS util/golay2312.h util/grb.h util/httpdownloadmanager.h + util/ieee_802_15_4.h util/incrementalarray.h util/incrementalvector.h util/interpolation.h diff --git a/sdrbase/resources/webapi.qrc b/sdrbase/resources/webapi.qrc index 9ab1ae0b4..7edc8baad 100644 --- a/sdrbase/resources/webapi.qrc +++ b/sdrbase/resources/webapi.qrc @@ -72,6 +72,7 @@ webapi/doc/swagger/include/GS232Controller.yaml webapi/doc/swagger/include/HackRF.yaml webapi/doc/swagger/include/HeatMap.yaml + webapi/doc/swagger/include/IEEE_802_15_4_Demod.yaml webapi/doc/swagger/include/IEEE_802_15_4_Mod.yaml webapi/doc/swagger/include/ILSDemod.yaml webapi/doc/swagger/include/Interferometer.yaml diff --git a/sdrbase/resources/webapi/doc/swagger/include/ChannelReport.yaml b/sdrbase/resources/webapi/doc/swagger/include/ChannelReport.yaml index 9ac0ab7c2..ecbfa4822 100644 --- a/sdrbase/resources/webapi/doc/swagger/include/ChannelReport.yaml +++ b/sdrbase/resources/webapi/doc/swagger/include/ChannelReport.yaml @@ -78,6 +78,8 @@ ChannelReport: EndOfTrainDemodReport: $ref: "/doc/swagger/include/EndOfTrainDemod.yaml#/EndOfTrainDemodReport" description: "End of train demod report data for Channel." + IEEE_802_15_4_DemodReport: + $ref: "/doc/swagger/include/IEEE_802_15_4_Demod.yaml#/IEEE_802_15_4_DemodReport" IEEE_802_15_4_ModReport: $ref: "/doc/swagger/include/IEEE_802_15_4_Mod.yaml#/IEEE_802_15_4_ModReport" description: "Ieee 802 15 4 mod report data for Channel." diff --git a/sdrbase/resources/webapi/doc/swagger/include/ChannelSettings.yaml b/sdrbase/resources/webapi/doc/swagger/include/ChannelSettings.yaml index 3de6d3cab..dfa26eaaf 100644 --- a/sdrbase/resources/webapi/doc/swagger/include/ChannelSettings.yaml +++ b/sdrbase/resources/webapi/doc/swagger/include/ChannelSettings.yaml @@ -129,6 +129,8 @@ ChannelSettings: InterferometerSettings: $ref: "/doc/swagger/include/Interferometer.yaml#/InterferometerSettings" description: "Interferometer settings configuration for Channel." + IEEE_802_15_4_DemodSettings: + $ref: "/doc/swagger/include/IEEE_802_15_4_Demod.yaml#/IEEE_802_15_4_DemodSettings" IEEE_802_15_4_ModSettings: $ref: "/doc/swagger/include/IEEE_802_15_4_Mod.yaml#/IEEE_802_15_4_ModSettings" description: "Ieee 802 15 4 mod settings configuration for Channel." diff --git a/sdrbase/resources/webapi/doc/swagger/include/IEEE_802_15_4_Demod.yaml b/sdrbase/resources/webapi/doc/swagger/include/IEEE_802_15_4_Demod.yaml new file mode 100644 index 000000000..f5e789ea2 --- /dev/null +++ b/sdrbase/resources/webapi/doc/swagger/include/IEEE_802_15_4_Demod.yaml @@ -0,0 +1,120 @@ +IEEE_802_15_4_DemodSettings: + description: IEEE_802_15_4_Demod + properties: + inputFrequencyOffset: + type: integer + format: int64 + description: "Frequency offset of the channel from the device center frequency in Hz." + phy: + type: string + description: > + PHY. One of: "20kbps BPSK", "40kbps BPSK", "100kbps <1GHz O-QPSK", + "250kbps <1GHz O-QPSK (Sine)", "250kbps <1GHz O-QPSK (RC)", "250kbps >2GHz O-QPSK" + rfBandwidth: + type: number + format: float + description: "RF bandwidth of the channel filter in Hz." + samplesPerChip: + type: integer + minimum: 2 + maximum: 16 + description: "Samples per chip. The channel sample rate is this multiplied by the chip rate." + maxFrequencyOffset: + type: number + format: float + description: "Maximum carrier frequency offset to search for during acquisition in Hz." + threshold: + type: number + format: float + minimum: 0 + maximum: 1 + description: "Preamble detection threshold." + showBadFCS: + type: integer + description: "Show frames with invalid FCS (1 for yes, 0 for no)." + filterFrameType: + type: integer + minimum: 0 + maximum: 5 + description: "Frame type filter for the GUI table: 0 - All, 1 - Beacon, 2 - Data, 3 - Ack, 4 - Command, 5 - Other." + filterPANID: + type: string + description: "Regular expression to filter frames by PAN ID in the GUI table." + filterAddress: + type: string + description: "Regular expression to filter frames by source or destination address in the GUI table." + udpEnabled: + type: integer + description: "Whether to forward received frames to specified UDP port (1 for yes, 0 for no)." + udpAddress: + type: string + description: "UDP address to forward received frames to." + udpPort: + type: integer + minimum: 1024 + maximum: 65535 + description: "UDP port to forward received frames to." + udpFormat: + type: integer + minimum: 0 + maximum: 1 + description: "Format of frames forwarded via UDP: 0 - ZEP (ZigBee Encapsulation Protocol v2), 1 - Raw MAC frame." + logFilename: + type: string + description: "Log filename. Use .pcap extension for PCAP format, otherwise CSV format is used." + logEnabled: + type: integer + description: "Whether to log received frames to a file (1 for yes, 0 for no)." + useFileTime: + type: integer + description: "Use date and time from file input device rather than the system clock (1 for yes, 0 for no)." + rgbColor: + type: integer + description: "Channel-marker colour as an ARGB integer." + title: + type: string + description: "Channel title shown in the GUI." + streamIndex: + description: MIMO channel. Not relevant when connected to SI (single Rx). + type: integer + useReverseAPI: + description: Synchronize with reverse API (1 for yes, 0 for no) + type: integer + reverseAPIAddress: + type: string + description: "Address of the reverse API peer." + reverseAPIPort: + type: integer + description: "Port of the reverse API peer." + reverseAPIDeviceIndex: + type: integer + description: "Device-set index used by the reverse API peer." + reverseAPIChannelIndex: + type: integer + description: "Channel index used by the reverse API peer." + scopeConfig: + $ref: "/doc/swagger/include/GLScope.yaml#/GLScope" + description: "Oscilloscope-display configuration." + channelMarker: + $ref: "/doc/swagger/include/ChannelMarker.yaml#/ChannelMarker" + description: "Channel-marker display settings." + rollupState: + $ref: "/doc/swagger/include/RollupState.yaml#/RollupState" + description: "Saved expanded or collapsed state of the GUI sections." + +IEEE_802_15_4_DemodReport: + description: IEEE_802_15_4_Demod + properties: + channelPowerDB: + description: power received in channel (dB) + type: number + format: float + channelSampleRate: + type: integer + description: "Effective sample rate delivered to the channel in samples per second." + framesOK: + type: integer + description: "Number of frames received with a valid FCS." + framesBadFCS: + type: integer + description: "Number of frames received with an invalid FCS." diff --git a/sdrbase/util/ieee_802_15_4.cpp b/sdrbase/util/ieee_802_15_4.cpp new file mode 100644 index 000000000..170c2aea8 --- /dev/null +++ b/sdrbase/util/ieee_802_15_4.cpp @@ -0,0 +1,717 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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 "util/crc.h" +#include "util/ieee_802_15_4.h" + +// Table 13-1 - Symbol-to-chip mapping for BPSK PHY (c0 first) +const uint8_t IEEE_802_15_4_PHY::m_chipsBPSK[2][15] = { + {1, 1, 1, 1, 0, 1, 0, 1, 1, 0, 0, 1, 0, 0, 0}, + {0, 0, 0, 0, 1, 0, 1, 0, 0, 1, 1, 0, 1, 1, 1} +}; + +// Table 12-2 - Symbol-to-chip mapping for the 780 MHz, 868 MHz and 915 MHz bands +const uint8_t IEEE_802_15_4_PHY::m_chipsSubGHzOQPSK[16][16] = { + {0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 1, 0, 0, 1, 0, 1}, + {0, 1, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 1, 0, 0, 1}, + {0, 1, 0, 1, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 1, 0}, + {1, 0, 0, 1, 0, 1, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0}, + {0, 0, 1, 0, 0, 1, 0, 1, 0, 0, 1, 1, 1, 1, 1, 0}, + {1, 0, 0, 0, 1, 0, 0, 1, 0, 1, 0, 0, 1, 1, 1, 1}, + {1, 1, 1, 0, 0, 0, 1, 0, 0, 1, 0, 1, 0, 0, 1, 1}, + {1, 1, 1, 1, 1, 0, 0, 0, 1, 0, 0, 1, 0, 1, 0, 0}, + {0, 1, 1, 0, 1, 0, 1, 1, 0, 1, 1, 1, 0, 0, 0, 0}, + {0, 0, 0, 1, 1, 0, 1, 0, 1, 1, 0, 1, 1, 1, 0, 0}, + {0, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 1, 0, 1, 1, 1}, + {1, 1, 0, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 1, 0, 1}, + {0, 1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 1}, + {1, 1, 0, 1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 0, 1, 0}, + {1, 0, 1, 1, 0, 1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 0}, + {1, 0, 1, 0, 1, 1, 0, 1, 1, 1, 0, 0, 0, 0, 0, 1}, +}; + +// Table 12-1 - Symbol-to-chip mapping for the 2450 MHz and 2380 MHz bands +const uint8_t IEEE_802_15_4_PHY::m_chips2450OQPSK[16][32] = { + {1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0}, + {1, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 1, 0}, + {0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 0, 0, 1, 0}, + {0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1}, + {0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1}, + {0, 0, 1, 1, 0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0}, + {1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1}, + {1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 0, 1}, + {1, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1}, + {1, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1}, + {0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1}, + {0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0}, + {0, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0}, + {0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1}, + {1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0}, + {1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0} +}; + +IEEE_802_15_4_PHY::IEEE_802_15_4_PHY() : + m_bitRate(250000), + m_modulation(OQPSK), + m_subGHzBand(false), + m_pulseShaping(SINE), + m_beta(1.0f), + m_symbolSpan(6) +{ +} + +bool IEEE_802_15_4_PHY::fromString(const QString& phy) +{ + bool valid; + + // First part of phy string should give bitrate in kbps + float bitRate = phy.split("k")[0].toFloat(&valid) * 1000.0f; + + if (!valid) { + return false; + } + + if (phy.contains("BPSK")) + { + m_bitRate = bitRate; + m_subGHzBand = true; + m_modulation = BPSK; + m_pulseShaping = RC; + m_beta = 1.0f; + m_symbolSpan = 6; + } + else if (phy.contains("O-QPSK")) + { + m_bitRate = bitRate; + m_subGHzBand = phy.contains("<1"); + m_modulation = OQPSK; + + if (phy.contains("RC")) + { + m_pulseShaping = RC; + m_beta = 0.8f; + m_symbolSpan = 6; + } + else + { + m_pulseShaping = SINE; + } + } + else + { + return false; + } + + return true; +} + +QStringList IEEE_802_15_4_PHY::getPHYNames() +{ + return { + "20kbps BPSK", + "40kbps BPSK", + "100kbps <1GHz O-QPSK", + "250kbps <1GHz O-QPSK (Sine)", + "250kbps <1GHz O-QPSK (RC)", + "250kbps >2GHz O-QPSK" + }; +} + +QString IEEE_802_15_4_PHY::toString() const +{ + if (m_modulation == BPSK) + { + if (m_bitRate == 20000) { + return "20kbps BPSK"; + } else if (m_bitRate == 40000) { + return "40kbps BPSK"; + } + } + else if (m_subGHzBand) + { + if (m_bitRate == 100000) { + return "100kbps <1GHz O-QPSK"; + } else if ((m_bitRate == 250000) && (m_pulseShaping == SINE)) { + return "250kbps <1GHz O-QPSK (Sine)"; + } else if (m_bitRate == 250000) { + return "250kbps <1GHz O-QPSK (RC)"; + } + } + else if (m_bitRate == 250000) + { + return "250kbps >2GHz O-QPSK"; + } + + return ""; +} + +int IEEE_802_15_4_PHY::getChipsPerSymbol() const +{ + if (m_modulation == BPSK) { + return 15; + } else { + return m_subGHzBand ? 16 : 32; + } +} + +int IEEE_802_15_4_PHY::getBitsPerSymbol() const +{ + return m_modulation == BPSK ? 1 : 4; +} + +int IEEE_802_15_4_PHY::getChipRate() const +{ + return m_bitRate * getChipsPerSymbol() / getBitsPerSymbol(); +} + +int IEEE_802_15_4_PHY::getOccupiedBandwidth() const +{ + int chipRate = getChipRate(); + + if (m_pulseShaping == SINE) { + return (int) (1.5 * chipRate); + } else { + return (int) ((1.0 + m_beta) * chipRate); + } +} + +int IEEE_802_15_4_PHY::getChip(int symbol, int chipIdx) const +{ + if (m_modulation == BPSK) { + return m_chipsBPSK[symbol & 1][chipIdx]; + } else if (m_subGHzBand) { + return m_chipsSubGHzOQPSK[symbol & 0xf][chipIdx]; + } else { + return m_chips2450OQPSK[symbol & 0xf][chipIdx]; + } +} + +std::vector IEEE_802_15_4_PHY::getPulse(int samplesPerChip) const +{ + std::vector pulse; + + if (m_pulseShaping == SINE) + { + // Half-sine over two chips: p(t) = sin(pi*t/(2*Tc)), 0 <= t <= 2*Tc + pulse.resize(2 * samplesPerChip); + + for (int i = 0; i < 2 * samplesPerChip; i++) { + pulse[i] = (float) std::sin(M_PI * i / (2.0 * samplesPerChip)); + } + } + else + { + // Raised cosine, centred on the chip time, as used by RaisedCosine + int nTaps = m_symbolSpan * samplesPerChip + 1; + + if (!(nTaps & 1)) { + nTaps++; + } + + pulse.resize(nTaps); + + for (int i = 0; i < nTaps; i++) + { + double t = (i - (nTaps / 2)) / (double) samplesPerChip; + double denominator = 1.0 - std::pow(2.0 * m_beta * t, 2.0); + + if (std::abs(denominator) > 1e-9) + { + double sinc = (t == 0.0) ? 1.0 : std::sin(M_PI * t) / (M_PI * t); + pulse[i] = (float) (sinc * std::cos(M_PI * m_beta * t) / denominator); + } + else + { + pulse[i] = (float) (m_beta * std::sin(M_PI / (2.0 * m_beta)) / 2.0); + } + } + } + + return pulse; +} + +int IEEE_802_15_4_PHY::getPulseStartOffset(int samplesPerChip) const +{ + if (m_pulseShaping == SINE) + { + return 0; + } + else + { + int nTaps = m_symbolSpan * samplesPerChip + 1; + + if (!(nTaps & 1)) { + nTaps++; + } + + return -(nTaps / 2); + } +} + +IEEE_802_15_4_FrameDecoder::IEEE_802_15_4_FrameDecoder() : + m_valid(false), + m_frameControl(0), + m_frameType(Beacon), + m_securityEnabled(false), + m_framePending(false), + m_ackRequest(false), + m_panIdCompression(false), + m_seqNoSuppression(false), + m_iePresent(false), + m_destAddressMode(AddressNone), + m_frameVersion(0), + m_srcAddressMode(AddressNone), + m_hasSeqNo(false), + m_seqNo(0), + m_hasDestPANID(false), + m_destPANID(0), + m_destAddress(0), + m_hasSrcPANID(false), + m_srcPANID(0), + m_srcAddress(0), + m_securityLevel(0), + m_keyIdMode(0), + m_auxSecurityHeaderLength(0), + m_commandId(-1), + m_hasFCS(false), + m_fcs(0) +{ +} + +uint16_t IEEE_802_15_4_FrameDecoder::calcFCS(const uint8_t *data, int length) +{ + crc16itut crc; + crc.calculate(data, length); + return crc.get(); +} + +bool IEEE_802_15_4_FrameDecoder::decode(const QByteArray& psdu, bool hasFCS) +{ + const uint8_t *p = (const uint8_t *) psdu.data(); + int length = psdu.size(); + + m_valid = false; + m_ies.clear(); + m_payload.clear(); + m_commandId = -1; + m_hasFCS = hasFCS && (length >= 2); + + if (m_hasFCS) + { + m_fcs = p[length - 2] | (p[length - 1] << 8); + length -= 2; + } + + if (length < 1) { + return false; + } + + int idx = 0; + m_frameControl = p[idx++]; + m_frameType = (FrameType) (m_frameControl & 0x7); + + // Fragment frames have no frame control, and multipurpose frames have a different + // format which we don't decode further + if ((m_frameType == Fragment) || (m_frameType == Multipurpose) || (m_frameType == Extended) || (m_frameType == Reserved)) + { + m_payload = QByteArray((const char *) &p[idx], length - idx); + m_valid = true; + return true; + } + + if (length < 2) { + return false; + } + + m_frameControl |= p[idx++] << 8; + m_securityEnabled = (m_frameControl >> 3) & 1; + m_framePending = (m_frameControl >> 4) & 1; + m_ackRequest = (m_frameControl >> 5) & 1; + m_panIdCompression = (m_frameControl >> 6) & 1; + m_seqNoSuppression = (m_frameControl >> 8) & 1; + m_iePresent = (m_frameControl >> 9) & 1; + m_destAddressMode = (AddressMode) ((m_frameControl >> 10) & 3); + m_frameVersion = (m_frameControl >> 12) & 3; + m_srcAddressMode = (AddressMode) ((m_frameControl >> 14) & 3); + + if ((m_destAddressMode == AddressReserved) || (m_srcAddressMode == AddressReserved)) { + return false; + } + + m_hasSeqNo = !m_seqNoSuppression; + + if (m_hasSeqNo) + { + if (idx >= length) { + return false; + } + m_seqNo = p[idx++]; + } + + // Determine which PAN IDs are present - 7.2.1.5 + bool destPresent = m_destAddressMode != AddressNone; + bool srcPresent = m_srcAddressMode != AddressNone; + + if (m_frameVersion < 2) + { + m_hasDestPANID = destPresent; + m_hasSrcPANID = srcPresent && !(destPresent && m_panIdCompression); + } + else + { + // Table 7-2 + if (!destPresent && !srcPresent) + { + m_hasDestPANID = m_panIdCompression; + m_hasSrcPANID = false; + } + else if (destPresent && !srcPresent) + { + m_hasDestPANID = !m_panIdCompression; + m_hasSrcPANID = false; + } + else if (!destPresent && srcPresent) + { + m_hasDestPANID = false; + m_hasSrcPANID = !m_panIdCompression; + } + else if ((m_destAddressMode == AddressExtended) && (m_srcAddressMode == AddressExtended)) + { + m_hasDestPANID = !m_panIdCompression; + m_hasSrcPANID = false; + } + else + { + m_hasDestPANID = true; + m_hasSrcPANID = !m_panIdCompression; + } + } + + auto readAddress = [&](AddressMode mode, uint64_t& address) -> bool { + int bytes = mode == AddressShort ? 2 : (mode == AddressExtended ? 8 : 0); + + if (idx + bytes > length) { + return false; + } + + address = 0; + + for (int i = 0; i < bytes; i++) { + address |= ((uint64_t) p[idx++]) << (8 * i); + } + + return true; + }; + + uint64_t panId; + + if (m_hasDestPANID) + { + if (!readAddress(AddressShort, panId)) { + return false; + } + m_destPANID = (uint16_t) panId; + } + if (!readAddress(m_destAddressMode, m_destAddress)) { + return false; + } + if (m_hasSrcPANID) + { + if (!readAddress(AddressShort, panId)) { + return false; + } + m_srcPANID = (uint16_t) panId; + } + if (!readAddress(m_srcAddressMode, m_srcAddress)) { + return false; + } + + // Auxiliary security header - 9.4 + m_auxSecurityHeaderLength = 0; + + if (m_securityEnabled) + { + if (idx >= length) { + return false; + } + + uint8_t securityControl = p[idx]; + m_securityLevel = securityControl & 0x7; + m_keyIdMode = (securityControl >> 3) & 0x3; + bool frameCounterSuppression = (m_frameVersion >= 2) && ((securityControl >> 5) & 1); + static const int keyIdLengths[4] = {0, 1, 5, 9}; + + m_auxSecurityHeaderLength = 1 + (frameCounterSuppression ? 0 : 4) + keyIdLengths[m_keyIdMode]; + + if (idx + m_auxSecurityHeaderLength > length) { + return false; + } + + idx += m_auxSecurityHeaderLength; + } + + // Information elements - 7.4 + if (m_iePresent) + { + bool payloadIEs = false; + + // Header IEs + while (idx + 2 <= length) + { + uint16_t descriptor = p[idx] | (p[idx + 1] << 8); + idx += 2; + IE ie; + ie.m_header = true; + ie.m_length = descriptor & 0x7f; + ie.m_id = (descriptor >> 7) & 0xff; + + if (idx + ie.m_length > length) { + return false; + } + + idx += ie.m_length; + + if (ie.m_id == 0x7e) // Header Termination 1 - Payload IEs follow + { + payloadIEs = true; + break; + } + else if (ie.m_id == 0x7f) // Header Termination 2 - Payload follows + { + break; + } + + m_ies.append(ie); + } + + // Payload IEs are encrypted if security is enabled + if (payloadIEs && !m_securityEnabled) + { + while (idx + 2 <= length) + { + uint16_t descriptor = p[idx] | (p[idx + 1] << 8); + idx += 2; + IE ie; + ie.m_header = false; + ie.m_length = descriptor & 0x7ff; + ie.m_id = (descriptor >> 11) & 0xf; + + if (idx + ie.m_length > length) { + return false; + } + + idx += ie.m_length; + + if (ie.m_id == 0xf) { // Payload termination + break; + } + + m_ies.append(ie); + } + } + } + + if ((m_frameType == Command) && !m_securityEnabled && (idx < length)) { + m_commandId = p[idx]; + } + + m_payload = QByteArray((const char *) &p[idx], length - idx); + m_valid = true; + + return true; +} + +QString IEEE_802_15_4_FrameDecoder::frameTypeToString(FrameType type) +{ + switch (type) + { + case Beacon: + return "Beacon"; + case Data: + return "Data"; + case Ack: + return "Ack"; + case Command: + return "Command"; + case Multipurpose: + return "Multipurpose"; + case Fragment: + return "Fragment"; + case Extended: + return "Extended"; + default: + return "Reserved"; + } +} + +QString IEEE_802_15_4_FrameDecoder::commandToString(int commandId) +{ + // Table 7-49 + switch (commandId) + { + case 0x01: + return "Association Request"; + case 0x02: + return "Association Response"; + case 0x03: + return "Disassociation Notification"; + case 0x04: + return "Data Request"; + case 0x05: + return "PAN ID Conflict Notification"; + case 0x06: + return "Orphan Notification"; + case 0x07: + return "Beacon Request"; + case 0x08: + return "Coordinator Realignment"; + case 0x09: + return "GTS Request"; + case 0x0a: + return "TRLE Management Request"; + case 0x0b: + return "TRLE Management Response"; + case 0x13: + return "DSME Association Request"; + case 0x14: + return "DSME Association Response"; + case 0x15: + return "DSME GTS Request"; + case 0x16: + return "DSME GTS Response"; + case 0x17: + return "DSME GTS Notify"; + case 0x18: + return "DSME Information Request"; + case 0x19: + return "DSME Information Response"; + case 0x1a: + return "DSME Beacon Allocation Notification"; + case 0x1b: + return "DSME Beacon Collision Notification"; + case 0x1c: + return "DSME Link Report"; + case 0x20: + return "RIT Data Request"; + case 0x21: + return "DBS Request"; + case 0x22: + return "DBS Response"; + case 0x23: + return "RIT Data Response"; + case 0x24: + return "Vendor Specific"; + case 0x25: + return "SRM Request"; + case 0x26: + return "SRM Response"; + case 0x27: + return "SRM Report"; + case 0x28: + return "SRM Information"; + default: + return QString("Command 0x%1").arg(commandId, 2, 16, QChar('0')); + } +} + +QString IEEE_802_15_4_FrameDecoder::addressToString(AddressMode mode, uint64_t address) +{ + if (mode == AddressShort) + { + return QString("0x%1").arg(address, 4, 16, QChar('0')); + } + else if (mode == AddressExtended) + { + // Display MSB first, as Wireshark does + QStringList bytes; + + for (int i = 7; i >= 0; i--) { + bytes.append(QString("%1").arg((address >> (8 * i)) & 0xff, 2, 16, QChar('0'))); + } + + return bytes.join(":"); + } + else + { + return ""; + } +} + +QString IEEE_802_15_4_FrameDecoder::getFrameTypeString() const +{ + return frameTypeToString(m_frameType); +} + +QString IEEE_802_15_4_FrameDecoder::getDestPANIDString() const +{ + return m_hasDestPANID ? QString("0x%1").arg(m_destPANID, 4, 16, QChar('0')) : ""; +} + +QString IEEE_802_15_4_FrameDecoder::getDestAddressString() const +{ + return addressToString(m_destAddressMode, m_destAddress); +} + +QString IEEE_802_15_4_FrameDecoder::getSrcPANIDString() const +{ + return m_hasSrcPANID ? QString("0x%1").arg(m_srcPANID, 4, 16, QChar('0')) : ""; +} + +QString IEEE_802_15_4_FrameDecoder::getSrcAddressString() const +{ + return addressToString(m_srcAddressMode, m_srcAddress); +} + +QString IEEE_802_15_4_FrameDecoder::getCommandString() const +{ + return m_commandId >= 0 ? commandToString(m_commandId) : ""; +} + +QString IEEE_802_15_4_FrameDecoder::toString() const +{ + QStringList parts; + + if (!m_valid) { + return "Invalid frame"; + } + + parts.append(getFrameTypeString()); + + if (m_commandId >= 0) { + parts.append(getCommandString()); + } + if (m_securityEnabled) { + parts.append(QString("Secured (level %1)").arg(m_securityLevel)); + } + if (m_ackRequest) { + parts.append("AR"); + } + if (m_framePending) { + parts.append("FP"); + } + if (m_frameVersion > 0) { + parts.append(QString("v%1").arg(m_frameVersion)); + } + for (const auto& ie : m_ies) { + parts.append(QString("%1 IE 0x%2").arg(ie.m_header ? "Header" : "Payload").arg(ie.m_id, 2, 16, QChar('0'))); + } + + return parts.join(", "); +} diff --git a/sdrbase/util/ieee_802_15_4.h b/sdrbase/util/ieee_802_15_4.h new file mode 100644 index 000000000..93cc57277 --- /dev/null +++ b/sdrbase/util/ieee_802_15_4.h @@ -0,0 +1,165 @@ +/////////////////////////////////////////////////////////////////////////////////// +// 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_UTIL_IEEE_802_15_4_H +#define INCLUDE_UTIL_IEEE_802_15_4_H + +#include +#include + +#include +#include +#include +#include + +#include "export.h" + +// IEEE 802.15.4-2015 O-QPSK (clause 12) and BPSK (clause 13) PHYs +struct SDRBASE_API IEEE_802_15_4_PHY +{ + enum Modulation { + BPSK, + OQPSK + }; + + enum PulseShaping { + RC, + SINE + }; + + int m_bitRate; + Modulation m_modulation; + bool m_subGHzBand; + PulseShaping m_pulseShaping; + float m_beta; //!< Roll-off for RC pulse shaping + int m_symbolSpan; //!< Span of RC pulse in chips + + IEEE_802_15_4_PHY(); + + //! Set PHY from a string as returned by getPHYNames() + bool fromString(const QString& phy); + //! Full PHY name, as in getPHYNames(), or empty if not a standard PHY + QString toString() const; + //! Names of the supported PHYs, as used in the GUI + static QStringList getPHYNames(); + + int getChipsPerSymbol() const; + int getBitsPerSymbol() const; + int getNumberOfSymbols() const { return 1 << getBitsPerSymbol(); } + int getChipRate() const; + int getSymbolRate() const { return m_bitRate / getBitsPerSymbol(); } + //! Number of symbols in the preamble (4 octets of zeros) + int getPreambleSymbols() const { return 32 / getBitsPerSymbol(); } + //! Approximate occupied bandwidth (99%) + int getOccupiedBandwidth() const; + + //! Chip (0 or 1) for chip index chipIdx of the given symbol (data symbol for O-QPSK, differentially encoded bit for BPSK) + int getChip(int symbol, int chipIdx) const; + + //! Pulse shape used for a single chip, sampled at samplesPerChip. + //! Half-sine pulses span two chips and start at the chip time. RC pulses are centred on the chip time. + std::vector getPulse(int samplesPerChip) const; + //! Offset in samples from the chip time to the start of the pulse returned by getPulse() + int getPulseStartOffset(int samplesPerChip) const; + + static const uint8_t m_chipsBPSK[2][15]; + static const uint8_t m_chipsSubGHzOQPSK[16][16]; + static const uint8_t m_chips2450OQPSK[16][32]; +}; + +// Decode of a MAC frame (clause 7) +struct SDRBASE_API IEEE_802_15_4_FrameDecoder +{ + enum FrameType { + Beacon = 0, + Data = 1, + Ack = 2, + Command = 3, + Reserved = 4, + Multipurpose = 5, + Fragment = 6, + Extended = 7 + }; + + enum AddressMode { + AddressNone = 0, + AddressReserved = 1, + AddressShort = 2, + AddressExtended = 3 + }; + + struct IE { + bool m_header; //!< Header IE (true) or payload IE (false) + int m_id; //!< Element ID for header IEs, Group ID for payload IEs + int m_length; + }; + + bool m_valid; //!< Frame could be parsed + uint16_t m_frameControl; + FrameType m_frameType; + bool m_securityEnabled; + bool m_framePending; + bool m_ackRequest; + bool m_panIdCompression; + bool m_seqNoSuppression; + bool m_iePresent; + AddressMode m_destAddressMode; + int m_frameVersion; + AddressMode m_srcAddressMode; + + bool m_hasSeqNo; + uint8_t m_seqNo; + bool m_hasDestPANID; + uint16_t m_destPANID; + uint64_t m_destAddress; + bool m_hasSrcPANID; + uint16_t m_srcPANID; + uint64_t m_srcAddress; + + int m_securityLevel; + int m_keyIdMode; + int m_auxSecurityHeaderLength; + + QList m_ies; + int m_commandId; //!< -1 if not a command frame or encrypted + QByteArray m_payload; //!< MAC payload (excluding header, IEs and FCS) + bool m_hasFCS; + uint16_t m_fcs; + + IEEE_802_15_4_FrameDecoder(); + + //! Decode a PSDU (MPDU). If hasFCS is true, the last two bytes are the FCS + bool decode(const QByteArray& psdu, bool hasFCS = true); + + QString getFrameTypeString() const; + QString getDestPANIDString() const; + QString getDestAddressString() const; + QString getSrcPANIDString() const; + QString getSrcAddressString() const; + QString getCommandString() const; + //! Short human readable summary of the frame contents + QString toString() const; + + static QString frameTypeToString(FrameType type); + static QString commandToString(int commandId); + static QString addressToString(AddressMode mode, uint64_t address); + //! Calculate the 16-bit FCS (ITU-T CRC) of data + static uint16_t calcFCS(const uint8_t *data, int length); +}; + +#endif // INCLUDE_UTIL_IEEE_802_15_4_H diff --git a/sdrbase/webapi/webapirequestmapper.cpp b/sdrbase/webapi/webapirequestmapper.cpp index 55cb03394..758754315 100644 --- a/sdrbase/webapi/webapirequestmapper.cpp +++ b/sdrbase/webapi/webapirequestmapper.cpp @@ -5062,6 +5062,12 @@ bool WebAPIRequestMapper::getChannelSettings( channelSettings->getHeatMapSettings()->init(); channelSettings->getHeatMapSettings()->fromJsonObject(settingsJsonObject); } + else if (channelSettingsKey == "IEEE_802_15_4_DemodSettings") + { + channelSettings->setIeee802154DemodSettings(new SWGSDRangel::SWGIEEE_802_15_4_DemodSettings()); + channelSettings->getIeee802154DemodSettings()->init(); + channelSettings->getIeee802154DemodSettings()->fromJsonObject(settingsJsonObject); + } else if (channelSettingsKey == "IEEE_802_15_4_ModSettings") { channelSettings->setIeee802154ModSettings(new SWGSDRangel::SWGIEEE_802_15_4_ModSettings()); diff --git a/sdrbase/webapi/webapiutils.cpp b/sdrbase/webapi/webapiutils.cpp index c97922306..0681004b4 100644 --- a/sdrbase/webapi/webapiutils.cpp +++ b/sdrbase/webapi/webapiutils.cpp @@ -78,6 +78,7 @@ const QMap WebAPIUtils::m_channelURIToSettingsKey = { {"sdrangel.channeltx.modpacket", "PacketModSettings"}, {"sdrangel.channel.psk31mod", "PSK31ModSettings"}, {"sdrangel.channel.psk31demod", "PSK31DemodSettings"}, + {"sdrangel.channelrx.demod802.15.4", "IEEE_802_15_4_DemodSettings"}, {"sdrangel.channeltx.mod802.15.4", "IEEE_802_15_4_ModSettings"}, {"sdrangel.channel.radioclock", "RadioClockSettings"}, {"sdrangel.channel.radiosondedemod", "RadiosondeDemodSettings"}, @@ -198,6 +199,7 @@ const QMap WebAPIUtils::m_channelTypeToSettingsKey = { {"FreqScanner", "FreqScannerSettings"}, {"FreqTracker", "FreqTrackerSettings"}, {"HeatMap", "HeatMapSettings"}, + {"IEEE_802_15_4_Demod", "IEEE_802_15_4_DemodSettings"}, {"IEEE_802_15_4_Mod", "IEEE_802_15_4_ModSettings"}, {"M17Demod", "M17DemodSettings"}, {"M17Mod", "M17ModSettings"}, diff --git a/swagger/sdrangel/api/swagger/include/ChannelReport.yaml b/swagger/sdrangel/api/swagger/include/ChannelReport.yaml index 767ce72b7..9063bada9 100644 --- a/swagger/sdrangel/api/swagger/include/ChannelReport.yaml +++ b/swagger/sdrangel/api/swagger/include/ChannelReport.yaml @@ -78,6 +78,8 @@ ChannelReport: EndOfTrainDemodReport: $ref: "http://swgserver:8081/api/swagger/include/EndOfTrainDemod.yaml#/EndOfTrainDemodReport" description: "End of train demod report data for Channel." + IEEE_802_15_4_DemodReport: + $ref: "http://swgserver:8081/api/swagger/include/IEEE_802_15_4_Demod.yaml#/IEEE_802_15_4_DemodReport" IEEE_802_15_4_ModReport: $ref: "http://swgserver:8081/api/swagger/include/IEEE_802_15_4_Mod.yaml#/IEEE_802_15_4_ModReport" description: "Ieee 802 15 4 mod report data for Channel." diff --git a/swagger/sdrangel/api/swagger/include/ChannelSettings.yaml b/swagger/sdrangel/api/swagger/include/ChannelSettings.yaml index 0e680625e..866f2b598 100644 --- a/swagger/sdrangel/api/swagger/include/ChannelSettings.yaml +++ b/swagger/sdrangel/api/swagger/include/ChannelSettings.yaml @@ -129,6 +129,8 @@ ChannelSettings: InterferometerSettings: $ref: "http://swgserver:8081/api/swagger/include/Interferometer.yaml#/InterferometerSettings" description: "Interferometer settings configuration for Channel." + IEEE_802_15_4_DemodSettings: + $ref: "http://swgserver:8081/api/swagger/include/IEEE_802_15_4_Demod.yaml#/IEEE_802_15_4_DemodSettings" IEEE_802_15_4_ModSettings: $ref: "http://swgserver:8081/api/swagger/include/IEEE_802_15_4_Mod.yaml#/IEEE_802_15_4_ModSettings" description: "Ieee 802 15 4 mod settings configuration for Channel." diff --git a/swagger/sdrangel/api/swagger/include/IEEE_802_15_4_Demod.yaml b/swagger/sdrangel/api/swagger/include/IEEE_802_15_4_Demod.yaml new file mode 100644 index 000000000..514c40821 --- /dev/null +++ b/swagger/sdrangel/api/swagger/include/IEEE_802_15_4_Demod.yaml @@ -0,0 +1,120 @@ +IEEE_802_15_4_DemodSettings: + description: IEEE_802_15_4_Demod + properties: + inputFrequencyOffset: + type: integer + format: int64 + description: "Frequency offset of the channel from the device center frequency in Hz." + phy: + type: string + description: > + PHY. One of: "20kbps BPSK", "40kbps BPSK", "100kbps <1GHz O-QPSK", + "250kbps <1GHz O-QPSK (Sine)", "250kbps <1GHz O-QPSK (RC)", "250kbps >2GHz O-QPSK" + rfBandwidth: + type: number + format: float + description: "RF bandwidth of the channel filter in Hz." + samplesPerChip: + type: integer + minimum: 2 + maximum: 16 + description: "Samples per chip. The channel sample rate is this multiplied by the chip rate." + maxFrequencyOffset: + type: number + format: float + description: "Maximum carrier frequency offset to search for during acquisition in Hz." + threshold: + type: number + format: float + minimum: 0 + maximum: 1 + description: "Preamble detection threshold." + showBadFCS: + type: integer + description: "Show frames with invalid FCS (1 for yes, 0 for no)." + filterFrameType: + type: integer + minimum: 0 + maximum: 5 + description: "Frame type filter for the GUI table: 0 - All, 1 - Beacon, 2 - Data, 3 - Ack, 4 - Command, 5 - Other." + filterPANID: + type: string + description: "Regular expression to filter frames by PAN ID in the GUI table." + filterAddress: + type: string + description: "Regular expression to filter frames by source or destination address in the GUI table." + udpEnabled: + type: integer + description: "Whether to forward received frames to specified UDP port (1 for yes, 0 for no)." + udpAddress: + type: string + description: "UDP address to forward received frames to." + udpPort: + type: integer + minimum: 1024 + maximum: 65535 + description: "UDP port to forward received frames to." + udpFormat: + type: integer + minimum: 0 + maximum: 1 + description: "Format of frames forwarded via UDP: 0 - ZEP (ZigBee Encapsulation Protocol v2), 1 - Raw MAC frame." + logFilename: + type: string + description: "Log filename. Use .pcap extension for PCAP format, otherwise CSV format is used." + logEnabled: + type: integer + description: "Whether to log received frames to a file (1 for yes, 0 for no)." + useFileTime: + type: integer + description: "Use date and time from file input device rather than the system clock (1 for yes, 0 for no)." + rgbColor: + type: integer + description: "Channel-marker colour as an ARGB integer." + title: + type: string + description: "Channel title shown in the GUI." + streamIndex: + description: MIMO channel. Not relevant when connected to SI (single Rx). + type: integer + useReverseAPI: + description: Synchronize with reverse API (1 for yes, 0 for no) + type: integer + reverseAPIAddress: + type: string + description: "Address of the reverse API peer." + reverseAPIPort: + type: integer + description: "Port of the reverse API peer." + reverseAPIDeviceIndex: + type: integer + description: "Device-set index used by the reverse API peer." + reverseAPIChannelIndex: + type: integer + description: "Channel index used by the reverse API peer." + scopeConfig: + $ref: "http://swgserver:8081/api/swagger/include/GLScope.yaml#/GLScope" + description: "Oscilloscope-display configuration." + channelMarker: + $ref: "http://swgserver:8081/api/swagger/include/ChannelMarker.yaml#/ChannelMarker" + description: "Channel-marker display settings." + rollupState: + $ref: "http://swgserver:8081/api/swagger/include/RollupState.yaml#/RollupState" + description: "Saved expanded or collapsed state of the GUI sections." + +IEEE_802_15_4_DemodReport: + description: IEEE_802_15_4_Demod + properties: + channelPowerDB: + description: power received in channel (dB) + type: number + format: float + channelSampleRate: + type: integer + description: "Effective sample rate delivered to the channel in samples per second." + framesOK: + type: integer + description: "Number of frames received with a valid FCS." + framesBadFCS: + type: integer + description: "Number of frames received with an invalid FCS." diff --git a/swagger/sdrangel/code/qt5/client/SWGChannelReport.cpp b/swagger/sdrangel/code/qt5/client/SWGChannelReport.cpp index 28293b794..640ee8db9 100644 --- a/swagger/sdrangel/code/qt5/client/SWGChannelReport.cpp +++ b/swagger/sdrangel/code/qt5/client/SWGChannelReport.cpp @@ -80,6 +80,8 @@ SWGChannelReport::SWGChannelReport() { m_end_of_train_demod_report_isSet = false; ieee_802_15_4_mod_report = nullptr; m_ieee_802_15_4_mod_report_isSet = false; + ieee_802_15_4_demod_report = nullptr; + m_ieee_802_15_4_demod_report_isSet = false; file_sink_report = nullptr; m_file_sink_report_isSet = false; file_source_report = nullptr; @@ -220,6 +222,8 @@ SWGChannelReport::init() { m_end_of_train_demod_report_isSet = false; ieee_802_15_4_mod_report = new SWGIEEE_802_15_4_ModReport(); m_ieee_802_15_4_mod_report_isSet = false; + ieee_802_15_4_demod_report = new SWGIEEE_802_15_4_DemodReport(); + m_ieee_802_15_4_demod_report_isSet = false; file_sink_report = new SWGFileSinkReport(); m_file_sink_report_isSet = false; file_source_report = new SWGFileSourceReport(); @@ -380,6 +384,9 @@ SWGChannelReport::cleanup() { if(ieee_802_15_4_mod_report != nullptr) { delete ieee_802_15_4_mod_report; } + if(ieee_802_15_4_demod_report != nullptr) { + delete ieee_802_15_4_demod_report; + } if(file_sink_report != nullptr) { delete file_sink_report; } @@ -562,6 +569,8 @@ SWGChannelReport::fromJsonObject(QJsonObject &pJson) { ::SWGSDRangel::setValue(&ieee_802_15_4_mod_report, pJson["IEEE_802_15_4_ModReport"], "SWGIEEE_802_15_4_ModReport", "SWGIEEE_802_15_4_ModReport"); + ::SWGSDRangel::setValue(&ieee_802_15_4_demod_report, pJson["IEEE_802_15_4_DemodReport"], "SWGIEEE_802_15_4_DemodReport", "SWGIEEE_802_15_4_DemodReport"); + ::SWGSDRangel::setValue(&file_sink_report, pJson["FileSinkReport"], "SWGFileSinkReport", "SWGFileSinkReport"); ::SWGSDRangel::setValue(&file_source_report, pJson["FileSourceReport"], "SWGFileSourceReport", "SWGFileSourceReport"); @@ -735,6 +744,9 @@ SWGChannelReport::asJsonObject() { if((ieee_802_15_4_mod_report != nullptr) && (ieee_802_15_4_mod_report->isSet())){ toJsonValue(QString("IEEE_802_15_4_ModReport"), ieee_802_15_4_mod_report, obj, QString("SWGIEEE_802_15_4_ModReport")); } + if((ieee_802_15_4_demod_report != nullptr) && (ieee_802_15_4_demod_report->isSet())){ + toJsonValue(QString("IEEE_802_15_4_DemodReport"), ieee_802_15_4_demod_report, obj, QString("SWGIEEE_802_15_4_DemodReport")); + } if((file_sink_report != nullptr) && (file_sink_report->isSet())){ toJsonValue(QString("FileSinkReport"), file_sink_report, obj, QString("SWGFileSinkReport")); } @@ -1122,6 +1134,16 @@ SWGChannelReport::setIeee802154ModReport(SWGIEEE_802_15_4_ModReport* ieee_802_15 this->m_ieee_802_15_4_mod_report_isSet = true; } +SWGIEEE_802_15_4_DemodReport* +SWGChannelReport::getIeee802154DemodReport() { + return ieee_802_15_4_demod_report; +} +void +SWGChannelReport::setIeee802154DemodReport(SWGIEEE_802_15_4_DemodReport* ieee_802_15_4_demod_report) { + this->ieee_802_15_4_demod_report = ieee_802_15_4_demod_report; + this->m_ieee_802_15_4_demod_report_isSet = true; +} + SWGFileSinkReport* SWGChannelReport::getFileSinkReport() { return file_sink_report; @@ -1605,6 +1627,9 @@ SWGChannelReport::isSet(){ if(ieee_802_15_4_mod_report && ieee_802_15_4_mod_report->isSet()){ isObjectUpdated = true; break; } + if(ieee_802_15_4_demod_report && ieee_802_15_4_demod_report->isSet()){ + isObjectUpdated = true; break; + } if(file_sink_report && file_sink_report->isSet()){ isObjectUpdated = true; break; } diff --git a/swagger/sdrangel/code/qt5/client/SWGChannelReport.h b/swagger/sdrangel/code/qt5/client/SWGChannelReport.h index 5eef83a9d..27ec8f7fd 100644 --- a/swagger/sdrangel/code/qt5/client/SWGChannelReport.h +++ b/swagger/sdrangel/code/qt5/client/SWGChannelReport.h @@ -54,6 +54,7 @@ #include "SWGFreqTrackerReport.h" #include "SWGHeatMapReport.h" #include "SWGIEEE_802_15_4_ModReport.h" +#include "SWGIEEE_802_15_4_DemodReport.h" #include "SWGILSDemodReport.h" #include "SWGInmarsatDemodReport.h" #include "SWGM17DemodReport.h" @@ -183,6 +184,9 @@ public: SWGIEEE_802_15_4_ModReport* getIeee802154ModReport(); void setIeee802154ModReport(SWGIEEE_802_15_4_ModReport* ieee_802_15_4_mod_report); + SWGIEEE_802_15_4_DemodReport* getIeee802154DemodReport(); + void setIeee802154DemodReport(SWGIEEE_802_15_4_DemodReport* ieee_802_15_4_demod_report); + SWGFileSinkReport* getFileSinkReport(); void setFileSinkReport(SWGFileSinkReport* file_sink_report); @@ -384,6 +388,9 @@ private: SWGIEEE_802_15_4_ModReport* ieee_802_15_4_mod_report; bool m_ieee_802_15_4_mod_report_isSet; + SWGIEEE_802_15_4_DemodReport* ieee_802_15_4_demod_report; + bool m_ieee_802_15_4_demod_report_isSet; + SWGFileSinkReport* file_sink_report; bool m_file_sink_report_isSet; diff --git a/swagger/sdrangel/code/qt5/client/SWGChannelSettings.cpp b/swagger/sdrangel/code/qt5/client/SWGChannelSettings.cpp index a0ca06854..f9191efb6 100644 --- a/swagger/sdrangel/code/qt5/client/SWGChannelSettings.cpp +++ b/swagger/sdrangel/code/qt5/client/SWGChannelSettings.cpp @@ -114,6 +114,8 @@ SWGChannelSettings::SWGChannelSettings() { m_interferometer_settings_isSet = false; ieee_802_15_4_mod_settings = nullptr; m_ieee_802_15_4_mod_settings_isSet = false; + ieee_802_15_4_demod_settings = nullptr; + m_ieee_802_15_4_demod_settings_isSet = false; m17_demod_settings = nullptr; m_m17_demod_settings_isSet = false; m17_mod_settings = nullptr; @@ -276,6 +278,8 @@ SWGChannelSettings::init() { m_interferometer_settings_isSet = false; ieee_802_15_4_mod_settings = new SWGIEEE_802_15_4_ModSettings(); m_ieee_802_15_4_mod_settings_isSet = false; + ieee_802_15_4_demod_settings = new SWGIEEE_802_15_4_DemodSettings(); + m_ieee_802_15_4_demod_settings_isSet = false; m17_demod_settings = new SWGM17DemodSettings(); m_m17_demod_settings_isSet = false; m17_mod_settings = new SWGM17ModSettings(); @@ -471,6 +475,9 @@ SWGChannelSettings::cleanup() { if(ieee_802_15_4_mod_settings != nullptr) { delete ieee_802_15_4_mod_settings; } + if(ieee_802_15_4_demod_settings != nullptr) { + delete ieee_802_15_4_demod_settings; + } if(m17_demod_settings != nullptr) { delete m17_demod_settings; } @@ -669,6 +676,8 @@ SWGChannelSettings::fromJsonObject(QJsonObject &pJson) { ::SWGSDRangel::setValue(&ieee_802_15_4_mod_settings, pJson["IEEE_802_15_4_ModSettings"], "SWGIEEE_802_15_4_ModSettings", "SWGIEEE_802_15_4_ModSettings"); + ::SWGSDRangel::setValue(&ieee_802_15_4_demod_settings, pJson["IEEE_802_15_4_DemodSettings"], "SWGIEEE_802_15_4_DemodSettings", "SWGIEEE_802_15_4_DemodSettings"); + ::SWGSDRangel::setValue(&m17_demod_settings, pJson["M17DemodSettings"], "SWGM17DemodSettings", "SWGM17DemodSettings"); ::SWGSDRangel::setValue(&m17_mod_settings, pJson["M17ModSettings"], "SWGM17ModSettings", "SWGM17ModSettings"); @@ -881,6 +890,9 @@ SWGChannelSettings::asJsonObject() { if((ieee_802_15_4_mod_settings != nullptr) && (ieee_802_15_4_mod_settings->isSet())){ toJsonValue(QString("IEEE_802_15_4_ModSettings"), ieee_802_15_4_mod_settings, obj, QString("SWGIEEE_802_15_4_ModSettings")); } + if((ieee_802_15_4_demod_settings != nullptr) && (ieee_802_15_4_demod_settings->isSet())){ + toJsonValue(QString("IEEE_802_15_4_DemodSettings"), ieee_802_15_4_demod_settings, obj, QString("SWGIEEE_802_15_4_DemodSettings")); + } if((m17_demod_settings != nullptr) && (m17_demod_settings->isSet())){ toJsonValue(QString("M17DemodSettings"), m17_demod_settings, obj, QString("SWGM17DemodSettings")); } @@ -1420,6 +1432,16 @@ SWGChannelSettings::setIeee802154ModSettings(SWGIEEE_802_15_4_ModSettings* ieee_ this->m_ieee_802_15_4_mod_settings_isSet = true; } +SWGIEEE_802_15_4_DemodSettings* +SWGChannelSettings::getIeee802154DemodSettings() { + return ieee_802_15_4_demod_settings; +} +void +SWGChannelSettings::setIeee802154DemodSettings(SWGIEEE_802_15_4_DemodSettings* ieee_802_15_4_demod_settings) { + this->ieee_802_15_4_demod_settings = ieee_802_15_4_demod_settings; + this->m_ieee_802_15_4_demod_settings_isSet = true; +} + SWGM17DemodSettings* SWGChannelSettings::getM17DemodSettings() { return m17_demod_settings; @@ -1894,6 +1916,9 @@ SWGChannelSettings::isSet(){ if(ieee_802_15_4_mod_settings && ieee_802_15_4_mod_settings->isSet()){ isObjectUpdated = true; break; } + if(ieee_802_15_4_demod_settings && ieee_802_15_4_demod_settings->isSet()){ + isObjectUpdated = true; break; + } if(m17_demod_settings && m17_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 46c6d57c2..7da2e65fa 100644 --- a/swagger/sdrangel/code/qt5/client/SWGChannelSettings.h +++ b/swagger/sdrangel/code/qt5/client/SWGChannelSettings.h @@ -58,6 +58,7 @@ #include "SWGFreqTrackerSettings.h" #include "SWGHeatMapSettings.h" #include "SWGIEEE_802_15_4_ModSettings.h" +#include "SWGIEEE_802_15_4_DemodSettings.h" #include "SWGILSDemodSettings.h" #include "SWGInmarsatDemodSettings.h" #include "SWGInterferometerSettings.h" @@ -243,6 +244,9 @@ public: SWGIEEE_802_15_4_ModSettings* getIeee802154ModSettings(); void setIeee802154ModSettings(SWGIEEE_802_15_4_ModSettings* ieee_802_15_4_mod_settings); + SWGIEEE_802_15_4_DemodSettings* getIeee802154DemodSettings(); + void setIeee802154DemodSettings(SWGIEEE_802_15_4_DemodSettings* ieee_802_15_4_demod_settings); + SWGM17DemodSettings* getM17DemodSettings(); void setM17DemodSettings(SWGM17DemodSettings* m17_demod_settings); @@ -477,6 +481,9 @@ private: SWGIEEE_802_15_4_ModSettings* ieee_802_15_4_mod_settings; bool m_ieee_802_15_4_mod_settings_isSet; + SWGIEEE_802_15_4_DemodSettings* ieee_802_15_4_demod_settings; + bool m_ieee_802_15_4_demod_settings_isSet; + SWGM17DemodSettings* m17_demod_settings; bool m_m17_demod_settings_isSet; diff --git a/swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodReport.cpp b/swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodReport.cpp new file mode 100644 index 000000000..63b0d6005 --- /dev/null +++ b/swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodReport.cpp @@ -0,0 +1,178 @@ +/** + * SDRangel + * This is the web REST/JSON API of SDRangel SDR software. SDRangel is an Open Source Qt5/OpenGL 3.0+ (4.3+ in Windows) GUI and server Software Defined Radio and signal analyzer in software. It supports Airspy, BladeRF, HackRF, LimeSDR, PlutoSDR, RTL-SDR, SDRplay RSP1 and FunCube --- Limitations and specifcities: * In SDRangel GUI the first Rx device set cannot be deleted. Conversely the server starts with no device sets and its number of device sets can be reduced to zero by as many calls as necessary to /sdrangel/deviceset with DELETE method. * Preset import and export from/to file is a server only feature. * Device set focus is a GUI only feature. * The following channels are not implemented (status 501 is returned): ATV and DATV demodulators, Channel Analyzer NG, LoRa demodulator * The device settings and report structures contains only the sub-structure corresponding to the device type. The DeviceSettings and DeviceReport structures documented here shows all of them but only one will be or should be present at a time * The channel settings and report structures contains only the sub-structure corresponding to the channel type. The ChannelSettings and ChannelReport structures documented here shows all of them but only one will be or should be present at a time --- + * + * OpenAPI spec version: 7.0.0 + * Contact: f4exb06@gmail.com + * + * NOTE: This class is auto generated by the swagger code generator program. + * https://github.com/swagger-api/swagger-codegen.git + * Do not edit the class manually. + */ + + + +#include "SWGIEEE_802_15_4_DemodReport.h" + +#include "SWGHelpers.h" + +#include +#include +#include +#include + +namespace SWGSDRangel { + +SWGIEEE_802_15_4_DemodReport::SWGIEEE_802_15_4_DemodReport(QString* json) { + init(); + this->fromJson(*json); +} + +SWGIEEE_802_15_4_DemodReport::SWGIEEE_802_15_4_DemodReport() { + channel_power_db = 0.0f; + m_channel_power_db_isSet = false; + channel_sample_rate = 0; + m_channel_sample_rate_isSet = false; + frames_ok = 0; + m_frames_ok_isSet = false; + frames_bad_fcs = 0; + m_frames_bad_fcs_isSet = false; +} + +SWGIEEE_802_15_4_DemodReport::~SWGIEEE_802_15_4_DemodReport() { + this->cleanup(); +} + +void +SWGIEEE_802_15_4_DemodReport::init() { + channel_power_db = 0.0f; + m_channel_power_db_isSet = false; + channel_sample_rate = 0; + m_channel_sample_rate_isSet = false; + frames_ok = 0; + m_frames_ok_isSet = false; + frames_bad_fcs = 0; + m_frames_bad_fcs_isSet = false; +} + +void +SWGIEEE_802_15_4_DemodReport::cleanup() { + + + + +} + +SWGIEEE_802_15_4_DemodReport* +SWGIEEE_802_15_4_DemodReport::fromJson(QString &json) { + QByteArray array (json.toStdString().c_str()); + QJsonDocument doc = QJsonDocument::fromJson(array); + QJsonObject jsonObject = doc.object(); + this->fromJsonObject(jsonObject); + return this; +} + +void +SWGIEEE_802_15_4_DemodReport::fromJsonObject(QJsonObject &pJson) { + ::SWGSDRangel::setValue(&channel_power_db, pJson["channelPowerDB"], "float", ""); + + ::SWGSDRangel::setValue(&channel_sample_rate, pJson["channelSampleRate"], "qint32", ""); + + ::SWGSDRangel::setValue(&frames_ok, pJson["framesOK"], "qint32", ""); + + ::SWGSDRangel::setValue(&frames_bad_fcs, pJson["framesBadFCS"], "qint32", ""); + +} + +QString +SWGIEEE_802_15_4_DemodReport::asJson () +{ + QJsonObject* obj = this->asJsonObject(); + + QJsonDocument doc(*obj); + QByteArray bytes = doc.toJson(); + delete obj; + return QString(bytes); +} + +QJsonObject* +SWGIEEE_802_15_4_DemodReport::asJsonObject() { + QJsonObject* obj = new QJsonObject(); + if(m_channel_power_db_isSet){ + obj->insert("channelPowerDB", QJsonValue(channel_power_db)); + } + if(m_channel_sample_rate_isSet){ + obj->insert("channelSampleRate", QJsonValue(channel_sample_rate)); + } + if(m_frames_ok_isSet){ + obj->insert("framesOK", QJsonValue(frames_ok)); + } + if(m_frames_bad_fcs_isSet){ + obj->insert("framesBadFCS", QJsonValue(frames_bad_fcs)); + } + + return obj; +} + +float +SWGIEEE_802_15_4_DemodReport::getChannelPowerDb() { + return channel_power_db; +} +void +SWGIEEE_802_15_4_DemodReport::setChannelPowerDb(float channel_power_db) { + this->channel_power_db = channel_power_db; + this->m_channel_power_db_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodReport::getChannelSampleRate() { + return channel_sample_rate; +} +void +SWGIEEE_802_15_4_DemodReport::setChannelSampleRate(qint32 channel_sample_rate) { + this->channel_sample_rate = channel_sample_rate; + this->m_channel_sample_rate_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodReport::getFramesOk() { + return frames_ok; +} +void +SWGIEEE_802_15_4_DemodReport::setFramesOk(qint32 frames_ok) { + this->frames_ok = frames_ok; + this->m_frames_ok_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodReport::getFramesBadFcs() { + return frames_bad_fcs; +} +void +SWGIEEE_802_15_4_DemodReport::setFramesBadFcs(qint32 frames_bad_fcs) { + this->frames_bad_fcs = frames_bad_fcs; + this->m_frames_bad_fcs_isSet = true; +} + + +bool +SWGIEEE_802_15_4_DemodReport::isSet(){ + bool isObjectUpdated = false; + do{ + if(m_channel_power_db_isSet){ + isObjectUpdated = true; break; + } + if(m_channel_sample_rate_isSet){ + isObjectUpdated = true; break; + } + if(m_frames_ok_isSet){ + isObjectUpdated = true; break; + } + if(m_frames_bad_fcs_isSet){ + isObjectUpdated = true; break; + } + }while(false); + return isObjectUpdated; +} +} + diff --git a/swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodReport.h b/swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodReport.h new file mode 100644 index 000000000..0ef2b702f --- /dev/null +++ b/swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodReport.h @@ -0,0 +1,77 @@ +/** + * SDRangel + * This is the web REST/JSON API of SDRangel SDR software. SDRangel is an Open Source Qt5/OpenGL 3.0+ (4.3+ in Windows) GUI and server Software Defined Radio and signal analyzer in software. It supports Airspy, BladeRF, HackRF, LimeSDR, PlutoSDR, RTL-SDR, SDRplay RSP1 and FunCube --- Limitations and specifcities: * In SDRangel GUI the first Rx device set cannot be deleted. Conversely the server starts with no device sets and its number of device sets can be reduced to zero by as many calls as necessary to /sdrangel/deviceset with DELETE method. * Preset import and export from/to file is a server only feature. * Device set focus is a GUI only feature. * The following channels are not implemented (status 501 is returned): ATV and DATV demodulators, Channel Analyzer NG, LoRa demodulator * The device settings and report structures contains only the sub-structure corresponding to the device type. The DeviceSettings and DeviceReport structures documented here shows all of them but only one will be or should be present at a time * The channel settings and report structures contains only the sub-structure corresponding to the channel type. The ChannelSettings and ChannelReport structures documented here shows all of them but only one will be or should be present at a time --- + * + * OpenAPI spec version: 7.0.0 + * Contact: f4exb06@gmail.com + * + * NOTE: This class is auto generated by the swagger code generator program. + * https://github.com/swagger-api/swagger-codegen.git + * Do not edit the class manually. + */ + + +/* + * SWGIEEE_802_15_4_DemodReport.h + * + * IEEE_802_15_4_Demod + */ + +#ifndef SWGIEEE_802_15_4_DemodReport_H_ +#define SWGIEEE_802_15_4_DemodReport_H_ + +#include + + + +#include "SWGObject.h" +#include "export.h" + +namespace SWGSDRangel { + +class SWG_API SWGIEEE_802_15_4_DemodReport: public SWGObject { +public: + SWGIEEE_802_15_4_DemodReport(); + SWGIEEE_802_15_4_DemodReport(QString* json); + virtual ~SWGIEEE_802_15_4_DemodReport(); + void init(); + void cleanup(); + + virtual QString asJson () override; + virtual QJsonObject* asJsonObject() override; + virtual void fromJsonObject(QJsonObject &json) override; + virtual SWGIEEE_802_15_4_DemodReport* fromJson(QString &jsonString) override; + + float getChannelPowerDb(); + void setChannelPowerDb(float channel_power_db); + + qint32 getChannelSampleRate(); + void setChannelSampleRate(qint32 channel_sample_rate); + + qint32 getFramesOk(); + void setFramesOk(qint32 frames_ok); + + qint32 getFramesBadFcs(); + void setFramesBadFcs(qint32 frames_bad_fcs); + + + virtual bool isSet() override; + +private: + float channel_power_db; + bool m_channel_power_db_isSet; + + qint32 channel_sample_rate; + bool m_channel_sample_rate_isSet; + + qint32 frames_ok; + bool m_frames_ok_isSet; + + qint32 frames_bad_fcs; + bool m_frames_bad_fcs_isSet; + +}; + +} + +#endif /* SWGIEEE_802_15_4_DemodReport_H_ */ diff --git a/swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodSettings.cpp b/swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodSettings.cpp new file mode 100644 index 000000000..8d967a977 --- /dev/null +++ b/swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodSettings.cpp @@ -0,0 +1,750 @@ +/** + * SDRangel + * This is the web REST/JSON API of SDRangel SDR software. SDRangel is an Open Source Qt5/OpenGL 3.0+ (4.3+ in Windows) GUI and server Software Defined Radio and signal analyzer in software. It supports Airspy, BladeRF, HackRF, LimeSDR, PlutoSDR, RTL-SDR, SDRplay RSP1 and FunCube --- Limitations and specifcities: * In SDRangel GUI the first Rx device set cannot be deleted. Conversely the server starts with no device sets and its number of device sets can be reduced to zero by as many calls as necessary to /sdrangel/deviceset with DELETE method. * Preset import and export from/to file is a server only feature. * Device set focus is a GUI only feature. * The following channels are not implemented (status 501 is returned): ATV and DATV demodulators, Channel Analyzer NG, LoRa demodulator * The device settings and report structures contains only the sub-structure corresponding to the device type. The DeviceSettings and DeviceReport structures documented here shows all of them but only one will be or should be present at a time * The channel settings and report structures contains only the sub-structure corresponding to the channel type. The ChannelSettings and ChannelReport structures documented here shows all of them but only one will be or should be present at a time --- + * + * OpenAPI spec version: 7.0.0 + * Contact: f4exb06@gmail.com + * + * NOTE: This class is auto generated by the swagger code generator program. + * https://github.com/swagger-api/swagger-codegen.git + * Do not edit the class manually. + */ + + + +#include "SWGIEEE_802_15_4_DemodSettings.h" + +#include "SWGHelpers.h" + +#include +#include +#include +#include + +namespace SWGSDRangel { + +SWGIEEE_802_15_4_DemodSettings::SWGIEEE_802_15_4_DemodSettings(QString* json) { + init(); + this->fromJson(*json); +} + +SWGIEEE_802_15_4_DemodSettings::SWGIEEE_802_15_4_DemodSettings() { + input_frequency_offset = 0L; + m_input_frequency_offset_isSet = false; + phy = nullptr; + m_phy_isSet = false; + rf_bandwidth = 0.0f; + m_rf_bandwidth_isSet = false; + samples_per_chip = 0; + m_samples_per_chip_isSet = false; + max_frequency_offset = 0.0f; + m_max_frequency_offset_isSet = false; + threshold = 0.0f; + m_threshold_isSet = false; + show_bad_fcs = 0; + m_show_bad_fcs_isSet = false; + filter_frame_type = 0; + m_filter_frame_type_isSet = false; + filter_panid = nullptr; + m_filter_panid_isSet = false; + filter_address = nullptr; + m_filter_address_isSet = false; + udp_enabled = 0; + m_udp_enabled_isSet = false; + udp_address = nullptr; + m_udp_address_isSet = false; + udp_port = 0; + m_udp_port_isSet = false; + udp_format = 0; + m_udp_format_isSet = false; + log_filename = nullptr; + m_log_filename_isSet = false; + log_enabled = 0; + m_log_enabled_isSet = false; + use_file_time = 0; + m_use_file_time_isSet = false; + rgb_color = 0; + m_rgb_color_isSet = false; + title = nullptr; + m_title_isSet = false; + stream_index = 0; + m_stream_index_isSet = false; + use_reverse_api = 0; + m_use_reverse_api_isSet = false; + reverse_api_address = nullptr; + m_reverse_api_address_isSet = false; + reverse_api_port = 0; + m_reverse_api_port_isSet = false; + reverse_api_device_index = 0; + m_reverse_api_device_index_isSet = false; + reverse_api_channel_index = 0; + m_reverse_api_channel_index_isSet = false; + scope_config = nullptr; + m_scope_config_isSet = false; + channel_marker = nullptr; + m_channel_marker_isSet = false; + rollup_state = nullptr; + m_rollup_state_isSet = false; +} + +SWGIEEE_802_15_4_DemodSettings::~SWGIEEE_802_15_4_DemodSettings() { + this->cleanup(); +} + +void +SWGIEEE_802_15_4_DemodSettings::init() { + input_frequency_offset = 0L; + m_input_frequency_offset_isSet = false; + phy = new QString(""); + m_phy_isSet = false; + rf_bandwidth = 0.0f; + m_rf_bandwidth_isSet = false; + samples_per_chip = 0; + m_samples_per_chip_isSet = false; + max_frequency_offset = 0.0f; + m_max_frequency_offset_isSet = false; + threshold = 0.0f; + m_threshold_isSet = false; + show_bad_fcs = 0; + m_show_bad_fcs_isSet = false; + filter_frame_type = 0; + m_filter_frame_type_isSet = false; + filter_panid = new QString(""); + m_filter_panid_isSet = false; + filter_address = new QString(""); + m_filter_address_isSet = false; + udp_enabled = 0; + m_udp_enabled_isSet = false; + udp_address = new QString(""); + m_udp_address_isSet = false; + udp_port = 0; + m_udp_port_isSet = false; + udp_format = 0; + m_udp_format_isSet = false; + log_filename = new QString(""); + m_log_filename_isSet = false; + log_enabled = 0; + m_log_enabled_isSet = false; + use_file_time = 0; + m_use_file_time_isSet = false; + rgb_color = 0; + m_rgb_color_isSet = false; + title = new QString(""); + m_title_isSet = false; + stream_index = 0; + m_stream_index_isSet = false; + use_reverse_api = 0; + m_use_reverse_api_isSet = false; + reverse_api_address = new QString(""); + m_reverse_api_address_isSet = false; + reverse_api_port = 0; + m_reverse_api_port_isSet = false; + reverse_api_device_index = 0; + m_reverse_api_device_index_isSet = false; + reverse_api_channel_index = 0; + m_reverse_api_channel_index_isSet = false; + scope_config = new SWGGLScope(); + m_scope_config_isSet = false; + channel_marker = new SWGChannelMarker(); + m_channel_marker_isSet = false; + rollup_state = new SWGRollupState(); + m_rollup_state_isSet = false; +} + +void +SWGIEEE_802_15_4_DemodSettings::cleanup() { + + if(phy != nullptr) { + delete phy; + } + + + + + + + if(filter_panid != nullptr) { + delete filter_panid; + } + if(filter_address != nullptr) { + delete filter_address; + } + + if(udp_address != nullptr) { + delete udp_address; + } + + + if(log_filename != nullptr) { + delete log_filename; + } + + + + if(title != nullptr) { + delete title; + } + + + if(reverse_api_address != nullptr) { + delete reverse_api_address; + } + + + + if(scope_config != nullptr) { + delete scope_config; + } + if(channel_marker != nullptr) { + delete channel_marker; + } + if(rollup_state != nullptr) { + delete rollup_state; + } +} + +SWGIEEE_802_15_4_DemodSettings* +SWGIEEE_802_15_4_DemodSettings::fromJson(QString &json) { + QByteArray array (json.toStdString().c_str()); + QJsonDocument doc = QJsonDocument::fromJson(array); + QJsonObject jsonObject = doc.object(); + this->fromJsonObject(jsonObject); + return this; +} + +void +SWGIEEE_802_15_4_DemodSettings::fromJsonObject(QJsonObject &pJson) { + ::SWGSDRangel::setValue(&input_frequency_offset, pJson["inputFrequencyOffset"], "qint64", ""); + + ::SWGSDRangel::setValue(&phy, pJson["phy"], "QString", "QString"); + + ::SWGSDRangel::setValue(&rf_bandwidth, pJson["rfBandwidth"], "float", ""); + + ::SWGSDRangel::setValue(&samples_per_chip, pJson["samplesPerChip"], "qint32", ""); + + ::SWGSDRangel::setValue(&max_frequency_offset, pJson["maxFrequencyOffset"], "float", ""); + + ::SWGSDRangel::setValue(&threshold, pJson["threshold"], "float", ""); + + ::SWGSDRangel::setValue(&show_bad_fcs, pJson["showBadFCS"], "qint32", ""); + + ::SWGSDRangel::setValue(&filter_frame_type, pJson["filterFrameType"], "qint32", ""); + + ::SWGSDRangel::setValue(&filter_panid, pJson["filterPANID"], "QString", "QString"); + + ::SWGSDRangel::setValue(&filter_address, pJson["filterAddress"], "QString", "QString"); + + ::SWGSDRangel::setValue(&udp_enabled, pJson["udpEnabled"], "qint32", ""); + + ::SWGSDRangel::setValue(&udp_address, pJson["udpAddress"], "QString", "QString"); + + ::SWGSDRangel::setValue(&udp_port, pJson["udpPort"], "qint32", ""); + + ::SWGSDRangel::setValue(&udp_format, pJson["udpFormat"], "qint32", ""); + + ::SWGSDRangel::setValue(&log_filename, pJson["logFilename"], "QString", "QString"); + + ::SWGSDRangel::setValue(&log_enabled, pJson["logEnabled"], "qint32", ""); + + ::SWGSDRangel::setValue(&use_file_time, pJson["useFileTime"], "qint32", ""); + + ::SWGSDRangel::setValue(&rgb_color, pJson["rgbColor"], "qint32", ""); + + ::SWGSDRangel::setValue(&title, pJson["title"], "QString", "QString"); + + ::SWGSDRangel::setValue(&stream_index, pJson["streamIndex"], "qint32", ""); + + ::SWGSDRangel::setValue(&use_reverse_api, pJson["useReverseAPI"], "qint32", ""); + + ::SWGSDRangel::setValue(&reverse_api_address, pJson["reverseAPIAddress"], "QString", "QString"); + + ::SWGSDRangel::setValue(&reverse_api_port, pJson["reverseAPIPort"], "qint32", ""); + + ::SWGSDRangel::setValue(&reverse_api_device_index, pJson["reverseAPIDeviceIndex"], "qint32", ""); + + ::SWGSDRangel::setValue(&reverse_api_channel_index, pJson["reverseAPIChannelIndex"], "qint32", ""); + + ::SWGSDRangel::setValue(&scope_config, pJson["scopeConfig"], "SWGGLScope", "SWGGLScope"); + + ::SWGSDRangel::setValue(&channel_marker, pJson["channelMarker"], "SWGChannelMarker", "SWGChannelMarker"); + + ::SWGSDRangel::setValue(&rollup_state, pJson["rollupState"], "SWGRollupState", "SWGRollupState"); + +} + +QString +SWGIEEE_802_15_4_DemodSettings::asJson () +{ + QJsonObject* obj = this->asJsonObject(); + + QJsonDocument doc(*obj); + QByteArray bytes = doc.toJson(); + delete obj; + return QString(bytes); +} + +QJsonObject* +SWGIEEE_802_15_4_DemodSettings::asJsonObject() { + QJsonObject* obj = new QJsonObject(); + if(m_input_frequency_offset_isSet){ + obj->insert("inputFrequencyOffset", QJsonValue(input_frequency_offset)); + } + if(phy != nullptr && *phy != QString("")){ + toJsonValue(QString("phy"), phy, obj, QString("QString")); + } + if(m_rf_bandwidth_isSet){ + obj->insert("rfBandwidth", QJsonValue(rf_bandwidth)); + } + if(m_samples_per_chip_isSet){ + obj->insert("samplesPerChip", QJsonValue(samples_per_chip)); + } + if(m_max_frequency_offset_isSet){ + obj->insert("maxFrequencyOffset", QJsonValue(max_frequency_offset)); + } + if(m_threshold_isSet){ + obj->insert("threshold", QJsonValue(threshold)); + } + if(m_show_bad_fcs_isSet){ + obj->insert("showBadFCS", QJsonValue(show_bad_fcs)); + } + if(m_filter_frame_type_isSet){ + obj->insert("filterFrameType", QJsonValue(filter_frame_type)); + } + if(filter_panid != nullptr && *filter_panid != QString("")){ + toJsonValue(QString("filterPANID"), filter_panid, obj, QString("QString")); + } + if(filter_address != nullptr && *filter_address != QString("")){ + toJsonValue(QString("filterAddress"), filter_address, obj, QString("QString")); + } + if(m_udp_enabled_isSet){ + obj->insert("udpEnabled", QJsonValue(udp_enabled)); + } + if(udp_address != nullptr && *udp_address != QString("")){ + toJsonValue(QString("udpAddress"), udp_address, obj, QString("QString")); + } + if(m_udp_port_isSet){ + obj->insert("udpPort", QJsonValue(udp_port)); + } + if(m_udp_format_isSet){ + obj->insert("udpFormat", QJsonValue(udp_format)); + } + if(log_filename != nullptr && *log_filename != QString("")){ + toJsonValue(QString("logFilename"), log_filename, obj, QString("QString")); + } + if(m_log_enabled_isSet){ + obj->insert("logEnabled", QJsonValue(log_enabled)); + } + if(m_use_file_time_isSet){ + obj->insert("useFileTime", QJsonValue(use_file_time)); + } + if(m_rgb_color_isSet){ + obj->insert("rgbColor", QJsonValue(rgb_color)); + } + if(title != nullptr && *title != QString("")){ + toJsonValue(QString("title"), title, obj, QString("QString")); + } + if(m_stream_index_isSet){ + obj->insert("streamIndex", QJsonValue(stream_index)); + } + if(m_use_reverse_api_isSet){ + obj->insert("useReverseAPI", QJsonValue(use_reverse_api)); + } + if(reverse_api_address != nullptr && *reverse_api_address != QString("")){ + toJsonValue(QString("reverseAPIAddress"), reverse_api_address, obj, QString("QString")); + } + if(m_reverse_api_port_isSet){ + obj->insert("reverseAPIPort", QJsonValue(reverse_api_port)); + } + if(m_reverse_api_device_index_isSet){ + obj->insert("reverseAPIDeviceIndex", QJsonValue(reverse_api_device_index)); + } + if(m_reverse_api_channel_index_isSet){ + obj->insert("reverseAPIChannelIndex", QJsonValue(reverse_api_channel_index)); + } + if((scope_config != nullptr) && (scope_config->isSet())){ + toJsonValue(QString("scopeConfig"), scope_config, obj, QString("SWGGLScope")); + } + if((channel_marker != nullptr) && (channel_marker->isSet())){ + toJsonValue(QString("channelMarker"), channel_marker, obj, QString("SWGChannelMarker")); + } + if((rollup_state != nullptr) && (rollup_state->isSet())){ + toJsonValue(QString("rollupState"), rollup_state, obj, QString("SWGRollupState")); + } + + return obj; +} + +qint64 +SWGIEEE_802_15_4_DemodSettings::getInputFrequencyOffset() { + return input_frequency_offset; +} +void +SWGIEEE_802_15_4_DemodSettings::setInputFrequencyOffset(qint64 input_frequency_offset) { + this->input_frequency_offset = input_frequency_offset; + this->m_input_frequency_offset_isSet = true; +} + +QString* +SWGIEEE_802_15_4_DemodSettings::getPhy() { + return phy; +} +void +SWGIEEE_802_15_4_DemodSettings::setPhy(QString* phy) { + this->phy = phy; + this->m_phy_isSet = true; +} + +float +SWGIEEE_802_15_4_DemodSettings::getRfBandwidth() { + return rf_bandwidth; +} +void +SWGIEEE_802_15_4_DemodSettings::setRfBandwidth(float rf_bandwidth) { + this->rf_bandwidth = rf_bandwidth; + this->m_rf_bandwidth_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getSamplesPerChip() { + return samples_per_chip; +} +void +SWGIEEE_802_15_4_DemodSettings::setSamplesPerChip(qint32 samples_per_chip) { + this->samples_per_chip = samples_per_chip; + this->m_samples_per_chip_isSet = true; +} + +float +SWGIEEE_802_15_4_DemodSettings::getMaxFrequencyOffset() { + return max_frequency_offset; +} +void +SWGIEEE_802_15_4_DemodSettings::setMaxFrequencyOffset(float max_frequency_offset) { + this->max_frequency_offset = max_frequency_offset; + this->m_max_frequency_offset_isSet = true; +} + +float +SWGIEEE_802_15_4_DemodSettings::getThreshold() { + return threshold; +} +void +SWGIEEE_802_15_4_DemodSettings::setThreshold(float threshold) { + this->threshold = threshold; + this->m_threshold_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getShowBadFcs() { + return show_bad_fcs; +} +void +SWGIEEE_802_15_4_DemodSettings::setShowBadFcs(qint32 show_bad_fcs) { + this->show_bad_fcs = show_bad_fcs; + this->m_show_bad_fcs_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getFilterFrameType() { + return filter_frame_type; +} +void +SWGIEEE_802_15_4_DemodSettings::setFilterFrameType(qint32 filter_frame_type) { + this->filter_frame_type = filter_frame_type; + this->m_filter_frame_type_isSet = true; +} + +QString* +SWGIEEE_802_15_4_DemodSettings::getFilterPanid() { + return filter_panid; +} +void +SWGIEEE_802_15_4_DemodSettings::setFilterPanid(QString* filter_panid) { + this->filter_panid = filter_panid; + this->m_filter_panid_isSet = true; +} + +QString* +SWGIEEE_802_15_4_DemodSettings::getFilterAddress() { + return filter_address; +} +void +SWGIEEE_802_15_4_DemodSettings::setFilterAddress(QString* filter_address) { + this->filter_address = filter_address; + this->m_filter_address_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getUdpEnabled() { + return udp_enabled; +} +void +SWGIEEE_802_15_4_DemodSettings::setUdpEnabled(qint32 udp_enabled) { + this->udp_enabled = udp_enabled; + this->m_udp_enabled_isSet = true; +} + +QString* +SWGIEEE_802_15_4_DemodSettings::getUdpAddress() { + return udp_address; +} +void +SWGIEEE_802_15_4_DemodSettings::setUdpAddress(QString* udp_address) { + this->udp_address = udp_address; + this->m_udp_address_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getUdpPort() { + return udp_port; +} +void +SWGIEEE_802_15_4_DemodSettings::setUdpPort(qint32 udp_port) { + this->udp_port = udp_port; + this->m_udp_port_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getUdpFormat() { + return udp_format; +} +void +SWGIEEE_802_15_4_DemodSettings::setUdpFormat(qint32 udp_format) { + this->udp_format = udp_format; + this->m_udp_format_isSet = true; +} + +QString* +SWGIEEE_802_15_4_DemodSettings::getLogFilename() { + return log_filename; +} +void +SWGIEEE_802_15_4_DemodSettings::setLogFilename(QString* log_filename) { + this->log_filename = log_filename; + this->m_log_filename_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getLogEnabled() { + return log_enabled; +} +void +SWGIEEE_802_15_4_DemodSettings::setLogEnabled(qint32 log_enabled) { + this->log_enabled = log_enabled; + this->m_log_enabled_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getUseFileTime() { + return use_file_time; +} +void +SWGIEEE_802_15_4_DemodSettings::setUseFileTime(qint32 use_file_time) { + this->use_file_time = use_file_time; + this->m_use_file_time_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getRgbColor() { + return rgb_color; +} +void +SWGIEEE_802_15_4_DemodSettings::setRgbColor(qint32 rgb_color) { + this->rgb_color = rgb_color; + this->m_rgb_color_isSet = true; +} + +QString* +SWGIEEE_802_15_4_DemodSettings::getTitle() { + return title; +} +void +SWGIEEE_802_15_4_DemodSettings::setTitle(QString* title) { + this->title = title; + this->m_title_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getStreamIndex() { + return stream_index; +} +void +SWGIEEE_802_15_4_DemodSettings::setStreamIndex(qint32 stream_index) { + this->stream_index = stream_index; + this->m_stream_index_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getUseReverseApi() { + return use_reverse_api; +} +void +SWGIEEE_802_15_4_DemodSettings::setUseReverseApi(qint32 use_reverse_api) { + this->use_reverse_api = use_reverse_api; + this->m_use_reverse_api_isSet = true; +} + +QString* +SWGIEEE_802_15_4_DemodSettings::getReverseApiAddress() { + return reverse_api_address; +} +void +SWGIEEE_802_15_4_DemodSettings::setReverseApiAddress(QString* reverse_api_address) { + this->reverse_api_address = reverse_api_address; + this->m_reverse_api_address_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getReverseApiPort() { + return reverse_api_port; +} +void +SWGIEEE_802_15_4_DemodSettings::setReverseApiPort(qint32 reverse_api_port) { + this->reverse_api_port = reverse_api_port; + this->m_reverse_api_port_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getReverseApiDeviceIndex() { + return reverse_api_device_index; +} +void +SWGIEEE_802_15_4_DemodSettings::setReverseApiDeviceIndex(qint32 reverse_api_device_index) { + this->reverse_api_device_index = reverse_api_device_index; + this->m_reverse_api_device_index_isSet = true; +} + +qint32 +SWGIEEE_802_15_4_DemodSettings::getReverseApiChannelIndex() { + return reverse_api_channel_index; +} +void +SWGIEEE_802_15_4_DemodSettings::setReverseApiChannelIndex(qint32 reverse_api_channel_index) { + this->reverse_api_channel_index = reverse_api_channel_index; + this->m_reverse_api_channel_index_isSet = true; +} + +SWGGLScope* +SWGIEEE_802_15_4_DemodSettings::getScopeConfig() { + return scope_config; +} +void +SWGIEEE_802_15_4_DemodSettings::setScopeConfig(SWGGLScope* scope_config) { + this->scope_config = scope_config; + this->m_scope_config_isSet = true; +} + +SWGChannelMarker* +SWGIEEE_802_15_4_DemodSettings::getChannelMarker() { + return channel_marker; +} +void +SWGIEEE_802_15_4_DemodSettings::setChannelMarker(SWGChannelMarker* channel_marker) { + this->channel_marker = channel_marker; + this->m_channel_marker_isSet = true; +} + +SWGRollupState* +SWGIEEE_802_15_4_DemodSettings::getRollupState() { + return rollup_state; +} +void +SWGIEEE_802_15_4_DemodSettings::setRollupState(SWGRollupState* rollup_state) { + this->rollup_state = rollup_state; + this->m_rollup_state_isSet = true; +} + + +bool +SWGIEEE_802_15_4_DemodSettings::isSet(){ + bool isObjectUpdated = false; + do{ + if(m_input_frequency_offset_isSet){ + isObjectUpdated = true; break; + } + if(phy && *phy != QString("")){ + isObjectUpdated = true; break; + } + if(m_rf_bandwidth_isSet){ + isObjectUpdated = true; break; + } + if(m_samples_per_chip_isSet){ + isObjectUpdated = true; break; + } + if(m_max_frequency_offset_isSet){ + isObjectUpdated = true; break; + } + if(m_threshold_isSet){ + isObjectUpdated = true; break; + } + if(m_show_bad_fcs_isSet){ + isObjectUpdated = true; break; + } + if(m_filter_frame_type_isSet){ + isObjectUpdated = true; break; + } + if(filter_panid && *filter_panid != QString("")){ + isObjectUpdated = true; break; + } + if(filter_address && *filter_address != QString("")){ + isObjectUpdated = true; break; + } + if(m_udp_enabled_isSet){ + isObjectUpdated = true; break; + } + if(udp_address && *udp_address != QString("")){ + isObjectUpdated = true; break; + } + if(m_udp_port_isSet){ + isObjectUpdated = true; break; + } + if(m_udp_format_isSet){ + isObjectUpdated = true; break; + } + if(log_filename && *log_filename != QString("")){ + isObjectUpdated = true; break; + } + if(m_log_enabled_isSet){ + isObjectUpdated = true; break; + } + if(m_use_file_time_isSet){ + isObjectUpdated = true; break; + } + if(m_rgb_color_isSet){ + isObjectUpdated = true; break; + } + if(title && *title != QString("")){ + isObjectUpdated = true; break; + } + if(m_stream_index_isSet){ + isObjectUpdated = true; break; + } + if(m_use_reverse_api_isSet){ + isObjectUpdated = true; break; + } + if(reverse_api_address && *reverse_api_address != QString("")){ + isObjectUpdated = true; break; + } + if(m_reverse_api_port_isSet){ + isObjectUpdated = true; break; + } + if(m_reverse_api_device_index_isSet){ + isObjectUpdated = true; break; + } + if(m_reverse_api_channel_index_isSet){ + isObjectUpdated = true; break; + } + if(scope_config && scope_config->isSet()){ + isObjectUpdated = true; break; + } + if(channel_marker && channel_marker->isSet()){ + isObjectUpdated = true; break; + } + if(rollup_state && rollup_state->isSet()){ + isObjectUpdated = true; break; + } + }while(false); + return isObjectUpdated; +} +} + diff --git a/swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodSettings.h b/swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodSettings.h new file mode 100644 index 000000000..f0a4d5565 --- /dev/null +++ b/swagger/sdrangel/code/qt5/client/SWGIEEE_802_15_4_DemodSettings.h @@ -0,0 +1,225 @@ +/** + * SDRangel + * This is the web REST/JSON API of SDRangel SDR software. SDRangel is an Open Source Qt5/OpenGL 3.0+ (4.3+ in Windows) GUI and server Software Defined Radio and signal analyzer in software. It supports Airspy, BladeRF, HackRF, LimeSDR, PlutoSDR, RTL-SDR, SDRplay RSP1 and FunCube --- Limitations and specifcities: * In SDRangel GUI the first Rx device set cannot be deleted. Conversely the server starts with no device sets and its number of device sets can be reduced to zero by as many calls as necessary to /sdrangel/deviceset with DELETE method. * Preset import and export from/to file is a server only feature. * Device set focus is a GUI only feature. * The following channels are not implemented (status 501 is returned): ATV and DATV demodulators, Channel Analyzer NG, LoRa demodulator * The device settings and report structures contains only the sub-structure corresponding to the device type. The DeviceSettings and DeviceReport structures documented here shows all of them but only one will be or should be present at a time * The channel settings and report structures contains only the sub-structure corresponding to the channel type. The ChannelSettings and ChannelReport structures documented here shows all of them but only one will be or should be present at a time --- + * + * OpenAPI spec version: 7.0.0 + * Contact: f4exb06@gmail.com + * + * NOTE: This class is auto generated by the swagger code generator program. + * https://github.com/swagger-api/swagger-codegen.git + * Do not edit the class manually. + */ + + +/* + * SWGIEEE_802_15_4_DemodSettings.h + * + * IEEE_802_15_4_Demod + */ + +#ifndef SWGIEEE_802_15_4_DemodSettings_H_ +#define SWGIEEE_802_15_4_DemodSettings_H_ + +#include + + +#include "SWGChannelMarker.h" +#include "SWGGLScope.h" +#include "SWGRollupState.h" +#include + +#include "SWGObject.h" +#include "export.h" + +namespace SWGSDRangel { + +class SWG_API SWGIEEE_802_15_4_DemodSettings: public SWGObject { +public: + SWGIEEE_802_15_4_DemodSettings(); + SWGIEEE_802_15_4_DemodSettings(QString* json); + virtual ~SWGIEEE_802_15_4_DemodSettings(); + void init(); + void cleanup(); + + virtual QString asJson () override; + virtual QJsonObject* asJsonObject() override; + virtual void fromJsonObject(QJsonObject &json) override; + virtual SWGIEEE_802_15_4_DemodSettings* fromJson(QString &jsonString) override; + + qint64 getInputFrequencyOffset(); + void setInputFrequencyOffset(qint64 input_frequency_offset); + + QString* getPhy(); + void setPhy(QString* phy); + + float getRfBandwidth(); + void setRfBandwidth(float rf_bandwidth); + + qint32 getSamplesPerChip(); + void setSamplesPerChip(qint32 samples_per_chip); + + float getMaxFrequencyOffset(); + void setMaxFrequencyOffset(float max_frequency_offset); + + float getThreshold(); + void setThreshold(float threshold); + + qint32 getShowBadFcs(); + void setShowBadFcs(qint32 show_bad_fcs); + + qint32 getFilterFrameType(); + void setFilterFrameType(qint32 filter_frame_type); + + QString* getFilterPanid(); + void setFilterPanid(QString* filter_panid); + + QString* getFilterAddress(); + void setFilterAddress(QString* filter_address); + + qint32 getUdpEnabled(); + void setUdpEnabled(qint32 udp_enabled); + + QString* getUdpAddress(); + void setUdpAddress(QString* udp_address); + + qint32 getUdpPort(); + void setUdpPort(qint32 udp_port); + + qint32 getUdpFormat(); + void setUdpFormat(qint32 udp_format); + + QString* getLogFilename(); + void setLogFilename(QString* log_filename); + + qint32 getLogEnabled(); + void setLogEnabled(qint32 log_enabled); + + qint32 getUseFileTime(); + void setUseFileTime(qint32 use_file_time); + + qint32 getRgbColor(); + void setRgbColor(qint32 rgb_color); + + QString* getTitle(); + void setTitle(QString* title); + + qint32 getStreamIndex(); + void setStreamIndex(qint32 stream_index); + + qint32 getUseReverseApi(); + void setUseReverseApi(qint32 use_reverse_api); + + QString* getReverseApiAddress(); + void setReverseApiAddress(QString* reverse_api_address); + + qint32 getReverseApiPort(); + void setReverseApiPort(qint32 reverse_api_port); + + qint32 getReverseApiDeviceIndex(); + void setReverseApiDeviceIndex(qint32 reverse_api_device_index); + + qint32 getReverseApiChannelIndex(); + void setReverseApiChannelIndex(qint32 reverse_api_channel_index); + + SWGGLScope* getScopeConfig(); + void setScopeConfig(SWGGLScope* scope_config); + + SWGChannelMarker* getChannelMarker(); + void setChannelMarker(SWGChannelMarker* channel_marker); + + SWGRollupState* getRollupState(); + void setRollupState(SWGRollupState* rollup_state); + + + virtual bool isSet() override; + +private: + qint64 input_frequency_offset; + bool m_input_frequency_offset_isSet; + + QString* phy; + bool m_phy_isSet; + + float rf_bandwidth; + bool m_rf_bandwidth_isSet; + + qint32 samples_per_chip; + bool m_samples_per_chip_isSet; + + float max_frequency_offset; + bool m_max_frequency_offset_isSet; + + float threshold; + bool m_threshold_isSet; + + qint32 show_bad_fcs; + bool m_show_bad_fcs_isSet; + + qint32 filter_frame_type; + bool m_filter_frame_type_isSet; + + QString* filter_panid; + bool m_filter_panid_isSet; + + QString* filter_address; + bool m_filter_address_isSet; + + qint32 udp_enabled; + bool m_udp_enabled_isSet; + + QString* udp_address; + bool m_udp_address_isSet; + + qint32 udp_port; + bool m_udp_port_isSet; + + qint32 udp_format; + bool m_udp_format_isSet; + + QString* log_filename; + bool m_log_filename_isSet; + + qint32 log_enabled; + bool m_log_enabled_isSet; + + qint32 use_file_time; + bool m_use_file_time_isSet; + + qint32 rgb_color; + bool m_rgb_color_isSet; + + QString* title; + bool m_title_isSet; + + qint32 stream_index; + bool m_stream_index_isSet; + + qint32 use_reverse_api; + bool m_use_reverse_api_isSet; + + QString* reverse_api_address; + bool m_reverse_api_address_isSet; + + qint32 reverse_api_port; + bool m_reverse_api_port_isSet; + + qint32 reverse_api_device_index; + bool m_reverse_api_device_index_isSet; + + qint32 reverse_api_channel_index; + bool m_reverse_api_channel_index_isSet; + + SWGGLScope* scope_config; + bool m_scope_config_isSet; + + SWGChannelMarker* channel_marker; + bool m_channel_marker_isSet; + + SWGRollupState* rollup_state; + bool m_rollup_state_isSet; + +}; + +} + +#endif /* SWGIEEE_802_15_4_DemodSettings_H_ */ diff --git a/swagger/sdrangel/code/qt5/client/SWGModelFactory.h b/swagger/sdrangel/code/qt5/client/SWGModelFactory.h index 671b00a29..c7d28d421 100644 --- a/swagger/sdrangel/code/qt5/client/SWGModelFactory.h +++ b/swagger/sdrangel/code/qt5/client/SWGModelFactory.h @@ -216,7 +216,9 @@ #include "SWGHeatMapSettings.h" #include "SWGIEEE_802_15_4_ModActions.h" #include "SWGIEEE_802_15_4_ModReport.h" +#include "SWGIEEE_802_15_4_DemodReport.h" #include "SWGIEEE_802_15_4_ModSettings.h" +#include "SWGIEEE_802_15_4_DemodSettings.h" #include "SWGILSDemodReport.h" #include "SWGILSDemodSettings.h" #include "SWGInmarsatDemodReport.h" @@ -1461,11 +1463,21 @@ namespace SWGSDRangel { obj->init(); return obj; } + if(QString("SWGIEEE_802_15_4_DemodReport").compare(type) == 0) { + SWGIEEE_802_15_4_DemodReport *obj = new SWGIEEE_802_15_4_DemodReport(); + obj->init(); + return obj; + } if(QString("SWGIEEE_802_15_4_ModSettings").compare(type) == 0) { SWGIEEE_802_15_4_ModSettings *obj = new SWGIEEE_802_15_4_ModSettings(); obj->init(); return obj; } + if(QString("SWGIEEE_802_15_4_DemodSettings").compare(type) == 0) { + SWGIEEE_802_15_4_DemodSettings *obj = new SWGIEEE_802_15_4_DemodSettings(); + obj->init(); + return obj; + } if(QString("SWGILSDemodReport").compare(type) == 0) { SWGILSDemodReport *obj = new SWGILSDemodReport(); obj->init(); From b00de0e6189833f3f31aec7544681ce6219509a8 Mon Sep 17 00:00:00 2001 From: Jon Beniston Date: Thu, 15 Oct 2026 18:04:27 +0100 Subject: [PATCH 2/4] 802.15.4 Mod: Support fractional resampling. --- .../mod802.15.4/ieee_802_15_4_modgui.cpp | 28 +- .../mod802.15.4/ieee_802_15_4_modsource.cpp | 314 +++++++++--------- .../mod802.15.4/ieee_802_15_4_modsource.h | 16 +- plugins/channeltx/mod802.15.4/readme.md | 27 +- 4 files changed, 205 insertions(+), 180 deletions(-) diff --git a/plugins/channeltx/mod802.15.4/ieee_802_15_4_modgui.cpp b/plugins/channeltx/mod802.15.4/ieee_802_15_4_modgui.cpp index 83261e71e..c717d0ef8 100644 --- a/plugins/channeltx/mod802.15.4/ieee_802_15_4_modgui.cpp +++ b/plugins/channeltx/mod802.15.4/ieee_802_15_4_modgui.cpp @@ -150,20 +150,15 @@ void IEEE_802_15_4_ModGUI::handleSourceMessages() } } -// Check sample rate is good enough and if not, display a warning in title +// Check sample rate is good enough and if not, display a warning in title. +// The waveform is resampled to the baseband sample rate, so it doesn't need to be a +// multiple of the chip rate, but should be at least the RF bandwidth. void IEEE_802_15_4_ModGUI::checkSampleRate() { - int cr = m_settings.getChipRate(); - - if ((m_basebandSampleRate % cr) != 0) + if (m_basebandSampleRate < m_settings.m_rfBandwidth) { ui->chipRateText->setStyleSheet("QLabel { background:rgb(200,50,50); }"); - ui->chipRateText->setToolTip(QString("Baseband sample rate %1 S/s is not an integer multiple of chip rate %2 S/s").arg(m_basebandSampleRate).arg(cr)); - } - else if ((m_basebandSampleRate / cr) <= 2) - { - ui->chipRateText->setStyleSheet("QLabel { background:rgb(200,50,50); }"); - ui->chipRateText->setToolTip(QString("Baseband sample rate %1 S/s is too low for chip rate %2 S/s").arg(m_basebandSampleRate).arg(cr)); + ui->chipRateText->setToolTip(QString("Baseband sample rate %1 S/s is lower than the RF bandwidth %2 Hz, so the transmitted signal will be filtered").arg(m_basebandSampleRate).arg(m_settings.m_rfBandwidth)); } else { @@ -196,7 +191,17 @@ void IEEE_802_15_4_ModGUI::on_phy_currentIndexChanged(int value) ui->glSpectrum->setSampleRate(m_settings.m_spectrumRate); displayChipRate(m_settings); checkSampleRate(); - applySettings(QStringList("phy")); + // There is no "phy" setting, so apply each of the settings setPHY() sets + applySettings(QStringList({ + "bitRate", + "subGHzBand", + "modulation", + "pulseShaping", + "beta", + "symbolSpan", + "rfBandwidth", + "spectrumRate" + })); // Remove custom PHY when deselected, as we no longer know how to set it if (value < 6) @@ -209,6 +214,7 @@ void IEEE_802_15_4_ModGUI::on_rfBW_valueChanged(int value) displayRFBandwidth(bw); m_channelMarker.setBandwidth(bw); m_settings.m_rfBandwidth = bw; + checkSampleRate(); applySettings(QStringList("rfBandwidth")); } diff --git a/plugins/channeltx/mod802.15.4/ieee_802_15_4_modsource.cpp b/plugins/channeltx/mod802.15.4/ieee_802_15_4_modsource.cpp index b9fb03a67..afb4081d3 100644 --- a/plugins/channeltx/mod802.15.4/ieee_802_15_4_modsource.cpp +++ b/plugins/channeltx/mod802.15.4/ieee_802_15_4_modsource.cpp @@ -26,6 +26,7 @@ #include "dsp/scopevis.h" #include "ieee_802_15_4_modsource.h" #include "util/crc.h" +#include "util/ieee_802_15_4.h" MESSAGE_CLASS_DEFINITION(IEEE_802_15_4_ModSource::MsgCloseUDP, Message) MESSAGE_CLASS_DEFINITION(IEEE_802_15_4_ModSource::MsgOpenUDP, Message) @@ -45,18 +46,21 @@ IEEE_802_15_4_ModSource::IEEE_802_15_4_ModSource() : m_peakLevel(0.0f), m_levelSum(0.0f), m_sampleIdx(0), + m_samplesPerChip(10), + m_modulationSampleRate(3000000), + m_resample(false), + m_resamplerDistance(1.0f), + m_resamplerDistanceRemain(0.0f), m_chipsPerSymbol(15), m_bitsPerSymbol(1), m_chipRate(300000), m_state(idle), + m_lpfFlushCount(0), m_byteIdx(0), m_bitIdx(0), m_bitCount(0), m_udpSocket(nullptr) { - m_lowpass.create(301, m_channelSampleRate, 22000.0 / 2.0); - m_pulseShapeI.create(1, 6, m_channelSampleRate/300000, true); - m_pulseShapeQ.create(1, 6, m_channelSampleRate/300000, true); m_specSampleBuffer.resize(m_specSampleBufferSize); m_scopeSampleBuffer.resize(m_scopeSampleBufferSize); applySettings(QStringList(), m_settings, true); @@ -90,11 +94,39 @@ void IEEE_802_15_4_ModSource::pullOne(Sample& sample) return; } - // Calculate next sample - modulateSample(); + Complex ci; + + // The waveform is generated at m_modulationSampleRate, which is an integer multiple + // of the chip rate, then resampled to the channel sample rate if that isn't + if (!m_resample) + { + modulateSample(); + ci = m_modSample; + } + else if (m_resamplerDistance > 1.0f) // decimate + { + modulateSample(); + + while (!m_resampler.decimate(&m_resamplerDistanceRemain, m_modSample, &ci)) { + modulateSample(); + } + + m_resamplerDistanceRemain += m_resamplerDistance; + } + else // interpolate + { + if (m_resampler.interpolate(&m_resamplerDistanceRemain, m_modSample, &ci)) { + modulateSample(); + } + + m_resamplerDistanceRemain += m_resamplerDistance; + } + + // Display transmitted baseband signal in spectrum analyser and scope + sampleToSpectrum(ci); + sampleToScope(ci); // Shift to carrier frequency - Complex ci = m_modSample; ci *= m_carrierNco.nextIQ(); // Calculate power @@ -160,9 +192,14 @@ void IEEE_802_15_4_ModSource::modulateSample() Real audioMod = 0.0f; m_modSample.real(audioMod); m_modSample.imag(0); + // Flush the RF bandwidth filter at the end of a frame, otherwise the last + // lpfTaps/2 samples of the frame (which can be more than the padding) are lost + if (m_lpfFlushCount > 0) + { + m_modSample = m_lowpass.filter(m_modSample); + m_lpfFlushCount--; + } calculateLevel(audioMod); - sampleToSpectrum(m_modSample); - sampleToScope(m_modSample); if (m_state == wait) { m_waitCounter--; @@ -242,10 +279,6 @@ void IEEE_802_15_4_ModSource::modulateSample() m_modSample.real(m_linearGain * linearRampGain * i); m_modSample.imag(m_linearGain * linearRampGain * q); - // Display baseband audio in spectrum analyser - sampleToSpectrum(m_modSample); - sampleToScope(m_modSample); - // Apply low pass filter to limit RF BW m_modSample = m_lowpass.filter(m_modSample); @@ -265,6 +298,7 @@ void IEEE_802_15_4_ModSource::modulateSample() )) { m_state = idle; + m_lpfFlushCount = m_settings.m_lpfTaps; // Do we need to retransmit the frame? if (m_settings.m_repeat) { @@ -276,7 +310,7 @@ void IEEE_802_15_4_ModSource::modulateSample() { // Wait before retransmitting m_state = wait; - m_waitCounter = m_settings.m_repeatDelay * m_channelSampleRate; + m_waitCounter = m_settings.m_repeatDelay * m_modulationSampleRate; } else { @@ -313,71 +347,16 @@ void IEEE_802_15_4_ModSource::calculateLevel(Real& sample) void IEEE_802_15_4_ModSource::applySettings(const QStringList& settingsKeys, const IEEE_802_15_4_ModSettings& settings, bool force) { - // Only recreate filters if settings have changed - if ((settingsKeys.contains("lpfTaps") && (settings.m_lpfTaps != m_settings.m_lpfTaps)) || - (settingsKeys.contains("rfBandwidth") && (settings.m_rfBandwidth != m_settings.m_rfBandwidth)) || force) - { - qDebug() << "IEEE_802_15_4_ModSource::applySettings: Creating new lpf with taps " << settings.m_lpfTaps << " rfBW " << settings.m_rfBandwidth; - m_lowpass.create(settings.m_lpfTaps, m_channelSampleRate, settings.m_rfBandwidth / 2.0); - } - if ((settingsKeys.contains("spectrumRate") && (settings.m_spectrumRate != m_settings.m_spectrumRate)) || force) - { - m_interpolatorDistanceRemain = 0; - m_interpolatorConsumed = false; - m_interpolatorDistance = (Real) m_channelSampleRate / (Real) settings.m_spectrumRate; - m_interpolator.create(48, settings.m_spectrumRate, settings.m_spectrumRate / 2.2, 3.0); - } - - if (settings.m_modulation == IEEE_802_15_4_ModSettings::BPSK) - { - m_chipsPerSymbol = 15; - m_bitsPerSymbol = 1; - } - else - { - m_bitsPerSymbol = 4; - m_chipsPerSymbol = settings.m_subGHzBand ? 16 : 32; - } - - m_chipRate = settings.m_bitRate * m_chipsPerSymbol / m_bitsPerSymbol; - m_samplesPerChip = m_channelSampleRate / m_chipRate; - qDebug() << "m_samplesPerChip: " << m_samplesPerChip; - - if (m_channelSampleRate % m_chipRate != 0) { - qCritical("Sample rate is not an integer multiple of the chip rate"); - } - - if (m_samplesPerChip <= 2) { - qCritical("Sample rate is not a high enough multiple of the chip rate"); - } - - if ((settingsKeys.contains("pulseShaping") && (settings.m_pulseShaping != m_settings.m_pulseShaping)) + bool updateRates = (settingsKeys.contains("lpfTaps") && (settings.m_lpfTaps != m_settings.m_lpfTaps)) + || (settingsKeys.contains("rfBandwidth") && (settings.m_rfBandwidth != m_settings.m_rfBandwidth)) + || (settingsKeys.contains("pulseShaping") && (settings.m_pulseShaping != m_settings.m_pulseShaping)) || (settingsKeys.contains("beta") && (settings.m_beta != m_settings.m_beta)) || (settingsKeys.contains("symbolSpan") && (settings.m_symbolSpan != m_settings.m_symbolSpan)) || (settingsKeys.contains("bitRate") && (settings.m_bitRate != m_settings.m_bitRate)) || (settingsKeys.contains("modulation") && (settings.m_modulation != m_settings.m_modulation)) || (settingsKeys.contains("subGHzBand") && (settings.m_subGHzBand != m_settings.m_subGHzBand)) - || force) - { - qDebug() << "IEEE_802_15_4_ModSource::applySettings: Recreating pulse shaping filter: " - << " pulseShaping: " << m_settings.m_pulseShaping - << " beta: " << settings.m_beta - << " symbolSpan: " << settings.m_symbolSpan - << " channelSampleRate:" << m_channelSampleRate - << " subGHzBand: " << settings.m_subGHzBand - << " bitRate:" << settings.m_bitRate - << " chipRate:" << m_chipRate; - - if (settings.m_pulseShaping == IEEE_802_15_4_ModSettings::RC) - { - m_pulseShapeI.create(settings.m_beta, m_settings.m_symbolSpan, m_channelSampleRate/m_chipRate, true); - m_pulseShapeQ.create(settings.m_beta, m_settings.m_symbolSpan, m_channelSampleRate/m_chipRate, true); - } - else - { - createHalfSine(m_channelSampleRate, m_chipRate); - } - } + || force; + bool updateSpectrum = (settingsKeys.contains("spectrumRate") && (settings.m_spectrumRate != m_settings.m_spectrumRate)) || force; if ((settingsKeys.contains("polynomial") && (settings.m_polynomial != m_settings.m_polynomial)) || force) { m_scrambler.setPolynomial(settings.m_polynomial); @@ -389,6 +368,14 @@ void IEEE_802_15_4_ModSource::applySettings(const QStringList& settingsKeys, con m_settings.applySettings(settingsKeys, settings); } + if (updateRates) { + updateSampleRates(); + } + + if (updateSpectrum) { + updateSpectrumInterpolator(); + } + // Precalculate linear gain to save doing it in the loop m_linearGain = powf(10.0f, m_settings.m_gain/20.0f); } @@ -407,54 +394,114 @@ void IEEE_802_15_4_ModSource::applyChannelSettings(int channelSampleRate, int ch m_carrierNco.setFreq(channelFrequencyOffset, channelSampleRate); } - if ((m_channelSampleRate != channelSampleRate) || force) + bool rateChanged = (m_channelSampleRate != channelSampleRate) || force; + bool spectrumChanged = rateChanged || (m_spectrumRate != m_settings.m_spectrumRate); + + m_channelSampleRate = channelSampleRate; + m_channelFrequencyOffset = channelFrequencyOffset; + + if (rateChanged) { + updateSampleRates(); + } + + if (spectrumChanged) { + updateSpectrumInterpolator(); + } +} + +// Choose the sample rate the waveform is generated at, and create the filters that depend on it. +// Pulse shaping requires an integer number of samples per chip. If the channel sample rate +// is a suitable integer multiple of the chip rate, the waveform is generated at that rate. +// Otherwise it is generated at m_resampleSamplesPerChip samples per chip, and resampled to +// the channel sample rate. This also limits CPU usage when the channel sample rate is much +// higher than the chip rate. +void IEEE_802_15_4_ModSource::updateSampleRates() +{ + if (m_settings.m_modulation == IEEE_802_15_4_ModSettings::BPSK) { - qDebug() << "IEEE_802_15_4_ModSource::applyChannelSettings: Recreating filters"; - m_lowpass.create(m_settings.m_lpfTaps, channelSampleRate, m_settings.m_rfBandwidth / 2.0); - qDebug() << "IEEE_802_15_4_ModSource::applyChannelSettings: Recreating pulse shaping filter: " - << " pulseShaping: " << m_settings.m_pulseShaping - << " beta: " << m_settings.m_beta - << " symbolSpan: " << m_settings.m_symbolSpan - << " channelSampleRate:" << channelSampleRate - << " subGHzBand: " << m_settings.m_subGHzBand - << " bitRate:" << m_settings.m_bitRate - << " chipRate:" << m_chipRate; - if (m_settings.m_pulseShaping == IEEE_802_15_4_ModSettings::RC) - { - m_pulseShapeI.create(m_settings.m_beta, m_settings.m_symbolSpan, channelSampleRate/m_chipRate, true); - m_pulseShapeQ.create(m_settings.m_beta, m_settings.m_symbolSpan, channelSampleRate/m_chipRate, true); - } - else - createHalfSine(channelSampleRate, m_chipRate); + m_chipsPerSymbol = 15; + m_bitsPerSymbol = 1; + } + else + { + m_bitsPerSymbol = 4; + m_chipsPerSymbol = m_settings.m_subGHzBand ? 16 : 32; + } + + m_chipRate = m_settings.m_bitRate * m_chipsPerSymbol / m_bitsPerSymbol; + + if ((m_chipRate <= 0) || (m_channelSampleRate <= 0)) { + return; } - if ((m_channelSampleRate != channelSampleRate) || (m_spectrumRate != m_settings.m_spectrumRate) || force) + int ratio = m_channelSampleRate / m_chipRate; + + if (((m_channelSampleRate % m_chipRate) == 0) && (ratio >= m_minSamplesPerChip) && (ratio <= m_maxSamplesPerChip)) + { + m_samplesPerChip = ratio; + m_resample = false; + } + else + { + m_samplesPerChip = m_resampleSamplesPerChip; + m_resample = true; + } + + m_modulationSampleRate = m_samplesPerChip * m_chipRate; + m_sampleIdx = 0; + + // RF bandwidth filter can't be wider than the sample rate + float rfBandwidth = std::min(m_settings.m_rfBandwidth, 0.9f * m_modulationSampleRate); + m_lowpass.create(m_settings.m_lpfTaps, m_modulationSampleRate, rfBandwidth / 2.0); + + if (m_settings.m_pulseShaping == IEEE_802_15_4_ModSettings::RC) + { + m_pulseShapeI.create(m_settings.m_beta, m_settings.m_symbolSpan, m_samplesPerChip, true); + m_pulseShapeQ.create(m_settings.m_beta, m_settings.m_symbolSpan, m_samplesPerChip, true); + } + else + { + createHalfSine(m_samplesPerChip); + } + + if (m_resample) + { + // Filter to the RF bandwidth, which also has to be within the Nyquist bandwidth of the + // lower of the two sample rates, to avoid aliasing + double cutoff = std::min((double) rfBandwidth / 2.0, 0.45 * std::min(m_modulationSampleRate, m_channelSampleRate)); + m_resamplerDistance = (Real) m_modulationSampleRate / (Real) m_channelSampleRate; + m_resamplerDistanceRemain = 0.0f; + m_resampler.create(48, m_modulationSampleRate, cutoff, m_resamplerTapsPerPhase); + } + + qDebug() << "IEEE_802_15_4_ModSource::updateSampleRates:" + << " channelSampleRate: " << m_channelSampleRate + << " chipRate: " << m_chipRate + << " samplesPerChip: " << m_samplesPerChip + << " modulationSampleRate: " << m_modulationSampleRate + << " resample: " << m_resample; +} + +void IEEE_802_15_4_ModSource::updateSpectrumInterpolator() +{ + if (m_settings.m_spectrumRate > 0) { m_interpolatorDistanceRemain = 0; m_interpolatorConsumed = false; - m_interpolatorDistance = (Real) channelSampleRate / (Real) m_settings.m_spectrumRate; + m_interpolatorDistance = (Real) m_channelSampleRate / (Real) m_settings.m_spectrumRate; m_interpolator.create(48, m_settings.m_spectrumRate, m_settings.m_spectrumRate / 2.2, 3.0); } - m_channelSampleRate = channelSampleRate; - m_channelFrequencyOffset = channelFrequencyOffset; m_spectrumRate = m_settings.m_spectrumRate; - m_samplesPerChip = m_channelSampleRate / m_chipRate; - qDebug() << "m_samplesPerChip: " << m_samplesPerChip; } // Half-sine pulse shaping for O-QPSK -void IEEE_802_15_4_ModSource::createHalfSine(int sampleRate, int chipRate) +void IEEE_802_15_4_ModSource::createHalfSine(int samplesPerChip) { - int samplesPerChip = sampleRate / chipRate; - double tc = 1.0 / chipRate; - delete[] m_sinLUT; m_sinLUT = new double[2*samplesPerChip]; - for (int i = 0; i < 2*samplesPerChip; i++) - { - double t=i/(double)sampleRate; - m_sinLUT[i] = sin(M_PI*t/(2.0*tc)); + for (int i = 0; i < 2*samplesPerChip; i++) { + m_sinLUT[i] = sin(M_PI*i/(2.0*samplesPerChip)); } } @@ -471,57 +518,12 @@ int IEEE_802_15_4_ModSource::getChip() if (m_chipIdx == 0) m_symbol = getSymbol(); - if (m_settings.m_bitRate <= 40000) - { - static const int chipsBpsk[2][15] = { - {1, 1, 1, 1, 0, 1, 0, 1, 1, 0, 0, 1, 0, 0, 0}, - {0, 0, 0, 0, 1, 0, 1, 0, 0, 1, 1, 0, 1, 1, 1} - }; - chip = chipsBpsk[m_symbol][m_chipIdx]; - } - else if (m_settings.m_subGHzBand) - { - static const int chipsSubGHzOqpsk[16][16] = { - {0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 1, 0, 0, 1, 0, 1}, - {0, 1, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 1, 0, 0, 1}, - {0, 1, 0, 1, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0, 1, 0}, - {1, 0, 0, 1, 0, 1, 0, 0, 1, 1, 1, 1, 1, 0, 0, 0}, - {0, 0, 1, 0, 0, 1, 0, 1, 0, 0, 1, 1, 1, 1, 1, 0}, - {1, 0, 0, 0, 1, 0, 0, 1, 0, 1, 0, 0, 1, 1, 1, 1}, - {1, 1, 1, 0, 0, 0, 1, 0, 0, 1, 0, 1, 0, 0, 1, 1}, - {1, 1, 1, 1, 1, 0, 0, 0, 1, 0, 0, 1, 0, 1, 0, 0}, - {0, 1, 1, 0, 1, 0, 1, 1, 0, 1, 1, 1, 0, 0, 0, 0}, - {0, 0, 0, 1, 1, 0, 1, 0, 1, 1, 0, 1, 1, 1, 0, 0}, - {0, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 1, 0, 1, 1, 1}, - {1, 1, 0, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 1, 0, 1}, - {0, 1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 1}, - {1, 1, 0, 1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 0, 1, 0}, - {1, 0, 1, 1, 0, 1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 0}, - {1, 0, 1, 0, 1, 1, 0, 1, 1, 1, 0, 0, 0, 0, 0, 1}, - }; - chip = chipsSubGHzOqpsk[m_symbol][m_chipIdx]; - } - else - { - static const int chipsOqpsk[16][32] = { - {1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0}, - {1, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 1, 0}, - {0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 0, 0, 1, 0}, - {0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1}, - {0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1}, - {0, 0, 1, 1, 0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1, 1, 1, 0, 0}, - {1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 0, 1, 1, 0, 0, 1}, - {1, 0, 0, 1, 1, 1, 0, 0, 0, 0, 1, 1, 0, 1, 0, 1, 0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 1, 0, 1, 1, 0, 1}, - {1, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1}, - {1, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1}, - {0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1}, - {0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0}, - {0, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0}, - {0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0, 1, 0, 0, 1}, - {1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0, 1, 1, 0, 0}, - {1, 1, 0, 0, 1, 0, 0, 1, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1, 1, 0, 0, 0} - }; - chip = chipsOqpsk[m_symbol][m_chipIdx]; + if (m_settings.m_bitRate <= 40000) { + chip = IEEE_802_15_4_PHY::m_chipsBPSK[m_symbol][m_chipIdx]; + } else if (m_settings.m_subGHzBand) { + chip = IEEE_802_15_4_PHY::m_chipsSubGHzOQPSK[m_symbol][m_chipIdx]; + } else { + chip = IEEE_802_15_4_PHY::m_chips2450OQPSK[m_symbol][m_chipIdx]; } m_chipIdx++; diff --git a/plugins/channeltx/mod802.15.4/ieee_802_15_4_modsource.h b/plugins/channeltx/mod802.15.4/ieee_802_15_4_modsource.h index 351c315c0..c1991fbe1 100644 --- a/plugins/channeltx/mod802.15.4/ieee_802_15_4_modsource.h +++ b/plugins/channeltx/mod802.15.4/ieee_802_15_4_modsource.h @@ -19,6 +19,7 @@ #ifndef INCLUDE_IEEE_802_15_4_MODSOURCE_H #define INCLUDE_IEEE_802_15_4_MODSOURCE_H +#include #include #include @@ -33,6 +34,7 @@ #include "util/lfsr.h" #include "util/movingaverage.h" #include "util/message.h" +#include "util/messagequeue.h" #include "ieee_802_15_4_modsettings.h" @@ -150,6 +152,15 @@ private: int m_sampleIdx; // Sample index in to chip int m_samplesPerChip; // Number of samples per chip + int m_modulationSampleRate; // Sample rate waveform is generated at (m_samplesPerChip * m_chipRate) + bool m_resample; // Whether to resample from m_modulationSampleRate to m_channelSampleRate + Interpolator m_resampler; + Real m_resamplerDistance; + Real m_resamplerDistanceRemain; + static const int m_minSamplesPerChip = 4; // Range of samples per chip for which we don't resample + static const int m_maxSamplesPerChip = 16; + static const int m_resampleSamplesPerChip = 8; // Samples per chip used when resampling + static constexpr double m_resamplerTapsPerPhase = 8.0; int m_chipsPerSymbol; // Number of chips per symbol int m_bitsPerSymbol; // Number of bits per symbol int m_chipRate; @@ -164,6 +175,7 @@ private: } m_state; // States for sample modulation int m_frameRepeatCount; uint64_t m_waitCounter; // Samples to wait before retransmission + int m_lpfFlushCount; // Samples to flush through m_lowpass after a frame uint8_t m_bits[4+1+1+127]; // Bits to transmit (preamble, SFD, length, payload) int m_byteIdx; // Index in to m_bits @@ -181,7 +193,9 @@ private: void initTX(); void openUDP(const QString& udpAddress, uint16_t udpPort); void closeUDP(); - void createHalfSine(int sampleRate, int chipRate); + void createHalfSine(int samplesPerChip); + void updateSampleRates(); + void updateSpectrumInterpolator(); void calculateLevel(Real& sample); void modulateSample(); diff --git a/plugins/channeltx/mod802.15.4/readme.md b/plugins/channeltx/mod802.15.4/readme.md index c9cf20992..c5b620c17 100644 --- a/plugins/channeltx/mod802.15.4/readme.md +++ b/plugins/channeltx/mod802.15.4/readme.md @@ -2,7 +2,9 @@

Introduction

-This plugin can be used to transmit IEEE 802.15.4 frames. The 802.15.4 PHY & RF layers are used by networking layers such as ZigBee, 6LoWPAN and others. +This plugin can be used to transmit IEEE 802.15.4 frames. +The 802.15.4 PHY & RF layers are used by networking layers such as ZigBee, 6LoWPAN and others. +Frames can be received with the [802.15.4 demodulator](../../channelrx/demod802.15.4/readme.md).

Interface

@@ -25,24 +27,25 @@ Use this button to toggle mute for this channel.

4: PHY

This specifies the parameters of the PHY (physical layer), including the bit rate and modulation that is used for the frame transmission. Supported PHYs are 20kbps BPSK, 40kbps BPSK, 100kpbs <1GHz O-QPSK, 250kpbs <1GHz O-QPSK and 250kbps 2.4GHz O-QPSK. -These 802.15.4 PHYs use DSSS (Direct sequence spread spectrum), whereby multiple chips are transmitted per symbol. This means that a high baseband sample rate and large RF bandwidth is required. The baseband sample rate should be set to an integer multiple of the chip rate (at least 4x). +These 802.15.4 PHYs use DSSS (Direct sequence spread spectrum), whereby multiple chips are transmitted per symbol. This means that a high baseband sample rate and large RF bandwidth is required. The baseband sample rate should be at least the RF bandwidth (6), as given in the Min sample rate column below. +The waveform is generated at an integer multiple of the chip rate: if the baseband sample rate is 4 to 16 times the chip rate, at the baseband sample rate, otherwise at 8 times the chip rate, and then resampled to the baseband sample rate. So the baseband sample rate doesn't need to be a multiple of the chip rate. Each PHY is applicable only for specific frequency bands as detailed below: Channel Page | Channels | Frequencies (MHz) | Bit rate (kbps) | Chip rate (kcps) | Modulation | Shaping | Min sample rate (MSa/s) -------------|----------|--------------------|-----------------|------------------|------------|---------|------------------------ -0 | 0 | 868.3 | 20 | 300 | BPSK | RC r=1 | 1.2 -0 | 1-10 | 906, 908... 926 | 40 | 600 | BPSK | RC r=1 | 2.4 -0 | 11-26 | 2405, 2410... 2480 | 250 | 2000 | O-QPSK | Sine | 8 -2 | 0 | 868.3 | 100 | 400 | O-QPSK | Sine/RC | 2.4 -2 | 1-10 | 906, 908... 926 | 250 | 1000 | O-QPSK | Sine | 4 -5 | 0-3 | 780, 782... 786 | 250 | 1000 | O-QPSK | RC r=.8 | 4 -11 | 0-6 | 2363, 2368... 2393 | 250 | 2000 | O-QPSK | Sine | 8 -11 | 7-13 | 2367, 2372... 2397 | 250 | 2000 | O-QPSK | Sine | 8 -11 | 14 | 2395 | 250 | 2000 | O-QPSK | Sine | 8 +0 | 0 | 868.3 | 20 | 300 | BPSK | RC r=1 | 0.6 +0 | 1-10 | 906, 908... 926 | 40 | 600 | BPSK | RC r=1 | 1.2 +0 | 11-26 | 2405, 2410... 2480 | 250 | 2000 | O-QPSK | Sine | 4 +2 | 0 | 868.3 | 100 | 400 | O-QPSK | Sine/RC | 0.8 +2 | 1-10 | 906, 908... 926 | 250 | 1000 | O-QPSK | Sine | 2 +5 | 0-3 | 780, 782... 786 | 250 | 1000 | O-QPSK | RC r=.8 | 2 +11 | 0-6 | 2363, 2368... 2393 | 250 | 2000 | O-QPSK | Sine | 4 +11 | 7-13 | 2367, 2372... 2397 | 250 | 2000 | O-QPSK | Sine | 4 +11 | 14 | 2395 | 250 | 2000 | O-QPSK | Sine | 4

5: Chip rate

-This is the chip rate. It must be a multiple of the baseband sample rate and the baseband sample rate should be at least twice the chip rate. If one or both of these conditions are not met the background turns to red and the tooltip details the condition. +This is the chip rate. If the baseband sample rate is lower than the RF bandwidth (6), the background turns to red, as the transmitted signal will be filtered.

6: RF Bandwidth

From 4d24022b527d660614e5c370d9783c04b6044d9e Mon Sep 17 00:00:00 2001 From: Jon Beniston Date: Thu, 15 Oct 2026 18:34:30 +0100 Subject: [PATCH 3/4] Add labels to image --- doc/img/IEEE_802_15_4_Demod_plugin.png | Bin 22013 -> 31144 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/doc/img/IEEE_802_15_4_Demod_plugin.png b/doc/img/IEEE_802_15_4_Demod_plugin.png index 96a12bacb8011c40acf906e2ec1dffb148887221..bc551ed8218e8b8bad6f08e706303b97825d82a3 100644 GIT binary patch literal 31144 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 Xu>$vX);Cly=X?;C7b_R}81%mYDZ#{p literal 22013 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 From 05af9f3c31e34430ebe520c4794fd7de01346cdf Mon Sep 17 00:00:00 2001 From: Jon Beniston Date: Thu, 15 Oct 2026 18:58:49 +0100 Subject: [PATCH 4/4] White space --- plugins/channeltx/mod802.15.4/readme.md | 4 ++-- sdrbase/util/ieee_802_15_4.h | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/plugins/channeltx/mod802.15.4/readme.md b/plugins/channeltx/mod802.15.4/readme.md index c5b620c17..d65c8a8ca 100644 --- a/plugins/channeltx/mod802.15.4/readme.md +++ b/plugins/channeltx/mod802.15.4/readme.md @@ -2,8 +2,8 @@

Introduction

-This plugin can be used to transmit IEEE 802.15.4 frames. -The 802.15.4 PHY & RF layers are used by networking layers such as ZigBee, 6LoWPAN and others. +This plugin can be used to transmit IEEE 802.15.4 frames. +The 802.15.4 PHY & RF layers are used by networking layers such as ZigBee, 6LoWPAN and others. Frames can be received with the [802.15.4 demodulator](../../channelrx/demod802.15.4/readme.md).

Interface

diff --git a/sdrbase/util/ieee_802_15_4.h b/sdrbase/util/ieee_802_15_4.h index 93cc57277..1c7a74ace 100644 --- a/sdrbase/util/ieee_802_15_4.h +++ b/sdrbase/util/ieee_802_15_4.h @@ -1,4 +1,4 @@ -/////////////////////////////////////////////////////////////////////////////////// +/////////////////////////////////////////////////////////////////////////////////// // Copyright (C) 2026 Jon Beniston, M7RCE // // Some code by AI // // //