diff --git a/doc/user_guide/en/images/colors.png b/doc/user_guide/en/images/colors.png index 7e8e9adcc..7c6813529 100644 Binary files a/doc/user_guide/en/images/colors.png and b/doc/user_guide/en/images/colors.png differ diff --git a/doc/user_guide/en/images/file-menu.png b/doc/user_guide/en/images/file-menu.png index e7a765fa7..4adcedc3b 100644 Binary files a/doc/user_guide/en/images/file-menu.png and b/doc/user_guide/en/images/file-menu.png differ diff --git a/doc/user_guide/en/images/help-menu.png b/doc/user_guide/en/images/help-menu.png index 91ef1b870..e4d9ab325 100644 Binary files a/doc/user_guide/en/images/help-menu.png and b/doc/user_guide/en/images/help-menu.png differ diff --git a/doc/user_guide/en/images/keyboard-shortcuts.png b/doc/user_guide/en/images/keyboard-shortcuts.png index 65ea3a96a..9249e2e08 100644 Binary files a/doc/user_guide/en/images/keyboard-shortcuts.png and b/doc/user_guide/en/images/keyboard-shortcuts.png differ diff --git a/doc/user_guide/en/images/log-qso.png b/doc/user_guide/en/images/log-qso.png index 867251bc7..4f85dc7df 100644 Binary files a/doc/user_guide/en/images/log-qso.png and b/doc/user_guide/en/images/log-qso.png differ diff --git a/doc/user_guide/en/images/misc-controls-center.png b/doc/user_guide/en/images/misc-controls-center.png index 773501a19..f2fdf64b9 100644 Binary files a/doc/user_guide/en/images/misc-controls-center.png and b/doc/user_guide/en/images/misc-controls-center.png differ diff --git a/doc/user_guide/en/images/reporting.png b/doc/user_guide/en/images/reporting.png index 2ac100df6..896b973a0 100644 Binary files a/doc/user_guide/en/images/reporting.png and b/doc/user_guide/en/images/reporting.png differ diff --git a/doc/user_guide/en/images/settings-advanced.png b/doc/user_guide/en/images/settings-advanced.png index 5a42a3cfe..2406d82e4 100644 Binary files a/doc/user_guide/en/images/settings-advanced.png and b/doc/user_guide/en/images/settings-advanced.png differ diff --git a/doc/user_guide/en/images/view-menu.png b/doc/user_guide/en/images/view-menu.png index 3387a5784..cb329215a 100644 Binary files a/doc/user_guide/en/images/view-menu.png and b/doc/user_guide/en/images/view-menu.png differ diff --git a/doc/user_guide/en/introduction.adoc b/doc/user_guide/en/introduction.adoc index 4149a48d0..fda2f7fa4 100644 --- a/doc/user_guide/en/introduction.adoc +++ b/doc/user_guide/en/introduction.adoc @@ -7,7 +7,7 @@ K1**JT**,`" while the suffix "`-X`" indicates that _WSJT-X_ started as an extended and experimental branch of the program _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*. The first five are designed for making reliable QSOs under extreme 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 messages normally carry the transmitting station’s callsign, grid 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 reports to a central database called {wsprnet} that provides a mapping facility, archival storage, and many other features. diff --git a/doc/user_guide/en/logging.adoc b/doc/user_guide/en/logging.adoc index ae657d23a..4eaec86e9 100644 --- a/doc/user_guide/en/logging.adoc +++ b/doc/user_guide/en/logging.adoc @@ -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 the DXCC entity is shown, abbreviated if necessary. Your "`worked before`" status for this callsign (according to log file -`wsjtx_log.adi`) is flagged with a single character and a change of -background color, as follows: - -[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. +`wsjtx_log.adi`) is indicated by highlighting colors, if that option +has been selected. _WSJT-X_ includes a built-in `cty.dat` file containing DXCC prefix 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 when searching for calls. +Additional features are provided for *Contest* and *Fox* logging. +(more to come, here ...) diff --git a/doc/user_guide/en/make-qso.adoc b/doc/user_guide/en/make-qso.adoc index 565c7f7c2..1a564c7c2 100644 --- a/doc/user_guide/en/make-qso.adoc +++ b/doc/user_guide/en/make-qso.adoc @@ -19,7 +19,10 @@ one callsign) followed by the transmitting station’s grid locator, a signal report, R plus a signal report, or the final acknowledgements RRR or 73. These messages are compressed and encoded in a highly 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, 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 fully automated QSOs. -=== VHF Contest Mode +=== Contest Messages -A special *NA VHF Contest* mode can be activated for FT8 and MSK144. -To use it you must activate *File | Settings | General | Enable -VHF/UHF/Microwave features* and then check the box *NA VHF Contest* on -the main window. This mode is configured especially for contests in -which four-character grid locators are the required exchange. When -*NA VHF Contest* mode is active, the standard QSO sequence looks like -this: +The new FT8 and MSK144 protocols support special messages optimized +for *NA VHF* and *EU VHF* contests. FT8 also supports messages for +*ARRL Field Day* and the *ARRL RTTY Roundup*. The decoders recognize +and decode these messages at any time. Configure the program to +automatically generate the required message types by selecting a +supported operating activity on the *Settings | Advanced* tab. Model +QSOs then proceed as follows, for each event type: + +*NA VHF Contest* CQ K1ABC FN42 - K1ABC W9XYZ EN37 + K1ABC W9XYZ EN37 W9XYZ K1ABC R FN42 - K1ABC W9XYZ RRR + K1ABC W9XYZ RRR W9XYZ K1ABC 73 -In contest circumstances K1ABC might choose to call CQ again rather -than sending 73 for his third transmission. +Either callsign (or both) may have /R appended. You can use RR73 in +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 -<> for further details. + +*EU VHF Contest* + + 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]] === Compound Callsigns -Compound callsigns such as xx/K1ABC or K1ABC/x are handled in -one of two possible ways: +*FT8 and MSK144* -.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 + W9XYZ + W9XYZ +03 + W9XYZ R-08 + PJ4/K1ABC RRR + PJ4/K1ABC 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 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 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 handled by using *Type 2* compound callsigns. In this case the diff --git a/doc/user_guide/en/new_features.adoc b/doc/user_guide/en/new_features.adoc index c947ad827..aed97945a 100644 --- a/doc/user_guide/en/new_features.adoc +++ b/doc/user_guide/en/new_features.adoc @@ -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 -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 -situations +- New FT8 and MSK144 protocols with 77-bit payloads permit these enhancements: -- Decoding improvements for JT65 mode, including _a priori_ (AP) -decoding when VHF/UHF/Microwave features are enabled +* Optimized contest messages for NA VHF, EU VHF, Field Day, RTTY Roundup -- 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 -decoding in FT8 mode +* New logging features for contesting -- 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 - 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 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 would like to contribute to the project in other ways, please make your interests known to the development team. The project's -source-code repository can be found at {devsvn}, and most -communication among the developers takes place on the email reflector -{devmail}. Bug reports and suggestions for new features, improvements -to the _WSJT-X_ User Guide, etc., may also be sent to the -{wsjt_yahoo_group} email reflector. You must join the relevant group -before posting to either email list. +source-code repository can be found at {devsvn}, and communication +among the developers takes place on the email reflector {devmail}. +Bug reports and suggestions for new features, improvements to the +_WSJT-X_ User Guide, etc., may also be sent to the {wsjt_yahoo_group} +email reflector. You must join the relevant group before posting to +either email list. diff --git a/doc/user_guide/en/settings-advanced.adoc b/doc/user_guide/en/settings-advanced.adoc index e939977ca..810075154 100644 --- a/doc/user_guide/en/settings-advanced.adoc +++ b/doc/user_guide/en/settings-advanced.adoc @@ -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 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 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}. diff --git a/doc/user_guide/en/settings-colors.adoc b/doc/user_guide/en/settings-colors.adoc index 6fc95eabb..3a67d228a 100644 --- a/doc/user_guide/en/settings-colors.adoc +++ b/doc/user_guide/en/settings-colors.adoc @@ -1,5 +1,7 @@ image::colors.png[align="center",alt="Colors Screen"] _WSJT-X_ uses colors to highlight decoded messages containing -information of particular interest. Click on one of the buttons to -select your preferred colors for any message category. +information of particular interest. Check the box to select any +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. diff --git a/doc/user_guide/en/settings-general.adoc b/doc/user_guide/en/settings-general.adoc index 0a259dd70..2825c0c80 100644 --- a/doc/user_guide/en/settings-general.adoc +++ b/doc/user_guide/en/settings-general.adoc @@ -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 the section <>. -NOTE: Enabling VHF/UHF/Microwave features necessarily disables the -wideband multi-decode capability of JT65. In most circumstances you -should turn this feature off when operating at HF. +NOTE: Checking *Enable VHF/UHF/Microwave features* necessarily +disables the wideband multi-decode capability of JT65. In most +circumstances you should turn this feature off when operating at HF. diff --git a/doc/user_guide/en/wsjtx-main.adoc b/doc/user_guide/en/wsjtx-main.adoc index 71f0e3c4a..aa4a9aa57 100644 --- a/doc/user_guide/en/wsjtx-main.adoc +++ b/doc/user_guide/en/wsjtx-main.adoc @@ -113,9 +113,12 @@ include::transceiver-setup.adoc[] This section introduces the basic user controls and program behavior 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 -tutorial, preferably while at your radio. Subsequent sections cover -additional details on <>, <> -and <>. +tutorial, preferably while at your radio. Note that as of late 2018, +digital usage on the HF bands has mostly moved from JT65 and JT9 to FT8. So +you may wish to pay particular attention to *FT8*, in Section 6.6. + +Subsequent sections cover additional details on <>, <> and <>. [[TUT_MAIN]] === Main Window Settings