Top level docs

git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@4677 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
This commit is contained in:
Bill Somerville 2014-11-28 23:34:23 +00:00
parent e633328ada
commit 4d8170f48a
8 changed files with 1495 additions and 3 deletions

4
AUTHORS Normal file
View File

@ -0,0 +1,4 @@
Joe Taylor, K1JT <k1jt@arrl.net>
See also about.cpp or "Help->About WSJT-X" in the application for
details of other contributions.

14
BUGS Normal file
View File

@ -0,0 +1,14 @@
__ __ ______ _____ ________ __ __
| \ _ | \ / \ | \| \ | \ | \
| $$ / \ | $$| $$$$$$\ \$$$$$ \$$$$$$$$ | $$ | $$
| $$/ $\| $$| $$___\$$ | $$ | $$ ______ \$$\/ $$
| $$ $$$\ $$ \$$ \ __ | $$ | $$| \ >$$ $$
| $$ $$\$$\$$ _\$$$$$$\| \ | $$ | $$ \$$$$$$/ $$$$\
| $$$$ \$$$$| \__| $$| $$__| $$ | $$ | $$ \$$\
| $$$ \$$$ \$$ $$ \$$ $$ | $$ | $$ | $$
\$$ \$$ \$$$$$$ \$$$$$$ \$$ \$$ \$$
There are some defects remaining in WSJT-X.

View File

@ -149,5 +149,3 @@ Later license versions may give you additional or different permissions. However
END OF TERMS AND CONDITIONS
---------------------------
The soft-decision Reed-Solomon decoder used in WSJT and MAP65 is based on an algorithm developed by R. Koetter and A. Vardy and protected under United States Patent number 6,634,007. It uses code licensed from CodeVector Technologies, LLC.

View File

@ -1 +0,0 @@
Copyright (C) 2001-2014 by Joe Taylor, K1JT

337
INSTALL Normal file
View File

@ -0,0 +1,337 @@
__ __ ______ _____ ________ __ __
| \ _ | \ / \ | \| \ | \ | \
| $$ / \ | $$| $$$$$$\ \$$$$$ \$$$$$$$$ | $$ | $$
| $$/ $\| $$| $$___\$$ | $$ | $$ ______ \$$\/ $$
| $$ $$$\ $$ \$$ \ __ | $$ | $$| \ >$$ $$
| $$ $$\$$\$$ _\$$$$$$\| \ | $$ | $$ \$$$$$$/ $$$$\
| $$$$ \$$$$| \__| $$| $$__| $$ | $$ | $$ \$$\
| $$$ \$$$ \$$ $$ \$$ $$ | $$ | $$ | $$
\$$ \$$ \$$$$$$ \$$$$$$ \$$ \$$ \$$
Installing WSJT-X
=================
Binary packages of WSJT-X are available from the project web site:
http://www.physics.princeton.edu/pulsar/K1JT/wsjtx.html
Building from Source
====================
On Linux systems some of the prerequisite libraries are available in
the mainstream distribution repositories. They are Qt v5 and FFTW v3.
For MS Windows see the section "Building from Source on MS Windows"
below. For Apple Mac see the section "Building from Source on Apple
Mac".
Qt v5 multimedia support is necessary as well as the core Qt v5
components, normally installing the Qt multimedia development package
is sufficient to pull in all the required Qt components and dependants
as a single transaction. On some systems the Qt multimedia plugin
component is separate in the distribution repository an it may also
need installing.
The single precision FFTW v3 library libfftw3f is required along with
the libfftw library development package. Normally installing the
library development package pulls in all the FFTW v3 libraries
including the single precision variant.
The Hamlib library is required. Currently WSJT-X needs to be built
using a forked version of the Hamlib git master. This fork contains
patches not yet accepted by the Hamlib development team which are
essential for correct operation of WSJT-X. To build the Hamlib fork
from sources something like the following recipe should suffice:
mkdir ~/hamlib-prefix
cd ~/hamlib-prefix
git clone git://git.code.sf.net/u/bsomervi/hamlib src
cd src
git checkout integration
mkdir ../build
cd ../build
../src/autogen.sh --prefix=$HOME/hamlib-prefix \
--disable-shared --enable-static \
--without-cxx-binding --disable-winradio \
CFLAGS="-fdata-sections -ffunction-sections" \
LDFLAGS="-Wl,--gc-sections"
make
make install
This will build a binary hamlib package located at ~/hamlib-prefix so
you will need to add that to your CMAKE_PREFIX_PATH variable in your
WSJT-X build. On Linux that is probably the only path you have on
CMAKE_PREFIX_PATH unless you are using a locally installed Qt
installation.
To get the sources either download and extract a source tarball from
the project web site or preferably fetch the sources directly from the
project's subversion repository. The project svn repository has a
non-standard layout in that the WSJT-X project is not on the trunk,
instead the main code line is in a branch at ^/branches/wsjtx
mkdir -p ~/wsjtx-prefix/build
cd ~/wsjtx-prefix
svn checkout svn://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx src
To build WSJT-X you will need CMake and asciidoc installed.
cd ~/wsjtx-prefix/build
cmake -D CMAKE_PREFIX_PATH=~/hamlib-prefix ../src
cmake --build .
cmake --build . --target install
The recipe above will install into /usr by default, if you wish to
install in you own directory you can add a prefix-path to the
configure step like:
cd ~/wsjtx-prefix/build
cmake -D CMAKE_PREFIX_PATH=~/hamlib-prefix \
-D CMAKE_INSTALL_PREFIX=~/wsjtx-prefix ../src
cmake --build .
cmake --build . --target install
this will install WSJT-X at ~/wsjtx-prefix.
Building from Source on MS Windows
==================================
Because building on MS Windows is quite complicated there is an
Software Development Kit available that provides all the prerequisite
libraries and tools for building WSJT-X. This SDK is called JT-SDK-QT
which is documented here:
http://physics.princeton.edu/pulsar/K1JT/wsjtx-doc/dev-guide-main.html
If you need to build Hamlib rather than use the Hamlib kit included in
the JT-SDK the following recipe should help. Reasons for building
Hamlib from source might include picking up the very latest patches or
building a different branch that you wish to contribute to.
On Windows there is a complication in that the compilers used to build
Qt and WSJT-X are the MinGW ones bundled with the Qt package but
Hamlib needs to be build from an MSYS shell with the tools required to
build an autotools project. This means that you need to tell the
Hamlib configuration to use the Qt bundled MinGW compilers (if you
don't then the thread support library use by Hamlib will be
incompatible with that used by Qt and WSJT-X). So on Windows the
Hamlib build recipe is something like:
In an MSYS shell:-
mkdir ~/hamib-prefix
cd ~/hamlib-prefix
git clone git://git.code.sf.net/u/bsomervi/hamlib src
cd src
git checkout integration
mkdir ../build
cd ../build
../src/autogen.sh --prefix=$HOME/hamlib-prefix \
--disable-shared --enable-static \
--without-cxx-binding --disable-winradio \
CC=<path-to-Qt-MinGW-tools>/gcc \
CXX=<path-to-Qt-MinGW-tools>/g++ \
CFLAGS="-fdata-sections -ffunction-sections" \
LDFLAGS="-Wl,--gc-sections"
make
make install
NOTE: <path-to-Qt-MinGQ-tools> should be substituted with the actual
path to your Qt bundled tools e.g on my system it is
C:\Tools\Qt\Tools\mingw48_32\bin
This will leave a Hamlib binary package installed at
c:/Users/<user-name>/hamlib-prefix which is what needs to be on your
CMAKE_PREFIX_PATH. On Windows you almost certainly will be using a
CMake tool chain file and this is where you will need to specify the
Hamlib binary location as one of the paths in CMAKE_PREFIX_PATH.
Building from Source on Apple Mac
=================================
These instructions are adapted from my Evernote page at:
https://www.evernote.com/pub/bsomervi/wsjt-xmacbuilds
There are several ways to get the required GNU and other open source
tools and libraries installed, my preference is MacPorts because it is
easy to use and does everything we need.
You will need Xcode, MacPorts, CMake and, Qt. The Xcode install
instructions are included in the MacPorts documentation.
Install MacPorts from instructions here:
http://www.macports.org/install.php
More detailed instructions are available in the documentation:
https://guide.macports.org
The ports that need to be installed are:
autoconf
automake
libtool
pkgconfig
texinfo
gcc49
fftw-3-single +gcc49
asciidoc
These are install by typing:
sudo port install autoconf automake \
libtool pkgconfig texinfo gcc49 asciidoc \
fftw-3-single +gcc49
Once complete you should have all the tools required to build WSJT-X.
Uninstalling MacPorts
If at some point you wish to remove the ports from your machine. The
instructions are here:
https://guide.macports.org/#installing.macports.uninstalling .
Hamlib
First fetch hamlib from the repository, in this case my fork of Hamlib
3 until the official repository has all the fixes we need:
mkdir -p ~/hamlib-prefix/build
cd ~/hamlib-prefix
git clone git://git.code.sf.net/u/bsomervi/hamlib src
cd src
git checkout integration
The integration branch is my system testing branch which has all my
latest published changes.
You need to make one small change to the sources to build on OS X
using the MacPorts tools, here is a sed command to make the change:
sed -i.orig '/libtoolize/s/lib/glib/' autogen.sh
To build:
cd ~/hamlib-prefix/build
../src/hamlib/autogen.sh \
--enable-static \
--disable-shared \
--disable-winradio \
--prefix=$HOME/hamlib-prefix
make
make install-strip
The above commands will build hamlib and install it into ~/hamlib-prefix
Qt
The easiest way to obtain Qt is to use the latest qt-project.org on
line installer DMG for Mac OS X which should be here:
http://www.qt.io/download . You need the "Community" edition.
CMake
Although CMake is available via MacPorts I prefer to use the binary
installer from cake.org as the MacPorts port doesn't include the
graphical CMake tool cmake-gui which I find quite useful.
Fetch the latest CMake universal 64-bit DMG from
http://www.cmake.org/download/ open the DMG then drag and drop the
application bundle onto the supplied /Applications link.
To complete the install process you need to run the CMake application
as root from a terminal shell:
sudo /Applications/CMake.app/Contents/MacOS/CMake
in the CMake application choose "Tools->Install For Command Line Use"
from the menu and then click the "Install Command Line Links".
WSJT-X
First fetch the source from the repository:
mkdir -p ~/wsjtx-prefix/build
cd ~/wsjtx-prefix
svn checkout svn://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx src
this links to the Subversion repository in a read-only fashion, if you
intend to contribute to the project then you probably want to get a
developer login and use a read-write checkout. Even if you don't it
can be upgraded at a later date.
The checkout is of the latest code on the project trunk, i.e. the
development branch. You can easily switch the checkout to another
branch or even a tag if you want to build a prior published
generation. For now we will build the latest development sources. To
configure:
cd ~/wsjtx-prefix/build
FC=gfortran-mp-4.9 \
cmake \
-D CMAKE_PREFIX_PATH="~/Qt/5.3/clang_64;~/hamlib-prefix;/opt/local" \
-D CMAKE_INSTALL_PREFIX=~/wsjtx-prefix \
~/wsjtx-prefix/src
The CMAKE_PREFIX_PATH variable specifies where CMake should look first
for other packages, the two elements may be different depending where
you have installed Qt and what version you have and where you
installed Hamlib (i.e. the --prefix configure option above in the
hamlib section).
If you already have the fftw3-dev package installed on your system it
may well get selected in preference to the one you built above in the
MacPorts installation. It is unlikely that a prior installation of
libfftw3f is correctly configured for use in a WSJT-X package, the
CMAKE_PREFIX_PATH above is augmented with the MacPorts installation
location (/opt/local) to ensure the correct libfftw3f.dylib and
headers are located.
To build:
cmake --build .
cmake --build . --target install
which installs the WSJT-X application bundle into ~/wsjtx-prefix
Updating and Rebuilding Hamlib
==============================
From time to time new fixes will be pushed to the Hamlib fork
repository integration branch. To pick them up type:
cd ~/hamlib-prefix/src
git pull
To rebuild hamlib with the changed sources:
cd ~/hamlib-prefix/build
make
make install-strip
Updating and Rebuilding WSJT-X
==============================
To update to the latest sources type:
cd ~/wsjtx-prefix/src
svn update
cd ~/wsjtx-prefix/build
cmake --build .
cmake --build . --target install
73
Bill
G4WJS.

1036
NEWS Normal file

File diff suppressed because it is too large Load Diff

46
README Normal file
View File

@ -0,0 +1,46 @@
__ __ ______ _____ ________ __ __
| \ _ | \ / \ | \| \ | \ | \
| $$ / \ | $$| $$$$$$\ \$$$$$ \$$$$$$$$ | $$ | $$
| $$/ $\| $$| $$___\$$ | $$ | $$ ______ \$$\/ $$
| $$ $$$\ $$ \$$ \ __ | $$ | $$| \ >$$ $$
| $$ $$\$$\$$ _\$$$$$$\| \ | $$ | $$ \$$$$$$/ $$$$\
| $$$$ \$$$$| \__| $$| $$__| $$ | $$ | $$ \$$\
| $$$ \$$$ \$$ $$ \$$ $$ | $$ | $$ | $$
\$$ \$$ \$$$$$$ \$$$$$$ \$$ \$$ \$$
Copyright (C) 2001 - 2014 by Joe Taylor, K1JT.
WSJT-X implements JT9, a new mode designed especially for the LF, MF,
and HF bands, as well as the popular mode JT65. Both modes were
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 proved very effective for worldwide QRP
communication at HF; in contrast, JT9 is optimized for HF and lower
frequencies. JT9 is about 2 dB more sensitive than JT65A while using
less than 10% of the bandwidth. World-wide QSOs are possible with
power levels of a few watts and compromise antennas. A 2 kHz slice of
spectrum is essentially full when occupied by ten JT65 signals. As
many as 100 JT9 signals can fit into the same space, without overlap.
WSJT-X offers a “bi-lingual” operating mode in which you can transmit
and receive JT65 and JT9 signals, switching between modes
automatically as needed. Displayed bandwidth can be as large as 5
kHz. If your receiver has as upper-sideband filter at least 4 kHz
wide, you can have all the typical JT65 and JT9 activity on screen at
once, available for making QSOs with a click of the mouse. Even with
standard SSB-width IF filters, switching between JT65 and JT9 modes is
quick and convenient. Be sure to read the online WSJT-X User's Guide.
Project web site:
http://www.physics.princeton.edu/pulsar/K1JT/wsjtx.html
Project mailing list (shared with other applications from the same
team):
https://groups.yahoo.com/neo/groups/wsjtgroup

58
THANKS Normal file
View File

@ -0,0 +1,58 @@
__ __ ______ _____ ________ __ __
| \ _ | \ / \ | \| \ | \ | \
| $$ / \ | $$| $$$$$$\ \$$$$$ \$$$$$$$$ | $$ | $$
| $$/ $\| $$| $$___\$$ | $$ | $$ ______ \$$\/ $$
| $$ $$$\ $$ \$$ \ __ | $$ | $$| \ >$$ $$
| $$ $$\$$\$$ _\$$$$$$\| \ | $$ | $$ \$$$$$$/ $$$$\
| $$$$ \$$$$| \__| $$| $$__| $$ | $$ | $$ \$$\
| $$$ \$$$ \$$ $$ \$$ $$ | $$ | $$ | $$
\$$ \$$ \$$$$$$ \$$$$$$ \$$ \$$ \$$
Thanks to:
The FFTW library (http://www.fftw.org) without which the efficient
generation of discrete fast Fourier transformations essential to the
decoding DSP algorithms of WSJT-X would be a considerable part of the
project.
The Qt project (http://qt-project.org) that allows us to deliver a
rich industrial strength cross platform GUI application written in
C++.
Nate Bargmann, N0NB, and the Hamlib developer team for their
excellent library and for prompt review and acceptance of the many
pull requests for upstream patches to Hamlib.
Dave Bernstein, AA6YQ, for being so receptive to suggestions
allowing WSJT-X to cooperate with his excellent Amateur Radio DX and
award chasing suite (http://www.dxlabsuite.com).
Laurie Cowcher, VK3AMA, for developing the partner applications
JTAlertX and JTMacrosX (http://www.hamapps.com) that make DX chasing
with WSJT-X such an efficient and pleasurable experience.
The CMake build and packaging tools (http://www.cmake.org) for
their comprehensive scripting tools that make automation of building
and packaging on all supported platforms possible.
The NSIS MS Windows installer scripting and generator tools
(http://nsis.sourceforge.net) that, through the CPack NSIS generator,
allows us to build a comprehensive Windows installer package.
The GNU Compiler Collection (http://gcc.gnu.org) that allows us to
compile and link C++, Fortran and C code to the latest Standards and
with high quality optimization.
The clang C++ & C compiler front ends and LLVM compiler back end
tools (http://clang.llvm.org) that provide us with another, gcc
compatible, high quality C++ and C compiler and Standard Library suite
which, particularly on Apple Mac, allows our code to be ported to the
maximum number of platforms.
The MinGW project (http://www.mingw.org) that ports the gcc
compilers and related GNU tools to the MS Windows environment allowing
a high quality C++, Fortran and C application to be portable between
native MS Windows and other platforms such as Linux and Apple Mac.