RB-1 Dual UR3: User Guide Manual
RB-1 Dual UR3: User Guide Manual
User Guide Annex - V.2.0
RB-1 Dual UR3
Contents
Contents 1
1. Introduction 3
1.1. Overall robot description 3
1.2. Intended use and safety warnings 4
1.2.1. Safety concept 4
1.2.2. General safety instructions 4
1.3. Applied standards 8
2. Quickstart 9
2.1. Unpacking the robot 9
2.2. Start-up sequence 9
2.3. Pad Teleoperation 9
2.4. Power-off sequence 10
5. Configuration 19
5.1. Limitation on velocity limits 19
5.2. Users & passwords 19
1
User Guide Annex - V.2.0
RB-1 Dual UR3
5.3. Network 21
5.4. Basic robot params 22
5.5. Arm 23
2
User Guide Annex - V.2.0
RB-1 Dual UR3
1. Introduction
Welcome to the RB-1 Dual UR3 user guide annex. This document describes the main differences
and incorporated aspects about the RB-1 robot.
Figure 1. RB-1 Dual UR3 robot
3
User Guide Annex - V.2.0
RB-1 Dual UR3
FORBIDDEN: a forbidden block
“Forbidden” description includes information about the situation and how to avoid it.
MANDATORY: a
mandatory block
1.2.2. General safety instructions
The robot platform should not be moved when the robot is connected to the manual
charger. You could damage the robot.
4
User Guide Annex - V.2.0
RB-1 Dual UR3
Figure 2. RB-1 Base with manual charger should not be moved
Do not touch the copper contacts during the charging process in the charging station.
You could suffer a small electric shock that could cause a slight burn.
Do not sprinkle water or oil on the robot or power charging cord.. The exterior cleaning
of the robot must be done with pressurized air or dry cloth. Contact with water or oil
can cause electric shock or malfunction of the unit.
Figure 3. Do not sprinkle water or oil on the robot
The robot should not be used as a support element or to transport people. You could
damage the robot or injure yourself.
5
User Guide Annex - V.2.0
RB-1 Dual UR3
The robot must not be lifted or pushed from any point. For lifting the vehicle, please
hold the robot by the bottom of the chassis (perform the operation between 2 people).
Incorrect use could damage the robot or injure someone.
Figure 5. The robot must not be lifted or pushed from any point
Do not overload the robot. Check its maximum payload in its technical specification.
Incorrect use could damage the robot or injure someone.
Do not drive the robot outdoors when the weather is rainy. You could damage the
robot.
Do not attempt to disassemble or modify the robot. You could damage the robot or
injure yourself.
Keep the emergency stop pussed if there is an operator close to the robot.
Remember to update maps when the route change to avoid new fixed obstacles. Not
updating maps, you could damage the robot or injure yourself.
Always use the original charger and plug the power cord firmly into the wall outlet.
Incomplete insertion in the wall outlet or the use of another charger could cause the
plug to heat up, possibly causing a fire.
Follow these steps if there is evidence of a battery malfunction. Use personal
protective equipment, such as gloves, safety glasses and lab coat.
6
User Guide Annex - V.2.0
RB-1 Dual UR3
● If batteries are showing evidence of thermal runaway failure, be very cautious
because the gases may be flammable and toxic and failure modes can be
hazardous.
● Disconnect the battery. Do not disassemble or break it.
● Remove the battery from the robot.
● Place the battery in a metal or other container away from combustibles.
7
User Guide Annex - V.2.0
RB-1 Dual UR3
8
User Guide Annex - V.2.0
RB-1 Dual UR3
2. Quickstart
Figure 6. PS4 Pad Operation Mode Figure 7. PS4 Pad Operation Mode
NOTES
● If the Bluetooth connection is lost, the robot will detect this situation and will STOP for
safety.
9
User Guide Annex - V.2.0
RB-1 Dual UR3
● If the Deadman button is NOT pressed, the robot will NOT move.
● Sometimes it is necessary to restart the pad to link it again with the robot controller. To
restart it, press the “Start” button until the light shuts down and afterwards proceed with the
startup sequence.
10
User Guide Annex - V.2.0
RB-1 Dual UR3
3. Robot components
This point describes the main parts of the RB-1 Dual UR3 mobile robot. Every main piece
includes a little description of the mechanical component that composes it.
The next figure shows the main external parts of the default robot:
Figure 8. Main external elements of RB-1 Dual UR3
11
User Guide Annex - V.2.0
RB-1 Dual UR3
12
User Guide Annex - V.2.0
RB-1 Dual UR3
13
User Guide Annex - V.2.0
RB-1 Dual UR3
14
User Guide Annex - V.2.0
RB-1 Dual UR3
Each UR3 arm is linked with its control box. In case of disassembling the arms and
reassembling them, it is important to put each arm in its original position (left or right) and
connect it to the corresponding control box. It is also important to mount the base of the arms
in the original orientation on the bracket, so that the zero position remains the same.
Important!!! Failure to follow these directions carries a high risk of self-collision and serious
damage to the robot and its environment.
Before starting the mechanical disassembly of the arms, it is necessary to disconnect the
cables and loosen the clamps that hold them. To remove one of the arms of the support, just
remove the four screws that hold it, and slowly extract its cable to the outside.
15
User Guide Annex - V.2.0
RB-1 Dual UR3
16
User Guide Annex - V.2.0
RB-1 Dual UR3
Figure 16 - RB-1 Dual UR3 back panel
1. EMERGENCY STOP BUTTON: disables the power and stops the robot. To move the robot
and use the arms, the EMERGENCY BUTTON (red) must be pulled out.
2. LEFT ARM POWER ON BUTTON: powers on the left arm computer. It has a green light
indicator that is turned on when the computer is fully operational (it requires a couple of
minutes since the power on).
3. LEFT ARM POWER OFF BUTTON: powers off the left arm computer.
4. RESTART ROBOT BUTTON: enables the power to the robot after a reboot or emergency
stop button pressed.
5. RESTART ARMS BUTTON: enables the power to the arms after a reboot or emergency.
6. RIGHT ARM POWER ON BUTTON: powers on the right arm computer. It has a green light
indicator that is turned on when the computer is fully operational (it requires a couple of
minutes since the power on).
7. RIGHT ARM POWER OFF BUTTON: powers off the right arm computer.
17
User Guide Annex - V.2.0
RB-1 Dual UR3
8. WI-FI Antennas: Necessary to improve the network performance.
4. Software architecture
4.1. Robot packages
This section gives an overview of the packages included in the workspace of the robot relative
to the dual UR3 arm model (commonly the folder catkin_ws located in the home folder of the
robot). The packages are grouped in different folders within the workspace:
4.1.1. Manipulation
4.1.1.1. universal_robot
Package to control the UR3 arm.
4.1.1.2. Universal_Robots_ROS_Driver
This repository contains the new ur_robot_driver and a couple of helper packages, such as:
● controller_stopper: A small external tool that stops and restarts ros-controllers based on
the robot's state. This can be helpful when the robot is in a state where it won't accept
commands sent from ROS.
● ur_calibration: Package around extracting and converting a robot's factory calibration
information to make it usable by the robot_description.
● ur_controllers: Controllers introduced with this driver, such as speed-scaling-aware
controllers.
● ur_robot_driver: The actual driver package.
4.1.2. Robot
4.1.2.1. rb1_base_common
Common packages of the RB1 Base: URDF description of the RB1 Base, platform messages and
other files for simulation.
● rb1_dual_ur3_moveit_config: This package contains all the moveit configuration files in
order to use the RB1 with a UR3 arm.
18
User Guide Annex - V.2.0
RB-1 Dual UR3
5. Configuration
○ robotnik_base_control/limits/elevator_down/linear_acceleration_limit
○ robotnik_base_control/limits/elevator_down/linear_deceleration_limit
○ robotnik_base_control/limits/elevator_down/linear_speed_limit
○ robotnik_base_control/limits/elevator_down/angular_acceleration_limit
○ robotnik_base_control/limits/elevator_down/angular_deceleration_limit
○ robotnik_base_control/limits/elevator_down/angular_speed_limit
Maximum speed and acceleration is also limited in the servodrives firmware, contact
Robotnik if these values need to be changed.
Password R0b0tn1K
UR Arm
User root
19
User Guide Annex - V.2.0
RB-1 Dual UR3
Password easybot
Safety
password ur
Router (if included)
User robot
Password R0b0tn1K
20
User Guide Annex - V.2.0
RB-1 Dual UR3
5.3. Network
If the RB1 Base has a router, then it will provide its own WiFi network for all internal components
communication and remote control. In the following diagram there are all network connected
devices with their IP addresses:
Figure 23. Robot network schema
Device IP address
Router 192.168.0.1
21
User Guide Annex - V.2.0
RB-1 Dual UR3
22
User Guide Annex - V.2.0
RB-1 Dual UR3
5.5. Arm
The UR arm has installed a VNC server to enable remote access to the UR Polyscope (see 6.1.3.
UR Polyscope). To connect to the UR using VNC you will need to follow these steps:
1. Make sure the arm is powered on.
2. Start the VNC server on UR PC (started by default).
3. Connect to the VNC server using the IP of the arm (using VNC viewer).
23
User Guide Annex - V.2.0
RB-1 Dual UR3
6. Advanced functionality
6.1. UR arm control
The UR ROS driver used to control the arm through ROS is the official one released by Universal
Robots: https://github.com/UniversalRobots/Universal_Robots_ROS_Driver
Please read it carefully before using the robot arm with ROS for an optimal use. Take into
consideration several new features, like the installation of the provided URCap.
As detailed in the previous section the UR arm is not launched by default when turning the robot
on. In any case, the arm can be moved independently from ROS by turning on the UR HMI.
To use the arm with ROS there are different possibilities:
● Control the UR joints with ROS, read their position and exchange I/O signals with the arm
● Only read the joint positions and exchange signals with the arm
If you want to control the UR arm with ROS and not with the UR interface, you need to launch
the external control URCap program.
WARNING : ROS driver cancels some polyscope functionalities
When executing the ROS driver with the control enabled the freedrive button in the robot won’t
work.
On the other hand if you just want to exchange signals with the arm and read its joint position
and still use the UR interface do not launch the URCap program
This way you can exchange signals with the UR arm by publishing and reading from the topic:
rostopic echo /robot/left_arm/ur_hardware_interface_left_arm/io_states -n1
digital_in_states:
-
pin: 0
state: False
...
-
24
User Guide Annex - V.2.0
RB-1 Dual UR3
pin: 17
state: False
digital_out_states:
-
pin: 0
state: False
...
-
pin: 17
state: False
flag_states: []
analog_in_states:
-
pin: 0
state: 0.201416015625
-
pin: 1
state: 0.322265625
analog_out_states:
-
pin: 0
state: 0.00400000018999
-
pin: 1
state: 0.00400000018999
---
You can also open rviz to visualize the robot position.
6.1.1 Joint by Joint with ROS
To move the robot joint by joint with ROS you will need to launch the external control URCap.
To open the interface to move each joint of the UR arm separately execute in another terminal:
ROS_NAMESPACE=robot rosrun rqt_joint_trajectory_controller
rqt_joint_trajectory_controller
25
User Guide Annex - V.2.0
RB-1 Dual UR3
A new window will appear enabling the movement of the different joints by simply scrolling in
the different bars:
Figure 28. RQT Joint Trajectory interface
6.1.2 ROS MoveIt
It is also possible to move the UR arm with MoveIt. To do that it is required to launch the
external control URCap program
When moveit is launched an rviz window is opened where it is possible to move the end effector
of the robot arm to a desired position taking into consideration the whole RB-1 structure and
avoiding possible collisions that might occur. To launch it open another terminal and run:
ROS_NAMESPACE=robot roslaunch rb1_dual_ur3_moveit_config
rb1_dual_ur3_moveit_config.launch
6.1.3 UR Polyscope
26
User Guide Annex - V.2.0
RB-1 Dual UR3
The UR arm might be controlled with the Polyscope interface. For more information about it,
please refer to the UR official manual.
27