#ifndef MESSAGE_CLIENT_HPP__ #define MESSAGE_CLIENT_HPP__ #include #include #include #include #include "Radio.hpp" #include "pimpl_h.hpp" class QByteArray; class QHostAddress; class QColor; // // MessageClient - Manage messages sent and replies received from a // matching server (MessageServer) at the other end of // the wire // // // Each outgoing message type is a Qt slot // class MessageClient : public QObject { Q_OBJECT; public: using Frequency = Radio::Frequency; using port_type = quint16; // instantiate and initiate a host lookup on the server // // messages will be silently dropped until a server host lookup is complete MessageClient (QString const& id, QString const& version, QString const& revision, QString const& server, port_type server_port, QObject * parent = nullptr); // query server details QHostAddress server_address () const; port_type server_port () const; // initiate a new server host lookup or is the server name is empty // the sending of messages is disabled Q_SLOT void set_server (QString const& server = QString {}); // change the server port messages are sent to Q_SLOT void set_server_port (port_type server_port = 0u); // outgoing messages Q_SLOT void status_update (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, bool watchdog_timeout, QString const& sub_mode , bool fast_mode, quint8 special_op_mode, QString const& configuration_name); Q_SLOT void decode (bool is_new, QTime time, qint32 snr, float delta_time, quint32 delta_frequency , QString const& mode, QString const& message, bool low_confidence , bool off_air); Q_SLOT void WSPR_decode (bool is_new, QTime time, qint32 snr, float delta_time, Frequency , qint32 drift, QString const& callsign, QString const& grid, qint32 power , bool off_air); Q_SLOT void decodes_cleared (); Q_SLOT void qso_logged (QDateTime time_off, 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, QDateTime time_on, QString const& operator_call , QString const& my_call, QString const& my_grid , QString const& exchange_sent, QString const& exchange_rcvd); // ADIF_record argument should be valid ADIF excluding any end // of record marker Q_SLOT void logged_ADIF (QByteArray const& ADIF_record); // this may be used to send arbitrary UDP datagrams to and // destination allowing the underlying socket to be used for general // UDP messaging if desired qint64 send_raw_datagram (QByteArray const&, QHostAddress const& dest_address, port_type dest_port); // disallowed message destination (does not block datagrams sent // with send_raw_datagram() above) Q_SLOT void add_blocked_destination (QHostAddress const&); // this signal is emitted if the server has requested a decode // window clear action Q_SIGNAL void clear_decodes (quint8 window); // this signal is emitted if the server sends us a reply, the only // reply supported is reply to a prior CQ or QRZ message Q_SIGNAL void reply (QTime, qint32 snr, float delta_time, quint32 delta_frequency, QString const& mode , QString const& message_text, bool low_confidence, quint8 modifiers); // this signal is emitted if the server has requested a replay of // all decodes Q_SIGNAL void replay (); // this signal is emitted if the server has requested immediate (or // auto Tx if auto_only is true) transmission to halt Q_SIGNAL void halt_tx (bool auto_only); // this signal is emitted if the server has requested a new free // message text Q_SIGNAL void free_text (QString const&, bool send); // this signal is emitted if the server has sent a highlight // callsign request for the specified call Q_SIGNAL void highlight_callsign (QString const& callsign, QColor const& bg, QColor const& fg, bool last_only); // this signal is emitted if the server has requested a switch to a // new configuration Q_SIGNAL void switch_configuration (QString const& configuration_name); // this signal is emitted when network errors occur or if a host // lookup fails Q_SIGNAL void error (QString const&) const; // this signal is emitted if the message obtains a location from a // server. (It doesn't have to be new, could be a periodic location // update) Q_SIGNAL void location (QString const&); private: class impl; pimpl m_; }; #endif