gr-hyacinth

GNU Radio out-of-tree audio input blocks maintained by the Hyacinth Amateur Satellite Team.

The repository is named gr-hyacinth. To preserve compatibility with existing flowgraphs and applications, the installed GNU Radio module, namespace, headers, CMake package, and library continue to use the name hyacinthsat (for example, gnuradio-hyacinthsat.dll).

Blocks

• stereo_iq_source: live stereo PCM audio input exposed as separate I and Q float streams. The Windows implementation supports selecting a WaveIn device and stopping cleanly when an input device disappears.
• wav_iq_source: WAV-file I/Q or real-IF source used by compatible receiver flowgraphs and offline tests.

Requirements

• CMake 3.8 or newer
• C++11 compiler
• GNU Radio 3.10 (blocks, fft, and filter; audio is also required on non-Windows platforms)
• Python and pybind11 support from GNU Radio when Python bindings are enabled

Build

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
cmake --install build --config Release

Set CMAKE_PREFIX_PATH or Gnuradio_DIR if GNU Radio is installed outside the default search path. On Windows, run these commands from the compiler environment matching the GNU Radio distribution.

Compatibility

Renaming the internal module or DLL would break existing ASRTU receiver builds and GNU Radio flowgraphs. Keep hyacinthsat as the ABI/module name even though the repository and public project name are gr-hyacinth.

License

GPL-3.0-or-later. See COPYING. Individual files retain their original copyright notices.