1
0
mirror of https://github.com/gnss-sdr/gnss-sdr synced 2024-12-13 19:50:34 +00:00

Improve README files

This commit is contained in:
Carles Fernandez 2020-05-16 16:11:50 +02:00
parent 35ee34673a
commit a73e08c017
No known key found for this signature in database
GPG Key ID: 4C583C52B0C3877D
2 changed files with 32 additions and 18 deletions

View File

@ -291,9 +291,9 @@ $ sudo apt-get install libblas-dev liblapack-dev # For Debian/Ubuntu/Linux
$ sudo yum install lapack-devel blas-devel # For Fedora/CentOS/RHEL $ sudo yum install lapack-devel blas-devel # For Fedora/CentOS/RHEL
$ sudo zypper install lapack-devel blas-devel # For OpenSUSE $ sudo zypper install lapack-devel blas-devel # For OpenSUSE
$ sudo pacman -S blas lapack # For Arch Linux $ sudo pacman -S blas lapack # For Arch Linux
$ wget https://sourceforge.net/projects/arma/files/armadillo-9.870.2.tar.xz $ wget https://sourceforge.net/projects/arma/files/armadillo-9.880.1.tar.xz
$ tar xvfz armadillo-9.870.2.tar.xz $ tar xvfz armadillo-9.880.1.tar.xz
$ cd armadillo-9.870.2 $ cd armadillo-9.880.1
$ cmake . $ cmake .
$ make $ make
$ sudo make install $ sudo make install

View File

@ -49,7 +49,7 @@ baseband processor:
![Example of VOLK_GNSSSDR ![Example of VOLK_GNSSSDR
usage.](./docs/images/VOLK_GNSSSDR_Usage_Example.png) usage.](./docs/images/VOLK_GNSSSDR_Usage_Example.png)
## How to build VOLK_GNSSSDR: ## How to build VOLK_GNSSSDR
This library is automatically built and installed along with GNSS-SDR if it is This library is automatically built and installed along with GNSS-SDR if it is
not found by CMake on your system at configure time. not found by CMake on your system at configure time.
@ -57,37 +57,41 @@ not found by CMake on your system at configure time.
However, you can install and use VOLK_GNSSSDR kernels as you use VOLK's, However, you can install and use VOLK_GNSSSDR kernels as you use VOLK's,
independently of GNSS-SDR. independently of GNSS-SDR.
### Install dependencies
First, make sure that the required dependencies are installed in your machine: First, make sure that the required dependencies are installed in your machine:
``` ```
$ sudo apt-get install cmake python3-mako python3-six libboost-dev \ $ sudo apt-get install build-essential python3-mako cmake git ca-certificates \
libboost-filesystem-dev libboost-system-dev libboost-dev libboost-filesystem-dev libboost-system-dev
``` ```
Please note that if you are using a compiler supporting the C++17 standard (for Please note that if you are using a compiler supporting the C++17 standard (for
instance, gcc >= 8.0), specifically the std::filesystem library, packages instance, gcc >= 8.0), specifically the `std::filesystem` library, packages
`libboost-dev`, `libboost-filesystem-dev` and `libboost-system-dev` are no `libboost-dev`, `libboost-filesystem-dev` and `libboost-system-dev` are no
longer required dependencies. The CMake script will detect that availability for longer required dependencies. The CMake script will detect that availability for
you. you.
### Building on most x86 (32-bit and 64-bit) platforms ### Building on most x86 (32-bit and 64-bit) platforms
In order to build and install the library, go to the base folder of the source In order to get the source code, build and install the library, do:
code and do:
``` ```
$ mkdir build $ git clone https://github.com/gnss-sdr/gnss-sdr
$ cd gnss-sdr
$ git checkout next
$ cd build $ cd build
$ cmake .. $ cmake ../src/algorithms/libs/volk_gnsssdr_module/volk_gnsssdr
$ make $ make
$ sudo make install $ sudo make install
$ sudo ldconfig
``` ```
That's it! That's it!
Before its first use, please execute `volk_gnsssdr_profile` to let your system Before its first use, please execute `volk_gnsssdr_profile` to let your system
know which is the fastest available implementation. This only has to be done know which is the fastest available implementation for each kernel. This only
once: has to be done once:
``` ```
$ volk_gnsssdr_profile $ volk_gnsssdr_profile
@ -101,9 +105,14 @@ The execution of `volk_gnsssdr_profile` can be set automatically after building,
leaving your system ready to use: leaving your system ready to use:
``` ```
$ cmake -DENABLE_PROFILING=ON ../ $ git clone https://github.com/gnss-sdr/gnss-sdr
$ cd gnss-sdr
$ git checkout next
$ cd build
$ cmake -DENABLE_PROFILING=ON ../src/algorithms/libs/volk_gnsssdr_module/volk_gnsssdr
$ make $ make
$ sudo make install $ sudo make install
$ sudo ldconfig
``` ```
### Building on Raspberry Pi and other ARM boards ### Building on Raspberry Pi and other ARM boards
@ -117,12 +126,17 @@ best performance.
Example for Raspberry Pi 4: Example for Raspberry Pi 4:
``` ```
$ mkdir build && cd build $ git clone https://github.com/gnss-sdr/gnss-sdr
$ cmake -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchains/arm_cortex_a72_hardfp_native.cmake .. $ cd gnss-sdr
$ git checkout next
$ cd build
$ cmake -DCMAKE_TOOLCHAIN_FILE=../cmake/Toolchains/arm_cortex_a72_hardfp_native.cmake \
../src/algorithms/libs/volk_gnsssdr_module/volk_gnsssdr
$ make $ make
$ make test $ make test
$ sudo make install $ sudo make install
$ volk_gnsssdr_profile $ volk_gnsssdr_profile
$ sudo ldconfig
``` ```
## References ## References
@ -134,7 +148,7 @@ following paper:
[_Accelerating GNSS Software Receivers_](https://zenodo.org/record/266493), in [_Accelerating GNSS Software Receivers_](https://zenodo.org/record/266493), in
Proc. of the 29th International Technical Meeting of the Satellite Division of Proc. of the 29th International Technical Meeting of the Satellite Division of
The Institute of Navigation (ION GNSS+ 2016), pp. 44-61, Portland, Oregon, The Institute of Navigation (ION GNSS+ 2016), pp. 44-61, Portland, Oregon,
September 12-16, 2016. doi: September 12-16, 2016. DOI:
[10.33012/2016.14576](https://doi.org/10.33012/2016.14576) [10.33012/2016.14576](https://doi.org/10.33012/2016.14576)
BibTeX entry: BibTeX entry:
@ -148,7 +162,7 @@ pages = {44--61},
year = {2016}, year = {2016},
address = {Portland, OR}, address = {Portland, OR},
month = {Sep.}, month = {Sep.},
note = {{doi}: 10.33012/2016.14576} note = {{DOI}: 10.33012/2016.14576}
} }
``` ```