Four-axis SCARA manipulator · Original CAD geometry · ros2_control · MoveIt 2 · Gazebo · RViz2
A ROS 2 workspace built around the SCARA assembly and embedded code from Matthew Garcia's original SCARA repository. This repository brings the mechanical files, Arduino firmware, Processing GUI, analytical kinematics, and simulation setup into one organized project.
Target environment: Ubuntu 22.04 LTS + ROS 2 Humble + Gazebo Classic 11.
Physical four-axis SCARA manipulator demonstrating basic joint motion and operation of the original hardware.
SCARA_Robot_Gazebo.webm
ROS 2 Humble simulation of the SCARA manipulator running in Gazebo and RViz2 with ros2_control and MoveIt 2 for joint control, motion planning, and trajectory execution.
An overhead camera finds the blue cylinder on the table, converts its position into joint angles, and the physical robot picks it up and drops it into the puzzle tray, then returns to its start pose. Everything runs from Python on Windows over the existing serial protocol; the original Arduino firmware and Processing GUI are unchanged.
How it works
- Detection: OpenCV color and shape filtering finds the cylinder and waits until it is stationary.
- Calibration: the robot places the cylinder at 8–12 spots; each camera pixel is paired with the joint angles used, and a homography maps pixels straight into the robot's own frame. No hand measurement is needed, and the mapping is taken at cylinder-top height.
- Planning: inverse kinematics picks whole-degree joint angles (the firmware's resolution), preferring the elbow direction used by the nearest calibration point.
- Execution: a 10-step pick → lift → drop → return sequence, in step-by-step or timed auto mode.
Status: full pick-and-place cycles run end to end on the real robot.
See vision/VISION_PICK_PLACE.md for setup and usage.
Development screenshot showing the detected cylinder, workspace outline, and estimated target position.
The camera is mounted above the tabletop to observe the pickup area beside the robot and puzzle tray.
Preview rendered from the original STEP assembly. This is a CAD visualization, not a screenshot of a running Gazebo session.
- Install, build, and launch the ROS workspace
- Robot frames and forward/inverse kinematics
- Functional gripper, colored pickup set, and three-piece Hanoi scene
- What has been tested
- Physical hardware integration requirements
- Original asset locations and preservation
| Component | Included | Validation status |
|---|---|---|
| Robot description | Original STEP converted into five rigid links, with 109 CAD part instances | Source hashes and assembly-frame reconstruction checked |
| Kinematics | Four-axis analytical FK/IK; elbow branches, joint limits, angle wraps, yaw | 10,000 standalone C++ round trips passed |
| ros2_control | Arm and two-finger trajectory controllers; Gazebo/mock backends | Automated Humble verification included |
| MoveIt 2 | Custom analytical plugin, OMPL planning, trajectory execution configuration | Humble plugin build and integration verification pending |
| Visualization | RViz2 configuration and Gazebo Classic world/launch | GUI runtime verification pending |
| Manipulation scene | Four colored pickup solids, three Hanoi rings, placement tray, and matching MoveIt world | Scene parity and grasp integration checks included |
| Embedded code | Original Arduino stepper/servo controller and Processing GUI | Preserved without modifying their behavior |
| Gripper | Synchronized white sliding fingers with Gazebo attach/release behavior | Simulation pick/lift/release implemented; physical servo integration pending |
Simulation mass properties and collision hulls are approximations. This project does not claim verified payload, torque, positioning accuracy, or a feedback-based physical ROS controller.
| Directory | Purpose |
|---|---|
cad/solidworks/ |
Original SolidWorks assemblies and part files, with original filenames |
cad/step/ |
Complete robot STEP assembly and individual STEP exports |
cad/development/ |
Printable 240 × 70 × 10 mm four-station placement tray (SCAD and STL) |
firmware/arduino/SCARA_Robot/ |
Original Arduino sketch, in an IDE-compatible sketch folder |
software/processing/GUI_for_SCARA_Robot/ |
Original Processing GUI, in its matching sketch folder |
ros2_ws/src/ |
Description, kinematics, MoveIt configuration, and bringup packages |
ros2_ws/tests/ |
Geometry, provenance, and standalone kinematics checks |
tools/ |
CAD export, preview rendering, and ROS integration runner |
docs/ |
Setup context, kinematics, validation, provenance, and hardware notes |
media/original/ |
Original robot photograph and animation |
docker/ |
Reproducible Ubuntu 22.04/Humble build environment |
.github/workflows/ |
Humble build and headless simulation checks |
After extracting the ZIP, open Command Prompt in this folder. Git and GitHub CLI must be installed and signed in as Matthew-Garcia.
publish-github.cmdThis creates a new private repository named SCARA-Robot-ROS2 and pushes these files. To make the new repository public instead, explicitly run publish-github.cmd public. The script refuses to overwrite an existing repository or reuse an existing origin remote. The original SCARA-Robot repository is not modified.
After installing the dependencies in the setup guide:
git clone https://github.com/Matthew-Garcia/SCARA-Robot-ROS2.git
cd SCARA-Robot-ROS2/ros2_ws
source /opt/ros/humble/setup.bash
rosdep install --from-paths src --ignore-src --rosdistro humble -r -y
colcon build --symlink-install
source install/setup.bash
ros2 launch scara_bringup sim.launch.pyRViz/MoveIt with mock joint feedback:
ros2 launch scara_bringup sim.launch.py mode:=mockSend a Cartesian target through MoveIt from another sourced terminal:
ros2 run scara_bringup move_to_pose.py --x 0.33 --y 0.02 --z 0.09 --yaw 0Operate the gripper or run a complete Gazebo pick-and-place demonstration:
ros2 run scara_bringup gripper_command.py open
ros2 run scara_bringup gripper_command.py close
ros2 run scara_bringup pick_lift_demo.py --object cube
# Other choices: sphere, cylinder, hexThe original robot has four controlled axes: shoulder rotation, vertical carriage motion, elbow rotation, and wrist yaw. Roll and pitch commands are unreachable.
From the repository root:
docker build -f docker/Dockerfile -t scara-ros2:humble .
# Headless simulation; no desktop display required.
docker run --rm scara-ros2:humble bash -lc \
'source /opt/ros/humble/setup.bash && source /scara_ws/install/setup.bash && ros2 launch scara_bringup sim.launch.py gui:=false rviz:=false'For GUI use, follow the native Ubuntu setup. The Dockerfile does not configure host display forwarding.
The original repository is retained separately. Its 77 files are preserved byte-for-byte in this new layout, including an archived copy of its README. The source manifest records every old/new path, SHA-256 hash, and original commit. Statements in the archived README are historical source text; the capability table above and validation record describe the current ROS addition.
CAD and embedded code retain their source provenance. The original repository does not include a top-level license file; no blanket relicensing of those assets is implied by the new ROS package metadata.



