hamlib/rigs/kit
Nate Bargmann d04364e685
Use pkgconf/pkg-config to test for libusb-1.0
As reported in GitHub issue #1892, configure on FreeBSD failed to search
for the name of the library correctly which is libusb.  As pkg-config
correctly holds the library name for linking, modify the search for
libusb-1.0 to use the pkg-config capability.  If pkg-config (now largely
replaced by pkgconf) is not installed or found, the modules depending on
it will be gracefull disabled, i.e. the configure script will complete
with those modules disabled.

Modify the output summary to use spaces instead of tabs as things were
not lining up nicely in my FreeBSD terminal.

Rename the Automake substituted variable 'HAVE_LIBUSB' to
'TESTS_HAVE_LIBUSB' to avoid confusion with identically named variable
written to include/hamlib/config.h.

Likewise, rename the AutoConf substituted name 'LIBUSB' to
'HAMLIB_PC_LIBUSB' to avoid confusion with the 'LIBUSB' string passed to
PKG_CHECK_MODULES.

Update hamlib.pc.in and tests/Makefile.am to use the new variable names.

Make sure all source files no longer reference HAVE_LIBUSB_H or
HAVE_LIBUSB_1_0_LIBUSB_H as these variables no longer exist.

Fix src/Makefile.am to provide include path for usb_port.c.
2025-09-17 21:31:37 -05:00
..
Android.mk Change all to remove HAVE_CONFIG dependency and include <hamlib/config.h> by default 2022-02-04 07:41:36 -06:00
dds60.c astyle files in preparation for release 4.6 2024-11-06 08:07:34 -06:00
drt1.c Fix typos 2025-05-22 21:55:10 +02:00
dwt.c Use pkgconf/pkg-config to test for libusb-1.0 2025-09-17 21:31:37 -05:00
elektor304.c astyle files in preparation for release 4.6 2024-11-06 08:07:34 -06:00
elektor507.c Use pkgconf/pkg-config to test for libusb-1.0 2025-09-17 21:31:37 -05:00
fifisdr.c Use pkgconf/pkg-config to test for libusb-1.0 2025-09-17 21:31:37 -05:00
funcube.c Use pkgconf/pkg-config to test for libusb-1.0 2025-09-17 21:31:37 -05:00
funcube.h Directory migration to new layout 2020-01-17 09:22:44 -06:00
hiqsdr.c astyle files in preparation for release 4.6 2024-11-06 08:07:34 -06:00
kit.c Use pkgconf/pkg-config to test for libusb-1.0 2025-09-17 21:31:37 -05:00
kit.h Fix ptt_share segmentation fault 2023-11-23 15:00:05 -06:00
Makefile.am Directory migration to new layout 2020-01-17 09:22:44 -06:00
miniVNA.c Replace #include serial.h with iofunc.h 2025-07-22 23:33:56 +02:00
pcrotor.c Fix typos 2025-05-22 21:55:10 +02:00
README.funcubedongle Directory migration to new layout 2020-01-17 09:22:44 -06:00
rs_hfiq.c Convert rigs/icom/, rigs/kit/ 2024-02-05 11:28:31 -05:00
si570avrusb.c Use pkgconf/pkg-config to test for libusb-1.0 2025-09-17 21:31:37 -05:00
si570avrusb.h Directory migration to new layout 2020-01-17 09:22:44 -06:00
usrp.c Fix ambiguity between system includes and Hamlib includes 2025-07-22 23:33:57 +02:00
usrp_impl.cc Fix include config.h 2025-08-30 11:18:51 +02:00
usrp_impl.h Fix ambiguity between system includes and Hamlib includes 2025-07-22 23:33:57 +02:00

+----------------------------------------+
|   Hamlib FUNcube dongle Win32 readme   |
|   Written by Wouter Weggelaar PA3WEG   |
|ISIS - Innovative Solutions In Space BV |
+----------------------------------------+

Note:  The following only applies for users running Win32 systems.

First of all, congratulations on obtaining a FUNcube dongle, the SDR
receiver ground segment for the FUNcube satellite! More info on this
exciting AMSAT-UK project can be found on http://funcube.org.uk/ more about
the dongle on http://www.funcubedongle.com/

The FUNcube dongle driver uses the USB kit backend in hamlib to interface to
the dongle via the USB HID interface. For this to work in hamlib, we need
LibUSB support (tested with 1.2.3.0 and 1.2.4.0) and LibUSB support compiled
into hamlib. This should be the case for all official hamlib releases
(hamlib-win32-1.2.13-2 tested).

You will need to download and install libusb-win32 from
http://sourceforge.net/projects/libusb-win32/ extract the zip archive to a
convenient location, change into this directory and run inf-wizard.exe
located in the bin directory.

Select the proper device in this wizard (Vendor ID 0x04D8, Product ID
0xFB56, interface 2) Click NEXT and accept the defaults, or change the
vendor name and product ID as you wish to see it appear in device manager.
I've changed this ID to reflect the vendor (hanlincrest ltd) and product
name (funcube dongle).

You can now suggest a location to store the driver (I suggest creating a
directory for this as the wizard creates more than one file).  Finally,
install the driver as suggested by the wizard.

You should be all set up now. Running hamlib from the command line using
rigctl -m 2513 -vvvv should provide something like below:

------------------------------------------
>rigctl.exe -m 2513 -v
Opened rig model 2513, 'FUNcube Dongle'

Rig command:
------------------------------------------
If you made it to here, you are all set up and ready to go.

**** PLEASE NOTE: by installing the LibUSB INF driver, other tools accessing
the dongle cannot find it anymore as they are looking for the windows HID
driver. Just uninstall the hamlib driver if you want to use those tools
again! HAMLIB or LibUSB DID NOT BREAK YOUR SYSTEM! ****

You could use hardware profiles to easily switch drivers.

Happy SDR-ing!

Wouter PA3WEG