From 2c98233d3a1f795a4dd72f32cf58a2708618f8b1 Mon Sep 17 00:00:00 2001 From: Joe Taylor Date: Fri, 13 Nov 2015 20:26:41 +0000 Subject: [PATCH] Final (?) additions to WSJT-X User Guide for v1.6.0. Close reading is now strongly encouraged! We "go to press" soon! git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@6090 ab8295b8-cf94-4d9e-aec4-7959e3be5d79 --- doc/CMakeLists.txt | 2 +- doc/user_guide/new_features.adoc | 22 +++++- doc/user_guide/vhf-and-up.adoc | 90 ---------------------- doc/user_guide/vhf-features.adoc | 123 +++++++++++++++++++++++++++++++ doc/user_guide/wsjtx-main.adoc | 3 +- 5 files changed, 144 insertions(+), 96 deletions(-) delete mode 100644 doc/user_guide/vhf-and-up.adoc create mode 100644 doc/user_guide/vhf-features.adoc diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index 84a47599f..5715dd4dd 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -60,7 +60,7 @@ set (UG_SRCS user_guide/tutorial-wide-graph-settings.adoc user_guide/tx-rx.adoc user_guide/utilities.adoc - user_guide/vhf-and-up.adoc + user_guide/vhf-features.adoc user_guide/wsjtx-main.adoc user_guide/wspr.adoc ) diff --git a/doc/user_guide/new_features.adoc b/doc/user_guide/new_features.adoc index 8f90c6c82..161667503 100644 --- a/doc/user_guide/new_features.adoc +++ b/doc/user_guide/new_features.adoc @@ -1,13 +1,15 @@ +=== New in Version 1.6 + 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 -improved sensitivity two-pass decoder. +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 +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. +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. @@ -15,3 +17,17 @@ be automatically ``on frequency'' to within about 1 Hz. - Mode-specific working frequencies accessible from the drop-down band selector. +=== Future releases + +Much work has already been done on what will become Version 1.7 of +_WSJT-X_. (Up to now it has been called v1.6.1.) A number of people +have been building this version for themselves, as development +progresses, and reporting on their experiences. The next release will +almost certainly have the following features not present in +Version 1.6.0: + +- *JTMSK* mode, intended for meteor scatter, ionospheric scatter, +aircraft scatter, and the like. Unlike the FSK441, ISCAT, and JTMS +modes present in the older program _WSJT_, JTMSK includes strong +forward error correction and uses structured messages identical to +those in JT4, JT9, and JT65. diff --git a/doc/user_guide/vhf-and-up.adoc b/doc/user_guide/vhf-and-up.adoc deleted file mode 100644 index 391ab0fce..000000000 --- a/doc/user_guide/vhf-and-up.adoc +++ /dev/null @@ -1,90 +0,0 @@ -=== 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.) - -- Check the box labeled _Enable VHF/UHF/Microwave features_ on the -*Settings | General* tab to activate the VHF-and-up features. - -- If you will be doing EME, check the box _Decode at t = 52 s_ -to allow for the EME path delay. - -- If you will use automatic Doppler tracking, check the box -_Allow Tx frequency changes while transmitting_. Also select -_Split Operation_ (either _Rig_ or _Fake It_: you might need -to experiment with both) on the *Radio* tab. - -IMPORTANT: Not all transceivers permit computer adjustments -of Tx frequency while transmitting. Among those that do are the -IC735, IC756 Pro II, IC910-H, FT-847, TS-2000 (with Rev 9 firmware -upgrade), Flex 1500 and 5000, HPSDR, Anan-10, Anan-100, and KX3. - -- When operating in appropriate modes the main window will reconfigure -itself to include controls supporting the additional features. For -example, in JT4 mode the central part of the main window will look -something like this: - -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. - -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. - -- 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. -Better still, 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. - -- Spinner controls at top right of the Astronomical Data window let you -set a working frequency above the nominal band edge. The frequency above -band edge is the sum of these two controls (kHz + Hz). - -=== EME with JT4 - -- Select *JT4* from the *Mode* menu. - -- 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. - -- 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 frequencty). For -example, for a 144 MHz radio and 10368 MHz, -offset = (144 - 10368) = -10224.000. Right-click anywhere inside the -_Station Information_ box, select the desired band, and enter the -offset number. - -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 correlation decoding. Select -your desired decoding depth from the *Decode* menu. - -image::images/decoding_depth.png[align="center",alt="Decoding Depth"] - -- By convention, EME with JT4 can use ``short form'' messages. To -activate automatic generation of these messages, check the box labeled -_Sh_ on the main window. - -IMPORTANT: Many additional details and hints for JT4 EME operation -are available here: -http://physics.princeton.edu/pulsar/K1JT/WSJT-X_for_JT4_v6.pdf -(thanks to G3WDG!). diff --git a/doc/user_guide/vhf-features.adoc b/doc/user_guide/vhf-features.adoc new file mode 100644 index 000000000..2de05cc9f --- /dev/null +++ b/doc/user_guide/vhf-features.adoc @@ -0,0 +1,123 @@ +=== 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.) + +- To activate the VHF-and-up features check the box labeled _Enable + VHF/UHF/Microwave features_ on the *Settings | General* tab. + +- If you will be doing EME, check the box _Decode at t = 52 s_ +to allow for the EME path delay on received signals. + +- If you will use automatic Doppler tracking, check the box _Allow Tx +frequency changes while transmitting_. On the *Radio* tab select +_Split Operation_ (use either _Rig_ or _Fake It_: you might need to +experiment with both). + +IMPORTANT: Not all transceivers permit computer adjustments of Tx +frequency while transmitting. Among those that do are the IC-735, +IC-756 Pro II, IC-910-H, FT-847, TS-2000 (with Rev 9 firmware +upgrade), Flex 1500 and 5000, HPSDR, Anan-10, Anan-100, and KX3. + +- The main window reconfigures itself as necessary to include controls +supporting features of each mode. For example, in JT4 mode the +central part of the main window will look like this: + +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. + +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. + +- 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. + +- Spinner controls at top right of the Astronomical Data window let you +set a working frequency above the nominal band edge. The frequency above +band edge is the sum of the numbers in these two controls (kHz + Hz). + +=== EME with JT4 + +- Select *JT4* from the *Mode* menu. + +- 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. + +- 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. + +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 +provide options to set different decoding behavior. However, in JT4 mode +this program version always behaves as if you have selected _Include +correlation_. + +image::images/decoding_depth.png[align="center",alt="Decoding Depth"] + +- By convention, EME with JT4 can use ``short form'' messages. To +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!. + +=== Echo Mode + +*Echo* mode allows you to make sensitive measurements of your own +lunar echoes, even when they are too weak to be heard. Select *Echo* +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 +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 +5. Repeat from step 1 + +To make a sequence of echo tests: + +- Select *Echo* from the *Mode* menu. + +- On the Astronomical Data window check _Doppler tracking_ and +_Constant frequency on the Moon_ + +- Choose your desired test frequency using the _Frequency above nominal +band edge_ controls. + +- Click *Enable Tx* on the main window to start a sequence of 6-second +cycles. + +- _WSJT-X_ calculates and compensates for Doppler shift automatically. +Your return echo should always appear at the center of the plot area +on the Echo Graph window. diff --git a/doc/user_guide/wsjtx-main.adoc b/doc/user_guide/wsjtx-main.adoc index 2bd6758e9..674da1b01 100644 --- a/doc/user_guide/wsjtx-main.adoc +++ b/doc/user_guide/wsjtx-main.adoc @@ -27,7 +27,6 @@ include::../common/links.adoc[] include::introduction.adoc[] [[NEW_FEATURES]] -== New in Version 1.6 include::new_features.adoc[] [[SYSREQ]] @@ -131,7 +130,7 @@ include::wspr.adoc[] [[VHF_AND_UP]] == VHF Features -include::vhf-and-up.adoc[] +include::vhf-features.adoc[] [[MAKE_QSOS]] == Making QSOs