From 598835d9c9660fbe62fbd939c533977ca47303a6 Mon Sep 17 00:00:00 2001 From: Joe Taylor Date: Wed, 23 Sep 2020 15:03:33 -0400 Subject: [PATCH] First cut at adding FST4, FST4W to the User Guide. --- doc/CMakeLists.txt | 8 +- doc/user_guide/en/images/FST4W_RoundRobin.png | Bin 0 -> 4777 bytes .../en/images/FST4_Decoding_Limits.png | Bin 0 -> 15426 bytes doc/user_guide/en/images/FST4_center.png | Bin 0 -> 4020 bytes doc/user_guide/en/intro_subsections.adoc | 40 ++++++ doc/user_guide/en/introduction.adoc | 93 +++++++------ doc/user_guide/en/new_features.adoc | 130 ++++-------------- doc/user_guide/en/protocols.adoc | 58 ++++++-- doc/user_guide/en/tutorial-example5.adoc | 24 ++++ doc/user_guide/en/tutorial-example6.adoc | 16 +++ doc/user_guide/en/wsjtx-main.adoc | 11 ++ 11 files changed, 222 insertions(+), 158 deletions(-) create mode 100644 doc/user_guide/en/images/FST4W_RoundRobin.png create mode 100644 doc/user_guide/en/images/FST4_Decoding_Limits.png create mode 100644 doc/user_guide/en/images/FST4_center.png create mode 100644 doc/user_guide/en/intro_subsections.adoc create mode 100644 doc/user_guide/en/tutorial-example5.adoc create mode 100644 doc/user_guide/en/tutorial-example6.adoc diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index 91b4d9875..9b48ced82 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -30,8 +30,7 @@ set (UG_SRCS install-mac.adoc install-windows.adoc introduction.adoc - measurement_tools.adoc - protocols.adoc + intro_subsections.adoc logging.adoc make-qso.adoc measurement_tools.adoc @@ -53,6 +52,8 @@ set (UG_SRCS tutorial-example2.adoc tutorial-example3.adoc tutorial-example4.adoc + tutorial-example5.adoc + tutorial-example6.adoc tutorial-main-window.adoc tutorial-wide-graph-settings.adoc utilities.adoc @@ -82,6 +83,9 @@ set (UG_IMGS images/FreqCal_Graph.png images/FreqCal_Results.png images/freemsg.png + images/FST4_center.png + images/FST4_Decoding_Limits.png + images/FST4W_RoundRobin.png images/ft4_decodes.png images/ft4_waterfall.png images/ft8_decodes.png diff --git a/doc/user_guide/en/images/FST4W_RoundRobin.png b/doc/user_guide/en/images/FST4W_RoundRobin.png new file mode 100644 index 0000000000000000000000000000000000000000..74d17b0078f2c96573c5d032b81c0ab7458b9d0a GIT binary patch literal 4777 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 TuJ^Zu0RU-n1+fZI1ONX8U8Y|g literal 0 HcmV?d00001 diff --git a/doc/user_guide/en/images/FST4_center.png b/doc/user_guide/en/images/FST4_center.png new file mode 100644 index 0000000000000000000000000000000000000000..b66aa18545cb266c678b1d19fd67d2eca7c1aa15 GIT binary patch literal 4020 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 literal 0 HcmV?d00001 diff --git a/doc/user_guide/en/intro_subsections.adoc b/doc/user_guide/en/intro_subsections.adoc new file mode 100644 index 000000000..242d54e54 --- /dev/null +++ b/doc/user_guide/en/intro_subsections.adoc @@ -0,0 +1,40 @@ +=== Documentation Conventions + +In this manual the following icons call attention to particular types +of information: + +NOTE: *Notes* containing information that may be of interest to +particular classes of users. + +TIP: *Tips* on program features or capabilities that might otherwise be +overlooked. + +IMPORTANT: *Warnings* about usage that could lead to undesired +consequences. + +=== User Interface in Other Languages + +The _WSJT-X_ user interface is now available in many languages. When +a translated user interface is available for the computer's default +System Language, it will appear automatically on program startup. + +=== How You Can Contribute + +_WSJT-X_ is part of an open-source project released under the +{gnu_gpl} (GPLv3). 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. We especially encourage +those with translation skills to volunteer their help, either for +this _User Guide_ or for the program's user interface. + +The project's source-code repository can be found at {devrepo}, 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 be sent there as well. You must +join the group before posting to the email list. + + +=== License + +Before using _WSJT-X_, please read our licensing terms +<>. diff --git a/doc/user_guide/en/introduction.adoc b/doc/user_guide/en/introduction.adoc index f172b5d35..5dfd2fb8f 100644 --- a/doc/user_guide/en/introduction.adoc +++ b/doc/user_guide/en/introduction.adoc @@ -3,42 +3,39 @@ _WSJT-X_ is a computer program designed to facilitate basic amateur radio communication using very weak signals. The first four letters in the program name stand for "`**W**eak **S**ignal communication by -K1**JT**,`" while the suffix "`-X`" indicates that _WSJT-X_ started as -an extended and experimental branch of the program _WSJT_, -first released in 2001. Bill Somerville, G4WJS, and Steve Franke, -K9AN, have been major contributors to program development since 2013 -and 2015, respectively. +K1**JT**,`" while the suffix "`*-X*`" indicates that _WSJT-X_ started +as an extended branch of an earlier program, _WSJT_, first released in +2001. Bill Somerville, G4WJS, and Steve Franke, K9AN, have been major +contributors to development of _WSJT-X_ since 2013 and 2015, respectively. -_WSJT-X_ Version {VERSION_MAJOR}.{VERSION_MINOR} offers ten different -protocols or modes: *FT4*, *FT8*, *JT4*, *JT9*, *JT65*, *QRA64*, -*ISCAT*, *MSK144*, *WSPR*, and *Echo*. The first six are designed for -making reliable QSOs under weak-signal conditions. They use nearly -identical message structure and source encoding. JT65 and QRA64 were -designed for EME ("`moonbounce`") on the VHF/UHF bands and have also -proven very effective for worldwide QRP communication on the HF bands. -QRA64 has some advantages over JT65, including better performance -for EME on the higher microwave bands. JT9 was originally designed -for the LF, MF, and lower HF bands. Its submode JT9A is 2 dB more -sensitive than JT65 while using less than 10% of the bandwidth. JT4 -offers a wide variety of tone spacings and has proven highly effective -for EME on microwave bands up to 24 GHz. These four "`slow`" modes -use one-minute timed sequences of alternating transmission and -reception, so a minimal QSO takes four to six minutes — two or three -transmissions by each station, one sending in odd UTC minutes and the -other even. FT8 is operationally similar but four times faster -(15-second T/R sequences) and less sensitive by a few dB. FT4 is -faster still (7.5 s T/R sequences) and especially well-suited for -radio contesting. On the HF bands, world-wide QSOs are possible with -any of these modes using power levels of a few watts (or even -milliwatts) and compromise antennas. On VHF bands and higher, QSOs -are possible (by EME and other propagation types) at signal levels 10 -to 15 dB below those required for CW. - -Note that even though their T/R sequences are short, FT4 and FT8 are -classified as slow modes because their message frames are sent only -once per transmission. All fast modes in _WSJT-X_ send their message -frames repeatedly, as many times as will fit into the Tx sequence -length. +_WSJT-X_ Version {VERSION_MAJOR}.{VERSION_MINOR} offers twelve +different protocols or modes: *FST4*, *FT4*, *FT8*, *JT4*, *JT9*, +*JT65*, *QRA64*, *ISCAT*, *MSK144*, *WSPR*, *FST4W*, and *Echo*. The +first seven are designed for making reliable QSOs under weak-signal +conditions. They use nearly identical message structure and source +encoding. JT65 and QRA64 were designed for EME ("`moonbounce`") on +the VHF/UHF bands and have also proven very effective for worldwide +QRP communication on the HF bands. QRA64 has some advantages over +JT65, including better performance for EME on the higher microwave +bands. JT9 was originally designed for the HF and lower +bands. Its submode JT9A is nearly 2 dB more sensitive than JT65 while using +less than 10% of the bandwidth. JT4 offers a wide variety of tone +spacings and has proven highly effective for EME on microwave bands up +to 24 GHz. These four "`slow`" modes use one-minute timed sequences +of alternating transmission and reception, so a minimal QSO takes four +to six minutes — two or three transmissions by each station, one +sending in odd UTC minutes and the other even. FT8 is operationally +similar but four times faster (15-second T/R sequences) and less +sensitive by a few dB. FT4 is faster still (7.5 s T/R sequences) and +especially well-suited for radio contesting. FST4 was added to +_WSJT-X_ in version 2.3.0. It is intended especially for use on the +LF and MF bands; further details can be found in the following +section, <>. +On the HF bands, world-wide QSOs are possible with any of these modes +using power levels of a few watts (or even milliwatts) and compromise +antennas. On VHF bands and higher, QSOs are possible (by EME and +other propagation types) at signal levels 10 to 15 dB below those +required for CW. *ISCAT*, *MSK144*, and optionally submodes *JT9E-H* are "`fast`" protocols designed to take advantage of brief signal enhancements from @@ -51,15 +48,25 @@ messages up to 28 characters long, while MSK144 uses the same structured messages as the slow modes and optionally an abbreviated format with hashed callsigns. +Note that some of the modes classified as slow can have T/R sequence +lengths as short the fast modes. "`Slow`" in this sense implies +message frames being sent only once per transmission. The fast modes +in _WSJT-X_ send their message frames repeatedly, as many times as +will fit into the Tx sequence length. + *WSPR* (pronounced "`whisper`") stands for **W**eak **S**ignal -**P**ropagation **R**eporter. The WSPR protocol was designed for probing -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 -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. +**P**ropagation **R**eporter. The WSPR protocol was designed for +probing potential propagation paths using low-power transmissions. +WSPR messages normally carry the transmitting station’s callsign, +grid locator, and transmitter power in dBm, and with two-minute +sequences they can be decoded at signal-to-noise ratios as low +as -31 dB in a 2500 Hz bandwidth. *FST4W* is designed for +similar purposes, but especially for use on LF and MF bands. +It includes optional sequence lengths as long as 30 minutes and +reaches sensitivity tresholds as low as -45 dB. WSPR and FST4W 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. *Echo* mode allows you to detect and measure your own station's echoes from the moon, even if they are far below the audible threshold. diff --git a/doc/user_guide/en/new_features.adoc b/doc/user_guide/en/new_features.adoc index c653379f1..53740bdaf 100644 --- a/doc/user_guide/en/new_features.adoc +++ b/doc/user_guide/en/new_features.adoc @@ -1,107 +1,31 @@ +[[NEW_FEATURES]] === New in Version {VERSION} -*Improvements to decoders* +_WSJT-X 2.3.0_ introduces *FST4* and *FST4W*, new digital protocols +designed particularly for the LF and MF bands. On these bands their +fundamental sensitivities are better than other _WSJT-X_ modes with the +same sequence lengths, approaching the theoretical limits for their +rates of information throughput. FST4 is optimized for two-way QSOs, +while FST4W is for quasi-beacon transmissions of WSPR-style messages. +FST4 and FST4W do not require the strict, independent time +synchronization and phase locking of modes like EbNaut. -*FT4:* Corrected bugs that prevented AP (_a priori_) decoding and/or -multi-pass decoding in some circumstances. Improved and extended the -algorithm for AP decoding. +The new modes use 4-GFSK modulation and share common software for +encoding and decoding messages. FST4 offers T/R sequence lengths of +15, 30, 60, 120, 300, 900, and 1800 seconds, while FST4W omits the +lengths shorter than 120 s. Submodes are given names like FST4-60, +FST4W-300, etc., the appended numbers indicating sequence length in +seconds. Message payloads contain either 77 bits, as in FT4, FT8, and +MSK144, or 50 bits for the WSPR-like messages of FST4W. Message +formats displayed to the user are like those in the other 77-bit and +50-bit modes in _WSJT-X_. Forward error correction uses a low density +parity check (LDPC) code with 240 information and parity bits. +Transmissions consist of 160 symbols: 120 information-carrying symbols +of two bits each, interspersed with five groups of eight predefined +synchronization symbols. -*FT8:* Decoding is now spread over three intervals. The first starts -11.8 s into an Rx sequence and typically yields around 85% of the -possible decodes, so you see most decodes much earlier than before. A -second processing step starts at 13.5 s, and the final one at 14.7 s. -Overall decoding yield on crowded bands is improved by 10% or more. -Systems with receive latency greater than 0.2 s will see smaller -improvements, but will still see many decodes earlier than before. - -SNR estimates no longer saturate at +20 dB, and large signals in the -passband no longer cause the SNR of weaker signals to be biased low. -Times written to cumulative journal file ALL.TXT are now correct even -when the decode occurs after the T/R sequence boundary. In FT8 -DXpedition Mode, AP decoding is now implemented for Hounds when the -Fox has a compound callsign. - - -*JT4:* Formatting and display of averaged and Deep Search decodes has -been cleaned up and made consistent with other modes used for EME and -extreme weak-signal work on microwave bands. - -*JT65:* Many improvements have been made for averaged and Deep Search -decodes, and their display to the user. For details see <> -in the <> section of this guide. - -*WSPR:* Significant improvements have been made to the WSPR decoder's -sensitivity, its ability to cope with many signals in a crowded -sub-band, and its rate of undetected false decodes. We now use up to -three decoding passes. Passes 1 and 2 use noncoherent demodulation of -single symbols and allow for frequency drifts up to ±4 Hz in a -transmission. Pass 3 assumes no drift and does coherent block -detection of up to three symbols. It also applies bit-by-bit -normalization of the single-symbol bit metrics, a technique that has -proven helpful for signals corrupted by artifacts of the subtraction -of stronger signals and also for LF/MF signals heavily contaminated by -lightning transients. With these improvements the number of decodes -in a crowded WSPR sub-band typically increases by 10 to 15%. - -*New message format:* When *EU VHF Contest* is selected, the Tx2 and -Tx3 messages -- those conveying signal report, serial number, and -6-character locator -- now use hashcodes for both callsigns. This -change is *not* backward compatible with earlier versions of _WSJT-X_, so -all users of *EU VHF Contest* messages should be sure to upgrade to -version 2.2.0. See <> for details. - -*Minor enhancements and bug fixes* - -- *Save None* now writes no .wav files to disk, even temporarily. - -- An explicit entry for *WW Digi Contest* has been added to *Special - operating activities* on the *Settings | Advanced* tab. - -- The contest mode FT4 now always uses RR73 for the Tx4 message. - -- *Keyboard shortcuts* have been added as an aid to accessibility: -*Alt+R* sets Tx4 message to RR73, *Ctrl+R* sets it to RRR. - -- The *Status bar* now displays the number of decodes found in the -most recent Rx sequence. - -- As an aid for partial color-blindness, the "`inverted goal posts`" -marking Rx frequency on the Wide Graph's frequency scale are now in a -darker shade of green. - -=== Documentation Conventions - -In this manual the following icons call attention to particular types -of information: - -NOTE: *Notes* containing information that may be of interest to -particular classes of users. - -TIP: *Tips* on program features or capabilities that might otherwise be -overlooked. - -IMPORTANT: *Warnings* about usage that could lead to undesired -consequences. - -=== User Interface in Other Languages - -Thanks to Xavi Perez, EA3W, in cooperation with G4WJS, the _WSJT-X_ -user interface is now available the Catalan language. Spanish will -follow soon, and other languages when translations are made. When a -translated user interface is available for the computer's default -System Language, it will appear automatically on program startup. - -=== How You Can Contribute - -_WSJT-X_ is part of an open-source project released under the -{gnu_gpl} (GPLv3). 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. We especially encourage -those with translation skills to volunteer their help, either for -this _User Guide_ or for the program's user interface. - -The project's source-code repository can be found at {devrepo}, 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 be sent there as well. You must -join the group before posting to the email list. +*We recommend that on the 2200 and 630 m bands FST4 should replace JT9 +for making 2-way QSOs, and FST4W should replace WSPR for propagation +tests*. Operating conventions on these LF and MF bands will +eventually determine the most useful T/R sequence lengths for each +type of operation. diff --git a/doc/user_guide/en/protocols.adoc b/doc/user_guide/en/protocols.adoc index e22911266..baa91bcd3 100644 --- a/doc/user_guide/en/protocols.adoc +++ b/doc/user_guide/en/protocols.adoc @@ -14,7 +14,7 @@ Special cases allow other information such as add-on callsign prefixes aim is to compress the most common messages used for minimally valid QSOs into a fixed 72-bit length. -The information payload for FT4, FT8, and MSK144 contains 77 bits. +The information payloads for FST4, FT4, FT8, and MSK144 contain 77 bits. The 5 new bits added to the original 72 are used to flag special message types signifying special message types used for FT8 DXpedition Mode, contesting, nonstandard callsigns, and a few other @@ -54,7 +54,7 @@ were the callsigns `E9AA` through `E9ZZ`. Upon reception they are converted back to the form `CQ AA` through `CQ ZZ`, for display to the user. -The FT4, FT8, and MSK144 protocols use different lossless compression +The FST4, FT4, FT8, and MSK144 protocols use different lossless compression algorithms with features that generate and recognize special messages used for contesting and other special purposes. Full details have been published in QEX, see {ft4_ft8_protocols}. @@ -71,6 +71,21 @@ _WSJT-X_ modes have continuous phase and constant envelope. [[SLOW_MODES]] === Slow Modes +[[FST4PRO]] +==== FST4 + +FST4 offers T/R sequence lengths of 15, 30, 60, 120, 300, 900, and +1800 seconds. Submodes are given names like FST4-60, FST4-120, etc., +the appended numbers indicating sequence length in seconds. Message +payloads contain 77 bits, and a 24-bit cyclic redundancy check (CRC) +appended to create a 101-bit message-plus-CRC word. Forward error +correction is accomplished using a (240,101) LDPC code. Transmissions +consist of 160 symbols: 120 information-carrying symbols of two bits +each, interspersed with five groups of eight predefined +synchronization symbols. Modulation uses 4-tone frequency-shift +keying (4-GFSK) with Gaussian smoothing of frequency transitions. + + [[FT4PRO]] ==== FT4 @@ -225,6 +240,20 @@ information the least significant. Thus, on a 0 – 3 scale, the tone for a given symbol is twice the value (0 or 1) of the data bit, plus the sync bit. +[[FST4WPRO]] +==== FST4W + +FST4W offers T/R sequence lengths of 120, 300, 900, and 1800 seconds. +Submodes are given names like FST4W-120, FST4W-300, etc., the appended +numbers indicating sequence length in seconds. Message payloads +contain 50 bits, and a 24-bit cyclic redundancy check (CRC) appended +to create a 74-bit message-plus-CRC word. Forward error correction +is accomplished using a (240,74) LDPC code. Transmissions consist of +160 symbols: 120 information-carrying symbols of two bits each, +interspersed with five groups of eight predefined synchronization +symbols. Modulation uses 4-tone frequency-shift keying (4-GFSK) with +Gaussian smoothing of frequency transitions. + [[SLOW_SUMMARY]] ==== Summary @@ -239,17 +268,28 @@ which the probability of decoding is 50% or higher. [[SLOW_TAB]] .Parameters of Slow Modes -[width="90%",cols="3h,^3,^2,^1,^2,^2,^2,^2,^2,^2",frame=topbot,options="header"] +[width="100%",cols="3h,^3,^2,^1,^2,^2,^2,^2,^2,^2",frame=topbot,options="header"] |=============================================================================== |Mode |FEC Type |(n,k) | Q|Modulation type|Keying rate (Baud)|Bandwidth (Hz) |Sync Energy|Tx Duration (s)|S/N Threshold (dB) -|FT4 |LDPC, r=1/2|(174,91)| 4| 4-GFSK| 20.8333 | 83.3 | 0.15| 5.04 | -17.5 -|FT8 |LDPC, r=1/2|(174,91)| 8| 8-GFSK| 6.25 | 50.0 | 0.27| 12.6 | -21 +|FST4-15 |LDPC | (240,101)| 4| 4-GFSK| 16.6667 | 67.7 | 0.25| 9.60 | -20.7 +|FST4-30 |LDPC | (240,101)| 4| 4-GFSK| 7.14 | 28.6 | 0.25| 22.4 | -24.2 +|FST4-60 |LDPC | (240,101)| 4| 4-GFSK| 3.09 | 12.4 | 0.25| 51.8 | -28.1 +|FST4-120 |LDPC | (240,101)| 4| 4-GFSK| 1.46 | 5.9 | 0.25| 109.3 | -31.3 +|FST4-300 |LDPC | (240,101)| 4| 4-GFSK| 0.56 | 2.2 | 0.25| 286.7 | -35.3 +|FST4-900 |LDPC | (240,101)| 4| 4-GFSK| 0.180 | 0.72 | 0.25| 887.5 | -40.2 +|FST4-1800 |LDPC | (240,101)| 4| 4-GFSK| 0.089 | 0.36 | 0.25| 1792.0| -43.2 +|FT4 |LDPC |(174,91)| 4| 4-GFSK| 20.8333 | 83.3 | 0.15| 5.04 | -17.5 +|FT8 |LDPC |(174,91)| 8| 8-GFSK| 6.25 | 50.0 | 0.27| 12.6 | -21 |JT4A |K=32, r=1/2|(206,72)| 2| 4-FSK| 4.375| 17.5 | 0.50| 47.1 | -23 -|JT9A |K=32, r=1/2|(206,72)| 8| 9-FSK| 1.736| 15.6 | 0.19| 49.0 | -27 +|JT9A |K=32, r=1/2|(206,72)| 8| 9-FSK| 1.736| 15.6 | 0.19| 49.0 | -26 |JT65A |Reed Solomon|(63,12) |64|65-FSK| 2.692| 177.6 | 0.50| 46.8 | -25 |QRA64A|Q-ary Repeat Accumulate|(63,12) |64|64-FSK|1.736|111.1|0.25|48.4| -26 | WSPR |K=32, r=1/2|(162,50)| 2| 4-FSK| 1.465| 5.9 | 0.50|110.6 | -31 +|FST4W-120 |LDPC | (240,74)| 4| 4-GFSK| 1.46 | 5.9 | 0.25| 109.3 | -32.8 +|FST4W-300 |LDPC | (240,74)| 4| 4-GFSK| 0.56 | 2.2 | 0.25| 286.7 | -36.8 +|FST4W-900 |LDPC | (240,74)| 4| 4-GFSK| 0.180 | 0.72 | 0.25| 887.5 | -41.7 +|FST4W-1800 |LDPC | (240,74)| 4| 4-GFSK| 0.089 | 0.36 | 0.25| 1792.0| -44.8 |=============================================================================== Submodes of JT4, JT9, JT65, and QRA64 offer wider tone spacings for @@ -259,12 +299,10 @@ threshold sensitivities of the various submodes when spreading is comparable to tone spacing. [[SLOW_SUBMODES]] -.Parameters of Slow Submodes +.Parameters of Slow Submodes with Wider Tome Spacings [width="50%",cols="h,3*^",frame=topbot,options="header"] |===================================== |Mode |Tone Spacing |BW (Hz)|S/N (dB) -|FT4 |20.8333 | 83.3 |-17.5 -|FT8 |6.25 | 50.0 |-21 |JT4A |4.375| 17.5 |-23 |JT4B |8.75 | 30.6 |-22 |JT4C |17.5 | 56.9 |-21 @@ -272,7 +310,7 @@ comparable to tone spacing. |JT4E |78.75| 240.6 |-19 |JT4F |157.5| 476.9 |-18 |JT4G |315.0| 949.4 |-17 -|JT9A |1.736| 15.6 |-27 +|JT9A |1.736| 15.6 |-26 |JT9B |3.472| 29.5 |-26 |JT9C |6.944| 57.3 |-25 |JT9D |13.889| 112.8 |-24 diff --git a/doc/user_guide/en/tutorial-example5.adoc b/doc/user_guide/en/tutorial-example5.adoc new file mode 100644 index 000000000..899625211 --- /dev/null +++ b/doc/user_guide/en/tutorial-example5.adoc @@ -0,0 +1,24 @@ +FST4 is is designed for making 2-way QSOs on the LF and MF bands. Do +not confuse it with FT4, which has a very different purpose! Most +on-screen controls, auto-sequencing, and other features behave in FST4 +as in other modes. However, operating conventions on the 2200 and 630 +m bands make it desirable to have additional user controls that set +the active frequency range for decoding. Spin boxes labeled *F Low* +and *F High* set lower and upper frequency limits for the FST4 +decoder. + +image::FST4_center.png[align="center"] + +Decoding limits are marked by dark green angle-bracket symbols *< >* on +the Wide Graph frequency scale: + +image::FST4_Decoding_Limits.png[align="center"] + +In general the specified range should be no larger than needed, since +detected transmissions in modes other than the selected FST4 sequence +length will be undecodable and will slow down the decoding process. + +If *Single decode* on the the *File | Settings | General* tab is +checked, the decoding range is further limited to the *F Tol* range +around *Rx Freq*. + diff --git a/doc/user_guide/en/tutorial-example6.adoc b/doc/user_guide/en/tutorial-example6.adoc new file mode 100644 index 000000000..8c7c0dc36 --- /dev/null +++ b/doc/user_guide/en/tutorial-example6.adoc @@ -0,0 +1,16 @@ +FST4W has significant advantages over WSPR for use on the 2200 and 630 +m bands. As for WSPR, the default Rx Freq is 1500 Hz and F Tol is +100 Hz, so the active decoding range 1400 to 1600 Hz. However, for added +flexibility you can select different center frequencies and F Tol values. +We expect that usage conventions will soon be established for FST4 activity on 2200 and 630 m. + +A new drop-down control below F Tol offers a round-robin mode for +scheduling FST4W transmissions: + +image::FST4W_RoundRobin.png[align="center"] + +If three operators agree in advance to select the options 1/3, 2/3, +and 3/3, for example, their FST4W transmissions will occur in a fixed +sequence with no two stations transmitting simultaneously. Sequence 1 +is the first sequence after 00:00 UTC. For WSPR-like scheduling +behavior, you should select Random with this control. diff --git a/doc/user_guide/en/wsjtx-main.adoc b/doc/user_guide/en/wsjtx-main.adoc index b04291136..9bed15dc6 100644 --- a/doc/user_guide/en/wsjtx-main.adoc +++ b/doc/user_guide/en/wsjtx-main.adoc @@ -32,6 +32,9 @@ include::introduction.adoc[] [[NEW_FEATURES]] include::new_features.adoc[] +[[INTRO_SUBSECTIONS]] +include::intro_subsections.adoc[] + [[SYSREQ]] == System Requirements include::system-requirements.adoc[] @@ -162,6 +165,14 @@ include::tutorial-example3.adoc[] === FT4 include::tutorial-example4.adoc[] +[[TUT_EX5]] +=== FST4 +include::tutorial-example5.adoc[] + +[[TUT_EX6]] +=== FST4W +include::tutorial-example6.adoc[] + [[MAKE_QSOS]] == Making QSOs include::make-qso.adoc[]