InstallingGR: Difference between revisions

From GNU Radio
Jump to navigation Jump to search
(Moved the Linux-specific installation information to LinuxInstall)
(Streamlined the page contents.)
Line 2: Line 2:
{{Template:BeginnerTutorials}}
{{Template:BeginnerTutorials}}
</div>
</div>
 
= Quick Start =
{| class="wikitable"
{| class="wikitable"
|+ Install Quickstart<br>(Refer to the rest of this page for more OS and installation options)
|+  
! Ubuntu 22.04
! Ubuntu 22.04
||
||
Line 30: Line 30:
|}
|}


= Other Installation Methods =


= Types of Installation Methods =
== Platform-specific guides ==
 
The recommended way to install GNU Radio on most platforms is using already available binary packages. Find your platform below in the [[#From_Binaries|From Binaries]] section for instructions on how to get GNU Radio through your regular package manager (e.g. [[#Ubuntu_PPA_Installation|Ubuntu PPA Installation]]), or visit the [[CondaInstall|Conda Installation]] page for instructions on how to use the Conda package manager to install GNU Radio on any Linux distribution, macOS, or Windows. For some platforms there are no binaries provided by available package managers or the GNU Radio project. In these cases please contact the maintainer of the package manager or the GNU Radio project to find a sensible way to provide binaries for your platform.
 
In addition to using binaries, GNU Radio can be installed:
 
# '''[[#From_Source|From source]]''' (for those who want full control)
# '''[[#Using_PyBOMBS|Using PyBOMBS]]''' (for those who want it built from source and/or installed to a specific directory using a script)
 
== Linux ==
See the [[LinuxInstall|Linux install guide]]
 
== Windows ==
 
See the [[CondaInstall|Conda install guide]] or [https://github.com/ryanvolz/radioconda radioconda] to install GNU Radio 3.8 or newer on Windows.<br />
 
If you need to install GNU Radio from source refer to the [[WindowsInstall|Windows install guide]].
 
'''Note''': GNU Radio support on Windows is improving significantly but remains less tested and there are known problems and even significant bugs which affect regular usage of GNU Radio Companion. Please report bugs on the [https://github.com/gnuradio/gnuradio/issues GitHub Issues page] and if you have Windows development experience please consider investigating some of the [https://github.com/gnuradio/gnuradio/issues?q=is%3Aopen+is%3Aissue+label%3AWindows known issues].
 
== Mac OS X ==


Refer to the [[MacInstall|Mac OS X install guide page]].
* [[LinuxInstall|Linux install guide]]
* [[WindowsInstall|Windows install guide]]
* [[MacInstall|Mac OS X install guide]]


= Using PyBOMBS =
== Cross-platform guides ==


PyBOMBS used to be the go-to method for building GNU Radio, UHD, and various Out of Tree (OOT) modules from source and then installing them into an isolated directory rather than system-wide, not unlike a Python virtualenv.  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).  The PyBOMBS documentation is in the PyBOMBS [https://github.com/gnuradio/pybombs#pybombs README].
* [[CondaInstall|Conda install guide]]
* [https://github.com/gnuradio/pybombs#pybombs 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 =
== 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:
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:
*[https://github.com/bastibl/instant-gnuradio Instant GNU Radio] A customizable, programmatically generated VM and live environment for GNU Radio.  
*[https://github.com/bastibl/instant-gnuradio Instant GNU Radio] A customizable, programmatically generated VM and live environment for GNU Radio.  

Revision as of 22:46, 3 November 2022

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
  4. Frequency Shifting
  5. Reading and Writing Binary Files

SDR Hardware

  1. RTL-SDR FM Receiver
  2. B200-B205mini FM Receiver

Quick Start

Ubuntu 22.04
  1. sudo apt-get install gnuradio
 v3.10.1
Ubuntu 20.04
  1. sudo add-apt-repository ppa:gnuradio/gnuradio-releases
  2. sudo apt-get update
  3. sudo apt-get install gnuradio python3-packaging
 v3.10.4
Windows
  1. Install the latest Radioconda installer
  2. Launch "GNU Radio Companion" from the Start menu
 v3.10.4
macOS
  1. Install Homebrew
  2. brew install gnuradio
 v3.10.4

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).

Retrieved from "https://wiki.gnuradio.org/index.php?title=InstallingGR&oldid=12647"