You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+11-4Lines changed: 11 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,17 +3,24 @@ Package to support relaying the RS-485 communication device in a UR robot to a r
3
3
4
4
Basically, this starts [`socat`](https://linux.die.net/man/1/socat) to relay the tool communication device to the network socket on port 54321.
5
5
6
+
## Installation
7
+
First, you need to put an `RS485 URCap` into the `programs` folder of your e-series robot.
8
+
You'll find the latest version [here](https://github.com/UniversalRobots/Universal_Robots_ToolComm_Forwarder_URCap/releases) in the *Releases* section.
9
+
Copying can be done either via `scp` or via using a USB stick.
10
+
Next, go through [these steps](doc/install_urcap.md) to install the URCap in Polyscope.
11
+
12
+
6
13
## Usage
7
-
Once the daemon is started, connect to the socket from a remote machine, also using `socat`:
14
+
Once the daemon is started in Polyscope, establish the connection from a remote machine, using `socat`:
8
15
```bash
9
16
# Setup your robot IP here:
10
17
export ROBOT_IP=192.168.56.101
11
-
# Setup the device name that should be available locally. Make sure that your user can write to that location.
18
+
# Setup the name for the device you wish to create. Make sure that your user can write to that location.
After that you should be able to use the device under `${LOCAL_DEVICE_NAME}` just like any local RS-485 tty device.
23
+
After that you should be able to use the device under `${LOCAL_DEVICE_NAME}`(in our case `/tmp/ttyUR`) just like any local RS-485 tty device.
17
24
18
25
## Use inside a ROS application
19
26
The [`ur_robot_driver`](http://wiki.ros.org/ur_robot_driver) has a [convenience script](https://github.com/UniversalRobots/Universal_Robots_ROS_Driver/blob/master/ur_robot_driver/scripts/tool_communication) wrapping the above `socat` call. When running the driver, the e-Series launchfiles provide a [flag](https://github.com/UniversalRobots/Universal_Robots_ROS_Driver/blob/master/ur_robot_driver/launch/ur10e_bringup.launch#L14) for automatically activating the tool communication. The launchfiles also allow setting up communication parameters on the robot directly.
This is a short step-by-step guide how to install the RS485 URCap in Polyscope.
4
+
We assume that you [copied](../README.md#installation) the latest *RS485 URCap* from [here](https://github.com/UniversalRobots/Universal_Robots_ToolComm_Forwarder_URCap/releases) to the `programs` folder of your e-series robot.
5
+
6
+
## Add the URCap to the system
7
+
After startup of the robot, click on the `hamburger` menu item at the top right of
8
+
the screen and select `Settings`.
9
+
10
+

11
+
12
+
In the menu on the left, go down to `System` -> `URCaps` and click the `+` button to add a URCap to the system.
13
+
Choose the RS485 URCap file you previously copied to the robot's `programs` folder and open it.
14
+
15
+

16
+
17
+
Your display should show the `rs485` under `Active URCaps`.
18
+
19
+

20
+
21
+
You now need to restart Polyscope for the changes to take effect.
22
+
23
+
## Confirm the installation
24
+
After restarting and coming back to this page, you should see the `rs485` URCap marked with a green check.
25
+
26
+

27
+
28
+
Finally, under the `Installation` tab, confirm that the RS-485 daemon runs.
0 commit comments