jt64setqt

JTSDK64 Tools is a collection of 64-Bit Open Source frameworks, library's and associated utilities focused on compiling WSJT-X, WSJT, MAP65, and WSPR applications.


License
GPL-3.0
Install
pip install jt64setqt==0.0.22

Documentation

JTSDK64 Tools

JTSDK64 Tools is a collection of 64-Bit Open Source frameworks, library's and associated utilities focused on compiling WSJT-X, WSJT, MAP65, and WSPR applications which are designed for weak-signal digital communication used by amateur radio operators world wide.

In addition to the required WSJT build dependencies, a number of optional tools are available: MSYS2, PostgreSQL, Dotnet Core SDK, Java Open JDK, Ant, Maven, Gradle, and more.

The primary focus of this document is to install the JTSDK64 Core Tools, or the minimal requirements for compiling the WSJT suite of applications including Hamlib.

Preparation

Before installing JTSDK64-Tools, you should remove all previous version of JTSDK, particularly those elements that were installed to system folders such as:

  • Git
  • VS Code
  • PostgreSQL
  • Python, all Anaconda and Miniconda versions.
  • Java

If you chose to leave them installed (not recommended), you will need to edit the Global Variables and Environment section of the jtsdk64-setup.cmd script and point the relevant paths to your current install configuration.

It should be noted, while removing Git and VS Code you will not loose any of your custom settings. Such items are kept outside the installation tree and will be picked back up at the next install.

::---------------------------------------------------------------------------
:: GLOBAL ENVIRONMENT VARIABLES and PATHS
::---------------------------------------------------------------------------

:: Paths
SET JTSDK_HOME=%CD%
SET TOOLS_DIR=%JTSDK_HOME%\tools
SET SETUP_DIR=%JTSDK_HOME%\tools\setup
SET CURL_DIR=%SETUP_DIR%\curl\bin

:: Global Environment Variables Variables
SET GIT_INSTALL_DIR=%PROGRAMFILES%\Git
SET DOTNET_INSTALL_DIR=%PROGRAMFILES%\dotnet
SET PYTHON_INSTALL_DIR=%LOCALAPPDATA%\Miniconda3

SET PGSQL_INSTALL_DIR=%PROGRAMFILES%\PostgreSQL\11
SET PGSQL_DATA_DIR=%LOCALAPPDATA%\PostgreSQL\11\data

SET QT_INSTALL_DIR=%TOOLS_DIR%\Qt
SET JAVA_INSTALL_DIR=%PROGRAMFILES%\java

NOTE: For JAVA_HOME, either at the system level or script, this will need to be adjusted at some point. Currently, Java and associated apps like Ant, Maven and Gradle are "NOT" part of the Core Tools. No Immediate action is required for Java at this time.

Before stating the installation:

  • Be sure all applications are closed
  • Perform a system re-boot
  • After which, run the main jtsdk64-tools-3.1.0.exe installer.

Installation and Configuration

All you need to get started is contained within then InnoSetup installers available at JTSDK SourceForge

Download and Run Installers

Download both the Tools and Apps installers

Run The Tools first, them

  1. Run the jtsdk64-tools-3.1.0.exe
  2. Run the jtsdk64-apps-3.1.0.1.exe

Postinstall

When the update installer is finished, use the Windows Start Menu and launch JTSDK64-Setup

Start >> JTSDK64-Tools >> JTSDK64-Setup

Upgrade Current Installation

If you are upgrading from a previous installation, all that is required is to update the Python packages.

# At the command prompt, type:

pysetup install-deps

New Installation

If this is a new installation, you need to run the post install script. At the JTSDK64 Setup Prompt, start the postinstall script with:

type: postinstall

You will be asked which applications you'd like to install by answering Y = Yes or N = No. For Qt there are three possible answers, M = Minimal, F = Full, or S = Skip.

For first time installations. select all the available options including MSYS2.

Required Installs

For building WSJT-X and Hamlib, the following are required install / configuration items:

  • Python, for managing the environmet
  • Git-SCM, source code management
  • QT, libraries and compilers
  • MSYS2 for building Hamlib

Option Selections

Regarding Qt, if you have any plans on testing / using multiple versions of Qt, you should select the F option for a full installation.

NOTE: Depending on your computer and internet speeds, this could take upwards of an hour or more to complete; the majority of time taken by the Qt section.

 ---------------------------------------------------
 JTSDK64 Tools Post Install Selections
 ---------------------------------------------------

 At the prompts, indicate which components
 you want to install, use ( Y = Yes or N = No )

 For the Qt Install Selection:
   D = Default ( minimal set of tools )
   F = Full ( full set of tools )
   N = Skip Installation

 NOTE: VS Code and PostgreSQL are NOT required
 for building WSJT-X, all others are.

Input Your Install Selections
(required) Python       : y
(required) Python       : y
(required) Git-SCM      : y
(required) Full Qt      : f
(required) MSYS2 Setup  : y
(optional) VS Code      : n
(optional) Postgres     : n

MSYS2 Update and Configuration

As with JTSDK versoin 2, the MSYS2 installation will need to be updated before installing hamlib dependencies. You can do this manually with a shortcut or through the menu system, the choice is yours. For consistency, this document will be using the menu system.

You can read more about the MSYS2 setup process from their website.

Main Screen

When MSYS2 first opens up, it will go through a series of configurations for the your current user; create home directory, generate profiles etc. Once complete, you'll be presented with the main splash screen for JTSDK64 Tools MSYS2.

MSYS2 Splash Screen

JTSDK64 Tools MSYS2 using QT v

For main menu, type ..: menu
For Help Menu, type ..: jthelp

Copyright (C) 2013-2019, GPLv3, Greg Beam, KI7MT
This is free software; There is NO warranty; not even
for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

# To use the menu, type:
menu

JTSDK MSYS2 Menu Options

The following options are available on the JTSDK64 Tools MSYS2 Menu:

-------------------------------------
JTSKD64 Tools Main Menu
------------------------------------
 1. List help commands
 2. Install hamlib dependencies
 3. Update scripts
 4. Print version information
 5. Build hamlib
 6. Update msys2 packages
 e. Enter 'e' or 'q' to exit
Enter your selection, then hit <return>:

Update MSYS2 Database and Runtime Packages

  1. The first set of actions is to use select options 6 and upgrade the MSYS2 database / runtime packages.
  2. Once the first update is complete, click the X at the top right to close the MSYS2 window.
  3. Back in the JTSDK64 Setup environment, type msys2 to re-lauch the console.
  4. Run the menu again, type: menu
  5. Select option 6 again
  6. Repeat option 6 until there are no further updates.

Install Hamlib Dependencies

  1. Using the menu tools menu again, select option 2 to install Hamlib packages

Building Hamlib

Now that the MSYS2 environment is updated, and all dependencies have been installed, its time to build hamlib.

  1. Using the MSYS2 Tools Menu, select option 5.

This will use the default QT version (5.12.4) to build the latest version of Hamlib from Bill's (G4WJS) Git repository. The output location and other associated build-details will be printed in the summary.

Conclusion

At this point in the installation, the environment should be ready to build WSJT-X or be used for any number of other purposes. When the user guide is complete, it will be posted to a Github.io page.

Community Support

To assist users with installation, usage, compiling applications, and general discussion, use:

Bug Reports

For submitting bug reports and feature requests, use the Issue Tracker.

The aim of JTSDK64-Tools is to use an Agile delivery approach to create a high-quality, yet flexible build system. Utilizing Github's Issue Tracker. users can quickly see the status of any particular request, discuss the merits, and implement the final disposition.