{"id":38856,"date":"2025-01-31T08:39:43","date_gmt":"2025-01-31T07:39:43","guid":{"rendered":"https:\/\/genesys-offenburg.de\/?post_type=smart-docs&#038;p=38856"},"modified":"2025-02-07T11:10:45","modified_gmt":"2025-02-07T10:10:45","slug":"ros2-driver-configuration","status":"publish","type":"smart-docs","link":"https:\/\/genesys-offenburg.de\/zh-hans\/support\/integrationsloesungen\/ros\/ros2-driver-configuration\/","title":{"rendered":"ROS2 &#8211; Configuration Parameters"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\" id=\"h-configuration\">Configuration<\/h2>\n\n\n\n<p>For configuring the ADMA ROS Driver the according parameters in the&nbsp;<code>adma_ros2_driver\/config\/driver_config.yaml<\/code>&nbsp;file have to be modified. If the workspace was built with&nbsp;<code>colcon build --symlink-install<\/code>, it is possible to restart the node after changing configuration parameters directly. Otherwise (built without &#8216;&#8211;symlink-install&#8217;) it is necessary to rebuild the workspace to update the files. Same &#8220;linking&#8221; rule applies to the&nbsp;<code>launch.py<\/code>&nbsp;files. The available parameters are described below.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-configuration-file-driver-config-yaml\">Configuration file &#8211; driver_config.yaml<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"459\" src=\"https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-72-1024x459.png\" alt=\"\" class=\"wp-image-39091\" srcset=\"https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-72-1024x459.png 1024w, https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-72-300x135.png 300w, https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-72-768x345.png 768w, https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-72-696x312.png 696w, https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-72-1068x479.png 1068w, https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-72.png 1101w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-destination-ip-and-destination-port\">Destination ip and destination port<\/h4>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p>For the <mark style=\"background-color:rgba(0, 0, 0, 0);color:#09811f\" class=\"has-inline-color\">destination ip<\/mark> and <mark style=\"background-color:rgba(0, 0, 0, 0);color:#09811f\" class=\"has-inline-color\">port<\/mark><strong><mark style=\"background-color:rgba(0, 0, 0, 0);color:#8e2936\" class=\"has-inline-color\"> <\/mark><\/strong>you have to apply the same settings as in the ADMA ADMAnet setup.<\/p>\n\n\n\n<p>In this case it is the <mark style=\"background-color:rgba(0, 0, 0, 0);color:#f7a913\" class=\"has-inline-color\">192.168.88.255<\/mark><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-pale-cyan-blue-color\"> <\/mark>(broadcast) with the destination port <mark style=\"background-color:rgba(0, 0, 0, 0);color:#f7a913\" class=\"has-inline-color\">11021<\/mark>.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" width=\"649\" height=\"256\" src=\"https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-71.png\" alt=\"\" class=\"wp-image-38888\" srcset=\"https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-71.png 649w, https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-71-300x118.png 300w\" sizes=\"(max-width: 649px) 100vw, 649px\" \/><\/figure>\n<\/div>\n<\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-protocol-version\">Protocol version<\/h4>\n\n\n\n<p>Please also adapt the <mark style=\"background-color:rgba(0, 0, 0, 0);color:#09811f\" class=\"has-inline-color\">protocol version<\/mark> to the one used in your ADMAnet setup. The following protocol version are available:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>v3.2<\/li>\n\n\n\n<li>v3.3.3<\/li>\n\n\n\n<li>v3.3.4<\/li>\n\n\n\n<li>v3.3.5<\/li>\n\n\n\n<li>v3.3.6<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-measurement-point\">Measurement point<\/h4>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p>ROS topics can be output at specific measurement points within the vehicle using ADMA Points of Interest (POIs). These POIs are defined in the ADMA web interface by setting user-defined offsets relative to the Measurement Reference Point (MRP). In the ADMA ROS Driver, the desired POI for each ROS topic can be selected by specifying the corresponding<mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-pale-cyan-blue-color\"> <\/mark><mark style=\"background-color:rgba(0, 0, 0, 0);color:#09811f\" class=\"has-inline-color\">topic_pois<\/mark> ID in the Driver Config File (0 = MRP, 1-8 = POI 1-8). By default, ROS topics are output at POI 1.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-full is-resized\"><img decoding=\"async\" width=\"657\" height=\"635\" src=\"https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-68.png\" alt=\"\" class=\"wp-image-38865\" style=\"width:333px;height:auto\" srcset=\"https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-68.png 657w, https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-68-300x290.png 300w\" sizes=\"(max-width: 657px) 100vw, 657px\" \/><\/figure>\n<\/div>\n<\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-odometry-topic\">Odometry Topic<\/h4>\n\n\n\n<p>By default, the odometry topic outputs <mark style=\"background-color:rgba(0, 0, 0, 0);color:#f7a913\" class=\"has-inline-color\">Yaw relative <\/mark>to the north direction. You can configure an offset for Yaw using the <mark style=\"background-color:rgba(0, 0, 0, 0);color:#09811f\" class=\"has-inline-color\">odometry_yaw_offset<\/mark><mark style=\"background-color:rgba(0, 0, 0, 0);color:#8e2936\" class=\"has-inline-color\"><strong> <\/strong><\/mark>parameter.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-replay-mode\">Replay Mode<\/h4>\n\n\n\n<p>With the <mark style=\"background-color:rgba(0, 0, 0, 0);color:#f7a913\" class=\"has-inline-color\">mode<\/mark>, it is possible to switch between the <mark style=\"background-color:rgba(0, 0, 0, 0);color:#f7a913\" class=\"has-inline-color\">online<\/mark><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-pale-cyan-blue-color\"> <\/mark>and the <mark style=\"background-color:rgba(0, 0, 0, 0);color:#f7a913\" class=\"has-inline-color\">replay mode<\/mark>. The replay mode is a built in replay function for subscribing to the <mark style=\"background-color:rgba(0, 0, 0, 0);color:#f7a913\" class=\"has-inline-color\">\/adma\/data_raw topic<\/mark> of a replayed bag file. This enables only the decoder part of the driver, that takes the rosbag data and publishes them in the standard ADMA ROS driver topics.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-header-time\">Header Time<\/h4>\n\n\n\n<p>With the <mark style=\"background-color:rgba(0, 0, 0, 0);color:#09811f\" class=\"has-inline-color\">time_mode <\/mark>parameter it is possible to define how the ROS header time stamps shall be defined. Either by the<mark style=\"background-color:rgba(0, 0, 0, 0);color:#f7a913\" class=\"has-inline-color\"> ADMA INS time<\/mark><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-pale-cyan-blue-color\"> <\/mark>(default) or by the<mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-pale-cyan-blue-color\"> <\/mark><mark style=\"background-color:rgba(0, 0, 0, 0);color:#f7a913\" class=\"has-inline-color\">ROS system time<\/mark>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-launch-file-adma-driver-launch-py\">Launch file &#8211; adma_driver.launch.py<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"932\" src=\"https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-73-1024x932.png\" alt=\"\" class=\"wp-image-39100\" srcset=\"https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-73-1024x932.png 1024w, https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-73-300x273.png 300w, https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-73-768x699.png 768w, https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-73-696x634.png 696w, https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-73-1068x972.png 1068w, https:\/\/genesys-offenburg.de\/wp-content\/uploads\/2025\/01\/image-73.png 1117w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>As default, the ADMA ROS driver is logging a .gsdb raw data file besides the published ROS topics. This makes it possible to reprocess the data in the ROS river, but also via <a href=\"https:\/\/genesys-offenburg.de\/en\/adma-pp\/\" target=\"_blank\" rel=\"noreferrer noopener\">ADMA-PP<\/a>, a Post processing software tool. <\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-log-raw-data-file\">Log raw data file<\/h4>\n\n\n\n<p>With the parameter <mark style=\"background-color:rgba(0, 0, 0, 0);color:#09811f\" class=\"has-inline-color\">log_gsdb_arg <\/mark>in the launch file it is possible to turn the .gsdb logging off for saving data space at long recordings.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-log-ros-bag-automatically\">Log ROS bag automatically<\/h4>\n\n\n\n<p>With the parameter <mark style=\"background-color:rgba(0, 0, 0, 0);color:#09811f\" class=\"has-inline-color\">record_ros_bag_arg <\/mark>it is possible to turn on automatic rosbag recording as soon as the driver gets started. <mark style=\"background-color:rgba(0, 0, 0, 0);color:#09811f\" class=\"has-inline-color\">recorded_topics <\/mark>enables you to select the ROS topics, that shall be recorded to the ROS bag, if automatic recording is activated and with <mark style=\"background-color:rgba(0, 0, 0, 0);color:#09811f\" class=\"has-inline-color\">rosbag_file_arg <\/mark>you are able to change the folder to save the recordings in.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"h-topic-remapping\">Topic Remapping<\/h4>\n\n\n\n<p>In the array <mark style=\"background-color:rgba(0, 0, 0, 0);color:#09811f\" class=\"has-inline-color\">remappings<\/mark>, all provided ROS topics are listed combined with the naming. By changing the names the topics can be remapped.<\/p>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Configuration For configuring the ADMA ROS Driver the a [&hellip;]<\/p>\n","protected":false},"author":148,"featured_media":30266,"template":"","meta":{"_acf_changed":false,"_links_to":"","_links_to_type":0,"footnotes":""},"smartdocs_category":[812,890],"class_list":{"0":"post-38856","1":"smart-docs","2":"type-smart-docs","3":"status-publish","4":"has-post-thumbnail","6":"smartdocs_category-integrationsloesungen","7":"smartdocs_category-ros"},"acf":[],"_links":{"self":[{"href":"https:\/\/genesys-offenburg.de\/zh-hans\/wp-json\/wp\/v2\/smart-docs\/38856","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/genesys-offenburg.de\/zh-hans\/wp-json\/wp\/v2\/smart-docs"}],"about":[{"href":"https:\/\/genesys-offenburg.de\/zh-hans\/wp-json\/wp\/v2\/types\/smart-docs"}],"author":[{"embeddable":true,"href":"https:\/\/genesys-offenburg.de\/zh-hans\/wp-json\/wp\/v2\/users\/148"}],"version-history":[{"count":3,"href":"https:\/\/genesys-offenburg.de\/zh-hans\/wp-json\/wp\/v2\/smart-docs\/38856\/revisions"}],"predecessor-version":[{"id":39103,"href":"https:\/\/genesys-offenburg.de\/zh-hans\/wp-json\/wp\/v2\/smart-docs\/38856\/revisions\/39103"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/genesys-offenburg.de\/zh-hans\/wp-json\/wp\/v2\/media\/30266"}],"wp:attachment":[{"href":"https:\/\/genesys-offenburg.de\/zh-hans\/wp-json\/wp\/v2\/media?parent=38856"}],"wp:term":[{"taxonomy":"smartdocs_category","embeddable":true,"href":"https:\/\/genesys-offenburg.de\/zh-hans\/wp-json\/wp\/v2\/smartdocs_category?post=38856"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}