How it works
Resource and Data Automation (RDA) for ROS 2
What is RDA?
Resource and Data Automation for ROS 2 (RDA) streamlines the entire ROS data lifecycle—from capture to insight—without writing a single line of code and centrally managed from the Heex Smart-Data SaaS platform.
- It imports ROS topics from ROS bags with a single CLI command to automatically generate Data Sources in Heex
- You can then create Triggers with Monitors, Conditions, and Recorders
- Have them deployed automatically to your target systems’ Heex agents
- And start your scenario-based data capture in minutes
See it in action:
Pre-requisites
-
ROS2 Installation: Heex supports the following distributions:
- Galactic (Ubuntu 20.04)
- Humble (Ubuntu 22.04)
- Jazzy (Ubuntu 24.04)
-
Custom Packages: If your environment uses custom ROS packages, Heex needs access to them:
- Agent Mode: Add custom build paths to
FILES_TO_SOURCE_IN_SERVICES_ENV
in the Agent Configuration - SDK Mode: Source all custom builds in the terminal before launching
heexOrchestrator
- Agent Mode: Add custom build paths to
Deployment Options
Agent Deployment Mode
When running in Agent deployment mode:
- RDA runs automatically with standard ROS2 installations (in
/opt/ros/ros2-distribution
) - For custom installations or multiple distributions, follow the ROS configuration guide before packaging the agent
SDK Mode
When running in SDK mode:
- Generate the
implementations.json
file as described in the SDK mode documentation - RDA implementations will run automatically once properly configured
How RDA Works
RDA Monitor
The RDA Monitor creates a ROS2 node called rda_monitor
that:
- Subscribes to all signals defined in your Heex Cloud configuration
- Continuously evaluates these signals against your predefined conditions
- Generates Events when conditions are met, triggering data capture workflows
RDA Recorder
The RDARecorder creates a ROS2 node called rda_recorder
that:
- Subscribes to all signals configured for recording in the Heex platform
- Maintains a rolling buffer of each signal’s data based on your specified time ranges
- Automatically clears data outside of the defined buffer ranges to optimize resource usage
- Creates MCAP recordings when triggered by Events from the RDAMonitor
- Processes and transmits recordings to Heex Cloud for immediate analysis
Need help getting started? Check out our Quick Start Guide or contact our support team at support@heex.io
.