This repository contains packages to support the interoperability between BeamNG.tech and ROS. BeamNG.tech is a driving simulation platform, suitable for commercial and academic use. Free licenses are available for non-commercial and academic use. Inquiries can be made through our registration form. For inquiries regarding commercial use, contact us at [email protected].

• Documentation
• Features
• Prerequirements
• Getting Started
• Compatibility
• Troubleshooting

As of now the BeamNG ROS integration supports one package for the remote control of the simulation platform and one package for the control of a driving agent. A third package manages custom messages.

For using the BeamNG ROS integration, a BeamNG.tech build and a python environment with BeamNGpy installed are required.

Note that BeamNG.tech only runs on Window, although Linux support is on its way. That means that BeamNG.tech needs to run on a separate Windows machine, or that ROS needs to run on on WSL.

The BeamNG ROS integration is compatible with the ROS 1 distributions Melodic Morenia and Noetic Ninjemys.

To use this project, a basic knowledge of the BeamNG.tech simulator and the BeamNGpy is neccessary. We recommend to familiarize yourself first with BeamNGpy to get a basic understanding of the platform before using the BeamNG ROS Integration.

After setting up BeamNG.tech and BeamNGpy with a python environment, the simulation needs to be started through BeamNGpy.

The ROS packages from this repository need to be added and build in your catkin workspace. See the ROS tutorials for more information on how to set up a catkin workspace.

A node connecting ROS to the simulation can then be started with the help of the example.launch file in the beamng_control package through the command:

roslaunch beamng_control example.launch

It needs to be configured to contain the correct IP address of the machine hosting the simulation. Using it will start up a node that connects to the simulation and starts up a scenario as defined in the beamng_control/config/simple_scenario.json. Other scenario specifications are available in the same directory.

Running the BeamNG ROS integration requires three individual software components, here is a list of compatible versions.

This section lists common issues with BeamNG ROS Integration in particular. Since this library is closely tied to BeamNG.tech and thus BeamNG.drive, it is also recommended to consult the documentation on BeamNG.drive here:

https://documentation.beamng.com/