UbuntuVM: Difference between revisions

From GNU Radio
Jump to navigation Jump to search
No edit summary
No edit summary
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
An Ubuntu 20.04 virtual machine image with GNU Radio 3.8.2.0, Fosphor, GQRX, and several other useful pieces of software.
An Ubuntu 20.04 virtual machine image with GNU Radio 3.8.2.0, Fosphor, GQRX, and several other useful pieces of software.


The images are available at: https://www.gnuradio.org/releases/
The most recent image is instant-gnuradio-3.8.2.0-1.0.0.ova and is a 3.4 GB download and 11 GB once installed and launched.


The most recent image is instant-gnuradio-3.8.2.0-1.0.0.ova
There is a torrent available: https://gnuradio.inpha.se/instant-gnuradio-3.8.2.0-1.0.0.ova.torrent


There is also a torrent available: https://gnuradio.inpha.se/instant-gnuradio-3.8.2.0-1.0.0.ova.torrent
If you can't use the torrent (which would be load balancing, including using GNU Radio's server), you can also download from  https://www.gnuradio.org/releases/ , but that might be slower.
 
The VM is built with [https://github.com/bastibl/instant-gnuradio Instant GNU Radio]. If there are any issues, please report them [https://github.com/bastibl/instant-gnuradio/issues here]. You can also use the VM as a base for your own builds. See the VM, created for the GRCon workshop on satellite communications [https://github.com/bastibl/instant-gnuradio/commit/a0ffd8af73a0b2ed3db3262699c08cfb015147b4 as an example].




Line 23: Line 25:
Or available via https://www.virtualbox.org/wiki/Downloads. If downloading manually, make sure the extension pack version number matches the VirtualBox version number. Distributions do not always use the latest version. Installation is under File/Preferences/Extensions.
Or available via https://www.virtualbox.org/wiki/Downloads. If downloading manually, make sure the extension pack version number matches the VirtualBox version number. Distributions do not always use the latest version. Installation is under File/Preferences/Extensions.


=== Pass Through USB Devices ===
=== Importing the Image ===
 
OVA files are loaded into VirtualBox under File/Import Appliance. Use default answers to any dialogs. Once the OVA is loaded it will show up in the list of available images in VirtualBox.
 
=== Running the Image ===
 
Select the image and hit the "Start" button. Log in when prompted. The screen will start off at low resolution. Select a more useful resolution under View/Virtual Screen 1. For High DPI monitors, you may want to select a scaling factor under the same menu.
 
If the image fails to boot, and the error dialog "Details" mention xHCI, then the extension pack was most likely not installed correctly.
 
The VM uses a persistent disk image, (1) your preferences and work will be saved, and (2) it is best to shut down the VM as if it were a real computer to avoid loss of work.
 
== GNU Radio Companion ==
 
The first icon in the app menu (the GNU Radio logo) will start GRC.
 
== USB Devices ==
 
=== Passing Through USB Devices ===
 
Host USB devices (e.g., a RTL dongle, USRP B2xx) can be taken from the host and given to the VM. Select any devices you would like to use in the VM under Devices/USB.


=== Testing With a RTL Dongle ===
=== Testing With a RTL Dongle ===
Plug a RTL dongle into the host. Select USB forwarding for "Realtek RTL ..." under Devices/USB.
Open a terminal (Terminator is the icon with 4 red boxes). Run
  dmesg
and make sure that the log shows the Realtek device being discovered. Now run
  rtl_test
which should print out status, and then appear to hang. CTRL-C to stop.
== Tools ==
=== GQRX ===
The fastest way to see something interesting using a real SDR device is to run GQRX (icon that looks like a pulse). Select the RTL device from the initial dialog, or from I/O devices (second icon on the menu bar). GQRX remembers the last device and settings used. If the available devices have changed (or even appear that way in the VM), it may not start up cleanly. In this case, try it a couple of times and you should be able to select the device/setting you want.
More information on GQRX is available here: https://gqrx.dk/
=== Inspectrum ===
Inspectrum is an easy-to-use FFT viewer for multiple file formats (determined by the file suffix). See: https://github.com/miek/inspectrum.
=== URH ===
Universal Radio Hacker is an end-to-end RF reverse engineering tool. It can capture, demodulate, analyze and generate bursts representing digital communication. There is a bit of a learning curve due to the amount of ground it covers, but it's worth the effort. See: https://github.com/jopohl/urh.

Latest revision as of 16:13, 9 October 2020

An Ubuntu 20.04 virtual machine image with GNU Radio 3.8.2.0, Fosphor, GQRX, and several other useful pieces of software.

The most recent image is instant-gnuradio-3.8.2.0-1.0.0.ova and is a 3.4 GB download and 11 GB once installed and launched.

There is a torrent available: https://gnuradio.inpha.se/instant-gnuradio-3.8.2.0-1.0.0.ova.torrent

If you can't use the torrent (which would be load balancing, including using GNU Radio's server), you can also download from https://www.gnuradio.org/releases/ , but that might be slower.

The VM is built with Instant GNU Radio. If there are any issues, please report them here. You can also use the VM as a base for your own builds. See the VM, created for the GRCon workshop on satellite communications as an example.


Using VirtualBox

https://www.virtualbox.org/wiki/Downloads

Installing the VirtualBox Extension Pack

This is needed for USB 3 and is a requirement for running the VM, even if you are not actually going to use USB 3.

Assuming your host is running Ubuntu,

 sudo apt install virtualbox-ext-pack

Or available via https://www.virtualbox.org/wiki/Downloads. If downloading manually, make sure the extension pack version number matches the VirtualBox version number. Distributions do not always use the latest version. Installation is under File/Preferences/Extensions.

Importing the Image

OVA files are loaded into VirtualBox under File/Import Appliance. Use default answers to any dialogs. Once the OVA is loaded it will show up in the list of available images in VirtualBox.

Running the Image

Select the image and hit the "Start" button. Log in when prompted. The screen will start off at low resolution. Select a more useful resolution under View/Virtual Screen 1. For High DPI monitors, you may want to select a scaling factor under the same menu.

If the image fails to boot, and the error dialog "Details" mention xHCI, then the extension pack was most likely not installed correctly.

The VM uses a persistent disk image, (1) your preferences and work will be saved, and (2) it is best to shut down the VM as if it were a real computer to avoid loss of work.

GNU Radio Companion

The first icon in the app menu (the GNU Radio logo) will start GRC.

USB Devices

Passing Through USB Devices

Host USB devices (e.g., a RTL dongle, USRP B2xx) can be taken from the host and given to the VM. Select any devices you would like to use in the VM under Devices/USB.

Testing With a RTL Dongle

Plug a RTL dongle into the host. Select USB forwarding for "Realtek RTL ..." under Devices/USB.

Open a terminal (Terminator is the icon with 4 red boxes). Run

 dmesg

and make sure that the log shows the Realtek device being discovered. Now run

 rtl_test

which should print out status, and then appear to hang. CTRL-C to stop.

Tools

GQRX

The fastest way to see something interesting using a real SDR device is to run GQRX (icon that looks like a pulse). Select the RTL device from the initial dialog, or from I/O devices (second icon on the menu bar). GQRX remembers the last device and settings used. If the available devices have changed (or even appear that way in the VM), it may not start up cleanly. In this case, try it a couple of times and you should be able to select the device/setting you want.

More information on GQRX is available here: https://gqrx.dk/

Inspectrum

Inspectrum is an easy-to-use FFT viewer for multiple file formats (determined by the file suffix). See: https://github.com/miek/inspectrum.

URH

Universal Radio Hacker is an end-to-end RF reverse engineering tool. It can capture, demodulate, analyze and generate bursts representing digital communication. There is a bit of a learning curve due to the amount of ground it covers, but it's worth the effort. See: https://github.com/jopohl/urh.