diff --git a/doc/common/links.adoc b/doc/common/links.adoc index 24ae2309c..d247a5856 100644 --- a/doc/common/links.adoc +++ b/doc/common/links.adoc @@ -2,14 +2,14 @@ Link file to hold all links File Location: ./doc/common/links.adoc Usage example: include::../common/links.adoc[] -Syntax: [link-id] [link] [displayed test] +Syntax: [link-id] [link] [displayed text] Example: :pskreporter: http://pskreporter.info/pskmap.html[PSK Reporter] [link-id] = :pskreporter: [link] http://pskreporter.info/pskmap.html -[displayed test] PSK Reporter +[displayed text] PSK Reporter Perform searches from the doc root directory: C:\JTSDK-DOC\doc Search: grep -rl --exclude-dir="*\.svn" {pskreporter} . @@ -56,13 +56,16 @@ d). Edit lines as needed. Keeping them in alphabetic order help see dupes. :fmt_arrl: http://www.arrl.org/frequency-measuring-test[ARRL FMT Info] :fmt_group: https://groups.yahoo.com/neo/groups/FMT-nuts/info[FMT Group] :fmt_k5cm: http://www.k5cm.com/[FMT Event Info] +:fmt_wspr: http://www.physics.princeton.edu/pulsar/K1JT/FMT_User.pdf[here] :gnu_gpl: http://www.gnu.org/licenses/gpl-3.0.txt[GNU General Public License] :homepage: http://physics.princeton.edu/pulsar/K1JT/[WSJT Home Page] :hrd: http://www.hrdsoftwarellc.com/[Ham Radio Deluxe] +:jt4eme: http://physics.princeton.edu/pulsar/K1JT/WSJT-X_for_JT4_v6.pdf[here] :jt65protocol: http://physics.princeton.edu/pulsar/K1JT/JT65.pdf[QEX] :jtalert: http://hamapps.com[JT-ALERT-X] :kvasd-installer: http://physics.princeton.edu/pulsar/K1JT/kv-installer.txt[here] :launchpadki7mt: https://launchpad.net/~ki7mt[KI7MT PPA's] +:log4om: http://www.log4om.com[Log4OM] :msys_url: http://sourceforge.net/projects/mingwbuilds/files/external-binary-packages/[MSYS Download] :ntpsetup: http://www.satsignal.eu/ntp/setup.html[Network Time Protocol Setup] :osx_instructions: http://physics.princeton.edu/pulsar/K1JT/OSX_Readme[here] diff --git a/doc/user_guide/acknowledgements.adoc b/doc/user_guide/acknowledgements.adoc index 48c096428..9925540aa 100644 --- a/doc/user_guide/acknowledgements.adoc +++ b/doc/user_guide/acknowledgements.adoc @@ -8,8 +8,8 @@ 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, G4KLA, G4WJS, K3WYC, KA6MAL, KA9Q, KB1ZMX, KI7MT, KK1D, -PY2SDR, VK3ACF, VK4BDJ, W4TI, W4TV, and W9MDB*. Each of these +AE4JY, DJ0OT, G4KLA, G4WJS, K3WYC, K9AN, KA6MAL, KA9Q, KB1ZMX, KI7MT, +KK1D, PY2SDR, VK3ACF, VK4BDJ, W4TI, W4TV, and W9MDB*. Each of these amateurs has helped to bring the program’s design, code, and documentation to its present state. @@ -23,5 +23,5 @@ Collection from the Free Software Foundation, the "clang" compiler from LLVM at the University of Illinois, and the Qt Project from Digia PLC. Other important resources include the FFTW library by Matteo Frigo and Steven G. Johnson; SLALIB, the Positional Astronomy Library -by P. T. Wallace; and a high-precision planetary emperis and +by P. T. Wallace; and a high-precision planetary ephemeris and associated software from NASA's Jet Propulsion Laboratory. diff --git a/doc/user_guide/command-reference.adoc b/doc/user_guide/command-reference.adoc deleted file mode 100644 index 1e501fe13..000000000 --- a/doc/user_guide/command-reference.adoc +++ /dev/null @@ -1,14 +0,0 @@ -// Status=review -// Needs updating: GB Added 03-NOV-2015 - -// add other sections here - -[[COMMAND_REF_LOGGING]] -.Choose any desired options from this group: - -* Prompt me to log QSO -* Convert mode to RTTY -* db reports to comments -* Clear DX call and grid after logging - -// more sections here diff --git a/doc/user_guide/controls-functions-center.adoc b/doc/user_guide/controls-functions-center.adoc index a65784b4d..c1a4e0e6f 100644 --- a/doc/user_guide/controls-functions-center.adoc +++ b/doc/user_guide/controls-functions-center.adoc @@ -21,12 +21,17 @@ to left.) Check the box *Lock Tx=Rx* to make the frequencies always track one another. The on-the-air frequency of your lowest JT9 or JT65 tone is the sum of dial frequency and audio Tx frequency. +IMPORTANT: In general we do not recommend using *Lock Tx=Rx* since it +encourages poor radio etiquette when running a frequency. With *Lock +Tx=Rx* checked, your own frequency will move around following your +callers. + * The *Report* control lets you change a signal report that has been inserted automatically. Most reports will fall in the range –26 to +10 dB. Remember that JT65 reports saturate at an upper limit of -1 dB. -IMPORTANT: When signals are close to or above 0 dB, you and your QSO -partner should probably reduce power. The WSJT modes are supposed to -be weak signal modes! +IMPORTANT: Consider reducing power if your QSO partner reports your +signal above -5 dB. The WSJT modes are supposed to be weak signal +modes! diff --git a/doc/user_guide/faq.adoc b/doc/user_guide/faq.adoc index 8de25efc0..6f4e8e2a3 100644 --- a/doc/user_guide/faq.adoc +++ b/doc/user_guide/faq.adoc @@ -37,20 +37,6 @@ decreasing *Bins/Pixel*, increasing *Start*, or reducing the width of the *Wide Graph*. You might also choose to re-center the filter passband, if such control is available. -My rig has only a single SSB filter, about 2700 Hz bandwidth. Can I use split mode?:: - -Set _Split Operation_ to *Rig* (or if necessary, *Fake It*) on the -*Settings | Radio* tab. To operate primarily in the JT9 frequency -range, check the *{plus}2 kHz* box. VFO-A will be moved up by that -amount, e.g., to 14.078 MHz on 20 meters. The JT9 sub-band now falls -between about 500 Hz and 2000Hz on the waterfall display. As -described above, VFO-B will be adjusted so as to keep your Tx audio -always between 1500 and 2000 Hz. To operate JT65, simply uncheck the -*{plus}2 kHz* option. If your rig has an IF shift control or -equivalent (``passband tuning''), you can operate as if you had 4 kHz -Rx bandwidth and use the IF shift control to focus on any 2.7 kHz -portion of the JT65 and JT9 sub-bands. - How should I configure _WSJT-X_ to run multiple instances?:: Start _WSJT-X_ from a command-prompt window, passing each instance a diff --git a/doc/user_guide/images/Astronomical_data.png b/doc/user_guide/images/Astronomical_data.png index 116707b3d..599764d30 100644 Binary files a/doc/user_guide/images/Astronomical_data.png and b/doc/user_guide/images/Astronomical_data.png differ diff --git a/doc/user_guide/introduction.adoc b/doc/user_guide/introduction.adoc index a775e6d0f..10ee5f2a9 100644 --- a/doc/user_guide/introduction.adoc +++ b/doc/user_guide/introduction.adoc @@ -12,7 +12,7 @@ QSOs under extreme weak-signal conditions. They use nearly identical message structure and source encoding. JT65 was designed for EME (“moonbounce”) on the VHF/UHF bands and has also proven very effective for worldwide QRP communication on the HF bands. JT9 is optimized for -the LF, MF, and lower HF bands. It is about 2 dB more sensitive than +the LF, MF, and lower HF bands. It 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 proved very effective for EME on microwave bands up to 24 GHz. All three of these modes use one-minute @@ -34,12 +34,15 @@ internet access can automatically upload their 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 lunar echoes, + even when they are far below the threshold of audibility. + _WSJT-X_ provides spectral displays for passbands up to 5 kHz, flexible rig control for nearly all modern radios used by amateurs, and a wide variety of special aids such as automatic Doppler control -for EME QSOs. The program runs equally well on Windows, Macintosh, -and Linux systems, and installation packages are available for all -three platforms. +for EME QSOs and echo testing. The program runs equally well on +Windows, Macintosh, and Linux systems, and installation packages are +available for all three platforms. _WSJT-X_ is an open-source project released under the {gnu_gpl} (GPL). If you have programming or documentation skills or would like diff --git a/doc/user_guide/logging.adoc b/doc/user_guide/logging.adoc index 961477d49..8f099631a 100644 --- a/doc/user_guide/logging.adoc +++ b/doc/user_guide/logging.adoc @@ -2,8 +2,14 @@ A basic logging facility in _WSJT-X_ saves QSO information to flies named +wsjtx.log+ (in comma-separated text format) and +wsjtx_log.adi+ (in standard ADIF format). These files can be imported directly into other programs, for example spreadsheets and popular logging prgrams. -More elaborate logging capabilities are supported in cooperation with -{jtalert}, {hrd}, or the {dxlsuite}. +As described in the <> and <> sections, different operating systems may place your +local log files in different locations. You can always navigate to +them directly by selecting *Open log directory* from the *File* menu. + +More elaborate logging capabilities are supported by third party +applications like {jtalert}, which can log QSOs automatically to other +applications including {hrd}, {dxlsuite}, and {log4om}. The program option *Show DXCC entity and worked before status* (selectable on the *Settings | General* tab) is intended mostly for diff --git a/doc/user_guide/make-qso.adoc b/doc/user_guide/make-qso.adoc index 861a94fd1..0d06a6282 100644 --- a/doc/user_guide/make-qso.adoc +++ b/doc/user_guide/make-qso.adoc @@ -44,7 +44,7 @@ for decodability are around –24 dB for JT65, –26 dB for JT9. Users often add some friendly chit-chat at the end of a QSO. Free-format messages such as ``TNX ROBERT 73'' or ``5W VERT 73 GL'' are supported, up to a maximum of 13 characters, including spaces. In -general you should avoid the character / in free-text nessages, as the +general you should avoid the character / in free-text messages, as the program may then try to interpret your construction as part of a compound callsign. It should be obvious that the JT9 and JT65 protocols are not designed or well suited for extensive conversations @@ -148,9 +148,9 @@ will be generated that best suit your needs. === Pre-QSO Checklist -Before attempting your first QSO with JT9 or JT65, be sure to go -through the <> above, as well as the following -checklist: +Before attempting your first QSO with one of the WSJT modes, be sure +to go through the <> above as well +as the following checklist: - Your callsign and grid locator set to correct values diff --git a/doc/user_guide/new_features.adoc b/doc/user_guide/new_features.adoc index 6ea347085..a9c04ae00 100644 --- a/doc/user_guide/new_features.adoc +++ b/doc/user_guide/new_features.adoc @@ -3,19 +3,25 @@ For quick reference, here's a short list of features and capabilities added to _WSJT-X_ since Version 1.5.0: -- *WSPR* mode, including automatic coordinated band-hopping and an +- *WSPR* mode, including coordinated automatic band-hopping and a two-pass decoder that can decode overlapping signals. -- EME-inspired features including *JT4* (submodes *A-G*), *Echo* mode, -and automatic *Doppler tracking*. (Note that submodes *JT65B* and -*JT65C* are also present in Version 1.6, but the high-sensitivity -decoder required for EME is not yet included.) +- EME-motivated features including *JT4* (submodes *A-G*), *Echo* +mode, and automatic *Doppler tracking*. The JT4 decoder is more +sensitive than that in the latest WSJT, and message averaging is fully +automated. (Note that submodes *JT65B* and *JT65C* are also present +in Version 1.6, but the high-sensitivity decoder required for EME is +not yet included.) - Tools for accurate *frequency calibration* of your radio, so you can -be automatically ``on frequency'' to within about 1 Hz. +be automatically on-frequency to within about 1 Hz. - Mode-specific working frequencies accessible from the drop-down band selector. + +- Many corrections of balky rig-control features implemented through +the hamlib library, and removal of a few unreliable features peculiar +to particular radios. === Future releases diff --git a/doc/user_guide/settings-audio.adoc b/doc/user_guide/settings-audio.adoc index 1a23592ce..cf4bbcb30 100644 --- a/doc/user_guide/settings-audio.adoc +++ b/doc/user_guide/settings-audio.adoc @@ -11,6 +11,9 @@ IMPORTANT: If you select the audio output device that is also your computer's default audio device, be sure to turn off all system sounds to prevent transmitting them over the air. +IMPORTANT: If necessary, be sure that your audio device in configured to +sample at 48000 Hz, 16 bits. + - _Save Directory_: _WSJT-X_ can save its received audio sequences as +.wav+ files. A default directory for these files is provided; you can select another location if desired. @@ -21,4 +24,3 @@ program for automatic tracking of the Sun or Moon, as well as predicted Doppler shift for the specified EME path. The file is updated once per second. - diff --git a/doc/user_guide/settings-frequencies.adoc b/doc/user_guide/settings-frequencies.adoc index 458ec0c62..56f8f80f5 100644 --- a/doc/user_guide/settings-frequencies.adoc +++ b/doc/user_guide/settings-frequencies.adoc @@ -22,7 +22,8 @@ the desired mode (or leave the Mode selection blank). Then click configuration. _Frequency Calibration_: If you have calibrated your radio with the -technique described (...here...), enter the measured values for +technique described {fmt_wspr}, or simply by measuring against WWV or +another reliable frequency reference, enter the measured values for Intercept and Slope. Frequency values sent to the radio and received from it will then be adjusted accordingly so that frequencies displayed by _WSJT-X_ will be correct. diff --git a/doc/user_guide/settings-reporting.adoc b/doc/user_guide/settings-reporting.adoc index 5902e806c..19b577d0d 100644 --- a/doc/user_guide/settings-reporting.adoc +++ b/doc/user_guide/settings-reporting.adoc @@ -2,9 +2,7 @@ [[FIG_CONFIG_RPT]] image::images/reporting.png[align="center",alt="Reporting Screen"] -- _Logging_: Choose any desired options from this group. For detailed -descriptions of their effects, see -<> section. +- _Logging_: Choose any desired options from this group. - _Network Services_: Check *Enable PSK Reporter Spotting* to send reception reports to the {pskreporter} mapping facility. diff --git a/doc/user_guide/system-requirements.adoc b/doc/user_guide/system-requirements.adoc index a9f09e160..ce1148619 100644 --- a/doc/user_guide/system-requirements.adoc +++ b/doc/user_guide/system-requirements.adoc @@ -8,6 +8,6 @@ device for T/R switching, or CAT control, or VOX, as required for your radio-to-computer connections - Audio input and output devices supported by the operating system and - capable of 48 kHz sample rate + configured for sample rate 48000 Hz. - Audio or equivalent USB connections between transceiver and computer - A means for synchronizing the computer clock to UTC within ±1 second diff --git a/doc/user_guide/transceiver-setup.adoc b/doc/user_guide/transceiver-setup.adoc index 90f62a887..9f22e3ee3 100644 --- a/doc/user_guide/transceiver-setup.adoc +++ b/doc/user_guide/transceiver-setup.adoc @@ -54,3 +54,10 @@ will be a good level for audio drive. digital slider labeled *Pwr* at the right edge of the main window. * Toggle the *Tune* button once more to stop your test transmission. + +IMPORTANT: Windows Vista and later incorrectly configure audio devices +using the Texas Instruments PCM2900 series CODEC for microphone input +rather line input. (This chip is used in many radios with built-in +USB CODECs, as well as various other audio interfaces.) If using such +a device, be sure to set the mic level in the Recording Device +Properties to 0 dB. diff --git a/doc/user_guide/utilities.adoc b/doc/user_guide/utilities.adoc index 9eccc61b3..55b7346f9 100644 --- a/doc/user_guide/utilities.adoc +++ b/doc/user_guide/utilities.adoc @@ -1,29 +1,56 @@ // Status=review -Utility programs *+jt9code+* and *+jt65code+* let you explore the -conversion of user-level messages into channel symbols or ``tone -numbers,'' and back again. These programs can be useful to someone -designing a beacon generator for JT9 or JT65, for understanding the +The _WSJT-X_ packages include program *+rigctl-wsjtx[.exe]+*, which +can be used to send CAT sequences to a rig from the command line, or +from a batch file or shell script; and program *+rigctld-wsjtx[.exe]+*, +which allows other compatible applications to share a CAT connection +to a rig. These program versions include the latest Hamlib rig +drivers -- the same ones used by _WSJT-X_ itself. + +Additional utility programs *+jt4code+*, *+jt9code+*, and *+jt65code+* +let you explore the conversion of user-level messages into channel +symbols or ``tone numbers,'' and back again. These programs can be +useful to someone designing a beacon generator, for understanding the permissible structure of transmitted messages, and for studying behavior of the error-control codes. +Channel-symbol values for JT4 run from 0 to 3. The total number of +symbols in a transmitted message is 206. To run +jt4code+, enter the +program name followed by a JT4 message enclosed in quotes. In Windows +the command and program output might look like this: + + C:\WSJTX> jt4code "G0XYZ K1ABC FN42" + Message Decoded Err? Type + ------------------------------------------------------------------- + 1. G0XYZ K1ABC FN42 G0XYZ K1ABC FN42 1: Std Msg + + Channel symbols + 2 0 0 1 3 2 0 2 3 1 0 3 3 2 2 1 2 1 0 0 0 2 0 0 2 1 1 2 0 0 + 2 0 2 0 2 0 2 0 2 3 0 3 1 0 3 1 0 3 0 1 1 1 1 1 0 1 0 0 2 3 + 2 2 3 0 2 1 3 3 3 3 2 0 2 1 2 3 0 0 2 3 1 1 1 0 3 1 2 0 3 2 + 0 2 3 3 0 1 2 1 2 1 0 1 0 1 1 1 1 3 0 3 0 3 2 3 3 0 3 0 1 0 + 3 3 3 0 0 3 2 1 3 2 3 1 3 3 2 2 0 2 3 3 2 1 1 0 2 2 3 3 1 2 + 3 1 1 2 1 1 1 0 2 1 2 0 2 3 1 2 3 1 2 2 1 2 0 0 3 3 1 1 1 1 + 2 0 3 3 0 2 2 2 3 3 0 0 0 1 2 3 3 2 1 1 1 3 2 3 0 3 + Channel-symbol values for JT9 run from 0 to 8, with 0 representing the sync tone. The total number of symbols in a transmitted message is -85. To run +jt9code+, enter the program name followed by a JT9 -message enclosed in quotes. In Windows the command and program output -might look like this: +85. Enter the program name followed by a JT9 message enclosed in +quotes: C:\WSJTX> jt9code "G0XYZ K1ABC FN42" - Message: G0XYZ K1ABC FN42 - Channel symbols: + Message Decoded Err? Type + ------------------------------------------------------------------- + 1. G0XYZ K1ABC FN42 G0XYZ K1ABC FN42 1: Std Msg + + Channel symbols 0 0 7 3 0 3 2 5 4 0 1 7 7 7 8 0 4 8 8 2 2 1 0 1 1 3 5 4 5 6 8 7 0 6 0 1 8 3 3 7 8 1 1 2 4 5 8 1 5 2 0 0 8 6 0 5 8 5 1 0 5 8 7 7 2 0 4 6 6 6 7 6 0 1 8 8 5 7 2 5 1 5 0 4 0 - Decoded message: G0XYZ K1ABC FN42 For the corresponding program *+jt65code+* only the information-carrying channel symbols are shown, and the symbol values -range from 0 to 63. Sync synbols lie two tone intervals below data +range from 0 to 63. Sync symbols lie two tone intervals below data tone 0, and the sequential locations of sync symbols are described in the <> section of this Guide. @@ -32,13 +59,16 @@ displays the packed message of 72 bits, shown here as 12 six-bit symbol values, followed by the channel symbols: C:\WSJTX> jt65code "G0XYZ K1ABC FN42" - Message: G0XYZ K1ABC FN42 - Packed message, 6-bit symbols: 61 36 45 30 3 55 3 2 14 5 33 40 - Information-carrying channel symbols: + Message Decoded Err? Type + ---------------------------------------------------------------------- + 1. G0XYZ K1ABC FN42 G0XYZ K1ABC FN42 1: Std Msg + + Packed message, 6-bit symbols 61 36 45 30 3 55 3 2 14 5 33 40 + + Information-carrying channel symbols 56 40 8 40 51 47 50 34 44 53 22 53 28 31 13 60 46 2 14 58 43 41 58 35 8 35 3 24 1 21 41 43 0 25 54 9 41 54 7 25 21 9 62 59 7 43 31 21 57 13 59 41 17 49 19 54 21 39 33 42 18 2 60 - Decoded message: G0XYZ K1ABC FN42 For an illustration of the power of the strong error-control coding in JT9 and JT65, try looking at the channel symbols after changing a @@ -46,14 +76,19 @@ single character in the message. For example, change the grid locator from +FN42+ to +FN43+ in the JT65 message: C:\Users\joe\wsjt\wsjtx_install>jt65code "G0XYZ K1ABC FN43" - Message: G0XYZ K1ABC FN43 - Packed message, 6-bit symbols: 61 36 45 30 3 55 3 2 14 5 33 41 - Information-carrying channel symbols: + Message Decoded Err? Type + ---------------------------------------------------------------------- + 1. G0XYZ K1ABC FN43 G0XYZ K1ABC FN43 1: Std Msg + + Packed message, 6-bit symbols 61 36 45 30 3 55 3 2 14 5 33 41 + + Information-carrying channel symbols 25 35 47 8 13 9 61 40 44 9 51 6 8 40 38 34 8 2 21 23 30 51 32 56 39 35 3 50 48 30 8 5 40 18 54 9 24 30 26 61 23 11 3 59 7 7 39 1 25 24 4 50 17 49 52 19 34 7 4 34 61 2 61 - Decoded message: G0XYZ K1ABC FN43 You will discover that every possible JT65 message differs from every other possible JT65 message in at least 52 of the 63 information-carrying channel symbols. + + diff --git a/doc/user_guide/vhf-features.adoc b/doc/user_guide/vhf-features.adoc index 2de05cc9f..489acc2d0 100644 --- a/doc/user_guide/vhf-features.adoc +++ b/doc/user_guide/vhf-features.adoc @@ -1,12 +1,13 @@ === VHF Setup V1.6.0 is the first _WSJT-X_ version to include features specifically -designed for use on VHF and higher bands. These features include *JT4*, -a mode particularly useful for EME on the microwave bands; *Echo* mode, -for detecting and measuring your own lunar echoes; and automatic -*Doppler tracking* for the EME path. (Note that sub-modes JT65B and -JT65C are present in v1.6.0, but are not yet fully implemented for EME -purposes.) +designed for use on VHF and higher bands. These features include +*JT4*, a mode particularly useful for EME on the microwave bands; +*Echo* mode, for detecting and measuring your own lunar echoes; and +automatic *Doppler tracking* for the EME path. The accuracy of +Doppler calculations is better than 1 Hz at 10 GHz. (Note that +sub-modes JT65B and JT65C are present in v1.6.0, but are not yet fully +implemented for EME purposes.) - To activate the VHF-and-up features check the box labeled _Enable VHF/UHF/Microwave features_ on the *Settings | General* tab. @@ -32,23 +33,30 @@ image::images/VHF_controls.png[align="center",alt="VHF Controls"] - On the *View* menu, select *Astronomical data* to display a window with important information for tracking the Moon and performing -automatic Doppler control. +automatic Doppler control. Check the box labeled _Doppler tracking_ +to ensure that the right-hand portion of the window is visible. image::images/Astronomical_data.png[align="center",alt="Astronomical data"] IMPORTANT: Note that two different types of Doppler control are provided. - Select _Full Doppler to DX Grid_ if you know your QSO partner's locator -and he/she is not using Doppler control. +and he/she will not be using any Doppler control. - Select _Constant frequency on Moon_ to correct for your own (one-way) Doppler shift to or from the Moon. If your QSO partner does the same thing, both stations will have the required Doppler compensation. Moreover, anyone else using this option will hear both of you without the need for manual frequency changes. The hypothetical ``man -in the moon'' will copy all of you on the selected nominal frequency: -in the example depicted above, this is 100 kHz above the stated band -edge, e.g., 10368.100 MHz for the 10 GHz band. +in the moon'' will copy all of you on the selected nominal frequency. + +- In the example depicted above, the moon-based nominal frequency is +100 kHz above the stated band edge, or 10368.100 MHz for the 10 GHz +band. The home station two-way self Doppler shift is +6193 Hz, so the +one-way shift is +3096.5 Hz. Therefore, the receive frequency is set +to 10,360.103097 Hz. When a transmission is started, the frequency +is reset to 3096.5 Hz below the nomial frequency. + - Spinner controls at top right of the Astronomical Data window let you set a working frequency above the nominal band edge. The frequency above @@ -61,21 +69,21 @@ band edge is the sum of the numbers in these two controls (kHz + Hz). - Select the desired submode, which determines the tone spacing. Higher spacings are used on the higher microwave bands, to allow for larger Doppler spreads. For example, JT4F is generally used for EME on -the 10 GHz band. +the 10 GHz band. -- If using a transverter, set the appropriate offset on the -*Settings | Frequencies* tab. Offset is defined as (desired -transceiver dial reading) minus (desired on-the-air frequency). For -example, when using a 144 MHz radio at 10368 MHz, -offset = (144 - 10368) = -10224.000. Right-click anywhere inside the -_Station Information_ box, select the desired band, and enter the -offset number. +- If using a transverter, set the appropriate offset on the *Settings +| Frequencies* tab. Offset is defined as (desired transceiver dial +reading) minus (desired on-the-air frequency). For example, when +using a 144 MHz radio at 10368 MHz, offset = (144 - 10368) = +-10224.000. If the band is already in the table, you can edit the +offset by double clicking on the offset field itself. Otherwise a new +band can be added by right clicking in the table and selecting _Insert_. image::images/Add_station_info.png[align="center",alt="Station information"] - The JT4 decoder in _WSJT-X_ includes optional facilities for -averaging over successive trandmissions and also correlation decoding, -sometimesknown as ``Deep Search''. The *Decode* menu appears to +averaging over successive transmissions and also correlation decoding, +sometimes known as ``Deep Search''. The *Decode* menu appears to provide options to set different decoding behavior. However, in JT4 mode this program version always behaves as if you have selected _Include correlation_. @@ -87,9 +95,8 @@ activate automatic generation of these messages, check the box labeled _Sh_ on the main window. IMPORTANT: Many additional hints for using JT4 and Echo mode on the -EME path are available here: -http://physics.princeton.edu/pulsar/K1JT/WSJT-X_for_JT4_v6.pdf. Thanks -to G3WDG for preparing this document!. +EME path are available {jt4eme}. (Thanks to G3WDG for preparing this +useful document.) === Echo Mode @@ -99,7 +106,7 @@ from the *Mode* menu, aim your antenna at the moon, pick a clear frequency, and toggle click *Tx Enable*. _WSJT-X_ will then cycle through the following loop every 6 seconds: -1. Transmit a fixed tone for 2.3 s +1. Transmit a 1500 Hz fixed tone for 2.3 s 2. Wait about 0.2 s for start of the return echo 3. Record the received signal for 2.3 s 4. Analyze, average, and display the results diff --git a/doc/user_guide/wsjtx-main.adoc b/doc/user_guide/wsjtx-main.adoc index 674da1b01..edc741352 100644 --- a/doc/user_guide/wsjtx-main.adoc +++ b/doc/user_guide/wsjtx-main.adoc @@ -61,10 +61,11 @@ include::install-from-source.adoc[] [[CONFIG]] == Settings -Select *Settings* from the *File* menu or by typing *F2* (on -Macintosh, *Command* or *Cmd*). The following sections describe setup -optiions available on each of seven tabs selectable near the top of the -window. +Select *Settings* from the *File* menu or by typing *F2*. (On +Macintosh select *Preferences* from the WSJT-X menu, or use the +keyboard *Command* or *Cmd* key.) The following sections describe +setup optiions available on each of seven tabs selectable near the top +of the window. [[GENERAL]] === General @@ -137,8 +138,7 @@ include::vhf-features.adoc[] include::make-qso.adoc[] [[COMMAND_REF]] -== Command Reference -include::command-reference.adoc[] +== On-Screen Controls [[CONTROLS_WIDE]] === Wide Graph