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

Guide for Building LibUSB

A number of operational issues have arisen with the use of compiled LibUSB packages downloaded from https://github.com/libusb/libusb/releases

It is now recommended that users of the JTSDK compile their own LibUSB from the latest source provided by the LibUSB Maintainers,.

These steps will demonstrate how to build and deploy a library set under the mingw64 environment for the JTSDK..

Step 1: Download and fully deploy the latest JTSDK i.e. v3.4.1

• Version 3.4.1 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 LibUSB 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

Download URL of the latest stable LibUSB. At the time of writimng the latest version was Version 1.0.27

• Navigate to https://libusb.info/
• Download the latest source by selecting Donwloads / Latest Source (tarball)
• Save this file to the MSYS2 src directory ( i.e. x:\JTSDK64-Tools\tools\msys64\home\<user name>\src )

Change to the directory that you have just downloaded this source package to from within a msys64 shell::

• cd ~/src

Extract the source package (assuming Version 1.0.27) with:

• tar xjf libusb-1.0.27.tar.bz2

Step 5: Configure and build the LibUSB library

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

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

The above command places all that is built into the subdirectory /tmp/libusb . 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 LibUSB library structure. .

Rename the directory /tmp/libusb to a name that6 best fits the "structuring" of the JTSDK. In this case we assume that source for v 1.0.27 has been used

• cd /tmp
• mv libusb 1.0.27

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

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


File: x:\JTSDK64-Tools\config\Versions.ini


...

libusbv=1.0.27

# Next can also be /MinGW64/dll

libusbdll=/bin

...


Close all JTSDK64-Rools and MSYS2/mingw64 windows.

When you re-open all the windows hopefully you will be able to use your compiled LibUSB packages with the JTSDK.