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
UDP message servers will not receive a Status until some status field
changes if they join a network with existing clients. To avoid this
receipt of a Replay message, which should be the first message a
server sends after negotiating the schema, now cuases the duplicate
message check to be disabled for the next message. This should be
sufficient for servers to get into sync.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6459 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
The message_aggregator (MessageAggregator.cpp) has been updated to do
something with WSPR decodes.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6101 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
Updated message_aggregator reference application to show the mode
label in the status bar with a cyan background colour when decoding is
busy.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6089 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
The MessageClient and MessageServer classes now agree a maximum common
schema number for the protocol described in NetworkMessage.hpp. this
is achieved by the client sending a Heartbeat message specifying the
highest schema number supported, the server responds with messages
using the minimum of its highest supported schema number and the
highest schema number sent by the client in its initial Heartbeat
message. This mechanism enables clients and servers built with
different generations of the message schema to interoperate with
minimum loss of functionality.
It should be noted that messages may be extended with new fields on
the end of the current definition so long as the meaning of the
original fields are unchanged. Such an extension does not need the
schema number to be incremented. On the other hand, using a newer
version of the underlying Qt QDataStream::Version should always
increment the schema number since the NetworkMessage::Builder and
NetworkMessage::Reader classes need to know which QDataStream::Version
to use.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5991 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
This message now has the ability to simply change the free text
message or to change the message and send it ASAP.
The message_aggregator reference UDP server application exercises this
feature by sending a new free text message on any edit and requesting
it be sent by WSJT-X when editing is finished i,e, RETURN pressed or
focus moved away.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5445 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
By providing safe defaults for expected input fields that are not
present in messages from older version senders, it is now possible to
mix versions of clients and servers. This relies on fields never
changing meaning or content, new fields may be safely added to the end
of existing messages.
Merged from the wsjtx-1.5 branch.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5338 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
The reply can now be used to turn off auto Tx or to halt Tx
immediately. Also enforced the accept UDP requests setting for halt Tx
and set free text message replies.
Merged from the wsjtx-1.5 branch.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5336 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
Also added Tx status to status UDP message.
Added the above features to the reference UDP server
message_aggregator.
Merged from the wsjtx-1.5 branch.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5334 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
To facilitate interaction with other applications WSJT-X now sends
status updates to a predefined UDP server or multicast group
address. The status updates include the information currently posted
to the decodes.txt and wsjtx_status.txt files. An optional back
communications channel is also implemented allowing the UDP server
application to control some basic actions in WSJT-X.
A reference implementaion of a typical UDP server written in C++ using
Qt is provided to demonstrate these facilities. This application is
not intended as a user tool but only as an example of how a third
party application may interact with WSJT-X.
The UDP messages Use QDataStream based serialization. Messages are
documented in NetworkMessage.hpp along with some helper classes that
simplify the building and decoding of messages.
Two message handling classes are introduced, MessageClient and
MessageServer. WSJT-X uses the MessageClient class to manage outgoing
and incoming UDP messages that allow communication with other
applications. The MessageServer class implements the kind of code
that a potential cooperating application might use. Although these
classes use Qt serialization facilities, the message formats are
easily read and written by applications that do not use the Qt
framework.
MessageAggregator is a demonstration application that uses
MessageServer and presents a GUI that displays messages from one or
more WSJT-X instances and allows sending back a CQ or QRZ reply
invocation by double clicking a decode. This application is not
intended as a user facing tool but rather as a demonstration of the
WSJT-X UDP messaging facility. It also demonstrates being a multicast
UDP server by allowing multiple instances to run concurrently. This is
enabled by using an appropriate multicast group address as the server
address. Cooperating applications need not implement multicast
techniques but it is recomended otherwise only a single appliaction
can act as a broadcast message (from WSJT-X) recipient.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@5225 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
