Welcome to gnss-sdr-monitor!
This program is a graphical user interface developed with Qt for monitoring the status of GNSS-SDR in real time.
 |
 |
 |
How to use gnss-sdr-monitor
This GUI is designed to receive real-time data from GNSS-SDR over the network either locally (GNSS-SDR and GUI instances running on the same machine) or remotely (GNSS-SDR and GUI instances running on different machines).
The data that is required by the GUI to work comes from GNSS-SDR via two serialization streams over UDP: the Monitor block streaming and the PVT block streaming, which are independent from each other and provide different kinds of information. In addition, the GUI provides a widget for communicating with the receiver interactive interface (Telecommand via TCP/IP) by allowing you to send special commands to GNSS-SDR.
Figure: GNSS-SDR general block diagram from the documentation page: https://gnss-sdr.org/docs/sp-blocks/. The Monitor block streaming and PVT block streaming are highlighted in red. The Telecommand module is highlighted in green.
Therefore, if you want to use the GUI, it is essential that at least you activate both serialization data streams in your GNSS-SDR receiver configuration file by following these instructions:
In your configuration file, append the following lines to the #PVT CONFIG# section. Put the IP address of the machine where the GUI is running and choose a port number at your own discretion. I am using the loopback address and port 1111 as an example.
PVT.enable_monitor=true
PVT.monitor_client_addresses=127.0.0.1
PVT.monitor_udp_port=1111
This will activate the serialized stream of PVT data to the GUI, which will let you see the position reported by the receiver on a live map as well as a charts of the reported altitude and dilution of precision.
Next, add the following chunk in the #MONITOR CONFIG# section. Again, choose the IP address of the machine where the GUI is running and a port number that work best for you.
Monitor.enable_monitor=true
Monitor.decimation_factor=1
Monitor.client_addresses=127.0.0.1
Monitor.udp_port=1112
This will activate the serialized stream of data from the Monitor block to the GUI, which will let you see a table-like widget with the status of each channel accompanied by data readings of the acquisition and tracking stages.
Making sure that the GUI setup matches that of the GNSS-SDR configuration file is a critical step for the connection to work. In the menu bar of the GUI go to Edit > Preferences, and verify that the port numbers are correct.
Finally, if you want to make use of the Telecommand functionality (which is something I would recommend), append the following lines to the #GLOBAL OPTIONS# section of the configuration file.
GNSS-SDR.telecommand_enabled=true
GNSS-SDR.telecommand_tcp_port=3333
And then enter the IP address and TCP port number in the widget.
This will let you send commands to control the GNSS-SDR instance that you are monitoring with the GUI.
Once you complete these steps you are all set.
How to build gnss-sdr-monitor
Install dependencies using software packages:
Debian / Ubuntu
If you are using Debian 10, Ubuntu 18.04 or above, this can be done by copying and pasting the following line in a terminal:
$ sudo apt install build-essential cmake git libboost-dev libboost-system-dev \
libprotobuf-dev protobuf-compiler qtbase5-dev qtdeclarative5-dev qtpositioning5-dev \
libqt5charts5-dev qml-module-qtquick2 qml-module-qtquick-controls2 qml-module-qtquick-window2 \
qml-module-qtlocation qml-module-qtpositioning qml-module-qtquick-layouts
Once you have installed these packages, you can jump directly to download the source code and build gnss-sdr-monitor.
Arch Linux
If you are using Arch Linux:
$ pacman -S gcc make cmake git boost boost-libs protobuf qt5-base qt5-declarative qt5-location \
qt5-charts qt5-quickcontrols2
Once you have installed these packages, you can jump directly to download the source code and build gnss-sdr-monitor.
CentOS
If you are using CentOS 7, you can install the dependencies via Extra Packages for Enterprise Linux (EPEL):
$ sudo yum install wget
$ wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
$ sudo rpm -Uvh epel-release-latest-7.noarch.rpm
$ sudo yum install gcc-c++ make cmake git boost-devel protobuf-devel protobuf-compiler \
qt5-qtbase-devel qt5-qtdeclarative-devel qt5-qtlocation-devel qt5-qtcharts-devel \
qt5-qtdeclarative-devel
Once you have installed these packages, you can jump directly to download the source code and build gnss-sdr-monitor.
Fedora
If you are using Fedora 28 or above, the required software dependencies can be installed by doing:
$ sudo dnf install gcc-c++ make cmake git boost-devel protobuf-devel protobuf-compiler \
qt5-qtbase-devel qt5-qtdeclarative-devel qt5-qtlocation-devel qt5-qtcharts-devel \
qt5-qtdeclarative-devel
Once you have installed these packages, you can jump directly to download the source code and build gnss-sdr-monitor.
openSUSE
If you are using openSUSE Leap or openSUSE Tumbleweed:
$ zypper install gcc-c++ cmake git boost-devel protobuf-devel libqt5-qtnetworkauth-devel \
libQt5PrintSupport-devel libQt53DQuick-devel libqt5-qtlocation-devel libQt5Charts5-devel
Once you have installed these packages, you can jump directly to download the source code and build gnss-sdr-monitor.
Clone gnss-sdr-monitor Git repository:
$ git clone https://github.com/acebrianjuan/gnss-sdr-monitor
Build and install gnss-sdr-monitor:
$ cd gnss-sdr-monitor/build
$ cmake ..
$ make
This will create the gnss-sdr-monitor executable at the gnss-sdr-monitor/src directory. You can run it from that folder, but if you prefer to install gnss-sdr-monitor on your system and have it available anywhere else, do:
$ sudo make install
Run gnss-sdr-monitor:
$ cd src/
$ ./gnss-sdr-monitor