Free · Open source · Apache License 2.0

Learn robotics
on a real six-axis arm.

SmartManipulator-X is a free kit of three open-source projects: the Operator PC, the Robot PC and the Doppelstep motor drive. Start in simulation on one computer, then move to a real motor and the whole arm, one level at a time. You can stop at any level.

3projects, one kit
3levels to the real arm
0hardware for Level 1
SmartManipulator-X, a 3D-printed six-axis robot arm, rendered from its CAD model
The kit

Three projects. One signal path.

A motion goal travels from the operator's screen to the motor. Each block is its own project with its own documentation.

The mechanics

A 3D-printed arm you can build yourself.

The arm is the BCN3D Moveo, an open-source robot arm designed to be printed on a desktop 3D printer. Its parts and assembly are public, which makes it a good base for learning: you can see and change every piece.

The robot description the software uses (the URDF) is generated straight from the Moveo CAD files. The arm you plan with in simulation at Level 1 has the same geometry as the printed one at Level 3.

6stepper motors, one per joint
CAD → URDFone source for the real and the simulated arm

Why stepper motors, not servos?

Smart servos with a built-in controller are convenient but expensive. Stepper motors are cheap and strong, but on their own they do not report where they are. The Doppelstep drive closes that gap: it controls the stepper and answers on the bus like a smart servo, so the robot software cannot tell the difference.

What each part teaches

Pick the layer you want to understand.

RViz2 previewing a planned arm motion

Operator PC

Works today

The operator's side: choose a goal, preview the motion plan and execute it.

  • Motion planning with MoveIt 2
  • Visualisation and interaction in RViz2
  • ROS 2 communication between machines
Operator PC docs ↗
SmartManipulator-X arm model used by the Robot PC

Robot PC

Works today

The robot's brain: runs the control stack, in simulation or on a Raspberry Pi CM4.

  • ROS 2 Jazzy and ros2_control
  • Mock hardware for simulated joints
  • Docker: one command to start
Robot PC docs ↗
Doppelstep bench GUI with live plots of position, velocity, current and input voltage

Doppelstep

Hardware in progress

The motor drive: turns a low-cost stepper into a smart servo the robot already speaks to.

  • Motor control and a 20 kHz current loop
  • Firmware on Zephyr RTOS with MCUboot
  • DYNAMIXEL XM430 servo emulation
Doppelstep docs ↗
Key ideas in five minutes

Four concepts you will meet on the way.

Read these before you open the docs. Each one maps to a part of the kit.

ROS 2

Programs that talk to each other

A robot is many small programs, called nodes. ROS 2 lets them exchange messages, on one machine or across the network. That is how the Operator PC and the Robot PC work together.

RViz2 showing the goal pose of the arm in orange MoveIt 2

From a goal to a path

You say where the gripper should go. MoveIt 2 works out the joint angles that get it there and a trajectory that avoids collisions, before anything moves.

ros2_control

Swap simulation for hardware

Controllers send commands to a hardware interface. At Level 1 that interface is simulated; at Level 3 it is the real bus. Nothing above it changes, so your code moves with you.

DYNAMIXEL bus

Six joints, one cable

All drives share one serial bus. Each has an ID and answers Protocol 2.0 packets. Doppelstep answers like a DYNAMIXEL XM430 servo, so the standard ROBOTIS software drives a stepper motor.

Learning path

From simulation to the real arm.

Each level adds hardware, not new software. The code you write at Level 1 runs unchanged at Level 3.

Level 1Available

Simulation

Plan and execute arm motions, write ROS 2 nodes and test algorithms against simulated joints.

You need
One computer with Docker
Uses
Operator PC · Robot PC
Hardware
None
Start Level 1 ↗
Level 2Planned

One joint on the desk

Run your trajectories on a real motor and see real timing and limits.

You need
One drive board, one stepper motor and a lab supply
Uses
Operator PC · Robot PC · Doppelstep ×1
Follow progress ↗
Level 3Planned

The whole robot

Run your algorithms on the real six-axis arm.

You need
The arm, six drives, the CM4-Duino and a small bus interface
Uses
All three projects
See the wiring ↗
What Level 1 looks like

Choose a goal. Preview. Execute.

RViz2: the orange goal arm bends forward while the current arm stands upright
STEP 1Choose the goalPick a target pose; the orange arm shows where it will go.
RViz2: preview of the planned motion from upright to the ready pose
STEP 2Preview the planMoveIt 2 finds a collision-free path and plays it back first.
RViz2: the arm has executed the motion and reached the ready pose
STEP 3ExecuteThe simulated joints follow the plan through ros2_control.

Screenshots from the Operator PC documentation. See the full RViz2 walkthrough ↗

FAQ

Before you start.

Do I need any hardware?

Not for Level 1. Everything runs in simulation on one computer with Docker.

Is it really free?

Yes. The Robot PC, the Operator PC and the Doppelstep firmware are open source under the Apache License 2.0.

Where do I start?

With the connection guide for beginners ↗. It walks you through Level 1 in pictures.

I am stuck. Where do I ask?

Open an issue in the project's repository on GitHub ↗.

Arm renders and robot description from the BCN3D Moveo CAD (MIT licence). Curious how every layer is engineered? Read the SmartManipulator-X case study.