diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index ce3fb74db..bb0b4699c 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -85,7 +85,7 @@ set (UG_IMGS user_guide/images/decode-menu.png user_guide/images/main-ui-1.5.png user_guide/images/r3666-main-ui-80.png - user_guide/images/settings-ui.png + user_guide/images/settings-general.png user_guide/images/wide-graph-controls.png user_guide/images/decodes.png user_guide/images/main-ui-controls.png @@ -93,7 +93,7 @@ set (UG_IMGS user_guide/images/setup-menu.png user_guide/images/file-menu.png user_guide/images/misc-controls-center.png - user_guide/images/r4148-freq-ui.png + user_guide/images/settings-frequencies.png user_guide/images/special-mouse-commands.png user_guide/images/psk-reporter.png user_guide/images/jtalert.png diff --git a/doc/user_guide/images/r4148-freq-ui.png b/doc/user_guide/images/r4148-freq-ui.png deleted file mode 100644 index d5679e5bc..000000000 Binary files a/doc/user_guide/images/r4148-freq-ui.png and /dev/null differ diff --git a/doc/user_guide/images/settings-frequencies.png b/doc/user_guide/images/settings-frequencies.png new file mode 100644 index 000000000..c4ddae04d Binary files /dev/null and b/doc/user_guide/images/settings-frequencies.png differ diff --git a/doc/user_guide/images/settings-general.png b/doc/user_guide/images/settings-general.png new file mode 100644 index 000000000..cf0a9de6f Binary files /dev/null and b/doc/user_guide/images/settings-general.png differ diff --git a/doc/user_guide/images/settings-ui.png b/doc/user_guide/images/settings-ui.png deleted file mode 100644 index e6cf2d3d8..000000000 Binary files a/doc/user_guide/images/settings-ui.png and /dev/null differ diff --git a/doc/user_guide/introduction.adoc b/doc/user_guide/introduction.adoc index bfd6c3853..f26469770 100644 --- a/doc/user_guide/introduction.adoc +++ b/doc/user_guide/introduction.adoc @@ -6,38 +6,47 @@ the program name stand for “Weak Signal communication by K1JT,” while the suffix “-X” indicates that _WSJT-X_ started as an extended (and experimental) branch of the program _WSJT_. -_WSJT-X_ currently offers two protocols or “modes,” JT65 and JT9. -Both are designed for making reliable, confirmed 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 JT65 -while using less than 10% of the bandwidth. Both modes use one-minute +_WSJT-X_ offers four protocols or “modes”: JT4, JT9, JT65 and WSPR. +The first three are designed for making reliable, confirmed 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 +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 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. On -the HF bands, world-wide QSOs are possible with power levels of a few -watts and compromise antennas. +the HF bands, world-wide QSOs are possible using power levels of a few +watts and compromise antennas. On VHF bands and higher, QSOs are +possible (by EME and other propagation methods) at signal levels 10 to +15 dB below those required for CW. -_WSJT-X_ can display a passband as large as 5 kHz and provides -dual-mode reception of both JT65 and JT9 signals. If your receiver can -be configured with at least 4 kHz bandwidth in USB mode, you can set -the dial frequency to one of the standard JT65 frequencies — for -example, 14.076 MHz for the 20-meter band — and display the full JT65 -and JT9 sub-bands simultaneously on the waterfall. You can then make -QSOs in both modes using nothing more than mouse clicks. +WSPR (pronounced “whisper”) stands for Weak Signal Propagation +Reporter. 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 -28 dB in a 2500 Hz bandwidth. WSPR users with +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. -Plans for future program development call for _WSJT-X_ and _WSJT_ to -merge together. _WSJT-X_ will gradually acquire additional modes -such as JT4 that are now supported in _WSJT_. The entire -WSJT-related effort is an open-source project, released under the -{gnu_gpl} (GPL). 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. -The project’s source-code repository can be found at {devsvn}, and -most communication among the developers takes place on the email -reflector {devmail}. User-level questions and answers, and general -communication among users is found on the {wsjt_yahoo_group} email -reflector. +_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. + +_WSJT-X_ is an open-source project released under the {gnu_gpl} +(GPL). 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. The project’s source-code repository +can be found at {devsvn}, and most communication among the developers +takes place on the email reflector {devmail}. User-level questions +and answers, and general communication among users is found on the +{wsjt_yahoo_group} email reflector. diff --git a/doc/user_guide/settings-frequencies.adoc b/doc/user_guide/settings-frequencies.adoc index 7f996aafe..458ec0c62 100644 --- a/doc/user_guide/settings-frequencies.adoc +++ b/doc/user_guide/settings-frequencies.adoc @@ -1,24 +1,32 @@ // Status=review [[FIG_BAND_SETTINGS]] -image::images/r4148-freq-ui.png[align="center",alt="Frequency Screen"] +image::images/settings-frequencies.png[align="center",alt="Frequency Screen"] -_Working Frequencies_: By default the *Frequency* table lists the -currently recommended dial frequencies for JT65. JT9 frequencies -generally start 2 kHz higher. You can modify the frequency table as -desired. +_Working Frequencies_: By default the *Working Frequency* table +contains a list of currently recommended dial frequencies for each +mode. You can modify the frequency table as desired. - To change an existing entry, click to select it, type a desired frequency in MHz, and hit *Enter* on the keyboard. The program will format your frequency value appropriately and add a band designator. - To add a new entry, right-click anywhere on the frequency table and -select *Insert*. Enter a frequency in MHz in the popup box, then -click *OK*. The table may include more than one frequency for a given -band. +select *Insert*. Enter a frequency in MHz in the popup box and select +the desired mode (or leave the Mode selection blank). Then click +*OK*. The table may include more than one frequency for a given band. - To delete an entry, right-click it and select *Delete*. +- Click the *Reset* button to return the table to its default +configuration. + +_Frequency Calibration_: If you have calibrated your radio with the +technique described (...here...), 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. + _Station Information_: You can save *Band*, *Offset* and *Antenna Description* information for your station. The antenna information will be included in reception reports sent to {pskreporter}. By diff --git a/doc/user_guide/settings-general.adoc b/doc/user_guide/settings-general.adoc index 7c18e7598..e0e4db8fa 100644 --- a/doc/user_guide/settings-general.adoc +++ b/doc/user_guide/settings-general.adoc @@ -1,6 +1,6 @@ // Status=review [[FIG_CONFIG_STATION]] -image::images/settings-ui.png[align="center",alt="Settings Window"] +image::images/settings-general.png[align="center",alt="Settings Window"] Select the *General* tab on the *Settings* window. Under _Station Details_, enter your call sign and 4-digit or 6-digit grid locator. diff --git a/doc/user_guide/system-requirements.adoc b/doc/user_guide/system-requirements.adoc index 80e2a947e..b7b9ce004 100644 --- a/doc/user_guide/system-requirements.adoc +++ b/doc/user_guide/system-requirements.adoc @@ -2,7 +2,7 @@ - SSB transceiver and antenna - Computer running Windows (XP or later), Linux, or OS X -- 1.5 GHz or faster CPU and 100 MB of available memory +- 1.5 GHz or faster CPU and 200 MB of available memory - Monitor with at least 1024 x 780 resolution - Computer-to-radio interface using a serial port for T/R switching, or CAT control, or VOX, as required for your radio-to-computer connections