From bb1306a54b1cdd3853abb0515780c0193d3a4c55 Mon Sep 17 00:00:00 2001 From: Joe Taylor Date: Fri, 12 Mar 2021 11:07:19 -0500 Subject: [PATCH] Updates to User Guide, mostly having to do with Q65. --- doc/user_guide/en/acknowledgements.adoc | 12 +++--- doc/user_guide/en/introduction.adoc | 55 ++++++++++++------------ doc/user_guide/en/make-qso.adoc | 10 ++--- doc/user_guide/en/protocols.adoc | 27 ++++++------ doc/user_guide/en/transceiver-setup.adoc | 8 +--- doc/user_guide/en/vhf-features.adoc | 45 ++++++++++--------- 6 files changed, 76 insertions(+), 81 deletions(-) diff --git a/doc/user_guide/en/acknowledgements.adoc b/doc/user_guide/en/acknowledgements.adoc index a5ab8b7c7..8aecb7879 100644 --- a/doc/user_guide/en/acknowledgements.adoc +++ b/doc/user_guide/en/acknowledgements.adoc @@ -2,18 +2,20 @@ The _WSJT_ project was started by *K1JT* in 2001. Since 2005 it has been an Open Source project, which now includes the programs _WSJT_, -_MAP65_, _WSPR_, _WSJT-X_, and _WSPR-X_. *G4WJS* (since 2013) and -*K9AN* (since 2015) have made major contributions to _WSJT-X_. -Together with K1JT they now form the core development team. +_MAP65_, _WSPR_, _WSJT-X_, and _WSPR-X_. *G4WJS* (since 2013), *K9AN* +(since 2015), and *IV3NWV* (since 2016) have made major contributions +to _WSJT-X_. Together with K1JT they now form the core development +team. *G4WJS* and *W9MDB* have made major contributiions to _hamlib_, +on which _WSJT-X_ depends for rig control. All code in the _WSJT_ project is licensed under the GNU Public License (GPL). Many users of these programs, too numerous to mention here individually, have contributed suggestions and advice that have greatly aided the development of _WSJT_ and its sister programs. For _WSJT-X_ in particular, we acknowledge contributions from *AC6SL, -AE4JY, DJ0OT, G3WDG, G4KLA, IV3NWV, IW3RAB, K3WYC, KA6MAL, KA9Q, +AE4JY, DF2ET, DJ0OT, G3WDG, G4KLA, IW3RAB, K3WYC, KA1GT, KA6MAL, KA9Q, KB1ZMX, KD6EKQ, KI7MT, KK1D, ND0B, PY2SDR, VE1SKY, VK3ACF, VK4BDJ, -VK7MO, W4TI, W4TV, and W9MDB*. Each of these amateurs has helped to +VK7MO, W3DJS, W4TI, W4TV, and W9MDB*. Each of these amateurs has helped to bring the program’s design, code, testing, and/or documentation to its present state. diff --git a/doc/user_guide/en/introduction.adoc b/doc/user_guide/en/introduction.adoc index 8f749b7fa..8765b272f 100644 --- a/doc/user_guide/en/introduction.adoc +++ b/doc/user_guide/en/introduction.adoc @@ -5,39 +5,38 @@ 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 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. +2001. Bill Somerville, G4WJS, Steve Franke, K9AN, and Nico Palermo, +IV3NWV, have been major contributors to development of _WSJT-X_ since +2013, 2015, and 2016, respectively. _WSJT-X_ Version {VERSION_MAJOR}.{VERSION_MINOR} offers eleven different protocols or modes: *FST4*, *FT4*, *FT8*, *JT4*, *JT9*, -*JT65*, *Q65*, *MSK144*, *WSPR*, *FST4W*, and *Echo*. The -first seven are designed for making reliable QSOs under weak-signal +*JT65*, *Q65*, *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 was designed for EME ("`moonbounce`") on VHF and -higher bands and is mostly used for that purpose today. Q65 replaces -an earlier mode, QRA64. Q65 is particularly effective for tropospheric -scatter, rain scatter, ionospheric scatter, TEP, and EME on VHF and -higher bands, as well as other types of fast-fading signals. JT9 was -originally designed for the HF and lower bands. Its submode JT9A is 1 -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, and already -during its first few months of testing intercontinental paths have -been spanned many times on the 2200 and 630 m 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, scatter, and other propagation types) at signal -levels 10 to 15 dB below those required for CW. +higher bands and is mostly used for that purpose today. Q65 is +particularly effective for tropospheric scatter, rain scatter, +ionospheric scatter, TEP, and EME on VHF and higher bands, as well as +other types of fast-fading signals. JT9 was designed for the HF and +lower bands. Its submode JT9A is 1 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. The "`slow`" modes use timed sequences of +alternating transmission and reception. JT4, JT9, and JT65 use +one-minute sequences, 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 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 +is designed especially for the LF and MF bands. Both FST4 and Q65 +offer a wide variety of timed sequence lengths, and Q65 a range of +tone spacings for different propagation conditions. 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, scatter, and other +propagation types) at signal levels 10 to 15 dB below those required +for CW. *MSK144*, and optionally submodes *JT9E-H* are "`fast`" protocols designed to take advantage of brief signal enhancements from diff --git a/doc/user_guide/en/make-qso.adoc b/doc/user_guide/en/make-qso.adoc index 5bdbc3db7..c48d5f741 100644 --- a/doc/user_guide/en/make-qso.adoc +++ b/doc/user_guide/en/make-qso.adoc @@ -75,8 +75,8 @@ responder to your CQ. 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. *Auto-sequencing is an operator aid, not an -operator replacement.* +fully automated QSOs. Auto-sequencing is an operator aid, not an +operator replacement. [[CONTEST_MSGS]] === Contest Messages @@ -159,9 +159,9 @@ guidelines for contest logging with FT4, FT8, and MSK144: [[COMP-CALL]] === Nonstandard Callsigns -*FST4, FT4, FT8, MSK144, and Q65* +*Modes with 77-bit message payloads: FST4, FT4, FT8, MSK144, and Q65* -Compound callsigns like xx/K1ABC or K1ABC/x and special event +Compound callsigns like PJ4/K1ABC or K1ABC/3 and special event callsigns like YW18FIFA are supported for normal QSOs but not for contest-style messages. Model QSOs look something like this: @@ -195,7 +195,7 @@ the types of information that can be included in a message. It prevents including your locator in standard messages, which necessarily impairs the usefulness of tools like PSK Reporter. -*JT4, JT9, and JT65* +*Modes with 72-bit message payloads: JT4, JT9, and JT65* In the 72-bit modes, compound callsigns are handled in one of two possible ways: diff --git a/doc/user_guide/en/protocols.adoc b/doc/user_guide/en/protocols.adoc index dbfc0732a..405d3bd0e 100644 --- a/doc/user_guide/en/protocols.adoc +++ b/doc/user_guide/en/protocols.adoc @@ -175,19 +175,20 @@ separation is 110250/4096 = 26.92 Hz multiplied by n for JT65A, with n Q65 is intended for scatter, EME, and other extreme weak-signal applications. Forward error correction (FEC) uses a specially designed (65,15) block code with six-bit symbols. Two symbols are -“punctured” from the code, yielding an effective (63,13) code with a -payload of k = 13 information symbols conveyed by n = 63 channel -symbols. The punctured symbols consist of a 12-bit CRC computed from -the 13 information symbols. The CRC is used to reduce the -false-decode rate to a very low value. A 22-symbol pseudo-random -sequence spread throughout a transmission is sent as “tone 0” and used -for synchronization. The total number of channel symbols in a Q65 -transmission is thus 63 + 22 = 85. - -For each T/R sequence length, submodes A - E have tone spacings and -occupied bandwidths 1, 2, 4, 8, and 16 times those specified in the -above table. Full submode designations include a number for sequence -length and a letter for tone spacing, as in Q65-15A, Q65-120C, etc. +“punctured” from the code and not transmitted, thereby yielding an +effective (63,13) code with a payload of k = 13 information symbols +conveyed by n = 63 channel symbols. The punctured symbols consist of +a 12-bit CRC computed from the 13 information symbols. The CRC is +used to reduce the false-decode rate to a very low value. A 22-symbol +pseudorandom sequence spread throughout a transmission is sent as +“tone 0” and used for synchronization. The total number of channel +symbols in a Q65 transmission is thus 63 + 22 = 85. Q65 offers T/R +sequence lengths of 15, 30, 60, 120, and 300 s, and submodes A - E +have tone spacings 1, 2, 4, 8, and 16 times the symbol rate. Submode +designations include a number for sequence length and a letter for +tone spacing, as in Q65-15A, Q65-120C, etc. Occupied bandwidths are +65 times the tone spacing, ranging from 19 Hz (Q65-300A) to a maximum +of 1733 Hz (Q65-15C, Q65-30D, and Q65-60E). [[WSPR_PROTOCOL]] ==== WSPR diff --git a/doc/user_guide/en/transceiver-setup.adoc b/doc/user_guide/en/transceiver-setup.adoc index 13fdb5b99..7b12e2423 100644 --- a/doc/user_guide/en/transceiver-setup.adoc +++ b/doc/user_guide/en/transceiver-setup.adoc @@ -26,13 +26,7 @@ TIP: The PC audio mixer normally has two sliders, one for each - If your transceiver offers more than one bandwidth setting in USB mode, it may be advantageous to choose the widest one possible, up - to about 5 kHz. This choice has the desirable effect of allowing - the *Wide Graph* (waterfall and 2D spectrum) to display the - conventional JT65 and JT9 sub-bands simultaneously on most HF bands. - Further details are provided in the <>. A wider displayed bandwidth may also be helpful at VHF - and above, where FT8, JT4, JT65, and Q65 signals may be found over - much wider ranges of frequencies. + to about 5 kHz. - If you have only a standard SSB filter you won’t be able to display more than about 2.7 kHz bandwidth. Depending on the exact dial diff --git a/doc/user_guide/en/vhf-features.adoc b/doc/user_guide/en/vhf-features.adoc index c095588ce..3dd1a06ae 100644 --- a/doc/user_guide/en/vhf-features.adoc +++ b/doc/user_guide/en/vhf-features.adoc @@ -1,15 +1,15 @@ _WSJT-X_ supports a number of features designed for use on the VHF and higher bands. These features include: -- *FT4*, designed especially for contesting +- *FT4*, for contesting -- *FT8*, designed for making fast QSOs with weak, fading signals +- *FT8*, for fast QSOs with weak, fading signals -- *JT4*, particularly useful for EME on the microwave bands +- *JT4*, for EME on the microwave bands -- *JT9 fast modes*, useful for scatter propagation on VHF bands +- *JT9 fast modes*, for scatter propagation on VHF bands -- *JT65*, widely used for EME on VHF and higher bands +- *JT65*, for EME on VHF and higher bands - *Q65*, for ionospheric scatter, tropospheric scatter, rain scatter, TEP, and EME @@ -175,24 +175,22 @@ image::JT65B.png[align="center",alt="JT65B"] === Q65 -Q65 is designed for propagation paths that produce fast fading -signals: tropospheric scatter, rain scatter, ionospheric scatter, -trans-equatorial propagation (TEP), EME, and the like. The following -screen shot shows a series of ionospheric scatter QSOs using submode -Q65-30A on the 6 meter band. The received signals were barely audible -most of the time. +Q65 is designed for fast-fading signals: tropospheric scatter, rain +scatter, ionospheric scatter, trans-equatorial propagation (TEP), EME, +and the like. The following screen shot shows a series of ionospheric +scatter QSOs using submode Q65-30A on the 6 meter band. The received +signals were barely audible most of the time. image::Q65_6m_ionoscatter.png[align="center",alt="Q65"] -The Q65 decoder makes no use of a callsign database. Instead, it -takes advantage of _a priori_ (AP) information such as one's own -callsign and the message word `CQ`. In normal usage, as a QSO -progresses the available AP information increases to include the -callsign of the station being worked and perhaps also his/her 4-digit +The Q65 decoder takes advantage of _a priori_ (AP) information such as +the encoded forms of one's own callsign and the message word `CQ`. In +normal usage, as a QSO progresses AP information increases to include +the callsign of the station being worked and perhaps his/her 4-digit grid locator. The decoder takes advantage of whatever AP information -is available. +is currently available. -For Q65 EME QSOs, particularly on the microwave bands, some operators +For Q65 EME QSOs on the microwave bands, some operators use short-form messages consisting of a single tone. To activate automatic generation of these messages, check the box labeled *Sh*. This also enables the generation of a single tone at 1000Hz by @@ -318,11 +316,12 @@ image::echo_144.png[align="center",alt="Echo 144 MHz"] Until the advent of Q65, digital EME has mostly been done using JT65A on the 50 MHz band, JT65B on 144 and 432 MHz, and JT65C on 1296 MHz. -On higher microwave bands typical choices have been JT65C or one of -the wider QRA64 or JT4 submodes, depending on the expected amount of -Doppler spread. We now recommend a suitable submodes of Q65 for EME -on all bands: for example, Q65-60A on 50 and 144 MHz, -60B on -432 MHz, -60C on 1296 MHz, and -60D on 10 GHz. +On higher microwave bands typical choices have been JT65C, one of the +wider JT4 submodes, or QRA64, depending on the expected amount of +Doppler spread. We now recommend a suitable submode of Q65 (which has +replaced QRA64) for EME on any VHF or higher band: for example, +Q65-60A on 50 and 144 MHz, Q65-60B on 432 MHz, Q65-60C on 1296 MHz, +and Q65-60D on 10 GHz. JT4, JT65, and Q65 offer *Message Averaging* -- the summation of subsequent transmissions that convey the same message -- to enable