github hydrasdr/hydrasdr-host v1.0.4
HydraSDR RFOne Host Tools + Shared Lib / DLL v1.0.4
on GitHub

latest releases: nightly, v1.1.0
3 months ago

What's Changed in v1.0.4

Fix CI/CD macOS pre-built archive to include *.dylib

Build System & Library Versioning

  • Set library versioning for libhydrasdr - Proper SOVERSION (1) for shared library compatibility (898a1a8)
  • Enable shared libraries in CMake configuration - Added -DENABLE_SHARED_LIB=ON support (c9b7bbb)
  • Build Release with -O3 by default on GCC/Clang/MinGW (22281f4)
  • Update macOS version in build workflow (708e404)

API Changes

  • Rename GPIO and RF port enums for consistency - API cleanup for better naming conventions (6a25421, 0ab68f5)
  • Rename receiver_mode_t to hydrasdr_receiver_mode_t - Namespace consistency (7e62e10)

New Features

  • Add hydrasdr_async_rx.c - Simple and full asynchronous RX example with device setup, streaming, buffer sizing, and statistics (3036bed)
  • Add hw/sw testing under docker by @kng (ce26110)

Bug Fixes

  • Fix memory initialization for delay_line array (54d97a7)
  • Fix Copy Files mingw64 to dynamically locate libusb-1.0.dll (ee2ff6a)
  • Fix typos in CMakeLists.txt and fix build of hydrasdr.rc with mingw (eb490d1)

Packaging

Documentation

  • Revise MSYS2/MinGW64 build instructions in README.md (a8ca50c)
  • Update CMakeLists to check WIN32 and MSVC for hydrasdr.rc (a31957c)

Contributors

Full Changelog: v1.0.3...v1.0.4

Important Note: This release fixes the library SOVERSION which is critical for SoapyHydraSDR compatibility. After installing v1.0.4, you must reinstall SoapyHydraSDR to link against the correct library version (libhydrasdr.so.1).

Available Builds:

Desktop Platforms (Generic Archives):

  • Windows x64 (.zip)
  • macOS ARM64 (Apple Silicon M1/M2/M3) (.tar.gz)
  • macOS x86_64 (Intel Macs) (.tar.gz)

GNU/Linux Distributions (Native Packages - Recommended):

.deb packages (apt/dpkg):

  • Ubuntu 24.04 LTS (Noble Numbat) - sudo dpkg -i [.zip also available for CI/CD]
  • Ubuntu 22.04 LTS (Jammy Jellyfish) - sudo dpkg -i [.zip also available for CI/CD]
  • Ubuntu 20.04 LTS (Focal Fossa) - sudo dpkg -i
  • Linux Mint 22.1 (Xia) - sudo dpkg -i
  • Linux Mint 22 (Wilma) - sudo dpkg -i
  • Linux Mint 21.3 (Virginia) - sudo dpkg -i
  • Linux Mint 21.2 (Victoria) - sudo dpkg -i
  • Linux Mint 21.1 (Vera) - sudo dpkg -i
  • Debian 13 (Trixie) - sudo dpkg -i
  • Debian 12 (Bookworm) - sudo dpkg -i
  • Debian 11 (Bullseye) - sudo dpkg -i

.rpm packages (dnf/yum/zypper):

  • Fedora 42 (Latest) - sudo dnf install
  • Fedora 41 - sudo dnf install
  • AlmaLinux 9 - sudo dnf install
  • openSUSE Tumbleweed - sudo zypper install

.pkg.tar.zst packages (pacman):

  • Arch Linux - sudo pacman -U

Installation Instructions:

Recommended: Native Packages (Automatic dependency management)

Debian/Ubuntu/Linux Mint (.deb packages):

# Download the appropriate .deb file for your distribution
# Examples:
# wget https://github.com/hydrasdr/rfone_host/releases/download/nightly/hydrasdr-host-tools-Ubuntu-22.04-LTS-Jammy-Jellyfish-v1.0.4.deb
# wget https://github.com/hydrasdr/rfone_host/releases/download/nightly/hydrasdr-host-tools-Ubuntu-24.04-LTS-Noble-Numbat-v1.0.4.deb
# wget https://github.com/hydrasdr/rfone_host/releases/download/nightly/hydrasdr-host-tools-Debian-12-Bookworm-v1.0.4.deb

# Install the package
sudo dpkg -i hydrasdr-host-tools-[DISTRIBUTION]-v[VERSION].deb
sudo apt-get install -f  # Fix any dependency issues if needed

# Add your user to plugdev group for device access
sudo usermod -a -G plugdev $USER
# Log out and back in for group changes to take effect

Fedora/AlmaLinux (.rpm packages):

# Download the appropriate .rpm file for your distribution
# Examples:
# wget https://github.com/hydrasdr/rfone_host/releases/download/nightly/hydrasdr-host-tools-Fedora-42-v1.0.4.rpm
# wget https://github.com/hydrasdr/rfone_host/releases/download/nightly/hydrasdr-host-tools-AlmaLinux-9-v1.0.4.rpm

# Install with automatic dependency resolution
sudo dnf install ./hydrasdr-host-tools-[DISTRIBUTION]-v[VERSION].rpm

# Add your user to plugdev group for device access
sudo usermod -a -G plugdev $USER

openSUSE (.rpm packages):

# Download the appropriate .rpm file
# wget https://github.com/hydrasdr/rfone_host/releases/download/nightly/hydrasdr-host-tools-openSUSE-Tumbleweed-v1.0.4.rpm

# Install with automatic dependency resolution
sudo zypper install ./hydrasdr-host-tools-openSUSE-Tumbleweed-v[VERSION].rpm

# Add your user to plugdev group for device access
sudo usermod -a -G plugdev $USER

Arch Linux (.pkg.tar.zst packages):

# Download the .pkg.tar.zst file
# wget https://github.com/hydrasdr/rfone_host/releases/download/nightly/hydrasdr-host-tools-Arch-Linux-v1.0.4.pkg.tar.zst

# Install with pacman
sudo pacman -U hydrasdr-host-tools-Arch-Linux-v[VERSION].pkg.tar.zst

# Add your user to plugdev group for device access
sudo usermod -a -G plugdev $USER

Alternative: Generic Archives (Manual installation)

Windows:

# Download and extract the .zip file
# All required DLLs are included in the package
# Add the extracted directory to your PATH environment variable

macOS:

# Download and extract the .tar.gz file
wget https://github.com/hydrasdr/rfone_host/releases/download/nightly/[package-name].tar.gz
tar -xzf [package-name].tar.gz

# Copy binaries to your PATH
sudo cp [extracted-dir]/* /usr/local/bin/

# Install dependencies via Homebrew
brew install libusb

Other Linux Distributions (if no native package available):

# Download the appropriate .tar.gz archive
wget https://github.com/hydrasdr/rfone_host/releases/download/nightly/[package-name].tar.gz

# Extract and install manually
tar -xzf [package-name].tar.gz
sudo cp [extracted-dir]/* /usr/local/bin/
sudo cp [extracted-dir]/libhydrasdr.so* /usr/local/lib/
sudo ldconfig

# Install dependencies via package manager
# Ubuntu/Debian: sudo apt-get install libusb-1.0-0
# Fedora: sudo dnf install libusb1
# Arch: sudo pacman -S libusb

For CI/CD Workflows:

Ubuntu 24.04 and 22.04 also provide .zip archives for automated workflows: 

# Download Ubuntu 24.04: .zip archive (for CI/CD)
wget https://github.com/hydrasdr/rfone_host/releases/download/nightly/hydrasdr-host-tools-Ubuntu-24.04-LTS-Noble-Numbat-v1.0.4.zip
unzip hydrasdr-host-tools-Ubuntu-24.04-LTS-Noble-Numbat-v1.0.4.zip

# Or for Ubuntu 22.04:
wget https://github.com/hydrasdr/rfone_host/releases/download/nightly/hydrasdr-host-tools-Ubuntu-22.04-LTS-Jammy-Jellyfish-v1.0.4.zip
unzip hydrasdr-host-tools-Ubuntu-22.04-LTS-Jammy-Jellyfish-v1.0.4.zip

System Requirements:

  • libusb 1.0.23 (avoid 1.0.24 due to known issues)
  • USB 2.0 or 3.0 port for HydraSDR RFOne device
  • 64-bit architecture (amd64/x86_64)

Package Features:

  • Automatic dependency management - Required libraries installed automatically
  • System integration - Proper udev rules for non-root device access
  • Easy removal - Standard package manager commands for clean uninstall
  • Automatic updates - Library cache and udev rules updated automatically
  • Digital signatures - All packages built in secure CI environment

Comprehensive Distribution Coverage:

This release provides native packages for major GNU/Linux distributions including all current LTS versions of Ubuntu, stable Debian releases, latest Fedora versions, and rolling-release distributions.

Distribution-specific naming: All packages use clear, descriptive names that identify their target distribution (e.g., hydrasdr-host-tools-Ubuntu-22.04-LTS-Jammy-Jellyfish-v1.0.4.deb, hydrasdr-host-tools-Fedora-42-v1.0.4.rpm).

Special provision: Ubuntu 24.04 and 22.04 provide both native .deb packages (recommended for users) and .zip archives (required for automated firmware build workflows).

Notes:

  • Native packages strongly recommended for easiest installation experience
  • Distribution-specific naming - All packages clearly identify their target distribution
  • Generic archives provided for Windows, macOS, and unsupported Linux distributions
  • Ubuntu ZIP archives provided for CI/CD workflows (firmware builds)
  • Native packages handle dependencies, system integration, and updates automatically
  • Nightly build - This is an automated nightly build with latest features
  • Stable releases - For stable releases, use tagged releases instead
  • Issue reporting - Report issues at https://github.com/hydrasdr/rfone_host/issues
  • Documentation - Full documentation at https://hydrasdr.com
Check out latest releases or
releases around hydrasdr/hydrasdr-host v1.0.4

Don't miss a new hydrasdr-host release

NewReleases is sending notifications on new releases.

Get notifications