w4kek/WSJT-X
1
0
Fork 0
mirror of https://github.com/saitohirga/WSJT-X.git synced 2026-06-15 12:18:34 -04:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'develop' of bitbucket.org:k1jt/wsjtx into fox_rate_calculations

Browse Source
This commit is contained in:
Brian Moran
2023-05-05 10:26:19 -07:00
parent e2085b0dd5 ea0ae2b18a
commit 2c98a4741e
10 changed files with 201 additions and 144 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Darwin/ReadMe.txt
+38 -113
View File
@@ -1,113 +1,38 @@
Notes on WSJT-X Installation for Mac OS X
-----------------------------------------
If you have already downloaded a previous version of WSJT-X then I suggest
you change the name in the Applications folder from WSJT-X to WSJT-X_previous
before proceeding.
I recommend that you follow the installation instructions especially if you
are moving from v2.3 to v2.4 or later, of WSJT-X or you have upgraded macOS.
Double-click on the wsjtx-...-Darwin.dmg file you have downloaded from K1JT's web-site.
Now open a Terminal window by going to Applications->Utilities and clicking on Terminal.
Along with this ReadMe file there is a file: com.wsjtx.sysctl.plist which must be copied to a
system area by typing this line in the Terminal window and then pressing the Return key.
sudo cp /Volumes/WSJT-X/com.wsjtx.sysctl.plist /Library/LaunchDaemons
you will be asked for your normal password because authorisation is needed to copy this file.
(Your password will not be echoed but press the Return key when completed.)
Now re-boot your Mac. This is necessary to install the changes. After the
reboot you should re-open the Terminal window as before and you can check that the
change has been made by typing:
sysctl -a | grep sysv.shm
If shmmax is not shown as 52428800 then contact me since WSJT-X might fail to load with
an error message: "Unable to create shared memory segment".
You can now close the Terminal window. It will not be necessary to repeat this procedure
again, even when you download an updated version of WSJT-X. It might be necessary if you
upgrade macOS.
Drag the WSJT-X app to your preferred location, such as Applications.
You need to configure your sound card. Visit Applications > Utilities > Audio MIDI
Setup and select your sound card and then set Format to be "48000Hz 2ch-16bit" for
input and output.
Now double-click on the WSJT-X app and two windows will appear. Select Preferences
under the WSJT-X Menu and fill in various station details on the General panel.
I recommend checking the 4 boxes under the Display heading and the first 4 boxes under
the Behaviour heading.
Depending on your macOS you might see a pop-up window suggesting that wsjtx wants to use the
microphone. What this means is that audio input must be allowed. Agree.
Next visit the Audio panel and select the Audio Codec you use to communicate between
WSJT-X and your rig. There are so many audio interfaces available that it is not
possible to give detailed advice on selection. If you have difficulties contact me.
Note the location of the Save Directory. Decoded wave forms are located here.
Look at the Reporting panel. If you check the "Prompt me" box, a logging panel will appear
at the end of the QSO. Visit Section 11 of the User Guide for information about log files
and how to access them.
Finally, visit the Radio panel. WSJT-X is most effective when operated with CAT
control. You will need to install the relevant Mac device driver for your rig,
and then re-launch WSJT-X. Return to the Radio panel in Preferences and in
the "Serial port" panel select your driver from the list that is presented. If you
do not know where to get an appropriate driver, contact me.
WSJT-X needs the Mac clock to be accurate. Visit System Preferences > Date & Time
and make sure that Date and Time are set automatically. The drop-down menu will
normally offer you several time servers to choose from.
On the Help menu, have a look at the new Online User's Guide for operational hints
and tips and possible solutions to any problem you might have.
Please email me if you have problems.
--- John G4KLA (g4kla@rmnjmn.co.uk)
Additional Notes:
1. Information about com.wsjtx.sysctl.plist and multiple instances of WSJT-X
WSJT-X makes use of a block of memory which is shared between different parts of
the code. The normal allocation of shared memory on a Mac is insufficient and this
has to be increased. The com.wsjtx.sysctl.plist file is used for this purpose. You can
use a Mac editor to examine the file. (Do not use another editor - the file
would probably be corrupted.)
It is possible to run two instances of WSJT-X simultaneously. See "Section 16.2
Frequently asked Questions" in the User Guide. If you wish to run more than two instances
simultaneously, the shmall parameter in the com.wsjtx.sysctl.plist file needs to be modified as follows.
The shmall parameter determines the amount of shared memory which is allocated in 4096 byte pages
with 50MB (52428800) required for each instance. The shmall parameter is calculated as:
(n * 52428800)/4096 where 'n' is the number of instances required to run simultaneously.
Replace your new version of this file in /Library/LaunchDaemons and remember to reboot your
Mac afterwards.
Note that the shmmax parameter remains unchanged. This is the maximum amount of shared memory that
any one instance is allowed to request from the total shared memory allocation and should not
be changed.
If two instances of WSJT-X are running, it is likely that you might need additional
audio devices, from two rigs for example. Visit Audio MIDI Setup and create an Aggregate Device
which will allow you to specify more than one interface. I recommend you consult Apple's guide
on combining multiple audio interfaces which is at https://support.apple.com/en-us/HT202000.
2. Preventing WSJT-X from being put into 'sleep' mode (App Nap).
In normal circumstances an application which has not been directly accessed for a while can be
subject to App Nap which means it is suspended until such time as its windows are accessed. If
it is intended that WSJT-X should be submitting continued reports to, for example, PSK Reporter
then reporting will be interrupted. App Nap can be disabled as follows, but first quit WSJT-X:
Open a Terminal window and type: defaults write org.k1jt.wsjtx NSAppSleepDisable -bool YES
If you type: defaults read org.k1jt.wsjtx then the response will be: NSAppSleepDisable = 1;
Close the Terminal window and launch WSJT-X. (If you 'Hide' WSJT-X, this scheme will be suspended.)
Notes on WSJT-X Installation for Mac OS X
-----------------------------------------
If you have already downloaded a previous version of WSJT-X then I suggest
you change the name in the Applications folder from WSJT-X to WSJT-X_previous
before proceeding.
I recommend that you follow the installation instructions especially if you
are moving from v2.4 to v2.5 or later, of WSJT-X or you have upgraded macOS.
Double-click on the wsjtx-...-Darwin.dmg file you have downloaded from K1JT's web-site.
Make sure that you leave this window open for the remaining installation steps.
Now open a Terminal window by going to Applications->Utilities and clicking on Terminal.
Along with this ReadMe file there is a file: com.wsjtx.sysctl.plist which must be copied to a
system area by typing this line in the Terminal window and then pressing the Return key.
sudo cp /Volumes/WSJT-X/com.wsjtx.sysctl.plist /Library/LaunchDaemons
sudo chown root:wheel /Library/LaunchDaemons/com.wsjtx.sysctl.plist
you will be asked for your normal password because authorisation is needed to copy this file.
(Your password will not be echoed but press the Return key when completed.)
IMPORTANT: now you must reboot your Mac otherwise these changes will not take effect.
After the reboot you should re-open the Terminal window as before and you can check
that the change has been made by typing:
sysctl -a | grep sysv.shm
If shmmax is not shown as 52428800 then contact me since WSJT-X might fail to load with
an error message: "Unable to create shared memory segment".
You can now close the Terminal window. It will not be necessary to repeat this procedure
again, even when you download an updated version of WSJT-X. It might be necessary if you
upgrade macOS.
NEWS
+66
View File
@@ -11,6 +11,72 @@
Copyright 2001 - 2023 by Joe Taylor, K1JT, and the WSJT Development Team
Release: WSJT-X 2.7.0-rc1
May 12, 2023
-------------------------
WSJT-X_v2.7.0-rc1 is the first Release Candidate that introduces a new QMAP
program. The target application is EME. Besides that, there are a number of
other enhancements and fixes.
- New QMAP program:
- QMAP is an independent program but is expected to be used cooperatively
with WSJT-X. QMAP acts as a wideband decoder for one of the 60-second
submodes of Q65. Decoding results are shared with WSJT-X, which manages
operator interactions and rig control.
- WSJT-X can cooperate with QMAP via shared memory. In such operation WSJT-X
provides a narrow (up to 5 kHz) view in which to conduct EME QSOs with
full Doppler control, T/R switching, message sequencing, etc., and QMAP
provides a wideband (90 kHz) view of all digital EME activity on the band.
- The Q65 decoder has been enhanced for better performance. These improvements
apply to decodes made in WSJT-X and also to those made in QMAP, which uses
the identical downstream code.
- QMAP provides most of the capabilities of map65, excert for adaptive
polarization.
- New Q65 Pileup mode, designed to help manage weak-signal pileup situations such
as those experienced by 6-meter EME DXpeditions. Messages exchange 4-character
locators rather than signal reports. Decoder "memory" provides q3-level
sensitivity for up to 40 callers decoded at least once in the past 24 hours,
and for whom the Moon is above the horizon.
- More efficient spotting to PSK Reporter. The transmission is now spread in time
and redundant spots are removed, which will hopefully lead to a noticeably lower
load for PSK Reporter.
- Support of the HamSCI Festivals of Eclipse Ionospheric Science: Temporarily,
during the upcoming solar eclipses, spots are transmitted more frequently to
PSK Reporter where this data is collected and used for analysis.
- WSJT-X is now able to process more than 100 FT8 decodes per period.
- Further improvements to the Fox mode:
- Better internal handling of the two queues.
- The Fox Log window now displays statistical data on the QSO rate.
- When the location is changed (e.g during portable operations) an updated grid
will be sent to PSK Reporter.
- The cty.dat file can now be updated from the settings. Just click the new
button on the Colors tab.
- New status display when fetching a new LotW file.
- AutoSeq now also accepts MSHV multistream messages when in Hound mode.
- Better protection against unwanted effects caused by late FT8 decodes.
- Fixing an inconsistency where in the Contest Name was not correctly
remembered.
- Various other minor fixes and improvements to the code.
- Updated hyperlinks to our homepage and to our new WSJT GROUP User Forum
(https://groups.io/g/wsjtgroup/) can now also be found in the User Guide.
- Some clarifications to the build instructions for macOS.
Release: WSJT-X 2.6.1
January 16, 2023
-------------------------
Release_Notes.txt
+66
View File
@@ -11,6 +11,72 @@
Copyright 2001 - 2023 by Joe Taylor, K1JT, and the WSJT Development Team
Release: WSJT-X 2.7.0-rc1
May 12, 2023
-------------------------
WSJT-X_v2.7.0-rc1 is the first Release Candidate that introduces a new QMAP
program. The target application is EME. Besides that, there are a number of
other enhancements and fixes.
- New QMAP program:
- QMAP is an independent program but is expected to be used cooperatively
with WSJT-X. QMAP acts as a wideband decoder for one of the 60-second
submodes of Q65. Decoding results are shared with WSJT-X, which manages
operator interactions and rig control.
- WSJT-X can cooperate with QMAP via shared memory. In such operation WSJT-X
provides a narrow (up to 5 kHz) view in which to conduct EME QSOs with
full Doppler control, T/R switching, message sequencing, etc., and QMAP
provides a wideband (90 kHz) view of all digital EME activity on the band.
- The Q65 decoder has been enhanced for better performance. These improvements
apply to decodes made in WSJT-X and also to those made in QMAP, which uses
the identical downstream code.
- QMAP provides most of the capabilities of map65, excert for adaptive
polarization.
- New Q65 Pileup mode, designed to help manage weak-signal pileup situations such
as those experienced by 6-meter EME DXpeditions. Messages exchange 4-character
locators rather than signal reports. Decoder "memory" provides q3-level
sensitivity for up to 40 callers decoded at least once in the past 24 hours,
and for whom the Moon is above the horizon.
- More efficient spotting to PSK Reporter. The transmission is now spread in time
and redundant spots are removed, which will hopefully lead to a noticeably lower
load for PSK Reporter.
- Support of the HamSCI Festivals of Eclipse Ionospheric Science: Temporarily,
during the upcoming solar eclipses, spots are transmitted more frequently to
PSK Reporter where this data is collected and used for analysis.
- WSJT-X is now able to process more than 100 FT8 decodes per period.
- Further improvements to the Fox mode:
- Better internal handling of the two queues.
- The Fox Log window now displays statistical data on the QSO rate.
- When the location is changed (e.g during portable operations) an updated grid
will be sent to PSK Reporter.
- The cty.dat file can now be updated from the settings. Just click the new
button on the Colors tab.
- New status display when fetching a new LotW file.
- AutoSeq now also accepts MSHV multistream messages when in Hound mode.
- Better protection against unwanted effects caused by late FT8 decodes.
- Fixing an inconsistency where in the Contest Name was not correctly
remembered.
- Various other minor fixes and improvements to the code.
- Updated hyperlinks to our homepage and to our new WSJT GROUP User Forum
(https://groups.io/g/wsjtgroup/) can now also be found in the User Guide.
- Some clarifications to the build instructions for macOS.
Release: WSJT-X 2.6.1
January 16, 2023
-------------------------
doc/common/links.adoc
+4 -4
View File
@@ -97,8 +97,8 @@ d). Edit lines as needed. Keeping them in alphabetic order help see dupes.
:win32_openssl: https://slproweb.com/download/Win32OpenSSL_Light-1_1_1s.msi[Win32 OpenSSL Light Package]
:win64_openssl: https://slproweb.com/download/Win64OpenSSL_Light-1_1_1s.msi[Win64 OpenSSL Light Package]
:writelog: https://writelog.com/[Writelog]
:wsjtx_group: https://groups.io/g/wsjtgroup[WSJT GROUP Forum]
:wsjtx_group2: https://groups.io/g/wsjtgroup[join the group]
:wsjtx_group: https://groups.io/g/wsjtgroup[WSJT GROUP User Forum]
:wsjtx_group2: https://groups.io/g/wsjtgroup/join[join the group]
:wsjtx: https://sourceforge.net/projects/wsjt/files/wsjtx-{VERSION}/wsjtx.html[WSJT-X]
:wspr0_guide: https://wsjt.sourceforge.io/WSPR0_Instructions.TXT[WSPR0 Guide]
:wspr: https://sourceforge.net/projects/wsjt/files/wsjtx-{VERSION}/wspr.html[WSPR Home Page]
@@ -121,8 +121,8 @@ d). Edit lines as needed. Keeping them in alphabetic order help see dupes.
:svn: https://subversion.apache.org/packages.html#windows[Subversion]
:win32: https://sourceforge.net/projects/wsjt/files/wsjtx-{VERSION}/wsjtx-{VERSION}-win32.exe[wsjtx-{VERSION}-win32.exe]
:win64: https://sourceforge.net/projects/wsjt/files/wsjtx-{VERSION}/wsjtx-{VERSION}-win64.exe[wsjtx-{VERSION}-win64.exe]
:wsjt-devel: https://sourceforge.net/p/wsjt/mailman/wsjt-devel/[join the group]
:wsjt-devel2: https://sourceforge.net/p/wsjt/mailman/wsjt-devel/[subscribe to the list]
:wsjt-devel: https://sourceforge.net/projects/wsjt/lists/wsjt-devel/[join the group]
:wsjt-devel2: https://sourceforge.net/projects/wsjt/lists/wsjt-devel/[subscribe to the list]
:wsjt_repo: https://sourceforge.net/p/wsjt/wsjt_orig/ci/master/tree/[WSJT Source Repository]
:wspr_code: https://sourceforge.net/projects/wsjt/files/wsjtx-{VERSION}/WSPRcode.exe[WSPRcode.exe]
:wspr_svn: https://sourceforge.net/p/wsjt/wspr/ci/master/tree/[WSPR Source Repository]
doc/user_guide/en/acknowledgements.adoc
+9 -9
View File
@@ -2,9 +2,9 @@
The _WSJT_ project was started by *K1JT* in 2001. Since 2005 it has
been an Open Source project, and it has included the programs _WSJT_,
_MAP65_, _WSPR_, _WSJT-X_, and _WSPR-X_. *G4WJS* (since 2013), *K9AN*
(since 2015), *IV3NWV* (since 2016), *KG4IYS* (since 2021), and
*DG2YCB* (since 2021) have made major contributions to _WSJT-X_.
_MAP65_, _WSPR_, _WSJT-X_, and _QMAP_. *G4WJS* (since 2013), *K9AN*
(since 2015), *IV3NWV* (since 2016), *DG2YCB* (since 2021), and
*N9ADG* (since 2022) have made major contributions to _WSJT-X_.
Together with K1JT they now form the core development team. *G4WJS*
and *W9MDB* have made major contributions to the _hamlib_ library, on
which _WSJT-X_ depends for rig control.
@@ -13,12 +13,12 @@ All code in the _WSJT_ project is 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, DF2ET, DJ0OT, G3WDG, G4KLA, IW3RAB, K3WYC, KA1GT, KA6MAL, KA9Q,
KB1ZMX, KD6EKQ, KI7MT, KK1D, ND0B, PY2SDR, VE1SKY, VK3ACF, VK4BDJ,
VK7MO, W3DJS, W3SZ, W4TI, W4TV, and W9MDB*. Each of these amateurs
has helped to bring the program’s design, code, testing, and/or
documentation to its present state.
_WSJT-X_ in particular, in addition to those mentioned above we
acknowledge contributions from *AC6SL, AE4JY, DF2ET, DJ0OT, G3WDG,
G4KLA, IW3RAB, K3WYC, KA1GT, KA6MAL, KA9Q, KB1ZMX, KD6EKQ, KI7MT,
KK1D, ND0B, PY2SDR, VE1SKY, VK3ACF, VK4BDJ, VK7MO, W3DJS, W3SZ, W4TI,
and W4TV*. Each of these amateurs has helped to bring the program’s
design, code, testing, and/or 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*
doc/user_guide/en/introduction.adoc
+3 -1
View File
@@ -7,7 +7,9 @@ K1**JT**,`" while the suffix "`*-X*`" indicates that _WSJT-X_ started
as an extended branch of an earlier program, _WSJT_, first released in
2001. Bill Somerville, G4WJS, Steve Franke, K9AN, and Nico Palermo,
IV3NWV, have been major contributors to development of _WSJT-X_ since
2013, 2015, and 2016, respectively.
2013, 2015, and 2016, respectively. Bill Somerville died suddenly and
unexpectedly in December 2021; Uwe Risse, DG2YCB, joined the core
development team soon afterward, and Brian Moran, N9ADG, in 2022.
_WSJT-X_ Version {VERSION_MAJOR}.{VERSION_MINOR} offers eleven
different protocols or modes: *FST4*, *FT4*, *FT8*, *JT4*, *JT9*,
doc/user_guide/en/support.adoc
+3 -4
View File
@@ -5,15 +5,14 @@ _WSJT-X_ is the {wsjtx_group} at email address
wsjtgroup@groups.io. The chances are good that someone with
similar interests and equipment has already solved your problem and
will be happy to help. To post messages here you will need to
{wsjt-devel}.
{wsjtx_group2}.
=== Bug Reports
One of your responsibilities as a _WSJT-X_ user is to help the
volunteer programmers to make the program better. Bugs may be
reported to the WSJTGROUP forum on Groups.io {wsjtgroup_mail} or the WSJT
Developers list (wsjt-devel@lists.sourceforge.net). Again, you will
need to {wsjtx_group2} or {wsjt-devel2}.
reported preferably to the WSJT Developers email list
(wsjt-devel@lists.sourceforge.net). You will need to {wsjt-devel2}.
To be useful, bug reports should include at least the following
information:
lib/ft8_decode.f90
+1 -1
View File
@@ -60,7 +60,7 @@ contains
character datetime*13,msg37*37
character*37 allmessages(200)
character*12 ctime
integer allsnrs(100)
integer allsnrs(200)
integer itone(NN)
integer itone_save(NN,MAX_EARLY)
real f1_save(MAX_EARLY)
widgets/about.cpp
+5 -5
View File
@@ -21,14 +21,14 @@ CAboutDlg::CAboutDlg(QWidget *parent) :
"WSJT-X implements a number of digital modes designed for <br />"
"weak-signal Amateur Radio communication. <br /><br />"
"&copy; 2001-2022 by Joe Taylor, K1JT, Bill Somerville, G4WJS, <br />"
"&copy; 2001-2023 by Joe Taylor, K1JT, Bill Somerville, G4WJS, <br />"
"Steve Franke, K9AN, Nico Palermo, IV3NWV, <br />"
"Chester Fennell, KG4IYS, and Uwe Risse, DG2YCB <br /><br />"
"Uwe Risse, DG2YCB, and Brian Moran, N9ADG <br /><br />"
"We gratefully acknowledge contributions from AC6SL, AE4JY,<br />"
"DF2ET, DJ0OT, G3WDG, G4KLA, IW3RAB, K3WYC, KA1GT,<br />"
"KA6MAL, KA9Q, KB1ZMX, KD6EKQ, KI7MT, KK1D, ND0B, PY2SDR,<br />"
"VE1SKY, VK3ACF, VK4BDJ, VK7MO, W3DJS, W3SZ, W4TI, W4TV,<br />"
"and W9MDB.<br /><br />"
"KA6MAL, KA9Q, KB1ZMX, KD6EKQ, KG4IYS, KI7MT, KK1D, ND0B,<br />"
" PY2SDR, VE1SKY, VK3ACF, VK4BDJ, VK7MO, W3DJS, W3SZ, W4TI,<br />"
" W4TV, and W9MDB.<br /><br />"
"WSJT-X is licensed under the terms of Version 3 <br />"
"of the GNU General Public License (GPL) <br /><br />"
"<a href=" TO_STRING__ (PROJECT_HOMEPAGE) ">"
widgets/mainwindow.cpp
+6 -7
View File
@@ -1093,16 +1093,14 @@ MainWindow::MainWindow(QDir const& temp_directory, bool multiple,
void MainWindow::not_GA_warning_message ()
{
/* ### TEMPORARY ###
MessageBox::critical_message (this,
"This is a pre-release version of WSJT-X 2.6.0 made\n"
"This is a pre-release version of WSJT-X 2.7.0-rc1 made\n"
"available for testing purposes. By design it will\n"
"be nonfunctional after Mar 31, 2023.");
"be nonfunctional after Jan 15, 2024.");
auto now = QDateTime::currentDateTimeUtc ();
if (now >= QDateTime {{2023, 03, 31}, {23, 59, 59, 999}, Qt::UTC}) {
if (now >= QDateTime {{2024, 01, 15}, {23, 59, 59, 999}, Qt::UTC}) {
Q_EMIT finished ();
}
*/
}
void MainWindow::initialize_fonts ()
@@ -2809,10 +2807,10 @@ void MainWindow::on_actionCopyright_Notice_triggered()
"\"The algorithms, source code, look-and-feel of WSJT-X and related "
"programs, and protocol specifications for the modes FSK441, FST4, FT8, "
"JT4, JT6M, JT9, JT65, JTMS, QRA64, Q65, MSK144 are Copyright (C) "
"2001-2022 by one or more of the following authors: Joseph Taylor, "
"2001-2023 by one or more of the following authors: Joseph Taylor, "
"K1JT; Bill Somerville, G4WJS; Steven Franke, K9AN; Nico Palermo, "
"IV3NWV; Greg Beam, KI7MT; Michael Black, W9MDB; Edson Pereira, PY2SDR; "
"Philip Karn, KA9Q; Chester Fennell, KG4IYS; Uwe Risse, DG2YCB; "
"Philip Karn, KA9Q; Uwe Risse, DG2YCB; Brian Moran, N9ADG; "
"and other members of the WSJT Development Group.\"");
MessageBox::warning_message(this, message);
}
@@ -8723,6 +8721,7 @@ void MainWindow::locationChange (QString const& location)
if (m_config.my_grid () != grid) {
m_config.set_location (grid);
genStdMsgs (m_rpt, false);
pskSetLocal ();
statusUpdate ();
}
} else {