Skip to content

Latest commit

 

History

History
90 lines (66 loc) · 5.52 KB

README.md

File metadata and controls

90 lines (66 loc) · 5.52 KB

ROS NTRIP Client

Description

ROS node that will communicate with an NTRIP caster to receive RTCM connections and publish them on a ROS topic. Also works with network/VRS mountpoints by subscribing to NMEA messages and sending them to the NTRIP server

Important Branches

There are two important branches that you may want to checkout:

  • ros -- Contains ROS1 implementation for this node.
  • ros2 -- Contains ROS2 implementation for this node.

Build Instructions

Building from source

  1. Install ROS and create a workspace: Installing and Configuring Your ROS Environment

  2. Move the entire ntrip_client folder to the your_workspace/src directory.

  3. Install rosdeps for this package: rosdep install --from-paths ~/your_workspace/src --ignore-src -r -y

  4. Build your workspace:

    cd ~/your_workspace
    catkin_make
    source ~/your_workspace/devel/setup.bash

    The source command may need to be run in each terminal prior to launching a ROS node.

Launch the node and publish data

The following command will launch the node. Keep in mind each instance needs to be run in a separate terminal.

roslaunch ntrip_client ntrip_client.launch

Optional launch parameters:

  • host: Hostname or IP address of the NTRIP server to connect to.
  • port: Port to connect to on the server. Default: 2101
  • mountpoint: Mountpoint to connect to on the NTRIP server.
  • ntrip_version: Value to use for the Ntrip-Version header in the initial HTTP request to the caster.
  • authenticate: Whether to authenticate with the server, or send an unauthenticated request. If set to true, username, and password must be supplied.
  • username: Username to use when authenticating with the NTRIP server. Only used if authenticate is true
  • password: Password to use when authenticating with the NTRIP server. Only used if authenticate is true
  • ssl: Whether to connect with SSL. cert, key, and ca_cert options will only take effect if this is true
  • cert: If the NTRIP caster is configured to use cert based authentication, you can use this option to specify the client certificate
  • key: If the NTRIP caster is configured to use cert based authentication, you can use this option to specify the private key
  • ca_cert: If the NTRIP caster uses self signed certs, or you need to use a different CA chain, this option can be used to specify a CA file
  • rtcm_message_packege: Changes the type of ROS RTCM message published by this node. Defaults to mavros_msgs, but also supports rtcm_msgs

Topics

This node currently only has two topics of interest:

  • /rtcm: This node will publish the RTCM corrections received from the server to this topic as RTCM messages. These messages can be consumed by nodes such as the microstrain_inertial_driver
  • /nmea: This node will subscribe on this topic and receive NMEA sentence messages which it will forward to the NTRIP server. This is only needed when using a virtual NTRIP server

Docker Integration

VSCode

The easiest way to use docker while still using an IDE is to use VSCode as an IDE. Follow the steps below to develop on this repo in a docker container

  1. Install the following dependencies:
    1. VSCode
    2. Docker
  2. Open VSCode and install the following plugins:
    1. VSCode Remote Containers plugin
  3. Open this directory in a container by following this guide

Make

If you are comfortable working from the command line, the Makefile in the .devcontainer directory can be used to build a development image, and run a shell inside the docker image. Follow the steps below to setup your environment to use the Makefile

  1. Install the following dependencies:
    1. Make
    2. Docker
    3. qemu-user-static (for multiarch builds)
      1. Run the following command to register the qemu binaries with docker: docker run --rm --privileged multiarch/qemu-user-static:register

The Makefile exposes the following tasks. They can all be run from the .devcontainer directory:

  • make build-shell - Builds the docker image and starts a shell session in the image allowing the user to develop and build the ROS project using common commands such as catkin_make
  • make clean - Cleans up after the above two tasks

License

ntrip_client is released under the MIT License - see the LICENSE file in the source distribution.

Copyright (c) 2021, Parker Hannifin Corp.