Getting Started with K1JT modes using WSJT-X, JTAlert, and DXLab
tnx to Björn SM7IUN, Rich VE3KI, Joe W4TV, Paul N1BUG, Jeff K2BM, Laurie VK3AMA, and Bill G4WJS for the information in this article
WSJT-X uses a soundcard connected to your transceiver to implement communication protocols or "modes" called FT8, JT4, JT9, JT65, QRA64, ISCAT, MSK144, and WSPR, as well as one called Echo for detecting and measuring your own radio signals reflected from the Moon. These modes were all designed for making reliable, confirmed QSOs under extreme weak-signal conditions.
JTAlert interoperates with WSJT-X and DXLab applications to provide
- Audio and visual alerts for several alert conditions
- Your Callsign decoded (someone calling you)
CQ & QRZ
- Wanted Callsign
- Wanted Prefix (by Band/Mode)
- Wanted Grid (by Band/Mode)
- Wanted US State (by Band/Mode)
- Wanted DXCC (by Band/Mode)
- Wanted CQ Zone (by Band/Mode)
- Wanted Continent (by Band/Mode)
- Wanted CQ Marathon (by Band/Mode)
- Logging to DXKeeper and lookup of previously logged QSOs with a decoded Callsign
Automatic posting of decoded Callsigns to SpotCollector (local spots)
- Automatic lookup of decoded callsigns with Pathfinder
- The option to log the current SFI, A-index, and K-index with each QSO
- Support for Web Services
- Lookup of decoded callsigns via QRZ.com (paid) or HamQTH (free)
Upload logged QSO to ClubLog.org and HRDLog.net
Upload all decoded Callsigns with frequency and signal report to HamSpots.net
Limitations
On SpotCollector's Main window, double-clicking a Spot Database Entry will convey that Entry's frequency to WSJT-X, but that Entry's callsign or mode will not be conveyed to WSJT-X.
Callsigns in the WSJT-X Band Activity window are not color-coded to reflect need with respect to DXLab's Realtime Award Tracking for the DXCC, IOTA, Marathon, WAS, WAZ, or WPX awards, or to reflect participation in eQSL or participation in LoTW.
This article provides guidance for installing and using both WSJT-X and JTAlert with DXLab applications. Note that some recommended settings are not required for successful interoperation; these settings are identified with a parenthetical (user preference).
Installing and configuring the software
Install Commander, and configure it to control your transceiver.
- Confirm that it can control your transceiver's frequency and mode, and switch your transceiver between receiving and transmitting.
Optimize Commander's responsiveness to directives from WSJT-X by reducing its Command Interval setting to the minimum value that supports accurate tracking of frequency and mode changes made from the transceiver's front panel. 25 ms is an appropriate Command Interval for most modern transceivers connected to your computer via a COM port configured for 9600 baud or faster. Older transceivers may require larger Command Intervals; if Commander does not accurately track frequency and mode changes made from the transceiver's front panel, double the Command Interval.
Install WSJT-X and JTAlert per their respective instructions.
You can find the latest WSJT-X installation file via https://sourceforge.net/projects/wsjt/ .
You can find the latest JTAlert installation file on http://hamapps.com/. Make sure you also install the Callsign Database and Sounds from the same page. When prompted, select to only install JTAlert for WSJT-X (unless you're also planning to use JTAlert with a JT65-HF derivative or with JTDX).
Operation in the FT4 and FT8 requires your computer clock to be accurate.
- better than ±500 ms for FT4 mode
- better than ±1 s for FT8 mode
See the WSJT-X User Guide for recommended applications that will automatically keep your computer's clock accurate.
If you're using Windows 10, enable Let apps use my microphone in the Settings window's Microphone section. If this option is disabled, applications will be prevented from using any audio device.
Configure your firewall and anti-malware applications to consider JT-Alert and your DXLab applications to be safe.
WSJT-X
Start WSJT-X.
If you want to avoid the splash screen at startup, check the do not show again box in it's lower right.
Open the settings menu (open the File menu's Settings command, or strike the F2 key)
On the General tab,
Enter your call sign, locator grid, and IARU region on the General tab
Uncheck the Show DXCC entity and worked before status box, as JTALert is a better source of this information
Check the TX messages to Rx frequency window box so you can more easily follow the progress of your QSO (user preference).
On the Radio tab
In the Rig dropdown menu, select DXLab Suite Commander
- This enables WSJT-X to control your radio via Commander, rather than via a serial port, or a virtual serial port created by a USB connection.
If you've configured Commander to use other than TCP port 52002, then specify the port TCP Commander is using in the CAT Control panel on the WSJT-X Radio tab in one of these three formats:
- hostname:port
- ipv4-address:port
- [ipv6-address]:port
set the Poll Interval to 1 second
Select CAT as the PTT method (in this context, PTT refers to switching the radio between reception and transmission)
Alternatively, if you have a separate COM port connected to a device with PTT capability triggered by the assertion of the port's DTR or RTS modem control signal, you can configure WSJT-X to use it, as doing so will provide more accurate PTT timing. If you choose this approach, however, don't configure Commander to use the same COM port for PTT, as WSJT-X would then be denied access to the COM port.
If Commander cannot switch your radio between reception and transmission, then consider an alternate selection for PTT method, e.g. VOX.
Select the Mode that is appropriate for your radio.
If your radio provides a DATA mode, then select Data/Pkt
Otherwise, choose USB
If WSJT-X displays the error message Rig failure - DX Lab Suite Commander sent an unrecognized mode: "", that means your radio doesn't provide a DATA mode, choose USB
Set the Split operation to Rig. This setting won't work with some radios, in which case you should instead use Fake it.
- Use the two buttons at the bottom tab to test the interaction with Commander
Click the Test CAT button; it should turn green after a few seconds.
Test your PTT with the Test PTT button to the right of the Test CAT button; clicking it should switch your radio from receiving to transmitting, and clicking it again should switch your radio back to receiving
On the Audio tab
in the Soundcard panel, select the appropriate soundcard Input and Output sections
- You may need to adjust levels in Windows audio settings for best operation. The WSJT-X documentation describes how to do this. The best settings may not be optimal for !Winwarbler operation so you may have to find a compromise.
in the Remember power settings by band panel, check Transmit and Tune boxes
On the Reporting tab
check the Prompt me to Log QSO box
in the UDP Server panel,
set the UDP Server to 127.0.0.1
set the UDP Server port number to 2237
check the Accept UDP requests box
check the Notify on accepted UDP request box (user preference)
check the Accepted UDP requests restores window box (user preference)
in the Secondary UDP Server (deprecated) panel, uncheck the Enable logged contact ADIF broadcast box
On the Frequencies tab,
Set the Frequency Calibration panel's Slope and Intercept to 0
Set the Offset to 0 in any entries in the Station Information panel
On the Advanced tab, enable Two pass decoding to allow HF-style JT65 operation to make more decodes if CPU performance is sufficient (user preference)
Click the OK button to complete configuration.
If the waterfall display is not enabled, enable it by selecting the View menu's Waterfall command
JTAlert
Start JTAlert.
The first time you start JTAlert, it will probably inform you that the WSJT-X grid square differs from the default JTAlert grid square. Correct this by entering your grid square and clicking the OK button.
Click in the JTAlert window's title bar, and open its Settings window by either striking the F2 key, or by clicking on Settings in the window's top bar and then clicking Manage Settings... in the pop-up menu . This window provides access to all settings via a tree control in a panel on the left side; in this tree control, click on a + box to expand a section; click on a - box to contract a section.
Expand the Logging section in the left-side panel; in the Logging Options panel,
check the Mark QSO upload to LoTW as "Requested" box
check the Mark QSO upload to eQSL as "Requested" box
consider checking the Log full name returned from XML lookups box
consider checking the Log full QTH returned from XML lookups box
consider checking the Log propagation data, SFI, A-index, and K-index box
consider checking the Mark QSO upload to LoTW as "Requested box
consider checking the Mark QSO upload to eQSL as "Requested box
consider checking the Remember QSL Request setting across logging and restarts box
Expand the Logging section's DXLab DXKeeper sub-section
Check the Enable DXLab DXKeeper Logging box at the top
If you use eQSL and want automatic uploads, check the Instruct DXKeeper to upload each new QSO to eQSL box
If you use LoTW and want automatic uploads, check the Instruct DXKeeper to upload each new QSO to LoTW box
If you use Club Log and want automatic uploads, check the Instruct DXKeeper to upload each new QSO to Clublog box
If you use QRZ and want automatic uploads, check the Instruct DXKeeper to upload each new QSO to QRZ box
Expand the Applications section in the left-side panel, and then expand its DXLab Suite sub-section
Consider checking the DXKeeper/DXView/Pathfinder Lookup on new DX Call box (note the alternatives to individually direct DXKeeper, DXView, or Pathfinder to perform lookups)
If you want JTAlert to forward decoded transmissions to SpotCollector as local spots, check the Post decoded Callsigns to SpotCollector as local spots box
in the WSJT-X / JTDX section uncheck the Rebroadcast WSJT-X UDP packets box
Expand the Web Services section in the left-side panel, and then expand its Online XML Callbooks sub-section; if you have a QRZ.com or HamQTH.com XML subscription,
- select the subscription you wish to use
specify your Callsign and Password in the appropriate XML Lookup panel
select the Logging section in the left-side panel and consider each of the options that govern XML lookups
The Alerts section in the left-side panel contains many settings, but they are all based on personal preference and you can leave them at default for now. With time you will develop an opinion on how you want them set.
In the Rebuild Alert Database section in the left-side panel, synchronize JTAlert's database with your DXKeeper log:
check the Enable this Rebuild box for each geographic entity you are pursuing
check the Confirmation boxes appropriately for the awards you are pursuing
click the Rebuild All (enabled) button in the upper-right corner; a Log Scan - DXLab DXKeeper window will appear on-screen and display progress
when OK to update your configuration? appears in the Log Scan - DXLab DXKeeper window,
click the OK (Apply) button in the lower-left corner of the Log Scan - DXLab DXKeeper window
then click the Save button in the lower-right corner of the Settings window's Rebuild Alert Database section
close the Settings window
Notes:
Depending on the speed of your computer (and internet connection if you e.g. use direct eQSL/LoTW upload), the Check QSO Log Record timing may have to be changed on Miscellanous->Performance. If see error messages informing you that the check fails, increase this time from the 2 second default.
Both DXKeeper and JTAlert can be configured to automatically upload QSOs to Club Log. If you want your K1JT-mode QSOs automatically uploaded to Club Log, configure DXKeeper to do so, and leave JTAlert's automatic Club Log upload option disabled.
To configure JTAlert to highlight duplicate contest QSOs, in the Worked B4 entry in the Settings window's Alerts section,
check the Ignore QSOs based on log entry date box
check the Ignore B4 status before this date box and specify the Contest Starting Date
SpotCollector
If you are running SpotCollector version 8.2.7 or later, uncheck the Enabled box on the WSJT-X panel on the Configuration window's Spot Sources tab.
Operation
Uncheck the Split box on Commander's Main window before starting WSJT-X.
Detailed descriptions of how to operate, QSO protocol etc. including suggested settings for the waterfall can be found in the WSJT-X documentation, accessible via WSJT-X's Help menu, and in
Note: after unsuccessfully pursuing a QSO, strike the ESC or F4 key to ensure that the WSJT-X Log QSOs window proposes an accurate start time for the next QSO.
After making any change to your DXKeeper log that updates your award progress, like marking QSOs confirmed via an incoming QSL card, or invoking Sync LoTW QSLs, synchronize JTAlert's database with your updated log: in the Rebuild Alert Database section in the left-side panel, synchronize JTAlert's database with your DXKeeper log:
check the Enable this Rebuild box for each geographic entity you are pursuing
check the Confirmation boxes appropriately for the awards you are pursuing
click the Rebuild All (enabled) button in the upper-right corner; a Log Scan - DXLab DXKeeper window will appear on-screen and display progress
when OK to update your configuration? appears in the Log Scan - DXLab DXKeeper window,
click the OK (Apply) button in the lower-left corner of the Log Scan - DXLab DXKeeper window
then click the Save button in the lower-right corner of the Settings window's Rebuild Alert Database section
Note that JTAlert can only access DXKeeper's log while DXKeeper is running. If DXKeeper is not running when you log a QSO, the resulting orphan QSO will be retained in WSJT-X's internal minilog, which is named wsjtx_log.adif and resides in the folder that appears when you direct WSJT-X to run the File menu's Open Log Directory command. To recover such orphan QSOs, you can either enable the Check duplicates on import option on the Import QSOs tab of DXKeeper's Main window with a range of 1 minute and then import wsjtx_log.adif, or -- if wsjtx_log.adif contains a large number of QSOs -- you can use a text editor to copy and paste only the orphan QSOs from wsjtx_log.adif into a new orphan.adi file, and import the orphan.adi into DXKeeper without Check duplicates on import enabled.
Additional Topics
Using WSJT-X with Commander and a Flex-6000 Series Transceiver
Getting Started with K1JT Modes using Direct Interoperation with WSJT-X
Configuring WSJT-X Running on a MAC to Use Commander Running on Parallels for Transceiver Control
Post a question or suggestion on the DXLab Discussion Group