Getting Started

Install ROS 2

SMACC2 targets ROS 2 Jazzy on Ubuntu 24.04. Follow the official installation guide:

• ROS 2 Jazzy Installation

After installing, source the setup file:

source /opt/ros/jazzy/setup.bash

Install SMACC2

Create a ROS 2 workspace:

mkdir -p ~/ros2_ws/src

Clone the SMACC2 repository:

cd ~/ros2_ws/src
git clone https://github.com/robosoft-ai/SMACC2.git

Install dependencies:

cd ~/ros2_ws
rosdep install --from-paths src --ignore-src -r -y

Build:

colcon build

Source the workspace after the build completes:

source ~/ros2_ws/install/setup.bash

Download the SMACC Viewer (RTA)

The SMACC Runtime Analyzer (RTA) is a graphical tool for real-time visualization and debugging of SMACC2 state machines. Download and install instructions are available at:

• SMACC Viewer Installation

For naming conventions, folder structures, and other foundational concepts, see SMACC Basics.