diff options
Diffstat (limited to 'installer')
| -rw-r--r-- | installer/README.md | 68 | ||||
| -rw-r--r-- | installer/debian.sh | 5 | ||||
| -rw-r--r-- | installer/gnuradio-livecd.sh | 184 |
3 files changed, 255 insertions, 2 deletions
diff --git a/installer/README.md b/installer/README.md new file mode 100644 index 0000000..45a2f32 --- /dev/null +++ b/installer/README.md @@ -0,0 +1,68 @@ +Installation scripts for ODR-mmbTools +===================================== + +This folder contains install scripts that simplify the compilation +and installation of the ODR-mmbTools + +Debian +------ + +The *debian.sh* script is designed to be run on debian wheezy or jessie, and installs + + * UHD + * ODR-mmbTools: + * ODR-DabMux + * ODR-DabMod + * auxiliary scripts + * the FDK-AAC-DABplus package + * Toolame-DAB + + +To use it, you have to: + + 1. Install debian on your machine + 1. apt-get install sudo and give your user the right to use sudo + 1. download the script to your home directory + 1. make it executable with chmod +x debian.sh + 1. run it with ./debian.sh + + +GNURadio LiveCD +--------------- + +This *gnuradio-livecd.sh* script can be used to install the ODR-mmbTools onto +the ubuntu live system offered by the GNURadio project. The following +explanations were given by Tobias Wallerius: + +The most convenient way for me was to use the official GNU Radio Live SDR +Environment (Ubuntu based), as it already contains a full GNU Radio +installation. I used version 2015-0623, but in the meantime 2015-0726 is +available. Download the ISO image of your preference. + +I wanted to be able to keep changes while running Linux from the USB drive, so +casper was also a requirement. An easy way to achieve this is to use the +Universal USB Installer to install the GNU Radio Ubuntu Image. + +### Installing the GNU Radio Live SDR Environment to a USB drive + + * Download the GNU Radio Live SDR Environment ISO image + * Make sure your USB drive is connected to your machine + * Start the Universal USB Installer executable + * For Step 1, select "Ubuntu" + * Select the ISO image in Step 2 with the Browse button + * In Step 3, select your USB drive letter + * With Step 4, make sure to enable persistence by selecting a file size for storage + * Click Create + +After the procedure finishes, you can reboot your machine from the USB drive. + +### Installing the ODR-mmbTools + +After you have the Ubuntu live system running, download and execute the +*gnuradio-livecd.sh* script: + + * Make sure your internet connection works + * Download the modified debian.sh install script from this post + * Make it executable using chmod +x gnuradio-livecd.sh + * On your console, start the install script with ./gnuradio-livecd.sh + diff --git a/installer/debian.sh b/installer/debian.sh index a9ada7d..e4d2d06 100644 --- a/installer/debian.sh +++ b/installer/debian.sh @@ -6,7 +6,8 @@ # * ODR-DabMux # * ODR-DabMod # * auxiliary scripts -# * the FDK-AAC-DABplus package +# * the FDK-AAC-DABplus package +# * Toolame-DAB # # and all required dependencies for a # Debian stable and oldstable system. @@ -29,7 +30,7 @@ echo echo "This is the mmbTools installer script for debian" echo "================================================" echo -echo "It will install UHD, dabmux, dabmod, fdk-aac-dabplus" +echo "It will install ODR-DabMux, ODR-DabMod, FDK-AAC-DABplus, Toolame-dab" echo "and all prerequisites to your machine." echo $DISTRO diff --git a/installer/gnuradio-livecd.sh b/installer/gnuradio-livecd.sh new file mode 100644 index 0000000..e08ab82 --- /dev/null +++ b/installer/gnuradio-livecd.sh @@ -0,0 +1,184 @@ +#!/bin/bash +# +# Installer script for the ubuntu live system offered by GNURadio +# * ODR-mmbTools: +# * ODR-DabMux +# * ODR-DabMod +# * auxiliary scripts +# * the FDK-AAC-DABplus package +# * Toolame-DAB +# +# +# Requires: sudo, UHD already installed, with all -dev packages too for +# boost and zeromq and maybe others + +RED="\e[91m" +GREEN="\e[92m" +NORMAL="\e[0m" + +echo +echo "This is the mmbTools installer script for the GNURadio live system" +echo "==================================================================" +echo +echo "It will install ODR-DabMux, ODR-DabMod, FDK-AAC-DABplus, Toolame-dab" +echo "and all prerequisites to your machine." + + +echo -e $RED +echo "This program will use sudo to install components on your" +echo "system. Please read the script before you execute it, to" +echo "understand what changes it will do to your system !" +echo +echo "There is no undo functionality here !" +echo -e $NORMAL + +if [ "$UID" == "0" ] +then + echo -e $RED + echo "Do not run this script as root !" + echo -e $NORMAL + echo "Install sudo, and run this script as a normal user." + exit 1 +fi + +which sudo +if [ "$?" == "0" ] +then + echo "Press Ctrl-C to abort installation" + echo "or Enter to proceed" + + read +else + echo -e $RED + echo -e "Please install sudo first $NORMAL using" + echo " apt-get -y install sudo" + exit 1 +fi + +# Fail on error +set -e + +if [ -d dab ] +then + echo -e $RED + echo "ERROR: The dab directory already exists." + echo -e $NORMAL + echo "This script assumes a fresh initialisation," + echo "if you have already run it and wish to update" + echo "the existing installation, please do it manually" + echo "or erase the dab folder first." + exit 1 +fi + +echo -e "$GREEN Updating ubuntu package repositories $NORMAL" +sudo apt-get -y --force-yes update + +echo -e "$GREEN Installing essential prerquisites $NORMAL" +# some essential and less essential prerequisistes +sudo apt-get -y --force-yes install build-essential git wget \ + sox alsa-tools alsa-utils \ + automake libtool mpg123 \ + libasound2 libasound2-dev \ + libjack-jackd2-dev jackd2 \ + ncdu vim ntp links cpufrequtils \ + libfftw3-dev \ + libmagickwand-dev \ + libvlc-dev vlc-nox \ + libfaad2 libfaad-dev + +# since this is the GNURadio live-CD, most UHD and related dependencies (boost, +# cmake, zeromq and a lot more) are already installed + + +# stuff to install from source +mkdir dab || exit +cd dab || exit + + +echo -e "$GREEN Installing KA9Q libfec $NORMAL" +git clone https://github.com/Opendigitalradio/ka9q-fec.git +pushd ka9q-fec +./bootstrap +./configure +make +sudo make install +popd + +echo +echo -e "$GREEN PREREQUISITES INSTALLED $NORMAL" +### END OF PREREQUISITES + +echo -e "$GREEN Fetching mmbtools-aux $NORMAL" +git clone https://github.com/mpbraendli/mmbtools-aux.git + +echo -e "$GREEN Fetching etisnoop $NORMAL" +git clone https://github.com/Opendigitalradio/etisnoop.git +pushd etisnoop +make +popd + +echo -e "$GREEN Compiling ODR-DabMux $NORMAL" +git clone https://github.com/Opendigitalradio/ODR-DabMux.git +pushd ODR-DabMux +./bootstrap.sh +./configure --enable-input-zeromq --enable-output-zeromq +make +sudo make install +popd + +echo -e "$GREEN Compiling ODR-DabMod $NORMAL" +git clone https://github.com/Opendigitalradio/ODR-DabMod.git +pushd ODR-DabMod +./bootstrap.sh +./configure --enable-zeromq --enable-fft-simd +make +sudo make install +popd + + +echo -e "$GREEN Compiling Toolame-DAB $NORMAL" +git clone https://github.com/Opendigitalradio/toolame-dab.git +pushd toolame-dab +make +sudo cp toolame /usr/local/bin/toolame +popd + +echo -e "$GREEN Compiling FDK-AAC-DABplus $NORMAL" +git clone https://github.com/Opendigitalradio/fdk-aac-dabplus.git +pushd fdk-aac-dabplus +./bootstrap +./configure --enable-jack --enable-vlc +make +sudo make install +popd + + +echo -e "$GREEN Updating ld cache $NORMAL" +# update ld cache +sudo ldconfig + + +echo -e "$GREEN Done installing all tools $NORMAL" +echo -e "All the tools have been dowloaded to the dab/ folder," +echo -e "compiled and installed to /usr/local" +echo +echo -e "The stable versions have been compiled, i.e. the latest" +echo -e "'master' branch from the git repositories" +echo +echo -e "If you know there is a new release, and you want to update," +echo -e "you have to go to the folder containing the tool, pull" +echo -e "the latest changes from the repository and recompile" +echo -e "it manually." +echo +echo -e "To pull the latest changes for ODR-DabMux, use:" +echo -e " cd ~/dab/ODR-DabMux" +echo -e " git pull" +echo -e " ./bootstrap.sh" +echo -e " ./configure --enable-input-zeromq --enable-output-zeromq" +echo -e " make" +echo -e " sudo make install" +echo +echo -e "This example should give you the idea. For the options" +echo -e "for compiling the other tools, please see in the gnuradio-livecd.sh" +echo -e "script what options are used. Please also read the README" +echo -e "and INSTALL files in the repositories." |