3.10.5.0
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.
3.10.4.0
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.
The package changed with the addition of its libepoll-shim dependency.
Otherwise, we can get:
ERROR: libepoll-shim>=0.0.20210418 is not installed; can't buildlink files.
## [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
- gr-pdu: Protocol Data Units library
- gr-iio: Linux industrial I/O library (but not packaged in pkgsrc)
- Custom Buffers Support
- switch from Log4CPP to spdlog
Changed
SoapySDR support (gr-soapy)
GRC
Parameter expressions and/or values can be displayed in blocks on the flowgraph. Previously, only values were displayed. Look for the "Show Parameter ..." toggles under the View menu.
Deprecated blocks are shown in a distinct color (orange), and the optional deprecated property has been added to block yaml
Dark theme works better, especially for parameter fields
Vector length is now correctly applied to all input ports
Validation has been improved. Raw types are validated. Port connections are checked by type rather than by item size.
Variable names that cause name conflicts in Python code (e.g., with package names) are rejected
Bus logic fixes
Blocks can no longer be dragged off the screen and lost forever
gnuradio-runtime
Remove pmt::pmt_* functions, which were not actually implemented. This is technically an API change, but any use of the API would have resulted in a link error.
Remove Python bindings for internal buffer functions
gr-analog
Added an example for PLL Frequency Detector
Better names for parameters in PLL GRC blocks
gr-blocks
Consistent naming for Vector Length parameter in GRC blocks
count_bits uses VOLK popcnt for better performance (used for example in the Correlate Access Code block)
Rotator block phase increment parameter is controllable via a message, and a tag can be added at the point where the increment is adjusted
gr-digital
MPSK example updated to use a Linear Equalizer (replacing deprecated block)
gr-filter
Filter Delay documentation improvement
Interpolating FIR filter can generate C++ code
gr-dtv
VL-SNR bugs fixed (incorrect constants).
gr-qtgui
Improve autoscaling for vector sinks
Fix floating-point resolution problems in several widgets, due to interpretation of PMT doubles as floats
gr-uhd
Add policy enum to Python bindings for tune_request
Additional time spec options on UHD blocks (PC Clock on Next PPS, GPS Time on Next PPS)
Fix up code that was generating warnings
Fix command handler logic to apply commands from messages to the correct channel
gr_filter_design
"File/Save" is disabled until the taps have been computed, and the GUI is reset after a save, to make it clearer which data is being saved.
Entries are hidden for parameters that do not apply to the selected filter type.
Save window type as an integer instead of a Python enum name
gr_modtool
Improve validation of module and block names
Build System and Infrastructure
Improved messages related to dependencies MPIR and GMP. Only one of these packages is required, and the previous error messages were confusing.
Cleaner builds for Windows and Conda. A number of general cmake improvements have resulted from this work.
In-tree packaging files for DEB and RPM, used with Launchpad and COPR
Added man pages for GNU Radio tools
Test code generation for all in-tree GRC examples
In GrPybind.cmake, PYBIND11_INCLUDE_DIR (incorrect) was changed to
pybind11_INCLUDE_DIR
This yields one common package to provide libfftw3 (double) and libfftw3f
(single) by default and optionally the Fortran bindings as well as
OpenMP and MPI variants, and those with long double or quad precision.
This changes all packages depending on fftwf in the same commit to minimize
the time of inconsistency. Soon, math/fftwf will disappear.
Changed
C++14
C11
VOLK now “regular” dependency, not in-tree submodule
numpy now also a CMake-checked hard dependency for Python support
Exception Handling: throw by value, catch by reference (clang-tidy check)
C++11: Emplace in vectors where you can; brings performance boni, but not included in clang-tidy-checks
An exception-throwing block will now terminate the flow graph process, configurable through top_block
gr-utils cleanup, folder restructuring
config version checks installed CMake file will accept “at least this version” now
PyBind11 replaces SWIG
Full tree conversion from SWIG to Pybind11 bindings
Doxygen now uses MathJax, full LaTeX installation no longer required
GRC
start flowgraph in folder where it resides
gnuradio-runtime
When calculating offsets in non-integer rate FEC, lround
default seed for gr::random now actually as documented time-dependent
loggers moved from gr::block to gr::basic_block
PMT serialization
PMT dicts no longer indistinguishable from pairs
PMT symbol hashing no longer suffers under oddball own implementations
gr-audio
Increased ALSA buffer nperiods
gr-blocks
add, add_const VOLK’ized, templated
this seems to break things in other places, even if it proves to be mathematically identical
wavfile infrastructure: libsndfile now dependency
gr-digital
transcendental block: default to 32 bit float complex, not double
Linear equalizer: separate adaptive algorithm, allows for using e.g. trained sequences instead of the classical LMS, CMA
DFE: better structure for decision history
gr-dtv
LDPC encoder: template functions instead of #defined macros
LDPC encoder: smaller tables through uint16_t for index tables
gr-fec
API uint8_t, not char
gr-fft
FFT blocks/functions templatized
gr-filter
logging format
rational_resampler_base -> rational_resampler
gr-uhd
Required UHD version bumped to 3.9.7
logging format
Deprecated
gr-analog
sig_source: freq port will be removed in the future
gr-audio
audio-sink, -source: Windows audio sink/source deprecated, the portaudio
sink/source works even better under windows anyway
gr-digital
In favor of symbol_sync, deprecate:
clock_recovery_mm
msk_timing_recovery
pfb_clock_sync
Added
C++ Generation all over the place
PyBind bindings + generator
gnuradio-runtime
block_gateway: set_max_output_buffer
GR_PREFS_PATH environment variable sensitivity to configure the path to the
config file
gnuradio-config-info --print-all
GRC
option to toggle ID visibilities globally
Validation check for QT GUI hints
Python snippets
block header parsing tool
block header parsing tool (GSoC 2019)
gr_modtool
option to convert blacklisted files
gr-analog
sig_source: cmd port adds support for dicts, setting of frequency, amplitude,
offset and phase parameters
gr-blocks
selector now has control message ports
Rotator-based freq shift convenience wrapper
Message-to-Variable and vice versa blocks
DC Spike removal
IQ Swap
Complex to interleaved char / short: scaling option
Delay block: control message port
Phase Shift block with message port
wavfile_sink, _source can now deal with a lot of audio formats: uncompressed
WAV/AIFF, µ- and A-law compressed audio, OGG/Vorbis, FLAC, even octave files
Stream Demux, which demuxes streams according to lengths vector
rotator: phase() getter
gr-digital
OFDM: multiple CP lengths
ofdm_equalizer_simpledfe: enable_soft_output
Constellation Encoder
Constellation: normalization options
gr-fec
{en,de}code_rs_8, {en,de}code_rs_ccsds: Reed-Solomon en- and decoders
gr-fft
Windows:
Gaussian
Flat Top
Tukey
Window build() call now with default beta
gr-filter
GRC: File taps loader block
Low pass FFT filter convenience wrapper
ichar / ishort decimator
phase continuity for freq_xlating_fir_filter
gr-network
gr-network: a whole new networking blocks module!
TCP
UDP
Much better lockup/multithreading support than 3.7-era blks2
gr-qtgui
Azimuth/Elevation plot
Autocorrelation plot
Compass visualization
Dial control
Gauge: dial, level
Distance plot
LED-like indicator
Message-passing check box
Message-passing numeric control
Message-passing push button
Toggle Button
Eye sink
Vertical slider
gr-uhd
Filter API
UHD 4.0 support
Power Reference API
Bidirectional setting messages on both sink, source
gr-vocoder
Codec2 dev branch support
FreeDV: In/output rates can differ
FreeDV: text message output
gr-zeromq
C++ GRC templates
Tag filtering for tag-forwarding blocks
Removed
VOLK is no longer a submodule
Sphinx: consolidate into doxygen, or wiki-maintained block list.
Python 2
SWIG
gru python module
gnuradio-runtime
circular_file.cc
math/common_factor.hpp
gr-blocks
bin_statistics_f
log2_const
gr-digital
PFB clock sync: set_taps
deprecated old OFDM infrastructur
ofdm_frame_acquisition
ofdm_frame_sink
ofdm_insert_preamble
ofdm_sync_fixed
ofdm_sync_pn
ofdm_sync_pnac
ofdm_sync_ml
ofdm_receiver
digital_voice
gr-fft
malloc_float, _double: rely on VOLK
Goertzel: dtor superfluous
gr-filter
deprecated window function duplicates (use them from gr-fft!)
Fixed
CMake: Qwt, Log4Cpp detection
ctrlport strings unicodified
Freedesktop install script was not executed
Redundant icons installed
Path substitution on Windows was backslash-broken
YAML definitions: more than I can count
Cross-building: py interpreter at runtime != build time
gnuradio-runtime
ctrlport: unholy stored reference to stack-allocated object removed
Sine table generation for fixed point math
gr_unittest: floatAlmostEqual had a lot of false passes due abuse of all()
get_tags_in_range for delay < (end-start)
Premature tag pruning
release flattened flowgraph after stopping, fixes restartability/shutdown
problem
PMT serialization portability
latency issue caused by setting block alias on msg block
Windows logging errors
ctrlport: Thrift >= 0.13 broke
GRC
Tab widget ID visibilities
A lot of YAML templates
Default setting in qtgui chooser restored
Boolean parameters no longer switch buttons
Nested namespace handling
Don’t rely on set ordering in tests
configparser import
input box color theme on dark themes
Search box typing doesn’t inadvertedly interact with the rest of GRC anymore
gr_modtool
Empty argument lists allowed
Boost UTF replaced CppUnit, this needed to be done here, too
gr-analog
wfm left/right, filters
gr-audio
portaudio: lock acquisition was improper
gr-blocks
Throttle now uses monotonic clock
Tag debug only saved last work call’s tags
File sink flushes on stop
gr_read_file_metadata.py used to lose rx_time precision
File source big file handling under Windows
file_*: fseek errors used to be ignored
gr-digital
map_bb: thread safety, buffer overflows
additive_scrambler: reset was broken
Constellation scalefactor wasn’t always initialized
long-standing qa_header_payload_demux bug addressed by waiting for both RX and
TX, not only either
false triggers in correlate_access_code
gr-dtv
rate mismatch in ATSC flowgraphs
gr-fec
async_decoder Heap corruption
cc_encoder: constraint length K > 8 led to wrong output
gr-fft
thread safety of copy assignment/ctor
log power FFT Python
gr-filter
variable_band_pass_filter GRC complex taps input
RRC filter gain for alpha = 1
gr-qtgui
Remove copies of image data in returns by using move semantics
Remove bogus overriding in drawing functions of plot_raster, _waterfall
Edit MSG box: don’t require key to be set
Don’t check for Python2 libs
Number Sink ignored averaging setting
gr-uhd
UHD apps: Py3 fixes
USRP blocks: multichannel objects not properly populating channels
gr-video-sdl
YUV formats fixed
gr-zeromq
Don’t depend on deprecated ZMQ functionality
Unhandled exceptions now handled, much calmer
Avoid infinite blocking in tb.stop() by using ZMQ_LINGER
------------------------------------------------------------
ChangeLog v3.7.10.1
This is the first bug-fix release for v3.7.10
This contains bug fixes primarily for GRC and DTV.
- GRC
* Catch more exceptions thrown by ConfigParser when reading corrupted
grc.conf files.
* Fix the docstring update error for empty categories.
* Fix grcc to call refactored GRC code.
* Convert initially opened files to absolute paths to prevent
attempting to read from tmp.
* Move startup checks back in to gnuradio-companion script from grc/checks.py.
- DTV
* Fix a segfault that occurs from out-of-bounds access in
dvbt_bit_inner_interleaver forecast by forecasting an enumerated list
of all input streams.
* Fix VL-SNR framing.
- Digital
* Enable update rate in block_recovery_mm blocks to keep tags close to
the the proper clock-recovered sample time. Tag offsets will still be
off between calls to work, but each work call updates the tag rate.
- Analog
* Fix the derivative calculation in fmdet block.
- Builds
* Fix linking GSL to gr-fec.
* Use gnu99 C standard rather than gnu11 standard to maintain
support for GCC 4.6.3.
- Other
Minor spelling and documentation fixes.
Fix uhd_siggen_gui when using lo_locked.
(pkgsrc changes on gnuradio-core/Makefile.common)
- Following lines added
CXXFLAGS+= -pthread
.include "../../devel/cppunit/buildlink3.mk"
.include "../../math/gsl/buildlink3.mk"
