raros is an application consisting of different subsystems that can be used to control a physical robot. This application was developed as part of a project at the Lucerne University of Applied Sciences and Arts with the goal of evaluating how such a control system can be implemented with ROS2.
Ultimately, the project should be able to be used to teach students the basic concepts of programming in a playful way, as they can see their work directly resulting in actions executed by the robot instead of just viewing some text in a terminal.
The project is divided into four main components:
apps/ros2: ROS2 packages for the master controller (RaspberryPi)apps/micro_ros: Code for the microcontroller (Arduino Zero)apps/api: REST-API to access the ROS2 controllerapps/client: Client library to control the robot
Additionally, in the examples directory are some examples of how the client library can be used to control the robot.
The client library is available on Maven Central and can be referenced in your project as follows:
Maven:
<dependency>
<groupId>io.github.francwhite</groupId>
<artifactId>raros-client</artifactId>
<version>1.0.5</version>
</dependency>Gradle:
implementation 'io.github.francwhite:raros-client:1.0.5'All required subsystems for the master controller (RaspberryPi) are available as docker images on GitHub Container Registry. The easiest way to get started is to use the docker-compose.yml file in the root directory of this repository.
Prerequisites:
- Ubuntu 22.04 Server (other Linux distributions may work as well, but are not tested)
- If you want to use the camera, make sure the legacy camera driver is enabled:
sudo raspi-config nonint do_camera 1 - docker is installed
./configdirectory exists for the volume mount
Instructions:
cd [path/to/docker-compose.yaml] # change directory to where the docker-compose.yaml file is located
mkdir config # create config directory, only required on first run
docker-compose up -d # start the containers in detached modeEnsure that the serial port for the communication with the microcontroller is configured correctly in the docker-compose.yaml file.
The default is /dev/ttyACM0.
The code for the microcontroller (Arduino zero) is available in the micro_ros
directory of this repository. To build and flash the software onto the microcontroller, clone the repository and use the flash.sh script located in root of said directory.
Prerequisites:
- PlatformIO CLI is installed
- Arduino is connected to the computer via USB
Instructions:
git clone https://github.com/francWhite/raros.git # clone the repository
cd raros/apps/micro_ros # navigate to the micro_ros directory
chmod +x flash.sh # make the script executable
./flash.sh # build and flash the software onto the microcontrollerMake sure that the controller and microcontroller are running and connected to the same network as the client.
The client library can be used to control the robot over the RobotController interface. An instance of the controller can be created as follows:
import io.github.francwhite.raros.client.controller.RobotControllerFactory;
...
RobotController client = RobotControllerFactory.create(URI.create("http://hostname:8000"))Start the docker containers as described in the installation section. The controller, including its REST-API,
is now available at http://hostname:8000.
The microcontroller is connected to the controller via a serial connection (default is /dev/ttyACM0). After flashing the software onto the microcontroller,
the Arduino will automatically connect to the controller. The onboard LED will light up continuously when the connection is established.
This project is licensed under the MIT License - see the LICENSE file for details.