Skip to content

About

Original SCARA CAD with ROS 2 Humble, ros2_control, MoveIt 2, Gazebo, RViz2, analytical kinematics and manipulation props.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

SCARA Robot · ROS 2 Humble

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.

Robot Demonstrations

Physical SCARA Robot

Physical SCARA Robot

Physical four-axis SCARA manipulator demonstrating basic joint motion and operation of the original hardware.

ROS 2 Gazebo + RViz2 Simulation

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.

Computer vision — camera-guided pick and place (in development)

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.

Blue-cylinder detection

Blue-cylinder detection preview with the calibrated workspace outline

Development screenshot showing the detected cylinder, workspace outline, and estimated target position.

Overhead camera setup

Physical SCARA robot with the overhead camera mounted above the work area

The camera is mounted above the tabletop to observe the pickup area beside the robot and puzzle tray.

CAD Model

Original SCARA CAD model

Preview rendered from the original STEP assembly. This is a CAD visualization, not a screenshot of a running Gazebo session.

Start here

Capabilities and status

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.

Repository structure

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

Publish this prepared repository from Windows

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.cmd

This 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.

Build and launch

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.py

RViz/MoveIt with mock joint feedback:

ros2 launch scara_bringup sim.launch.py mode:=mock

Send 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 0

Operate 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, hex

The original robot has four controlled axes: shoulder rotation, vertical carriage motion, elbow rotation, and wrist yaw. Roll and pitch commands are unreachable.

Docker build

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.

Original project and attribution

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.

About

Original SCARA CAD with ROS 2 Humble, ros2_control, MoveIt 2, Gazebo, RViz2, analytical kinematics and manipulation props.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages