u-blox GPS receivers use a UBX binary protocol to transmit GPS data to a host computer using asynchronous serial ports. This project provides a definition all the messages as well as wrapping transport framing used by u-blox 5/6/7/8 devices.
The protocol is defined in multiple schema files using CommsDSL. The commsds2comms code generator from commsdsl project is used to generate C++11 code of the protocol implementation.
The generated CMake project of this protocol definition is hosted and can be viewed at cc.ublox.generated
The examples directory contains following example applications:
- simple_pos - simple application that communicates to u-blox receiver over USB serial link and polls for NAV-POSLLH messages. When latter is received, the position is printed to standard output.
Please read License section from commsdsl project.
This project uses CMake as its build system. Please open main CMakeLists.txt file and review available options as well as mentioned available parameters, which can be used in addition to standard ones provided by CMake itself, to modify the default build.
The commsdsl2comms application from commsdsl project is used to generate appropriate C++ code. If path to externally built commsdsl2comms is not provided, then this project will build the latter itself.
The example applications use Boost
to parse their command line parameters as well as manage their asynchronous I/O.
In case Boost libraries are not installed in expected default location
(mostly happens on Windows systems), use variables described in
CMake documentation
to help CMake find required libraries and headers.
It is recommended to use -DBoost_USE_STATIC_LIBS=ON parameter to force
linkage with static Boost libraries.
NOTE, that commsdsl2comms application also requires Boost libraries. Please provide path to the latter, when commsdsl2comms is built internally, even if example applications are excluded from the build.
If code generation output directory is not provided, it defaults to
output subdirectory of the one used to build the project.
$> cd /source/of/this/project
$> mkdir build && cd build
$> cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=$PWD/install ..
$> make install
$> cd C:\source\of\this\project
$> mkdir build && cd build
$> cmake -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=%cd%/install \
-DBOOST_ROOT="C:\Libraries\boost_1_65_1" -DBoost_USE_STATIC_LIBS=ON ..
$> nmake install
Please read Supported Compilers info from commsdsl project.
Please read the Generated CMake Project Walkthrough wiki page for details on the generated project internals.
The release artifacts contain doxygen generated documentation of the protocol definition.
For bug reports, feature requests, or any other question you may open an issue here in github or e-mail me directly to: arobenko@gmail.com. I usually respond within 24 hours.