Skip to content

Robot Studio | User Manual

This guide helps you connect Robot Studio, record your first motion, and export it as a JSON file.

Robot Studio is a browser-based motion editing tool for robot platforms built around bus servo systems. No installation is required. Open it in your browser to scan online servos, read current poses, edit action groups, play motions, and import or export JSON data.

Open the Editor

Before You Start

  • Connect the adapter board (UC-01 or RUC-01) to your computer via USB.
  • Make sure the bus servo power supply is working properly. Otherwise, some servos may not be detected, or angle reading may fail.
  • Check in advance that each bus servo has a unique ID, to avoid scan failures or recognition issues caused by duplicate IDs.

Tip

It is recommended to use a browser that supports Web Serial, such as Chrome or Edge.

Quick Start

Connect

  1. At the top of the page, select the appropriate baud rate.
  2. Click Connect to open the serial port selector, then choose the correct serial port device in the browser dialog.
  3. After the first successful connection, Robot Studio automatically scans for online servos.
Connection

Record Your First Motion

  1. In the Current Pose area, check the angle of each servo and adjust the robot pose by dragging the sliders or positioning the robot by hand.
  2. To position the robot by hand, click Unlock All first.
  3. If needed, click Read Angle to confirm that the current pose data is correct.
  4. Set Motion Time and Post-Move Delay.
  5. Click Add Current Pose to save the current angle of every servo as one frame.
  6. Repeat the adjustment and save process to build a complete motion sequence step by step.
  7. Click Play to preview the current motion.
Interface Overview

Export

  1. After confirming that the motion works as expected, click Export (JSON).
  2. Use the exported JSON file for backup, sharing, or later re-importing for editing.
Export JSON

Other Current Pose Controls

Current Pose

Locking and Unlocking

  • Lock All / Unlock All: Lock or unlock all online servos at once.
  • Unlock State: Free: Places the servo in the free state for easier manual positioning.
  • Unlock State: Damping: Places the servo in damping mode and lets you set a damping value.

Real-Time Adjustment

  • Live Slider Control: When enabled, dragging the slider on the corresponding servo card sends commands in real time.
  • Motion Speed: Sets the speed used during real-time dragging.

Servo Actions

  • Input Angle: Enter an angle in the cell and press Enter, and the servo moves to the target angle.
  • Set Origin: Set the current position of the online servo as the origin. Use this carefully.
  • Check: Checks servo status, such as stall, overvoltage, and other abnormal conditions.
  • Reset Turns: Sends a multi-turn reset command to the online servos.

Layout Control

  • Layout: Unlocked: Drag each servo card freely so the layout matches the robot's actual structure and joint positions.
  • Layout: Locked: Prevents servo card positions from being moved.

More Action Group and Action Sequence Features

Action Group and Sequence

Add the Current Pose

  1. Motion Time: The movement time for the current frame.
  2. Post-Move Delay: The wait time after the current frame finishes and before the next frame starts.
  3. Add Current Pose: Save the current angle of every servo as one frame.

Action Group

  • Action Group: Manage different motion items. You can create, rename, or delete groups.
  • Action Sequence: The list of frames in the current action group. You can drag to reorder them.

Playback Controls

  • Play: Play all frames in the current action group in sequence.
  • Loop: When enabled, playback starts again from the beginning after it finishes.
  • Stop: Stop the current motion playback.

Import and Export

  • Export (JSON): Export the current action group and layout data.
  • Import: Restore action group and layout data from a JSON file.

FAQ

No servos are detected during scanning.
  • Make sure the adapter board is connected to power. A USB connection alone is not enough for normal detection.
  • Make sure the wiring direction of the servo bus is correct, and that the supply voltage is within the operating range of the servo.
  • Make sure each bus servo has a unique ID. Do not connect multiple servos with the same ID at the same time.
  • If detection still fails, disconnect and reconnect the setup, then scan again.
Only some servos are detected during scanning.
  • First check whether the power supply capacity is sufficient, to avoid some servos dropping offline because of insufficient power.
  • Check whether the bus connection has poor contact or cable issues.
  • Check whether duplicate IDs or a faulty servo is interfering with bus communication.
The adapter board does not appear in the serial port list after connection.
  • If the adapter board's serial port information does not appear in the serial port list, the driver may not be installed correctly.
  • Please download the CH340 driver, install it, and refresh the serial port list again.
The servo does not move smoothly during real-time dragging.
  • Open the servo Parameter Configuration option and confirm that Respond After Command Sent is turned off.
  • If it is not turned off, disable it, write the parameter, and test again.
The motion layout changes after importing data.
  • The JSON file includes servo layout information.
  • If you import older data, the layout field may be missing. In that case, the page falls back to the default layout.