Skip to main content

Getting Started with reBot Arm B601-RS

License: MITPython VersionPlatformPinocchio

6-DOF Robotic Arm · Multi-Motor Support · Kinematics Solver · Trajectory Planning · Fully Open Source

The reBot Arm project has been open-sourced on GitHub. This guide will take you through the quick start of B601-RS, from assembly to operation. The content of this guide is racing towards you at the speed of light — stay tuned.

Step 1: Assembly Guide​

  • Before assembly, please read the following instructions carefully. To ensure a smooth assembly process and a complete hands-on experience, please be patient, stay focused, and always follow these key points:
    1. This kit includes numerous screws and structural parts, some of which look similar. Please carefully verify the screw specifications and part models, and confirm the installation orientation before fastening.
    2. The video was recorded in early April. There may be minor adjustments to parts later, but this does not affect the assembly quality when following the video. The final parts are subject to what is shipped.
    3. For ease of screw installation and removal, the open-source BOM specifies standard screws. However, the screws shipped with the kit have thread-lock applied. You may also use your own preferred tools or an electric screwdriver (highly recommended to have one ready). If using an electric tool, be sure to set the torque to a low-to-medium level (3–6 kgf·cm) to avoid excessive torque that could strip the screws, causing irreversible damage where parts cannot be removed. If there is any sign of stripping, immediately replace the screw or realign and retry. Stripped thread-lock screws cannot be removed with a screw extractor and will scrap the entire part. Therefore, please proceed with caution.
    4. Please prioritize safety during assembly to avoid pinched fingers or crush injuries. Children should complete this project with the accompaniment of a parent or guardian.

Step 2: Calibrate the Robotic Arm and Get Started​

  1. Explore our MotorBridge platform. This platform is a one-stop comprehensive solution that supports continuous expansion of motor types, covering Damiao motors, Robstride motors, Hightorque motors, Myactuator motors, Hexfellow, and more. It is also compatible with continuously updated robotic arm products like reBot. The platform is user-friendly for beginners and also provides a Python SDK with fully consistent functionality for developers.

  2. Experience the new features and details of MotorBridge specifically adapted for the reBot robotic arm, including one-click zero-point calibration, parameter writing, drag-and-drop motor control via the UI, and a built-in model visualization interface.

  3. This tool is fully compatible with Windows, Ubuntu, and macOS operating systems.

tip

  1. It is highly recommended not to use a virtual machine. Virtual machines are prone to environment issues.

  2. (Beta version) Let an agent help you initialize the robotic arm. Copy the following content and send it to the agent:

Please follow the process in AGENTS.md (https://github.com/Welt-liu/reBot-B601-Agent-Guide/blob/main/en/AGENTS.md) to help the user complete the initialization of a new robotic arm.

Note: If you purchased a pre-assembled kit, please tell the agent during the motor ID writing step: "I purchased a pre-assembled kit, please scan motors 1–7 to verify they are all online, do not rewrite the motor IDs."

  1. The agent uses CLI commands to complete motor ID writing, while the wiki uses a web UI interaction method. Both approaches work.

You should have completed the preliminary preparation for the robotic arm assembly by following the video. Next, we will introduce how to write motor IDs and calibrate the robotic arm.

  1. Install Miniforge and create a virtual environment to avoid conflicts with other environment packages that could cause demo failures.

Ubuntu\macOS\Jetson\Raspberry Pi:

wget "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-$(uname)-$(uname -m).sh"
bash Miniforge3-$(uname)-$(uname -m).sh

or Windows:

Open the Miniforge Release page in your browser, find the latest version of Miniforge3-Windows-x86_64.exe and click to download:

https://github.com/conda-forge/miniforge/releases
  1. Create a Python 3.12 virtual environment:
tip

Git Bash users: If the conda command is not found, it means Git Bash has not loaded the conda environment. You need to initialize it first:

# Temporary (current terminal only), replace <install_path> with the actual path
source <install_path>/etc/profile.d/conda.sh

# Permanent (write to bashrc, run once)
echo 'source <install_path>/etc/profile.d/conda.sh' >> ~/.bashrc
source ~/.bashrc

To let PowerShell automatically activate the conda environment:

conda init powershell
conda create -y -n rebot python=3.12
  1. Activate the virtual environment. You need to re-run this activation command every time you open a terminal to use reBot-related features:
conda activate rebot

2. Install Motorbridge​

After activating the reBot virtual environment, run the following command to install motorbridge:

Note for macOS users

If you experience low frame rates during teleoperation on macOS, it may be caused by an outdated WCH CH34x driver version. For macOS 10.14 and later, the system includes a built-in AppleUSBCHC0M driver. You can uninstall the old driver and switch to the macOS built-in driver, which should effectively improve frame rates.

pip install motorbridge

3. PCAN-USB​

Get the PCAN-USB device working on the CAN bus at 1Mbps for robotic arm communication.

Ubuntu\macOS\Jetson\Raspberry Pi:

# The kit includes PCAN-USB, which should normally show up as can0 or can1
sudo modprobe peak_usb
ip -br link

# If can0 appears, set the bitrate
sudo ip link set can0 down 2>/dev/null
sudo ip link set can0 type can bitrate 1000000 restart-ms 100
sudo ip link set can0 up

Windows users, please visit pcan-usb to install the PCAN-USB driver.

4. Start MotorBridge-gateway to Write Zero Points and Debug​

Before Motor Reset​

Before motor parameter configuration, please note the following preparations and safety rules:

  • Prepare 2 tooling clamps (size ≥3 inches) and a 48V XT30-output switching power supply (please choose a reputable brand; do not use inferior power supplies).
  • During debugging and operation, maintain a safe distance of at least 1 meter.
  • Do not hot-plug motors; disconnect the power supply before plugging/unplugging the XT30 2+2 connector.
  • Do not overload or overspeed the motors; check wiring and fasteners before startup; do not use in humid, high-temperature, or dusty environments.
  • Set reasonable program parameters and emergency stop function to prevent equipment runaway.
  • Please strictly follow the above rules. The seller is not liable for any risks and losses caused by non-compliant operations or human errors.

Web UI Zero Point Writing and Debugging​

Open the address motorbridge-studio in your browser, click the Help option, copy the corresponding command based on your operating system and driver board, verify the IP address and port number, then press Enter in the terminal to run it.

motorbridge-gateway --bind 127.0.0.1:9002

Please refer to the video for usage. Before operating the robotic arm, you need to reset the zero point again.

Loading Comments...