Merged user guide generation changes from trunk
Revisions 5316, 5317, 5319, 5320, 5321, 5322, 5323, 5324, 5327, 5369, 5370, 5428, 5429, 5430, 5431, 5432, 5433, 5434, 5435, 5437, 5438, 5439, 5440, 5441, 5442. git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx-1.5@5443 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
@ -41,6 +41,9 @@ if (POLICY CMP0043)
|
||||
endif (POLICY CMP0043)
|
||||
|
||||
|
||||
include (${PROJECT_SOURCE_DIR}/CMake/VersionCompute.cmake)
|
||||
message (STATUS "Building ${CMAKE_PROJECT_NAME}-${wsjtx_VERSION}")
|
||||
|
||||
#
|
||||
# project information
|
||||
#
|
||||
@ -49,7 +52,7 @@ set (PROJECT_VENDOR "Joe Taylor, K1JT")
|
||||
set (PROJECT_CONTACT "Joe Taylor <k1jt@arrl.net>")
|
||||
set (PROJECT_COPYRIGHT "Copyright (C) 2001-2014 by Joe Taylor, K1JT")
|
||||
set (PROJECT_HOMEPAGE "http://www.physics.princeton.edu/pulsar/K1JT/wsjtx.html")
|
||||
set (PROJECT_MANUAL wsjtx-main.html)
|
||||
set (PROJECT_MANUAL wsjtx-main-${wsjtx_VERSION}.html)
|
||||
set (PROJECT_MANUAL_DIRECTORY_URL http://www.physics.princeton.edu/pulsar/K1JT/wsjtx-doc)
|
||||
set (PROJECT_SUMMARY_DESCRIPTION "${PROJECT_NAME} - JT9 and JT65 Modes for LF, MF and HF Amateur Radio.")
|
||||
set (PROJECT_DESCRIPTION "${PROJECT_SUMMARY_DESCRIPTION}
|
||||
@ -80,9 +83,6 @@ set (PROJECT_KVASD_URL http://svn.code.sf.net/p/wsjt/wsjt/trunk/kvasd-binary)
|
||||
|
||||
set (CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/CMake/Modules ${CMAKE_MODULE_PATH})
|
||||
|
||||
include (${PROJECT_SOURCE_DIR}/CMake/VersionCompute.cmake)
|
||||
message (STATUS "Building ${CMAKE_PROJECT_NAME}-${wsjtx_VERSION}")
|
||||
|
||||
# make sure that the default configuration is a RELEASE
|
||||
if (NOT CMAKE_BUILD_TYPE)
|
||||
set (CMAKE_BUILD_TYPE RELEASE CACHE STRING
|
||||
@ -113,6 +113,7 @@ option (WSJT_HAMLIB_TRACE "Debugging option that turns on minimal Hamlib interna
|
||||
option (WSJT_SOFT_KEYING "Apply a ramp to CW keying envelope to reduce transients." ON)
|
||||
option (WSJT_SKIP_MANPAGES "Skip *nix manpage generation.")
|
||||
option (WSJT_EMBED_SAMPLES "Embed sample files into WSJT-X resources." ON)
|
||||
option (WSJT_GENERATE_DOCS "Generate documentation files." ON)
|
||||
|
||||
CMAKE_DEPENDENT_OPTION (WSJT_HAMLIB_VERBOSE_TRACE "Debugging option that turns on full Hamlib internal diagnostics." OFF WSJT_HAMLIB_TRACE OFF)
|
||||
CMAKE_DEPENDENT_OPTION (WSJT_QDEBUG_IN_RELEASE "Leave Qt debugging statements in Release configuration." OFF
|
||||
@ -514,7 +515,9 @@ endif (APPLE)
|
||||
#
|
||||
find_program(CTAGS ctags)
|
||||
find_program(ETAGS etags)
|
||||
|
||||
if (WSJT_GENERATE_DOCS)
|
||||
add_subdirectory (doc)
|
||||
endif (WSJT_GENERATE_DOCS)
|
||||
|
||||
#
|
||||
# C & C++ setup
|
||||
@ -607,13 +610,13 @@ FortranCInterface_HEADER (FC.h MACRO_NAMESPACE "FC_" SYMBOL_NAMESPACE "FC_"
|
||||
#
|
||||
# fetch latest HTML manual
|
||||
#
|
||||
set (WSJT_MANUAL_DIRECTORY "${PROJECT_MANUAL_DIRECTORY_URL}"
|
||||
CACHE STRING "Can be overridden to a local URI")
|
||||
add_custom_target (user_manual ALL
|
||||
${CMAKE_COMMAND} -D URL=${WSJT_MANUAL_DIRECTORY} -D NAME=${PROJECT_MANUAL} -P ${CMAKE_SOURCE_DIR}/CMake/download_html_manual.cmake
|
||||
COMMENT "Downloading ${PROJECT_NAME} HTML manual"
|
||||
VERBATIM
|
||||
)
|
||||
#set (WSJT_MANUAL_DIRECTORY "${PROJECT_MANUAL_DIRECTORY_URL}"
|
||||
# CACHE STRING "Can be overridden to a local URI")
|
||||
#add_custom_target (user_manual ALL
|
||||
# ${CMAKE_COMMAND} -D URL=${WSJT_MANUAL_DIRECTORY} -D NAME=${PROJECT_MANUAL} -P ${CMAKE_SOURCE_DIR}/CMake/download_html_manual.cmake
|
||||
# COMMENT "Downloading ${PROJECT_NAME} HTML manual"
|
||||
# VERBATIM
|
||||
# )
|
||||
|
||||
#
|
||||
# Setup RPATH so that built executable targets will run in both the
|
||||
@ -968,7 +971,6 @@ install (PROGRAMS
|
||||
)
|
||||
|
||||
install (FILES
|
||||
${CMAKE_BINARY_DIR}/contrib/${PROJECT_MANUAL}
|
||||
README
|
||||
COPYING
|
||||
AUTHORS
|
||||
|
@ -695,6 +695,7 @@ Configuration::impl::impl (Configuration * self, QSettings * settings, QWidget *
|
||||
, self_ {self}
|
||||
, ui_ {new Ui::configuration_dialog}
|
||||
, settings_ {settings}
|
||||
, doc_dir_ {QApplication::applicationDirPath ()}
|
||||
, frequencies_ {
|
||||
{
|
||||
136130,
|
||||
|
163
doc/CMakeLists.txt
Normal file
@ -0,0 +1,163 @@
|
||||
set (common_SRCS
|
||||
common/communication.adoc
|
||||
common/license.adoc
|
||||
common/links.adoc
|
||||
)
|
||||
|
||||
set (UG_SRCS
|
||||
user_guide/acknowledgements.adoc
|
||||
user_guide/install-from-source.adoc
|
||||
user_guide/rig-config-drake.adoc
|
||||
user_guide/settings-radio.adoc
|
||||
user_guide/compiling.adoc
|
||||
user_guide/install-linux.adoc
|
||||
user_guide/rig-config-elecraft.adoc
|
||||
user_guide/settings-reporting.adoc
|
||||
user_guide/config-details.adoc
|
||||
user_guide/install-mac.adoc
|
||||
user_guide/rig-config-flexrad.adoc
|
||||
user_guide/settings-txmacros.adoc
|
||||
user_guide/controls-functions-center.adoc
|
||||
user_guide/install-windows.adoc
|
||||
user_guide/rig-config-icom.adoc
|
||||
user_guide/system-requirements.adoc
|
||||
user_guide/controls-functions-left.adoc
|
||||
user_guide/introduction.adoc
|
||||
user_guide/rig-config-kenwood.adoc
|
||||
user_guide/transceiver-setup.adoc
|
||||
user_guide/controls-functions-main-window.adoc
|
||||
user_guide/jt65-jt9-differences.adoc
|
||||
user_guide/rig-config-main.adoc
|
||||
user_guide/tutorial-example1.adoc
|
||||
user_guide/controls-functions-menus.adoc
|
||||
user_guide/jt65-protocol.adoc
|
||||
user_guide/rig-config-softrock.adoc
|
||||
user_guide/tutorial-example2.adoc
|
||||
user_guide/controls-functions-messages.adoc
|
||||
user_guide/jt9-protocol.adoc
|
||||
user_guide/rig-config-template.adoc
|
||||
user_guide/tutorial-main-window.adoc
|
||||
user_guide/controls-functions-status-bar.adoc
|
||||
user_guide/make-qso.adoc
|
||||
user_guide/rig-config-tentec.adoc
|
||||
user_guide/tutorial-wide-graph-settings.adoc
|
||||
user_guide/controls-functions-wide-graph.adoc
|
||||
user_guide/platform-dependencies.adoc
|
||||
user_guide/rig-config-yaesu.adoc
|
||||
user_guide/tx-rx.adoc
|
||||
user_guide/coop-prgrms.adoc
|
||||
user_guide/rig-config-adat.adoc
|
||||
user_guide/settings-audio.adoc
|
||||
user_guide/utilities.adoc
|
||||
user_guide/faq.adoc
|
||||
user_guide/rig-config-alinco.adoc
|
||||
user_guide/settings-frequencies.adoc
|
||||
user_guide/wsjtx-main.adoc
|
||||
user_guide/font-sizes.adoc
|
||||
user_guide/rig-config-aor.adoc
|
||||
user_guide/settings-general.adoc
|
||||
user_guide/cooperating-programs.adoc
|
||||
user_guide/logging.adoc
|
||||
user_guide/settings-colors.adoc
|
||||
)
|
||||
|
||||
set (UG_IMGS
|
||||
user_guide/images/130610_2343-wav-80.png
|
||||
user_guide/images/freemsg.png
|
||||
user_guide/images/misc-main-ui.png
|
||||
user_guide/images/colors.png
|
||||
user_guide/images/status-bar-a.png
|
||||
user_guide/images/MacAppMenu.png
|
||||
user_guide/images/help-menu.png
|
||||
user_guide/images/mode-menu.png
|
||||
user_guide/images/r4148-txmac-ui.png
|
||||
user_guide/images/traditional-msg-box.png
|
||||
user_guide/images/RadioTab.png
|
||||
user_guide/images/keyboard-shortcuts.png
|
||||
user_guide/images/new-msg-box.png
|
||||
user_guide/images/save-menu.png
|
||||
user_guide/images/tx-macros.png
|
||||
user_guide/images/band-settings.png
|
||||
user_guide/images/log-qso.png
|
||||
user_guide/images/r3666-config-screen-80.png
|
||||
user_guide/images/settings-audio.png
|
||||
user_guide/images/view-menu.png
|
||||
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/wide-graph-controls.png
|
||||
user_guide/images/decodes.png
|
||||
user_guide/images/main-ui-controls.png
|
||||
user_guide/images/reporting.png
|
||||
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/special-mouse-commands.png
|
||||
user_guide/images/psk-reporter.png
|
||||
user_guide/images/jtalert.png
|
||||
)
|
||||
|
||||
find_package (PythonInterp 2.4 REQUIRED)
|
||||
if (PYTHON_VERSION_STRING VERSION_GREATER 2.9.9)
|
||||
message (FATAL_ERROR "The asciidoc package requires a Python version less than 3
|
||||
|
||||
Use CMAKE_PREFIX_PATH to point to an earlier version or install one,
|
||||
you can also skip building the documentation by switching the option
|
||||
WSJT_GENERATE_DOCS to OFF.")
|
||||
endif (PYTHON_VERSION_STRING VERSION_GREATER 2.9.9)
|
||||
|
||||
find_program (ASCIIDOC_EXECUTABLE NAMES asciidoc asciidoc.py)
|
||||
if (NOT ASCIIDOC_EXECUTABLE)
|
||||
message (FATAL_ERROR "Asciidoc is required to build the documentation
|
||||
|
||||
Building the documenation may optionally be tured off by setting the CMake
|
||||
option WSJT_GENERATE_DOCS to OFF.")
|
||||
endif (NOT ASCIIDOC_EXECUTABLE)
|
||||
|
||||
include (CMakeParseArguments)
|
||||
|
||||
# generate an HTML document from asciidoc text files(s)
|
||||
#
|
||||
# HTML - variable for output file ${CMAKE_CURRENT_BINARY_DIR}/`$basename ${SOURCE}`.html
|
||||
# SOURCE - top level asciidoc file
|
||||
# ASCIIDOC_OPTIONS - asciidoc command options
|
||||
# DEPENDS - dependent files
|
||||
function (html_document)
|
||||
cmake_parse_arguments (args "" "SOURCE;HTML" "ASCIIDOC_OPTIONS;DEPENDS" ${ARGN})
|
||||
get_filename_component (_output_name_we ${args_SOURCE} NAME_WE)
|
||||
get_filename_component (_path ${args_SOURCE} PATH)
|
||||
set (_doc_file ${CMAKE_CURRENT_BINARY_DIR}/${_output_name_we}.html)
|
||||
add_custom_command (
|
||||
OUTPUT ${_doc_file}
|
||||
WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/${path}
|
||||
COMMAND ${PYTHON_EXECUTABLE} ARGS ${ASCIIDOC_EXECUTABLE} ${args_ASCIIDOC_OPTIONS} --out-file=${CMAKE_CURRENT_BINARY_DIR}/${_output_name_we}.html ${args_SOURCE}
|
||||
DEPENDS ${args_DEPENDS}
|
||||
COMMENT "Generating ${_doc_file}"
|
||||
)
|
||||
set (${args_HTML} ${_doc_file} PARENT_SCOPE)
|
||||
endfunction (html_document)
|
||||
|
||||
configure_file (wsjtx.conf.in wsjtx.conf.out)
|
||||
# copy the file to the final location only if the generated output
|
||||
# changes reduces needless rebuilds
|
||||
execute_process (
|
||||
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
|
||||
COMMAND ${CMAKE_COMMAND} -E copy_if_different wsjtx.conf.out wsjtx.conf
|
||||
)
|
||||
|
||||
html_document(
|
||||
HTML user_guide
|
||||
SOURCE user_guide/wsjtx-main.adoc
|
||||
ASCIIDOC_OPTIONS -a data-uri -a toc2 -a max-width=1024px --conf-file=${CMAKE_CURRENT_BINARY_DIR}/wsjtx.conf --backend=xhtml11 --theme wsjt
|
||||
DEPENDS ${common_SRCS} ${UG_SRCS} ${UG_IMGS} wsjtx.conf.in theme/wsjt/wsjt.css
|
||||
)
|
||||
add_custom_target (docs ALL DEPENDS ${user_guide})
|
||||
|
||||
install (FILES
|
||||
${user_guide}
|
||||
DESTINATION ${WSJT_SHARE_DESTINATION}/${WSJT_DOC_DESTINATION}
|
||||
RENAME ${PROJECT_MANUAL}
|
||||
#COMPONENT runtime
|
||||
)
|
51
doc/README
Normal file
@ -0,0 +1,51 @@
|
||||
This folder contains the sources of WSJT-X documentation. To build
|
||||
these you will need the asciidoc and Python v2 tools installed.
|
||||
|
||||
If you do not wish to build the documentation, it is possible to skip
|
||||
this directory in the WSJT-X build by setting the CMake option
|
||||
WSJT_GENERATE_DOCS to OFF in your build tree.
|
||||
|
||||
|
||||
On Linux
|
||||
========
|
||||
|
||||
You will probably have these installed already if you are building the
|
||||
WSJT-X manpages, if you are not you will just need to install
|
||||
asciidoc:
|
||||
|
||||
sudo apt-get install asciidoc
|
||||
|
||||
or
|
||||
|
||||
sudo yum install asciidoc
|
||||
|
||||
or whatever your distribution and package management requires.
|
||||
|
||||
|
||||
On Mac OS X
|
||||
===========
|
||||
|
||||
I recommend MacPorts:
|
||||
|
||||
sudo port install asciidoc
|
||||
|
||||
|
||||
On Windows
|
||||
==========
|
||||
|
||||
The asciidoc tool is a Python script so you will need to install a
|
||||
version of Python v2. If you already have Python v3 as the default
|
||||
Python interpreter on your system then download and install Python v2
|
||||
(probably v2.7.x) but adjust the installer options so as not to make
|
||||
it the default system Python interpreter, this is normally a
|
||||
configuration option in the MSI installer.
|
||||
|
||||
The current version of asciidoc (8.6.9) is broken on Windows so you
|
||||
will need to get the latest development version:
|
||||
|
||||
download https://github.com/asciidoc/asciidoc/archive/master.zip
|
||||
|
||||
and unzip it somewhere like C:\Tools then you will need to add the
|
||||
path to asciidoc and possibly Python v2 to your CMake tool chain file
|
||||
for building WSJT-X. The directory containing asciidoc.py needs to be
|
||||
included in the CMAKE_PREFIX_PATH variable.
|
17
doc/common/communication.adoc
Normal file
@ -0,0 +1,17 @@
|
||||
The following are established communication channels for the WSJT Group.
|
||||
For updates and other information on the continuing development of _WSJT_,
|
||||
_MAP65_, _WSPR_, _WSPR-X_, and _WSJT-X_ you are invited to subscribe to the
|
||||
{dev_mail_list}.
|
||||
|
||||
.General Information
|
||||
* Main Site: {homepage}
|
||||
* Development Site: {projsummary}
|
||||
|
||||
.Development Related
|
||||
* Project Manager, email: {joe_taylor}
|
||||
* Development Email: {devmail1}
|
||||
* Development Mailing List (join): {dev_mail_list}
|
||||
* Repository Updates, (join): {dev_mail_svn}
|
||||
|
||||
.Community Related
|
||||
* Discussion Board: {wsjt_yahoo_group}
|
15
doc/common/license.adoc
Executable file
@ -0,0 +1,15 @@
|
||||
include::./links.adoc[]
|
||||
_{prog}_ is free software: you can redistribute it and/or modify
|
||||
under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
_{prog}_ is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this documentation. If not, see {gnu_gpl}.
|
||||
|
||||
Copyright (C) 2001-2015 Joseph H Taylor, Jr, {joe_taylor}.
|
110
doc/common/links.adoc
Normal file
@ -0,0 +1,110 @@
|
||||
////
|
||||
Link file to hold all links
|
||||
File Location: ./doc/common/links.adoc
|
||||
Usage example: include::../common/links.adoc[]
|
||||
Syntax: [link-id] [link] [displayed test]
|
||||
|
||||
Example:
|
||||
:pskreporter: http://pskreporter.info/pskmap.html[PSK Reporter]
|
||||
|
||||
[link-id] = :pskreporter:
|
||||
[link] http://pskreporter.info/pskmap.html
|
||||
[displayed test] PSK Reporter
|
||||
|
||||
Perform searches from the doc root directory: C:\JTSDK-DOC\doc
|
||||
Search: grep -rl --exclude-dir="*\.svn" {pskreporter} .
|
||||
grep -rl --exclude-dir="*\.svn" PSK Reporter .
|
||||
grep -rl --exclude-dir="*\.svn" {devsvn} .
|
||||
grep -rl --exclude-dir="*\.svn" {kvasd} .
|
||||
grep -rl --exclude-dir="*\.svn" {ntpsetup} .
|
||||
|
||||
Include links.adoc: grep -rl --exclude-dir="*\.svn" pskreporter .
|
||||
Exclude links.adoc: grep -rl --exclude-dir="*\.svn" {pskreporter} .
|
||||
|
||||
Note(s):
|
||||
a). Don't forget a space then "." at the end.
|
||||
b). To include links.adoc file itself, remove the brackets {} from
|
||||
the pattern search:
|
||||
c). Look at each of the files listed to ensure the [displayed test]
|
||||
still makes sense in the caption. If not, just add another link.
|
||||
d). Edit lines as needed. Keeping them in alphabetic order help see dupes.
|
||||
|
||||
////
|
||||
|
||||
// General URL's
|
||||
//:launchpadac6sl: https://launchpad.net/~jnogatch/+archive/wsjtx[WSJT-X Linux Packages]
|
||||
:asciidoc_cheatsheet: http://powerman.name/doc/asciidoc[AsciiDoc Cheatsheet]
|
||||
:asciidoc_help: http://www.methods.co.nz/asciidoc/userguide.html[AsciiDoc User Guide]
|
||||
:asciidoc_questions: http://www.methods.co.nz/asciidoc/faq.html[AsciiDoc FAQ]
|
||||
:asciidoc_syntax: http://xpt.sourceforge.net/techdocs/nix/tool/asciidoc-syn/ascs01-AsciiDocMarkupSyntaxQuickSummary/single/[AsciiDoc Syntax]
|
||||
:asciidoctor_style: http://asciidoctor.org/docs/asciidoc-writers-guide/#delimited-blocks[AsciiDoctor Styles Guide]
|
||||
:asciidoctor_syntax: http://asciidoctor.org/docs/asciidoc-writers-guide/#delimited-blocks[AsciiDoctor Syntax Guide]
|
||||
:cc_by_sa: http://creativecommons.org/licenses/by-sa/3.0/[Commons Attribution-ShareAlike 3.0 Unported License]
|
||||
:debian32: http://physics.princeton.edu/pulsar/K1JT/wsjtx_{VERSION}_i386.deb[wsjtx_{VERSION}_i386.deb]
|
||||
:debian64: http://physics.princeton.edu/pulsar/K1JT/wsjtx_{VERSION}_amd64.deb[wsjtx_{VERSION}_amd64.deb]
|
||||
:debian: http://www.debian.org/[Debian]
|
||||
:dev_guide: http://www.physics.princeton.edu/pulsar/K1JT/wsjtx-doc/wsjt-dev-guide.html[Dev-Guide]
|
||||
:devsvn1: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/[Devel-SVN]
|
||||
:devsvn: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/[SourceForge]
|
||||
:dimension4: http://www.thinkman.com/dimension4/[Dimension4]
|
||||
:download: http://physics.princeton.edu/pulsar/K1JT/wsjtx.html[Download Page]
|
||||
:dxatlas: http://www.dxatlas.com/[Afreet Software, Inc.]
|
||||
:dxlcommander: http://www.dxlabsuite.com/commander/[Commander]
|
||||
:dxlsuite: http://www.dxlabsuite.com/[DX Lab Suite]
|
||||
:fedora32: http://physics.princeton.edu/pulsar/K1JT/wsjtx-{VERSION}-i686.rpm[wsjtx-{VERSION}-i686.rpm]
|
||||
:fedora64: http://physics.princeton.edu/pulsar/K1JT/wsjtx-{VERSION}-x86_64.rpm[wsjtx-{VERSION}-x86_64.rpm]
|
||||
: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]
|
||||
: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]
|
||||
: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]
|
||||
: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]
|
||||
:ppa: http://en.wikipedia.org/wiki/Personal_Package_Archive[PPA]
|
||||
:projsummary: http://sourceforge.net/projects/wsjt/[Project Summary]
|
||||
:pskreporter: http://pskreporter.info/pskmap.html[PSK Reporter]
|
||||
:sourceforge: https://sourceforge.net/user/registration[SourceForge]
|
||||
:sourceforge-jtsdk: https://sourceforge.net/projects/jtsdk[SourceForge JTSDK]
|
||||
:ubuntu_sdk: https://launchpad.net/~ubuntu-sdk-team/+archive/ppa[Ubuntu SDK Notice]
|
||||
:wsjt_yahoo_group: https://groups.yahoo.com/neo/groups/wsjtgroup/info[WSJT Group]
|
||||
:wsjtx: http://physics.princeton.edu/pulsar/K1JT/wsjtx.html[WSJT-X]
|
||||
:wspr0_guide: http://www.physics.princeton.edu/pulsar/K1JT/WSPR0_Instructions.TXT[WSPR0 Guide]
|
||||
:wspr: http://physics.princeton.edu/pulsar/K1JT/wspr.html[WSPR Home Page]
|
||||
:wsprnet: http://wsprnet.org/drupal/[WSPRnet]
|
||||
:wsprnet_activity: http://wsprnet.org/drupal/wsprnet/activity[WSPRnet Activity page]
|
||||
|
||||
// Download Links
|
||||
:cty_dat: http://www.country-files.com/cty/[here]
|
||||
:hamlib3: https://dl.dropboxusercontent.com/u/4192709/Hamlib-integration-wsjtx.zip[Download]
|
||||
:jtsdk_doc: http://physics.princeton.edu/pulsar/K1JT/JTSDK-DOC.exe[Download]
|
||||
:jtsdk_installer: http://sourceforge.net/projects/jtsdk/files/win32/2.0.0/JTSDK-2.0.0-B2-Win32.exe/download[Download]
|
||||
:jtsdk_omnirig: http://sourceforge.net/projects/jtsdk/files/win32/2.0.0/base/contrib/OmniRig.zip/download[Download]
|
||||
:jtsdk_py: http://physics.princeton.edu/pulsar/K1JT/JTSDK-PY.exe[Download]
|
||||
:jtsdk_qt: http://physics.princeton.edu/pulsar/K1JT/JTSDK-QT.exe[Download]
|
||||
:jtsdk_vcredist: http://sourceforge.net/projects/jtsdk/files/win32/2.0.0/base/contrib/vcredist_x86.exe/download[Download]
|
||||
:kvasd: http://physics.princeton.edu/pulsar/K1JT/kvasd[kvasd]
|
||||
:nh6z: http://www.nh6z.net/Amatuer_Radio_Station_NH6Z/Other_Peoples_Software.html[here]
|
||||
:omnirig: http://www.dxatlas.com/OmniRig/Files/OmniRig.zip[Download]
|
||||
:osx: http://physics.princeton.edu/pulsar/K1JT/wsjtx-{VERSION}-Darwin.dmg[wsjtx-{VERSION}-Darwin.dmg]
|
||||
:svn: http://subversion.apache.org/packages.html#windows[Subversion]
|
||||
:win32: http://physics.princeton.edu/pulsar/K1JT/wsjtx-{VERSION}-win32.exe[wsjtx-{VERSION}-win32.exe]
|
||||
:wsjt_svn: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/[here]
|
||||
:wspr_code: http://physics.princeton.edu/pulsar/K1JT/WSPRcode.exe[WSPRcode.exe]
|
||||
:wspr_svn: http://sourceforge.net/p/wsjt/wsjt/HEAD/tree/branches/wspr/[here]
|
||||
|
||||
// MAIL-TO links
|
||||
:alex_efros: mailto:powerman@powerman.name[Alex Efros]
|
||||
:bill_somerville: mailto:g4wjs -at- c l a s s d e s i g n -dot- com [G4WJS]
|
||||
:dev_mail_list: http://sourceforge.net/mailarchive/forum.php?forum_name=wsjt-devel[WSJT Developers Email List]
|
||||
:dev_mail_svn: https://sourceforge.net/auth/subscriptions/[WSJT SVN Archives]
|
||||
:devmail: mailto:wsjt-devel@lists.sourceforge.net[wsjt-devel]
|
||||
:devmail1: mailto:wsjt-devel@lists.sourceforge.net[Post Message]
|
||||
:greg_beam: mailto:ki7mt@yahoo.com[KI7MT]
|
||||
:joe_taylor: mailto:joe@princeton.edu[K1JT]
|
||||
:stuart_rackman: mailto:srackham@gmail.com[Stuart Rackham]
|
546
doc/theme/wsjt/wsjt.css
vendored
Normal file
@ -0,0 +1,546 @@
|
||||
/* Below is the content of the asciidoc.css file from the asciidoc
|
||||
distribution, the WSJT theme additions are at the bottom of this
|
||||
file */
|
||||
|
||||
/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
|
||||
|
||||
/* Default font. */
|
||||
body {
|
||||
font-family: Georgia,serif;
|
||||
}
|
||||
|
||||
/* Title font. */
|
||||
h1, h2, h3, h4, h5, h6,
|
||||
div.title, caption.title,
|
||||
thead, p.table.header,
|
||||
#toctitle,
|
||||
#author, #revnumber, #revdate, #revremark,
|
||||
#footer {
|
||||
font-family: Arial,Helvetica,sans-serif;
|
||||
}
|
||||
|
||||
body {
|
||||
margin: 1em 5% 1em 5%;
|
||||
}
|
||||
|
||||
a {
|
||||
color: blue;
|
||||
text-decoration: underline;
|
||||
}
|
||||
a:visited {
|
||||
color: fuchsia;
|
||||
}
|
||||
|
||||
em {
|
||||
font-style: italic;
|
||||
color: navy;
|
||||
}
|
||||
|
||||
strong {
|
||||
font-weight: bold;
|
||||
color: #083194;
|
||||
}
|
||||
|
||||
h1, h2, h3, h4, h5, h6 {
|
||||
color: #527bbd;
|
||||
margin-top: 1.2em;
|
||||
margin-bottom: 0.5em;
|
||||
line-height: 1.3;
|
||||
}
|
||||
|
||||
h1, h2, h3 {
|
||||
border-bottom: 2px solid silver;
|
||||
}
|
||||
h2 {
|
||||
padding-top: 0.5em;
|
||||
}
|
||||
h3 {
|
||||
float: left;
|
||||
}
|
||||
h3 + * {
|
||||
clear: left;
|
||||
}
|
||||
h5 {
|
||||
font-size: 1.0em;
|
||||
}
|
||||
|
||||
div.sectionbody {
|
||||
margin-left: 0;
|
||||
}
|
||||
|
||||
hr {
|
||||
border: 1px solid silver;
|
||||
}
|
||||
|
||||
p {
|
||||
margin-top: 0.5em;
|
||||
margin-bottom: 0.5em;
|
||||
}
|
||||
|
||||
ul, ol, li > p {
|
||||
margin-top: 0;
|
||||
}
|
||||
ul > li { color: #aaa; }
|
||||
ul > li > * { color: black; }
|
||||
|
||||
.monospaced, code, pre {
|
||||
font-family: "Courier New", Courier, monospace;
|
||||
font-size: inherit;
|
||||
color: navy;
|
||||
padding: 0;
|
||||
margin: 0;
|
||||
}
|
||||
pre {
|
||||
white-space: pre-wrap;
|
||||
}
|
||||
|
||||
#author {
|
||||
color: #527bbd;
|
||||
font-weight: bold;
|
||||
font-size: 1.1em;
|
||||
}
|
||||
#email {
|
||||
}
|
||||
#revnumber, #revdate, #revremark {
|
||||
}
|
||||
|
||||
#footer {
|
||||
font-size: small;
|
||||
border-top: 2px solid silver;
|
||||
padding-top: 0.5em;
|
||||
margin-top: 4.0em;
|
||||
}
|
||||
#footer-text {
|
||||
float: left;
|
||||
padding-bottom: 0.5em;
|
||||
}
|
||||
#footer-badges {
|
||||
float: right;
|
||||
padding-bottom: 0.5em;
|
||||
}
|
||||
|
||||
#preamble {
|
||||
margin-top: 1.5em;
|
||||
margin-bottom: 1.5em;
|
||||
}
|
||||
div.imageblock, div.exampleblock, div.verseblock,
|
||||
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
|
||||
div.admonitionblock {
|
||||
margin-top: 1.0em;
|
||||
margin-bottom: 1.5em;
|
||||
}
|
||||
div.admonitionblock {
|
||||
margin-top: 2.0em;
|
||||
margin-bottom: 2.0em;
|
||||
margin-right: 10%;
|
||||
color: #606060;
|
||||
}
|
||||
|
||||
div.content { /* Block element content. */
|
||||
padding: 0;
|
||||
}
|
||||
|
||||
/* Block element titles. */
|
||||
div.title, caption.title {
|
||||
color: #527bbd;
|
||||
font-weight: bold;
|
||||
text-align: left;
|
||||
margin-top: 1.0em;
|
||||
margin-bottom: 0.5em;
|
||||
}
|
||||
div.title + * {
|
||||
margin-top: 0;
|
||||
}
|
||||
|
||||
td div.title:first-child {
|
||||
margin-top: 0.0em;
|
||||
}
|
||||
div.content div.title:first-child {
|
||||
margin-top: 0.0em;
|
||||
}
|
||||
div.content + div.title {
|
||||
margin-top: 0.0em;
|
||||
}
|
||||
|
||||
div.sidebarblock > div.content {
|
||||
background: #ffffee;
|
||||
border: 1px solid #dddddd;
|
||||
border-left: 4px solid #f0f0f0;
|
||||
padding: 0.5em;
|
||||
}
|
||||
|
||||
div.listingblock > div.content {
|
||||
border: 1px solid #dddddd;
|
||||
border-left: 5px solid #f0f0f0;
|
||||
background: #f8f8f8;
|
||||
padding: 0.5em;
|
||||
}
|
||||
|
||||
div.quoteblock, div.verseblock {
|
||||
padding-left: 1.0em;
|
||||
margin-left: 1.0em;
|
||||
margin-right: 10%;
|
||||
border-left: 5px solid #f0f0f0;
|
||||
color: #888;
|
||||
}
|
||||
|
||||
div.quoteblock > div.attribution {
|
||||
padding-top: 0.5em;
|
||||
text-align: right;
|
||||
}
|
||||
|
||||
div.verseblock > pre.content {
|
||||
font-family: inherit;
|
||||
font-size: inherit;
|
||||
}
|
||||
div.verseblock > div.attribution {
|
||||
padding-top: 0.75em;
|
||||
text-align: left;
|
||||
}
|
||||
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
|
||||
div.verseblock + div.attribution {
|
||||
text-align: left;
|
||||
}
|
||||
|
||||
div.admonitionblock .icon {
|
||||
vertical-align: top;
|
||||
font-size: 1.1em;
|
||||
font-weight: bold;
|
||||
text-decoration: underline;
|
||||
color: #527bbd;
|
||||
padding-right: 0.5em;
|
||||
}
|
||||
div.admonitionblock td.content {
|
||||
padding-left: 0.5em;
|
||||
border-left: 3px solid #dddddd;
|
||||
}
|
||||
|
||||
div.exampleblock > div.content {
|
||||
border-left: 3px solid #dddddd;
|
||||
padding-left: 0.5em;
|
||||
}
|
||||
|
||||
div.imageblock div.content { padding-left: 0; }
|
||||
span.image img { border-style: none; vertical-align: text-bottom; }
|
||||
a.image:visited { color: white; }
|
||||
|
||||
dl {
|
||||
margin-top: 0.8em;
|
||||
margin-bottom: 0.8em;
|
||||
}
|
||||
dt {
|
||||
margin-top: 0.5em;
|
||||
margin-bottom: 0;
|
||||
font-style: normal;
|
||||
color: navy;
|
||||
}
|
||||
dd > *:first-child {
|
||||
margin-top: 0.1em;
|
||||
}
|
||||
|
||||
ul, ol {
|
||||
list-style-position: outside;
|
||||
}
|
||||
ol.arabic {
|
||||
list-style-type: decimal;
|
||||
}
|
||||
ol.loweralpha {
|
||||
list-style-type: lower-alpha;
|
||||
}
|
||||
ol.upperalpha {
|
||||
list-style-type: upper-alpha;
|
||||
}
|
||||
ol.lowerroman {
|
||||
list-style-type: lower-roman;
|
||||
}
|
||||
ol.upperroman {
|
||||
list-style-type: upper-roman;
|
||||
}
|
||||
|
||||
div.compact ul, div.compact ol,
|
||||
div.compact p, div.compact p,
|
||||
div.compact div, div.compact div {
|
||||
margin-top: 0.1em;
|
||||
margin-bottom: 0.1em;
|
||||
}
|
||||
|
||||
tfoot {
|
||||
font-weight: bold;
|
||||
}
|
||||
td > div.verse {
|
||||
white-space: pre;
|
||||
}
|
||||
|
||||
div.hdlist {
|
||||
margin-top: 0.8em;
|
||||
margin-bottom: 0.8em;
|
||||
}
|
||||
div.hdlist tr {
|
||||
padding-bottom: 15px;
|
||||
}
|
||||
dt.hdlist1.strong, td.hdlist1.strong {
|
||||
font-weight: bold;
|
||||
}
|
||||
td.hdlist1 {
|
||||
vertical-align: top;
|
||||
font-style: normal;
|
||||
padding-right: 0.8em;
|
||||
color: navy;
|
||||
}
|
||||
td.hdlist2 {
|
||||
vertical-align: top;
|
||||
}
|
||||
div.hdlist.compact tr {
|
||||
margin: 0;
|
||||
padding-bottom: 0;
|
||||
}
|
||||
|
||||
.comment {
|
||||
background: yellow;
|
||||
}
|
||||
|
||||
.footnote, .footnoteref {
|
||||
font-size: 0.8em;
|
||||
}
|
||||
|
||||
span.footnote, span.footnoteref {
|
||||
vertical-align: super;
|
||||
}
|
||||
|
||||
#footnotes {
|
||||
margin: 20px 0 20px 0;
|
||||
padding: 7px 0 0 0;
|
||||
}
|
||||
|
||||
#footnotes div.footnote {
|
||||
margin: 0 0 5px 0;
|
||||
}
|
||||
|
||||
#footnotes hr {
|
||||
border: none;
|
||||
border-top: 1px solid silver;
|
||||
height: 1px;
|
||||
text-align: left;
|
||||
margin-left: 0;
|
||||
width: 20%;
|
||||
min-width: 100px;
|
||||
}
|
||||
|
||||
div.colist td {
|
||||
padding-right: 0.5em;
|
||||
padding-bottom: 0.3em;
|
||||
vertical-align: top;
|
||||
}
|
||||
div.colist td img {
|
||||
margin-top: 0.3em;
|
||||
}
|
||||
|
||||
@media print {
|
||||
#footer-badges { display: none; }
|
||||
}
|
||||
|
||||
#toc {
|
||||
margin-bottom: 2.5em;
|
||||
}
|
||||
|
||||
#toctitle {
|
||||
color: #527bbd;
|
||||
font-size: 1.1em;
|
||||
font-weight: bold;
|
||||
margin-top: 1.0em;
|
||||
margin-bottom: 0.1em;
|
||||
}
|
||||
|
||||
div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
|
||||
margin-top: 0;
|
||||
margin-bottom: 0;
|
||||
}
|
||||
div.toclevel2 {
|
||||
margin-left: 2em;
|
||||
font-size: 0.9em;
|
||||
}
|
||||
div.toclevel3 {
|
||||
margin-left: 4em;
|
||||
font-size: 0.9em;
|
||||
}
|
||||
div.toclevel4 {
|
||||
margin-left: 6em;
|
||||
font-size: 0.9em;
|
||||
}
|
||||
|
||||
span.aqua { color: aqua; }
|
||||
span.black { color: black; }
|
||||
span.blue { color: blue; }
|
||||
span.fuchsia { color: fuchsia; }
|
||||
span.gray { color: gray; }
|
||||
span.green { color: green; }
|
||||
span.lime { color: lime; }
|
||||
span.maroon { color: maroon; }
|
||||
span.navy { color: navy; }
|
||||
span.olive { color: olive; }
|
||||
span.purple { color: purple; }
|
||||
span.red { color: red; }
|
||||
span.silver { color: silver; }
|
||||
span.teal { color: teal; }
|
||||
span.white { color: white; }
|
||||
span.yellow { color: yellow; }
|
||||
|
||||
span.aqua-background { background: aqua; }
|
||||
span.black-background { background: black; }
|
||||
span.blue-background { background: blue; }
|
||||
span.fuchsia-background { background: fuchsia; }
|
||||
span.gray-background { background: gray; }
|
||||
span.green-background { background: green; }
|
||||
span.lime-background { background: lime; }
|
||||
span.maroon-background { background: maroon; }
|
||||
span.navy-background { background: navy; }
|
||||
span.olive-background { background: olive; }
|
||||
span.purple-background { background: purple; }
|
||||
span.red-background { background: red; }
|
||||
span.silver-background { background: silver; }
|
||||
span.teal-background { background: teal; }
|
||||
span.white-background { background: white; }
|
||||
span.yellow-background { background: yellow; }
|
||||
|
||||
span.big { font-size: 2em; }
|
||||
span.small { font-size: 0.6em; }
|
||||
|
||||
span.underline { text-decoration: underline; }
|
||||
span.overline { text-decoration: overline; }
|
||||
span.line-through { text-decoration: line-through; }
|
||||
|
||||
div.unbreakable { page-break-inside: avoid; }
|
||||
|
||||
|
||||
/*
|
||||
* xhtml11 specific
|
||||
*
|
||||
* */
|
||||
|
||||
div.tableblock {
|
||||
margin-top: 1.0em;
|
||||
margin-bottom: 1.5em;
|
||||
}
|
||||
div.tableblock > table {
|
||||
border: 3px solid #527bbd;
|
||||
}
|
||||
thead, p.table.header {
|
||||
font-weight: bold;
|
||||
color: #527bbd;
|
||||
}
|
||||
p.table {
|
||||
margin-top: 0;
|
||||
}
|
||||
/* Because the table frame attribute is overriden by CSS in most browsers. */
|
||||
div.tableblock > table[frame="void"] {
|
||||
border-style: none;
|
||||
}
|
||||
div.tableblock > table[frame="hsides"] {
|
||||
border-left-style: none;
|
||||
border-right-style: none;
|
||||
}
|
||||
div.tableblock > table[frame="vsides"] {
|
||||
border-top-style: none;
|
||||
border-bottom-style: none;
|
||||
}
|
||||
|
||||
|
||||
/*
|
||||
* html5 specific
|
||||
*
|
||||
* */
|
||||
|
||||
table.tableblock {
|
||||
margin-top: 1.0em;
|
||||
margin-bottom: 1.5em;
|
||||
}
|
||||
thead, p.tableblock.header {
|
||||
font-weight: bold;
|
||||
color: #527bbd;
|
||||
}
|
||||
p.tableblock {
|
||||
margin-top: 0;
|
||||
}
|
||||
table.tableblock {
|
||||
border-width: 3px;
|
||||
border-spacing: 0px;
|
||||
border-style: solid;
|
||||
border-color: #527bbd;
|
||||
border-collapse: collapse;
|
||||
}
|
||||
th.tableblock, td.tableblock {
|
||||
border-width: 1px;
|
||||
padding: 4px;
|
||||
border-style: solid;
|
||||
border-color: #527bbd;
|
||||
}
|
||||
|
||||
table.tableblock.frame-topbot {
|
||||
border-left-style: hidden;
|
||||
border-right-style: hidden;
|
||||
}
|
||||
table.tableblock.frame-sides {
|
||||
border-top-style: hidden;
|
||||
border-bottom-style: hidden;
|
||||
}
|
||||
table.tableblock.frame-none {
|
||||
border-style: hidden;
|
||||
}
|
||||
|
||||
th.tableblock.halign-left, td.tableblock.halign-left {
|
||||
text-align: left;
|
||||
}
|
||||
th.tableblock.halign-center, td.tableblock.halign-center {
|
||||
text-align: center;
|
||||
}
|
||||
th.tableblock.halign-right, td.tableblock.halign-right {
|
||||
text-align: right;
|
||||
}
|
||||
|
||||
th.tableblock.valign-top, td.tableblock.valign-top {
|
||||
vertical-align: top;
|
||||
}
|
||||
th.tableblock.valign-middle, td.tableblock.valign-middle {
|
||||
vertical-align: middle;
|
||||
}
|
||||
th.tableblock.valign-bottom, td.tableblock.valign-bottom {
|
||||
vertical-align: bottom;
|
||||
}
|
||||
|
||||
|
||||
/*
|
||||
* manpage specific
|
||||
*
|
||||
* */
|
||||
|
||||
body.manpage h1 {
|
||||
padding-top: 0.5em;
|
||||
padding-bottom: 0.5em;
|
||||
border-top: 2px solid silver;
|
||||
border-bottom: 2px solid silver;
|
||||
}
|
||||
body.manpage h2 {
|
||||
border-style: none;
|
||||
}
|
||||
body.manpage div.sectionbody {
|
||||
margin-left: 3em;
|
||||
}
|
||||
|
||||
@media print {
|
||||
body.manpage div#toc { display: none; }
|
||||
}
|
||||
|
||||
|
||||
/* WSJT styling overriding the above which is the content of the
|
||||
standard asciidoc.css style sheet */
|
||||
body {
|
||||
font-family: Arial, Hevetica, sans-serif;
|
||||
}
|
||||
|
||||
h1, h2, h3, h4, h5, h6 {
|
||||
font-family: Georgia, "Times New Roman", Times, serif;
|
||||
}
|
||||
|
||||
a:visited {
|
||||
color: purple;
|
||||
}
|
24
doc/user_guide/acknowledgements.adoc
Normal file
@ -0,0 +1,24 @@
|
||||
// Status=review
|
||||
|
||||
Since 2005 the _WSJT_ project (including programs _WSJT_, _MAP65_,
|
||||
_WSPR_, _WSJT-X_, and _WSPR-X_) has been ``open source'', with all
|
||||
code 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, G4KLA, G4WJS, K3WYC, 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.
|
||||
|
||||
Most of the color palettes for the _WSJT-X_ waterfall were copied from
|
||||
the excellent, well documented, open-source program _fldigi_, by *W1HKJ*
|
||||
and friends.
|
||||
|
||||
We use development tools and libraries from many sources. We
|
||||
particularly wish to acknowledge importance of the GNU Compiler
|
||||
Collection from the Free Software Foundation, the "clang" compiler
|
||||
from LLVM at the University of Illinois, the Qt Project from Digia
|
||||
PLC, and the FFTW package by Matteo Frigo and Steven G. Johnson.
|
20
doc/user_guide/compiling.adoc
Normal file
@ -0,0 +1,20 @@
|
||||
// Status=review
|
||||
// Note to developers. The URL http://developer.berlios.de/projects/wsjt/. is
|
||||
// to a very old src version of WSJT 5.7 or so. WSJTX is not listed at all.
|
||||
// Also, all the Qt4 stuff is now obsolete, and needs to be updated.
|
||||
|
||||
// Web Links
|
||||
// Source File is: dev-guide/source/wsjtx-dev/wsjtx-dev.adoc
|
||||
// At some point, compiling_wsjtx_linux.html needs a name change to: wsjtx-dev.html
|
||||
// These files can only be built on Linux, due to source-highlight being removed
|
||||
// From the windows build batch file.
|
||||
:dev-guide: http://www.physics.princeton.edu/pulsar/K1JT/wsjtx-doc/wsjt-dev-guide.html[WSJT Developers Guide]
|
||||
|
||||
// mail-to links
|
||||
|
||||
A Developer's Guide for WSJT and its sister programs is itself under
|
||||
development. The present draft contains full instructions for
|
||||
compiling _WSJT-X_ in Linux, and an outline of steps required in
|
||||
Windows.
|
||||
|
||||
{dev-guide}
|
4
doc/user_guide/config-details.adoc
Normal file
@ -0,0 +1,4 @@
|
||||
// Status=review
|
||||
[[CONFIG_DETAILS]]
|
||||
|
||||
Are we here?
|
32
doc/user_guide/controls-functions-center.adoc
Normal file
@ -0,0 +1,32 @@
|
||||
// Status=review
|
||||
|
||||
At the center of the main window are a number of controls used when
|
||||
making QSOs:
|
||||
|
||||
//.Misc Controls Center
|
||||
image::images/misc-controls-center.png[align="center",alt="Misc Controls Center"]
|
||||
|
||||
* Check *Tx even* to transmit in even-numbered UTC minutes. Uncheck
|
||||
this box to transmit in the odd minutes. This selection is made
|
||||
automatically when you double-click on a decoded text line, as
|
||||
described in the <<TUTORIAL,Basic Operating Tutorial>>.
|
||||
|
||||
* The Tx and Rx audio frequencies are usually set automatically by
|
||||
double-clicking on decoded text or a signal in the waterfall. They
|
||||
can also be adjusted with spinner controls.
|
||||
|
||||
* You can force Tx frequency to the current Rx frequency by clicking
|
||||
the *Tx<Rx* button, and vice-versa for *Rx<Tx*. (Copy is from right
|
||||
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.
|
||||
|
||||
* 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!
|
||||
|
41
doc/user_guide/controls-functions-left.adoc
Normal file
@ -0,0 +1,41 @@
|
||||
// Status=review
|
||||
|
||||
Controls related to frequency selection, received audio level, the
|
||||
station being called, and date and time are found at lower left of the
|
||||
main window:
|
||||
|
||||
//.Misc Controls Left
|
||||
image::images/misc-main-ui.png[align="center",alt="Mist Menu Items"]
|
||||
|
||||
* A drop-down list of frequencies and bands at upper left lets you
|
||||
select the operating band and sets dial frequency to a value taken
|
||||
from the *Frequencies* tab on the *Settings* window. If CAT control
|
||||
is active the radio's dial frequency will be set accordingly; if not,
|
||||
you must tune the radio manually.
|
||||
|
||||
* Alternatively, you can enter a frequency (in MHz) or band name in
|
||||
recognized ADIF format, for example 630m, 20m, or 70cm. The band-name
|
||||
format works only if a working frequency has been set up on that band,
|
||||
in which case the first working frequency on that band is
|
||||
selected.
|
||||
|
||||
* If you are using CAT control, a small colored square appears in
|
||||
green if the CAT control is activated and functional. The green
|
||||
square contains the character S if the rig is detected to be in
|
||||
*Split* mode. The square becomes red if you have requested CAT
|
||||
control but communication with the radio has been lost.
|
||||
|
||||
IMPORTANT: Many Icom rigs cannot be queried for split status, current
|
||||
VFO or split transmit frequency. Consequently you should not change
|
||||
the current VFO, split status or frequency using controls on the radio
|
||||
when using _WSJT-X_.
|
||||
|
||||
* If *DX Grid* contains a valid Maidenhead locator, the corresponding
|
||||
great-circle azimuth and distance from your location are displayed.
|
||||
|
||||
* The program can maintain a database of callsigns and locators for
|
||||
future reference. Click *Add* to insert the present call and locator
|
||||
in the database; click *Lookup* to retrieve the locator for a
|
||||
previously stored call. This feature is mainly useful for situations
|
||||
in which the number of active stations is modest and reasonably
|
||||
stable, such as EME (Earth-Moon-Earth) communication.
|
51
doc/user_guide/controls-functions-main-window.adoc
Normal file
@ -0,0 +1,51 @@
|
||||
// Status=review
|
||||
The following buttons appear just under the decoded text windows on
|
||||
the main screen:
|
||||
|
||||
//.Main UI Controls
|
||||
image::images/main-ui-controls.png[align="left",width=650,alt="Main UI Controls"]
|
||||
|
||||
* *Log QSO* raises a dialog window pre-filled with known information
|
||||
about a QSO you have nearly completed. You can edit or add to this
|
||||
information before clicking *OK* to log the QSO. If you check *Prompt
|
||||
me to log QSO* on the *Setup* menu, the program will raise the
|
||||
confirmation screen automatically when you send a 73 or free-text
|
||||
message.
|
||||
|
||||
//.Log QSO Window
|
||||
image::images/log-qso.png[align="center",alt="Log QSO"]
|
||||
|
||||
* *Stop* will terminate normal data acquisition in case you want to
|
||||
freeze the waterfall or open and explore a previously recorded audio
|
||||
file.
|
||||
|
||||
* *Monitor* restarts normal receive operation. This button is
|
||||
highlighted in green when the _WSJT-X_ is receiving. If you are
|
||||
using CAT control, toggling *Monitor* OFF relinquishes control of the
|
||||
rig; if *Monitor returns to last used frequency" is selected
|
||||
on the *Settings | General* tab, toggling *Monitor* back ON will
|
||||
return to the original frequency.
|
||||
|
||||
* *Erase* clears the right-hand decoded text window.
|
||||
Double-clicking *Erase* clears both text windows.
|
||||
|
||||
* *Decode* tells the program to repeat the decoding procedure at the
|
||||
Rx frequency (green marker on waterfall), using the most recently
|
||||
completed sequence of received data.
|
||||
|
||||
* *Enable Tx* toggles the program into automatic T/R sequencing mode
|
||||
and highlights the button in red. A transmission will start at
|
||||
the beginning of the selected (odd or even) sequence, or immediately
|
||||
if appropriate. A transmission will not be started any later than 24
|
||||
s into a UTC minute.
|
||||
|
||||
* *Halt Tx* terminates a transmission in progress and disables
|
||||
automatic T/R sequencing.
|
||||
|
||||
* *Tune* may be used to switch into Tx mode and generate an
|
||||
unmodulated carrier at the specified Tx frequency (red marker
|
||||
on waterfall). This process may be useful for adjusting an antenna
|
||||
tuner. The button is highlighted in red while *Tune* is
|
||||
active. Toggle the button a second time to terminate the *Tune*
|
||||
process.
|
||||
|
46
doc/user_guide/controls-functions-menus.adoc
Normal file
@ -0,0 +1,46 @@
|
||||
// Status=review
|
||||
|
||||
Program menus offer many options for configuration and operation.
|
||||
Most of the items are self-explanatory; a few additional details are
|
||||
provided below. Keyboard shortcuts for some frequently used menu
|
||||
items are listed at the right.
|
||||
|
||||
==== WSJT-X menu
|
||||
image::images/MacAppMenu.png[align="left",alt="Mac App Menu"]
|
||||
|
||||
This menu appears on the Macintosh only. *Settings* appears here,
|
||||
labeled as *Preferences*, rather than on the *File* menu. *About
|
||||
WSJT-X* appears here rather than on the *Help* menu.
|
||||
|
||||
[[FILE_MENU]]
|
||||
==== File menu
|
||||
image::images/file-menu.png[align="left",alt="File Menu"]
|
||||
|
||||
[[VIEW_MENU]]
|
||||
==== View Menu
|
||||
image::images/view-menu.png[align="left",alt="View Menu"]
|
||||
|
||||
[[MODE_MENU]]
|
||||
==== Mode Menu
|
||||
image::images/mode-menu.png[align="left",alt="Mode Menu"]
|
||||
|
||||
[[DECODE_MENU]]
|
||||
==== Decode Menu
|
||||
image::images/decode-menu.png[align="left",alt="Decode Menu"]
|
||||
|
||||
[[SAVE_MENU]]
|
||||
[[SAVE-WAV]]
|
||||
==== Save Menu
|
||||
image::images/save-menu.png[align="left",alt="Save Menu"]
|
||||
|
||||
Choose *Save all* to save received data as audio +.wav+ files.
|
||||
*Save decoded* will save only those files containing at least one
|
||||
decoded message.
|
||||
|
||||
[[HELP_MENU]]
|
||||
==== Help Menu
|
||||
image::images/help-menu.png[align="left",alt="Help Menu"]
|
||||
|
||||
image::images/keyboard-shortcuts.png[align="left",alt="Help Menu"]
|
||||
|
||||
image::images/special-mouse-commands.png[align="left",alt="Help Menu"]
|
55
doc/user_guide/controls-functions-messages.adoc
Normal file
@ -0,0 +1,55 @@
|
||||
// Status=review
|
||||
|
||||
Two arrangements of controls are provided for generating and selecting
|
||||
Tx messages. Controls familiar to users of program _WSJT_
|
||||
appear on *Tab 1*, providing six fields for message entry.
|
||||
Pre-formatted messages for the standard minimal QSO are generated when
|
||||
you click *Generate Std Msgs* or double-click on an appropriate line
|
||||
in one of the decoded text windows.
|
||||
|
||||
//.Traditional Message Menu
|
||||
image::images/traditional-msg-box.png[align="center",alt="Traditional Message Menu"]
|
||||
|
||||
* Select the next message to be transmitted (at the start of your next
|
||||
Tx sequence) by clicking on the circle under *Next*.
|
||||
|
||||
* To change to a specified Tx message immediately during a
|
||||
transmission, click on a rectangular button under the *Now* label.
|
||||
Changing a Tx message in mid-stream will slightly reduce the chance of
|
||||
a correct decode, but it is usually OK if done in the first 10-15 s of
|
||||
a transmission.
|
||||
|
||||
* All six Tx message fields are editable. You can modify an
|
||||
automatically generated message or enter a desired message, keeping in
|
||||
mind the strict limits on message content. See <<PROTOCOLS,Protocol
|
||||
Specifications>> for details.
|
||||
|
||||
* Click on the pull-down arrow for message #5 to select one of the
|
||||
pre-stored messages entered on the *Settings | Tx Macros* tab.
|
||||
Pressing *Enter* on a modified message #5 automatically adds that
|
||||
message to the stored macros.
|
||||
|
||||
The second arrangement of controls for generating and selecting
|
||||
Tx messages appears on *Tab 2* of the Message Control Panel:
|
||||
|
||||
//.New Message Menu
|
||||
image::images/new-msg-box.png[align="center",alt="New Message Menu"]
|
||||
|
||||
With this setup you normally follow a top-to-bottom sequence of
|
||||
transmissions from the left column if you are calling CQ, or the right
|
||||
column if answering a CQ.
|
||||
|
||||
* Clicking a button puts the appropriate message in the *Gen Msg* box.
|
||||
If you are already transmitting, the Tx message is changed
|
||||
immediately.
|
||||
|
||||
* You can enter and transmit anything (up to 13 characters, including
|
||||
spaces) in the *Free Msg* box.
|
||||
|
||||
* Click on the pull-down arrow in the *Free Msg* box to select a
|
||||
pre-stored macro. Pressing *Enter* on a modified message here
|
||||
automatically adds that message to the table of stored macros.
|
||||
|
||||
IMPORTANT: During a transmission the actual message being sent always
|
||||
appears in the first box of the status bar (bottom left of the main
|
||||
screen).
|
17
doc/user_guide/controls-functions-status-bar.adoc
Normal file
@ -0,0 +1,17 @@
|
||||
// Status=review
|
||||
|
||||
A *Status Bar* at the bottom edge of the main window provides
|
||||
information about operating conditions.
|
||||
|
||||
//.Status Bar
|
||||
image::images/status-bar-a.png[align="left",alt="New Message Menu"]
|
||||
|
||||
Labels on the *Status Bar* display such information as the program's
|
||||
current operating state, operating mode, the content of your most
|
||||
recent transmitted message, and whether *Double-click on call sets Tx
|
||||
enable* has been selected on the *Settings | General* tab. The first
|
||||
label (operating state) can be Receiving, Tx (for Transmitting), Tune,
|
||||
or the name of file opened from the *File* menu; this label is
|
||||
highlighted in green for Receiving, yellow for Tx, and red for Tune.
|
||||
When transmitting, the Tx message is displayed exactly as it will be
|
||||
decoded by receiving stations.
|
49
doc/user_guide/controls-functions-wide-graph.adoc
Normal file
@ -0,0 +1,49 @@
|
||||
// Status=review
|
||||
|
||||
The following controls appear at the bottom of the Wide Graph window.
|
||||
With the exception of *JT65 nnnn JT9*, they affect only the graphical
|
||||
displays — they have no effect on the decoding process.
|
||||
|
||||
image::images/wide-graph-controls.png[align="center",alt="Wide Graph Controls"]
|
||||
|
||||
- *Bins/Pixel* controls the displayed frequency resolution. Set this
|
||||
value to 1 for the highest possible resolution, or to higher numbers
|
||||
to compress the spectral display. Normal operation with a convenient
|
||||
window size works well at 2 to 8 bins per pixel.
|
||||
|
||||
- *JT65 nnnn JT9* sets the dividing point (blue marker) for wide-band
|
||||
decoding of JT65 and JT9 signals in *JT9+JT65* mode. The decoder
|
||||
looks for JT65 signals everywhere, but JT9 signals only above this
|
||||
frequency.
|
||||
|
||||
- *Start nnn Hz* sets the low-frequency starting point of the
|
||||
waterfall frequency scale.
|
||||
|
||||
- *N Avg* is the number of successive FFTs to be averaged before
|
||||
updating the spectral display. Values around 5 are suitable for
|
||||
normal JT9 and JT65 operation. Adjust *N Avg* to make the waterfall
|
||||
move faster or slower, as desired.
|
||||
|
||||
- *Zero* and *Gain* control the reference level and scaling for
|
||||
waterfall colors. Values around 0 for both parameters are usually
|
||||
about right, depending on the input signal level, the chosen palette,
|
||||
and your own preferences.
|
||||
|
||||
- A dropdown list below the *Palette* label lets you select from a
|
||||
wide range of waterfall color palettes.
|
||||
|
||||
- Click *Adjust* to activate a window that allows you to create a
|
||||
user-defined palette.
|
||||
|
||||
- Check *Flatten* if you want _WSJT-X_ to compensate for a sloping or
|
||||
uneven response across the received passband. For this feature to
|
||||
work properly, remember to restrict the range of displayed frequencies
|
||||
so that only the active part of the spectrum is shown.
|
||||
|
||||
- Select *Current* or *Cumulative* for the spectrum displayed in the
|
||||
bottom one-third of the Wide Graph window. *Current* is the average
|
||||
spectrum over the most recent *N Avg* FFT calculations. *Cumulative*
|
||||
is the average spectrum since the start of the present UTC minute.
|
||||
(*Linear Avg* is not useful for JT9 or JT65; it is intended for use
|
||||
with the yet-to-be implemented JT4 mode.)
|
||||
|
5
doc/user_guide/coop-prgrms.adoc
Normal file
@ -0,0 +1,5 @@
|
||||
There is one program and one service that compliment _WSJT-X_ greatly. They are as follows:
|
||||
|
||||
- {pskreporter}
|
||||
|
||||
- {jtalert}
|
23
doc/user_guide/cooperating-programs.adoc
Normal file
@ -0,0 +1,23 @@
|
||||
_WSJT-X_ is programmed to cooperate closely with several other useful
|
||||
programs.
|
||||
|
||||
* {dxlsuite} and {hrd} were described in the section on <<RADIO,rig control>>.
|
||||
|
||||
* {pskreporter}, by Philip Gladstone, is a web server that gathers
|
||||
reception reports sent by various other programs, including _WSJT-X_.
|
||||
The information is made available in near real time on a world map,
|
||||
and also as statistical summaries of various kinds. A number of
|
||||
options are available to the user; for example, you can request a map
|
||||
showing world-wide JT65 activity on all amateur bands over over the
|
||||
past hour. Such a map might look like this, where different colors
|
||||
represent different bands:
|
||||
|
||||
image::images/psk-reporter.png[align="left",alt="PSK Reporter"]
|
||||
|
||||
* {jtalert}, by VK3AMA, is available only for Windows. It provides
|
||||
many operating aids including automatic logging to several third-party
|
||||
logging programs, audio and visual alerts following a number of
|
||||
optional alert conditions (decoding of a new DXCC, new state, etc.),
|
||||
and convenient direct access to web services such as callsign lookup.
|
||||
|
||||
image::images/jtalert.png[align="left",alt="JTAlert-X image"]
|
83
doc/user_guide/faq.adoc
Normal file
@ -0,0 +1,83 @@
|
||||
////
|
||||
Questions:
|
||||
Should be short one liners ending with ?::
|
||||
If your question is too long for one line, consider multiple questions or rephrase
|
||||
|
||||
Answers:
|
||||
Can be bullet or paragraphs. Bullets make for easier reading.
|
||||
|
||||
Bullet Usage:
|
||||
* = a circle bullet single intent
|
||||
** = circle bullet double indent
|
||||
. = should be avoided as the questions are numbered
|
||||
.. = bullet a, b, c, and so on, double indent
|
||||
|
||||
Alternatives: Use a * Bullet, followed by .. for example, then have
|
||||
a multi-section answer using the * as the section header
|
||||
|
||||
* Section Header 1
|
||||
.. Possible Answer a
|
||||
.. Possible Answer b
|
||||
* Section Header 2
|
||||
.. Possible Answer a
|
||||
.. Possible Answer b
|
||||
|
||||
Link Usage:
|
||||
Use the common/links.adoc for href links to maintain consistency. Try to avoid
|
||||
apostrophes ` or ' as it breaks AsciiDoc syntax without special escaping
|
||||
and they do not translate into other languages well.
|
||||
|
||||
////
|
||||
[qanda]
|
||||
My displayed spectrum is flatter when I do not check the *Flatten* box. What's wrong?::
|
||||
|
||||
_WSJT-X_ does not expect a steep filter edge within the displayed
|
||||
passband. Use a wider IF filter or reduce the displayed passband by
|
||||
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
|
||||
unique identifier as in the following two-instance example. This
|
||||
procedure will isolate the *Settings* file and the writable file
|
||||
location for each instance of _WSJT-X_.
|
||||
|
||||
wsjtx --rig-name=TS2000
|
||||
wsjtx --rig-name=FT847
|
||||
|
||||
When setting up rig control through _OmniRig_, something goes wrong when I click *Test CAT*. What can I do about it?::
|
||||
|
||||
_OmniRig_ apparently has a bug that appears when you click *Test CAT*.
|
||||
Forget using *Test CAT* and just click *OK*. _OmniRig_ then behaves
|
||||
normally.
|
||||
|
||||
I am using _WSJT-X_ with _Ham Radio Deluxe_. All seems well until I start HRD Logbook or DM780 running in parallel; then CAT control becomes unreliable.::
|
||||
|
||||
You may see delays up to 20 seconds or so in frequency changes or
|
||||
other radio commands, due to a bug in HRD. HRD folks are aware of the
|
||||
problem, and are working to resolve it.
|
||||
|
||||
I am running _WSJT-X_ under Ubuntu 14.04. The program starts, but menu bar is missing from the top of the main window and the hot-keys don't work.::
|
||||
|
||||
Ubuntu's new ``Unity'' desktop puts the menu for the currently active
|
||||
window at the top of the primary display screen. You can restore menu
|
||||
bars to their traditional locations by typing the following in a
|
||||
command-prompt window:
|
||||
|
||||
sudo apt-get remove appmenu-qt5
|
15
doc/user_guide/font-sizes.adoc
Normal file
@ -0,0 +1,15 @@
|
||||
// Status=review
|
||||
|
||||
- You can control the program's font sizes by using a text editor
|
||||
(e.g., Windows Notepad or similar) to create a one-line file named
|
||||
+fonts.txt+ in the _WSJT-X_ installation directory. Enter a single
|
||||
line of text with four numbers separated by spaces. The first two
|
||||
numbers control the font size (in points) and weight (on a 0 – 100
|
||||
scale) of most labels on the user interface. The last two numbers
|
||||
control size and weight of text in the *Band Activity* and *Rx
|
||||
Frequency* windows.
|
||||
|
||||
- By default the four numbers are ``8 50 10 50''. If you need larger
|
||||
fonts in the user interface and bold text in the decode windows, try
|
||||
something like ``10 50 12 100'' (without the quotes).
|
||||
|
BIN
doc/user_guide/images/130610_2343-wav-80.png
Normal file
After Width: | Height: | Size: 184 KiB |
BIN
doc/user_guide/images/MacAppMenu.png
Normal file
After Width: | Height: | Size: 55 KiB |
BIN
doc/user_guide/images/RadioTab.png
Normal file
After Width: | Height: | Size: 26 KiB |
BIN
doc/user_guide/images/band-settings.png
Normal file
After Width: | Height: | Size: 19 KiB |
BIN
doc/user_guide/images/colors.png
Normal file
After Width: | Height: | Size: 11 KiB |
BIN
doc/user_guide/images/decode-menu.png
Normal file
After Width: | Height: | Size: 2.2 KiB |
BIN
doc/user_guide/images/decodes.png
Normal file
After Width: | Height: | Size: 21 KiB |
BIN
doc/user_guide/images/file-menu.png
Normal file
After Width: | Height: | Size: 6.7 KiB |
BIN
doc/user_guide/images/freemsg.png
Normal file
After Width: | Height: | Size: 7.0 KiB |
BIN
doc/user_guide/images/help-menu.png
Normal file
After Width: | Height: | Size: 4.8 KiB |
BIN
doc/user_guide/images/jtalert.png
Normal file
After Width: | Height: | Size: 50 KiB |
BIN
doc/user_guide/images/keyboard-shortcuts.png
Normal file
After Width: | Height: | Size: 63 KiB |
BIN
doc/user_guide/images/log-qso.png
Normal file
After Width: | Height: | Size: 14 KiB |
BIN
doc/user_guide/images/main-ui-1.5.png
Normal file
After Width: | Height: | Size: 341 KiB |
BIN
doc/user_guide/images/main-ui-controls.png
Normal file
After Width: | Height: | Size: 2.2 KiB |
BIN
doc/user_guide/images/misc-controls-center.png
Normal file
After Width: | Height: | Size: 3.5 KiB |
BIN
doc/user_guide/images/misc-main-ui.png
Normal file
After Width: | Height: | Size: 6.4 KiB |
BIN
doc/user_guide/images/mode-menu.png
Normal file
After Width: | Height: | Size: 2.6 KiB |
BIN
doc/user_guide/images/new-msg-box.png
Normal file
After Width: | Height: | Size: 5.5 KiB |
BIN
doc/user_guide/images/psk-reporter.png
Normal file
After Width: | Height: | Size: 532 KiB |
BIN
doc/user_guide/images/r3666-config-screen-80.png
Normal file
After Width: | Height: | Size: 26 KiB |
BIN
doc/user_guide/images/r3666-main-ui-80.png
Normal file
After Width: | Height: | Size: 207 KiB |
BIN
doc/user_guide/images/r4148-freq-ui.png
Normal file
After Width: | Height: | Size: 25 KiB |
BIN
doc/user_guide/images/r4148-txmac-ui.png
Normal file
After Width: | Height: | Size: 7.0 KiB |
BIN
doc/user_guide/images/reporting.png
Normal file
After Width: | Height: | Size: 16 KiB |
BIN
doc/user_guide/images/save-menu.png
Normal file
After Width: | Height: | Size: 2.6 KiB |
BIN
doc/user_guide/images/settings-audio.png
Normal file
After Width: | Height: | Size: 13 KiB |
BIN
doc/user_guide/images/settings-ui.png
Normal file
After Width: | Height: | Size: 23 KiB |
BIN
doc/user_guide/images/setup-menu.png
Normal file
After Width: | Height: | Size: 16 KiB |
BIN
doc/user_guide/images/special-mouse-commands.png
Normal file
After Width: | Height: | Size: 53 KiB |
BIN
doc/user_guide/images/status-bar-a.png
Normal file
After Width: | Height: | Size: 1.9 KiB |
BIN
doc/user_guide/images/traditional-msg-box.png
Normal file
After Width: | Height: | Size: 6.0 KiB |
BIN
doc/user_guide/images/tx-macros.png
Normal file
After Width: | Height: | Size: 12 KiB |
BIN
doc/user_guide/images/view-menu.png
Normal file
After Width: | Height: | Size: 2.4 KiB |
BIN
doc/user_guide/images/wide-graph-controls.png
Normal file
After Width: | Height: | Size: 4.3 KiB |
29
doc/user_guide/install-from-source.adoc
Normal file
@ -0,0 +1,29 @@
|
||||
// Status=review
|
||||
|
||||
Source code for _WSJT-X_ is available from a public repository at
|
||||
{devsvn}. To compile the program you will need to install at least the
|
||||
following packages:
|
||||
|
||||
- Subversion 1.8 or later
|
||||
- Qt 5.2 or later
|
||||
- g++ 4.8 or later
|
||||
- gfortran 4.8 or later
|
||||
- fftw3
|
||||
- MinGW (for Windows only)
|
||||
|
||||
Source code for _WSJT-X_ v{VERSION} can be downloaded with the command:
|
||||
|
||||
=====
|
||||
svn co svn://svn.code.sf.net/p/wsjt/wsjt/tags/wsjtx-{VERSION}
|
||||
=====
|
||||
|
||||
and for the current development branch,
|
||||
|
||||
=====
|
||||
svn co svn://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx
|
||||
=====
|
||||
|
||||
If you are interested in contributing to the development and
|
||||
documentation of _WSJT_ and its sister programs, please join the
|
||||
developer's email list {devmail} and let us know of your areas of
|
||||
interest.
|
39
doc/user_guide/install-linux.adoc
Normal file
@ -0,0 +1,39 @@
|
||||
// Status=review
|
||||
|
||||
* For Debian, Ubuntu, and other Debian-based systems:
|
||||
** 32-bit: {debian32}
|
||||
- To install: +sudo dpkg -i wsjtx_{VERSION}_i386.deb+
|
||||
- Uninstall: +sudo dpkg -P wsjtx+
|
||||
** 64-bit: {debian64}
|
||||
- To install: +sudo dpkg -i wsjtx_{VERSION}_amd64.deb+
|
||||
- Uninstall: +sudo dpkg -P wsjtx+
|
||||
** You may also need to execute the following commands in a terminal:
|
||||
|
||||
sudo apt-get install libqt5multimedia5-plugins libqt5serialport5
|
||||
sudo apt-get install libfftw3-single3
|
||||
|
||||
* For Ubuntu 15.04 and similar systems:
|
||||
|
||||
sudo apt-get install libqt5multimedia5-plugins libqt5serialport5
|
||||
sudo apt-get install libfftw3-single3 libqt5opengl5
|
||||
|
||||
* For Fedora, Red Hat, and other rpm-based systems:
|
||||
** 32-bit: {fedora32}
|
||||
- To install: +sudo rpm -i wsjtx-{VERSION}-i686.rpm+
|
||||
- Uninstall: +sudo rpm -e wsjtx+
|
||||
** 64-bit: {fedora64}
|
||||
- To install: +sudo rpm -i wsjtx-{VERSION}-x86_64.rpm+
|
||||
- Uninstall: +sudo rpm -e wsjtx+
|
||||
** You may also need to execute the following commands in a terminal:
|
||||
|
||||
sudo yum install fftw-libs-single qt5-qtmultimedia qt5-qtserialport
|
||||
|
||||
* All Linux users should install a companion program called +kvasd+,
|
||||
the Koetter-Vardy algebraic soft-decision Reed Solomon decoder.
|
||||
Execute the following commands from a terminal:
|
||||
|
||||
sudo add-apt-repository ppa:ki7mt/kvasd-installer
|
||||
sudo apt-get update
|
||||
sudo apt-get install kvasd-installer
|
||||
kvasd-installer
|
||||
|
19
doc/user_guide/install-mac.adoc
Normal file
@ -0,0 +1,19 @@
|
||||
// These instructions are up-to-date for WSJT-X v1.4
|
||||
|
||||
* OS X 10.7 and later: {osx}
|
||||
|
||||
* After downloading it to your desktop, double-click on the dmg file
|
||||
and consult its +ReadMe+ file for important installation notes.
|
||||
|
||||
* If you have already installed a previous version, you can retain it by
|
||||
changing its name in the *Applications* folder (say, from _WSJT-X_ to
|
||||
_WSJT-X_previous_). You can then proceed to the installation phase.
|
||||
|
||||
* Remember to use the Mac's *Audio MIDI Setup* utility to configure
|
||||
your sound card for 48000 Hz, two-channel, 16-bit format.
|
||||
|
||||
* Use *System Preferences* to select an external time source to keep
|
||||
your system clock synchronized to UTC.
|
||||
|
||||
* To uninstall simply drag the _WSJT-X_ application from *Applications*
|
||||
to the *Trash Can*.
|
28
doc/user_guide/install-windows.adoc
Normal file
@ -0,0 +1,28 @@
|
||||
// Status=review
|
||||
|
||||
Download and execute the package file {win32}, following these
|
||||
instructions:
|
||||
|
||||
- Install _WSJT-X_ into its own directory rather than in the conventional
|
||||
location +C:\Program Files\WSJTX+. Suggested installation directories are
|
||||
+C:\WSJTX+ or +C:\WSJT\WSJTX+.
|
||||
|
||||
- All program files relating to _WSJT-X_ will be stored in the chosen
|
||||
installation directory and its subdirectories.
|
||||
|
||||
- Logs and other writeable files will normally be found in the
|
||||
directory +C:\Users\<username>\AppData\Local\WSJT-X+.
|
||||
|
||||
- The built-in Windows facility for time synchronization is usually
|
||||
not adequate. We recommend the program _Meinberg NTP_: see {ntpsetup}
|
||||
for downloading and installation instructions.
|
||||
|
||||
- _WSJT-X_ expects your sound card to do its raw sampling at 48000 Hz.
|
||||
To ensure that this will be so when running under recent versions of
|
||||
Windows, open the system's *Sound* control panel and select in turn the
|
||||
*Recording* and *Playback* tabs. Click on *Properties*, then
|
||||
*Advanced*, and select *16 bit, 48000 Hz (DVD Quality)*.
|
||||
|
||||
- You can uninstall _WSJT-X_ by clicking its *Uninstall* link in the
|
||||
Windows *Start* menu, or by using *Uninstall a Program* on the
|
||||
Windows Control Panel.
|
43
doc/user_guide/introduction.adoc
Normal file
@ -0,0 +1,43 @@
|
||||
// Status=review
|
||||
|
||||
_WSJT-X_ is a computer program designed to facilitate basic amateur
|
||||
radio communication using very weak signals. The first four letters in
|
||||
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
|
||||
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.
|
||||
|
||||
_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.
|
||||
|
||||
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.
|
||||
|
41
doc/user_guide/jt65-jt9-differences.adoc
Normal file
@ -0,0 +1,41 @@
|
||||
// Status=review
|
||||
|
||||
The most striking difference between JT65 and JT9 is the much smaller
|
||||
occupied bandwidth of JT9: 15.6 Hz, compared with 177.6 Hz for JT65A.
|
||||
Transmissions in the two modes are essentially the same length, and
|
||||
both modes use exactly 72 bits to carry message information. At the
|
||||
user level the two modes support nearly identical message structures.
|
||||
|
||||
JT65 signal reports are constrained to the range –1 to –30 dB. This
|
||||
range is more than adequate for EME purposes, but not really enough
|
||||
for optimum use at HF and below. S/N values displayed by the JT65
|
||||
decoder are clamped at an upper limit –1 dB, and in present JT65
|
||||
decoders the S/N scale is nonlinear above –10 dB.
|
||||
|
||||
By comparison, JT9 allows for signal reports in the range –50 to +49
|
||||
dB. It manages this by taking over a small portion of ``message
|
||||
space'' that would otherwise be used for grid locators within 1 degree
|
||||
of the south pole. The S/N scale of the present JT9 decoder is
|
||||
reasonably linear (although it’s not intended to be a precision
|
||||
measurement tool).
|
||||
|
||||
With clean signals and a clean noise background, JT65 achieves nearly
|
||||
100% decoding down to S/N = –22 dB and about 50% success at –24
|
||||
dB. JT9 is about 2 dB better, achieving 50% decoding at –26 dB. Both
|
||||
modes produce extremely low false-decode rates.
|
||||
|
||||
Early experience suggests that under most HF propagation conditions
|
||||
the two modes have comparable reliability. The tone spacing of JT9 is
|
||||
about two-thirds that of JT65, so in some disturbed ionospheric
|
||||
conditions in the higher portion of the HF spectrum, JT65 may perform
|
||||
better.
|
||||
|
||||
JT9 is an order of magnitude better in spectral efficiency. On a busy
|
||||
HF band, the conventional 2-kHz-wide JT65 sub-band is often filled
|
||||
with overlapping signals. Ten times as many JT9 signals can fit into
|
||||
the same frequency range, without collisions.
|
||||
|
||||
JT65 signals often decode correctly even when they overlap. Such
|
||||
behavior is much less likely with JT9 signals, which fill their occupied
|
||||
bandwidth more densely. JT65 may also be more forgiving of small
|
||||
frequency drifts.
|
51
doc/user_guide/jt65-protocol.adoc
Normal file
@ -0,0 +1,51 @@
|
||||
// Status=review
|
||||
|
||||
JT65 was designed for making minimal QSOs via EME (``moon-bounce'') on
|
||||
the VHF and UHF bands. A detailed description of the protocol and its
|
||||
implementation in program _WSJT_ was published in {jt65protocol} for
|
||||
September-October, 2005. Briefly stated, JT65 uses 60 s T/R sequences
|
||||
and carefully structured messages. Standard messages are compressed so
|
||||
that two callsigns and a grid locator can be transmitted in just 71
|
||||
information bits. A 72^nd^ bit serves as a flag to indicate that a
|
||||
message consists of arbitrary text (up to 13 characters) instead of
|
||||
callsigns and a grid locator. Special formats allow other information
|
||||
such as add-on callsign prefixes (e.g., ZA/K1ABC) or numerical signal
|
||||
reports (in dB) to be substituted for the grid locator. The basic aim
|
||||
is to compress the most common messages used for minimally valid QSOs
|
||||
into a minimum fixed number of bits. After compression, a Reed Solomon
|
||||
(63,12) error-control code converts 72-bit user messages into
|
||||
sequences of 63 six-bit channel symbols.
|
||||
|
||||
JT65 requires tight synchronization of time and frequency between
|
||||
transmitting and receiving stations. Each transmission is divided into
|
||||
126 contiguous time intervals or symbols of length 4096/11025 = 0.372
|
||||
s. Within each interval the waveform is a constant-amplitude sinusoid
|
||||
at one of 65 pre-defined frequencies. Frequency steps between
|
||||
intervals are accomplished in a phase-continuous manner. Half of the
|
||||
channel symbols are devoted to a pseudo-random synchronizing vector
|
||||
interleaved with the encoded information symbols. The sync vector
|
||||
allows calibration of time and frequency offsets between transmitter
|
||||
and receiver. A transmission nominally begins at t = 1 s after the
|
||||
start of a UTC minute and finishes at t = 47.8 seconds. The
|
||||
synchronizing tone is at 11025 × 472/4096 = 1270.46 Hz, and is normally
|
||||
sent in each interval having a “1” in the following pseudo-random
|
||||
sequence:
|
||||
|
||||
100110001111110101000101100100011100111101101111000110101011001
|
||||
101010100100000011000000011010010110101010011001001000011111111
|
||||
|
||||
Encoded user information is transmitted during the 63 intervals not
|
||||
used for the sync tone. Each channel symbol generates a tone at
|
||||
frequency 11025 × 472/4096 + 11025/4096 × (N+2) × m, where N is the
|
||||
value of the six-bit symbol, 0 ≤ N ≤ 63, and m is 1, 2, or 4 for JT65
|
||||
sub-modes A, B, or C. Sub-mode JT65A is always used at HF.
|
||||
|
||||
For EME (but, conventionally, not on the HF bands) the signal report
|
||||
OOO is sometimes used instead of numerical signal reports. It is
|
||||
conveyed by reversing sync and data positions in the transmitted
|
||||
sequence. Shorthand messages for RO, RRR, and 73 dispense with the
|
||||
sync vector entirely and use time intervals of 16384/11025 = 1.486 s
|
||||
for pairs of alternating tones. The lower frequency is always 1270.46
|
||||
Hz, the same as that of the sync tone, and the frequency separation is
|
||||
110250/4096 = 26.92 Hz multiplied by n × m, with n = 2, 3, 4 for the
|
||||
messages RO, RRR, and 73.
|
20
doc/user_guide/jt9-protocol.adoc
Normal file
@ -0,0 +1,20 @@
|
||||
// Status=review
|
||||
//Needs work!
|
||||
|
||||
JT9 is designed for making minimally valid QSOs at LF, MF, and HF. It
|
||||
uses 72-bit structured messages nearly identical (at the user level)
|
||||
to those in JT65. Error control coding (ECC) uses a strong
|
||||
convolutional code with constraint length K=32, rate r=1/2, and a zero
|
||||
tail, leading to an encoded message length of (72+31) × 2 = 206
|
||||
information-carrying bits. Modulation is nine-tone frequency-shift
|
||||
keying, 9-FSK. Eight tones are used for data, one for
|
||||
synchronization. Eight data tones means that three data bits are
|
||||
conveyed by each transmitted information symbol. Sixteen symbol
|
||||
intervals are devoted to synchronization, so a transmission requires a
|
||||
total of 206 / 3 + 16 = 85 (rounded up) channel symbols. The sync
|
||||
symbols are those numbered 1, 2, 5, 10, 16, 23, 33, 35, 51, 52, 55,
|
||||
60, 66, 73, 83, and 85 in the transmitted sequence. Each symbol lasts
|
||||
for 6912 sample intervals at 12000 samples per second, or about 0.576
|
||||
seconds. Tone spacing of the 9-FSK modulation is 12000/6912 = 1.736
|
||||
Hz, the inverse of the symbol duration. The total occupied bandwidth
|
||||
is 9 × 1.736 = 15.6 Hz.
|
40
doc/user_guide/logging.adoc
Normal file
@ -0,0 +1,40 @@
|
||||
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}.
|
||||
|
||||
The program option *Show DXCC entity and worked before status*
|
||||
(selectable on the *Settings | General* tab) is intended mostly for
|
||||
use on non-Windows platforms, where {jtalert} is not available. When
|
||||
this option is checked _WSJT-X_ appends some additional information to
|
||||
all CQ messages displayed in the _Band Activity_ window. The name of
|
||||
the DXCC entity is shown, abbreviated if necessary. Your ``worked
|
||||
before'' status for this callsign (according to log file
|
||||
+wsjtx_log.adi+) is flagged with a single character and a change of
|
||||
background color, as follows:
|
||||
|
||||
[horizontal]
|
||||
!:: (default color bright purple) -- New DXCC entity
|
||||
~:: (light pink) -- You have already worked this DXCC entity but not
|
||||
this station
|
||||
:: (green) -- You have previously worked the calling station
|
||||
|
||||
In this respect the program does not distinguish between modes, but it
|
||||
does differentiate between bands.
|
||||
|
||||
_WSJT-X_ includes a built-in +cty.dat+ file containing DXCC prefix
|
||||
information. Updated files can be downloaded from {cty_dat} when
|
||||
required. If an updated +cty.dat+ is present in the logs folder
|
||||
and readable, it will be used in preference to the built-in one.
|
||||
|
||||
The log file +wsjtx_log.adi+ is updated whenever you log a QSO from
|
||||
_WSJT-X_. (Keep in mind that if you erase this file you will lose all
|
||||
``worked before'' information.) You can append or overwrite the
|
||||
+wsjtx_log.adi+ file by exporting your QSO history as an ADIF file
|
||||
from another logging program. Turning *Show DXCC entity and worked
|
||||
before status* off and then on again will cause _WSJT-X_ to re-read
|
||||
the log file. Very large log files may cause _WSJT-X_ to slow down
|
||||
when searching for calls.
|
||||
|
166
doc/user_guide/make-qso.adoc
Normal file
@ -0,0 +1,166 @@
|
||||
// Status=review
|
||||
=== Standard Exchange
|
||||
By longstanding tradition, a minimally valid QSO requires the exchange
|
||||
of callsigns, a signal report or some other information, and
|
||||
acknowledgments. _WSJT-X_ is designed to facilitate making such
|
||||
minimal QSOs using short, structured messages. The process works best
|
||||
if you use these formats and follow standard operating practices. The
|
||||
recommended basic QSO goes something like this:
|
||||
|
||||
[width="90%",cols="3,7,12",options="header"]
|
||||
|=======================================
|
||||
|UTC|Transmitted Message|Comment
|
||||
|0001|CQ K1ABC FN42|K1ABC calls CQ
|
||||
|0002|K1ABC G0XYZ IO91|G0XYZ answers
|
||||
|0003|G0XYZ K1ABC –19|K1ABC sends report
|
||||
|0004|K1ABC G0XYZ R–22|G0XYZ sends acknowledgment and report
|
||||
|0005|G0XYZ K1ABC RRR|K1ABC sends acknowledgment
|
||||
|0006|K1ABC G0XYZ 73|G0XYZ sends 73
|
||||
|=======================================
|
||||
|
||||
*Standard messages* consist of two callsigns (or CQ, QRZ, or DE and
|
||||
one callsign) followed by the transmitting station’s grid locator, a
|
||||
signal report, R plus a signal report, or the final acknowledgements
|
||||
RRR or 73. These messages are compressed and encoded in a highly
|
||||
efficient and reliable way. In uncompressed form (as displayed
|
||||
on-screen) they may contain as many as 22 characters.
|
||||
|
||||
*Signal reports* are specified as signal-to-noise ratio (S/N) in dB,
|
||||
using a standard reference noise bandwidth of 2500 Hz. Thus, in
|
||||
example message at UTC 0003 above, K1ABC is telling G0XYZ that his
|
||||
signal is 19 dB below the noise power in bandwidth 2500 Hz. In the
|
||||
message at 0004, G0XYZ acknowledges receipt of that report and
|
||||
responds with a –22 dB signal report. JT65 reports are constrained to
|
||||
lie in the range –30 to –1 dB, and values are significantly compressed
|
||||
above about -10 dB. JT9 supports the extended range –50 to +49 dB and
|
||||
assigns more reliable numbers to relatively strong signals.
|
||||
|
||||
IMPORTANT: Signals become visible on the waterfall around S/N = –26 dB and
|
||||
audible (to someone with very good hearing) around –15 dB. Thresholds
|
||||
for decodability are around –24 dB for JT65, –26 dB for JT9.
|
||||
|
||||
=== Free Text Messages
|
||||
|
||||
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
|
||||
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
|
||||
or rag-chewing.
|
||||
|
||||
[[COMP-CALL]]
|
||||
=== Compound Callsigns
|
||||
|
||||
Compound callsigns such as xx/K1ABC or K1ABC/x are handled in
|
||||
one of two possible ways:
|
||||
|
||||
.Messages containing Type 1 compound callsigns
|
||||
|
||||
A list of about 350 of the most common prefixes and suffixes can be
|
||||
displayed from the *Help* menu. A single compound callsign involving
|
||||
one item from this list can be used in place of the standard third
|
||||
word of a message (normally a locator, signal report, RRR, or 73).
|
||||
The following examples are all acceptable messages containing *Type 1*
|
||||
compound callsigns:
|
||||
|
||||
CQ ZA/K1ABC
|
||||
CQ K1ABC/4
|
||||
ZA/K1ABC G0XYZ
|
||||
G0XYZ K1ABC/4
|
||||
|
||||
The following messages are _not_ valid, because a third word is not
|
||||
permitted in any message containing a *Type 1* compound callsign:
|
||||
|
||||
ZA/K1ABC G0XYZ -22 #These messages will be sent
|
||||
G0XYZ K1ABC/4 73 #without the third "word"
|
||||
|
||||
A QSO between two stations using *Type 1* compound-callsign messages
|
||||
might look like this:
|
||||
|
||||
CQ ZA/K1ABC
|
||||
ZA/K1ABC G0XYZ
|
||||
G0XYZ K1ABC –19
|
||||
K1ABC G0XYZ R–22
|
||||
G0XYZ K1ABC RRR
|
||||
K1ABC G0XYZ 73
|
||||
|
||||
Notice that the full compound callsign is sent and received in the
|
||||
first two transmissions. After that, the operators omit the add-on
|
||||
prefix or suffix and use the standard structured messages.
|
||||
|
||||
.Type 2 Compound-Callsign Messages
|
||||
|
||||
Prefixes and suffixes _not_ found in the displayable short list are
|
||||
handled by using *Type 2* compound callsigns. In this case the
|
||||
compound callsign must be the second word in a two- or three-word
|
||||
message, and the first word must be CQ, DE, or QRZ. Prefixes can be 1
|
||||
to 4 characters, suffixes 1 to 3 characters. A third word conveying a
|
||||
locator, report, RRR, or 73 is permitted. The following are valid
|
||||
messages containing *Type 2* compound callsigns:
|
||||
|
||||
CQ W4/G0XYZ FM07
|
||||
QRZ K1ABC/VE6 DO33
|
||||
DE W4/G0XYZ FM18
|
||||
DE W4/G0XYZ -22
|
||||
DE W4/G0XYZ R-22
|
||||
DE W4/G0XYZ RRR
|
||||
DE W4/G0XYZ 73
|
||||
|
||||
In each case, the message is treated as *Type 2* because the add-on
|
||||
prefix or suffix is _not_ one of those in the fixed list. Note
|
||||
that a second callsign is never permissible in these messages.
|
||||
|
||||
IMPORTANT: Remember that during a transmission your transmitted message is
|
||||
always displayed in the first label on the *Status Bar*, highlighted
|
||||
in yellow. It is displayed there exactly as another station will
|
||||
receive it. Be sure to check that you are actually transmitting the
|
||||
message you wish to send!
|
||||
|
||||
QSOs involving *Type 2* compound callsigns might look like either
|
||||
of the following sequences
|
||||
|
||||
CQ K1ABC/VE1 FN75
|
||||
K1ABC G0XYZ IO91
|
||||
G0XYZ K1ABC –19
|
||||
K1ABC G0XYZ R–22
|
||||
G0XYZ K1ABC RRR
|
||||
K1ABC/VE1 73
|
||||
|
||||
|
||||
CQ K1ABC FN42
|
||||
DE G0XYZ/W4 FM18
|
||||
G0XYZ K1ABC –19
|
||||
K1ABC G0XYZ R–22
|
||||
G0XYZ K1ABC RRR
|
||||
DE G0XYZ/W4 73
|
||||
|
||||
Operators with a compound callsign use its full form when calling CQ
|
||||
and possibly also in a 73 transmission, as may be required by
|
||||
licensing authorities. Other transmissions during a QSO may use the
|
||||
standard structured messages without callsign prefix or suffix.
|
||||
|
||||
IMPORTANT: If you are using a compound callsign, you may want to
|
||||
experiment with the option *Message generation for type 2 compound
|
||||
callsign holders* on the *Settings | General* tab, so that messages
|
||||
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 <<TUTORIAL,Basic Operating Tutorial>> above, as well as the following
|
||||
checklist:
|
||||
|
||||
- Your callsign and grid locator set to correct values
|
||||
|
||||
- PTT and CAT control (if used) properly configured and tested
|
||||
|
||||
- Computer clock properly synchronized to UTC within ±1 s
|
||||
|
||||
- Radio set to *USB* (upper sideband) mode
|
||||
|
||||
- Radio filters centered and set to widest available passband (up to 5 kHz).
|
||||
|
||||
IMPORTANT: Remember that JT9 and J65 generally do not require high
|
||||
power. Under most HF propagation conditions, QRP is the norm.
|
48
doc/user_guide/platform-dependencies.adoc
Normal file
@ -0,0 +1,48 @@
|
||||
// Status=review
|
||||
|
||||
A few _WSJT-X_ features behave differently in Windows, Linux, or OS X,
|
||||
or may not be relevant to all operating platforms.
|
||||
|
||||
.File locations
|
||||
* *Windows*
|
||||
Settings::
|
||||
+%LOCALAPPDATA%\WSJT-X\WSJT-X.ini+
|
||||
Log files::
|
||||
+%LOCALAPPDATA%\WSJT-X\+
|
||||
Default save::
|
||||
+%LOCALAPPDATA%\WSJT-X\save\+
|
||||
|
||||
* *Windows, when using "--rig-name=xxx"*
|
||||
Settings::
|
||||
+%LOCALAPPDATA%\WSJT-X - xxx+
|
||||
Log files::
|
||||
+%LOCALAPPDATA%\WSJT-X - xxx\WSJT-X - xxx.ini+
|
||||
|
||||
* *Linux*
|
||||
Settings::
|
||||
+~/.config/WSJT-X.ini+
|
||||
Log files::
|
||||
+~/.local/share/WSJT-X/+
|
||||
Default save::
|
||||
+~/.local/share/WSJT-X/save/+
|
||||
|
||||
* *Linux, when using "--rig-name=xxx"*
|
||||
Log files::
|
||||
+~/.local/share/WSJT-X - xxx/+
|
||||
Default save::
|
||||
+~/.config/WSJT-x - xxx.ini+
|
||||
|
||||
* *Macintosh*
|
||||
Settings::
|
||||
+~/Library/Preferences/WSJT-X.ini+
|
||||
Log files::
|
||||
+~/Library/Application Support/WSJT-X/+
|
||||
Default save::
|
||||
+~/Library/Application Support/WSJT-X/save/+
|
||||
|
||||
* *Macintosh, when using "--rig-name=xxx"*
|
||||
Log files::
|
||||
+~/Library/Application Support/WSJT-X - xxx/+
|
||||
Default save::
|
||||
+~/Library/Preferences/WSJT-X - xxx.ini+
|
||||
|
104
doc/user_guide/rig-config-adat.adoc
Normal file
@ -0,0 +1,104 @@
|
||||
// Status=needsupdate
|
||||
// This is a comment line, anything with // is ignored at process time.
|
||||
// because the page is not a main page include, we need to add
|
||||
// ref-links again, as they are not global.
|
||||
:icons:
|
||||
:badges:
|
||||
:rig_template: link:rig-config-template.html[Template]
|
||||
:devmail: mailto:wsjt-devel@lists.berlios.de[wsjt-devel]
|
||||
|
||||
= ADAT Configuration Guide
|
||||
Available Configurations
|
||||
|
||||
If you have configuration data for a rig that is not listed, or comments about a
|
||||
particular rig configuration, please use the {rig_template} and send it to
|
||||
{devmail}.
|
||||
|
||||
[align="center",valign="middle",halign="center"]
|
||||
// 5 Models per line please
|
||||
|========
|
||||
|<<X1,ADAT1>>|<<X2,ADAT2>>|ADAT3|ADAT4|ADAT5
|
||||
|========
|
||||
|
||||
[[X1]]
|
||||
== ADAT-1
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
||||
[[X2]]
|
||||
== ADAT-2
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
- Note-1/2/3
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio
|
||||
-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
104
doc/user_guide/rig-config-alinco.adoc
Normal file
@ -0,0 +1,104 @@
|
||||
// Status=needsupdate
|
||||
// This is a comment line, anything with // is ignored at process time.
|
||||
// because the page is not a main page include, we need to add
|
||||
// ref-links again, as they are not global.
|
||||
:icons:
|
||||
:badges:
|
||||
:rig_template: link:rig-config-template.html[Template]
|
||||
:devmail: mailto:wsjt-devel@lists.berlios.de[wsjt-devel]
|
||||
|
||||
= Alinco Configuration Guide
|
||||
Available Configurations
|
||||
|
||||
If you have configuration data for a rig that is not listed, or comments about a
|
||||
particular rig configuration, please use the {rig_template} and send it to
|
||||
{devmail}.
|
||||
|
||||
[align="center",valign="middle",halign="center"]
|
||||
// 5 Models per line please
|
||||
|========
|
||||
|<<X1,Alinco1>>|<<X2,Alinco2>>|Alinco3|Alinco4|Alinco5
|
||||
|========
|
||||
|
||||
[[X1]]
|
||||
== Alinco-1
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
||||
[[X2]]
|
||||
== Alinco-2
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
- Note-1/2/3
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio
|
||||
-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
103
doc/user_guide/rig-config-aor.adoc
Normal file
@ -0,0 +1,103 @@
|
||||
// Status=needsupdate
|
||||
// This is a comment line, anything with // is ignored at process time.
|
||||
// because the page is not a main page include, we need to add
|
||||
// ref-links again, as they are not global.
|
||||
:icons:
|
||||
:badges:
|
||||
:rig_template: link:rig-config-template.html[Template]
|
||||
:devmail: mailto:wsjt-devel@lists.berlios.de[wsjt-devel]
|
||||
|
||||
= AOR Configuration Guide
|
||||
Available Configurations
|
||||
|
||||
If you have configuration data for a rig that is not listed, or comments about a
|
||||
particular rig configuration, please use the {rig_template} and send it to
|
||||
{devmail}.
|
||||
|
||||
[align="center",valign="middle",halign="center"]
|
||||
// 5 Models per line please
|
||||
|========
|
||||
|<<X1,AOR1>>|<<X2,AOR2>>|AOR3|AOR4|AOR5
|
||||
|========
|
||||
|
||||
[[X1]]
|
||||
== AOR-1
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
||||
[[X2]]
|
||||
== AOR-2
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
- Note-1/2/3
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio
|
||||
-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
104
doc/user_guide/rig-config-drake.adoc
Normal file
@ -0,0 +1,104 @@
|
||||
// Status=needsupdate
|
||||
// This is a comment line, anything with // is ignored at process time.
|
||||
// because the page is not a main page include, we need to add
|
||||
// ref-links again, as they are not global.
|
||||
:icons:
|
||||
:badges:
|
||||
:rig_template: link:rig-config-template.html[Template]
|
||||
:devmail: mailto:wsjt-devel@lists.berlios.de[wsjt-devel]
|
||||
|
||||
= Drake Configuration Guide
|
||||
Available Configurations
|
||||
|
||||
If you have configuration data for a rig that is not listed, or comments about a
|
||||
particular rig configuration, please use the {rig_template} and send it to
|
||||
{devmail}.
|
||||
|
||||
[align="center",valign="middle",halign="center"]
|
||||
// 5 Models per line please
|
||||
|========
|
||||
|<<X1,Drake1>>|<<X2,Drake2>>|Drake3|Drake4|Drake5
|
||||
|========
|
||||
|
||||
[[X1]]
|
||||
== Drake-1
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
||||
[[X2]]
|
||||
== Drake-2
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
- Note-1/2/3
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio
|
||||
-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
104
doc/user_guide/rig-config-elecraft.adoc
Normal file
@ -0,0 +1,104 @@
|
||||
// Status=needsupdate
|
||||
// This is a comment line, anything with // is ignored at process time.
|
||||
// because the page is not a main page include, we need to add
|
||||
// ref-links again, as they are not global.
|
||||
:icons:
|
||||
:badges:
|
||||
:rig_template: link:rig-config-template.html[Template]
|
||||
:devmail: mailto:wsjt-devel@lists.berlios.de[wsjt-devel]
|
||||
|
||||
= ElectroCraft Configuration Guide
|
||||
Available Configurations
|
||||
|
||||
If you have configuration data for a rig that is not listed, or comments about a
|
||||
particular rig configuration, please use the {rig_template} and send it to
|
||||
{devmail}.
|
||||
|
||||
[align="center",valign="middle",halign="center"]
|
||||
// 5 Models per line please
|
||||
|========
|
||||
|<<X1,ElectroCraft1>>|<<X2,ElectroCraft2>>|ElectroCraft3|ElectroCraft4|ElectroCraft5
|
||||
|========
|
||||
|
||||
[[X1]]
|
||||
== ElectroCraft-1
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
||||
[[X2]]
|
||||
== ElectroCraft-2
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
- Note-1/2/3
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio
|
||||
-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
104
doc/user_guide/rig-config-flexrad.adoc
Normal file
@ -0,0 +1,104 @@
|
||||
// Status=needsupdate
|
||||
// This is a comment line, anything with // is ignored at process time.
|
||||
// because the page is not a main page include, we need to add
|
||||
// ref-links again, as they are not global.
|
||||
:icons:
|
||||
:badges:
|
||||
:rig_template: link:rig-config-template.html[Template]
|
||||
:devmail: mailto:wsjt-devel@lists.berlios.de[wsjt-devel]
|
||||
|
||||
= Flex Radio Configuration Guide
|
||||
Available Configurations
|
||||
|
||||
If you have configuration data for a rig that is not listed, or comments about a
|
||||
particular rig configuration, please use the {rig_template} and send it to
|
||||
{devmail}.
|
||||
|
||||
[align="center",valign="middle",halign="center"]
|
||||
// 5 Models per line please
|
||||
|========
|
||||
|<<X1,Flex1>>|<<X2,Flex2>>|Flex3|Flex4|Flex5
|
||||
|========
|
||||
|
||||
[[X1]]
|
||||
== Flex-1
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
||||
[[X2]]
|
||||
== Flex-2
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
- Note-1/2/3
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio
|
||||
-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
104
doc/user_guide/rig-config-icom.adoc
Normal file
@ -0,0 +1,104 @@
|
||||
// Status=needsupdate
|
||||
// This is a comment line, anything with // is ignored at process time.
|
||||
// because the page is not a main page include, we need to add
|
||||
// ref-links again, as they are not global.
|
||||
:icons:
|
||||
:badges:
|
||||
:rig_template: link:rig-config-template.html[Template]
|
||||
:devmail: mailto:wsjt-devel@lists.berlios.de[wsjt-devel]
|
||||
|
||||
= Icom Configuration Guide
|
||||
Available Configurations
|
||||
|
||||
If you have configuration data for a rig that is not listed, or comments about a
|
||||
particular rig configuration, please use the {rig_template} and send it to
|
||||
{devmail}.
|
||||
|
||||
[align="center",valign="middle",halign="center"]
|
||||
// 5 Models per line please
|
||||
|========
|
||||
|<<X1,Icom1>>|<<X2,Icom2>>|Icom3|Icom4|Icom5
|
||||
|========
|
||||
|
||||
[[X1]]
|
||||
== Icom-1
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
||||
[[X2]]
|
||||
== Icom-2
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
- Note-1/2/3
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio
|
||||
-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
104
doc/user_guide/rig-config-kenwood.adoc
Normal file
@ -0,0 +1,104 @@
|
||||
// Status=needsupdate
|
||||
// This is a comment line, anything with // is ignored at process time.
|
||||
// because the page is not a main page include, we need to add
|
||||
// ref-links again, as they are not global.
|
||||
:icons:
|
||||
:badges:
|
||||
:rig_template: link:rig-config-template.html[Template]
|
||||
:devmail: mailto:wsjt-devel@lists.berlios.de[wsjt-devel]
|
||||
|
||||
= Kenwood Configuration Guide
|
||||
Available Configurations
|
||||
|
||||
If you have configuration data for a rig that is not listed, or comments about a
|
||||
particular rig configuration, please use the {rig_template} and send it to
|
||||
{devmail}.
|
||||
|
||||
[align="center",valign="middle",halign="center"]
|
||||
// 5 Models per line please
|
||||
|========
|
||||
|<<X1,Kenwood1>>|<<X2,Kenwood2>>|Kenwood3|Kenwood4|Kenwood5
|
||||
|========
|
||||
|
||||
[[X1]]
|
||||
== Kenwood-1
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
||||
[[X2]]
|
||||
== Kenwood-2
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
- Note-1/2/3
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio
|
||||
-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
33
doc/user_guide/rig-config-main.adoc
Normal file
@ -0,0 +1,33 @@
|
||||
// Status=review
|
||||
:adat: link:rig-config-adat.html[ ADAT]
|
||||
:alinco: link:rig-config-alinco.html[ Alinco ]
|
||||
:aor: link:rig-config-aor.html[ AOR ]
|
||||
:drake: link:rig-config-drake.html[ Drake ]
|
||||
:elecraft: link:rig-config-elecraft.html[ Elecraft ]
|
||||
:flexrad: link:rig-config-flexrad.html[ Flex Radio ]
|
||||
:kenwood: link:rig-config-kenwood.html[ Kenwood ]
|
||||
:icom: link:rig-config-icom.html[ Icom ]
|
||||
:rig_template: link:rig-config-template.html[Template]
|
||||
:softrock: link:rig-config-softrock.html[ Soft Rock ]
|
||||
:tentec: link:rig-config-tentec.html[ Ten Tec ]
|
||||
:yaesu: link:rig-config-yaesu.html[Yaesu]
|
||||
|
||||
Some rigs work with DTR, RTS, Polling, CAT, and PTT while others do
|
||||
not. The number of possible combinations is virtually endless. The
|
||||
purpose of this section is to provide configuration information for
|
||||
specific rig models, e.g. Icom 756 Pro-III, Kenwood TS-2000, Yaesu
|
||||
FT-1000MP, Flex-5000, etc. This is a work-in-progress, and some rigs
|
||||
may never be covered.
|
||||
|
||||
IMPORTANT: If you have configuration data for a rig that is not listed, or
|
||||
comments about a particular rig configuration, please use the
|
||||
{rig_template} and send it to {devmail}.
|
||||
|
||||
.Select Manufacturer
|
||||
[align="center",valign="middle",halign="center"]
|
||||
|========
|
||||
|{adat}|{aor}|{alinco}|{drake}|{elecraft}
|
||||
|{flexrad}|{kenwood}|{icom}|{softrock}|{tentec}
|
||||
|{yaesu}|{rig_template}|||
|
||||
|========
|
||||
|
104
doc/user_guide/rig-config-softrock.adoc
Normal file
@ -0,0 +1,104 @@
|
||||
// Status=needsupdate
|
||||
// This is a comment line, anything with // is ignored at process time.
|
||||
// because the page is not a main page include, we need to add
|
||||
// ref-links again, as they are not global.
|
||||
:icons:
|
||||
:badges:
|
||||
:rig_template: link:rig-config-template.html[Template]
|
||||
:devmail: mailto:wsjt-devel@lists.berlios.de[wsjt-devel]
|
||||
|
||||
= SoftRock Configuration Guide
|
||||
Available Configurations
|
||||
|
||||
If you have configuration data for a rig that is not listed, or comments about a
|
||||
particular rig configuration, please use the {rig_template} and send it to
|
||||
{devmail}.
|
||||
|
||||
[align="center",valign="middle",halign="center"]
|
||||
// 5 Models per line please
|
||||
|========
|
||||
|<<X1,SR1>>|<<X2,SR2>>|SR3|SR4|SR5
|
||||
|========
|
||||
|
||||
[[X1]]
|
||||
== SR-1
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
||||
[[X2]]
|
||||
== SR-2
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
- Note-1/2/3
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio
|
||||
-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
60
doc/user_guide/rig-config-template.adoc
Normal file
@ -0,0 +1,60 @@
|
||||
// Status=review
|
||||
// because the page is not a main page include, we need to add
|
||||
// ref-links again, as they are not global.
|
||||
:icons:
|
||||
:badges:
|
||||
:devmail: mailto:wsjt-devel@lists.berlios.de[wsjt-devel]
|
||||
= Rig Template
|
||||
|
||||
This is a simple guide for providing rig configuration data for the WSJT-X
|
||||
User Guide. Try to fill out as much as possible, but do not worry if you cannot
|
||||
fill in all the fields. OS Specific & Interface Notes are a bonus.
|
||||
|
||||
* Copy and paste the template into a text file.
|
||||
* Save as the rig's model.txt: rig-confg-ic756p3.txt
|
||||
* Email the file to {devmail} for inclusion.
|
||||
* Alternatively, join the team and submit the updates directly.
|
||||
|
||||
.Copy & Paste the following:
|
||||
----------
|
||||
Manufacturer:
|
||||
Model:
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
----------
|
||||
|
104
doc/user_guide/rig-config-tentec.adoc
Normal file
@ -0,0 +1,104 @@
|
||||
// Status=needsupdate
|
||||
// This is a comment line, anything with // is ignored at process time.
|
||||
// because the page is not a main page include, we need to add
|
||||
// ref-links again, as they are not global.
|
||||
:icons:
|
||||
:badges:
|
||||
:rig_template: link:rig-config-template.html[Template]
|
||||
:devmail: mailto:wsjt-devel@lists.berlios.de[wsjt-devel]
|
||||
|
||||
= Ten Tec Configuration Guide
|
||||
Available Configurations
|
||||
|
||||
If you have configuration data for a rig that is not listed, or comments about a
|
||||
particular rig configuration, please use the {rig_template} and send it to
|
||||
{devmail}.
|
||||
|
||||
[align="center",valign="middle",halign="center"]
|
||||
// 5 Models per line please
|
||||
|========
|
||||
|<<X1,TenTec1>>|<<X2,TenTec2>>|TenTec3|TenTec4|TenTec5
|
||||
|========
|
||||
|
||||
[[X1]]
|
||||
== TenTec-1
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
||||
[[X2]]
|
||||
== TenTec-2
|
||||
.Configuration Covers:
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
- Note-1/2/3
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio
|
||||
-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
102
doc/user_guide/rig-config-yaesu.adoc
Normal file
@ -0,0 +1,102 @@
|
||||
// Status=review
|
||||
// This is a comment line, anything with // is ignored at process time.
|
||||
// because the page is not a main page include, we need to add
|
||||
// ref-links again, as they are not global.
|
||||
:icons:
|
||||
:badges:
|
||||
:rig_template: link:rig-config-template.html[Template]
|
||||
:devmail: mailto:wsjt-devel@lists.berlios.de[wsjt-devel]
|
||||
|
||||
= Yaesu Configuration Guide
|
||||
Available Configurations
|
||||
|
||||
If you have configuration data for a rig that is not listed, or comments about a
|
||||
particular rig configuration, please use the {rig_template} and send it to
|
||||
{devmail}.
|
||||
|
||||
[align="center",valign="middle",halign="center"]
|
||||
// 5 Models per line please
|
||||
|========
|
||||
|<<X1,FT-1000>>|<<X2,FT-2000>>|FT-3000|FT-5000|FT-9000
|
||||
|========
|
||||
|
||||
[[X1]]
|
||||
== FT-1000
|
||||
.Configuration Covers FT-1000, FT-1000MP, FT-1000D
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
||||
[[X2]]
|
||||
== FT-2000
|
||||
.Configuration Covers FT-2000, FT-2000D
|
||||
|
||||
* MyCall:
|
||||
* MyGrid:
|
||||
* PTT Method:
|
||||
* Pskreporter:
|
||||
* CW Id After 73:
|
||||
* CW Interval:
|
||||
* CAT NOTES:
|
||||
* DTR:
|
||||
* RTS:
|
||||
* CAT Port:
|
||||
* CAT Port Settings:
|
||||
* Split:
|
||||
* Polling:
|
||||
* Audio-In:
|
||||
* Audio-In Mono:
|
||||
* Audio-Out:
|
||||
* Audio-Out:
|
||||
|
||||
=== OS Specific Notes
|
||||
.Notes Relating To Operating System
|
||||
|
||||
* Windows: XP, Vista, Win7, Win8, etc.
|
||||
* Linux: Slackaware, Fedora, FreeBSD, Ubuntu, Debian, etc
|
||||
* Mac OSx:
|
||||
|
||||
=== Interface Notes
|
||||
.Notes Relating To Rig Interface
|
||||
|
||||
* Navigator
|
||||
* SignaLink
|
||||
* ShackLan
|
||||
* Kam
|
||||
* DX-Doubler
|
||||
* Array Solutions
|
||||
* Home-Brew
|
||||
|
20
doc/user_guide/settings-audio.adoc
Normal file
@ -0,0 +1,20 @@
|
||||
// Status=review
|
||||
Select the *Audio* tab to configure your sound system.
|
||||
|
||||
image::images/settings-audio.png[align="center",alt="WSJT-X Audio Configuration Screen"]
|
||||
|
||||
- _Soundcard_: Select the audio devices to be used for *Input* and
|
||||
*Output*. Usually the *Mono* settings will suffice, but in special
|
||||
cases you can choose *Left*, *Right*, or *Both* stereo channels.
|
||||
|
||||
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.
|
||||
|
||||
- _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.
|
||||
|
||||
- _JT9W Settings_: JT9W is an experimental mode designed for EME on
|
||||
the microwave bands, and is not enabled in current release versions.
|
||||
|
8
doc/user_guide/settings-colors.adoc
Normal file
@ -0,0 +1,8 @@
|
||||
[[COLORS]]
|
||||
|
||||
image::images/colors.png[align="center",alt="Reporting Screen"]
|
||||
|
||||
_WSJT-X_ uses colors to highlight decoded messages that contain
|
||||
information that may be of particular interest. Click on one of
|
||||
the buttons to select your preferred colors for any message
|
||||
category.
|
39
doc/user_guide/settings-frequencies.adoc
Normal file
@ -0,0 +1,39 @@
|
||||
// Status=review
|
||||
|
||||
[[FIG_BAND_SETTINGS]]
|
||||
image::images/r4148-freq-ui.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.
|
||||
|
||||
- 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.
|
||||
|
||||
- To delete an entry, right-click it and select *Delete*.
|
||||
|
||||
_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
|
||||
default the frequency *Offset* for each band is zero. Nonzero offsets
|
||||
may be added if (for example) a transverter is in use.
|
||||
|
||||
- For a simple setup approach you might want to delete any unwanted
|
||||
bands -- for example, bands where you have no equipment. Then click
|
||||
on a *Frequency* entry and type *Ctrl+A* to ``select all,'' and
|
||||
drag-and-drop the entries onto the _Station Information_ table. You
|
||||
can then add any transverter offsets and antenna details.
|
||||
|
||||
- To avoid typing the same information multiple times, you can
|
||||
drag-and-drop entries between the lines of the _Station Information_
|
||||
table.
|
||||
|
||||
- When all settings have been configured to your liking, click *OK* to
|
||||
dismiss the *Settings* window.
|
14
doc/user_guide/settings-general.adoc
Normal file
@ -0,0 +1,14 @@
|
||||
// Status=review
|
||||
[[FIG_CONFIG_STATION]]
|
||||
image::images/settings-ui.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.
|
||||
This information will be sufficient for initial tests.
|
||||
|
||||
Meanings of remaining options on the *General* tab should be
|
||||
self-explanatory after you have made some QSOs using _WSJT-X_. You
|
||||
may return to set these options to your preferences later.
|
||||
|
||||
IMPORTANT: If you are using a callsign with an add-on prefix or suffix,
|
||||
be sure to read the section <<COMP-CALL,Compound Callsigns>>.
|
75
doc/user_guide/settings-radio.adoc
Normal file
@ -0,0 +1,75 @@
|
||||
// Status=review
|
||||
|
||||
_WSJT-X_ offers CAT (Computer Aided Transceiver) control of the
|
||||
relevant features of most modern transceivers. To configure the
|
||||
program for your radio, select the *Radio* tab.
|
||||
|
||||
image::images/RadioTab.png[align="center",alt="Radio Tab"]
|
||||
|
||||
- Select your radio type from the drop-down list labeled *Rig*, or
|
||||
*None* if you do not wish to use CAT control.
|
||||
|
||||
- Alternatively, if you have configured your station for control by
|
||||
*DX Lab Suite Commander*, *Ham Radio Deluxe*, *Hamlib NET rigctl*, or
|
||||
*OmniRig*, you may select one of those program names from the *Rig*
|
||||
list. In these cases the entry field immediately under _CAT Control_
|
||||
will be relabeled as *Network Server*. Leave this field blank to
|
||||
access the default instance of your control program, running on the
|
||||
same computer. If the control program runs on a different computer
|
||||
and/or port, specify it here. Hover the mouse pointer over the entry
|
||||
field to see the required formatting details.
|
||||
|
||||
- Select *OmniRig Rig 1* or *OmniRig Rig 2* to connect to an _OmniRig_
|
||||
server running on the same computer. Note that _OmniRig_ is available
|
||||
only under Windows.
|
||||
|
||||
- Set *Poll Interval* to the desired interval for _WSJT-X_ to query
|
||||
your radio. For most radios a small number (say, 1 – 3 s) is
|
||||
suitable.
|
||||
|
||||
- _CAT Control_: To have _WSJT-X_ control the radio directly rather
|
||||
than though another program, make the following settings:
|
||||
|
||||
* Select the *Serial Port* used to communicate with your radio.
|
||||
|
||||
* _Serial Port Parameters_: Set values for *Baud Rate*, *Data Bits*,
|
||||
*Stop Bits*, and *Handshake* method. Consult your radio's user guide
|
||||
for the proper parameter values.
|
||||
|
||||
* _Force Control Lines_: A few station setups require the CAT serial
|
||||
port’s *RTS* and/or *DTR* control lines to be forced high or
|
||||
low. Check these boxes only if you are sure they are needed.
|
||||
|
||||
- _PTT Method_: select *VOX*, *CAT*, *DTR*, or *RTS* as the desired
|
||||
method for T/R switching. If your choice is *DTR* or *RTS*, select
|
||||
the desired serial port (which may be the same one as used for
|
||||
CAT control).
|
||||
|
||||
- _Transmit Audio Source_: some radios permit you to choose the
|
||||
connector that will accept Tx audio. If this choice is enabled,
|
||||
select *Rear/Data* or *Front/Mic*.
|
||||
|
||||
- _Mode_: _WSJT-X_ uses upper sideband mode for both transmitting and
|
||||
receiving. Select *USB*, or choose *Data/Pkt* if your radio offers
|
||||
such an option and uses it to enable the rear-panel audio line input.
|
||||
Some radios also offer wider and/or flatter passbands when set to
|
||||
*Data/Pkt* mode. Select *None* if you do not want _WSJT-X_ to change
|
||||
the radio's Mode setting.
|
||||
|
||||
- _Split Operation_: Significant advantages result from using *Split*
|
||||
mode (separate VFOs for Rx and Tx) if your radio supports it. If it
|
||||
does not, _WSJT-X_ can simulate such behavior. Either method will
|
||||
result in a cleaner transmitted signal, by keeping the Tx audio always
|
||||
in the range 1500 to 2000 Hz so that audio harmonics cannot pass
|
||||
through the Tx sideband filter. Select *Rig* to use the radio's Split
|
||||
mode, or *Fake It* to have _WSJT-X_ adjust the VFO frequency as
|
||||
needed, just before T/R switching occurs. Choose *None* if you do not
|
||||
wish to use split operation.
|
||||
|
||||
When all required settings have been made, click *Test CAT* to test
|
||||
communication between _WSJT-X_ and your radio. The button should turn
|
||||
green to indicate that proper communication has been established.
|
||||
Failure of the CAT-control test turns the button red and displays an
|
||||
error message. After a succesful CAT test, toggle the *Test PTT*
|
||||
button to confirm that your selected method of T/R control is working
|
||||
properly.
|
16
doc/user_guide/settings-reporting.adoc
Normal file
@ -0,0 +1,16 @@
|
||||
// Status=review
|
||||
[[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 <<CONFIG_DETAILS,Configuration>>
|
||||
in the <<COMMAND_REF,Command Reference>> section.
|
||||
|
||||
- _Network_: Check *Enable PSK Reporter Spotting* to send reception
|
||||
reports to the {pskreporter} mapping facility.
|
||||
|
||||
- _UDP Server_: This group of options controls the network name or
|
||||
address and port number used by a program that will receive status
|
||||
updates from WSJT-X. It is expected that cooperating applications
|
||||
like JTAlert-X use this feature to obtain information about a
|
||||
running WSJT-X instance.
|
16
doc/user_guide/settings-txmacros.adoc
Normal file
@ -0,0 +1,16 @@
|
||||
// Status=review
|
||||
|
||||
[[FigTxMacros]]
|
||||
image::images/tx-macros.png[align="center",alt="Tx Macros Screen"]
|
||||
|
||||
*Tx Macros* are an aid for sending brief, frequently used free-text
|
||||
messages.
|
||||
|
||||
- To add a new message to the list, enter the desired text (up to 13
|
||||
characters) in the entry field at top, then click *Add*.
|
||||
|
||||
- To remove an unwanted message, click on the message and then on
|
||||
*Delete*.
|
||||
|
||||
- You can reorder your macro messages by using drag-and-drop. The
|
||||
new order will be preserved when _WSJT-X_ is restarted.
|
12
doc/user_guide/system-requirements.adoc
Normal file
@ -0,0 +1,12 @@
|
||||
// Status=review
|
||||
|
||||
- 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
|
||||
- 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
|
||||
- Audio input and output devices supported by the operating system and
|
||||
capable of 48 kHz sample rate
|
||||
- Audio or equivalent USB connections between transceiver and computer
|
||||
- A means for synchronizing the computer clock to UTC within ±1 second
|
56
doc/user_guide/transceiver-setup.adoc
Normal file
@ -0,0 +1,56 @@
|
||||
// Status=review
|
||||
.Receiver Noise Level
|
||||
|
||||
- If it is not already highlighted in green, click the *Monitor*
|
||||
button to return to normal receive operation.
|
||||
|
||||
- Be sure your transceiver is set to *USB* (or *USB Data*) mode.
|
||||
|
||||
- Use the receiver gain controls and/or the computer's audio mixer
|
||||
controls to set the background noise level (scale at lower left of
|
||||
main window) to around 30 dB when no signals are present. You may
|
||||
find it best to reduce the RF gain control so as to minimize 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 this
|
||||
slider not too far from its mid-point.
|
||||
|
||||
.Bandwidth and Frequency Setting
|
||||
|
||||
- If your transceiver offers more than one bandwidth setting in USB
|
||||
mode, you should normally 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 JT65 and JT9
|
||||
sub-bands simultaneously on most HF bands. Further details are
|
||||
provided in the <<TUTORIAL,Tutorial>> section.
|
||||
|
||||
- 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
|
||||
frequency setting, you can display the full sub-band generally used
|
||||
for one mode (JT65 or JT9) and part of the sub-band for the other
|
||||
mode.
|
||||
|
||||
- Of course, you might prefer to concentrate on one mode at a time,
|
||||
setting your dial frequency to (say) 14.076 for JT65 or 14.078 for
|
||||
JT9. Present conventions have the nominal JT9 dial frequency 2 kHz
|
||||
higher than the JT65 dial frequency. A checkbox labeled *+2 kHz*,
|
||||
just below the *Band* selector, makes the appropriate frequency
|
||||
settings easy.
|
||||
|
||||
.Transmitter Audio Level
|
||||
|
||||
* Click the *Tune* button on the main screen to switch the
|
||||
radio into transmit mode and generate a steady audio tone.
|
||||
|
||||
* Listen to the generated audio tone using your radio’s *Monitor*
|
||||
facility. The transmitted tone should be perfectly smooth, with no
|
||||
clicks or glitches.
|
||||
|
||||
* Open the computer’s audio mixer controls for output (``Playback'')
|
||||
devices and adjust the volume slider downward from its maximum until
|
||||
the RF output from your transmitter falls by around ten percent. This
|
||||
will be a good level for audio drive.
|
||||
|
||||
* Alternatively, you can make the Tx audio level adjustment using the
|
||||
digital slider labeled *Pwr* at the right edge of the main window.
|
||||
|
||||
* Toggle the *Tune* button once more to stop your test transmission.
|
96
doc/user_guide/tutorial-example1.adoc
Normal file
@ -0,0 +1,96 @@
|
||||
// Status=review
|
||||
|
||||
For this step and the next, you may want to pretend you are K1JT
|
||||
by entering that callsign temporarily as *My Call* on the
|
||||
*Settings | General* tab. Your results should then be identical to
|
||||
those shown in the screen shot below.
|
||||
|
||||
.Open a Wave File:
|
||||
|
||||
- Select *File | Open* and select the file
|
||||
+...\save\samples\130418_1742.wav+. When the file opens you should see
|
||||
something similar to the to the following screen shot:
|
||||
|
||||
[[X12]]
|
||||
image::images/main-ui-1.5.png[align="center",alt="Main UI and Wide Graph"]
|
||||
|
||||
.Decoding Overview
|
||||
|
||||
Decoding takes place at the end of a receive sequence and is proceeds
|
||||
in two steps. The first decode takes place at the selected Rx
|
||||
frequency, indicated by the U-shaped green marker on the waterfall
|
||||
scale. Results appear in both the left (*Band Activity*) and right
|
||||
(*Rx Frequency*) text windows on the main screen. The program then
|
||||
finds and decodes all signals in the selected mode over the displayed
|
||||
frequency range. The red marker indicates your Tx frequency.
|
||||
|
||||
Seven JT9 signals are present in the example file, all decodable.
|
||||
When this file was recorded KF4RWA was finishing a QSO with K1JT.
|
||||
Since the green marker was placed at his audio frequency, 1224 Hz, his
|
||||
message ``K1JT KF4RWA 73'' is decoded first and appears in the *Rx
|
||||
Frequency* window. The *Band Activity* window shows this message plus
|
||||
all decodes at other frequencies. By default lines containing CQ are
|
||||
highlighted in green, and lines with *My Call* (in this case K1JT) in
|
||||
red.
|
||||
|
||||
[[X13]]
|
||||
.Decoding Controls
|
||||
|
||||
To gain some feeling for controls frequently used when making QSOs,
|
||||
try clicking with the mouse on the decoded text lines and on the
|
||||
waterfall spectral display. You should be able to confirm the
|
||||
following behavior:
|
||||
|
||||
- Double-click on either of the decoded lines highlighted in
|
||||
green. This action produces the following results:
|
||||
|
||||
** Callsign and locator of a station calling CQ are copied to the *DX
|
||||
Call* and *DX Grid* entry fields.
|
||||
|
||||
** Messages are generated for a standard minimal QSO.
|
||||
|
||||
** The *Tx even* box is checked or cleared appropriately, so that you
|
||||
will transmit in the proper (odd or even) minutes.
|
||||
|
||||
** The Rx and Tx frequency markers are moved to the frequency of the
|
||||
CQing station.
|
||||
|
||||
** The *Gen Msg* (``generated message'') radio button at bottom right
|
||||
of the main window is selected.
|
||||
|
||||
** If you had checked *Double-click on call sets Tx Enable* on the
|
||||
*Setup* menu, *Enable Tx* would be activated and a transmission would
|
||||
start automatically at the proper time.
|
||||
|
||||
- Double-click on the decoded message ``K1JT N5KDV EM41'',
|
||||
highlighted in red. Results will be similar to those in the
|
||||
previous step, except the Tx frequency (red marker) is not
|
||||
moved. Such messages are usually in response to your own CQ, or from
|
||||
a tail-ender, and you probably want your Tx frequency to stay where it
|
||||
was.
|
||||
|
||||
- By holding down the *Ctrl* key when double-clicking on a decoded
|
||||
line you can cause both Tx and Rx frequencies to be moved. This
|
||||
behavior can also be forced by checking *Lock Tx=Rx*.
|
||||
|
||||
- Double-click on the message from KF4RWA in either window. He is
|
||||
sending ``73'' to K1JT, signifying that the QSO is over. Most likely
|
||||
you want to send 73 to him, so the message ``KF4RWA K1JT 73'' is
|
||||
automatically generated and selected for your next transmission.
|
||||
(Alternatively, you might choose to send a free text message or to
|
||||
call CQ again.)
|
||||
|
||||
- Click somewhere on the waterfall to set Rx frequency (green marker).
|
||||
|
||||
- Ctrl-click on the waterfall to set both Rx and Tx frequencies.
|
||||
|
||||
- Double-click on a signal in the waterfall to set Rx frequency and
|
||||
start a narrow-band decode there. Decoded text will appear in the
|
||||
right window only.
|
||||
|
||||
- Ctrl-double-click on a signal to set both Rx and Tx frequencies and
|
||||
decode at the new frequency.
|
||||
|
||||
- Click *Erase* to clear the right window.
|
||||
|
||||
- Double-click *Erase* to clear both text windows.
|
117
doc/user_guide/tutorial-example2.adoc
Normal file
@ -0,0 +1,117 @@
|
||||
// Status=review
|
||||
.Wide Graph Settings:
|
||||
|
||||
- Set *Bins/Pixel* = 7
|
||||
- Adjust the width of the Wide Graph window so that the upper
|
||||
frequency limit is approximately 4000 Hz.
|
||||
|
||||
.Main Window:
|
||||
- Select *JT9+JT65* on the *Mode* menu.
|
||||
- Toggle the *Tx mode* button to read *Tx JT65*, and set the Tx and Rx
|
||||
frequencies to 1718 Hz.
|
||||
- Double-click on *Erase* to clear both text windows.
|
||||
|
||||
.Open a Wave File:
|
||||
|
||||
- Select *File | Open* and navigate to +...\save\samples\130610_2343.wav+.
|
||||
The waterfall should look like this:
|
||||
|
||||
//.130610_2343.wav Decode
|
||||
[[X14]]
|
||||
image::images/130610_2343-wav-80.png[align="left",alt="Wide Graph Decode 130610_2343"]
|
||||
|
||||
IMPORTANT: Notice the [blue]*BLUE* marker on the waterfall scale, here
|
||||
set at 2500 Hz. Its position is set by the spinner control *JT65 nnnn
|
||||
JT9*, where nnnn is a frequency in Hz. In *JT9+JT65* mode the program
|
||||
will automatically decode JT9 signals only above this frequency.
|
||||
|
||||
JT9 signals appear in the *Cumulative* spectrum as nearly rectangular
|
||||
shapes about 16 Hz wide. They have no clearly visible sync tone like
|
||||
the one at the low-frequency edge of all JT65 signals. By convention
|
||||
the nominal frequency of both JT9 and JT65 signals is taken to be that
|
||||
of the lowest tone, at the left edge of its spectrum.
|
||||
|
||||
This sample file contains 17 decodable signals — nine in JT65 mode
|
||||
(flagged with the character # in the decoded text windows), and eight
|
||||
in JT9 mode (flagged with @). On multi-core computers the decoders
|
||||
for JT9 and JT65 modes run simultaneously, so their results will be
|
||||
interspersed. The *Band Activity* window contains all decodes (you
|
||||
might need to scroll back in the window to see some of them). A
|
||||
signal at the frequency specified by the green marker is given
|
||||
decoding priority, and its message is displayed in the *Rx Frequency*
|
||||
window.
|
||||
|
||||
[[FigDecodes]]
|
||||
image::images/decodes.png[align="center"]
|
||||
|
||||
- Confirm that mouse-click behavior is similar to that described
|
||||
earlier, in <<TUT_EX1,Example 1>>. _WSJT-X_ automatically determines
|
||||
the mode of each JT9 or JT65 message.
|
||||
|
||||
IMPORTANT: When you double-click on a signal in the waterfall it will be
|
||||
properly decoded even if on the ``wrong'' side of the *JT65 nnnn JT9*
|
||||
marker. The Tx mode automatically switches to that of the decoded
|
||||
signal and the Rx and Tx frequency markers on the waterfall scale
|
||||
resize themselves accordingly. When selecting a JT65 signal, click on
|
||||
the sync tone at its left edge.
|
||||
|
||||
- Double-click on the waterfall near 815 Hz: a JT65 message
|
||||
originating from W7VP will be decoded and appear in the *Rx Frequency*
|
||||
window. Between the *UTC* and *Freq* columns on the decoded text line
|
||||
you will find *dB*, the measured signal-to-noise ratio, and *DT*, the
|
||||
signal's time offset in seconds relative to your computer clock.
|
||||
|
||||
[width="70%",cols="3,^3,^3,^4,^4,30",options="header"]
|
||||
|=================================
|
||||
|UTC|dB|DT|Freq|Mode|Message
|
||||
|+2343+|+-7+|+0.3+|+815+|+#+|+KK4DSD W7VP -16+
|
||||
|=================================
|
||||
|
||||
- Double-click on the waterfall at 3196 Hz. The program will decode a
|
||||
JT9 message from IZ0MIT:
|
||||
|
||||
[width="70%",cols="3,^3,^3,^4,^4,30",options="header"]
|
||||
|=====================================
|
||||
|UTC|dB|DT|Freq|Mode|Message
|
||||
|+2343+|+-7+|+0.3+|+3196+|+@+|+WB8QPG IZ0MIT -11+
|
||||
|=====================================
|
||||
|
||||
- Scroll back in the *Band Activity* window and double-click on the
|
||||
message +CQ DL7ACA JO40+. The program will set *Tx mode* to JT65 and Tx
|
||||
and Rx frequencies to that of DL7ACA, 975 Hz. If you had checked
|
||||
*Double-click on call sets Tx Enable* on the *Setup* menu, the program
|
||||
would configure itself to start a QSO with DL7ACA.
|
||||
|
||||
- Double-click on the decoded JT65 message +CQ TA4A KM37+. The program
|
||||
will set Tx mode to JT9 and the Rx and Tx frequencies to 3567 Hz. The
|
||||
program is now configured properly for a JT9 QSO with TA4A.
|
||||
|
||||
.Reopen the First Sample File:
|
||||
- Select *File | Open* and navigate to +...\save\samples\130418_1742.wav+.
|
||||
|
||||
Taking full advantage of the wide-band, dual-mode capability of
|
||||
_WSJT-X_ requires a receiver bandwidth of at least 4 kHz. These
|
||||
data were recorded with a much narrower Rx bandwidth, roughly 200 to
|
||||
2400 Hz. If you have no Rx filter wider than about 2.7 kHz, you will
|
||||
be using data like this. For best viewing, adjust *Bins/Pixel* and the
|
||||
width of the Wide Graph so that only the active part of the spectrum
|
||||
shows, say 200 to 2400 Hz. Re-open the example file after any change of
|
||||
*Bins/Pixel* or Wide Graph width, to refresh the waterfall.
|
||||
|
||||
The signals in this file are all JT9 signals. To decode them
|
||||
automatically in *JT9+JT65* mode you’ll need to move the *JT65 nnnn JT9*
|
||||
delimiter down to 1000 Hz or less.
|
||||
|
||||
.Start, Zero, and Gain
|
||||
|
||||
Now is a good time to experiment with the *Start*, *Zero*, and *Gain*
|
||||
parameters. *Start* determines the frequency displayed at the left
|
||||
side of the waterfall scale. *Zero* sets the baseline level for
|
||||
colors, and *Gain* sets the sensitivity for color changes. For the
|
||||
receiver setup of this file good values are close to *Zero*=0,
|
||||
*Gain*=0. You may want to uncheck *Flatten* when adjusting the *Zero*
|
||||
and *Gain* controls. Re-open the wave file after each change, to see
|
||||
the new results.
|
||||
|
||||
IMPORTANT: When finished with this Tutorial, don’t forget to re-enter
|
||||
your own callsign as *My Call* on the *Settings | General* tab.
|
16
doc/user_guide/tutorial-main-window.adoc
Normal file
@ -0,0 +1,16 @@
|
||||
// Status=review
|
||||
|
||||
- Click the *Stop* button on the main window to halt any data acquisition.
|
||||
|
||||
- Select *JT9* from the *Mode* menu and *Deepest* from the *Decode* menu.
|
||||
|
||||
- Set the audio frequencies to *Tx 1224 Hz* and *Rx 1224 Hz*. You
|
||||
can type numbers directly into these controls, as well as using their
|
||||
up/down arrows.
|
||||
|
||||
- Select *Tab 2* (below the *Decode* button) to choose the alternative
|
||||
set of controls for generating and selecting Tx messages.
|
||||
|
||||
IMPORTANT: Sliders and spin-box controls respond to arrow key presses
|
||||
and Page Up/Down key presses, with the Page keys moving the controls
|
||||
in larger steps.
|
14
doc/user_guide/tutorial-wide-graph-settings.adoc
Normal file
@ -0,0 +1,14 @@
|
||||
// Status=review
|
||||
|
||||
- *Bins/Pixel* = 4
|
||||
- *JT65 .... JT9* = 2500
|
||||
- *Start* = 200
|
||||
- *N Avg* = 5
|
||||
- *Zero* = 0
|
||||
- *Gain* = 0
|
||||
- *Palette* = Digipan
|
||||
- *Flatten* = checked
|
||||
- Select *Cumulative* for data display.
|
||||
|
||||
- Use the mouse to adjust the width of the *Wide Graph* so that its
|
||||
upper frequency limit is about 2400 Hz.
|
80
doc/user_guide/tx-rx.adoc
Normal file
@ -0,0 +1,80 @@
|
||||
// Status=review
|
||||
.Transmitting
|
||||
|
||||
Immediately before the start of a transmission _WSJT-X_ encodes a
|
||||
user's message and computes the sequence of tones to be sent. The
|
||||
audio waveform is computed on-the-fly, with 16-bit integer samples
|
||||
sent to the audio output device at a 48000 Hz rate. Generated JT65
|
||||
and JT9 signals have continuous phase and constant amplitude, and
|
||||
there are no key clicks. The transmitter's power amplifier need not
|
||||
be highly linear.
|
||||
|
||||
.Receiving
|
||||
|
||||
_WSJT-X_ acquires 16-bit integer samples from the audio input device
|
||||
at a 48000 Hz rate and immediately downsamples the stream to 12000 Hz.
|
||||
Spectra from overlapping segments are computed for the waterfall
|
||||
display and saved for the decoder at intervals of 3456/12000 = 0.288
|
||||
s, half the JT9 symbol length.
|
||||
|
||||
.Decoding
|
||||
|
||||
At the end of a reception sequence, about 50 seconds into the UTC
|
||||
minute, received data samples are forwarded to the decoder. For
|
||||
operator convenience the decoder goes through its full procedure
|
||||
twice: first at the selected Rx frequency, and then over the full
|
||||
displayed frequency range. Each decoding pass can be described as a
|
||||
sequence of discrete blocks. The functional blocks are different for
|
||||
the JT65 and JT9 modes. In dual-mode JT9+JT65 operation on computers
|
||||
with more than one CPU, decoding computations for the two modes are
|
||||
done in parallel.
|
||||
|
||||
The basic decoding algorithm for JT65 mode is described in the 2005
|
||||
{jt65protocol} paper. The following list summarizes the corresponding
|
||||
algorithm for JT9 mode. Blocks are labeled here with the names of
|
||||
functional procedures in the code.
|
||||
|
||||
[horizontal]
|
||||
+sync9+:: Use sync symbols to find candidate JT9 signals
|
||||
in the specified frequency range
|
||||
|
||||
Then, at the frequency of each plausible candidate:
|
||||
|
||||
[horizontal]
|
||||
+downsam9+:: Mix, filter and downsample to 16 complex
|
||||
samples/symbol
|
||||
|
||||
+peakdt9+:: Using sync symbols, time-align to start of JT9 symbol
|
||||
sequence
|
||||
|
||||
+afc9+:: Measure frequency offset and possible drift
|
||||
|
||||
+twkfreq+:: Remove frequency offset and drift
|
||||
|
||||
+symspec2+:: Compute 8-bin spectra for 69 information-carrying
|
||||
symbols, using the time- and frequency-aligned data;
|
||||
transform to yield 206 single-bit soft symbols
|
||||
|
||||
+interleave9+:: Remove single-bit interleaving imposed at the
|
||||
transmitter
|
||||
|
||||
+decode9+:: Retrieve a 72-bit user message using the sequential
|
||||
Fano algorithm
|
||||
|
||||
|
||||
+unpackmsg+:: Unpack a human-readable message from the 72-bit
|
||||
compressed format
|
||||
|
||||
Decoding of clean JT9 signals in a white-noise background starts to
|
||||
fail below signal-to-noise ratio -25 dB and reaches 50% copy at -26
|
||||
dB.
|
||||
|
||||
With marginal or unrecognizable signals the sequential Fano algorithm
|
||||
can take exponentially long times. If the +sync9+ step in the above
|
||||
sequence finds many seemingly worthy candidate signals and many of
|
||||
them turn out to be undecodable, the decoding loop can take an
|
||||
inconveniently long time. For this reason the step labeled +decode9+
|
||||
is programmed to ``time out'' and report failure for a given signal if
|
||||
it takes too long. The choices *Fast | Normal | Deepest* on the
|
||||
*Decode* menu provide the user with a three-step adjustment of the
|
||||
timeout limit.
|
59
doc/user_guide/utilities.adoc
Normal file
@ -0,0 +1,59 @@
|
||||
// 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
|
||||
permissible structure of transmitted messages, and for studying
|
||||
behavior of the error-control codes.
|
||||
|
||||
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:
|
||||
|
||||
C:\WSJTX> jt9code "G0XYZ K1ABC FN42"
|
||||
Message: G0XYZ K1ABC FN42
|
||||
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
|
||||
tone 0, and the sequential locations of sync symbols are described in
|
||||
the <<JT65PRO,JT65 Protocol>> section of this Guide.
|
||||
|
||||
A typical execution of +jt65code+ is shown below. The program
|
||||
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:
|
||||
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
|
||||
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:
|
||||
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.
|
205
doc/user_guide/wsjtx-main.adoc
Normal file
@ -0,0 +1,205 @@
|
||||
// This is a comment line, anything with // is ignored at process time.
|
||||
= WSJT-X User Guide
|
||||
:Revision: {VERSION}
|
||||
// For web-pages, adding :badges: is ok, but is a security issue for
|
||||
// package building .deb, .rpm, etc as it exposes the IP address and the images
|
||||
// are non-free, so can't be included as part of the Debian package.
|
||||
// :badges:
|
||||
:icons:
|
||||
:numbered:
|
||||
:keywords: amateur radio weak signal communication K1JT WSJT JT65 JT9
|
||||
:description: Software for Amateur Radio Weak-Signal Communication
|
||||
:prog: WSJT-X
|
||||
|
||||
// use global link file
|
||||
include::../common/links.adoc[]
|
||||
|
||||
// These [[xxxx]] labels are HTML anchors, and can be used to
|
||||
// navigate though the document easily: <<INTRO,See Introduction>> will
|
||||
// place a hyper-link in your text to take you too the anchored section.
|
||||
// All major sections or points of interest should have one.
|
||||
|
||||
// == is level (2), section 1.0, === would mean section 1.1, === would
|
||||
// be section 1.1.1. This method is used throughout the document.
|
||||
|
||||
[[INTRO]]
|
||||
== Introduction
|
||||
include::introduction.adoc[]
|
||||
|
||||
[[SYSREQ]]
|
||||
== System Requirements
|
||||
include::system-requirements.adoc[]
|
||||
|
||||
[[INSTALL]]
|
||||
== Installation
|
||||
|
||||
Installation packages for Windows, Linux, and OS X are found on the
|
||||
the {homepage}. Click on the _WSJT-X_ link at the left margin, and
|
||||
then select the appropriate package for your operating system.
|
||||
|
||||
[[INSTALL_WIN]]
|
||||
=== Windows
|
||||
include::install-windows.adoc[]
|
||||
|
||||
[[INSTALL_LINUX]]
|
||||
=== Linux
|
||||
include::install-linux.adoc[]
|
||||
|
||||
[[INSTALL_OSX]]
|
||||
=== Macintosh OS X
|
||||
include::install-mac.adoc[]
|
||||
|
||||
////
|
||||
[[SRC_CODE]]
|
||||
=== Source Code
|
||||
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.
|
||||
|
||||
[[GENERAL]]
|
||||
=== General
|
||||
include::settings-general.adoc[]
|
||||
|
||||
[[RADIO]]
|
||||
=== Radio
|
||||
include::settings-radio.adoc[]
|
||||
|
||||
[[AUDIO]]
|
||||
=== Audio
|
||||
include::settings-audio.adoc[]
|
||||
|
||||
[[TXMACROS]]
|
||||
=== Tx Macros
|
||||
include::settings-txmacros.adoc[]
|
||||
|
||||
[[REPORTING]]
|
||||
=== Reporting
|
||||
include::settings-reporting.adoc[]
|
||||
|
||||
[[BAND_SETTINGS]]
|
||||
=== Frequencies
|
||||
include::settings-frequencies.adoc[]
|
||||
|
||||
[[COLORS]]
|
||||
=== Colors
|
||||
include::settings-colors.adoc[]
|
||||
|
||||
[[TRANSCEIVER]]
|
||||
== Transceiver Setup
|
||||
include::transceiver-setup.adoc[]
|
||||
|
||||
[[TUTORIAL]]
|
||||
== Basic Operating Tutorial
|
||||
|
||||
[[TUT_MAIN]]
|
||||
=== Main Window Settings
|
||||
include::tutorial-main-window.adoc[]
|
||||
|
||||
[[TUT_WIDE_GRAPH]]
|
||||
=== Wide Graph Settings
|
||||
include::tutorial-wide-graph-settings.adoc[]
|
||||
|
||||
[[TUT_EX1]]
|
||||
=== Sample File 1
|
||||
include::tutorial-example1.adoc[]
|
||||
|
||||
[[TUT_EX2]]
|
||||
=== Sample File 2
|
||||
include::tutorial-example2.adoc[]
|
||||
|
||||
[[MAKE_QSOS]]
|
||||
== Making QSOs
|
||||
include::make-qso.adoc[]
|
||||
|
||||
[[COMMAND_REF]]
|
||||
== Command Reference
|
||||
|
||||
[[CONTROLS_WIDE]]
|
||||
=== Wide Graph
|
||||
include::controls-functions-wide-graph.adoc[]
|
||||
|
||||
[[CONTROLS_MAIN]]
|
||||
=== Main Window
|
||||
include::controls-functions-main-window.adoc[]
|
||||
|
||||
[[CONTROLS_LEFT]]
|
||||
=== Controls Left
|
||||
include::controls-functions-left.adoc[]
|
||||
|
||||
[[CONTROLS_CENTER]]
|
||||
=== Controls Center
|
||||
include::controls-functions-center.adoc[]
|
||||
|
||||
[[CONTROLS_MSGS]]
|
||||
=== Tx Messages
|
||||
include::controls-functions-messages.adoc[]
|
||||
|
||||
[[STATUS_BAR]]
|
||||
=== Status Bar
|
||||
include::controls-functions-status-bar.adoc[]
|
||||
|
||||
[[MENUS]]
|
||||
=== Menus
|
||||
include::controls-functions-menus.adoc[]
|
||||
|
||||
[[LOGGING]]
|
||||
== Logging
|
||||
include::logging.adoc[]
|
||||
|
||||
[[COOP_PGMS]]
|
||||
== Cooperating Programs
|
||||
include::cooperating-programs.adoc[]
|
||||
|
||||
[[PLATFORM]]
|
||||
== Platform Dependencies
|
||||
include::platform-dependencies.adoc[]
|
||||
|
||||
|
||||
[[FAQ]]
|
||||
== Frequently Asked Questions
|
||||
include::faq.adoc[]
|
||||
|
||||
[[PROTOCOLS]]
|
||||
== Protocol Specifications
|
||||
|
||||
[[JT65PRO]]
|
||||
=== JT65
|
||||
include::jt65-protocol.adoc[]
|
||||
|
||||
[[JT9PRO]]
|
||||
=== JT9
|
||||
include::jt9-protocol.adoc[]
|
||||
|
||||
[[JT65_JT9]]
|
||||
=== JT65 & JT9 Differences
|
||||
include::jt65-jt9-differences.adoc[]
|
||||
|
||||
[[TXRX]]
|
||||
== Implementation Details
|
||||
include::tx-rx.adoc[]
|
||||
|
||||
////
|
||||
[[TROUBLE_SHOOTING]]
|
||||
== Troubleshooting
|
||||
To be added (?) ...
|
||||
////
|
||||
|
||||
[[UTIL]]
|
||||
== Utility Programs
|
||||
include::utilities.adoc[]
|
||||
|
||||
[[ACK]]
|
||||
== Acknowledgements
|
||||
include::acknowledgements.adoc[]
|
||||
|
||||
[[LICENSE]]
|
||||
== License
|
||||
include::../common/license.adoc[]
|
||||
|
8
doc/wsjtx.conf.in
Normal file
@ -0,0 +1,8 @@
|
||||
# This is an asciidoc configuraiton file which is processed by CMake
|
||||
# as a configuration file to substitute variables
|
||||
[attributes]
|
||||
themedir=@CMAKE_CURRENT_SOURCE_DIR@/theme/wsjt
|
||||
VERSION_MAJOR=@WSJTX_VERSION_MAJOR@
|
||||
VERSION_MINOR=@WSJTX_VERSION_MINOR@
|
||||
VERSION_PATCH=@WSJTX_VERSION_PATCH@
|
||||
VERSION=@wsjtx_VERSION@
|