Updates to User Guide for v2.0. Mostly done up through Section 11.

This commit is contained in:
Joe Taylor 2018-12-04 14:34:08 -05:00
parent 007e75c85e
commit e9aebea074
17 changed files with 132 additions and 63 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 8.9 KiB

After

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.3 KiB

After

Width:  |  Height:  |  Size: 7.4 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 5.5 KiB

After

Width:  |  Height:  |  Size: 7.2 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 9.9 KiB

After

Width:  |  Height:  |  Size: 9.4 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.2 KiB

After

Width:  |  Height:  |  Size: 6.7 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 16 KiB

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.4 KiB

After

Width:  |  Height:  |  Size: 4.3 KiB

View File

@ -7,7 +7,7 @@ K1**JT**,`" while the suffix "`-X`" indicates that _WSJT-X_ started as
an extended and experimental branch of the program an extended and experimental branch of the program
_WSJT_. _WSJT_.
_WSJT-X_ Version 1.9 offers nine different protocols or modes: *FT8*, _WSJT-X_ Version 2.0 offers nine different protocols or modes: *FT8*,
*JT4*, *JT9*, *JT65*, *QRA64*, *ISCAT*, *MSK144*, *WSPR*, and *Echo*. *JT4*, *JT9*, *JT65*, *QRA64*, *ISCAT*, *MSK144*, *WSPR*, and *Echo*.
The first five are designed for making reliable QSOs under extreme The first five are designed for making reliable QSOs under extreme
weak-signal conditions. They use nearly identical message structure weak-signal conditions. They use nearly identical message structure
@ -47,7 +47,7 @@ format with hashed callsigns.
potential propagation paths using low-power transmissions. WSPR potential propagation paths using low-power transmissions. WSPR
messages normally carry the transmitting stations callsign, grid messages normally carry the transmitting stations callsign, grid
locator, and transmitter power in dBm, and they can be decoded at locator, and transmitter power in dBm, and they can be decoded at
signal-to-noise ratios as low as -28 dB in a 2500 Hz bandwidth. WSPR signal-to-noise ratios as low as -31 dB in a 2500 Hz bandwidth. WSPR
users with internet access can automatically upload reception users with internet access can automatically upload reception
reports to a central database called {wsprnet} that provides a mapping reports to a central database called {wsprnet} that provides a mapping
facility, archival storage, and many other features. facility, archival storage, and many other features.

View File

@ -18,17 +18,8 @@ this option is checked _WSJT-X_ appends some additional information to
all CQ messages displayed in the _Band Activity_ window. The name of all CQ messages displayed in the _Band Activity_ window. The name of
the DXCC entity is shown, abbreviated if necessary. Your "`worked the DXCC entity is shown, abbreviated if necessary. Your "`worked
before`" status for this callsign (according to log file before`" status for this callsign (according to log file
`wsjtx_log.adi`) is flagged with a single character and a change of `wsjtx_log.adi`) is indicated by highlighting colors, if that option
background color, as follows: has been selected.
[horizontal]
!:: Default color bright purple: New DXCC entity
~:: Light pink: You have already worked this DXCC entity but not
this station
:: Green: You have previously worked the calling station
In this respect the program does not distinguish between modes, but it
does differentiate between bands.
_WSJT-X_ includes a built-in `cty.dat` file containing DXCC prefix _WSJT-X_ includes a built-in `cty.dat` file containing DXCC prefix
information. Updated files can be downloaded from the {cty_dat} web information. Updated files can be downloaded from the {cty_dat} web
@ -45,3 +36,5 @@ before status* off and then on again will cause _WSJT-X_ to re-read
the log file. Very large log files may cause _WSJT-X_ to slow down the log file. Very large log files may cause _WSJT-X_ to slow down
when searching for calls. when searching for calls.
Additional features are provided for *Contest* and *Fox* logging.
(more to come, here ...)

View File

@ -19,7 +19,10 @@ one callsign) followed by the transmitting stations grid locator, a
signal report, R plus a signal report, or the final acknowledgements signal report, R plus a signal report, or the final acknowledgements
RRR or 73. These messages are compressed and encoded in a highly RRR or 73. These messages are compressed and encoded in a highly
efficient and reliable way. In uncompressed form (as displayed efficient and reliable way. In uncompressed form (as displayed
on-screen) they may contain as many as 22 characters. on-screen) they may contain as many as 22 characters. Some operators
prefer ro send RR73 rather than RRR. This is workable because RR73 is
encoded as a valid grid locator, one unlikely ever to be occupied by
an amateur station.
*Signal reports* are specified as signal-to-noise ratio (S/N) in dB, *Signal reports* are specified as signal-to-noise ratio (S/N) in dB,
using a standard reference noise bandwidth of 2500 Hz. Thus, in the using a standard reference noise bandwidth of 2500 Hz. Thus, in the
@ -76,36 +79,92 @@ NOTE: When *Auto-Seq* is enabled the program de-activates *Enable Tx*
at the end of each QSO. It is not intended that _WSJT-X_ should make at the end of each QSO. It is not intended that _WSJT-X_ should make
fully automated QSOs. fully automated QSOs.
=== VHF Contest Mode === Contest Messages
A special *NA VHF Contest* mode can be activated for FT8 and MSK144. The new FT8 and MSK144 protocols support special messages optimized
To use it you must activate *File | Settings | General | Enable for *NA VHF* and *EU VHF* contests. FT8 also supports messages for
VHF/UHF/Microwave features* and then check the box *NA VHF Contest* on *ARRL Field Day* and the *ARRL RTTY Roundup*. The decoders recognize
the main window. This mode is configured especially for contests in and decode these messages at any time. Configure the program to
which four-character grid locators are the required exchange. When automatically generate the required message types by selecting a
*NA VHF Contest* mode is active, the standard QSO sequence looks like supported operating activity on the *Settings | Advanced* tab. Model
this: QSOs then proceed as follows, for each event type:
*NA VHF Contest*
CQ K1ABC FN42 CQ K1ABC FN42
K1ABC W9XYZ EN37 K1ABC W9XYZ EN37
W9XYZ K1ABC R FN42 W9XYZ K1ABC R FN42
K1ABC W9XYZ RRR K1ABC W9XYZ RRR
W9XYZ K1ABC 73 W9XYZ K1ABC 73
In contest circumstances K1ABC might choose to call CQ again rather Either callsign (or both) may have /R appended. You can use RR73 in
than sending 73 for his third transmission. place of RRR, and the final 73 is optional.
IMPORTANT: Do not use VHF Contest Mode on an HF band or in conditions
where worldwide propagation is available. See *EU VHF Contest*
<<PROTOCOL_OVERVIEW,Protocol Specifications>> for further details.
CQ TEST G4ABC IO91
G4ABC PA9XYZ JO22
PA9XYZ 570123 IO91NP
G4ABC R 580071 JO22DB
PA9XYZ G4ABC RR73
Either callsign (or both) may have /P appended.
*ARRL Field Day*
CQ FD K1ABC FN42
K1ABC W9XYZ 6A WI
W9XYZ K1ABC R 2B EMA
K1ABC W9XYZ RR73
*ARRL RTTY Roundup*
CQ RU K1ABC FN42
K1ABC W9XYZ 579 WI
W9XYZ K1ABC R 589 MA
K1ABC W9XYZ RR73
[[COMP-CALL]] [[COMP-CALL]]
=== Compound Callsigns === Compound Callsigns
Compound callsigns such as xx/K1ABC or K1ABC/x are handled in *FT8 and MSK144*
one of two possible ways:
.Messages containing Type 1 compound callsigns Compound callsigns like xx/K1ABC or K1ABC/x and nonstandard callsigns
like YW18FIFA are supported for normal QSOs but not for the special
contest-style messages. Model QSOs look something like this:
CQ PJ4/K1ABC
<PJ4/K1ABC> W9XYZ
W9XYZ <PJ4/K1ABC> +03
<PJ4/K1ABC> W9XYZ R-08
<W9XYZ> PJ4/K1ABC RRR
PJ4/K1ABC <W9XYZ> 73
The compound or nonstandard callsigns are automatically recognized and
handled using special message formats. One such callsign and one
standard callsign may appear in most messages, provided that one of
them is enclosed in < > angle brackets. If the message includes a
grid locator or numerical signal report, the brackets must enclose the
compound or nonstandard callsign; otherwise the brackets may be around
either call.
Angle brackets imply that the enclosed callsign is not transmitted in
full, but rather as a hash code using a smaller number of bits.
Receiving stations will display the full nonstandard callsign if it
has been received in full in the recent past. Otherwise it will be
displayed as < . . . >. These restrictions are honored automatically
by the algorithm that generates default messages for minimal QSOs.
Except for the special cases involving /P or /R used in VHF
contesting, _WSJT-X 2.0_ offers no support for two nonstandard
callsigns to work each other.
*JT4, JT9, JT65, and QRA64*
In the 72-bit modes, compound callsigns are handled in one of two
possible ways:
.Type 1 compound callsigns
A list of about 350 of the most common prefixes and suffixes can be A list of about 350 of the most common prefixes and suffixes can be
displayed from the *Help* menu. A single compound callsign involving displayed from the *Help* menu. A single compound callsign involving
@ -139,7 +198,7 @@ Notice that the full compound callsign is sent and received in the
first two transmissions. After that, the operators omit the add-on first two transmissions. After that, the operators omit the add-on
prefix or suffix and use the standard structured messages. prefix or suffix and use the standard structured messages.
.Type 2 Compound-Callsign Messages .Type 2 Compound callsigns
Prefixes and suffixes _not_ found in the displayable short list are Prefixes and suffixes _not_ found in the displayable short list are
handled by using *Type 2* compound callsigns. In this case the handled by using *Type 2* compound callsigns. In this case the

View File

@ -1,33 +1,38 @@
=== New in Version 1.9 === New in Version 2.0
For quick reference, here's a short list of features and capabilities For quick reference, here's a short list of features and capabilities
added to _WSJT-X_ since Version 1.8.0: added to _WSJT-X_ since Version 1.9.1:
- New *FT8 DXpedition Mode* to facilitate high QSO rates in pileup - New FT8 and MSK144 protocols with 77-bit payloads permit these enhancements:
situations
- Decoding improvements for JT65 mode, including _a priori_ (AP) * Optimized contest messages for NA VHF, EU VHF, Field Day, RTTY Roundup
decoding when VHF/UHF/Microwave features are enabled
- Optional Auto-Sequencing in JT4, JT9, and JT65 when VHF/UHF/Microwave features are enabled * Full support for "/R" and "/P" calls in relevant contests
- Better suppression of low-confidence false decodes generated by AP * New logging features for contesting
decoding in FT8 mode
- Improved decoding performance for WSPR mode, especially effective at LF and MF * Integration with N1MM+ and WriteLog for contesting
- Minor adjustments to auto-sequencing behavior * IMproved support for compound and nonstandard callsigns
- More flexible Doppler control features for EME * Nearly equal (or better) sensitivity compared to old protocols
- Improved waterfall sensitivity for very weak signals * Lower false decode rates
- Automatic real-time forwarding of logged information to _N1MM Logger+_ - Improved color highlighting of received messages
- Improved WSPR sensitivity
- Expanded and improved UDP messages sent to companion programs - Expanded and improved UDP messages sent to companion programs
- Bug fixes and other minor tweaks to user interface - Bug fixes and other minor tweaks to user interface
IMPORTANT: Note that for FT8 and MSK144 there is no backward
compatibility with WSJT-X 1.9.1 and earlier. Everyone using these
modes should upgrade to WSJT-X 2.0 by January 1, 2019.
=== Documentation Conventions === Documentation Conventions
In this manual the following icons call attention to particular types In this manual the following icons call attention to particular types
@ -48,9 +53,9 @@ _WSJT-X_ is part of an open-source project released under the
{gnu_gpl} (GPL). If you have programming or documentation skills or {gnu_gpl} (GPL). If you have programming or documentation skills or
would like to contribute to the project in other ways, please make would like to contribute to the project in other ways, please make
your interests known to the development team. The project's your interests known to the development team. The project's
source-code repository can be found at {devsvn}, and most source-code repository can be found at {devsvn}, and communication
communication among the developers takes place on the email reflector among the developers takes place on the email reflector {devmail}.
{devmail}. Bug reports and suggestions for new features, improvements Bug reports and suggestions for new features, improvements to the
to the _WSJT-X_ User Guide, etc., may also be sent to the _WSJT-X_ User Guide, etc., may also be sent to the {wsjt_yahoo_group}
{wsjt_yahoo_group} email reflector. You must join the relevant group email reflector. You must join the relevant group before posting to
before posting to either email list. either email list.

View File

@ -36,9 +36,16 @@ with twice or four times the normal tone spacing. This feature is
intended for use with specialized LF/MF transmitters that divide intended for use with specialized LF/MF transmitters that divide
generated frequencies by 2 or 4 as part of the transmission process. generated frequencies by 2 or 4 as part of the transmission process.
_FT8 DXpedition Mode_ _Special Operating Activity: Generation of FT8 and MSk144 messages_
- Check this box and select the type of activity to enable
auto-generation of special message formats for contesting and
DXpeditions. For *ARRL Field Day*, enter your operating Class and
ARRL/RAC section; for *ARRL RTTY Roundup*, enter your state or province.
Use “DX” for section or state if you are not in the US or Canada. In
the RTTY Roundup, Stations in Alaska and Hawaii should enter “DX”.
- Check *Fox* if you are a DXpedition station operating in FT8 - Check *Fox* if you are a DXpedition station operating in FT8
DXpedition Mode. Check *Hound* if you wish to make QSOs with such a DXpedition Mode. Check *Hound* if you wish to make QSOs with such a
Fox. Be sure to read the operating instructions for {ft8_DXped}. Fox. Be sure to read the operating instructions for {ft8_DXped}.

View File

@ -1,5 +1,7 @@
image::colors.png[align="center",alt="Colors Screen"] image::colors.png[align="center",alt="Colors Screen"]
_WSJT-X_ uses colors to highlight decoded messages containing _WSJT-X_ uses colors to highlight decoded messages containing
information of particular interest. Click on one of the buttons to information of particular interest. Check the box to select any
select your preferred colors for any message category. that interest you. Drag any line up or down to raise or lower
its logical priority. Right-click any line to select a new
foreground or background color.

View File

@ -17,6 +17,6 @@ NOTE: If you are using a callsign with an add-on prefix or
suffix, or wish to work a station using such a call, be sure to read suffix, or wish to work a station using such a call, be sure to read
the section <<COMP-CALL,Compound Callsigns>>. the section <<COMP-CALL,Compound Callsigns>>.
NOTE: Enabling VHF/UHF/Microwave features necessarily disables the NOTE: Checking *Enable VHF/UHF/Microwave features* necessarily
wideband multi-decode capability of JT65. In most circumstances you disables the wideband multi-decode capability of JT65. In most
should turn this feature off when operating at HF. circumstances you should turn this feature off when operating at HF.

View File

@ -113,9 +113,12 @@ include::transceiver-setup.adoc[]
This section introduces the basic user controls and program behavior This section introduces the basic user controls and program behavior
of _WSJT-X_, with particular emphasis on the JT9, JT65, and FT8 modes. of _WSJT-X_, with particular emphasis on the JT9, JT65, and FT8 modes.
We suggest that new users should go through the full HF-oriented We suggest that new users should go through the full HF-oriented
tutorial, preferably while at your radio. Subsequent sections cover tutorial, preferably while at your radio. Note that as of late 2018,
additional details on <<MAKE_QSOS,Making QSOs>>, <<WSPR,WSPR mode>> digital usage on the HF bands has mostly moved from JT65 and JT9 to FT8. So
and <<VHF_AND_UP,VHF+ Features>>. you may wish to pay particular attention to *FT8*, in Section 6.6.
Subsequent sections cover additional details on <<MAKE_QSOS,Making
QSOs>>, <<WSPR,WSPR mode>> and <<VHF_AND_UP,VHF+ Features>>.
[[TUT_MAIN]] [[TUT_MAIN]]
=== Main Window Settings === Main Window Settings