GNU Radio Live SDR Environment: Difference between revisions

From GNU Radio
Jump to navigation Jump to search
(Imported from Redmine)
 
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
= GNU Radio Live SDR Environment =
The GNU Radio Live SDR Environment, produced by [http://corganlabs.com Corgan Labs], is a bootable Ubuntu Linux DVD or USB drive image, with GNU Radio and third party software pre-installed. It is designed for quick and easy testing and experimentation with GNU Radio without having to make any permanent modifications to a PC or laptop. It does not, however, provide for permanent installation.
The GNU Radio Live SDR Environment, produced by [http://corganlabs.com Corgan Labs], is a bootable Ubuntu Linux DVD or USB drive image, with GNU Radio and third party software pre-installed. It is designed for quick and easy testing and experimentation with GNU Radio without having to make any permanent modifications to a PC or laptop. It does not, however, provide for permanent installation.


Line 7: Line 5:
== Current Stable Release ==
== Current Stable Release ==


This version of the ISO image is based on the latest stable release of GNU Radio, 3.7.10.1, and the stable releases of third party software at that time:
Distribution of the GNU Radio Live SDR is currently retired. We are looking into creating new images based on newer releases.
 
http://s3-dist.gnuradio.org/ubuntu-14.04.5-desktop-amd64-gnuradio-3.7.10.1.torrent
 
The use of Bittorrent reduces the load on the GNU Radio web server and lowers project bandwidth costs.
 
If a Bittorrent client is not available or its use is restricted, you may download the ISO image file by choosing from one of the following mirror sites:
 
http://s3-dist.gnuradio.org/ubuntu-14.04.5-desktop-amd64-gnuradio-3.7.10.1.iso<br />
http://eu1-dist.gnuradio.org/s3/ubuntu-14.04.5-desktop-amd64-gnuradio-3.7.10.1.iso<br />
http://eu2-dist.gnuradio.org/ubuntu-14.04.5-desktop-amd64-gnuradio-3.7.10.1.iso
 
MD5 sum:
 
<pre>04028362ec84b39fd50e41164a48ac11  ubuntu-14.04.5-desktop-amd64-gnuradio-3.7.10.1.iso</pre>
The ISO image is signed by a GNU Radio PGP key and can be validated by checking the following signature:
 
http://s3-dist.gnuradio.org/ubuntu-14.04.5-desktop-amd64-gnuradio-3.7.10.1.iso.asc


== Contents ==
== Contents ==


The livesdr image is based on [http://www.ubuntu.com/desktop Ubuntu] Linux 14.04.5 LTS, 64-bit edition, and has additional software installed beyond the defaults supplied by Ubuntu.
The livesdr image is based on [http://www.ubuntu.com/desktop Ubuntu] Linux 16.04.2 LTS, 64-bit edition, and has additional software installed beyond the defaults supplied by Ubuntu.


=== GNU Radio ===
=== GNU Radio ===


GNU Radio Release 3.7.10.1 is installed on the livesdr image. You can access the GNU Radio Companion through the desktop link, or open a terminal window to execute GNU Radio applications.
GNU Radio Release 3.7.11 is installed on the livesdr image. You can access the GNU Radio Companion through the desktop link, or open a terminal window to execute GNU Radio applications.


=== Pre-Installed SDR Hardware Drivers ===
=== Pre-Installed SDR Hardware Drivers ===
Line 38: Line 19:
Drivers for these GNU Radio-compatible SDR peripherals have been pre-installed:
Drivers for these GNU Radio-compatible SDR peripherals have been pre-installed:


* [http://ettus.com Ettus Research] [http://code.ettus.com/redmine/ettus/projects/uhd/wiki UHD] <code>release_003_009_004</code>
* [http://ettus.com Ettus Research] [http://code.ettus.com/redmine/ettus/projects/uhd/wiki UHD] <code>release_003_009_006</code>
* [http://greatscottgadgets.com/hackrf/ Great Scott Gadgets] [https://github.com/mossmann/hackrf/wiki HackRF products]  
* [http://greatscottgadgets.com/hackrf/ Great Scott Gadgets] [https://github.com/mossmann/hackrf/wiki HackRF products]  
* [http://nuand.com/ Nuand] [https://github.com/nuand/bladeRF/wiki bladeRF products]
* [http://nuand.com/ Nuand] [https://github.com/nuand/bladeRF/wiki bladeRF products]
* osmoSDR [http://sdr.osmocom.org/trac/wiki/rtl-sdr RTL-SDR] driver
* osmoSDR [http://sdr.osmocom.org/trac/wiki/rtl-sdr RTL-SDR] driver
* AirSpy http://airspy.com/&quot;:http://airspy.com/
* AirSpy http://airspy.com/":http://airspy.com/


Each of these provides its own set of utilities and files. Please consult the manufacturers' documentation for more information.
Each of these provides its own set of utilities and files. Please consult the manufacturers' documentation for more information.
Line 50: Line 31:
There are many 3rd-party applications, demos, drivers, and block libraries produced by the GNU Radio community. Below is a list of pre-installed packages that highlight some of the diverse capabilities of GNU Radio:
There are many 3rd-party applications, demos, drivers, and block libraries produced by the GNU Radio community. Below is a list of pre-installed packages that highlight some of the diverse capabilities of GNU Radio:


* [http://sdr.osmocom.org/trac/wiki/GrOsmoSDR <code>gr-osmosdr</code>], a set of blocks supporting various hardware SDRs and applications, and related dependencies
* [http://sdr.osmocom.org/trac/wiki/GrOsmoSDR gr-osmosdr], a set of blocks supporting various hardware SDRs and applications, and related dependencies
* [http://sdr.osmocom.org/trac/wiki/fosphor <code>gr-fosphor</code>], a GPU-accelerated real-time spectrum analyzer display
* [http://sdr.osmocom.org/trac/wiki/fosphor gr-fosphor], a GPU-accelerated real-time spectrum analyzer display
* [http://gqrx.dk <code>gqrx</code>], a narrowband SDR receiver application by Alexandru Csete
* [http://gqrx.dk gqrx], a narrowband SDR receiver application by Alexandru Csete
* [http://gnss-sdr.org <code>GNSS-SDR</code>], a fully software-based GPS, Galileo, and GLONASS real time receiver
* [http://gnss-sdr.org GNSS-SDR], a fully software-based GPS, Galileo, and GLONASS real time receiver
* [https://github.com/kit-cel/gr-specest <code>gr-specest</code>], an implementation of several spectral estimation algorithms
* [https://github.com/kit-cel/gr-specest gr-specest], an implementation of several spectral estimation algorithms
* [http://sourceforge.net/projects/openlte/ <code>OpenLTE</code>], an open source 3GPP LTE implementation
* [http://sourceforge.net/projects/openlte/ OpenLTE], an open source 3GPP LTE implementation
* [https://github.com/stwunsch/gr-nacl <code>gr-nacl</code>], wrapper blocks around NaCL encryption library
* [https://github.com/stwunsch/gr-nacl gr-nacl], wrapper blocks around NaCL encryption library
* [https://github.com/antoinet/gr-acars2 <code>gr-acars2</code>]
* [https://github.com/antoinet/gr-acars2 gr-acars2]
* [https://github.com/wnagele/gr-adsb <code>gr-adsb</code>], an ADS-B modem
* [https://github.com/wnagele/gr-adsb gr-adsb], an ADS-B modem
* [https://github.com/kit-cel/gr-specest <code>gr-ais&quot;:https://github.com/bistromath/gr-ais, an AIS modem
* [https://github.com/bistromath/gr-ais gr-ais], an AIS modem
* &quot;</code>gr-ax25<code>&quot;:https://github.com/dl1ksv/gr-ax25
* [https://github.com/dl1ksv/gr-ax25 gr-ax25], AX25
* &quot;</code>gr-burst<code>&quot;:https://github.com/gr-vt/gr-burst, a burst PSK modem
* [https://github.com/gr-vt/gr-burst gr-burst], a burst PSK modem
* &quot;</code>gr-cdma<code>&quot;:https://github.com/anastas/gr-cdma, a CDMA phy
* [https://github.com/anastas/gr-cdma gr-cdma], a CDMA phy
* &quot;</code>gr-eventstream<code>&quot;:https://oshearesearch.com/tag/gr-eventstream/
* [https://oshearesearch.com/tag/gr-eventstream/ gr-eventstream]
* &quot;</code>gr-gsm<code>&quot;:https://github.com/ptrkrysik/gr-gsm, blocks and tools for receiving GSM transmissions
* [https://github.com/ptrkrysik/gr-gsm gr-gsm], blocks and tools for receiving GSM transmissions
* &quot;</code>gr-ieee-80211<code>&quot;:https://github.com/bastibl/gr-ieee802-11, an IEEE 802.11a/g/p transceiver
* [https://github.com/bastibl/gr-ieee802-11 gr-ieee-80211], an IEEE 802.11a/g/p transceiver
* &quot;</code>gr-ldpc<code>&quot;:https://github.com/manuts/gr-ldpc, an implementation of generic LDPC codecs
* [https://github.com/manuts/gr-ldpc gr-ldpc], an implementation of generic LDPC codecs
* &quot;</code>gr-lte<code>&quot;:https://github.com/kit-cel/gr-lte, an implementation of a 3GPP LTE receiver
* [https://github.com/kit-cel/gr-lte gr-lte], an implementation of a 3GPP LTE receiver
* &quot;</code>gr-mapper<code>&quot;:https://github.com/gr-vt/gr-mapper, extra symbol/bit mapping tools
* [https://github.com/gr-vt/gr-mapper gr-mapper], extra symbol/bit mapping tools
* &quot;</code>gr-paint<code>&quot;:https://github.com/drmpeg/gr-paint, spectrum painting block
* [https://github.com/drmpeg/gr-paint gr-paint], spectrum painting block
* &quot;</code>gr-radar<code>&quot;:https://github.com/kit-cel/gr-radar, the GNU Radio Radar Toolbox
* [https://github.com/kit-cel/gr-radar gr-radar], the GNU Radio Radar Toolbox
* &quot;</code>gr-rds<code>&quot;:https://github.com/bastibl/gr-rds, an implementation of broadcast FM radio RDS reception
* [https://github.com/bastibl/gr-rds gr-rds], an implementation of broadcast FM radio RDS reception
* &quot;</code>gr-specest@], Spectrum estimation blocks
* [https://github.com/kit-cel/gr-specest gr-specest], Spectrum estimation blocks


Each of these packages has been installed using the GNU Radio PyBOMBS installation utility. Please consult the individual project sites for information on using these applications.
Each of these packages has been installed using the GNU Radio PyBOMBS installation utility. Please consult the individual project sites for information on using these applications.
Line 80: Line 61:
Since the operating system must use a RAM drive to simulate a hard drive, it is strongly recommended that your system have at least 4GB of RAM when using the live image.
Since the operating system must use a RAM drive to simulate a hard drive, it is strongly recommended that your system have at least 4GB of RAM when using the live image.


Once a DVD has been created using the ISO image linked above, one boots directly into Linux from the DVD by inserting the DVD into a drive, rebooting the PC, and either:
Once a DVD or USB drive has been created using the ISO image linked above, one boots directly into Linux from the DVD or drive by either:


* Accessing the PC boot device menu and selecting &quot;Boot from CD/DVD Drive&quot; (typically by pressing F12, but may be something else), or
* Accessing the PC boot device menu and selecting booting from alternate media (typically by pressing F12, but may be something else), or
* Updating the PC BIOS configuration to allow booting from DVD. The PC BIOS is typically entered by pressing F2 during startup, but this varies between systems.
* Updating the PC BIOS configuration to configure booting from a DVD or USB. The PC BIOS is typically entered by pressing F2 during startup, but this varies between systems.


The booting process, depending on the speed of the DVD drive, may take 2-3 minutes or more to complete, and will automatically log into the Ubuntu desktop screen as user 'ubuntu'. From here, you can select software to run with the mouse, or may create a terminal window using the Ctrl-Alt-T shortcut key. The logged in user can obtain administrative rights by using the 'sudo' command; it does not require a password.
The booting process, depending on the speed of the drive, may take 2-3 minutes or more to complete, and will automatically log into the Ubuntu desktop screen as user 'ubuntu'. From here, you can select software to run with the mouse, or may create a terminal window using the Ctrl-Alt-T shortcut key. The logged in user can obtain administrative rights by using the 'sudo' command; it does not require a password.


Notes:
Notes:
Line 91: Line 72:
* When operating from the liveSDR image, the first time an operation is performed, the software loads from the boot media, and can appear very slow. However, at this point, the software remains cached in memory, and subsequent execution will be at normal speed.
* When operating from the liveSDR image, the first time an operation is performed, the software loads from the boot media, and can appear very slow. However, at this point, the software remains cached in memory, and subsequent execution will be at normal speed.


* It is important to ensure that once the DVD boots, that any needed network connections, audio configuration, or other hardware specific configuration is done (if needed), prior to running the included SDR applications.
* It is important to ensure that once the drive boots, that any needed network connections, audio configuration, or other hardware specific configuration is done (if needed), prior to running the included SDR applications.


* If your CPU supports automatic frequency scaling, the DVD will boot up in &quot;on demand&quot; mode, which will leave the CPU at a lower frequency until system load increases. However, this process doesn't not always occur correctly. You may use the frequency scaling widget in the upper right corner in order to set a specific CPU frequency, or to set &quot;performance&quot; mode.
* If your CPU supports automatic frequency scaling, the DVD will boot up in "on demand" mode, which will leave the CPU at a lower frequency until system load increases. However, this process doesn't not always occur correctly. You may use the frequency scaling widget in the upper right corner in order to set a specific CPU frequency, or to set "performance" mode.


== Network Configuration on the Live Image ==
== Network Configuration on the Live Image ==
Line 99: Line 80:
The system has been pre-configured to use one of two network configurations when an Ethernet cable is plugged into the network port of the PC. This is accessed by clicking on the network configuration icon in the upper right configuration bar.
The system has been pre-configured to use one of two network configurations when an Ethernet cable is plugged into the network port of the PC. This is accessed by clicking on the network configuration icon in the upper right configuration bar.


* Under &quot;Wired Network&quot;, select &quot;Internet (DHCP assigned)&quot; to allow the PC to obtain its network configuration from the connected LAN
* Under "Wired Network", select "Internet (DHCP assigned)" to allow the PC to obtain its network configuration from the connected LAN
* For use with the [http://ettus.com Ettus Research] USRP N-series devices, choose &quot;USRP&quot; from the selections, which will assign the IP address of 192.168.10.1 to the host PC and allow communication with the default IP configuration of a USRP. In this configuration, in order to access an external network, an alternative interface must be available, such a Wireless network or second Ethernet port.
* For use with the [http://ettus.com Ettus Research] USRP N- or X-series devices, choose "USRP" from the selections, which will assign the IP address of 192.168.10.1 to the host PC and allow communication with the default IP configuration of a USRP. In this configuration, in order to access an external network, an alternative interface must be available, such a Wireless network or second Ethernet port.


== Installation Locations on the DVD ==
== Installation Locations ==


The GNU Radio software source code, as well as the source code to other installed software, is installed in <code>/home/ubuntu/src/</code>, which may be browsed from the filesystem explorer or from the command line.
The GNU Radio software source code, as well as the source code to other installed software, is installed in <code>/home/ubuntu/src/</code>, which may be browsed from the filesystem explorer or from the command line.

Latest revision as of 22:06, 2 February 2019

The GNU Radio Live SDR Environment, produced by Corgan Labs, is a bootable Ubuntu Linux DVD or USB drive image, with GNU Radio and third party software pre-installed. It is designed for quick and easy testing and experimentation with GNU Radio without having to make any permanent modifications to a PC or laptop. It does not, however, provide for permanent installation.

It is supplied as an ISO image to be downloaded and burned onto a recordable DVD disc or copied to a USB flash drive using a utility such as the Ubuntu Startup Disk Creator (Ubuntu Linux OS) or Unetbootin (Windows, MacOS, Linux). Creating a USB drive from the image will provide much faster booting and operation, and allow making changes and storing files. Finally, the ISO image may be booted within a virtual environment such as VirtualBox, QEMU/kvm, VMware, or Parallels.

Current Stable Release

Distribution of the GNU Radio Live SDR is currently retired. We are looking into creating new images based on newer releases.

Contents

The livesdr image is based on Ubuntu Linux 16.04.2 LTS, 64-bit edition, and has additional software installed beyond the defaults supplied by Ubuntu.

GNU Radio

GNU Radio Release 3.7.11 is installed on the livesdr image. You can access the GNU Radio Companion through the desktop link, or open a terminal window to execute GNU Radio applications.

Pre-Installed SDR Hardware Drivers

Drivers for these GNU Radio-compatible SDR peripherals have been pre-installed:

Each of these provides its own set of utilities and files. Please consult the manufacturers' documentation for more information.

Pre-Installed GNU Radio Applications

There are many 3rd-party applications, demos, drivers, and block libraries produced by the GNU Radio community. Below is a list of pre-installed packages that highlight some of the diverse capabilities of GNU Radio:

  • gr-osmosdr, a set of blocks supporting various hardware SDRs and applications, and related dependencies
  • gr-fosphor, a GPU-accelerated real-time spectrum analyzer display
  • gqrx, a narrowband SDR receiver application by Alexandru Csete
  • GNSS-SDR, a fully software-based GPS, Galileo, and GLONASS real time receiver
  • gr-specest, an implementation of several spectral estimation algorithms
  • OpenLTE, an open source 3GPP LTE implementation
  • gr-nacl, wrapper blocks around NaCL encryption library
  • gr-acars2
  • gr-adsb, an ADS-B modem
  • gr-ais, an AIS modem
  • gr-ax25, AX25
  • gr-burst, a burst PSK modem
  • gr-cdma, a CDMA phy
  • gr-eventstream
  • gr-gsm, blocks and tools for receiving GSM transmissions
  • gr-ieee-80211, an IEEE 802.11a/g/p transceiver
  • gr-ldpc, an implementation of generic LDPC codecs
  • gr-lte, an implementation of a 3GPP LTE receiver
  • gr-mapper, extra symbol/bit mapping tools
  • gr-paint, spectrum painting block
  • gr-radar, the GNU Radio Radar Toolbox
  • gr-rds, an implementation of broadcast FM radio RDS reception
  • gr-specest, Spectrum estimation blocks

Each of these packages has been installed using the GNU Radio PyBOMBS installation utility. Please consult the individual project sites for information on using these applications.

Using the GNU Radio Live Image

Since the operating system must use a RAM drive to simulate a hard drive, it is strongly recommended that your system have at least 4GB of RAM when using the live image.

Once a DVD or USB drive has been created using the ISO image linked above, one boots directly into Linux from the DVD or drive by either:

  • Accessing the PC boot device menu and selecting booting from alternate media (typically by pressing F12, but may be something else), or
  • Updating the PC BIOS configuration to configure booting from a DVD or USB. The PC BIOS is typically entered by pressing F2 during startup, but this varies between systems.

The booting process, depending on the speed of the drive, may take 2-3 minutes or more to complete, and will automatically log into the Ubuntu desktop screen as user 'ubuntu'. From here, you can select software to run with the mouse, or may create a terminal window using the Ctrl-Alt-T shortcut key. The logged in user can obtain administrative rights by using the 'sudo' command; it does not require a password.

Notes:

  • When operating from the liveSDR image, the first time an operation is performed, the software loads from the boot media, and can appear very slow. However, at this point, the software remains cached in memory, and subsequent execution will be at normal speed.
  • It is important to ensure that once the drive boots, that any needed network connections, audio configuration, or other hardware specific configuration is done (if needed), prior to running the included SDR applications.
  • If your CPU supports automatic frequency scaling, the DVD will boot up in "on demand" mode, which will leave the CPU at a lower frequency until system load increases. However, this process doesn't not always occur correctly. You may use the frequency scaling widget in the upper right corner in order to set a specific CPU frequency, or to set "performance" mode.

Network Configuration on the Live Image

The system has been pre-configured to use one of two network configurations when an Ethernet cable is plugged into the network port of the PC. This is accessed by clicking on the network configuration icon in the upper right configuration bar.

  • Under "Wired Network", select "Internet (DHCP assigned)" to allow the PC to obtain its network configuration from the connected LAN
  • For use with the Ettus Research USRP N- or X-series devices, choose "USRP" from the selections, which will assign the IP address of 192.168.10.1 to the host PC and allow communication with the default IP configuration of a USRP. In this configuration, in order to access an external network, an alternative interface must be available, such a Wireless network or second Ethernet port.

Installation Locations

The GNU Radio software source code, as well as the source code to other installed software, is installed in /home/ubuntu/src/, which may be browsed from the filesystem explorer or from the command line.

The GNU Radio Companion application is installed as grc on the system path, and may be run from any directory, or may be accessed directly from the desktop by clicking on the icon.

GNU Radio example applications are installed in /home/ubuntu/examples and may be run by navigating to one of the example directories and executing the python scripts using the syntax ./foo.py, where foo.py is the name of the example program, or using GRC to load and execute the GRC-based examples.