Skip to content

Commit 801fd2c

Browse files
committed
To 4.0.0-U1 Support for Boost > 1.85.0 and DOc Updates
1 parent 656c0b2 commit 801fd2c

File tree

13 files changed

+99
-151
lines changed

13 files changed

+99
-151
lines changed

README.md

Lines changed: 9 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -26,10 +26,12 @@ completely removes needs for capable third-party environments such as [Python][]
2626
As of [JTSDK64-3.4.0][] there are no longer distinctions between "Base" and "Tools" packages. There will just me "Main Releases" and "Updates".
2727

2828
- Under the [JTSDK64-3.2-Stream][] the "Base Package" was [JTSDK64-Base-3.2.3][]. Under the JTSDK64-4.0-Stream the former "Base" deployment package will become [JTSDK64-4.0.0][].
29-
- Under the [JTSDK64-3.2-Stream][] the "Patch Package" was [JTSDK64-Tools-3.2.3.3][]. Under the JTSDK64-4.0-Stream the "Update" packages will become [JTSDK64-4.0.0-U1][].
29+
- Under the [JTSDK64-3.2-Stream][] the "Patch Package" was [JTSDK64-Tools-3.2.3.3][]. Under the JTSDK64-4.0-Stream the "Update" packages will become/is [JTSDK64-4.0.0-U1][].
3030

3131
The Main deployment package - [JTSDK64-4.0.0][] - can be downloaded at https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-4.0-Stream/JTSDK64-4.0.0.exe
3232

33+
The Update deployment package - [JTSDK64-4.0.0-U1][] - can be downloaded at https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-4.0-Stream/JTSDK64-4.0.0-U1.exe
34+
3335
This README.md file includes deployment instructions. The very latest news - including tips
3436
to solve issues - can be found at https://hamlib-sdk.sourceforge.io/ .
3537

@@ -76,28 +78,11 @@ build libraries (i.e. [Boost 1.85](Boost-1.85.0) ) as part of the learning proce
7678
Current packaging preempts known cases of proposed licence and delivery condition changes.
7779

7880
************************************************************************************
79-
Precompiled drop-in packages for [Boost-1.85.0][]
80-
are available - saving many hours. Note that the continued production of these files is under review.
81-
82-
[Boost-1.85.0][] is built with and supplied under Qt's 5.15.2 [MinGW 8.1](MinGW) environs.
83-
84-
**Note:** It is not recommended to use [Boost-1.86.0][] or later with [Qt][] 5.15.2 as there are some build and compatability issues (related to Qt 5.16.2's MinGW 8.1).
85-
86-
Extract the folder for the Boost version-package that you want to use into **x:\JTSDK64-Tools\tools\boost** (create the directory if it does not exist) and then remove the -7.3, -8.1 or -11.2 suffix !
81+
Precompiled drop-in packages are no longer available as Sourceforge, our project host, are auditing space.
8782
************************************************************************************
88-
The recommended development environment should be [JTSDK64-4.0.0][] with the latest update applied i.e [JTSDK64-4.0.0-U1][] if available.
89-
90-
The current environment incorporates [Qt][] 5.15.2 and support for building [Boost-1.85.0][] working with [MinGW 8.1](MinGW) under
91-
the **mingw64 8.1** [MSYS2][] environment.
83+
The recommended development environment should be [JTSDK64-4.0.0][] with the latest update [JTSDK64-4.0.0-U1][] applied.
9284
************************************************************************************
9385

94-
### The Next Steps
95-
96-
Version 4 of the JTSDK will involve a number of strategic re-thinks - and will be developed actively once
97-
[Qt][] 5.15.2 is unavailable for deployment.
98-
99-
Watch the [JTSDK Forum][] for updates and to contribute.
100-
10186
### Conventions used in this document.
10287

10388
Drive paths will be referred to as x: (i.e. **x:\JTSDK64-Tools\config**) , where **x:** is the default deployment drive
@@ -212,10 +197,10 @@ An **Update** package can only be applied to a matching release. i.e. You cannot
212197
- Download the latest **Update** packages from https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-4.0-Stream/
213198

214199
************************************************************************************
215-
There are no current update packages available.
200+
The current update deployment package - [JTSDK64-4.0.0-U1][] - can be downloaded at https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-4.0-Stream/JTSDK64-4.0.0-U1.exe
216201
************************************************************************************
217202

218-
- Deploy the **Update** package (if it is available and if it exists) [JTSDK64-4.0.0-U1][] to your JTSDK install directory.
203+
- Deploy the **Update** package [JTSDK64-4.0.0-U1][] to your JTSDK install directory.
219204

220205
Updates may be required for the [MSYS2][] environment. Therefore the "profile" directory for
221206
[MSYS2][] may be deleted and re-created.
@@ -314,7 +299,7 @@ This DLL may be copied and placed into that folder, negating the need for deploy
314299
** Note that these instructions assumes a fresh Windows 10 or 11 Virtual Machine is used **
315300

316301
- Deploy the **Release** installer [JTSDK64-4.0.0][] inside a FRESH, FULLY UPDATED WINDOWS 10 or 11 VM.
317-
- Deploy the latest **update** Package, if it exists, to your deployment i.e. [JTSDK64-4.0.0-U1][]
302+
- Deploy the latest **update** Package to your installation i.e. [JTSDK64-4.0.0-U1][]
318303

319304
It is recommended to use all the initial default settings and file locations.
320305

@@ -326,7 +311,7 @@ A screen similar to the following should eventually appear:
326311

327312
```
328313
-------------------------------------------
329-
JTSDK Setup v4.0.0
314+
JTSDK Setup v4.0.0.1
330315
-------------------------------------------
331316
332317
Required Tools

docs/index.html

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
<meta http-equiv="expires" content="0" />
99
<meta http-equiv="expires" content="Tue, 01 Jan 1980 1:00:00 GMT" />
1010
<meta http-equiv="pragma" content="no-cache" />
11-
<title>Hamlib SDK Version 4</title>
11+
<title>Hamlib SDK / JTSDK Version 4</title>
1212
<link rel="stylesheet" href="style-new.css">
1313
<link rel="shortcut icon" type="image/x-icon" href="favicon.ico" />
1414
</head>
@@ -41,19 +41,28 @@ <h2>Evolving the JT-ware Software Developer's Kit (JTSDK)</h2>
4141
<td width="16.6%" align="center"><a href="./ver3/index3.html">Version 3 Documentation</a></td>
4242
<td width="16.6%" align="center"><a href="./ver4/index4.html">Version 4 Documentation</a></td>
4343
<td width="16.6%" align="center"><a href="./Qt/indexQt.html">JTSDK Qt Guide</a></td>
44-
<td width="16.6%" align="center"><a href="https://groups.io/g/JTSDK">JTSDK Forum</a></td>
44+
<td width="16.6%" align="center"><a href="https://groups.io/g/JTSDK">JTSDK Forum</a></td>
4545
<td width="16.5%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/">Sourceforge</a></td>
4646
<td width="16.7%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-4.0-Stream/">Download</a</td>
4747
</tr>
4848
</table>
4949
<hr/>
50+
<h3>Important Note.</h3>
51+
<ul>
52+
<p>Development of the <a href="./ver3/index3.html">Version 3-Streams</a> of the Hamlib SDK (JTSDK) has concluded. Further maintenance will not be performed on images from this stream.</p>
53+
<p>If third-parties wish to continue any component of the <a href="./ver3/index3.html">Version 3-Stream</a> of the Hamlib SDK please contact the developers via the <a href="[email protected]">forum</a>. Tested efforts can and will be uploaded and made available here.</p>
54+
<p>All reference(s) to <a href="./ver3/index3.html">Version 3-Streams</a> from this master documentation site will be removed come 1st June 2025. Resources will not be lost; they will just be archived and no longer maintained.</p>
55+
</ul>
56+
<h3>Vale: Mike W9MDB(sk).</h3>
57+
<ul>
58+
<p>The community associated with this project are deeply saddened at the passing of one of the great supporters and contributors to this project - <a href="https://www.qrz.com/db/W9MDB">Mike Black W9MDB</a>.</p>
59+
<p>Please refer to the QRZ.COM page at <a href="https://forums.qrz.com/index.php?threads/mike-black-w9mdb-sk.949794/l">https://forums.qrz.com/index.php?threads/mike-black-w9mdb-sk.949794/</a>.</p>
60+
</ul>
5061
<h3>Introduction.</h3>
5162
<ul>
5263
<p>Development of <a href="./ver4/index4.html">Version 4</a> of the Hamlib SDK (JTSDK) is now current.</p>
53-
<p>Development of <a href="./ver3/index3.html">Version 3</a> of the Hamlib SDK (JTSDK) has concluded and further maintenance will not occur.</p>
54-
<p>This page links to both the <a href="./ver3/index3.html">Version 3</a> and <a href="./ver4/index4.html">Version 4</a> Kit documentation.</p>
55-
<p><a href="./ver4/index4.html">Version 4</a> of the JTSDK/Hamlib SDK is Qt 6.x centric - but will support Archived Deployments of <a href="https://www.qt.io/blog/qt-5.15.2-released">Qt 5.15.2</a></p>
56-
<p>Please watch this space !</p>
64+
<p><a href="./ver4/index4.html">Version 4</a> of the JTSDK/Hamlib SDK aims to be > Qt 6.6.3 centric - but will support archive-repository-delivered deployments of <a href="https://www.qt.io/blog/qt-5.15.2-released">Qt 5.15.2</a></p>
65+
<p>Please watch this space and information/notes made available via the <a href="https://groups.io/g/JTSDK">[email protected] forum</a>.</p>
5766
</ul>
5867
<hr/>
5968
<table border="0" width=100%>

docs/ver4/AN4.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -199,7 +199,7 @@ <h3>CPACK Packaging Issues - Not Finding DLL's</h3>
199199
<ul>
200200
<p><strong>$env:Path += "</strong>;C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\5.15.2\bin<strong>"</strong></p>
201201
</ul>
202-
<li>If you are using <strong>Qt 6.7.2</strong> (experimental only - Will not build JT-ware yet):</li>
202+
<li>If you are using <strong>Qt 6.7.2</strong> (experimental only - It will only build specialised, experimental JT-ware versions at this stage. See <a href="sourceforge.net/projects/wsjt-x-improved/files/WSJT-X_v2.8.0/Source%20code/">WSJT-X Imoroved</a> as an example):</li>
203203
<ul>
204204
<p><strong>$env:Path += "</strong>;C:\Windows\SysWOW64\downlevel;C:\JTSDK64-Tools\tools\hamlib\qt\6.7.2\bin<strong>"</strong></p>
205205
</ul>

docs/ver4/DG4-Build-Boost.html

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -55,11 +55,12 @@ <h3>Introduction</h3>
5555
<p>If you want ALSA support – which requires a licensed SDK - refer to notes in the WSJT-X source.</p>
5656
</ul>
5757
<hr/>
58-
<h2>Using the Deploy-Boost Script</h2>
58+
<h2>Configuring the Environment</h2>
5959
<hr/>
6060
<ul>
61-
<p>This script, available from the <strong>JTSDK64-Tools</strong> console, can automate the entire process of building <strong>Boost</strong>. To use this script to properly build <strong>Boost</strong> there are some configuration changes to the environment that should be made first. The environment configuration setting <em>unixtools=</em> should be set to <em>enabled</em> inside <strong>Versions.ini</strong>.</p>
62-
<p>This setting should be returned to <em>disabled</em> after you have built <strong>Boost</strong>.</p>
61+
<p>The script <strong>Deploy-Boost</strong> is available from the <strong>JTSDK64-Tools</strong> console and automates the process of building and deploying Boost.</p>
62+
<p>These processes here describe how to build and deploy Boost without the use of the <strong>Deploy-Boost</strong> tool.</p>
63+
<p>Execute the following command from the <strong>JTSDK64-Tools</strong> console:</p>
6364
<ul>
6465
<li>Using Windows File Manager, navigate to <strong>x:\JTSDK64-Tools\config</strong>.</li>
6566
<li>Right click on <strong>Versions.ini</strong> and select your favorite text editor or select 'Open' to edit the file.</li>
@@ -86,7 +87,7 @@ <h3>Step 2: Deploy the Build Tools</h3>
8687
<li>Execute the following command inside the JTSDK-Tools environment:</li>
8788

8889
<ul>
89-
<li><strong>msys2</strong></li>
90+
<li><strong>mingw64</strong></li>
9091
</ul>
9192

9293
<li>Execute the following commands inside the MSYS2 environment:</li>
@@ -142,7 +143,7 @@ <h3>Step 4: Download the Source</h3>
142143
<li>In the msys64 shell, type <strong>wget</strong>, paste the URL, and then press enter. i.e.</li>
143144

144145
<ul>
145-
<li><strong>wget </strong><a href="https://github.com/boostorg/boost/releases/download/boost-1.85.0/boost-1.85.0.tar.gz">https://github.com/boostorg/boost/releases/download/boost-1.85.0/boost-1.85.0.tar.gz</a></li>
146+
<li><strong>wget </strong><a href="https://archives.boost.io/release/1.85.0/source/boost_1_85_0.tar.gz">https://archives.boost.io/release/1.85.0/source/boost_1_85_0.tar.gz</a></li>
146147
</ul>
147148
</ul>
148149
<p>This downloads the source package.</p>

docs/ver4/DG4-Build-FFTW.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -108,10 +108,10 @@ <h3>Step 3: Deploy the MSYS2 Build Environment with Qt Compilers</h3>
108108
<li>Inside the JTSDK64-Tools environment type:</li>
109109

110110
<ul>
111-
<li><strong>msys2</strong></li>
111+
<li><strong>mingw64</strong></li>
112112
</ul>
113113
</ul>
114-
<p>Now we need to tell the MSYS2 environment HOW to find the Qt-delivered compilers..</p>
114+
<p>Now we need to tell the MSYS2/MinGW64 environment HOW to find the Qt-delivered compilers..</p>
115115
<ul>
116116

117117
<li>Inside the JTSDK64-Tools environment type:</li>

docs/ver4/DG4-Build-LibUSB.html

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,8 @@ <h2>Guide for Building LibUSB</h2>
5050
<ul>
5151
<p>A number of operational issues have arisen with the use of compiled LibUSB packages downloaded from <a href="file:///C|/Users/stepheni.HOME/AppData/Local/Microsoft/Windows/INetCache/IE/XFNP0OWK/releases[1]">https://github.com/libusb/libusb/releases</a> </p>
5252
<p>It is now recommended that users of the JTSDK compile their own LibUSB from the latest source provided by the LibUSB Maintainers,.</p>
53-
<p>These steps will demonstrate how to build and deploy a library set under the <strong>mingw64</strong> environment for the JTSDK..</p>
53+
<p>These steps will demonstrate how to build and deploy a library set under the <strong>mingw64</strong> environment for the JTSDK.</p>
54+
<p><b>Note:</b> The currrent version of LibUSB at writing is <a href="https://github.com/libusb/libusb/releases/download/v1.0.28/libusb-1.0.28.tar.bz2">1.0.28</a>.</p>
5455
</ul>
5556

5657
<h3>Step 1: Download and fully deploy the latest JTSDK</h3>
@@ -111,7 +112,7 @@ <h3>Step 3: Deploy the mingw64 Build Environment</h3>
111112
<h3>Step 4: Download the Source</h3>
112113

113114
<ul>
114-
<p>Download URL of the latest stable LibUSB. At the time of writimng the latest version was Version <a href="https://github.com/libusb/libusb/releases/download/v1.0.27/libusb-1.0.27.tar.bz2">1.0.27</a></p>
115+
<p>Download URL of the latest stable LibUSB. At the time of writimng the latest version was Version <a href="https://github.com/libusb/libusb/releases/download/v1.0.28/libusb-1.0.28.tar.bz2">1.0.28</a></p>
115116
<ul>
116117
<li>Navigate to <a href="https://libusb.info/">https://libusb.info/</a></li>
117118
</ul>
@@ -123,12 +124,12 @@ <h3>Step 4: Download the Source</h3>
123124
<ul>
124125
<li><strong>cd ~/src</strong></li>
125126
</ul>
126-
<p>Extract the source package (assuming Version 1.0.27) with:
127+
<p>Extract the source package (assuming Version 1.0.28) with:
127128
</p>
128129
<ul>
129130

130131
<ul>
131-
<li><strong>tar xjf libusb-1.0.27.tar.bz2</strong></li>
132+
<li><strong>tar xjf libusb-1.0.28.tar.bz2</strong></li>
132133
</ul>
133134
</ul>
134135
</ul>
@@ -140,14 +141,14 @@ <h3>Step 5: Configure and build the LibUSB library</h3>
140141
<li>Execute the following commands at the MSYS2 command prompt:</li>
141142

142143
<ul>
143-
<li><strong>cd libusb-1.0.27</strong></li>
144+
<li><strong>cd libusb-1.0.28</strong></li>
144145

145146
<li><strong>mkdir /tmp/libusb</strong></li>
146147

147148
<li>You may be required to create the &quot;build&quot; directory. Type <strong>mkdir build</strong> </li>
148149
<li><strong>cd build</strong></li>
149150

150-
<li><strong>../configure -prefix=/tmp/libusb --enable-shared --enable-static</strong></li>
151+
<li><strong>../configure --prefix=/tmp/libusb --enable-shared --enable-static</strong></li>
151152
</ul>
152153

153154
<p>The above command places all that is built into the subdirectory <strong>/tmp/libusb</strong> . This way the built libraries are easy to find.</p>
@@ -166,19 +167,21 @@ <h3>Complete</h3>
166167

167168
<ul>
168169

169-
<p>You will find a structure inside <em>/tmp</em> (windows path <em>C:\msys64\tmp\portaudio</em>) that contains the same LibUSB library structure. .</p>
170-
<p>Rename the directory /tmp/libusb to a name that6 best fits the &quot;structuring&quot; of the JTSDK. In this case we assume that source for v 1.0.27 has been used</p>
170+
<p>You will find a structure inside <em>/tmp</em> (windows path <em>C:\JTSDK64-Tools\tools\msys64\tmp\libusb</em>) that contains the built LibUSB library structure. .</p>
171+
<p>Rename the directory /tmp/libusb to a name that best fits the &quot;structuring&quot; of the JTSDK. In this case we assume that source for v 1.0.28 has been used</p>
171172
<ul>
172173
<li>cd /tmp</li>
173-
<li>mv libusb 1.0.27</li>
174+
<li>mv libusb 1.0.28</li>
175+
</ul>
176+
<p>Deliver that folder structure to <em>X:\JTSDK64-Tools\tools\</em>libusb . From the MSYS2 prompt the command will be:</p>
177+
<ul>
178+
<li>mv ./1.0.28 /c/JTSDK64-Tools/tools/libusb</li>
174179
</ul>
175-
<p>Deliver that folder structure to <em>X:\JTSDK64-Tools\tools\</em>libusb .</p>
176-
177180
<p>Make the appropriate adjustment in <em>C:\JTSDK64-Tools\config\Versions.ini</em> so that it can be used by the JTSDK. </p>
178181
<br><strong>File:</strong> x:\JTSDK64-Tools\config\Versions.ini</br>
179182
<ul>
180183
<br>...</br>
181-
<br>libusbv=1.0.27</br>
184+
<br>libusbv=1.0.28</br>
182185
<br># Next can also be /MinGW64/dll</br>
183186
<br>libusbdll=/bin</br>
184187
<br>...</br>

0 commit comments

Comments
 (0)