InstallingGR: Difference between revisions

From GNU Radio
Jump to navigation Jump to search
(→‎Quick Start: github releases page needs to be navigated, hard for newbs. Since we're maintaining the "current release" row, anyways, let's just link to the downloads directly)
(→‎Quick Start: Overhaul table)
Line 5: Line 5:
{| class="wikitable"
{| class="wikitable"
|+  
|+  
! Ubuntu 22.04
!rowspan=2| Debian ≥12<br>Ubuntu ≥22.04<br>Mint ≥21.1<br>Raspberry Pi OS<sub>64-bit</sub> ≥2021-10-30
|rowspan=2| <syntaxhighlight lang="shell">sudo apt-get install gnuradio</syntaxhighlight>
||Ubuntu 22.04: v3.10.1.1
|-
||Ubuntu 23.04: v3.10.5.1
|-
! Ubuntu 20.04<br><small>Consider [https://ubuntu.com/tutorials/upgrading-ubuntu-desktop#1-before-you-start upgrading] your Ubuntu</small>
||
||
# <code>sudo apt-get install gnuradio</code>
<syntaxhighlight lang="shell">
||v3.10.1.1
sudo add-apt-repository ppa:gnuradio/gnuradio-releases
sudo apt-get update
sudo apt-get install gnuradio python3-packaging
</syntaxhighlight>
||v3.10.5.1
|-
|-
! Ubuntu 20.04
! Other Linux Distros
||
||
# <code>sudo add-apt-repository ppa:gnuradio/gnuradio-releases</code>
<syntaxhighlight lang="shell">
# <code>sudo apt-get update</code>
sudo {apt,dnf,yay,emerge,…} gnuradio
# <code>sudo apt-get install gnuradio python3-packaging</code>
</syntaxhighlight>
||v3.10.5.1
|| See [https://repology.org/project/gnuradio/badges this table]
|-
|-
! Windows
! Windows
||
||
# Install the Windows [https://github.com/ryanvolz/radioconda/releases/download/2023.04.26/radioconda-2023.04.26-Windows-x86_64.exe Radioconda installer]
Run [https://github.com/ryanvolz/radioconda/releases/download/2023.04.26/radioconda-2023.04.26-Windows-x86_64.exe Windows Radioconda installer]<br>
# Launch "GNU Radio Companion" from the Start menu
and launch "GNU Radio Companion" from the Start menu
||v3.10.6.0
|rowspan=3|v3.10.6.0
|-
|-
! macOS
!rowspan=2| macOS
||
| Intel: Run [https://github.com/ryanvolz/radioconda/releases/download/2023.04.26/radioconda-2023.04.26-MacOSX-x86_64.pkg Mac OS X Radioconda installer (x86_64)]
# Install the Mac OS X [https://github.com/ryanvolz/radioconda/releases/download/2023.04.26/radioconda-2023.04.26-MacOSX-x86_64.pkg Radioconda installer]
|-
||v3.10.6.0
| Apple Silicon: Run [https://github.com/ryanvolz/radioconda/releases/download/2023.04.26/radioconda-2023.04.26-MacOSX-arm64.pkg Mac OS X Radioconda installer (aarch64)]
|}
|}



Revision as of 11:38, 15 June 2023

Beginner Tutorials

Introducing GNU Radio

  1. What is GNU Radio?
  2. Installing GNU Radio
  3. Your First Flowgraph

Flowgraph Fundamentals

  1. Python Variables in GRC
  2. Variables in Flowgraphs
  3. Runtime Updating Variables
  4. Signal Data Types
  5. Converting Data Types
  6. Packing Bits
  7. Streams and Vectors
  8. Hier Blocks and Parameters

Creating and Modifying Python Blocks

  1. Creating Your First Block
  2. Python Block With Vectors
  3. Python Block Message Passing
  4. Python Block Tags

DSP Blocks

  1. Low Pass Filter Example
  2. Designing Filter Taps
  3. Sample Rate Change

Quick Start

Debian ≥12
Ubuntu ≥22.04
Mint ≥21.1
Raspberry Pi OS64-bit ≥2021-10-30
sudo apt-get install gnuradio
Ubuntu 22.04: v3.10.1.1
Ubuntu 23.04: v3.10.5.1
Ubuntu 20.04
Consider upgrading your Ubuntu
sudo add-apt-repository ppa:gnuradio/gnuradio-releases
sudo apt-get update
sudo apt-get install gnuradio python3-packaging
v3.10.5.1
Other Linux Distros
sudo {apt,dnf,yay,emerge,…} gnuradio
See this table
Windows

Run Windows Radioconda installer
and launch "GNU Radio Companion" from the Start menu

v3.10.6.0
macOS Intel: Run Mac OS X Radioconda installer (x86_64)
Apple Silicon: Run Mac OS X Radioconda installer (aarch64)

Other Installation Methods

Platform-specific guides

Cross-platform guides

  • Conda install guide
  • PyBOMBS - Note: We are no longer including PyBOMBS as a recommended method of installing GNU Radio, unless you want to play around with old versions (e.g. GR 3.7, 3.8, and OOTs of matching version)

VMs and Live Images

Over the years a number of Live Images and VMs have been created. There are currently no official versions but here are some current options:

  • Instant GNU Radio A customizable, programmatically generated VM and live environment for GNU Radio.
  • UbuntuVM An Ubuntu 20.04 virtual machine image with GNU Radio 3.8.2.0, Fosphor, GQRX, and several other useful pieces of software. (Created using Instant GNU Radio)

OK, it's installed, what now?

If the installation worked without any trouble, you're ready to use GNU Radio! If you have no idea how to do that, the best place to start is with the Tutorials.

Optionally, you may run volk_profile on your terminal to help libvolk to determine the optimal kernels (may speed up GNU Radio).