hydrasdr/hydrasdr-host v1.1.0

HydraSDR Host Tools + Shared Lib / DLL v1.1.0

on GitHub

What's Changed in v1.1.0

Version 1.1.0 represents a major architectural refactor introducing following features:

• Hardware Abstraction Layer (HAL): Unified API supporting multiple HydraSDR hardware variants
• Capability Discovery: Runtime feature detection via hydrasdr_get_device_info()
• Unified Gain API: Single hydrasdr_set_gain() function for all gain types
• DDC Decimation (2x-64x): Virtual sample rates with cascaded halfband filters
• Decimation Mode Selection: Low Bandwidth vs High Definition modes
• Lock-Free Streaming: Decoupled USB/callback architecture with SPSC queue and triple buffering
• Optimized DDC Pipeline: Multiple filter configurations (33/47/65/83 taps) with ~2x performance improvement

For full details see #10

Full Changelog: v1.0.4...v1.1.0

Important Note: This release fixes the library SOVERSION (for old version of HydraSDR Host Tools + Shared Lib / DLL <v1.0.4) which is critical for SoapyHydraSDR compatibility.
After installing v1.1.0, you must reinstall SoapyHydraSDR to link against the correct library version (libhydrasdr.so.1).

Available Builds:

Documentation:

• API Documentation (HTML + PDF) - Complete Doxygen-generated documentation for libhydrasdr
  • Available in both .tar.gz (Linux/macOS) and .zip (Windows) formats
  • Includes HTML documentation with interactive call graphs and source browsing
  • Includes PDF reference manuals

Desktop Platforms (Generic Archives):

• Windows x64 (.zip)
• macOS ARM64 (Apple Silicon M1/M2/M3) (.tar.gz)
• macOS x86_64 (Intel Macs) (.tar.gz)
• Linux x86_64 (Ubuntu 24.04 LTS) - with DDC benchmark
• Linux ARM64 (Ubuntu 22.04/24.04 LTS) - Native ARM64 runners with DDC benchmark

GNU/Linux Distributions (Native Packages - Recommended):

.deb packages - x86_64/amd64 (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

.deb packages - ARM64/aarch64 (apt/dpkg):

• Ubuntu 22.04 LTS ARM64 - sudo dpkg -i
• Ubuntu 24.04 LTS ARM64 - 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:

Documentation:

# Download and extract documentation (choose .tar.gz or .zip)
wget https://github.com/hydrasdr/hydrasdr-host/releases/download/v1.1.0/hydrasdr-host-tools-documentation-v1.1.0.tar.gz
tar -xzf hydrasdr-host-tools-documentation-v1.1.0.tar.gz

# Open HTML documentation in browser
# open libhydrasdr-html/index.html

# View PDF documentation with your preferred PDF reader
# libhydrasdr-documentation-v1.1.0.pdf

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/hydrasdr-host/releases/download/v1.1.0/hydrasdr-host-tools-Ubuntu-22.04-LTS-Jammy-Jellyfish-v1.1.0.deb
# wget https://github.com/hydrasdr/hydrasdr-host/releases/download/v1.1.0/hydrasdr-host-tools-Ubuntu-24.04-LTS-Noble-Numbat-v1.1.0.deb
# wget https://github.com/hydrasdr/hydrasdr-host/releases/download/v1.1.0/hydrasdr-host-tools-Debian-12-Bookworm-v1.1.0.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/hydrasdr-host/releases/download/v1.1.0/hydrasdr-host-tools-Fedora-42-v1.1.0.rpm
# wget https://github.com/hydrasdr/hydrasdr-host/releases/download/v1.1.0/hydrasdr-host-tools-AlmaLinux-9-v1.1.0.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/hydrasdr-host/releases/download/v1.1.0/hydrasdr-host-tools-openSUSE-Tumbleweed-v1.1.0.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/hydrasdr-host/releases/download/v1.1.0/hydrasdr-host-tools-Arch-Linux-v1.1.0.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

ARM64 Linux (.deb packages):

# For ARM64 systems (including Raspberry Pi 3/4/5 with 64-bit Ubuntu)

# Download the ARM64 .deb package (Ubuntu 24.04 or 22.04)
wget https://github.com/hydrasdr/hydrasdr-host/releases/download/v1.1.0/hydrasdr-host-tools-Ubuntu-24.04-LTS-ARM64-v1.1.0.deb
sudo dpkg -i hydrasdr-host-tools-Ubuntu-24.04-LTS-ARM64-v1.1.0.deb

# Fix any dependency issues if needed
sudo apt-get install -f

# 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:

# Install libusb dependency if not already present
brew install libusb

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

# Install tools to /usr/local/bin/
sudo cp [extracted-dir]/hydrasdr_* /usr/local/bin/
sudo chmod +x /usr/local/bin/hydrasdr_*

# Install libraries to /usr/local/lib/
sudo cp [extracted-dir]/libhydrasdr*.dylib /usr/local/lib/

Other Linux Distributions (if no native package available):

# Download the appropriate .tar.gz archive
wget https://github.com/hydrasdr/hydrasdr-host/releases/download/v1.1.0/[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/hydrasdr-host/releases/download/v1.1.0/hydrasdr-host-tools-Ubuntu-24.04-LTS-Noble-Numbat-v1.1.0.zip
unzip hydrasdr-host-tools-Ubuntu-24.04-LTS-Noble-Numbat-v1.1.0.zip

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

System Requirements:

• libusb 1.0.23 (avoid 1.0.24 due to known issues)
• USB 2.0 or 3.0 port for HydraSDR software-defined radio device
• 64-bit architecture (x86_64/amd64 or ARM64/aarch64)
• Supported ARM64 platforms: Raspberry Pi 3/4/5 (with 64-bit Ubuntu), Ampere, AWS Graviton

DDC Benchmark Results:

Benchmark results are collected during CI builds for performance tracking:

• Windows x64 - Available in benchmark-Windows-x64 artifact
• Linux x86_64 - Available in benchmark-Ubuntu-24.04-LTS-Noble-Numbat artifact
• Linux ARM64 - Available in benchmark-Ubuntu-*-LTS-ARM64 artifacts
• macOS ARM64 (Apple Silicon) - Available in benchmark-macOS-ARM64 artifact
• macOS x86_64 (Intel) - Available in benchmark-macOS-x86_64 artifact

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
• libhydrasdr API documentation - Doxygen-generated HTML and PDF documentation with call graphs and source browsing

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.1.0.deb, hydrasdr-host-tools-Fedora-42-v1.1.0.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
• API Documentation included with complete Doxygen-generated reference for developers
• Nightly build - This is an automated v1.1.0 build with latest features
• Stable releases - For stable releases, use tagged releases instead
• Issue reporting - Report issues at https://github.com/hydrasdr/hydrasdr-host/issues
• Documentation - Full documentation at https://hydrasdr.com