ROS Resources: Documentation | Support | Discussion Forum | Service Status | ros @ Robotics Stack Exchange
ROS Index
  1. Home
  2. Packages
  3. bosch_locator_bridge
 

bosch_locator_bridge package from locator_ros_bridge repo

bosch_locator_bridge bosch_locator_bridge_utils

API Docs
Browse Code
Wiki

Package Summary

Tags No category tags.
Version 2.1.10
License Apache License 2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

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

Package Description

ROS interface to Rexroth ROKIT Locator

Additional Links

No additional links.

Maintainers

  • Stefan Laible

Authors

No additional authors.
bosch_locator_bridge/README.md

General information about this repository, including legal information and build instructions are given in README.md in the repository root.

bosch_locator_bridge

Overview

This package provides a ROS 2 interface to the Rexroth ROKIT Locator. It translates ROS 2 messages to the ROKIT Locator API (as described in the ROKIT Locator API documentation) and vice versa. It also allows to control the ROKIT Locator via ROS 2 service calls.

The package has been tested under ROS 2 Humble and Ubuntu 22.04. The bridge is compatible with ROKIT Locator version 1.8. If you have an earlier version, see Support of earlier versions of ROKIT Locator.

Quick Start

This section describes how to record your environment, create a map out of the record and localize yourself within it.

Ensure the ROKIT Locator is reachable from your computer

Make sure the ROKIT Locator is installed and running on a computer in your network. You can test this by running the following command in a terminal (replace <LOCATOR_IP> by the IP address of the computer running the ROKIT Locator):

curl --header "Content-Type: application/json" --request POST --data '{"jsonrpc":"2.0","method":"aboutModulesList","params":{"query":{}},"id":1}' http://<LOCATOR_IP>:8080

Start Bridge Node

Start the bridge node with

ros2 launch bosch_locator_bridge bridge.launch.xml bridge_ip:=<HOST_IP> locator_ip:=<LOCATOR_IP> locator_user:=<USER> locator_password:=<PASSWORD> scan_topic:=<SCAN_TOPIC> enable_odometry:=<ENABLE_ODOM> odom_topic:=<ODOM_TOPIC>

where - <HOST_IP> is the IP address of the computer the bridge is to be started - <LOCATOR_IP> is the IP address of the computer where the ROKIT Locator is running - <USER> and <PASSWORD> are the credentials to log into the ROKIT Locator - <SCAN_TOPIC> is the topic name of the laser scans - <ENABLE_ODOM> is a boolean that describes whether you want to forward odometry ROS messages to the ROKIT Locator - <ODOM_TOPIC> is the topic name of the odometry

Since the Laser Localization Software is running in docker, the <HOST_IP> has to be set to docker0 ip address (172.17.0.1) instead of localhost ip address (127.0.0.1) when the user program providing the laser data runs on the same machine.

For additional parameters please refer to the launch file bridge.launch.xml.

Start Visual Recording

Then, make sure there are laser scans published on <SCAN_TOPIC>, and start the visual recording with e.g.

ros2 run rviz2 rviz2 -d $(ros2 pkg prefix bosch_locator_bridge)/share/bosch_locator_bridge/config/locator_bridge_visual_recording.rviz
ros2 service call /bridge_node/start_visual_recording bosch_locator_bridge/srv/StartRecording "name: 'ROS-Quickstart-$(date -Isecond)'"

You should see the laser scans, the robot position and its previous path, and the recording built up over time.

Stop Visual Recording

When you are done, you can stop recording with

ros2 service call /bridge_node/stop_visual_recording std_srvs/srv/Empty

Create Map From Recording

Now, create a map from your recording with

ros2 run rviz2 rviz2 -d $(ros2 pkg prefix bosch_locator_bridge)/share/bosch_locator_bridge/config/locator_bridge_map_creation.rviz
ros2 service call /bridge_node/start_map bosch_locator_bridge/srv/ClientMapStart

When the map has been created, it must be sent to the map server and set as the active map.

ros2 service call /bridge_node/send_map bosch_locator_bridge/srv/ClientMapSend
ros2 service call /bridge_node/set_map bosch_locator_bridge/srv/ClientMapSet

Start Localization

Finally, you can start the localization with

ros2 run rviz2 rviz2 -d $(ros2 pkg prefix bosch_locator_bridge)/share/bosch_locator_bridge/config/locator_bridge_localization.rviz
ros2 service call /bridge_node/start_localization std_srvs/srv/Empty

You can set the initial pose of the robot by clicking the "2D Pose Estimate" button in RViz, and then set the pose in the map.

Stop Localization

When you are done, you can stop the localization with

ros2 service call /bridge_node/stop_localization std_srvs/srv/Empty

Map Expansion

  1. Record and build the prior map (map name: priormap) as usual.
  2. Start localization on this prior map and move until the system is localized.
  3. Make a note of the pose and do not move
  4. Enable map expansion
    rosservice  call /bridge_node/enable_map_expansion "prior_map_name: priormap"
  1. Start visual recording and use the following to visualize the prior map
    rosrun rviz rviz -d `rospack find bosch_locator_bridge`/config/locator_bridge_visual_recording_with_prior_map.rviz
  1. Use the pose in step 3 to set the current pose in the recording
    rosservice call /bridge_node/recording_set_current_pose "pose:
        x: -0.357
        y: 32.3
        theta: -0.23"
  1. Drive around to record the new area as an extension
  2. Stop visual recording
  3. Start mapping with the recording including the initial pose (map expansion is still enabled)
    rosrun rviz rviz -d `rospack find bosch_locator_bridge`/config/locator_bridge_map_creation_with_prior_map.rviz
  1. Disable the map expansion
    rosservice  call /bridge_node/disable_map_expansion

Nodes

bridge_node

This node provides an interface to the localization client.

ROKIT Locator Configuration

To correctly forward the laser scan data, it is important that ClientSensor.laser.type is set to simple, and that ClientSensor.laser.address is set to the IP address (with port) of the computer the bridge is running.

Subscribed Topics

  • /scan (sensor_msgs/msg/LaserScan)

    The laserscan topic of the first laser to translate and forward to the ROKIT Locator.

  • /scan2 (sensor_msgs/msg/LaserScan)

    The laserscan topic of the second laser to translate and forward to the ROKIT Locator.

  • /odom (nav_msgs/msg/Odometry)

    The odometry topic to translate and forward to the ROKIT Locator. Only used when enable_odometry is set to true.

  • /initialpose (geometry_msgs/msg/PoseWithCovarianceStamped)

    Set a seed pose to help localization. RViz by default sends a message of this type and topic when the user clicks on the "2D Pose Estimate" button in the toolbar.

Published Topics

Map Creation
Map Recording
Localization
Map Expansion

Services

    rosservice call /bridge_node/recording_set_current_pose "pose:
        x: -0.357
        y: 32.3
        theta: -0.23"

server_bridge_node

This node provides an interface to the map server.

Start Server Bridge Node

Start the server bridge node with

ros2 launch bosch_locator_bridge server_bridge.launch.xml bridge_ip:=<HOST_IP> locator_ip:=<LOCATOR_IP> locator_user:=<USER> locator_password:=<PASSWORD>

where - <HOST_IP> is the IP address of the computer the bridge is to be started - <LOCATOR_IP> is the IP address of the computer where the ROKIT Locator is running - <USER> and <PASSWORD> are the credentials to log into the ROKIT Locator

Services

Caveats

ROKIT Locator closes connection

The ROKIT Locator performs a strict input validation checks and closes the connection, if it receives data that is outside of its specified range. If you see error messages of this kind in the output of the ROS bridge:

Connection reset by peer

Double check the data sent and compare it with the acceptable values in the ROKIT Locator API documentation.

Also peek in the LocalizationClient's syslog file (see the ROKIT Locator documentation) for hints (usually validation of ... failed).

Error message: SENSOR_NOT_AVAILABLE

This can happen if you switch the ROKIT Locator into a mode where it requires e.g. laser data, but none is available (e.g. no laser data is sent with a few hundred miliseconds after the mode switch).

To avoid this, make sure LaserScan messages are sent to the bridge before switching the ROKIT Locator mode.

Support of earlier versions of ROKIT Locator

Note that version 1.6 and earlier of ROKIT Locator were developed for ROS Galactic, and bosch_locator_bridge_utils does not built with ROS Humble. But if you want to build bosch_locator_bridge only, you can ignore bosch_locator_bridge_utils by putting a file named COLCON_IGNORE in the package folder:

touch locator_ros_bridge/bosch_locator_bridge_utils/COLCON_IGNORE

But if you need the bosch_locator_bridge_utils package, see issue #50.

If you have version 1.6, checkout the corresponding tag:

git checkout 2.1.9 -b galactic-v1.6

And if you have version 1.5:

git checkout 2.1.8 -b galactic-v1.5

And if you have version 1.4:

git checkout 2.1.6 -b galactic-v1.4

And if you have version 1.3:

git checkout 2.1.4 -b galactic-v1.3

And if you have version 1.2:

git checkout 2.1.2 -b galactic-v1.2
CHANGELOG

Changelog for package bosch_locator_bridge

2.1.10 (2023-10-31) -----------* update compatible Locator version to 1.8 * Document the map expansion workflow * Add rviz config files for map expansion * Add services and interfaces for map expansion * Add expandmap_state in control mode * Remove field distanceToLastLC in ClientLocalizationVisualizationDatagram * Introduce parameter odometry_velocity_set of odometry message * Configurable Locator ports * Contributors: Sheung Ying Yuen-Wille, Stefan Laible

2.1.9 (2023-03-23)

  • Try to stop everything before setting config list (#35)
  • Add errorFlags and infoFlags fields to ClientLocalizationPose (#33)
  • Update to ROKIT Locator version 1.6
  • Contributors: Stefan Laible

2.1.8 (2023-02-14)

  • Support setting arbitrary Locator config entries
  • Update module versions in server node
  • Use mutex to just make one json_rpc_call at a time
  • Contributors: Fabian K

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Launch files

  • launch/bridge.launch.xml
    • Copyright (c) 2021 - for information on the respective copyright owner see the NOTICE file and/or the repository https://github.com/boschglobal/locator_ros_bridge. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
      • bridge_ip [default: 172.17.0.1]
      • locator_ip [default: 127.0.0.1]
      • locator_RPC_Port [default: 8080]
      • locator_binaryPortsStart [default: 9004]
      • bridge_node_name [default: bridge_node]
      • locator_user [default: admin]
      • locator_password [default: admin]
      • enable_odometry [default: false]
      • laser_datagram_port [default: 2112]
      • laser_mirror_scans [default: false]
      • laser_x [default: 0.0]
      • laser_y [default: 0.0]
      • laser_yaw [default: 0.0]
      • laser_use_intensities [default: false]
      • laser2_enable [default: false]
      • laser2_datagram_port [default: 2113]
      • laser2_mirror_scans [default: false]
      • laser2_x [default: 0.0]
      • laser2_y [default: 0.0]
      • laser2_yaw [default: 0.0]
      • laser2_use_intensities [default: false]
      • enable_reflector_markers [default: false]
      • odom_datagram_port [default: 1111]
      • scan_topic [default: /scan]
      • scan2_topic [default: /scan2]
      • odom_topic [default: /odom]
      • odometry_velocity_set [default: false]
  • launch/bridge_with_bagplayback.launch.xml
    • Copyright (c) 2021 - for information on the respective copyright owner see the NOTICE file and/or the repository https://github.com/boschglobal/locator_ros_bridge. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
      • bridge_ip [default: 172.17.0.1]
      • locator_ip [default: 127.0.0.1]
      • locator_RPC_Port [default: 8080]
      • locator_binaryPortsStart [default: 9004]
      • bridge_node_name [default: bridge_node]
      • locator_user [default: admin]
      • locator_password [default: admin]
      • enable_odometry [default: false]
      • bag [default: ]
      • laser_datagram_port [default: 2112]
      • laser_mirror_scans [default: false]
      • laser_x [default: 0.0]
      • laser_y [default: 0.0]
      • laser_yaw [default: 0.0]
      • laser_use_intensities [default: false]
      • laser2_enable [default: false]
      • laser2_datagram_port [default: 2113]
      • laser2_mirror_scans [default: false]
      • laser2_x [default: 0.0]
      • laser2_y [default: 0.0]
      • laser2_yaw [default: 0.0]
      • laser2_use_intensities [default: false]
      • enable_reflector_markers [default: false]
      • odom_datagram_port [default: 1111]
      • scan_topic [default: /scan]
      • scan2_topic [default: /scan2]
      • odom_topic [default: /odom]
  • launch/server_bridge.launch.xml
    • Copyright (c) 2021 - for information on the respective copyright owner see the NOTICE file and/or the repository https://github.com/boschglobal/locator_ros_bridge. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
      • bridge_ip [default: 172.17.0.1]
      • locator_ip [default: 127.0.0.1]
      • locator_user [default: admin]
      • locator_password [default: admin]
      • update_time [default: 300]

Messages

Services

Plugins

No plugins found.

Recent questions tagged bosch_locator_bridge at Robotics Stack Exchange

bosch_locator_bridge package from locator_ros_bridge repo

bosch_locator_bridge bosch_locator_bridge_utils

API Docs
Browse Code
Wiki

Package Summary

Tags No category tags.
Version 2.1.10
License Apache License 2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

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

Package Description

ROS interface to Rexroth ROKIT Locator

Additional Links

No additional links.

Maintainers

  • Stefan Laible

Authors

No additional authors.
bosch_locator_bridge/README.md

General information about this repository, including legal information and build instructions are given in README.md in the repository root.

bosch_locator_bridge

Overview

This package provides a ROS 2 interface to the Rexroth ROKIT Locator. It translates ROS 2 messages to the ROKIT Locator API (as described in the ROKIT Locator API documentation) and vice versa. It also allows to control the ROKIT Locator via ROS 2 service calls.

The package has been tested under ROS 2 Humble and Ubuntu 22.04. The bridge is compatible with ROKIT Locator version 1.8. If you have an earlier version, see Support of earlier versions of ROKIT Locator.

Quick Start

This section describes how to record your environment, create a map out of the record and localize yourself within it.

Ensure the ROKIT Locator is reachable from your computer

Make sure the ROKIT Locator is installed and running on a computer in your network. You can test this by running the following command in a terminal (replace <LOCATOR_IP> by the IP address of the computer running the ROKIT Locator):

curl --header "Content-Type: application/json" --request POST --data '{"jsonrpc":"2.0","method":"aboutModulesList","params":{"query":{}},"id":1}' http://<LOCATOR_IP>:8080

Start Bridge Node

Start the bridge node with

ros2 launch bosch_locator_bridge bridge.launch.xml bridge_ip:=<HOST_IP> locator_ip:=<LOCATOR_IP> locator_user:=<USER> locator_password:=<PASSWORD> scan_topic:=<SCAN_TOPIC> enable_odometry:=<ENABLE_ODOM> odom_topic:=<ODOM_TOPIC>

where - <HOST_IP> is the IP address of the computer the bridge is to be started - <LOCATOR_IP> is the IP address of the computer where the ROKIT Locator is running - <USER> and <PASSWORD> are the credentials to log into the ROKIT Locator - <SCAN_TOPIC> is the topic name of the laser scans - <ENABLE_ODOM> is a boolean that describes whether you want to forward odometry ROS messages to the ROKIT Locator - <ODOM_TOPIC> is the topic name of the odometry

Since the Laser Localization Software is running in docker, the <HOST_IP> has to be set to docker0 ip address (172.17.0.1) instead of localhost ip address (127.0.0.1) when the user program providing the laser data runs on the same machine.

For additional parameters please refer to the launch file bridge.launch.xml.

Start Visual Recording

Then, make sure there are laser scans published on <SCAN_TOPIC>, and start the visual recording with e.g.

ros2 run rviz2 rviz2 -d $(ros2 pkg prefix bosch_locator_bridge)/share/bosch_locator_bridge/config/locator_bridge_visual_recording.rviz
ros2 service call /bridge_node/start_visual_recording bosch_locator_bridge/srv/StartRecording "name: 'ROS-Quickstart-$(date -Isecond)'"

You should see the laser scans, the robot position and its previous path, and the recording built up over time.

Stop Visual Recording

When you are done, you can stop recording with

ros2 service call /bridge_node/stop_visual_recording std_srvs/srv/Empty

Create Map From Recording

Now, create a map from your recording with

ros2 run rviz2 rviz2 -d $(ros2 pkg prefix bosch_locator_bridge)/share/bosch_locator_bridge/config/locator_bridge_map_creation.rviz
ros2 service call /bridge_node/start_map bosch_locator_bridge/srv/ClientMapStart

When the map has been created, it must be sent to the map server and set as the active map.

ros2 service call /bridge_node/send_map bosch_locator_bridge/srv/ClientMapSend
ros2 service call /bridge_node/set_map bosch_locator_bridge/srv/ClientMapSet

Start Localization

Finally, you can start the localization with

ros2 run rviz2 rviz2 -d $(ros2 pkg prefix bosch_locator_bridge)/share/bosch_locator_bridge/config/locator_bridge_localization.rviz
ros2 service call /bridge_node/start_localization std_srvs/srv/Empty

You can set the initial pose of the robot by clicking the "2D Pose Estimate" button in RViz, and then set the pose in the map.

Stop Localization

When you are done, you can stop the localization with

ros2 service call /bridge_node/stop_localization std_srvs/srv/Empty

Map Expansion

  1. Record and build the prior map (map name: priormap) as usual.
  2. Start localization on this prior map and move until the system is localized.
  3. Make a note of the pose and do not move
  4. Enable map expansion
    rosservice  call /bridge_node/enable_map_expansion "prior_map_name: priormap"
  1. Start visual recording and use the following to visualize the prior map
    rosrun rviz rviz -d `rospack find bosch_locator_bridge`/config/locator_bridge_visual_recording_with_prior_map.rviz
  1. Use the pose in step 3 to set the current pose in the recording
    rosservice call /bridge_node/recording_set_current_pose "pose:
        x: -0.357
        y: 32.3
        theta: -0.23"
  1. Drive around to record the new area as an extension
  2. Stop visual recording
  3. Start mapping with the recording including the initial pose (map expansion is still enabled)
    rosrun rviz rviz -d `rospack find bosch_locator_bridge`/config/locator_bridge_map_creation_with_prior_map.rviz
  1. Disable the map expansion
    rosservice  call /bridge_node/disable_map_expansion

Nodes

bridge_node

This node provides an interface to the localization client.

ROKIT Locator Configuration

To correctly forward the laser scan data, it is important that ClientSensor.laser.type is set to simple, and that ClientSensor.laser.address is set to the IP address (with port) of the computer the bridge is running.

Subscribed Topics

  • /scan (sensor_msgs/msg/LaserScan)

    The laserscan topic of the first laser to translate and forward to the ROKIT Locator.

  • /scan2 (sensor_msgs/msg/LaserScan)

    The laserscan topic of the second laser to translate and forward to the ROKIT Locator.

  • /odom (nav_msgs/msg/Odometry)

    The odometry topic to translate and forward to the ROKIT Locator. Only used when enable_odometry is set to true.

  • /initialpose (geometry_msgs/msg/PoseWithCovarianceStamped)

    Set a seed pose to help localization. RViz by default sends a message of this type and topic when the user clicks on the "2D Pose Estimate" button in the toolbar.

Published Topics

Map Creation
Map Recording
Localization
Map Expansion

Services

    rosservice call /bridge_node/recording_set_current_pose "pose:
        x: -0.357
        y: 32.3
        theta: -0.23"

server_bridge_node

This node provides an interface to the map server.

Start Server Bridge Node

Start the server bridge node with

ros2 launch bosch_locator_bridge server_bridge.launch.xml bridge_ip:=<HOST_IP> locator_ip:=<LOCATOR_IP> locator_user:=<USER> locator_password:=<PASSWORD>

where - <HOST_IP> is the IP address of the computer the bridge is to be started - <LOCATOR_IP> is the IP address of the computer where the ROKIT Locator is running - <USER> and <PASSWORD> are the credentials to log into the ROKIT Locator

Services

Caveats

ROKIT Locator closes connection

The ROKIT Locator performs a strict input validation checks and closes the connection, if it receives data that is outside of its specified range. If you see error messages of this kind in the output of the ROS bridge:

Connection reset by peer

Double check the data sent and compare it with the acceptable values in the ROKIT Locator API documentation.

Also peek in the LocalizationClient's syslog file (see the ROKIT Locator documentation) for hints (usually validation of ... failed).

Error message: SENSOR_NOT_AVAILABLE

This can happen if you switch the ROKIT Locator into a mode where it requires e.g. laser data, but none is available (e.g. no laser data is sent with a few hundred miliseconds after the mode switch).

To avoid this, make sure LaserScan messages are sent to the bridge before switching the ROKIT Locator mode.

Support of earlier versions of ROKIT Locator

Note that version 1.6 and earlier of ROKIT Locator were developed for ROS Galactic, and bosch_locator_bridge_utils does not built with ROS Humble. But if you want to build bosch_locator_bridge only, you can ignore bosch_locator_bridge_utils by putting a file named COLCON_IGNORE in the package folder:

touch locator_ros_bridge/bosch_locator_bridge_utils/COLCON_IGNORE

But if you need the bosch_locator_bridge_utils package, see issue #50.

If you have version 1.6, checkout the corresponding tag:

git checkout 2.1.9 -b galactic-v1.6

And if you have version 1.5:

git checkout 2.1.8 -b galactic-v1.5

And if you have version 1.4:

git checkout 2.1.6 -b galactic-v1.4

And if you have version 1.3:

git checkout 2.1.4 -b galactic-v1.3

And if you have version 1.2:

git checkout 2.1.2 -b galactic-v1.2
CHANGELOG

Changelog for package bosch_locator_bridge

2.1.10 (2023-10-31) -----------* update compatible Locator version to 1.8 * Document the map expansion workflow * Add rviz config files for map expansion * Add services and interfaces for map expansion * Add expandmap_state in control mode * Remove field distanceToLastLC in ClientLocalizationVisualizationDatagram * Introduce parameter odometry_velocity_set of odometry message * Configurable Locator ports * Contributors: Sheung Ying Yuen-Wille, Stefan Laible

2.1.9 (2023-03-23)

  • Try to stop everything before setting config list (#35)
  • Add errorFlags and infoFlags fields to ClientLocalizationPose (#33)
  • Update to ROKIT Locator version 1.6
  • Contributors: Stefan Laible

2.1.8 (2023-02-14)

  • Support setting arbitrary Locator config entries
  • Update module versions in server node
  • Use mutex to just make one json_rpc_call at a time
  • Contributors: Fabian K

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Launch files

  • launch/bridge.launch.xml
    • Copyright (c) 2021 - for information on the respective copyright owner see the NOTICE file and/or the repository https://github.com/boschglobal/locator_ros_bridge. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
      • bridge_ip [default: 172.17.0.1]
      • locator_ip [default: 127.0.0.1]
      • locator_RPC_Port [default: 8080]
      • locator_binaryPortsStart [default: 9004]
      • bridge_node_name [default: bridge_node]
      • locator_user [default: admin]
      • locator_password [default: admin]
      • enable_odometry [default: false]
      • laser_datagram_port [default: 2112]
      • laser_mirror_scans [default: false]
      • laser_x [default: 0.0]
      • laser_y [default: 0.0]
      • laser_yaw [default: 0.0]
      • laser_use_intensities [default: false]
      • laser2_enable [default: false]
      • laser2_datagram_port [default: 2113]
      • laser2_mirror_scans [default: false]
      • laser2_x [default: 0.0]
      • laser2_y [default: 0.0]
      • laser2_yaw [default: 0.0]
      • laser2_use_intensities [default: false]
      • enable_reflector_markers [default: false]
      • odom_datagram_port [default: 1111]
      • scan_topic [default: /scan]
      • scan2_topic [default: /scan2]
      • odom_topic [default: /odom]
      • odometry_velocity_set [default: false]
  • launch/bridge_with_bagplayback.launch.xml
    • Copyright (c) 2021 - for information on the respective copyright owner see the NOTICE file and/or the repository https://github.com/boschglobal/locator_ros_bridge. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
      • bridge_ip [default: 172.17.0.1]
      • locator_ip [default: 127.0.0.1]
      • locator_RPC_Port [default: 8080]
      • locator_binaryPortsStart [default: 9004]
      • bridge_node_name [default: bridge_node]
      • locator_user [default: admin]
      • locator_password [default: admin]
      • enable_odometry [default: false]
      • bag [default: ]
      • laser_datagram_port [default: 2112]
      • laser_mirror_scans [default: false]
      • laser_x [default: 0.0]
      • laser_y [default: 0.0]
      • laser_yaw [default: 0.0]
      • laser_use_intensities [default: false]
      • laser2_enable [default: false]
      • laser2_datagram_port [default: 2113]
      • laser2_mirror_scans [default: false]
      • laser2_x [default: 0.0]
      • laser2_y [default: 0.0]
      • laser2_yaw [default: 0.0]
      • laser2_use_intensities [default: false]
      • enable_reflector_markers [default: false]
      • odom_datagram_port [default: 1111]
      • scan_topic [default: /scan]
      • scan2_topic [default: /scan2]
      • odom_topic [default: /odom]
  • launch/server_bridge.launch.xml
    • Copyright (c) 2021 - for information on the respective copyright owner see the NOTICE file and/or the repository https://github.com/boschglobal/locator_ros_bridge. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
      • bridge_ip [default: 172.17.0.1]
      • locator_ip [default: 127.0.0.1]
      • locator_user [default: admin]
      • locator_password [default: admin]
      • update_time [default: 300]

Messages

Services

Plugins

No plugins found.

Recent questions tagged bosch_locator_bridge at Robotics Stack Exchange

No version for distro rolling. Known supported distros are highlighted in the buttons above.

bosch_locator_bridge package from locator_ros_bridge repo

bosch_locator_bridge

API Docs
Browse Code
Wiki

Package Summary

Tags No category tags.
Version 1.0.10
License Apache License 2.0
Build type CATKIN
Use RECOMMENDED

Repository Summary

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

Package Description

ROS interface to Rexroth ROKIT Locator

Additional Links

No additional links.

Maintainers

  • Stefan Laible

Authors

No additional authors.
bosch_locator_bridge/README.md

General information about this repository, including legal information and build instructions are given in README.md in the repository root.

bosch_locator_bridge

Overview

This package provides a ROS 1 interface to the Rexroth ROKIT Locator. It translates ROS 1 messages to the ROKIT Locator API (as described in the ROKIT Locator API documentation) and vice versa. It also allows to control the ROKIT Locator via ROS 1 service calls.

The package has been tested under ROS 1 Noetic and Ubuntu 20.04. The bridge is compatible with ROKIT Locator version 1.8. If you have an earlier version, see Support of earlier versions of ROKIT Locator.

Quick Start

This section describes how to record your environment, create a map out of the record and localize yourself within it.

Ensure the ROKIT Locator is reachable from your computer

Make sure the ROKIT Locator is installed and running on a computer in your network. You can test this by running the following command in a terminal (replace <LOCATOR_IP> by the IP address of the computer running the ROKIT Locator):

curl --header "Content-Type: application/json" --request POST --data '{"jsonrpc":"2.0","method":"aboutModulesList","params":{"query":{}},"id":1}' http://<LOCATOR_IP>:8080

Start Bridge Node

Start the bridge node with

roslaunch bosch_locator_bridge bridge.launch bridge_ip:=<HOST_IP> locator_ip:=<LOCATOR_IP> locator_user:=<USER> locator_password:=<PASSWORD> scan_topic:=<SCAN_TOPIC> enable_odometry:=<ENABLE_ODOM> odom_topic:=<ODOM_TOPIC>

where - <HOST_IP> is the IP address of the computer the bridge is to be started - <LOCATOR_IP> is the IP address of the computer where the ROKIT Locator is running - <USER> and <PASSWORD> are the credentials to log into the ROKIT Locator - <SCAN_TOPIC> is the topic name of the laser scans - <ENABLE_ODOM> is a boolean that describes whether you want to forward odometry ROS messages to the ROKIT Locator - <ODOM_TOPIC> is the topic name of the odometry

Since the Laser Localization Software is running in docker, the <HOST_IP> has to be set to docker0 ip address (172.17.0.1) instead of localhost ip address (127.0.0.1) when the user program providing the laser data runs on the same machine.

For additional parameters please refer to the launch file bridge.launch.

Start Visual Recording

Then, make sure there are laser scans published on <SCAN_TOPIC>, and start the visual recording with e.g.

rosrun rviz rviz -d `rospack find bosch_locator_bridge`/config/locator_bridge_visual_recording.rviz
rosservice call /bridge_node/start_visual_recording "name: 'ROS-Quickstart-$(date -Isecond)'"

You should see the laser scans, the robot position and its previous path, and the recording built up over time.

Stop Visual Recording

When you are done, you can stop recording with

rosservice call /bridge_node/stop_visual_recording

Create Map From Recording

Now, create a map from your recording with

rosrun rviz rviz -d `rospack find bosch_locator_bridge`/config/locator_bridge_map_creation.rviz
rosservice call /bridge_node/start_map "" ""

When the map has been created, it must be sent to the map server and set as the active map.

rosservice call /bridge_node/send_map ""
rosservice call /bridge_node/set_map ""

Start Localization

Finally, you can start the localization with

rosrun rviz rviz -d `rospack find bosch_locator_bridge`/config/locator_bridge_localization.rviz
rosservice call /bridge_node/start_localization

You can set the initial pose of the robot by clicking the "2D Pose Estimate" button in RViz, and then set the pose in the map.

Stop Localization

When you are done, you can stop the localization with

rosservice call /bridge_node/stop_localization

Map Expansion

  1. Record and build the prior map (map name: priormap) as usual.
  2. Start localization on this prior map and move until the system is localized.
  3. Make a note of the pose and do not move
  4. Enable map expansion
    rosservice  call /bridge_node/enable_map_expansion "prior_map_name: priormap"
  1. Start visual recording and use the following to visualize the prior map
    rosrun rviz rviz -d `rospack find bosch_locator_bridge`/config/locator_bridge_visual_recording_with_prior_map.rviz
  1. Use the pose in step 3 to set the current pose in the recording
    rosservice call /bridge_node/recording_set_current_pose "pose:
        x: -0.357
        y: 32.3
        theta: -0.23"
  1. Drive around to record the new area as an extension
  2. Stop visual recording
  3. Start mapping with the recording including the initial pose (map expansion is still enabled)
    rosrun rviz rviz -d `rospack find bosch_locator_bridge`/config/locator_bridge_map_creation_with_prior_map.rviz
  1. Disable the map expansion
    rosservice  call /bridge_node/disable_map_expansion

Nodes

bridge_node

This node provides an interface to the localization client.

ROKIT Locator Configuration

The bridge looks for ROS parameters under /bridge_node/localization_client_config and sets these to the ROKIT Locator configuration. This is done only once, during the start of the bridge_node. See the ROKIT Locator API documentation section 8.5.4 for a list of possible options.

To correctly forward the laser scan data, it is important that ClientSensor.laser.type is set to simple, and that ClientSensor.laser.address is set to the IP address (with port) of the computer the bridge is running.

Subscribed Topics

The laserscan topic of the first laser to translate and forward to the ROKIT Locator.

The laserscan topic of the second laser to translate and forward to the ROKIT Locator.

  • /odom (nav_msgs/Odometry)

    The odometry topic to translate and forward to the ROKIT Locator. Only used when enable_odometry is set to true.

  • /initialpose (geometry_msgs/PoseWithCovarianceStamped)

    Set a seed pose to help localization. RViz by default sends a message of this type and topic when the user clicks on the "2D Pose Estimate" button in the toolbar.

Published Topics

Map Creation
Map Recording
Localization
Map Expansion

Services

    rosservice call /bridge_node/recording_set_current_pose "pose:
        x: -0.357
        y: 32.3
        theta: -0.23"

server_bridge_node

This node provides an interface to the map server.

Start Server Bridge Node

Start the server bridge node with

roslaunch bosch_locator_bridge server_bridge.launch bridge_ip:=<HOST_IP> locator_ip:=<LOCATOR_IP> locator_user:=<USER> locator_password:=<PASSWORD>

where - <HOST_IP> is the IP address of the computer the bridge is to be started - <LOCATOR_IP> is the IP address of the computer where the ROKIT Locator is running - <USER> and <PASSWORD> are the credentials to log into the ROKIT Locator

Services

Caveats

ROKIT Locator closes connection

The ROKIT Locator performs a strict input validation checks and closes the connection, if it receives data that is outside of its specified range. If you see error messages of this kind in the output of the ROS bridge:

Connection reset by peer

Double check the data sent and compare it with the acceptable values in the ROKIT Locator API documentation.

Also peek in the LocalizationClient's syslog file (see the ROKIT Locator documentation) for hints (usually validation of ... failed).

Error message: SENSOR_NOT_AVAILABLE

This can happen if you switch the ROKIT Locator into a mode where it requires e.g. laser data, but none is available (e.g. no laser data is sent with a few hundred miliseconds after the mode switch).

To avoid this, make sure LaserScan messages are sent to the bridge before switching the ROKIT Locator mode.

Support of earlier versions of ROKIT Locator

If you have version 1.6 of ROKIT Locator, checkout the corresponding tag:

git checkout 1.0.9 -b noetic-v1.6

And if you have version 1.5:

git checkout 1.0.8 -b noetic-v1.5

And if you have version 1.4:

git checkout 1.0.6 -b noetic-v1.4

And if you have version 1.3:

git checkout 1.0.4 -b noetic-v1.3

And if you have version 1.2:

git checkout 1.0.2 -b noetic-v1.2
CHANGELOG

Changelog for package bosch_locator_bridge

1.0.10 (2023-10-20) -----------* Update to ROKIT Locator version 1.8 * Document the map expansion workflow * Add rviz config files for map expansion * Add services and interfaces for map expansion * Add expandmap_state in control mode * Remove field distanceToLastLC in ClientLocalizationVisualizationDatagram * Introduce parameter odometry_velocity_set of odometry message * Configurable Locator ports * Contributors: Sheung Ying Yuen-Wille

1.0.9 (2023-03-21)

  • Try to stop everything before setting config list (#38)
  • Add errorFlags and infoFlags fields to ClientLocalizationPose (#32)
  • Update to ROKIT Locator version 1.6
  • Contributors: Sheung Ying Yuen-Wille, Stefan Laible

1.0.8 (2023-01-30)

  • Support arrays in config for server node
  • Update module versions in server node
  • Use mutex to just make one json_rpc_call at a time
  • Contributors: Stefan Laible

1.0.7 (2022-09-08)

  • Fixed a bug that could cause latency in localization poses
  • Remove tf broadcaster
  • Support arrays in config
  • Check if laser scan message is valid
  • Update to ROKIT Locator version 1.5
  • Contributors: Fabian K

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Launch files

  • launch/bridge.launch
    • Copyright (c) 2021 - for information on the respective copyright owner see the NOTICE file and/or the repository https://github.com/boschglobal/locator_ros_bridge. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
      • bridge_ip [default: 172.17.0.1]
      • locator_ip [default: 127.0.0.1]
      • locator_RPC_Port [default: 8080]
      • locator_binaryPortsStart [default: 9004]
      • bridge_node_name [default: bridge_node]
      • locator_user [default: admin]
      • locator_password [default: admin]
      • enable_odometry [default: false]
      • laser_datagram_port [default: 2112]
      • laser_mirror_scans [default: false]
      • laser_x [default: 0.0]
      • laser_y [default: 0.0]
      • laser_yaw [default: 0.0]
      • laser_use_intensities [default: false]
      • laser2_enable [default: false]
      • laser2_datagram_port [default: 2113]
      • laser2_mirror_scans [default: false]
      • laser2_x [default: 0.0]
      • laser2_y [default: 0.0]
      • laser2_yaw [default: 0.0]
      • laser2_use_intensities [default: false]
      • enable_reflector_markers [default: false]
      • odom_datagram_port [default: 1111]
      • scan_topic [default: /scan]
      • scan2_topic [default: /scan2]
      • odom_topic [default: /odom]
      • odometry_velocity_set [default: false] — set to true if the velocity in the odometry should be used
  • launch/server_bridge.launch
    • Copyright (c) 2021 - for information on the respective copyright owner see the NOTICE file and/or the repository https://github.com/boschglobal/locator_ros_bridge. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
      • bridge_ip [default: 172.17.0.1]
      • locator_ip [default: 127.0.0.1]
      • locator_user [default: admin]
      • locator_password [default: admin]
  • launch/bridge_with_bagplayback.launch
    • Copyright (c) 2021 - for information on the respective copyright owner see the NOTICE file and/or the repository https://github.com/boschglobal/locator_ros_bridge. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
      • bridge_ip [default: 172.17.0.1]
      • locator_ip [default: 127.0.0.1]
      • locator_RPC_Port [default: 8080]
      • locator_binaryPortsStart [default: 9004]
      • bridge_node_name [default: bridge_node]
      • locator_user [default: admin]
      • locator_password [default: admin]
      • enable_odometry [default: false]
      • bag
      • laser_datagram_port [default: 2112]
      • laser_mirror_scans [default: false]
      • laser_x [default: 0.0]
      • laser_y [default: 0.0]
      • laser_yaw [default: 0.0]
      • laser_use_intensities [default: false]
      • laser2_enable [default: false]
      • laser2_datagram_port [default: 2113]
      • laser2_mirror_scans [default: false]
      • laser2_x [default: 0.0]
      • laser2_y [default: 0.0]
      • laser2_yaw [default: 0.0]
      • laser2_use_intensities [default: false]
      • enable_reflector_markers [default: false]
      • odom_datagram_port [default: 1111]
      • scan_topic [default: /scan]
      • scan2_topic [default: /scan2]
      • odom_topic [default: /odom]
      • odometry_velocity_set [default: false]

Messages

Services

Plugins

No plugins found.

Recent questions tagged bosch_locator_bridge at Robotics Stack Exchange

No version for distro ardent. Known supported distros are highlighted in the buttons above.
No version for distro bouncy. Known supported distros are highlighted in the buttons above.
No version for distro crystal. Known supported distros are highlighted in the buttons above.
No version for distro eloquent. Known supported distros are highlighted in the buttons above.
No version for distro dashing. Known supported distros are highlighted in the buttons above.
No version for distro galactic. Known supported distros are highlighted in the buttons above.

bosch_locator_bridge package from locator_ros_bridge repo

bosch_locator_bridge

API Docs
Browse Code
Wiki

Package Summary

Tags No category tags.
Version 2.0.10
License Apache License 2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/boschglobal/locator_ros_bridge.git
VCS Type git
VCS Version foxy
Last Updated 2023-11-03
Dev Status MAINTAINED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

ROS interface to Rexroth ROKIT Locator

Additional Links

No additional links.

Maintainers

  • Stefan Laible

Authors

No additional authors.
bosch_locator_bridge/README.md

General information about this repository, including legal information and build instructions are given in README.md in the repository root.

bosch_locator_bridge

Overview

This package provides a ROS 2 interface to the Rexroth ROKIT Locator. It translates ROS 2 messages to the ROKIT Locator API (as described in the ROKIT Locator API documentation) and vice versa. It also allows to control the ROKIT Locator via ROS 2 service calls.

The package has been tested under ROS 2 Foxy and Ubuntu 20.04. The bridge is compatible with ROKIT Locator version 1.6. If you have an earlier version, see Support of earlier versions of ROKIT Locator. For later versions the bridge is available for ROS 2 Humble and Ubuntu 22.04. Foxy is no longer supported.

Quick Start

This section describes how to record your environment, create a map out of the record and localize yourself within it.

Ensure the ROKIT Locator is reachable from your computer

Make sure the ROKIT Locator is installed and running on a computer in your network. You can test this by running the following command in a terminal (replace <LOCATOR_IP> by the IP address of the computer running the ROKIT Locator):

curl --header "Content-Type: application/json" --request POST --data '{"jsonrpc":"2.0","method":"aboutModulesList","params":{"query":{}},"id":1}' http://<LOCATOR_IP>:8080

Start Bridge Node

Start the bridge node with

ros2 launch bosch_locator_bridge bridge.launch.xml bridge_ip:=<HOST_IP> locator_ip:=<LOCATOR_IP> locator_user:=<USER> locator_password:=<PASSWORD> scan_topic:=<SCAN_TOPIC> enable_odometry:=<ENABLE_ODOM> odom_topic:=<ODOM_TOPIC>

where - <HOST_IP> is the IP address of the computer the bridge is to be started - <LOCATOR_IP> is the IP address of the computer where the ROKIT Locator is running - <USER> and <PASSWORD> are the credentials to log into the ROKIT Locator - <SCAN_TOPIC> is the topic name of the laser scans - <ENABLE_ODOM> is a boolean that describes whether you want to forward odometry ROS messages to the ROKIT Locator - <ODOM_TOPIC> is the topic name of the odometry

Since the Laser Localization Software is running in docker, the <HOST_IP> has to be set to docker0 ip address (172.17.0.1) instead of localhost ip address (127.0.0.1) when the user program providing the laser data runs on the same machine.

For additional parameters please refer to the launch file bridge.launch.xml.

Start Visual Recording

Then, make sure there are laser scans published on <SCAN_TOPIC>, and start the visual recording with e.g.

ros2 run rviz2 rviz2 -d $(ros2 pkg prefix bosch_locator_bridge)/share/bosch_locator_bridge/config/locator_bridge_visual_recording.rviz
ros2 service call /bridge_node/start_visual_recording bosch_locator_bridge/srv/StartRecording "name: 'ROS-Quickstart-$(date -Isecond)'"

You should see the laser scans, the robot position and its previous path, and the recording built up over time.

Stop Visual Recording

When you are done, you can stop recording with

ros2 service call /bridge_node/stop_visual_recording std_srvs/srv/Empty

Create Map From Recording

Now, create a map from your recording with

ros2 run rviz2 rviz2 -d $(ros2 pkg prefix bosch_locator_bridge)/share/bosch_locator_bridge/config/locator_bridge_map_creation.rviz
ros2 service call /bridge_node/start_map bosch_locator_bridge/srv/ClientMapStart

When the map has been created, it must be sent to the map server and set as the active map.

ros2 service call /bridge_node/send_map bosch_locator_bridge/srv/ClientMapSend
ros2 service call /bridge_node/set_map bosch_locator_bridge/srv/ClientMapSet

Start Localization

Finally, you can start the localization with

ros2 run rviz2 rviz2 -d $(ros2 pkg prefix bosch_locator_bridge)/share/bosch_locator_bridge/config/locator_bridge_localization.rviz
ros2 service call /bridge_node/start_localization std_srvs/srv/Empty

You can set the initial pose of the robot by clicking the "2D Pose Estimate" button in RViz, and then set the pose in the map.

Stop Localization

When you are done, you can stop the localization with

ros2 service call /bridge_node/stop_localization std_srvs/srv/Empty

Nodes

bridge_node

This node provides an interface to the localization client.

ROKIT Locator Configuration

To correctly forward the laser scan data, it is important that ClientSensor.laser.type is set to simple, and that ClientSensor.laser.address is set to the IP address (with port) of the computer the bridge is running.

Subscribed Topics

  • /scan (sensor_msgs/msg/LaserScan)

    The laserscan topic of the first laser to translate and forward to the ROKIT Locator.

  • /scan2 (sensor_msgs/msg/LaserScan)

    The laserscan topic of the second laser to translate and forward to the ROKIT Locator.

  • /odom (nav_msgs/msg/Odometry)

    The odometry topic to translate and forward to the ROKIT Locator. Only used when enable_odometry is set to true.

  • /initialpose (geometry_msgs/msg/PoseWithCovarianceStamped)

    Set a seed pose to help localization. RViz by default sends a message of this type and topic when the user clicks on the "2D Pose Estimate" button in the toolbar.

Published Topics

Map Creation
Map Recording
Localization

Services

server_bridge_node

This node provides an interface to the map server.

Start Server Bridge Node

Start the server bridge node with

ros2 launch bosch_locator_bridge server_bridge.launch.xml bridge_ip:=<HOST_IP> locator_ip:=<LOCATOR_IP> locator_user:=<USER> locator_password:=<PASSWORD>

where - <HOST_IP> is the IP address of the computer the bridge is to be started - <LOCATOR_IP> is the IP address of the computer where the ROKIT Locator is running - <USER> and <PASSWORD> are the credentials to log into the ROKIT Locator

Services

Caveats

ROKIT Locator closes connection

The ROKIT Locator performs a strict input validation checks and closes the connection, if it receives data that is outside of its specified range. If you see error messages of this kind in the output of the ROS bridge:

Connection reset by peer

Double check the data sent and compare it with the acceptable values in the ROKIT Locator API documentation.

Also peek in the LocalizationClient's syslog file (see the ROKIT Locator documentation) for hints (usually validation of ... failed).

Error message: SENSOR_NOT_AVAILABLE

This can happen if you switch the ROKIT Locator into a mode where it requires e.g. laser data, but none is available (e.g. no laser data is sent with a few hundred miliseconds after the mode switch).

To avoid this, make sure LaserScan messages are sent to the bridge before switching the ROKIT Locator mode.

Support of earlier versions of ROKIT Locator

If you have version 1.6 of ROKIT Locator, checkout the corresponding tag:

git checkout 2.0.10 -b foxy-v1.6

And if you have version 1.5:

git checkout 2.0.9 -b foxy-v1.5

And if you have version 1.4:

git checkout 2.0.7 -b foxy-v1.4

And if you have version 1.3:

git checkout 2.0.4 -b foxy-v1.3

And if you have version 1.2:

git checkout 2.0.2 -b foxy-v1.2
CHANGELOG

Changelog for package bosch_locator_bridge

2.0.10 (2023-03-23)

  • Try to stop everything before setting config list (#37)
  • Add errorFlags and infoFlags fields to ClientLocalizationPose (#34)
  • Update to ROKIT Locator version 1.6
  • Contributors: Sheung Ying Yuen-Wille, Stefan Laible

2.0.9 (2023-02-22)

  • Support setting arbitrary Locator config entries
  • Update module versions in server node
  • Use mutex to just make one json_rpc_call at a time
  • Contributors: Stefan Laible

2.0.8 (2022-09-08)

  • Fixed a bug that could cause latency in localization poses
  • Remove tf broadcaster
  • Check if laser scan message is valid
  • Add refresh timer to service callback group to avoid overlapping json rpc calls
  • Update to ROKIT Locator version 1.5
  • Contributors: Fabian K

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Launch files

  • launch/bridge.launch.xml
    • Copyright (c) 2021 - for information on the respective copyright owner see the NOTICE file and/or the repository https://github.com/boschglobal/locator_ros_bridge. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
      • bridge_ip [default: 172.17.0.1]
      • locator_ip [default: 127.0.0.1]
      • locator_user [default: admin]
      • locator_password [default: admin]
      • enable_odometry [default: false]
      • laser_datagram_port [default: 4242]
      • laser_mirror_scans [default: false]
      • laser_x [default: 0.0]
      • laser_y [default: 0.0]
      • laser_yaw [default: 0.0]
      • laser_use_intensities [default: false]
      • laser2_enable [default: false]
      • laser2_datagram_port [default: 2113]
      • laser2_mirror_scans [default: false]
      • laser2_x [default: 0.0]
      • laser2_y [default: 0.0]
      • laser2_yaw [default: 0.0]
      • laser2_use_intensities [default: false]
      • enable_reflector_markers [default: false]
      • odom_datagram_port [default: 1111]
      • scan_topic [default: /scan]
      • scan2_topic [default: /scan2]
      • odom_topic [default: /odom]
  • launch/bridge_with_bagplayback.launch.xml
    • Copyright (c) 2021 - for information on the respective copyright owner see the NOTICE file and/or the repository https://github.com/boschglobal/locator_ros_bridge. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
      • bridge_ip [default: 172.17.0.1]
      • locator_ip [default: 127.0.0.1]
      • locator_user [default: admin]
      • locator_password [default: admin]
      • enable_odometry [default: false]
      • bag [default: ]
      • laser_datagram_port [default: 4242]
      • laser_mirror_scans [default: false]
      • laser_x [default: 0.0]
      • laser_y [default: 0.0]
      • laser_yaw [default: 0.0]
      • laser_use_intensities [default: false]
      • laser2_enable [default: false]
      • laser2_datagram_port [default: 2113]
      • laser2_mirror_scans [default: false]
      • laser2_x [default: 0.0]
      • laser2_y [default: 0.0]
      • laser2_yaw [default: 0.0]
      • laser2_use_intensities [default: false]
      • enable_reflector_markers [default: false]
      • odom_datagram_port [default: 1111]
      • scan_topic [default: /scan]
      • scan2_topic [default: /scan2]
      • odom_topic [default: /odom]
  • launch/server_bridge.launch.xml
    • Copyright (c) 2021 - for information on the respective copyright owner see the NOTICE file and/or the repository https://github.com/boschglobal/locator_ros_bridge. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
      • bridge_ip [default: 172.17.0.1]
      • locator_ip [default: 127.0.0.1]
      • locator_user [default: admin]
      • locator_password [default: admin]
      • update_time [default: 300]

Messages

Services

Plugins

No plugins found.

Recent questions tagged bosch_locator_bridge at Robotics Stack Exchange

No version for distro lunar. Known supported distros are highlighted in the buttons above.
No version for distro jade. Known supported distros are highlighted in the buttons above.
No version for distro indigo. Known supported distros are highlighted in the buttons above.
No version for distro hydro. Known supported distros are highlighted in the buttons above.
No version for distro kinetic. Known supported distros are highlighted in the buttons above.
No version for distro melodic. Known supported distros are highlighted in the buttons above.