HAMLIB SDK Version 3 Evolving the JT-ware Software Developer's Kit (JTSDK)

Guide for Building PortAudio

As of version 3.2.1 JTSDK as provided at this point can build the PortAudio required to build WSJT-X.

These steps will demonstrate how to deploy a Windows MME-Interface-based driver. If you want ALSA support – which requires a licensed SDK - refer to notes in the WSJT-X source at (source)/doc.

Step 1: Download and fully deploy the latest JTSDK

• Version 3.4.1 and subsequent update packages can be found at:
• https://sourceforge.net/projects/hamlib-sdk/files/Windows/JTSDK-3.4-Stream/

Step 2: Deploy build tools

The first stage involves deploying tools as if one were building Hamlib. Many required MSYS2 tools are deployed as part of this process.

• Execute the following command inside the JTSDK-Tools environment:
• msys2
• Execute the following commands inside the MSYS2 environment:
• menu
• Select Option 2 to update the MSYS2 environment. If the environment requests that you close the window after completion then do so. Restart this section again.
• Select Option 3. Install Hamlib dependencies.
• Select Option 4. Install msys64 GNU Compilers.

This should have now downloaded the build environment for mingw64 – providing a POSIX-compliant environment in which PortAudio code should be built.

• Close all MSYS2 and JTSDK-Tools environment Windows

Step 3: Deploy the mingw64 Build Environment

Launch an environment that provides the native GNU compilers.

• Launch the JTSDK64-Tools environment
• Inside the JTSDK64-Tools environment type:
• mingw64

Step 4: Download the Source

Determine the download URL of the latest stable PortAudio release by browsing to http://files.portaudio.com/download.html .

• Right-click on the URL of the download file that you want and select “Copy Link”
• i.e.: the URL is http://files.portaudio.com/archives/pa_stable_v190700_20240406.tgz
• Type the following command:
• cd ~/src
• In the msys64 shell, type wget, paste the URL, and then press enter. i.e.
• wget http://files.portaudio.com/archives/pa_stable_v190700_20240406.tgz

This downloads the source package

• Extract the source package with:
• tar xvfz  pa_stable_v190700_20240406.tgz

Step 5: Configure and build the PortAudio libraries

The following set of steps actually configures and builds the library.

• Execute the following commands at the MSYS2 command prompt:
• cd portaudio
• mkdir /tmp/portaudio
• You may be required to create the "build" directory. Type mkdir build
• cd build
• ../configure -–prefix=/tmp/portaudio

The above command places all that is built into the subdirectory /tmp/portaudio . This way the built libraries are easy to find.

• Start the actual build and deployment with the following commands:
• make
• make install

Complete

You will find a structure inside /tmp (windows path C:\msys64\tmp\portaudio) that contains the same PortAudio library structure as delivered into the JTSDK i.e. X:\JTSDK64-Tools\tools\portaudio .

Deliver that folder structure to X:\JTSDK64-Tools\tools\ .

Make the appropriate adjustment in C:\JTSDK64-Tools\config\Versions.ini so that it can be used by the JTSDK.

Note: These procedures DO NOT build PortAudio with ASIO Drivers. [ Note that these drivers have NOTHING TO DO WITH THE AUSTRALIAN AGENCY OF THE SAME NAME - yes we do get queries about this ... hmmm ]. These drivers may have specific licensing requirements that preclude us distributing these as part of the JTSDK. You can find instructions inside the JTSDK source (in the WSJTX (src)/doc folder) on how to build PortAudio with these drivers; these instructions can easily be adapted for use with the JTSDK.

References

You may find the following reference(s) useful:

• https://files.portaudio.com/docs/v19-doxydocs-dev/compile_windows_mingw-w64.html