novatel_oem7_driver repository

Repository Summary

Checkout URI https://github.com/novatel/novatel_oem7_driver.git
VCS Type git
VCS Version humble
Last Updated 2023-10-30
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
novatel_oem7_driver 20.3.0
novatel_oem7_msgs 20.1.0

README

NovAtel OEM7 Driver

ROS Driver for NovAtel OEM7 GNSS/SPAN Receivers.

Getting Started

This documents how to custom-build the novatel_oem7_driver for ROS from the provided source code. Typical users will prefer to install the pre-made binary release that has been published in the ROS distribution.

Refer to our documentation under the ROS community wiki for: * Hardware Setup * Binary Driver Installation * Driver Configuration * Driver Runtime Operation * Post-Processing data * Information on Relevant NovAtel Services and Products * Advanced Topics

novatel_oem7_driver documentation on ROS community wiki is located here: http://wiki.ros.org/novatel_oem7_driver


Building novatel_oem7_driver from source code

Prerequisites

  • Install ROS2 Humble.
  • Obtain OEM7 receiver.

Installation

Option A: Install binary package (not supported yet; coming soon)

There is substantial documention regarding use of the binary release of this driver on the ROS community wiki, located here: https://wiki.ros.org/novatel_oem7_driver

The key step is:

sudo apt install ros-${ROS_DISTRO}-novatel-oem7-driver

Please refer to the Community Wiki for detailed run-time documentation for novatel_oem7_driver (link given above).

Option B: Build from source (docker)

These instructions assume that you are using Ubuntu 22.04.

  1. Install Docker, add the user you intend on using to the 'docker' group. For example:
    1. Add the current user to the 'docker' group: sudo usermod -aG docker ${USER}
    2. Apply the membership changes to the current session: su - ${USER}
  2. From the base directory of the repository, create container for the desired ROS architecture and distro, e.g. Humble:
    ./docker/run.sh -r amd64 humble
    Note: only amd64 and arm64v8 architectures are supported at this point.
  3. From within your docker container, use standard ROS2 tools, like colcon.
  4. Alternatively, use the build.sh script.

Option C: Build from source (local environment)

Here are approximate instructions for building this driver with your local ROS development environment. Please note this is for reference. The Docker approach is recommended.

  1. Install ROS with developer support to your environment (ROS Wiki Ubuntu)
  2. Install ROS dependencies using rosdep install --from-paths src --ignore-src -r -y
  3. Run source /opt/ros/${ROS_DISTRO}/setup.bash
  4. Run build: ./build.sh -f
  5. After a successful build, source your local environment: . install/setup.sh

Install .deb packages

Building produces two deb package, novatel-oem7-driver and novatel-oem7-msgs.

You can then install these via apt or dpkg:

sudo apt install ./ros-{$ROS_DISTRO}-novatel-oem7*.deb

Configuration Parameters

  • oem7_position_source: string. Oem7 log used to obtain the position for GPSFix, NavSatFix, Odometry

BESTPOS: Always use BESTPOS log

INSPVAS: Always use INSPVAS log. Requires SPAN

unset (default): use INSPVAS unless BESTPOS has better quality

  • oem7_imu_rate: int. Overrides the IMU data rate.

Can Used to enable IMU message generation when INSCONFIG is not available, e.g. when feeding input from

a partial dataset file.

default: 0; INSCONFIG must be present in input.

  • oem7_odometry_zero_origin: bool When 'true', use 0,0,0 as Odometry origin; the first valid GPSFix is used to set the origin.

default: false

  • oem7_odometry_transform: bool. When 'true', Transform is published, sourced from Odometry.

default: false

  • oem7_receiver_log_file: string. Path to a file recording all bytes output by the Oem7 Receiver.

default: "", no output is captured.

  • oem7_decoder_log_file: Path to a file recording all bytes output by the Oem7 Decoder. Used for decoder debugging.

default: "", no output is captured.

  • oem7_strict_receiver_init:bool. When 'true', strict initialization is used; no position / velocity /attitude data

is output unless all receiver initialization commands have succeeded.

default: true

  • oem7_publish_unknown_oem7_raw: bool. When 'true', all Oem7 messages not supported by the decoder are publshed as 'raw'.

    default: false

  • oem7_publish_delay: double. Seconds to delay before publishing each message.

Used for debugging, and with file-based input.

default: 0

Next Steps

Refer to the novatel_oem7_driver documentation in the ROS wiki for more information: http://wiki.ros.org/novatel_oem7_driver

Authors

License

This project is licensed under the MIT License - see the LICENSE file for details

CONTRIBUTING

No CONTRIBUTING.md found.

Repository Summary

Checkout URI https://github.com/novatel/novatel_oem7_driver.git
VCS Type git
VCS Version ros1
Last Updated 2024-01-30
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
novatel_oem7_driver 4.3.0
novatel_oem7_msgs 4.3.0

README

NovAtel OEM7 Driver

ROS Driver for NovAtel OEM7 GNSS/SPAN Receivers.

Getting Started

This documents how to custom-build the novatel_oem7_driver for ROS from the provided source code. Typical users will prefer to install the pre-made binary release that has been published in the ROS distribution.

Refer to our documentation under the ROS community wiki for: * Hardware Setup * Binary Driver Installation * Driver Configuration * Driver Runtime Operation * Post-Processing data * Information on Relevant NovAtel Services and Products * Advanced Topics

novatel_oem7_driver documentation on ROS community wiki is located here: http://wiki.ros.org/novatel_oem7_driver


Building novatel_oem7_driver from source code

Prerequisites

  • Install ROS Noetic, Melodic or Kinetic.
  • Obtain OEM7 receiver.

Installation

Option A: Install binary package

There is substantial documention regarding use of the binary release of this driver on the ROS community wiki, located here: https://wiki.ros.org/novatel_oem7_driver

The key step is:

sudo apt install ros-${ROS_DISTRO}-novatel-oem7-driver

Please refer to the Community Wiki for detailed run-time documentation for novatel_oem7_driver (link given above).

Option B: Build from source (docker)

These instructions assume that you are using Ubuntu 18.04.

  1. Install Docker, add the user you intend on using to the 'docker' group. For example:
    1. Add the current user to the 'docker' group: sudo usermod -aG docker ${USER}
    2. Apply the membership changes to the current session: su - ${USER}
  2. From the base directory of the repository, create container for the desired ROS architecture and distro, e.g. Noetic:
    ./docker/run.sh -r amd64 noetic
    Note: only amd64 architecture is supported at this point.
  3. From within your docker container (where the prompt from above should land), run ./build.sh -f

Option C: Build from source (local environment)

Here are approximate instructions for building this driver with your local ROS development environment. Please note this is for reference. The Docker approach is recommended.

  1. Install ROS with developer support to your environment (ROS Wiki Ubuntu 18.04)
  2. Install ROS dependencies using rosdep install --from-paths src --ignore-src -r -y
  3. Set ROS_DISTRO environment variable (Ex: ROS_DISTRO=noetic)
  4. Run source /opt/ros/${ROS_DISTRO}/setup.bash
  5. Run source envsetup.sh
  6. Run build: ./build.sh -f

Install .deb packages

Building produces two deb package, novatel-oem7-driver and novatel-oem7-msgs.

You can then install these via apt or dpkg:

sudo apt install ./ros-{$ROS_DISTRO}-novatel-oem7*.deb

Next Steps

Refer to the novatel_oem7_driver documentation in the ROS wiki for more information: http://wiki.ros.org/novatel_oem7_driver

Authors

License

This project is licensed under the MIT License - see the LICENSE file for details

CONTRIBUTING

No CONTRIBUTING.md found.

Repository Summary

Checkout URI https://github.com/novatel/novatel_oem7_driver.git
VCS Type git
VCS Version ros2-dev
Last Updated 2023-10-30
Dev Status DEVELOPED
CI status No Continuous Integration
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
novatel_oem7_driver 10.5.0
novatel_oem7_msgs 10.0.0

README

NovAtel OEM7 Driver

ROS Driver for NovAtel OEM7 GNSS/SPAN Receivers.

Getting Started

This documents how to custom-build the novatel_oem7_driver for ROS from the provided source code. Typical users will prefer to install the pre-made binary release that has been published in the ROS distribution.

Refer to our documentation under the ROS community wiki for: * Hardware Setup * Binary Driver Installation * Driver Configuration * Driver Runtime Operation * Post-Processing data * Information on Relevant NovAtel Services and Products * Advanced Topics

novatel_oem7_driver documentation on ROS community wiki is located here: http://wiki.ros.org/novatel_oem7_driver


Building novatel_oem7_driver from source code

Prerequisites

  • Install ROS2 Foxy.
  • Obtain OEM7 receiver.

Installation

Option A: Install binary package (not supported yet; coming soon)

There is substantial documention regarding use of the binary release of this driver on the ROS community wiki, located here: https://wiki.ros.org/novatel_oem7_driver

The key step is:

sudo apt install ros-${ROS_DISTRO}-novatel-oem7-driver

Please refer to the Community Wiki for detailed run-time documentation for novatel_oem7_driver (link given above).

Option B: Build from source (docker)

These instructions assume that you are using Ubuntu 18.04.

  1. Install Docker, add the user you intend on using to the 'docker' group. For example:
    1. Add the current user to the 'docker' group: sudo usermod -aG docker ${USER}
    2. Apply the membership changes to the current session: su - ${USER}
  2. From the base directory of the repository, create container for the desired ROS architecture and distro, e.g. Foxy:
    ./docker/run.sh -r amd64 foxy
    Note: only amd64 and arm64v8 architectures are supported at this point.
  3. From within your docker container, use standard ROS2 tools, like colcon.
  4. Alternatively, use the build.sh script.

Option C: Build from source (local environment)

Here are approximate instructions for building this driver with your local ROS development environment. Please note this is for reference. The Docker approach is recommended.

  1. Install ROS with developer support to your environment (ROS Wiki Ubuntu 20.04)
  2. Install ROS dependencies using rosdep install --from-paths src --ignore-src -r -y
  3. Set ROS_DISTRO environment variable (Ex: ROS_DISTRO=foxy)
  4. Run source /opt/ros/${ROS_DISTRO}/setup.bash
  5. Run build: ./build.sh -f
  6. After a successful build, source your local environment: . install/setup.sh

Install .deb packages

Building produces two deb package, novatel-oem7-driver and novatel-oem7-msgs.

You can then install these via apt or dpkg:

sudo apt install ./ros-{$ROS_DISTRO}-novatel-oem7*.deb

Next Steps

Refer to the novatel_oem7_driver documentation in the ROS wiki for more information: http://wiki.ros.org/novatel_oem7_driver

Authors

License

This project is licensed under the MIT License - see the LICENSE file for details

CONTRIBUTING

No CONTRIBUTING.md found.

Repository Summary

Checkout URI https://github.com/novatel/novatel_oem7_driver.git
VCS Type git
VCS Version master
Last Updated 2024-01-12
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
novatel_oem7_driver 4.0.0
novatel_oem7_msgs 4.0.0

README

NovAtel OEM7 Driver

ROS Driver for NovAtel OEM7 GNSS/SPAN Receivers.

Getting Started

This documents how to custom-build the novatel_oem7_driver for ROS from the provided source code. Typical users will prefer to install the pre-made binary release that has been published in the ROS distribution.

Refer to our documentation under the ROS community wiki for: * Hardware Setup * Binary Driver Installation * Driver Configuration * Driver Runtime Operation * Post-Processing data * Information on Relevant NovAtel Services and Products * Advanced Topics

novatel_oem7_driver documentation on ROS community wiki is located here: http://wiki.ros.org/novatel_oem7_driver


Building novatel_oem7_driver from source code

Prerequisites

  • Install ROS Noetic, Melodic or Kinetic.
  • Obtain OEM7 receiver.

Installation

Option A: Install binary package

There is substantial documention regarding use of the binary release of this driver on the ROS community wiki, located here: https://wiki.ros.org/novatel_oem7_driver

The key step is:

sudo apt install ros-${ROS_DISTRO}-novatel-oem7-driver

Please refer to the Community Wiki for detailed run-time documentation for novatel_oem7_driver (link given above).

Option B: Build from source (docker)

These instructions assume that you are using Ubuntu 18.04.

  1. Install Docker, add the user you intend on using to the 'docker' group. For example:
    1. Add the current user to the 'docker' group: sudo usermod -aG docker ${USER}
    2. Apply the membership changes to the current session: su - ${USER}
  2. From the base directory of the repository, create container for the desired ROS architecture and distro, e.g. Noetic:
    ./docker/run.sh -r amd64 noetic
    Note: only amd64 architecture is supported at this point.
  3. From within your docker container (where the prompt from above should land), run ./build.sh -f

Option C: Build from source (local environment)

Here are approximate instructions for building this driver with your local ROS development environment. Please note this is for reference. The Docker approach is recommended.

  1. Install ROS with developer support to your environment (ROS Wiki Ubuntu 18.04)
  2. Install ROS dependencies using rosdep install --from-paths src --ignore-src -r -y
  3. Set ROS_DISTRO environment variable (Ex: ROS_DISTRO=noetic)
  4. Run source /opt/ros/${ROS_DISTRO}/setup.bash
  5. Run source envsetup.sh
  6. Run build: ./build.sh -f

Install .deb packages

Building produces two deb package, novatel-oem7-driver and novatel-oem7-msgs.

You can then install these via apt or dpkg:

sudo apt install ./ros-{$ROS_DISTRO}-novatel-oem7*.deb

Next Steps

Refer to the novatel_oem7_driver documentation in the ROS wiki for more information: http://wiki.ros.org/novatel_oem7_driver

Authors

License

This project is licensed under the MIT License - see the LICENSE file for details

CONTRIBUTING

No CONTRIBUTING.md found.

Repository Summary

Checkout URI https://github.com/novatel/novatel_oem7_driver.git
VCS Type git
VCS Version ros1
Last Updated 2024-01-30
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Packages

Name Version
novatel_oem7_driver 4.3.0
novatel_oem7_msgs 4.3.0

README

NovAtel OEM7 Driver

ROS Driver for NovAtel OEM7 GNSS/SPAN Receivers.

Getting Started

This documents how to custom-build the novatel_oem7_driver for ROS from the provided source code. Typical users will prefer to install the pre-made binary release that has been published in the ROS distribution.

Refer to our documentation under the ROS community wiki for: * Hardware Setup * Binary Driver Installation * Driver Configuration * Driver Runtime Operation * Post-Processing data * Information on Relevant NovAtel Services and Products * Advanced Topics

novatel_oem7_driver documentation on ROS community wiki is located here: http://wiki.ros.org/novatel_oem7_driver


Building novatel_oem7_driver from source code

Prerequisites

  • Install ROS Noetic, Melodic or Kinetic.
  • Obtain OEM7 receiver.

Installation

Option A: Install binary package

There is substantial documention regarding use of the binary release of this driver on the ROS community wiki, located here: https://wiki.ros.org/novatel_oem7_driver

The key step is:

sudo apt install ros-${ROS_DISTRO}-novatel-oem7-driver

Please refer to the Community Wiki for detailed run-time documentation for novatel_oem7_driver (link given above).

Option B: Build from source (docker)

These instructions assume that you are using Ubuntu 18.04.

  1. Install Docker, add the user you intend on using to the 'docker' group. For example:
    1. Add the current user to the 'docker' group: sudo usermod -aG docker ${USER}
    2. Apply the membership changes to the current session: su - ${USER}
  2. From the base directory of the repository, create container for the desired ROS architecture and distro, e.g. Noetic:
    ./docker/run.sh -r amd64 noetic
    Note: only amd64 architecture is supported at this point.
  3. From within your docker container (where the prompt from above should land), run ./build.sh -f

Option C: Build from source (local environment)

Here are approximate instructions for building this driver with your local ROS development environment. Please note this is for reference. The Docker approach is recommended.

  1. Install ROS with developer support to your environment (ROS Wiki Ubuntu 18.04)
  2. Install ROS dependencies using rosdep install --from-paths src --ignore-src -r -y
  3. Set ROS_DISTRO environment variable (Ex: ROS_DISTRO=noetic)
  4. Run source /opt/ros/${ROS_DISTRO}/setup.bash
  5. Run source envsetup.sh
  6. Run build: ./build.sh -f

Install .deb packages

Building produces two deb package, novatel-oem7-driver and novatel-oem7-msgs.

You can then install these via apt or dpkg:

sudo apt install ./ros-{$ROS_DISTRO}-novatel-oem7*.deb

Next Steps

Refer to the novatel_oem7_driver documentation in the ROS wiki for more information: http://wiki.ros.org/novatel_oem7_driver

Authors

License

This project is licensed under the MIT License - see the LICENSE file for details

CONTRIBUTING

No CONTRIBUTING.md found.