How frankaemika/franka_ros2 works
Project type and purpose
• This is a ROS 2 integration monorepo for Franka Robotics research arms (“franka_ros2”).
• It provides wrappers around libfranka, hardware interfaces, controllers, simulation support (Gazebo/Ignition), MoveIt configuration, message/action definitions, and example nodes to drive the robot within ROS 2.
• The README confirms it targets ROS 2 Humble, supporting both real and simulated hardware via Docker or native install.
File structure
• Top‐level files: Dockerfile, docker‑compose.yml, Jenkinsfile, GitHub workflows → CI/CD and containerized environment.
• Multiple ROS 2 packages in parallel directories:
• franka_hardware: hardware_interface wrapping libfranka, exposes ROS2 control interfaces and action servers
• franka_gripper: gripper action server
• franka_msgs: custom ROS2 messages, actions, services
• franka_robot_state_broadcaster: state to TF/component broadcaster
• franka_semantic_components: high‐level semantic interfaces (Cartesian pose/velocity, robot model/state wrappers)
• franka_bringup: launch files and controller config for bringing up a real robot
• franka_example_controllers: sample controllers demonstrating how to use the interfaces
• franka_fr3_moveit_config: MoveIt2 planning configuration, SRDFs, launch files
• franka_gazebo: simulation packages for Gazebo and Ignition with hardware plugins and bringup
• integration_launch_testing: end‐to‐end smoke tests
• Each package follows the ROS 2 structure: package.xml, CMakeLists.txt, include/, src/, launch/, config/, test/.
Key insights from the README
• Architecture revolves around ROS 2 nodes, topics, actions, services, and lifecycle managed by launch files.
• Supports real and fake hardware via use_fake_hardware flag in MoveIt launch.
• Recommends Docker for reproducible builds; includes devcontainer support.