Add a component

Each guide walks you through adding a specific component type to your machine: choosing a model, configuring attributes, and verifying it works. The general process is the same for every component – How components work covers the universal steps. The guides below add component-specific details: tested attribute examples, working code, and troubleshooting.

If you’re not sure which component type you need, start with Component types.

Control an arm, gripper, or gantry

ComponentDescription
ArmControl a multi-joint robotic arm: move joints, position the end effector, integrate with motion planning.
GripperOpen, close, and grasp objects with a gripper mounted on an arm or gantry.
GantryMove a tool head, camera, or sensor to precise coordinates along one or more linear axes.

Sensing

Components that read data from the physical world.

ComponentDescription
CameraCapture images or video from a USB webcam, IP camera, or depth sensor.
SensorRead environmental data: temperature, humidity, distance, air quality, and more.
Movement sensorGet position, velocity, orientation, or compass heading from a GPS, IMU, or odometry source.
Power sensorMonitor voltage, current, and power consumption.
EncoderTrack how far a motor has turned and how fast it’s spinning.

Drive a mobile robot

ComponentDescription
BaseDrive a mobile robot with movement commands like “move forward 300mm” or “spin 90 degrees.” A base wraps your drive system into a single interface.

Control motors and servos

ComponentDescription
MotorControl a DC or stepper motor through a motor driver and GPIO pins.
ServoSet the angular position of a hobby servo with a PWM pin.

Control

Components for physical I/O and user interaction.

ComponentDescription
BoardExpose GPIO pins, analog readers, and digital interrupts from a single-board computer. Many other components depend on a board.
ButtonDetect presses from a physical button to trigger actions.
SwitchRead or set the position of a toggle or selector switch.
Input controllerUse a gamepad, joystick, or other input device for manual machine control.

Other

ComponentDescription
GenericInterface with hardware that doesn’t fit any standard component type.