[hamradio-commits] [gnss-sdr] 04/20: Update PyBOMBS instructions

Thu Jun 30 20:08:58 UTC 2016

This is an automated email from the git hooks/post-receive script.

carles_fernandez-guest pushed a commit to branch master
in repository gnss-sdr.

commit dc476338232eb542305c56b4254132b9c38dcda5
Author: Carles Fernandez <carles.fernandez at gmail.com>
Date:   Sat May 21 12:31:46 2016 +0200

    Update PyBOMBS instructions
    
    also fixes documentation related to RTCM parameters
---
 README.md | 82 +++++++++++++++++++++++++++++++++++++++++++++------------------
 1 file changed, 59 insertions(+), 23 deletions(-)

diff --git a/README.md b/README.md
index ccad04e..d989084 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,11 @@ GNU/Linux
 
 Older distribution releases might work as well, but you will need GCC 4.7 or newer.
 
-Before building GNSS-SDR, you need to install all the required dependencies. If you are using Debian 8, Ubuntu 14.10 or above, this can be done by copying and pasting the following line in a terminal:
+Before building GNSS-SDR, you need to install all the required dependencies. There are two alternatives here: through software packages or building them from the source code. It is in general not a good idea to mix both approaches.
+
+### Alternative 1: Install dependencies using software packages
+
+If you want to start building and running GNSS-SDR as quick and easy as possible, the best option is to install all the required dependencies as binary packages. If you are using Debian 8, Ubuntu 14.10 or above, this can be done by copying and pasting the following line in a terminal:
 
 ~~~~~~ 
 $ sudo apt-get install build-essential cmake git libboost-dev libboost-date-time-dev \
@@ -50,37 +54,67 @@ $ sudo apt-get update
 $ sudo apt-get build-dep gnss-sdr
 ~~~~~~ 
 
-Once you have installed these packages, you can jump directly to [how to download the source code and build GNSS-SDR](#download-and-build-linux). Otherwise, if you need to manually build and install those libraries, please keep reading.
+Once you have installed these packages, you can jump directly to [how to download the source code and build GNSS-SDR](#download-and-build-linux). 
 
 Note for Ubuntu 14.04 LTS "trusty" users: you will need to build from source and install GNU Radio manually, as explained below, since GNSS-SDR requires gnuradio-dev >= 3.7.3, and Ubuntu 14.04 came with 3.7.2. Install all the packages above BUT EXCEPT ```libuhd-dev```, ```gnuradio-dev``` and ```gr-osmosdr``` (and remove them if they are already installed in your machine), and install those dependencies using PyBOMBS.
 
-### Manual installation of GNU Radio
 
-Downloading, building and installing [GNU Radio](http://gnuradio.org/redmine/projects/gnuradio/wiki "GNU Radio's Homepage") and all its dependencies is not a simple task. We recommend to use [PyBOMBS](http://gnuradio.org/pybombs "Python Build Overlay Managed Bundle System wiki") (Python Build Overlay Managed Bundle System), the GNU Radio install management system that automatically does all the work for you. In a terminal, type:
+### Alternative 2: Install dependencies using PyBOMBS
 
-~~~~~~
-$ git clone https://github.com/gnuradio/pybombs.git
-$ cd pybombs
-$ python setup.py build
-$ sudo python setup.py install
-$ pybombs recipes add gr-recipes https://github.com/gnuradio/gr-recipes.git
-$ pybombs recipes add gr-etcetera https://github.com/gnuradio/gr-etcetera.git
-$ sudo pybombs prefix init /usr/local -a myprefix
-$ pybombs config default_prefix myprefix
-$ pybombs install gnuradio gr-osmosdr armadillo glog
-~~~~~~
+This option is adequate if you are interested in development, in working with the most recent versions of software dependencies, want more fine tuning on the installed versions, or simply in building everything from the scratch just for the fun of it. In such cases, we recommend to use [PyBOMBS](http://gnuradio.org/pybombs "Python Build Overlay Managed Bundle System wiki") (Python Build Overlay Managed Bundle System), the GNU Radio install management system that automatically does all th [...]
+
+Fist of all, install some basic packages:
+
+~~~~~~ 
+$ sudo apt-get install git python-pip python-mako
+~~~~~~ 
+
+Download, build and install PyBOMBS:
+
+~~~~~~ 
+$ sudo pip install git+https://github.com/gnuradio/pybombs.git
+~~~~~~ 
+
+Add some software recipes (i.e., instructions on how to install software dependencies):
+
+~~~~~~ 
+$ pybombs recipes add gr-recipes git+https://github.com/gnuradio/gr-recipes.git
+$ pybombs recipes add gr-etcetera git+https://github.com/gnuradio/gr-etcetera.git
+~~~~~~ 
 
-Other installation and configuration options are available from https://github.com/gnuradio/pybombs
+Download, build and install GNU Radio, related drivers and some other extra modules into the directory ```/path/to/prefix``` (replace this path by your preferred one, for instance ```$HOME/sdr```):
+
+~~~~~~ 
+$ pybombs prefix init /path/to/prefix -a myprefix -R gnuradio-default
+~~~~~~ 
+
+This will perform a local installation of the dependencies under ```/path/to/prefix```, so they will not be visible when opening a new terminal. In order to make them available, you will need to set up the adequate environment variables:
+
+~~~~~~ 
+$ cd /path/to/prefix
+$ . ./setup_env.sh
+~~~~~~ 
+
+Now you are ready to use GNU Radio and to jump into building GNSS-SDR after installing Armadillo, GFlags and Glog. Actually, those are steps that PyBOMBS can do for you as well:
+
+~~~~~~ 
+$ pybombs install gnss-sdr
+~~~~~~ 
+
+By default, PyBOMBS installs the ‘next’ branch of GNSS-SDR development, which is the most recent version of the source code. This behaviour can be modified by altering the corresponding recipe at ```$HOME/.pybombs/recipes/gr-recipes/gnss-sdr.lwr``` 
+
+In case you do not want to use PyBOMBS and prefer to build and install GNSS-SDR step by step (i.e. cloning the repository and doing the usual ```cmake .. && make && make install``` dance), Armadillo, GFlags and Glog can be installed either by using PyBOMBS: 
+
+~~~~~~ 
+$ pybombs install armadillo gflags glog
+~~~~~~ 
 
-The last step can take some time (up to two hours to complete, depending on your system), and it downloads, builds and installs the latest versions of GNU Radio, related drivers and dependencies in your system.
+or manually as explained below, and then please follow instructions on how to [download the source code and build GNSS-SDR](#download-and-build-linux).
 
-In case you do not want to use PyBOMBS and prefer to build and install GNU Radio step by step, follow instructions at the [GNU Radio Build Guide](http://gnuradio.org/redmine/projects/gnuradio/wiki/BuildGuide). Other GNSS-SDR dependencies can be built and installed manually as explained below.
 
-    
-    
 ### Manual installation of other required dependencies
 
-#### Install the [Armadillo](http://arma.sourceforge.net/ "Armadillo's Homepage") C++ linear algebra library:
+#### Install [Armadillo](http://arma.sourceforge.net/ "Armadillo's Homepage"), a C++ linear algebra library:
 
 ~~~~~~
 $ sudo apt-get install libopenblas-dev liblapack-dev   # For Debian/Ubuntu/LinuxMint
@@ -1184,9 +1218,11 @@ PVT.dump_filename=./PVT
 $ gnss-sdr --RINEX_version=2
 ~~~~~~ 
 
-* **RTCM SC-104** provides standards that define the data structure for differential GNSS correction information for a variety of differential correction applications. Developed by the Radio Technical Commission for Maritime Services ([RTCM](http://www.rtcm.org/overview.php#Standards "Radio Technical Commission for Maritime Services")), they have become an industry standard for communication of correction information. GNSS-SDR implements RTCM version 3.2, defined in the document *RTCM 10 [...]
+* **RTCM SC-104** provides standards that define the data structure for differential GNSS correction information for a variety of differential correction applications. Developed by the Radio Technical Commission for Maritime Services ([RTCM](http://www.rtcm.org/overview.php#Standards "Radio Technical Commission for Maritime Services")), they have become an industry standard for communication of correction information. GNSS-SDR implements RTCM version 3.2, defined in the document *RTCM 10 [...]
 ~~~~~~ 
-$ gnss-sdr --RTCM_Port=12345 --RTCM_Ref_Station_ID=10
+PVT.flag_rtcm_server=true
+PVT.rtcm_tcp_port=2102
+PVT.rtcm_station_id=1111
 ~~~~~~ 
 
 **Important note:**

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-hamradio/gnss-sdr.git

