Brief setup instructions by Jonas Beuchert, original readme below.
You need a C++11 compiler, ROS, Eigen 3.3.3, and Boost, but they might be installed already.
Install Google's glog library for message output:
sudo apt-get install libgoogle-glog-dev
Clone gnss_comm for ROS message definitions:
cd spot_git
git clone [email protected]:HKUST-Aerial-Robotics/gnss_comm.git
Clone this repository:
git clone [email protected]:ori-drs/ublox_driver.git
Depending on you desired configuration, you might need to change the configuration file, but it should work out-of-the-box. Sometimes, you need to change the port. Usually, it is dev/ttyACM0
(default) or /dev/ttyACM1
.
Create symbolic links from you catkin workspace to the cloned repositories
cd ../spot_ws/src
ln -s ~/spot_git/gnss_comm/ .
ln -s ~/spot_git/ublox_driver/ .
Build the driver using catkin tools:
cd ..
catkin build ublox_driver
Launch roscore
in another terminal.
Grant permission to the port, e.g:
sudo chmod 666 /dev/ttyACM0
(Alternatively, add the user permanently to the dialout
group with sudo adduser user_name dialout
and logout and login again.)
Launch the driver:
source devel/setup.bash
roslaunch ublox_driver ublox_driver.launch
It might be worth it to check out Section 5. below to synchronize the local system time with a global time reference (and, therefore, with the timestamps of the GNSS observations.)
If the driver prints the error ubx rxmrawx week=0 error
or the error open: No such file or directory
, a cause can be that the port in the configuration file is incorrectly set.
If a permission-denied error occurs, then the driver might not have access rights to the port.
If you want to obtain differential fixes in real-time (with potentially cm-accuracy), then you need to feed data from a nearby base station to the GNSS receiver.
If the receiver has Bluetooth (like the C099-F9P), then you can do the following:
- Pair the receiver with your phone via Bluetooth. The C099-F9P should have a name of the form BT_C099-F9P_XXXX. The receiver does not appear as a Bluetooth device? For the C099-F9P, you might have to enable it first: Plug in the receiver via USB, open a serial terminal (baud rate: 460800; serial frame: 8 bits, 1 stop bit, no parity; flow control: none; local echo off/disabled) and run the command
/bt_visible/run
. - Install an NTRIP client (for example, the Lefebure NTRIP Client) on your phone.
- In the receiver settings, select the Bluetooth option and connect to the GNSS receiver.
- In the NTRIP caster section, select a base station. For example, the one near Bicester has the IP address 3.23.52.207 (rtk2go.com), the port 2101, the mount point / stream name OXTS1, and no username and no password. It uses the NTRIP Rev 1 protocol. You can find other base stations in this table. For example, you could search for stations with country code GBR, which provide at least GPS, Glonass (GLO), Galileo (GAL), and BeiDou (BDS) data. However, some streams might be password protected. Another option is to use one of the NTRIP broadcatsers from the BKG. Their streams are lsited here. For example, the station LICC00GBR is in London. However, you need to register first, which is free. Then, enter your username and password in your NTRIP client.
- Run the client and stream the data from the base to the receiver.
- Check that the flag
diff_soln
in the fixes in thereceiver_pvt
topic isTrue
after your started to stream the data.
If the receiver does not have Bluetooth, but the NUC has internet, then follow the instructions in the section Obtain RTK Solution (Optional) below.
Summary of steps here.
Install RTKLIB's NTRIP client:
git clone https://github.com/tomojitakasu/RTKLIB.git
cd RTKLIB/
git checkout rtklib_2.4.3
cd app/consapp/str2str/gcc/
make
Connect to the NTRIP stream of the base station:
./str2str -in ntrip://${NTRIP_SITE}:${NTRIP_PORT}/${MOUNT_POINT} -out tcpsvr://:3503
For example, for the stream from the base close to Bicester:
./str2str -in ntrip://3.23.52.207:2101/OXTS1 -out tcpsvr://:3503
Set the input_rtcm
option to 1
in config/driver_config.yaml.
Launch the ROS node as usual:
roslaunch ublox_driver ublox_driver.launch
Again, check that the flag diff_soln
in the fixes in the receiver_pvt
topic is True
.
To obtain differential fixes offline with post-processing, you can do the following:
- Log the stream from a base station during your trial with an NTRIP client of your choice.
- Convert the log into the RINEX format, if necessary.
- Convert the GNSS observations in your rosbag into RINEX format using this tool.
- Install RTKLIB or this well-maintained fork.
- Get the satellite navigation data from here. Choose the correct year and day-of-the year and the file named
BRDM00DLR_S_YYYYDDD0000_01D_MN.rnx.gz
. (Alternatively, get the satellite navigation data from the base station, too.) - Optionally, get SP3, CLK, ERP, and ION files from here. Choose the correct GPS week number and the correct day of the week (Sunday=0, Monday=1, ...) to identify the correct directory and file. Files starting with
igs
are better than files startingigr
, which are better than theigu
files. Using these files should improve performance since they are more accurate than the broadcasted data mentioned above. - Use RTKLIB's RTKPOST program with all these files to obatain a differential solution. If you are uncertain which options to choose, then have a look at the section in the RTKLIB manual that describes RTKPOST. Probably the
Kinematic
mode is a good starting point.
Authors/Maintainers: CAO Shaozu (shaozu.cao AT gmail.com)
The ublox_driver provides essential functionalities for u-blox GNSS receivers. This package is originally designed for u-blox ZED-F9P module according to the specification UBX-18010854, but should also be compatible to other 8-series or 9-series u-blox receivers as long as the interface is the same.
The following diagram shows all possible input and output options supported by ublox_driver.
This package requires some features of C++11.
This package is developed under ROS Kinetic environment.
We use Eigen 3.3.3 for matrix manipulation.
Our software utilizes Boost library for serial and socket manipulation. Using command sudo apt-get install libboost-all-dev
to install Boost.
This package also requires gnss_comm for ROS message definitions and some utility functions. Follow those instructions to build the gnss_comm package.
Clone the repository to your catkin workspace (for example ~/catkin_ws/
):
cd ~/catkin_ws/src/
git clone https://github.com/HKUST-Aerial-Robotics/ublox_driver.git
Then build the package with:
cd ~/catkin_ws/
catkin_make
source ~/catkin_ws/devel/setup.bash
Our software can take the serial stream from the u-blox receiver as an input source. Before running the package, you need to configure your receiver using u-center to output at least UBX-RXM-RAWX
, UBX-RXM-SFRBX
and UBX-NAV-PVT
messages to a specific serial port (a sample config used in our system can be found at config/ucenter_config_f9p_gvins.txt). Then connecting your computer(Linux) with the receiver, make sure the serial port appears as a file in the /dev/
directory. Then add your account to dialout
group to obtain permission on serial r/w operation via (no need to substitute $USER):
sudo usermod -aG dialout $USER
Open config/driver_config.yaml, set online
and to_ros
to 1, and adjust input_serial_port
and serial_baud_rate
according to your setting. Run the package with:
roslaunch ublox_driver ublox_driver.launch
Open another terminal, echo the ROS message by:
rostopic echo /ublox_driver/receiver_lla
If everything goes smoothly, there should be some ROS messages coming out. Note that some ROS topics remain inactive until the receiver gets GNSS signals.
Besides the ROS message, you can record the serial stream to a file(to_file
option) or forward the stream to another serial port(to_serial
option). All output options can be turned on simultaneously.
If your receiver owns an internal RTK engine (for example, ZED-F9P), you can input RTCM messages from the GNSS base station to the receiver in order to obtain the cm-level accurate RTK localization result. Our software can forward the RTCM stream from a local socket to the receiver's serial port. Nowadays many GNSS stations distribute their RTCM streams via NTRIP protocol and you can easily fetch the NTRIP data and map it to a local socket via RTKLIB. Following those commands to build RTKLIB and setup the RTCM stream:
git clone https://github.com/tomojitakasu/RTKLIB.git
cd RTKLIB/
git checkout rtklib_2.4.3
cd app/consapp/str2str/gcc/
make
./str2str -in ntrip://${NTRIP_SITE}:${NTRIP_PORT}/${MOUNT_POINT} -out tcpsvr://:3503
Then set the input_rtcm
option to 1
in config/driver_config.yaml and launch the ros node with:
roslaunch ublox_driver ublox_driver.launch
If the field carr_soln
in /ublox_driver/receiver_pvt
message becomes 2
, the RTK is in fix status. If you find the location of the GNSS base station reported in the RTCM message is somehow biased, you can apply correction via the variable rtk_correction_ecef
in the config file.
Our package can also take an log file as the input. The log file can be recorded via u-center, RTKLIB or our package itself. To playback the log file, you need to set online
to 0
and point ubx_filepath
to your log file in the config file. Then launch the ros node with:
roslaunch ublox_driver ublox_driver.launch
Similar to the online receiver manner, all three output options are also supported in the playback mode. Note that the playback speed is controlled by the serial_baud_rate
variable in the config file.
In addition to message parsing and delivery, ublox_driver can also synchronize the local system time to the global time without the need of internet connection. Note that such synchronization is only in a coarse level and the accuracy is not guaranteed. To perform such synchronization, you need to set UTC_OFFSET
macro in src/sync_system_time.cpp
according to your timezone. Recompile and launch the driver with:
roslaunch ublox_driver ublox_driver.launch
Then open another terminal and run commands:
sudo su
source /opt/ros/kinetic/setup.bash
source ${YOUR_CATKIN_WORKSPACE}/devel/setup.bash
rosrun ublox_driver sync_system_time
The system time will be synchronized to the global time when the receiver gets a valid PVT solution.
- Config u-blox receiver when the driver gets launched
- Infer timezone from geodetic location when sync time
- Optimize time-sync function to improve precision
Many of the ephemeris parsing functions in our package are adapted from RTKLIB. We use mini-yaml for config parsing.
The source code is released under GPLv3 license.