bastibl / instant-gnuradio

Customizable GNU Radio Environment for Live Images and VMs
158 stars 34 forks source link
gnuradio gqrx sdr ubuntu

Instant GNU Radio

A customizable, programmatically generated VM and live environment for GNU Radio. Download the VM and get started!

Screenshot

Requirements

Main Features

Credentials

user: sdr
password: sdr

SSH Login

ssh -p2222 sdr@localhost

Password is sdr.

You might want to add something like this to your SSH config (~/.ssh/config):

Host vm
    Hostname localhost
    User sdr
    Port 2222
    UserKnownHostsFile /dev/null
    StrictHostKeyChecking no

With this config, you can login with ssh vm and your password.

VMWare

VirtualBox and VMWare use different network interfaces, which results in different names for the Ethernet controller. If the network is not automatically configured use ip link show to figure out the device name of the interface and adapt the ethernets section of /etc/netplan/01-netcfg.yaml accordingly.

Customization

If you want to rebuild and customize the environment, read on...

Prerequisites

Instant GNU Radio requires packer and VirtualBox including the Extension Pack.

On Debian-like systems, the following packets will do the trick:

sudo apt install packer
sudo apt install virtualbox virtualbox-ext-pack

On Ubuntu, your user should be in the vboxusers group.

sudo usermod -a -G vboxusers <your username>

You have to logout and login again for the changes to take effect.

Create Image

Note: You have to be online to build the image.

Then, just run:

configure

to check if all dependencies are satisfied. Once configure has successfully run, type

make

to build the virtual machine. The output will be in the vms/ directory.

Note that there is a base file and a sdr file. If you make changes to your sdr.json you can save time by only rebuilding the latter by running make sdr.

Customizing the Virtual Machines

VM configurations are defined in the packer configuration files base.json and sdr.json.

More information on how to customize the virtual machines can be found on the packer website.

Live Image

TBD. See the gen_iso.sh and chroot.sh script.

More Screenshots

Screenshot Screenshot Screenshot