Modulo is part of the AICA robotics framework.
It is an extension layer to ROS 2 that adds interoperability support for aica-technology/control-libraries and provides a modular framework for application composition through custom component classes in both C++ and Python.
Modulo API documentation is available at aica-technology.github.io/modulo.
To start developing custom components and controllers with modulo, refer to the aica-technology/component-template repository and corresponding documentation at https://docs.aica.tech/docs/category/custom-components.
The core package implements interoperability between ROS 2 and state_representation data types, allowing state data and parameters to be directly translated and handled as messages on the ROS 2 interface layer.
Modulo components are wrappers for ROS 2 Nodes which abstract low-level ROS methods for greater user convenience and consistency between components.
While ROS 2 Nodes provide a highly flexible and customizable interface, there is often a significant amount of boilerplate code that is duplicated with each new Node. In addition, the interoperability of multiple nodes in an application depends on them using compatible message types and behaving in a generally consistent manner.
The component classes are intended to simplify the development of compatible application modules. They provide more concise methods for adding parameters, services, transforms, topic subscriptions and publications. They also introduce new concepts such as predicate broadcasting, error handling and the direct binding of data attributes to their corresponding interface.
The package provides two variant classes: modulo_components::Component
and modulo_components::LifecycleComponent
.
See the package documentation for more information.
This package defines custom standard interfaces for modulo components.
This package contains shared test fixtures.
It is possible to use a bridge service to interface ROS 2 with ROS 1 in order to publish/subscribe to topics from ROS 1.
ROS provides a docker image with this service. Run the following lines to pull the bridge image, launch an interactive shell, and subsequently start the bridge topic.
# run the bridge image interactively
docker run --rm -it --net=host ros:galactic-ros1-bridge
# start the bridge service in the container
root@docker-desktop:/# ros2 run ros1_bridge dynamic_bridge --bridge-all-topics