Evaluation Guide
The RidgeRun Immersive Teleoperation documentation from RidgeRun is presently being developed. |
If you have any problems or questions, please contact RidgeRun.
RidgeRun Immersive Teleoperation is offered as an open-source project. The project makes use of several of our products that you can evaluate for free at any time. Follow this process to evaluate the application.
Hardware Requirements
- UGV Rover
- NVIDIA Jetson Orin NX devkit.
- 360 Video Dual Camera with RPI IMX477 HQ camera
Evaluation Process
1. Go to this link and download teleop-eval-jetson-orin-JP6.1.tar and APK.
The file teleop-eval-jetson-orin-JP6.1.tar is the Immersive Teleoperation Evaluation Bundle. The package contains evaluation versions of all of the following RidgeRun products used in the demo:
2. Flash your Orin NX devkit with Jetpack 6.
3. Once your board is flashed, from your board, clone the RidgeRun Immersive Teleoperation project:
git clone ...
4. Put the evaluation bundle you downloaded in step 1 in the root of the project. Your project should look like this:
# rr-teleop/ # ├─ docker-compose.yaml # ├─ docker/ # ├─ docker-compose.perf.yaml # ├─ teleop-jetson-orin-JP6.1.tar # Your Evaluation Bundle # ├─ rr-workspace/ # └─ web/ # └─ src/ ...
5. Generate the Jetson-specific .env file (SOC, DISTRO, CUDA, HOST_UID, HOST_GID):
chmod +x scripts/generate-jetson-env.sh scripts/generate-jetson-env.sh
6. Export user/group ids for correct file ownership inside the container if you prefer manual overrides:
export HOST_UID=$(id -u) export HOST_GID=$(id -g)
7. Build the images:
docker compose build rr_teleop
8. Start the container (detached):
The `docker-compose.yaml` file defines several environment variables required by the teleoperations application. In most cases, the defaults are enough.
TELEOP_ADVERTISED_IP=192.168.86.27 TELEOP_COMMAND_PORT=8081 TELEOP_RTSP_ENABLE=true TELEOP_RTSP_PORT=5555 TELEOP_RTSP_MAPPING=stream TELEOP_RTSP_FRAMERATE=30/1
The only setting you typically need to change is TELEOP_ADVERTISED_IP (the robot's IP address on your network). Override any of these at runtime before starting the container. A typical command would be:
TELEOP_ADVERTISED_IP=<Your robot IP address> docker compose up -d
9. Attach to the container
docker compose exec --user admin rr_teleop bash <syntaxhighlight> '''10''' Start the teleoperation application <syntaxhighlight lang=bash> /usr/local/bin/teleop-launch.sh
Robot Operation
1. Follow these steps to setup the web application and the Meta Quest application for robot operation.
2. Follow this guide for the Meta Quest application usage.
3. Follow this guide for the web application usage.