Many updates to User Guide.
git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7182 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
Before Width: | Height: | Size: 184 KiB After Width: | Height: | Size: 52 KiB |
Before Width: | Height: | Size: 69 KiB After Width: | Height: | Size: 37 KiB |
Before Width: | Height: | Size: 4.6 KiB After Width: | Height: | Size: 3.7 KiB |
Before Width: | Height: | Size: 131 KiB After Width: | Height: | Size: 84 KiB |
Before Width: | Height: | Size: 21 KiB After Width: | Height: | Size: 27 KiB |
BIN
doc/user_guide/en/images/main-ui.png
Normal file
After Width: | Height: | Size: 98 KiB |
@ -15,6 +15,13 @@ to prevent transmitting them over the air.
|
|||||||
IMPORTANT: Be sure that your audio device is configured to sample at
|
IMPORTANT: Be sure that your audio device is configured to sample at
|
||||||
48000 Hz, 16 bits.
|
48000 Hz, 16 bits.
|
||||||
|
|
||||||
|
IMPORTANT: Windows Vista and later may 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 you are using
|
||||||
|
such a device, be sure to set the mic level in the Recording Device
|
||||||
|
Properties to 0 dB.
|
||||||
|
|
||||||
- _Save Directory_: _WSJT-X_ can save its received audio sequences as
|
- _Save Directory_: _WSJT-X_ can save its received audio sequences as
|
||||||
+.wav+ files. A default directory for these files is provided; you
|
+.wav+ files. A default directory for these files is provided; you
|
||||||
can select another location if desired.
|
can select another location if desired.
|
||||||
|
@ -11,8 +11,9 @@ controls to set the background noise level (scale at lower left of
|
|||||||
main window) to around 30 dB when no signals are present. It is
|
main window) to around 30 dB when no signals are present. It is
|
||||||
usually best to turn AGC off or reduce the RF gain control to minimize
|
usually best to turn AGC off or reduce the RF gain control to minimize
|
||||||
AGC action. If necessary you can also adjust the slider next to the
|
AGC action. If necessary you can also adjust the slider next to the
|
||||||
dB scale, but note that the overall dynamic range will be best with
|
dB scale, but note that the overall dynamic range will be best when
|
||||||
this slider not too far from its mid-point.
|
the displayed level is near 30 dB with the slider close to its
|
||||||
|
mid-point.
|
||||||
|
|
||||||
.Bandwidth and Frequency Setting
|
.Bandwidth and Frequency Setting
|
||||||
|
|
||||||
@ -22,8 +23,9 @@ mode, you should normally choose the widest one possible, up to about
|
|||||||
Graph* (waterfall and 2D spectrum) to display the conventional JT65
|
Graph* (waterfall and 2D spectrum) to display the conventional JT65
|
||||||
and JT9 sub-bands simultaneously on most HF bands. Further details
|
and JT9 sub-bands simultaneously on most HF bands. Further details
|
||||||
are provided in the <<TUTORIAL,Basic Operating Tutorial>>. A wider
|
are provided in the <<TUTORIAL,Basic Operating Tutorial>>. A wider
|
||||||
displayed bandwidth may also be helpful at VHF and above, where JT4
|
displayed bandwidth may also be helpful at VHF and above, where JT4,
|
||||||
and JT65 signals are found over much wider ranges of frequencies.
|
JT65, and QRA64 signals may be found over much wider ranges of
|
||||||
|
frequencies.
|
||||||
|
|
||||||
- If you have only a standard SSB filter you won’t be able to display
|
- 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
|
more than about 2.7 kHz bandwidth. Depending on the exact dial
|
||||||
@ -43,21 +45,16 @@ radio into transmit mode and generate a steady audio tone.
|
|||||||
|
|
||||||
* Listen to the generated audio tone using your radio’s *Monitor*
|
* Listen to the generated audio tone using your radio’s *Monitor*
|
||||||
facility. The transmitted tone should be perfectly smooth, with no
|
facility. The transmitted tone should be perfectly smooth, with no
|
||||||
clicks or glitches.
|
clicks or glitches. Make sure that this is true even when you
|
||||||
|
simultaneously use the computer to do other tasks such as email, web
|
||||||
|
browsing, etc.
|
||||||
|
|
||||||
* Open the computer's audio mixer controls for output ("`Playback`")
|
* Open the computer's audio mixer controls for output ("`Playback`")
|
||||||
devices and adjust the volume slider downward from its maximum until
|
devices and adjust the volume slider downward from its maximum until
|
||||||
the RF output from your transmitter falls by around ten percent. This
|
the RF output from your transmitter falls slightly. This is generally
|
||||||
will be a good level for audio drive.
|
a good level for audio drive.
|
||||||
|
|
||||||
* Alternatively, you can make the Tx audio level adjustment using the
|
* Alternatively, you can make the Tx audio level adjustment using the
|
||||||
digital slider labeled *Pwr* at the right edge of the main window.
|
digital slider labeled *Pwr* at the right edge of the main window.
|
||||||
|
|
||||||
* Toggle the *Tune* button once more to stop your test transmission.
|
* 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 you are
|
|
||||||
using such a device, be sure to set the mic level in the Recording
|
|
||||||
Device Properties to 0 dB.
|
|
||||||
|
@ -12,7 +12,7 @@ those shown in the screen shot below.
|
|||||||
something similar to the to the following screen shot:
|
something similar to the to the following screen shot:
|
||||||
|
|
||||||
[[X12]]
|
[[X12]]
|
||||||
image::main-ui-1.6.png[align="center",alt="Main UI and Wide Graph"]
|
image::main-ui.png[align="center",alt="Main UI and Wide Graph"]
|
||||||
|
|
||||||
.Decoding Overview
|
.Decoding Overview
|
||||||
|
|
||||||
|
@ -7,23 +7,25 @@ frequencies to 1718 Hz.
|
|||||||
|
|
||||||
.Wide Graph Settings:
|
.Wide Graph Settings:
|
||||||
|
|
||||||
- Set *Bins/Pixel* = 7
|
- *Bins/Pixel* = 7
|
||||||
|
- *JT65 .... JT9* = 2500
|
||||||
- Adjust the width of the Wide Graph window so that the upper
|
- Adjust the width of the Wide Graph window so that the upper
|
||||||
frequency limit is approximately 4000 Hz.
|
frequency limit is approximately 4000 Hz.
|
||||||
|
|
||||||
.Open a Wave File:
|
.Open a Wave File:
|
||||||
|
|
||||||
- Select *File | Open* and navigate to +...\save\samples\130610_2343.wav+.
|
- Select *File | Open* and navigate to +...\save\samples\130610_2343.wav+.
|
||||||
The waterfall should look like this:
|
The waterfall should look something like this:
|
||||||
|
|
||||||
//.130610_2343.wav Decode
|
//.130610_2343.wav Decode
|
||||||
[[X14]]
|
[[X14]]
|
||||||
image::130610_2343-wav-80.png[align="left",alt="Wide Graph Decode 130610_2343"]
|
image::130610_2343-wav-80.png[align="left",alt="Wide Graph Decode 130610_2343"]
|
||||||
|
|
||||||
IMPORTANT: Notice the [blue]*BLUE* marker on the waterfall scale, here
|
IMPORTANT: The position pf the blue marker on the waterfall scale is
|
||||||
set at 2500 Hz. Its position is set by the spinner control *JT65 nnnn
|
set by the spinner control *JT65 nnnn JT9*, where nnnn is an audio
|
||||||
JT9*, where nnnn is a frequency in Hz. In *JT9+JT65* mode the program
|
frequency in Hz. In *JT9+JT65* mode the program will automatically
|
||||||
will automatically decode JT9 signals only above this frequency.
|
decode JT9 signals only above this frequency. JT65 signals will be
|
||||||
|
decoded over the full displayed frequency range.
|
||||||
|
|
||||||
JT9 signals appear in the *Cumulative* spectrum as nearly rectangular
|
JT9 signals appear in the *Cumulative* spectrum as nearly rectangular
|
||||||
shapes about 16 Hz wide. They have no clearly visible sync tone like
|
shapes about 16 Hz wide. They have no clearly visible sync tone like
|
||||||
|
@ -9,7 +9,7 @@
|
|||||||
IMPORTANT: Sliders and spinner controls respond to *Arrow* key presses
|
IMPORTANT: Sliders and spinner controls respond to *Arrow* key presses
|
||||||
and *Page Up/Down* key presses, with the *Page* keys moving the
|
and *Page Up/Down* key presses, with the *Page* keys moving the
|
||||||
controls in larger steps. You can also type numbers directly into
|
controls in larger steps. You can also type numbers directly into
|
||||||
the spinner controls.
|
the spinner controls or use the mouse wheel.
|
||||||
|
|
||||||
- Select *Tab 2* (below the *Decode* button) to choose the alternative
|
- Select *Tab 2* (below the *Decode* button) to choose the alternative
|
||||||
set of controls for generating and selecting Tx messages.
|
set of controls for generating and selecting Tx messages.
|
||||||
|
@ -1,13 +1,13 @@
|
|||||||
// Status=review
|
// Status=review
|
||||||
|
|
||||||
- *Bins/Pixel* = 4
|
- *Bins/Pixel* = 4
|
||||||
- *JT65 .... JT9* = 2500
|
|
||||||
- *Start* = 200 Hz
|
- *Start* = 200 Hz
|
||||||
- *N Avg* = 5
|
- *N Avg* = 5
|
||||||
- *Palette* = Digipan
|
- *Palette* = Digipan
|
||||||
- *Flatten* = checked
|
- *Flatten* = checked
|
||||||
- Select *Cumulative* for data display
|
- Select *Cumulative* for data display
|
||||||
- *Gain* and *Zero* sliders set near midscale
|
- *Gain* and *Zero* sliders for waterfall and spectrum set near midscale
|
||||||
|
- *Spec* = 25%
|
||||||
|
|
||||||
- Use the mouse to adjust the width of the *Wide Graph* so that its
|
- Use the mouse to adjust the width of the *Wide Graph* so that its
|
||||||
upper frequency limit is about 2400 Hz.
|
upper frequency limit is about 2400 Hz.
|
||||||
|
@ -1,57 +1,69 @@
|
|||||||
=== VHF Setup
|
=== VHF Setup
|
||||||
|
|
||||||
_WSJT-X_ v1.7.0 builds on the features designed for use on VHF and
|
_WSJT-X_ v1.7 builds on for VHF and
|
||||||
higher bands first introduced in v1.6. These features now include
|
higher bands first introduced in v1.6. These features now include:
|
||||||
*JT4*, a mode particularly useful for EME on the microwave bands;
|
|
||||||
*QRA64*, a mode for EME using a "`Q-ary Repeat Accumulate`" code, a
|
- *JT4*, a mode particularly useful for EME on the microwave bands
|
||||||
|
|
||||||
|
- *QRA64*, a mode for EME using a "`Q-ary Repeat Accumulate`" code, a
|
||||||
low-density partity-check (LDPC) code using a 64-character symbol
|
low-density partity-check (LDPC) code using a 64-character symbol
|
||||||
alphabet; *MSK144*, a mode for meteor scatter using a binary LDPC code
|
alphabet
|
||||||
and offset quadrature phase-shift keying (OQPSK), a waveform also
|
|
||||||
known as Minimum Shift Keying (MSK); and *ISCAT*, intended for other
|
|
||||||
types of scatter propagation. Additional VHF-and-up features include
|
|
||||||
*Echo* mode, for detecting and measuring your own lunar echoes, and
|
|
||||||
automatic high-accuracy *Doppler tracking* for the EME path.
|
|
||||||
|
|
||||||
- To activate the VHF-and-up features check the box labeled _Enable
|
- *MSK144*, a mode for meteor scatter using a binary LDPC code
|
||||||
VHF/UHF/Microwave features_ on the *Settings | General* tab. In most
|
and Offset Quadrature Phase-Shift Keying (OQPSK), a waveform also
|
||||||
cases you will also want to check _Single decode_.
|
known as Minimum Shift Keying (MSK)
|
||||||
|
|
||||||
- If you will be doing EME, check the box _Decode at t = 52 s_
|
- *ISCAT*, intended for other types of scatter propagation.
|
||||||
to allow for the EME path delay on received signals.
|
|
||||||
|
|
||||||
- If you will use automatic Doppler tracking, check the box _Allow Tx
|
- *Echo* mode, for detecting and measuring your own lunar echoes
|
||||||
frequency changes while transmitting_. On the *Radio* tab select
|
|
||||||
_Split Operation_ (use either _Rig_ or _Fake It_: you might need to
|
- Automatic *Doppler tracking* for the EME path
|
||||||
experiment with both).
|
|
||||||
|
To activate the VHF-and-up features:
|
||||||
|
|
||||||
|
- Check the box labeled *Enable VHF/UHF/Microwave features* on the
|
||||||
|
*Settings | General* tab.
|
||||||
|
|
||||||
|
- In most cases you will also want to check *Single decode*.
|
||||||
|
|
||||||
|
- 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*.
|
||||||
|
|
||||||
IMPORTANT: Not all transceivers permit computer adjustments of Tx
|
IMPORTANT: Not all transceivers permit computer adjustments of Tx
|
||||||
frequency while transmitting. Among those that do are the IC-735,
|
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
|
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.
|
upgrade), TS-590S, TS-590SG, Flex 1500 and 5000, HPSDR, Anan-10,
|
||||||
|
Anan-100, and KX3.
|
||||||
|
|
||||||
|
- On the *Radio* tab select *Split Operation* (use either *Rig* or
|
||||||
|
*Fake It*; you may need to experiment with both options to find one
|
||||||
|
that works best with your radio).
|
||||||
|
|
||||||
- The main window reconfigures itself as necessary to include controls
|
- The main window reconfigures itself as necessary to include controls
|
||||||
supporting features of each mode. For example, in JT4 mode the
|
supporting features of each mode. For example, in JT4 mode the
|
||||||
central part of the main window will look like this:
|
central part of the main window might look something like this:
|
||||||
|
|
||||||
image::VHF_controls.png[align="center",alt="VHF Controls"]
|
image::VHF_controls.png[align="center",alt="VHF Controls"]
|
||||||
|
|
||||||
- On the *View* menu, select *Astronomical data* to display a window
|
- On the *View* menu, select *Astronomical data* to display a window
|
||||||
with important information for tracking the Moon and performing
|
with important information for tracking the Moon and performing
|
||||||
automatic Doppler control. Check the box labeled _Doppler tracking_
|
automatic Doppler control. Check the box labeled *Doppler tracking*
|
||||||
to ensure that the right-hand portion of the window is visible.
|
to ensure that the right-hand portion of the window is visible.
|
||||||
|
|
||||||
image::Astronomical_data.png[align="center",alt="Astronomical data"]
|
image::Astronomical_data.png[align="center",alt="Astronomical data"]
|
||||||
|
|
||||||
IMPORTANT: Note that three different types of Doppler tracking are
|
Three different types of Doppler tracking are provided:
|
||||||
provided.
|
|
||||||
|
|
||||||
- Select _Full Doppler to DX Grid_ if you know your QSO partner's locator
|
- Select *Full Doppler to DX Grid* if you know your QSO partner's locator
|
||||||
and he/she will not be using any Doppler control.
|
and he/she will not be using any Doppler control.
|
||||||
|
|
||||||
- Select _Receive only_ to enable EME Doppler tracking of your receive
|
- Select *Receive only* to enable EME Doppler tracking of your receive
|
||||||
frequency to a specific locator; your Tx frequency will remain fixed.
|
frequency to a specific locator; your Tx frequency will remain fixed.
|
||||||
|
|
||||||
- Select _Constant frequency on Moon_ to correct for your own (one-way)
|
- 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
|
Doppler shift to or from the Moon. If your QSO partner does the same
|
||||||
thing, both stations will have the required Doppler compensation.
|
thing, both stations will have the required Doppler compensation.
|
||||||
Moreover, anyone else using this option will hear both of you
|
Moreover, anyone else using this option will hear both of you
|
||||||
@ -77,10 +89,10 @@ the 10 GHz band.
|
|||||||
- If using a transverter, set the appropriate offset on the *Settings
|
- If using a transverter, set the appropriate offset on the *Settings
|
||||||
| Frequencies* tab. Offset is defined as (desired transceiver dial
|
| Frequencies* tab. Offset is defined as (desired transceiver dial
|
||||||
reading) minus (desired on-the-air frequency). For example, when
|
reading) minus (desired on-the-air frequency). For example, when
|
||||||
using a 144 MHz radio at 10368 MHz, _Offset (MHz)_ = (144 - 10368) =
|
using a 144 MHz radio at 10368 MHz, *Offset (MHz)* = (144 - 10368) =
|
||||||
-10224.000. If the band is already in the table, you can edit the
|
-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
|
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_.
|
band can be added by right clicking in the table and selecting *Insert*.
|
||||||
|
|
||||||
image::Add_station_info.png[align="center",alt="Station information"]
|
image::Add_station_info.png[align="center",alt="Station information"]
|
||||||
|
|
||||||
@ -92,7 +104,7 @@ image::decoding_depth.png[align="center",alt="Decoding Depth"]
|
|||||||
|
|
||||||
- By convention, EME with JT4 can use "`short form`" messages. To
|
- By convention, EME with JT4 can use "`short form`" messages. To
|
||||||
activate automatic generation of these messages, check the box labeled
|
activate automatic generation of these messages, check the box labeled
|
||||||
_Sh_ on the main window.
|
*Sh* on the main window.
|
||||||
|
|
||||||
IMPORTANT: Thanks to G3WDG, many additional hints for using JT4 and
|
IMPORTANT: Thanks to G3WDG, many additional hints for using JT4 and
|
||||||
Echo mode on the EME path are available in {jt4eme}.
|
Echo mode on the EME path are available in {jt4eme}.
|
||||||
@ -131,14 +143,14 @@ To make a sequence of echo tests:
|
|||||||
|
|
||||||
- Select *Echo* from the *Mode* menu.
|
- Select *Echo* from the *Mode* menu.
|
||||||
|
|
||||||
- On the Astronomical Data window check _Doppler tracking_ and
|
- On the Astronomical Data window check *Doppler tracking* and
|
||||||
_Constant frequency on the Moon_
|
*Constant frequency on the Moon*
|
||||||
|
|
||||||
- Choose your desired test frequency using the _Frequency above nominal
|
- Choose your desired test frequency using the *Frequency above nominal
|
||||||
band edge_ controls.
|
band edge* controls.
|
||||||
|
|
||||||
- Be sure that your rig control has been set up for _Split Operation_
|
- Be sure that your rig control has been set up for _Split Operation_
|
||||||
(either _Rig_ of _Fake It_) on the *Settings | Radio* tab.
|
(either *Rig* or *Fake It*) on the *Settings | Radio* tab.
|
||||||
|
|
||||||
- Click *Enable Tx* on the main window to start a sequence of 6-second
|
- Click *Enable Tx* on the main window to start a sequence of 6-second
|
||||||
cycles.
|
cycles.
|
||||||
|
@ -115,7 +115,7 @@ bands. <<WSPR,Section 7>> covers WSPR mode, and
|
|||||||
<<VHF_AND_UP,Section 8>> covers VHF+ features. If you are a new
|
<<VHF_AND_UP,Section 8>> covers VHF+ features. If you are a new
|
||||||
user of _WSJT-X_ we suggest that you go through the full HF-oriented
|
user of _WSJT-X_ we suggest that you go through the full HF-oriented
|
||||||
tutorial while at your radio. It should take no more than 20 minutes.
|
tutorial while at your radio. It should take no more than 20 minutes.
|
||||||
If your main interests are WSPR of VHF+, you may then proceed to
|
If your main interests are WSPR or VHF+, you may then proceed to
|
||||||
Sections 7 and 8.
|
Sections 7 and 8.
|
||||||
|
|
||||||
[[TUT_MAIN]]
|
[[TUT_MAIN]]
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
- Select *WSPR-2* from the *Mode* menu. The main window will
|
- Select *WSPR* from the *Mode* menu. The main window will
|
||||||
reconfigure itself to the WSPR interface, removing some controls not
|
reconfigure itself to the WSPR interface, removing some controls not
|
||||||
used in WSPR mode.
|
used in WSPR mode.
|
||||||
|
|
||||||
|
@ -1179,11 +1179,9 @@ void MainWindow::dataSink(qint64 frames)
|
|||||||
t2.sprintf(" -f %.6f ",f0m1500);
|
t2.sprintf(" -f %.6f ",f0m1500);
|
||||||
|
|
||||||
if(m_diskData) {
|
if(m_diskData) {
|
||||||
// cmnd='"' + m_appDir + '"' + "/wsprd " + m_path;
|
|
||||||
cmnd='"' + m_appDir + '"' + "/wsprd -a \"" +
|
cmnd='"' + m_appDir + '"' + "/wsprd -a \"" +
|
||||||
QDir::toNativeSeparators(m_dataDir.absolutePath()) + "\" \"" + m_path + "\"";
|
QDir::toNativeSeparators(m_dataDir.absolutePath()) + "\" \"" + m_path + "\"";
|
||||||
// if(m_TRseconds==900) cmnd='"' + m_appDir + '"' + "/wsprd -m 15" + t2 +
|
// QDir::toNativeSeparators(m_dataDir.absolutePath()) + "\" " + t2 + " " + m_path + "\"";
|
||||||
// m_path + '"';
|
|
||||||
} else {
|
} else {
|
||||||
cmnd='"' + m_appDir + '"' + "/wsprd -a \"" +
|
cmnd='"' + m_appDir + '"' + "/wsprd -a \"" +
|
||||||
QDir::toNativeSeparators(m_dataDir.absolutePath()) + "\" " +
|
QDir::toNativeSeparators(m_dataDir.absolutePath()) + "\" " +
|
||||||
|