gnuradio / gnuradio-docker

Script automation for creating canonical GNU Radio docker images

GNU Radio

GNU Radio is a free & open-source signal processing runtime and signal processing software development toolkit. Originally developed for use with software-defined radios and for simulating wireless communications, it's robust capabilities have led to adoption in hobbyist, academic, and commercial environments. GNU Radio has found use in software-defined radio, digital communications, nuclear physics, high- energy particle physics, astrophysics, radio astronomy and more!

Helpful Links

• GNU Radio Website
• GNU Radio Wiki
• Github issue tracker for bug reports and feature requests
• View the GNU Radio Mailing List Archive
• Subscribe to the GNU Radio Mailing List
• GNU Radio Chatroom on Matrix
• Contributors and Affiliated Organizations

How to Run the QT Version of GNU Radio Companion

    # Ensure PyQt5 and other dependencies are installed
    pip install QDarkStyle qtpy
    
    # If you want to run tests
    pip install pytest-qt pyautogui

    # Build and install as usual (described below) and then run
    gnuradio-companion --qt

GNU Radio 4.0

The next major release of GNU Radio, GNU Radio 4.0, is currently under active development. The effort is being spearheaded by FAIR (The Facility for Anti-Proton and Ion Research), part of GSI in Germany. Development of that version is currently taking place under their GitHub organization, here.

How to Install GNU Radio

Prebuilt Binaries

The recommended way to install GNU Radio on most platforms is using available binary package distributions.

The following command is for Debian, Ubuntu, and derivatives. Consult your distribution information to obtain the version of GNU Radio which is included.

    sudo apt install gnuradio

For other operating systems and versions, see Quick Start

Ubuntu PPA Installation

For Ubuntu, the latest builds (both released and pulled from master branch) are maintained as PPAs (Personal Package Archives) on launchpad.net. Be sure to uninstall any previously installed versions of gnuradio first. See UnInstall GR.

Other Installation Methods

Platform-specific guides and Cross-platform guides are described in Other Installation Methods.

From Source

Complete instructions for building GNU Radio from source code are detailed in Installing From Source.

PyBOMBS

We are no longer recommending PyBOMBS to install modern versions of GNU Radio.

Legal Matters

Some files have been changed many times throughout the years. Copyright notices at the top of source files list which years changes have been made. For some files, changes have occurred in many consecutive years. These files may often have the format of a year range (e.g., "2006 - 2011"), which indicates that these files have had copyrightable changes made during each year in the range, inclusive.

gnuradio-docker's Issues

Use RUN more efficiently

Something like

RUN mkdir /src
RUN do a bunch of stuff in /src
RUN rm -rf /src

does not actually recover the space, it just covers it up. Instead, do single transactions the way they're done with the apt/yum commands:

RUN mkdir /src \
&& do a bunch of stuff in /src \
&& rm -rf /src

Add VOLK CI containers

It'd be great to have VOLK containers for all the different platforms for people to test. This should basically be GR containers minus the VOLK binary and all the other dependencies that are not required for VOLK.

Python 3

I am currently porting this set of containers to a Python 3 base. Is there any interest in me submitting a pull request back? It doesn't look like this repo is actively maintained, so I just want to check and see whether that would even add value?

Docker image wont build "Unknown instruction" error

When I attempt to build docker using
"docker build https://github.com/gnuradio/gnuradio-docker" I get

"Downloading build context from remote url: https://github.com/gnuradio/gnuradio-docker 58.
Sending build context to Docker daemon 59.9kB
Error response from daemon: Dockerfile parse error line 7: unknown instruction: <!DOCTYPE"

Am I doing something wrong?

how to use it?

how to use gnuradio/ci image? I pulled it down,but i don't know how to use it .

Problem when running run-builder.sh

I ran into a slight issue when running the run-builder.sh file. It says that: line 8: PREFIX: unbound variable and doesn't the complete the run. I've tried to set PREFIX on the commandline and re-run the script but that doesn't work either.

I could always hardcode it to a value in the script, but I would think there is a point to $PREFIX being there. So how should I do it the "correct way"?

libcomedi0 no longer used

gnuradio-docker/ci/ci-ubuntu-20.04-3.9/Dockerfile

Line 19 in 35bd05a

libcomedi0 \

@duggabe found this whilst working through https://wiki.gnuradio.org/index.php/UbuntuInstall#Notes

Since libcomedi quite possibly won't be around forever, this unneeded dependency kind of constitutes a bug.