How xarm-developer/xarm_ros works
Project type and purpose
• This is a robotics integration framework built on ROS (1) for UFACTORY xArm series arms (xArm5/6/7, Lite6/UF850).
• It comprises multiple ROS packages for description (URDF/Xacro/meshes), simulation (Gazebo), hardware drivers, controllers, MoveIt! configurations, planning services, API wrappers, vision demos, and example launch scripts.
File structure
• Top-level ROS packages:
• xarm_description: URDF/Xacro, meshes, gazebo plugins
• xarm_gazebo: Gazebo worlds, launch files, plugins
• xarm_controller: ros_control hardware_interface, controller definitions, C++ nodes
• xarm_bringup: driver launch files for real hardware
• xarm_api and xarm_msgs: C++/Python SDK wrappers, ROS services, messages
• xarm_planner: simple MoveIt!-based planning service
• xarm_*moveit_config / uf_robot_moveit_config*: MoveIt! setup for each robot model
• xarm_moveit_servo: real-time jog interface (joystick/keyboard/SpaceMouse)
• xarm_vision: sample vision demos (hand-eye calibration, object detection, grasping)
• examples: various usage demos
• ROS build files: CMakeLists.txt, package.xml, launch/*.launch, config/*.yaml
• Documentation in doc/ and README files
README
• Describes system capabilities: direct driver control, MoveIt! planning, Gazebo simulation, joystick/keyboard servo, vision demos.
• Lists dependencies: ros_control, gazebo_ros_pkgs, MoveIt!, RealSense libraries, easy_handeye, find_object_2d.
• Defines ROS topics (/xarm/xarm_states, /joint_states, /controller_gpio_states), services (/xarm/move_joint, /xarm/set_mode, etc.), actions (gripper_move).
• Explains “mode” architecture (position, velocity, online replanning, free-drive).
Be very detailed
• Launch files as orchestrators that wire simulation vs real hardware, MoveIt! config selection, add_realsense_d435i, add_gripper flags.
• Essential elements: hardware, simulation plugin, URDF model, controllers, API, planning, application.
• Don’t overcomplicate: group low-level nodes into logical layers and show their interactions clearly.