mirror of
https://github.com/saitohirga/WSJT-X.git
synced 2024-11-01 16:13:57 -04:00
ae3749bb46
Build now creates and installs a UDP library that contains the server side of the UDP messaging facility. This library is used by the udp_daemon and message_aggregator reference examples. The new library is currently a static archive but can also be built as a shared library. The library allows third party Qt applications to easily access UDP messages from WSJT-X. Refactored the message_aggregator reference example to split out classes into separate translation units. Added new functionality to exercise the new UDP status fields, highlight own call, CQ/QRZ messages and decodes near Rx DF. git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6691 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
87 lines
3.5 KiB
C++
87 lines
3.5 KiB
C++
#ifndef MESSAGE_SERVER_HPP__
|
|
#define MESSAGE_SERVER_HPP__
|
|
|
|
#include <QObject>
|
|
#include <QTime>
|
|
#include <QDateTime>
|
|
#include <QHostAddress>
|
|
|
|
#include "udp_export.h"
|
|
#include "Radio.hpp"
|
|
|
|
#include "pimpl_h.hpp"
|
|
|
|
class QString;
|
|
|
|
//
|
|
// MessageServer - a reference implementation of a message server
|
|
// matching the MessageClient class at the other end
|
|
// of the wire
|
|
//
|
|
// This class is fully functioning and suitable for use in C++
|
|
// applications that use the Qt framework. Other applications should
|
|
// use this classes' implementation as a reference implementation.
|
|
//
|
|
class UDP_EXPORT MessageServer
|
|
: public QObject
|
|
{
|
|
Q_OBJECT;
|
|
|
|
public:
|
|
using port_type = quint16;
|
|
using Frequency = Radio::Frequency;
|
|
|
|
MessageServer (QObject * parent = nullptr);
|
|
|
|
// start or restart the server, if the multicast_group_address
|
|
// argument is given it is assumed to be a multicast group address
|
|
// which the server will join
|
|
Q_SLOT void start (port_type port, QHostAddress const& multicast_group_address = QHostAddress {});
|
|
|
|
// ask the client with identification 'id' to make the same action
|
|
// as a double click on the decode would
|
|
//
|
|
// note that the client is not obliged to take any action and only
|
|
// takes any action if the decode is present and is a CQ or QRZ message
|
|
Q_SLOT void reply (QString const& id, QTime time, qint32 snr, float delta_time, quint32 delta_frequency
|
|
, QString const& mode, QString const& message);
|
|
|
|
// ask the client with identification 'id' to replay all decodes
|
|
Q_SLOT void replay (QString const& id);
|
|
|
|
// ask the client with identification 'id' to halt transmitting
|
|
// auto_only just disables auto Tx, otherwise halt is immediate
|
|
Q_SLOT void halt_tx (QString const& id, bool auto_only);
|
|
|
|
// ask the client with identification 'id' to set the free text
|
|
// message and optionally send it ASAP
|
|
Q_SLOT void free_text (QString const& id, QString const& text, bool send);
|
|
|
|
// the following signals are emitted when a client broadcasts the
|
|
// matching message
|
|
Q_SIGNAL void client_opened (QString const& id);
|
|
Q_SIGNAL void status_update (QString const& id, Frequency, QString const& mode, QString const& dx_call
|
|
, QString const& report, QString const& tx_mode, bool tx_enabled
|
|
, bool transmitting, bool decoding, qint32 rx_df, qint32 tx_df
|
|
, QString const& de_call, QString const& de_grid, QString const& dx_grid);
|
|
Q_SIGNAL void client_closed (QString const& id);
|
|
Q_SIGNAL void decode (bool is_new, QString const& id, QTime time, qint32 snr, float delta_time
|
|
, quint32 delta_frequency, QString const& mode, QString const& message);
|
|
Q_SIGNAL void WSPR_decode (bool is_new, QString const& id, QTime time, qint32 snr, float delta_time, Frequency
|
|
, qint32 drift, QString const& callsign, QString const& grid, qint32 power);
|
|
Q_SIGNAL void qso_logged (QString const& id, QDateTime time, QString const& dx_call, QString const& dx_grid
|
|
, Frequency dial_frequency, QString const& mode, QString const& report_sent
|
|
, QString const& report_received, QString const& tx_power, QString const& comments
|
|
, QString const& name);
|
|
Q_SIGNAL void clear_decodes (QString const& id);
|
|
|
|
// this signal is emitted when a network error occurs
|
|
Q_SIGNAL void error (QString const&) const;
|
|
|
|
private:
|
|
class UDP_NO_EXPORT impl;
|
|
pimpl<impl> m_;
|
|
};
|
|
|
|
#endif
|