Skip to content

Commit d7ef662

Browse files
committed
To v3.4.0a Release
1 parent 36c5a3a commit d7ef662

12 files changed

Lines changed: 284 additions & 426 deletions

docs/ver3/AN3.html

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<head>
44
<meta charset="utf-8">
55
<meta name="keywords" content="JTSDK, JT-ware, wsjtx, jtdx, js8call, build wsjtx, compile wsjtx, Qt, Windows, software, development">
6-
<title>Hamlib SDK v3.2.3 Application Notes</title>
6+
<title>JSDK v3.4.0 Application Notes</title>
77
<link rel="stylesheet" href="../style-new.css">
88
<link rel="shortcut icon" type="image/x-icon" href="../favicon.ico" />
99
</head>
@@ -46,13 +46,13 @@ <h2>Evolving the JT-ware Software Developer's Kit (JTSDK)</h2>
4646
</table>
4747
<hr/>
4848

49-
<h2>JTSDK 3.2.3 Application Notes</h2>
49+
<h2>JTSDK 3.4.0 Application Notes</h2>
5050

5151
<hr>
5252

5353
<h3>Direction</h3>
5454
<ul>
55-
<p>The <strong>JTSDK 3.2.3</strong> evolves the kits from Windows Batch Files towards Windows
55+
<p>The <strong>JTSDK 3.4.0</strong> evolves the kits from Windows Batch Files towards Windows
5656
<a href="https://docs.microsoft.com/en-us/powershell/">PowerShell</a>-based scripts. <a href="https://docs.microsoft.com/en-us/powershell/">PowerShell</a> is also supported in Mac and
5757
Linux environs, so common-adaptation for these purposes may occur as the kits evolve. </p>
5858
<p>This started as an experiment to reduce maintenance (i.e. new package versions).
@@ -65,15 +65,15 @@ <h3>The Version 3.2 Base Stream</h3>
6565
<ul>
6666
<p>The <strong>Version 3.2</strong> stream is a learning, discovery and technique refinement experiment. </p>
6767
</ul>
68-
<h3>Version 3.2.3</h3>
68+
<h3>Version 3.4.0</h3>
6969
<ul>
70-
<p>The <strong>JTSDK 3.2.3</strong> outwardly will appear similar to the <strong>JTSDK 3.2.0</strong>-stream. Yet the
71-
<strong>JTSDK 3.2.3</strong> has significant enhancements in that many of the key commands now accept
70+
<p>The <strong>JTSDK 3.4.0</strong> outwardly will appear similar to the <strong>JTSDK 3.2.0</strong>-stream. Yet the
71+
<strong>JTSDK 3.4.0</strong> has significant enhancements in that many of the key commands now accept
7272
switches that can make the process of developing code quicker and simpler.</p>
7373
<p>In addition the &quot;mirroring&quot; of <strong>build-hamlib.sh</strong> and <strong>build-hamlib.sh-static</strong> has been
7474
broken - with <strong>build-hamlib.sh</strong> offering a number of additional command-line switches to
7575
aid developers.</p>
76-
<p>The <strong>JTSDK 3.2.3</strong> provides a version of <a href="https://libusb.info/">LibUSB 1.0.26</a> that we have supplied. LibUSB 1.0.26 as supplied by the LibUSB maintainers is still supplied.</p>
76+
<p>The <strong>JTSDK 3.4.0</strong> provides a version of <a href="https://libusb.info/">LibUSB 1.0.26</a> that we have supplied. LibUSB 1.0.26 as supplied by the LibUSB maintainers is still supplied.</p>
7777
</ul>
7878

7979
<table width="*" align="center" border="1">
@@ -92,12 +92,12 @@ <h3>Project Status</h3>
9292
build libraries (i.e. <a href="https://www.boost.org/https://www.boost.org/">Boost</a>) as part of the learning process.</p>
9393
<p>Current packaging preempts known cases of proposed licence and delivery condition changes. </p>
9494

95-
<p>Precompiled drop-in packages for <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/Boost-1.74.0-MinGW-v7.3-v8.1.7z">Boost-1.74.0</a>, <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/Boost-1.81.0-MinGW-v8.1-v11.2.7z">Boost-1.81.0</a> and <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/Boost-1.82.0-MinGW-v8.1-v11.2.7z">Boost-1.82.0</a> built under Qt&#39;s <a href="http://www.mingw.org/">MinGW</a> 8.1 and <a href="http://www.mingw.org/">MinGW</a> 11.2 environs are available (saving 3+ hours).</p>
95+
<p>Precompiled drop-in packages for <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/Boost-1.74.0-MinGW-v7.3-v8.1.7z">Boost-1.74.0</a>, <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/Boost-1.81.0-MinGW-v8.1-v11.2.7z">Boost-1.81.0</a>, <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/Boost-1.82.0-MinGW-v8.1-v11.2.7z">Boost-1.82.0</a> , <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/Boost-1.83.0-MinGW-v8.1-v11.2.7z">Boost-1.83.0</a> and <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/Boost-1.84.0-MinGW-v8.1-v11.2.7z">Boost-1.84.0</a> built under Qt&#39;s <a href="http://www.mingw.org/">MinGW</a> 8.1 and <a href="http://www.mingw.org/">MinGW</a> 11.2 environs are available (saving 3+ hours).</p>
9696
</ul>
9797

9898
<table width="*" align="center" border="1">
9999
<tr>
100-
<td class="custd"><p>The recommended mainstream development environments are <a href="https://www.qt.io/download-open-source">Qt</a> <strong>5.15.2</strong> and <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/Boost-1.82.0-MinGW-v8.1-v11.2.7z">Boost-1.82.0</a> working with <a href="http://www.mingw.org/">MinGW</a> <strong>8.1</strong>.</p></td>
100+
<td class="custd"><p>The recommended mainstream development environments are <a href="https://www.qt.io/download-open-source">Qt</a> <strong>5.15.2</strong> and <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/Boost-1.84.0-MinGW-v8.1-v11.2.7z">Boost-1.84.0</a> working with <a href="http://www.mingw.org/">MinGW</a> <strong>8.1</strong>.</p></td>
101101
</tr>
102102
</table>
103103

docs/ver3/DG3-Build-Boost.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ <h2>Building from mingw64 Environment </h2>
7474
<h3>Step 1: Download and fully deploy the latest JTSDK i.e. v3.2.3</h3>
7575
<ul>
7676
<li>The JTSDK Version 3.2.3 and any Tools packages can be found at: <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/">https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/ </a></li>
77-
<li>Refer to the <a href="DG3.html">Deployment Guide for deploying JTSDK 3.2.3</a>.</li>
77+
<li>Refer to the <a href="DG3.html">Deployment Guide for deploying JTSDK 3.4.0</a>.</li>
7878
</ul>
7979

8080
<h3>Step 2: Deploy the Build Tools</h3>

docs/ver3/DG3-Build-x64-JT-ware.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ <h3>Introduction</h3>
5151
<ul>
5252
<p>The scripts and packages provided assist with the construction of <a href="https://www.qt.io/download-open-source#section-2>Qt</a>-based environment are provided that enable <a href=" https: physics.princeton.edu pulsar k1jt wsjtx.html>WSJT-X</a> and derivatives <a href="https://jtdx.tech/en/">JTDX</a> and <a href="http://js8call.com/">JS8CALL</a> - collectively referred to as <strong>JT-ware</strong>.</p>
5353
<p>These notes will assist with with techniques to build JT-ware</p>
54-
<p>Note that the <strong>JTSDK 3.2.3</strong> is by default a x64/64-Bit Environment.&nbsp; &nbsp;&nbsp;</p>
54+
<p>Note that the <strong>JTSDK 3.4.0</strong> is by default a x64/64-Bit Environment.&nbsp; &nbsp;&nbsp;</p>
5555
</ul>
5656
<h3>The PowerShell jtbuild commandlet</h3>
5757
<ul>

docs/ver3/DG3-Build-x86-JT-ware.html

Lines changed: 3 additions & 162 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
</td>
2020
<td>
2121
<h1>HAMLIB SDK Version 3 </h1>
22-
<h2>Evolving the JT-ware Software Developer's Kit (JTSDK)</h2>
22+
<h2>Evolving the JT-ware Software Developer's Kit (JTSDK)</h2>
2323
</td>
2424
</tr>
2525
</table>
@@ -41,174 +41,15 @@ <h2>Evolving the JT-ware Software Developer's Kit (JTSDK)</h2>
4141
<td width="12.5%" align="center"><a href="AN3.html">Notes</a></td>
4242
<td width="12.5%" align="center"><a href="QU3.html">Questions</a></td>
4343
<td width="12.5%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/">Sourceforge</a></td>
44-
<td width="12.5%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-Stream/">Download</a</td>
44+
<td width="12.5%" align="center"><a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.4-Stream/">Download</a</td>
4545
</tr>
4646
</table>
4747
<hr/>
4848
<h2>Guide for Building x86 JT-Ware</h2>
49-
<hr>
50-
<h3>Introduction</h3>
51-
<ul>
52-
<p>The scripts and packages provided assist with the construction of <a href="https://www.qt.io/download-open-source#section-2>Qt</a>-based environment are provided that enable <a href=" https: physics.princeton.edu pulsar k1jt wsjtx.html>WSJT-X</a> and derivatives <a href="https://jtdx.tech/en/">JTDX</a> and <a href="http://js8call.com/">JS8CALL</a> - collectively referred to as <strong>JT-ware</strong>.</p>
53-
<p>These notes will assist with with techniques to build JT-ware.</p>
54-
<p>Note that the <strong>JTSDK 3.2.3</strong> is by default a x64/64-Bit Environment. Patches are maintained by <a href="https://www.qrz.com/db/dg2ycb">Uwe Risse DG2YCB</a> that will enable the kit to be <strong>modified to build x86/32-bit software</strong>.</p>
55-
</ul>
56-
<hr/>
57-
<h2>Patching the JTSDK 3.2.3 x64 environment to build x86</h3>
58-
<hr/>
59-
<ul>
60-
<p>A complete section of the <a href="https://sourceforge.net/projects/hamlib-sdk/">Hamlib SDK SourceForge Repository</a> is dedicated to maintaining patches and instructions for techniques that can be applied for enabling x86 builds.</p>
61-
<p>These instructions can be found within the following folder: <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-x86-Patches/">https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-x86-Patches/</a>.</p>
62-
</ul>
63-
<h3>Step 1</h3>
64-
6549
<ul>
66-
<p>This tutorial is about how to add 32-bit build support to JTSDK64-Tools. It works for version 3.2.3.</p>
6750

68-
<p><strong>Ensure that you have a functional version 3.2.3 of JTSDK64-Tools in place.</strong></p>
69-
70-
<p>For all further steps I assume that you installed it to <strong>C:\JTSDK64-Tools</strong> and that you are familiar with how to use the JTSDK64. If you use another directory, adjust the paths accordingly.</p>
71-
</ul>
72-
<h3>Step 2</h3>
73-
<ul>
74-
<p><a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-x86-Patches/Files%20for%2032-bit%20support%20%28for%203.2.0.x%29.zip">Download the zip file from Sourceforge</a> and move the contained files to the following locations (replace the old files):</p>
75-
<ul>
76-
<li> <strong> Versions32.ini </strong>=&gt; <strong>C:\JTSDK64-Tools\config </strong></li>
77-
<li><strong>ver.jtsdk</strong> =&gt; <strong>C:\JTSDK64-Tools </strong> </li>
78-
<li><strong>jtsdk64.ps1</strong> =&gt; <strong>C:\JTSDK64-Tools </strong> </li>
79-
<li><strong>jtsdk32.ps1</strong> =&gt; <strong>C:\JTSDK64-Tools </strong> </li>
80-
<li><strong>jtsdk64-setup.ps1</strong> =&gt; <strong>C:\JTSDK64-Tools </strong> </li>
81-
<li><strong>jtbuild.ps1</strong> =&gt; <strong>C:\JTSDK64-Tools\tools\scripts </strong> </li>
82-
<li><strong>jtbuild32.ps1</strong> =&gt; <strong>C:\JTSDK64-Tools\tools\scripts </strong> </li>
83-
<li><strong>deploy-Boost.ps1</strong> =&gt; <strong>C:\JTSDK64-Tools\tools\scripts </strong> </li>
84-
<li><strong>build-hamlib.sh</strong> =&gt; <strong>C:\JTSDK64-Tools\tools\msys64\home\&lt;user&gt;\bin</strong></li>
85-
<li><strong>build-hamlib32.sh</strong> =&gt; <strong>C:\JTSDK64-Tools\tools\msys64\home\&lt;user&gt;\bin </strong> </li>
86-
<li><strong>jtsdk_setup.sh</strong> =&gt; <strong>C:\JTSDK64-Tools\tools\msys64\home\&lt;user&gt;\bin</strong></li>
87-
</ul>
88-
<p>Copy the latter 3 files also to <strong>C:\JTSDK-Tools\tools\msys64\etc\skel\bin.</strong></p>
89-
</ul>
90-
<h3>Step 3</h3>
91-
<ul>
92-
<p>Start the Qt Maintenance Tool.&nbsp;</p>
93-
<p>Download and install at least one 32-bit version of Qt (e.g. 5.15.2) as well as CMake_32.</p>
94-
<p>The correct location for Qt is <strong>C:\JTSDK64-Tools\tools\Qt</strong>, and the Qt Maintenance Tool automatically generates a sub-directory <strong>C:\JTSDK64-Tools\tools\Qt\Tools\CMake_32</strong>. </p>
95-
</ul>
96-
<h3>Step 4</h3>
97-
<ul>
98-
<p>To be ready for building x86 compilations, we need only a few additional packages:</p>
99-
<ul>
100-
<li><strong>fftw 3.3.5 (32-bit)</strong> in<strong> C:\JTSDK64-Tools\tools\fftw\3.3.5_32</strong></li>
101-
<li><strong>ruby 3.0.2-1 (32-bit)</strong> in <strong>C:\JTSDK64-Tools\tools\ruby\3.0.2-1_32 </strong></li>
102-
<li><strong>boost 1.77.0 (mingw 8.1)</strong> in <strong>C:\JTSDK64-Tools\tools\boost\1.77.0_32</strong></li>
103-
<li><strong>portaudio32 19.7.0 (32-bit)</strong> in<strong> C:\JTSDK64-Tools\tools\portaudio32</strong></li>
104-
</ul>
105-
<p>You can get the 32-bit packages from here:</p>
106-
<ul>
107-
<li><strong>fftw</strong> =&gt; <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-x86-Patches/fftw_3.3.5_32.zip">https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-x86-Patches/fftw_3.3.5_32.zip</a> </li>
108-
<li><strong>ruby</strong> =&gt; <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-x86-Patches/ruby_3.0.2-1_32.zip">https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-x86-Patches/ruby_3.0.2-1_32.zip</a> </li>
109-
<li><strong>boost</strong> =&gt; <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-x86-Patches/boost_1.77.0_32.zip">https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-x86-Patches/boost_1.77.0_32.zip</a> </li>
110-
<li><strong>portaudio32</strong> =&gt; <a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-x86-Patches/portaudio32.zip">https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-x86-Patches/portaudio32.zip</a></li>
111-
</ul>
112-
</ul>
113-
<h3>Step 5</h3>
114-
<ul>
115-
<p>Adjust the entries in Versions32.ini to those version numbers you have installed.</p>
116-
</ul>
117-
<h3>Step 6</h3>
118-
<ul>
119-
<p>Have in mind that the 64-bit part of <strong>JTSDK64-Tools</strong> gets its information from <strong>Versions.ini</strong>, and the newly added 32-bit part from the file <strong>Versions32.ini</strong>, so that you can have different settings for making x86 and x64 compilations. Also the internal sub-locations are different for 64-bit and 32-bit.&nbsp;</p>
120-
<p>The new 32-bit part doesn’t interfere with the existing 64-bit part of JTSDK64.</p>
121-
</ul>
122-
<h3>Step7</h3>
123-
<ul>
124-
<p>Now it’s time to start the work with your new 64+32-bit supporting JTSDK64-Tools…</p>
125-
</ul>
126-
<h3>Step 8</h3>
127-
<ul>
128-
<p>Start<strong> jtsdk64-setup.ps1</strong> and wait until setup is completed.</p>
129-
</ul>
130-
<h3>Step 9</h3>
131-
<ul>
132-
<p>For 64-bit compilations start<strong> jtsdk64.ps1</strong> as you are familiar with. Everything should work as before. Only the layout of the UI has been slightly optimized, so that it looks the same as for the 32-bit part. </p>
51+
<p><strong>Note</strong>: This is not supported directly. Use the <strong><a href="https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.2-x86-Patches/\">Version 3.2 Stream</a> kits and notes there. </strong></p>
13352
</ul>
134-
<h3>Step 10</h3>
135-
<ul>
136-
<p>For 32-bit compilations start<strong> jtsdk32.ps1</strong>.</p>
137-
<p><strong>Note:</strong> To be able to distinguish the 32-bit part from the 64-bit part, the term “JTSDK32” instead of “JTSDK64” is used in the new 32-bit part of your JTSDK64.</p>
138-
</ul>
139-
<h3>Step 11</h3>
140-
<ul>
141-
<p>Start <strong>msys2</strong>.</p>
142-
<p>The msys2 layout now offers you shortcuts for the various options. You simply have to type the right shortcut number and press ENTER to build hamlib.</p>
143-
<p>Use shortcut “5” to build a fresh 32-bit version of hamlib into <strong>C:\JTSDK64-Tools\tools\hamlib32</strong> directory.</p>
144-
145-
</ul>
146-
<h3>Step 12</h3>
147-
<ul>
148-
<p>Once hamlib32 has been built, close the <strong>msys2</strong> terminal window.</p>
149-
</ul>
150-
<h3>Step 13</h3>
151-
<ul>
152-
<p>Now it’s time to put a suitable wsjtx folder into the well-known location (<strong>C:\JTSDK64-Tools\tmp</strong>\) .</p>
153-
</ul>
154-
<h3>Step 14</h3>
155-
<ul>
156-
<p>Open again <strong>jtsdk32.ps1</strong> and start the x86 compilation of wsjtx with the command <strong>jtbuild32 package</strong>.</p>
157-
</ul>
158-
<h3>Step 15</h3>
159-
<ul>
160-
<p>The output directory is <strong>C:\JTSDK64-Tools\tmp\wsjtx-output32</strong>, so that is does not interfere with the 64- bit compilations.</p>
161-
<p>In case you get an error message “asciidoctor is required to build the documentation”:
162-
<ul>
163-
<li>Open a terminal window</li>
164-
<li>Go to <strong>C:\JTSDK64-Tools\tools\ruby\3.0.3_32</strong></li>
165-
<li>Type: <strong>gem install asciidoctor</strong></li>
166-
<p>This installs the <strong>Asciidoctor</strong> package.</p>
167-
</ul>
168-
<p>Now compilation of 32-bit builds should work.</p>
169-
</ul>
170-
<h3>Step 16</h3>
171-
<ul>
172-
<p>In case a 64-bit compilation starts instead of building for x86, check whether there is any symbolic link on your computer which leads to the 64-bit version of MinGW. (Such links are usually on <strong>C:\</strong>).</p>
173-
<p>Delete all such links.</p>
174-
<p>Now, both<strong> jtsdk32.ps1</strong> and<strong> jtsdk64.ps1</strong> should find the right build environment automatically.</p>
175-
</ul>
176-
<h3>Complete !</h3>
177-
<ul>
178-
<p>Enjoy your new 32-bit build support!</p>
179-
</ul>
180-
181-
<hr/>
182-
<h2>Notes for building x86 WSJT-X</h3>
183-
<hr/>
184-
<ul>
185-
<p>There are no special notes for building <strong>WSJTX</strong> at this time.</p>
186-
<p>Source for <strong>WSJT-X</strong> &nbsp;and <strong>JTDX</strong> is development prioritised for any build process.</p>
187-
</ul>
188-
189-
<hr/>
190-
<h2>Notes for building x86 JTDX</h2>
191-
<hr/>
192-
<ul>
193-
<p>There are no special notes for building <strong>JTDX</strong> at this time.</p>
194-
<p>Source for <strong>WSJT-X</strong> &nbsp;and <strong>JTDX</strong> is development prioritised for any build process.</p>
195-
</ul>
196-
<hr/>
197-
<h2>Notes for building x86 JS8CALL</h2>
198-
<hr/>
199-
<ul>
200-
<p>There are no special notes for building <strong>JTDX</strong> at this time.</p>
201-
<p>Source for <strong>WSJT-X</strong> &nbsp;and <strong>JTDX</strong> is development prioritised for any build process.</p>
202-
</ul>
203-
<hr/>
204-
<h2>Notes for working with your own modified source</h2>
205-
<hr/>
206-
207-
<ul>
208-
<p>Modify the source for your own requirements at your own peril.</p>
209-
<p>Ensure that you comply with the source release requirements and terms for <strong>WSJT-X</strong> - again at your own peril.</p>
210-
<p>If uncertain as to what these requirements are then please ask in the <strong>WSJT-X Forum</strong></p>
211-
</ul>
21253
<hr>
21354
<table width="100%" border="0">
21455
<tbody>

0 commit comments

Comments
 (0)