[3.10.5.0] - 2022-12-19

Runtime

• Python block have access to the block logger, as in C++
• Default log level changed to INFO (from OFF)
• Memory-based logger gr.dictionary_logger_backend() added for log debugging
• API Note: The Python block gateway is now completely implemented in the PyBind11 wrapper, in order to clean up Python dependencies. This is technically an API change, but should not have any external effect.
• PMT serialization of Complex32 vectors is now REAL | IMAG on all platforms
• Python IO signature replication (multiple ports specified by one signature) fixed

GRC

• Continue processing block connections after a connection error occurs
• Drawing/scaling fixes that improve user experience on HiDPI and Windows machines

Build system and packaging

• Many deprecation warnings fixed
• Make target link libraries PRIVATE wherever possible, removing unnecessary downstream dependencies
• Add Fedora 37 and drop Fedora 35 CI targets
• Conda re-rendered with more recent packages - thanks to Ryan Volz for making Conda an easy-to-use, cross-platform method of installing GNU Radio
• Debian and Fedora packaging specs are no longer included in the code base, since they were out of date, and are maintained by downstreams

Testing

• Code formatting rules for clang format updated to v14
• Removed all compiler warning suppression
• Enable Python block testing for Conda on macOS
• Many other improvements that make maintenance easier - thanks again to Clayton Smith. In the process of fixing tests, a number of latent bugs were fixed throughout the code.

gr-analog

• AGC3 performance and bug fixes
• Python has access to control_loop parent class in PLL blocks
• CTCSS detection of standard tones improved by fixing floating point comparison

gr-blocks

• Probe Signal cross platform reliability improved by better thread synchronization

gr-digital

• CRC32 and CRC16 blocks use little-endian order regardless of host order. This is a wire format change. The options were to have different endian machines unable to communicate, or older and newer versions unable to communicate. Note that there is a more general set of blocks (CRC Append and CRC Check) that are recommended for use wherever possible.
• Packet headers use consistent bit order across machines
• Floating point/rounding fix in constellation lookup table

gr-fec

• LDPC G matrix n and k can be access from Python
• LDPC matrix output size calculation corrected
• CCSDS/Viterbi path metrics overflow fix

gr-network

• Improve UDP Source/Sink efficiency by removing a layer of buffering and using the GR circular buffer instead of the Boost equivalent

gr-qtgui

• Fixed Python code generation for Msg CheckBox, Digital Number Control, Toggle Button, Toggle Switch

gr-soapy

• Sources will generate rx_time, rx_freq and rx_rate tags, as in UHD sources, where supported by the underlying Soapy driver

gr-uhd

• Re-enable uhd.find_devices(), in addition to uhd.find()
• RFNoC: generate correct Python code when using clock/time source
• RFNoC: allow specification of adapter IDs for streamers
• RFNoC: enable setting of vlen and types for streamers
• RFNoC: streamers pay attention to stream args
• RFNoC: sync block controller with gr-ettus OOT
• RFNoC:set_property() and get_property() added to the C++ and Python APIs
• RFNoC: Python binds added for rfnoc_block_generic

gr-zeromq

• Sinks will optionally block on full queue, providing backpressure. Previously, overflow data was dropped.

GNU Radio Release v3.10.4.0

[3.10.4.0] - 2022-09-16

Changed

Project Scope

• Replace get_initial_sptr() calls with make_block_sptr() calls. There were a number of places the incorrect function was being used.

Runtime

• Use correctly typed arguments to log messages to prevent build errors.

GRC

• Add xfce4-terminal and urxvt to the list of terminal emulators discovered during the build process.
• Suppress GUI hint errors that were being shown in the terminal window.
• Use integers for screenshot size (floats were causing Cairo errors).

Build system and packaging

• Reformat cmake files and make cmake formatting part of the workflow.
• Allow GNU Radio to be a part of other cmake-based projects.
• Correct linking to libiio and libad9361 on macOS.
• Update method for determining Python installation directory. This should work correctly now on (all?) distro releases.

gr-blocks

• New Block Interleaver/Deinterleaver interleaves blocks of symbols
• Correct calculation of items_remaining in File Source, which allows seek() to work correctly.
• Add an example for Wavefile Sink

gr-digital

• Deprecate the CRC32 and CRC16 blocks, which will be removed in the future. There are more general CRC blocks which do the same thing (and more).

gr-filter

• Fix demo for PFB channelizer

gr-iio

• FMCOMMS2 Sink assumes CS16 data is scaled to 32768, rather than 2048.
• FMCOMMS2 returns the correct samples for the second channel in 2-channel mode.

gr-trellis

• Correct Python bindings for trellis::metrics.

gr-qtgui

• Range widget can now output messages when value changes.
• Add C++ code generation for Time Sink
• Regenerate Python bindings for some blocks when necessary.
• Waterfall Sink correctly uses half spectrum for float input.

gr-uhd

• Add Python bindings for the UHD find() functino.

gr-zeromq

• Support newer get() and older/deprecated getsockopt() functions in cppzmq depending on availability.

Modtool

• Parse IO signatures with or without gr:: prefix.

Documentation

• Update certain file lists to keep build paths out of documentation.

Testing

• Update Conda recipe for Qt 5.15 and re-render CI support files.
• Add testing on Ubuntu 22.04.
• Link tests directly against spdlog with not linking to GR runtime.
• Ignore Python "missing whitespace after keywork" formatting error.

GNU Radio Release v3.9.8.0

[3.9.8.0] - 2022-09-16

This is last quarterly release of GNU Radio 3.9. Version 3.10 is mostly compatible with 3.9, so we recommend that all users of 3.9 migrate to 3.10 when able.

Changed

Project Scope

• Replace get_initial_sptr() calls with make_block_sptr() calls. There were a number of places the incorrect function was being used.

GRC

• Add xfce4-terminal and urxvt to the list of terminal emulators discovered during the build process.
• Suppress GUI hint errors that were being shown in the terminal window.
• Use integers for screenshot size (floats were causing Cairo errors).

gr-blocks

• Correct calculation of items_remaining in File Source, which allows seek() to work correctly.

gr-filter

• Fix demo for PFB channelizer

gr-trellis

• Correct Python bindings for trellis::metrics.

gr-uhd

• Add Python bindings for the UHD find() functino.

Testing

• Ignore Python "missing whitespace after keywork" formatting error.

Changed

Project Scope

• Continue replacement of Boost functionality with standard C++ continues, where practical, making the code more maintainable.
• Fix more flaky CI tests that were failing unnecessarily. This helps greatly with maintenance.

gnuradio-runtime

• Only catch Thrift transport exceptions
• Import PyQt5 before matplotlib to work around a bug
• Fix broken log format string in set_min_output_buffer
• Process system messages before others. This helps with orderly flowgraph termination.
• Custom buffers: add missing (simulated) data transfer to input/output_blocked_callback functions in host_buffer class
• Fix Mach-kernel timebase (numer and denom were reversed)
• Fix signed integer overflows in fixed-point table generation

GRC

• Add parentheses on arithmetic expressions to avoid operator precedence problems in templated code
• Fix create hier / missing top_block error

Build system and packaging

• CI: Add testing for Fedora 36, remove Fedora 34.
• cmake: Use platform-specific Python install schemes
• cmake: Always prefix git hash used as version with "g"
• cmake: Allow MPIR/MPLIB package find to fail gracefully
• cmake: Remove 'REQUIRED' flag for Volk

gr-blocks

• Fix rotator_cc scheduled phase increment updates
• Wavefile Sink: add support for Ogg Opus if libsndfile is >= 1.0.29
• Probe Signal: synchronize access to d_level to prevent race conditions

gr-digital

• Use memcmp for CRC comparisons to avoid alignment errors

gr-dtv

• Use unsigned integer for CRC calculation
• Fix use of uninitialized memory
• Fix initialization of L1Post struct

gr-filter

• Fix various bugs in Generic Filterbank

gr-iio

• Fix grc pluto sink attenuation callback

gr-qtgui

• Several sinks produce wrong error messages, when GUI Hint is used. Reorder params in yml files to fix.

gr-soapy

• Deactivate stream before closing. Some modules depend on this behavior.

gr-uhd

• Implement get_gpio_attr()

Code generation tools

• C++ generation: Fix various template errors

Modtool

• gr_newmod: Fix copying python bindings to test dir on Windows
• gr_newmod: Make untagged conda package version less specific
• modtool: Add a conda recipe to the OOT template
• Make the pydoc_h.mako more clang compliant

Documentation

• Add shim Sphinx config for readthedocs

Authors

The following people contributed commits to this release. They are credited by the name used in commits. There are may people who contribute in other ways ... discussions, reviews, bug reporting, testing, etc. We just don't have an easy way to provide credit for all that valuable work.

• Adrian Suciu [email protected]
• Bjoern Kerler [email protected]
• Clayton Smith [email protected]
• Daniel Estévez [email protected]
• David Sorber [email protected]
• Igor Freire [email protected]
• Jeff Long [email protected]
• Josh Morman [email protected]
• maitbot
• Martin Braun [email protected]
• Michael Roe
• Paul Atreides [email protected]
• Philipp Niedermayer [email protected]
• Ron Economos [email protected]
• Ryan Volz [email protected]
• Volker Schroer
• wakass

Changed

Project Scope

• Fix more flaky CI tests that were failing unnecessarily. This helps greatly with maintenance.

gnuradio-runtime

• Only catch Thrift transport exceptions
• Import PyQt5 before matplotlib to work around a bug
• Process system messages before others. This helps with orderly flowgraph termination.
• Fix Mach-kernel timebase (numer and denom were reversed)
• Fix signed integer overflows in fixed-point table generation

GRC

• Fix create hier / missing top_block error

Build system and packaging

• CI: Add testing for Fedora 36, remove Fedora 34.
• cmake: Allow MPIR/MPLIB package find to fail gracefully

gr-blocks

• Fix rotator_cc scheduled phase increment updates
• Probe Signal: synchronize access to d_level to prevent race conditions

gr-digital

• Use memcmp for CRC comparisons to avoid alignment errors

gr-dtv

• Use unsigned integer for CRC calculation
• Fix use of uninitialized memory
• Fix initialization of L1Post struct

gr-filter

• Fix various bugs in Generic Filterbank

gr-qtgui

• Several sinks produce wrong error messages, when GUI Hint is used. Reorder params in yml files to fix.

gr-soapy

• Deactivate stream before closing. Some modules depend on this behavior.

gr-uhd

• Implement get_gpio_attr()

Modtool

• gr_newmod: Fix copying python bindings to test dir on Windows
• Make the pydoc_h.mako more clang compliant

Authors

The following people contributed commits to this release. They are credited by the name used in commits. There are may people who contribute in other ways ... discussions, reviews, bug reporting, testing, etc. We just don't have an easy way to provide credit for all that valuable work.

• Bjoern Kerler [email protected]
• Clayton Smith [email protected]
• Igor Freire [email protected]
• Jeff Long [email protected]
• maitbot
• Philipp Niedermayer [email protected]
• Ron Economos [email protected]
• Ryan Volz [email protected]
• Volker Schroer
• wakass

[3.10.3.0-rc1] - 2022-06-09

Changed

Project Scope

• Continue replacement of Boost functionality with standard C++ continues, where practical, making the code more maintainable.
• Fix more flaky CI tests that were failing unnecessarily. This helps greatly with maintenance.

gnuradio-runtime

• Only catch Thrift transport exceptions
• Import PyQt5 before matplotlib to work around a bug
• Fix broken log format string in set_min_output_buffer
• Process system messages before others. This helps with orderly flowgraph termination.
• Custom buffers: add missing (simulated) data transfer to input/output_blocked_callback functions in host_buffer class
• Fix Mach-kernel timebase (numer and denom were reversed)
• Fix signed integer overflows in fixed-point table generation

GRC

• Add parentheses on arithmetic expressions to avoid operator precedence problems in templated code
• Fix create hier / missing top_block error

Build system and packaging

• CI: Add testing for Fedora 36, remove Fedora 34.
• cmake: Use platform-specific Python install schemes
• cmake: Always prefix git hash used as version with "g"
• cmake: Allow MPIR/MPLIB package find to fail gracefully
• cmake: Remove 'REQUIRED' flag for Volk

gr-blocks

• Fix rotator_cc scheduled phase increment updates
• Wavefile Sink: add support for Ogg Opus if libsndfile is >= 1.0.29
• Probe Signal: synchronize access to d_level to prevent race conditions

gr-digital

• Use memcmp for CRC comparisons to avoid alignment errors

gr-dtv

• Use unsigned integer for CRC calculation
• Fix use of uninitialized memory
• Fix initialization of L1Post struct

gr-filter

• Fix various bugs in Generic Filterbank

gr-iio

• Fix grc pluto sink attenuation callback

gr-qtgui

• Several sinks produce wrong error messages, when GUI Hint is used. Reorder params in yml files to fix.

gr-soapy

• Deactivate stream before closing. Some modules depend on this behavior.

gr-uhd

• Implement get_gpio_attr()

Code generation tools

• C++ generation: Fix various template errors

Modtool

• gr_newmod: Fix copying python bindings to test dir on Windows
• gr_newmod: Make untagged conda package version less specific
• modtool: Add a conda recipe to the OOT template
• Make the pydoc_h.mako more clang compliant

Documentation

• Add shim Sphinx config for readthedocs

Authors

The following people contributed commits to this release. They are credited by the name used in commits. There are may people who contribute in other ways ... discussions, reviews, bug reporting, testing, etc. We just don't have an easy way to provide credit for all that valuable work.

• Adrian Suciu [email protected]
• Bjoern Kerler [email protected]
• Clayton Smith [email protected]
• Daniel Estévez [email protected]
• David Sorber [email protected]
• Igor Freire [email protected]
• Jeff Long [email protected]
• Josh Morman [email protected]
• maitbot
• Martin Braun [email protected]
• Michael Roe
• Paul Atreides [email protected]
• Philipp Niedermayer [email protected]
• Ron Economos [email protected]
• Ryan Volz [email protected]
• Volker Schroer
• wakass

[3.9.7.0-rc1] - 2022-06-09

Changed

Project Scope

• Fix more flaky CI tests that were failing unnecessarily. This helps greatly with maintenance.

gnuradio-runtime

• Only catch Thrift transport exceptions
• Import PyQt5 before matplotlib to work around a bug
• Process system messages before others. This helps with orderly flowgraph termination.
• Fix Mach-kernel timebase (numer and denom were reversed)
• Fix signed integer overflows in fixed-point table generation

GRC

• Fix create hier / missing top_block error

Build system and packaging

• CI: Add testing for Fedora 36, remove Fedora 34.
• cmake: Allow MPIR/MPLIB package find to fail gracefully

gr-blocks

• Fix rotator_cc scheduled phase increment updates
• Probe Signal: synchronize access to d_level to prevent race conditions

gr-digital

• Use memcmp for CRC comparisons to avoid alignment errors

gr-dtv

• Use unsigned integer for CRC calculation
• Fix use of uninitialized memory
• Fix initialization of L1Post struct

gr-filter

• Fix various bugs in Generic Filterbank

gr-qtgui

• Several sinks produce wrong error messages, when GUI Hint is used. Reorder params in yml files to fix.

gr-soapy

• Deactivate stream before closing. Some modules depend on this behavior.

gr-uhd

• Implement get_gpio_attr()

Modtool

• gr_newmod: Fix copying python bindings to test dir on Windows
• Make the pydoc_h.mako more clang compliant

Authors

The following people contributed commits to this release. They are credited by the name used in commits. There are may people who contribute in other ways ... discussions, reviews, bug reporting, testing, etc. We just don't have an easy way to provide credit for all that valuable work.

• Bjoern Kerler [email protected]
• Clayton Smith [email protected]
• Igor Freire [email protected]
• Jeff Long [email protected]
• maitbot
• Philipp Niedermayer [email protected]
• Ron Economos [email protected]
• Ryan Volz [email protected]
• Volker Schroer
• wakass

[3.10.2.0] - 2022-04-09

Changed

Project Scope

• Clayton Smith continues the effort to replace Boost usage with modern C++ equivalents. In a related effort, he has continued the logging modernization started by Marcus Müller. In his spare time, he has tackled some tricky, intermittent CI failures, some of which turned out to be real bugs. Much of this work is invisible to end users, but is extremely useful in making GNU Radio more reliable and maintainable. Special thanks are due to Clayton for a lot of hard work this cycle.
• Use exceptions instead of exit() in several places.
• Fixed a variety of Python deprecation warnings.
• Packager note: jsonschema is required for the JSON Config and YAML Config blocks. Those blocks will be disabled if jsonschema is not found.

gnuradio-runtime

• Correct size/usage for single-mapped buffers (part of the new Custom Buffers feature).
• Correct buffer size allocation. This was actually the single change in v3.10.1.1, which did not get its own CHANGELOG entry.

GRC

• Improve discovery of xterm and related programs.
• Save generated hierarchical block code to the block library instead of the directory containing the current GRC flowgraph.
• New JSON Config and YAML Config blocks that load configuration variables from files at runtime. Those variables may then be used in block parameters.
• Store the GNU Radio version in flowgraph metadata when saving.
• Minor change in Python evaluation code to allow affinity, minoutbuf and maxoutbuf to be adjusted via script parameters.

Build system and packaging

• Require C++-17 for gnuradio-runtime and code compiled against it (via cmake flags).
• Add pythonschema to build- and run-time dependencies.

gr-blocks

• Add exponential distribution to Message Strobe Random block's delay selection.
• Quiet down debug messages in File Sink.
• Skip alignment check in File Source when the input file is not seekable (e.g., it is a pipe).

gr-filter

• Fix crash in Rational Resampler logging

gr-digital

• Add generic CRC blocks: CRC Append and CRC Check.

gr-qtgui

• Improve text/background color on Range widget.
• Digital Number Control emits message with new, instead of previous, value.
• Message Edit Box sends message only when return is pressed, rather than whenever focus is lost.
• Vector Sink allows legend to be disabled.
• Type error fixes (Python 3.10 is stricter about int casting).

gr-trellis

• Provide Python bindings for PCCC Encoder and Viterbi Combo.

gr-vocoder

• Add C++ generation support to gr-vocoder

Code generation tools

• Support strongly-typed enums in Python bindings

Authors

The following people contributed commits to this release. There are may people who contribute in other ways ... discussions, reviews, bug reporting, testing, etc. We just don't have an easy way to provide credit for all that valuable work.

• A. Maitland Bottoms [email protected]
• André Apitzsch [email protected]
• AsciiWolf [email protected]
• Bjoern Kerler [email protected]
• Campbell McDiarmid [email protected]
• Clayton Smith [email protected]
• Daniel Estévez [email protected]
• Davide Gerhard [email protected]
• David Sorber [email protected]
• Håkon Vågsether [email protected]
• JaredD [email protected]
• jb41997
• Jeff Long [email protected]
• Josh Morman [email protected]
• jsallay
• luz paz [email protected]
• Marcus Müller [email protected]
• Philip Balister [email protected]
• Ron Economos [email protected]
• Ryan Volz [email protected]
• Volker Schroer

[3.9.6.0] - 2022-04-09

Changed

Project Scope

• PEP8 formatting applied and enforced on all Python files.

GRC

• New JSON Config and YAML Config blocks that load configuration variables from files at runtime. Those variables may then be used in block parameters.
• Store the GNU Radio version in flowgraph metadata when saving.
• Minor change in Python evaluation code to allow affinity, minoutbuf and maxoutbuf to be adjusted via script para meters.
• Show blocks with "deprecated" flags as deprecated.
• Bug fix: initialize value for "priority" parameter in Python Snippets.
• Don't blacklist default as a flowgraph ID to prevent always starting in an error state

Runtime

• Add ownership and locking to hier_block2 to avoid crash/freeze after disconnect.

gr-analog

• Fix C++ code generation for random_uniform_source

gr-blocks

• Add exponential distribution to Message Strobe Random block's delay selection.
• Skip alignment check in File Source when the input file is not seekable (e.g., it is a pipe).

gr-filter

• Fix crash in Rational Resampler logging
• Bug fix: buses should now work with PFB channelizer and synthesizer.

gr-trellis

• Provide Python bindings for PCCC Encoder and Viterbi Combo.

gr-qtgui

• Improve text/background color on Range widget.
• Digital Number Control emits message with new, instead of previous, value.
• Message Edit Box sends message only when return is pressed, rather than whenever focus is lost.
• Vector Sink allows legend to be disabled.
• Type error fixes (Python 3.10 is stricter about int casting).
• Frequency/Waterfall Sinks force power of 2 for fft size

gr-uhd

• Correct descriptor names in uhd_fpga_ddc/duc.

Code generation tools

• Support strongly-typed enums in Python bindings

Authors

The following people contributed commits to this release. There are may people who contribute in other ways ... discussions, reviews, bug reporting, testing, etc. We just don't have an easy way to provide credit for all that valuable work.

• André Apitzsch [email protected]
• Armin Ghani [email protected]
• AsciiWolf [email protected]
• Bjoern Kerler [email protected]
• Campbell McDiarmid [email protected]
• Clayton Smith [email protected]
• David Winter [email protected]
• JaredD [email protected]
• jb41997
• Jeff Long [email protected]
• Josh Morman [email protected]
• jsallay
• Marcus Müller [email protected]
• Philip Balister [email protected]
• Ron Economos [email protected]
• Ryan Volz [email protected]
• Thomas Habets [email protected]
• Vladisslav P [email protected]
• Volker Schroer

This patch level release fixes an off-by-one error in output buffer allocation. This release should be API and ABI compatible with v3.10.1.0.

This is mostly a bug fix release. It is API compatible with 3.10.X.Y releases. Code built against GNU Radio libraries (including OOTs) will likely need to be recompiled, as ABI compatibility is not guaranteed.

Runtime

• Add ownership and locking to hier_block2 to avoid crash/freeze after disconnect.

gr-analog

• Fix C++ code generation for random_uniform_source

gr-blocks

• Minimal implementation of a SigMF Sink, allowing users to easily try out generation SigMF output. SigMF uses a raw data file and a separate JSON metadata file. A SigMF Source is also provided. At this time, it is a wrapper around a File Source (the data files are compatible), but metadata is not processed.

gr-filter

• Bug fix: buses should now work with PFB channelizer and synthesizer.

gr-iio

• Various fixes for fmcomms2/3/4.

gr-uhd

• Bug fix: overflow count was uninitialized.
• Correct descriptor names in uhd_fpga_ddc/duc.

GRC

• Bug fix: initialize value for "priority" parameter in Python Snippets.
• Show blocks with "deprecated" flags as deprecated.

This is mostly a bug fix release. It is API compatible with 3.10.X.Y releases. Code built against GNU Radio libraries (including OOTs) will likely need to be recompiled, as ABI compatibility is not guaranteed.

Runtime

• Add ownership and locking to hier_block2 to avoid crash/freeze after disconnect.

gr-analog

• Fix C++ code generation for random_uniform_source

gr-blocks

• Minimal implementation of a SigMF Sink, allowing users to easily try out generation SigMF output. SigMF uses a raw data file and a separate JSON metadata file. A SigMF Source is also provided. At this time, it is a wrapper around a File Source (the data files are compatible), but metadata is not processed.

gr-filter

• Bug fix: buses should now work with PFB channelizer and synthesizer.

gr-iio

• Various fixes for fmcomms2/3/4.

gr-uhd

• Bug fix: overflow count was uninitialized.
• Correct descriptor names in uhd_fpga_ddc/duc.

GRC

• Bug fix: initialize value for "priority" parameter in Python Snippets.
• Show blocks with "deprecated" flags as deprecated.

It is with much excitement (and after only 4 RCs!!) that we release the next step forward for GNU Radio - 3.10.0.0!

Not only does this release bring in some extremely useful new modules (gr-iio, gr-pdu, and arguably gr-soapy thought that thankfully made it also into recent 3.9 maintenance releases), but also sets a path forward for using GNU Radio in heterogeneous compute environments by providing "custom buffers" for more efficiently interacting with accelerators (GPUS, FPGAs, TPUs, etc.).

We have been fortunate this year to have extremely active backporting and consistent maintenance releases from co-maintainter Jeff Long - so many of the fixes and smaller features (and larger ones) have already seen the light of day in the 3.9.x.x and even 3.8.x.x releases. Here are some highlights of the 3.10 release:

gr-pdu

PDUs (protocol data units) in GNU Radio are a special type of PMT that have a dictionary and a uniform vector type representing a burst of data with some metadata. Up to this point, support of pdus has been scattered throughout the codebase with minimal supporting the way of handling this type of data consistently. Fortunately, Jacob Gilbert has been able to upstream much of the amazing work from himself and the team at Sandia National Labs which brings in-tree a suite of tools for manipulating these data objects (see https://github.com/sandialabs/gr-pdu_utils). Also, many of the previous PDU processing blocks that existed in other in-tree modules have been migrated to this module, so there has been some block re-arrangement. Please see https://www.youtube.com/watch?v=bT60hVVte48 for more detailed information

gr-iio

IIO is the industrial I/O framework that provides an industry standard method for communicating with a wide-range of devices. Analog Devices has supported out of tree a gr-iio module that brings this capability into GNU Radio and now upstreamed this module so support for devices like the PlutoSDR are available out of the box. Special thanks here to Adam Horden, Dave Winter, Volker Shroer for bringing this in-tree and working through many of the complexities. Please see https://www.youtube.com/watch?v=2gKbollW6wg for a more technical description of IIO and gr-iio.

Custom Buffers Support

NOTE: this is an advanced "experimental" feature that if not actively employed will not affect normal GNU Radio usage.
David Sorber from Black Lynx has introduced a feature that enables streamlined data movement between GNU Radio blocks and hardware accelerators. By creating a "custom buffer" class (or using one that is provided by someone else), blocks can be made to abstract the data movement behind the scenes so that when the work function is reached, data already exists in the device memory.
Let me give a quick example - previously if you wanted to write a GPU accelerated block with CUDA, you would have to get into the work function, move the data from the GNU Radio circular buffers to GPU device memory, execute the CUDA kernels, then move the data back to GR buffers. Now that data movement is done behind the scenes if the block is set up right so that when the work function is hit, the data is in GPU device memory and will get transferred back to CPU memory behind the scenes as well. This allows back to back HW accelerated blocks to not have to ingress/egress in and out of GR memory unnecessarily. Also, the single mapped buffer abstraction brings huge performance benefits as can be seen here: https://www.youtube.com/watch?v=VO1zMXowezg for a much better description, and for all the technical details: https://wiki.gnuradio.org/index.php/Custom_Buffers For examples of this in action, please see the gr-cuda repository here: https://github.com/gnuradio/gr-cuda - which contains the CUDA custom buffers (that can be re-used in your OOT) and some example blocks.

Logging Infrastructure

Log4CPP has previously been our logging backend library, but has become a troublesome dependency. A huge thanks to Marcus Müller for fixing all of this up, replacing Log4CPP with spdlog - a more modern logging library, and also for his ongoing architectural leadership on this project. The move to spdlog also opens up the door for more modern logging statements that don't rely on Boost.format, and libfmt (which is now also a dependency) can be used for general string manipulation as well. All the previous methods and macros still exist (except for the log4cpp specific ones), but there is now new capability to log in a more convenient way using the libfmt statements.
Previous: GR_LOG_INFO(this->d_logger, boost::format("this happened: %d") % code) New: this->d_logger->info("this happened {:d}", code)

Contributors

Much appreciation to all that contributed through code, documentation, review, and just generally being a part of this wonderful community. The code contributors for 3.10 includes AT LEAST the following: 0xloem [email protected] a-andre [email protected] Adam Horden [email protected] Adarsh Singh [email protected] Aditya Thomas [email protected] Adrien Michel [email protected] André Apitzsch [email protected] Andrej Rode [email protected] Artem Pisarenko [email protected] Bernard Tyers - Sane UX Design [email protected] beroset [email protected] Bill Muzika [email protected] Callyan [email protected] Chris [email protected] Christophe Seguinot [email protected] Christoph Koehler [email protected] Chuang Zhu [email protected] Clayton Smith [email protected] cmrincon [email protected] Codey McCodeface [email protected] Daniel Estévez [email protected] David Pi [email protected] David Sorber [email protected] David Winter [email protected] Derek Kozel [email protected] Doron Behar [email protected] duggabe [email protected] efardin [email protected] Elof Wecksell [email protected] Emmanuel Blot [email protected] Ferenc Gerlits [email protected] GitHub [email protected] gnieboer [email protected] Håkon Vågsether [email protected] Igor Freire [email protected] Ipsit [email protected] Jacob Gilbert [email protected] japm48 [email protected] JaredD [email protected] Jason Uher [email protected] Jeff Dumps [email protected] Jeff Long [email protected] Jeppe Ledet-Pedersen [email protected] jfmadeira [email protected] jmadeira [email protected] Johannes Demel [email protected] John Sallay [email protected] Josh Blum [email protected] Josh Morman [email protected] karel [email protected] lenhart [email protected] Liu, Andrew Z [email protected] luz paz [email protected] Marc L [email protected] Marcus Müller [email protected] Mark Bauer [email protected] Mark Pentler [email protected] Martin Braun [email protected] Martyn van Dijke [email protected] masw [email protected] Matt Ettus [email protected] Matt Mills [email protected] muaddib1984 [email protected] Nicholas Bruce [email protected] Nicholas Corgan [email protected] Nick Foster [email protected] Nick M [email protected] Nick Østergaard [email protected] Niki [email protected] Notou [email protected] Oleksandr Kravchuk [email protected] Pavon [email protected] Philip Balister [email protected] rear1019 [email protected] Rohan Sharma [email protected] Ron Economos [email protected] Ryan Volz [email protected] schneider42 [email protected] Sebastian Koslowski [email protected] Seth Hitefield [email protected] shwhiti [email protected] Solomon Tan [email protected] Sylvain Munaut [email protected] Terry May [email protected] Thomas Habets [email protected] Tim Huggins [email protected] Travis F. Collins [email protected] Vasilis Tsiligiannis [email protected] Vasil Velichkov [email protected] Victor Wollesen [email protected] Volker Schroer [email protected] Zackery Spytz [email protected]

Release candidate 4 for v3.10.0.0

This is a hard freeze and will convert into v3.10.0.0 if no serious issues are found

Release candidate 3 of v3.10.0.0

This is an API compatible update to GNU Radio 3.9. Code written for 3.9.X versions should compile and link without modification. The ABI is not guaranteed to be compatible, so a rebuild of OOT modules may be necessary.

Changes

GRC

• Fix: dependent variables sometimes fail to evaluate
• Modify and cleanup bokeh server loop

gr-analog

• Update python bindings for power squelch

gr-dtv

• Add energy normalization for DVB-S2X constellations.

gr-filter

• Remove pyqwt and qt4 from filter_design

gr-network

• Fix: segfaults when TCP & UDP blocks are restarted
• Add throttle flag to the tcp source and sink blocks

gr-qtgui

• Enable use of Qwt 6.2

gr-uhd

• Add Python bindings for rfnoc_{block, ddc, duc, rx/tx_radio}

modtool

• Improvements in generated QA code

Build System

• Better support for cross-compiling (OpenEmbedded)
• Find log4cpp on Ubuntu systems
• Handle optional components in find_package
• Add version check for pygccxml

CI/QA

• Update tests to work with OpenEmbedded

Contributors

At LEAST the following people contributed to this release:

• a-andre
• Aditya Thomas [email protected]
• Andre Puschmann [email protected]
• Bill Muzika [email protected]
• Christoph Koehler [email protected]
• Christoph Koehler [email protected]
• Chris Vine [email protected]
• Clayton Smith [email protected]
• Jeff Long [email protected]
• Josh Morman [email protected]
• masw [email protected]
• Nicholas Bruce [email protected]
• Nick M [email protected]
• Nick Østergaard [email protected]
• Notou [email protected]
• Philip Balister [email protected]
• Ron Economos [email protected]
• Ryan Volz [email protected]
• shwhiti [email protected]
• Volker Schroer

This is an API compatible update to GNU Radio 3.8. Code written for 3.8.X versions should compile and link without modification. The ABI is not guaranteed to be compatible, so a rebuild of OOT modules may be necessary.

GRC

• GRC now runs on Fedora 35 ... Gtk initialization checks were too strict
• Fix: dependent variables sometimes fail to evaluate
• Change type aliasing to allow interleaved short/byte to be connected to vectors of short/byte. Stricter type checking was added previously and caused some blocks to be unconnectable when using these types.
• Account for scale factor when computing drawing area size
• Tooltips fixed for categories and modules

gr-digital

• Fix yml file for Header/Payload Demux

gr-dtv

• Add energy normalization for DVB-S2X constellations.

gr-filter

• Remove pyqwt and qt4 from filter_design

gr-qtgui

• Enable use of Qwt 6.2
• Remove unusable int type in Number Sink yml
• RangeWidget - implement Eng & EngSlider

At LEAST the following authors contributed to this release.

• Bill Muzika [email protected]
• Chris [email protected]
• Chris Vine [email protected]
• Clayton Smith [email protected]
• Doron Behar [email protected]
• Jeff Long [email protected]
• John Sallay [email protected]
• Josh Morman [email protected]
• Marcus Müller [email protected]
• Mark Pentler [email protected]
• Martin Braun [email protected]
• masw [email protected]
• Matt Mills [email protected]
• Nick Østergaard [email protected]
• Ron Economos [email protected]
• Ryan Volz [email protected]
• Sec [email protected]
• Volker Schroer

Second release candidate for v3.10.0.0

Release candidate for v3.10.0.0. This release introduces the following major features:

• gr-pdu
• gr-iio
• Custom Buffers
• Log4CPP Replacement

Release v3.9.4.0 is appearing a little early because of a couple of regressions in v3.9.3.0. While we were at it, we pulled in a few more helpful commits from the master branch.

This is an API compatible update to GNU Radio 3.9. Code written for 3.9.X versions should compile and link without modification. The ABI is not guaranteed to be compatible, so a rebuild of OOT modules may be necessary.

Changes

Regressions Fixes

• Remove #include <filesystem> (C++17 feature) from one file
• Restore pyqwidget() in gr-qtgui

GRC

• GRC now runs on Fedora 35 ... Gtk initialization checks were too strict
• Add keyboard shortcuts for zoom
• Account for scale factor when computing drawing area size
• Use font size from config for block comments
• Change type aliasing to allow interleaved short/byte to be connected to vectors of short/byte. Stricter type checking was added previously and caused some blocks to be unconnectable when using these types.
• Required params no longer default to 0 when left empty. This caused hard-to-find errors. Older flowgraphs that have empty required fields will need to be fixed.
• Tooltips fixed for categories and modules

gr-runtime

• PMT uses the VOLK allocator for vectors
• get_tags_in_window() Python wrapper calls the correct function
• Add --pybind option to gnuradio-config-info to get PyBind11 version

gr-blocks

• Add example for XMLRPC
• Add a unit test for Message Strobe
• Fix C++ support for Unpacked to Packed

gr-channels

• RNG seeds are initialized correctly

gr-digital

• Fix yml file for Header/Payload Demux

gr-network

• Suppress warning in tuntap

gr-qtgui

• Remove unusable int type in Number Sink yml
• Use no_quotes() function in several yml files

modtool

• Hashes can be fixed using modtool using --update-hash-only
• Use tempfile() instead of /tmp in bindtool and modtool
• Use static_cast instead of reinterpret_cast in templates
• Correct broken Python general block template

Build system

• Better check for Boost version
• Determine the Python prefix more reliably
• Use GR-specified compiler standard (C++14) in gr-soapy, instead of the SoapySDR standard (C++11)
• GrPython.cmake is compatible with older cmake

Documentation

• Man pages are in-tree
• Repair many examples, especially in gr-digital
• Allow UTF-8 in pydoc templates

CI

• Execute make install during test
• Add Ubuntu 18.04 test target

Release candidate for v3.9.4.0. This release is intended to be API compatible with v3.9.x.y.

This is an API compatible update to GNU Radio 3.9. Code written for 3.9.X versions should compile and link without modification. The ABI is not guaranteed to be compatible, so a rebuild of OOT modules may be necessary.

Changes

General

• Many cleanups and some C++ modernization changes
• Replace Boost with stdc++ equivalents (ongoing effort)
• Logging cleanup and performance improvements (ongoing effort)
• Cleanup of many unused includes
• Various block yaml cleanups and repairs
• Use Soapy instead of UHD for flowgraph testing in gr-analog and gr-dtv

GRC

• Improvements in C++ templates and code generation, more blocks are usable
• Add specification of packages to find (via cmake) for C++ templates
• Fix C++ hier block param template
• Add GUI hints for widgets in C++ code generation
• Add no_quotes() convenience function to strip quotes from strings, callable from templates
• Allow short and byte as valid types in an enum
• Fix desync when dragging block (block would not always track cursor)
• Correctly evaluate interdependent variables
• Allow error messages to be copied to clipboard
• Update disabled blocks if they depend on others

gnuradio-runtime

• Deprecate tag_checker class (will be removed in 3.10)
• Detect and follow symbolic links for installation prefix in gr::prefix()
• Add "<" operator for comparison of tags (instead of offset_compare())

gr-blocks

• New Matrix Interleaver block
• Throttle and Head blocks can be input-only when no output is needed, improving performance
• Fix tag propagation in (un)pack-k-bits blocks
• Fix namespace for nco and vco in benchmarks

gr-digital

• New Async CRC16 block
• Add NRZI option to Differential En/Decoder
• Constellation performance improvements
• Fix constellation normalization by average power
• Remove unimplemented msg output port from Chunks to Symbols block
• Make unpacking of bits optional in GMSK modulator so the blocks can accept unpacked bits
• In GFSK/GMSK hier blocks, replace M&M clock recovery with newer and more capable Digital Symbol Sync block

gr-fec

• Cleanups and code improvements

gr-fft

• Add a "shift" paramenter to Log Power FFT, to place DC bin at center

gr-filter

• Performance improvement in PFB Arbitrary Resampler when interpolating, especially at low rates

gr-qtgui

• Fix display of tags on the last sample (would be dropped)
• Python wrapping: replace pyqwidget() with qwidget() - this is not intended to be a visible fix, but is mentioned here in case it causes trouble for anyone
• C++ generation
  • add double quotes to cpp_opts keys with colons
  • position windows correctly depending on gui_hint
  • use option attributes to generate enums
  • use the cpp enums for wintype and trigger_type

gr-uhd

• Fix input filename in freq hopping examples
• Make RFNoC a separately enabled component in cmake
• Python bindings for rfnoc_graph,_rx/tx_streamer

gr-video-sdl

• U and V channels were reversed on sink blocks

gr-soapy

• Added message support for SoapySDR 0.8 API

modtool

• Set VERSION_PATCH to 0 instead of "git" in new modules
• Fix "rm", "bind", disable", "rename" and "makeyml" which had unexpected side effects, or did not work as a user would expect

Build System

• Correct minimum version checking for Mako
• Ensure that RC_*_VERSION are numeric (Windows)
• Fix finding libunwind
• Pass through extra arguments to GR_PYTHON_INSTALL to install command
• Remove absolute paths and private links from exported targets
• Add gir1.2-gtk-3.0 as deb runtime dependency

Documentation

• Code of Conduct updates and link to Wiki

CI

• Do not error out on deprecations, allowing testing of deprecated code

Contributors

At LEAST the following people contributed code to this release.

Adrien Michel cmrincon [email protected] Daniel Estévez [email protected] David Pi [email protected] David Winter [email protected] Håkon Vågsether [email protected] Igor Freire [email protected] japm48 JaredD [email protected] Jason Uher [email protected] Jeff Long [email protected] jfmadeira [email protected] jmadeira [email protected] Marc L [email protected] Marcus Müller [email protected] Mark Bauer [email protected] Martin Braun [email protected] Nicholas Corgan [email protected] Oleksandr Kravchuk [email protected] Pavon [email protected] Rohan Sharma [email protected] Ron Economos [email protected] Ryan Volz [email protected] Seth Hitefield [email protected] Solomon [email protected] Solomon Tan [email protected] Volker Schroer

API is compatible with C++ code written against previous v3.8 releases.

ABI (link time) compatibility is not guaranteed. Out-of-tree C++ code linked to previous v3.8 releases should be rebuilt against this version.

Changed

GRC

• Fix drag and drop issue with Quartz
• Fix desync when dragging block
• Update disabled blocks if they depend on others
• Allow short and byte as valid types in an enum
• Fix evaluation of interdependent variables

modtool

• Set VERSION_PATH to 0 in new modules, instead of using GIT rev
• For Python3, return correct exeption ModuleNotFoundError instead of ImportError

gr-blocks

• New Matrix Interleaver block

gr-channels

• Fix "hide" expressions in yml files

gr-digital

• Remove unused msg output port from Chunks To Symbols block yml

gr-fft

• Add "shift" parameter to Log Power FFT

gr-qtgui

• Fix: tags on the last sample were not shown

gr-video-sdl

• Fix: U and V channels were reversed on sink blocks

At LEAST the following authors contributed to this release.

• Adrien Michel [email protected]
• David Winter [email protected]
• Emmanuel Blot [email protected]
• Håkon Vågsether [email protected]
• Jared Dulmage [email protected]
• Jason Uher [email protected]
• Jeff Long [email protected]
• Marc L [email protected]
• Marcus Müller [email protected]
• Martin Braun [email protected]
• Ron Economos [email protected]
• Volker Schroer