Connecting to sources…

How to build DJI RoboMaster EP Core (RoboMaster S1 Education Expansion Set Core)

97 steps to build DJI RoboMaster EP Core (RoboMaster S1 Education Expansion Set Core), with the source documents.

Neither DJI's site nor its store shows a price (the store product page says it does not exist, 2026‑10‑31); the SDK and developer guide are free

Software

  • Cancel chassis attitude subscription

    Cancel the chassis attitude data subscription and return the result of the cancellation.

  • Cancel ESC information subscription

    Cancel the ESC data subscription and return the result of the cancellation.

  • Cancel chassis IMU gyroscope subscription

    Cancel the chassis IMU gyroscope data subscription.

  • Rotate the gimbal at a set speed

    Set the rotation speed of the pitch and yaw axes; each speed must be within [-360, 360] °/s. The call returns a bool result.

  • Get the gimbal module version

    Read the gimbal module version number. The returned string has the format AA.BB.CC.DD.

  • Move the gimbal relative to its current position

    Move the gimbal to a specified position with the current position as the coordinate origin. Both pitch and yaw angles are within [-55, 55]°, and both speeds are within [0, 540]°/s; the call returns an action object.

  • Move the gimbal relative to power-on position

    Move the gimbal to a specified position with the power-on position as the coordinate origin. The pitch angle is within [-25, 30]°, the yaw angle is within [-250, 250]°, and both speeds are within [0, 540]°/s; the call returns an action object.

  • Center the gimbal

    Control the gimbal to return to its center position. The pitch_speed and yaw_speed ranges are both [-360, 360]°/s; the call returns an action object.

  • Resume the gimbal from sleep

    Control the gimbal to resume from its sleep state. The call returns a bool result.

  • Put the gimbal into sleep

    Control the gimbal to enter its sleep state. The call returns a bool result.

  • Get Gripper Module Version

    Call the EP gripper module's version query interface. It returns a string in the format AA.BB.CC.DD.

  • Close the EP Gripper

    Call the close control of the EP gripper module to close the gripper.

  • Open the EP Gripper

    Call the open control of the EP gripper module to open the gripper.

  • Stop the Gripper Motion

    Call the stop control of the EP gripper module to stop the gripper motion.

  • Subscribe to Gripper Status

    Subscribe to gripper status and set freq to 1, 5, 10, 20, or 50 Hz. The callback receives opened, closed, and normal status, and the subscription returns a boolean result.

  • Cancel Gripper Status Subscription

    Cancel the gripper status information subscription and return the cancellation result.

  • Get Armor LED Module Version

    Call the EP armor LED module's version query interface. It returns a string in the format AA.BB.CC.DD.

  • Set Gimbal Lighting

    Set the top_all, top_left, or top_right gimbal area, specify RGB components from 0–255, a gimbal LED index list from 0–7, and an on or off effect. The call returns a boolean result.

  • Set Robot Armor Lighting

    Set an all, top_all, top_right, top_left, bottom_all, bottom_front, bottom_back, bottom_left, or bottom_right lighting area, and specify RGB components with an on, off, flash, breath, or scrolling effect. Set freq to 1–10 Hz for the flash effect; scrolling applies only to gimbal lights. The call returns a boolean result.

  • Initialize the robot connection

    Establish the connection with ap, sta, or rnds and choose tcp or udp communication. To change the default connection method, specify DEFAULT_CONN_TYPE in conf.py.

  • Get robot module objects

    Get the battery, blaster, camera, chassis, gimbal, arm, lighting-control, intelligent-recognition, and general module objects.

  • Play robot audio

    Play a local audio file or a system sound. For a system sound, specify the sound ID and number of plays.

  • Set drone network mode

    Set the aircraft connection mode to network mode and specify the router SSID and password. The operation returns the setting result.

  • Scan robots on the network

    Automatically scan for robots on the network.

  • Set drone WIFI channel

    Set the aircraft's WIFI channel.

  • Get Servo Angle

    Call the servo angle retrieval function to read the servo angle information.

  • Prepare the Python Environment

    Ensure that the appropriate Python environment is installed on the programming platform; use the linked Python environment installation guide to install or reinstall it.

  • Install the VC Library Environment

    Download the VC library environment executable from the GitHub RoboMaster SDK repository or the backup Gitee RoboMaster SDK repository, then run the installer. Perform this installation if the pictured problem occurs while using the SDK.

  • Install VC Build Tools

    Download the VC build tools executable from the GitHub RoboMaster SDK repository or the backup Gitee RoboMaster SDK repository, then run the installer. Installing the SDK without VC build tools produces the pictured error.

  • Open Command Prompt as Administrator

    Open the Start menu, enter cmd in the search box, right-click Command Prompt in the results, and select Run as administrator.

  • Install the RoboMaster Python SDK

    Enter pip install robomaster in Command Prompt running as administrator to install the RoboMaster SDK. If the pictured situation occurs, refer to the linked Python environment installation guide.

  • Retry Installation with Tsinghua Mirror

    If the network is poor and repeated installations fail, try installing the RoboMaster SDK using the Tsinghua University Python package mirror.

  • Upgrade RoboMaster SDK

    Enter the upgrade command in the command line to upgrade RoboMaster SDK.

  • Install the SDK on Linux

    Enter the installation command in the Python environment on Ubuntu 16.04 to install RoboMaster SDK.

  • Upgrade the SDK on Linux

    When an upgrade is needed, enter the RoboMaster SDK upgrade command in the command line.

  • Refer to the Raspberry Pi guide

    For installing the Python SDK on Raspberry Pi, refer to the sdk install on Raspberry Pi.7z guide.

  • Install the SDK on macOS X

    Enter the installation command in the command line on macOS X to install RoboMaster SDK.

  • Upgrade the SDK on macOS X

    When an upgrade is needed, enter the RoboMaster SDK upgrade command in the command line.

  • Download Python 3.7.8 on Windows

    Download the Python 3.7.8 installer from the official Python website. Make sure the downloaded python.exe is 64-bit; the Python SDK supports Python versions from 3.6.6 through 3.8.9.

  • Verify Windows Python installation

    After installation, press win+r and enter cmd to open the command prompt. Enter python in the command line and confirm that Python 3.7.8 is displayed; if no version information appears, reinstall from the first step.

Calibrate and test

  • Get chassis module version

    Get the chassis module version as a string in the format AA.BB.CC.DD.

  • Set PWM output frequency

    Set the output frequency for pwm1 through pwm6 from 0 to 50000 Hz.

  • Set PWM output duty cycle

    Set the output duty cycle for each channel from pwm1 through pwm6, with each parameter ranging from 0 to 100%.

  • Set chassis stick fusion mode

    Choose mode 0 to disable SDK stick fusion, mode 1 to enable it with the vehicle coordinate frame as the positive direction, or mode 2 to enable SDK mode with the gimbal orientation as the positive direction; the call returns a bool.

  • Read the current flight speed

    Read the currently configured speed; the returned value is in cm/s.

  • Set the flight speed

    Set the current speed used by subsequent flight operations.

  • Fly to a specified coordinate

    Fly to the specified coordinate at the set speed. The aircraft does not move when x, y, and z are all between -20 and 20; without a challenge card, its position is the origin, forward is positive x, and left is positive y.

  • Detect a card and fly to a target

    First fly to (x, y, z) in the mid1 coordinate system and hover, then detect the mid2 challenge card. Fly to (0, 0, z) in the mid2 frame and rotate to the specified yaw value.

  • Disable challenge-card detection

    Disable challenge-card detection; the interface returns the control result.

  • Enable challenge-card detection

    Enable challenge-card detection, which turns on both forward-facing and downward detection by default; the interface returns the control result.

  • Control relative aircraft position

    For relative-position control, x, y, and z cannot all be between -20 and 20, and challenge-card detection must be enabled first.

  • Rotate to a card-frame absolute angle

    Rotate the aircraft to a specified absolute angle in the challenge-card coordinate system.

  • Read robot working mode

    Read the current working mode: free for free mode, gimbal_lead for chassis-follows-gimbal, and chassis_lead for gimbal-follows-chassis.

  • Set robot working mode

    Set the robot working mode.

  • Read robot hardware information

    Get the robot hardware SN string and firmware version string.

  • Reset robot state

    Reset the robot to its initial default state.

  • Stop the drone object

    Stop the drone object.

  • Read drone acceleration and attitude

    Get the aircraft's three-axis acceleration values and three-axis attitude information.

  • Read drone height

    Get the motor barometer height and the aircraft's relative height.

  • Read drone software versions

    Get the aircraft firmware version, esp32 version, and WIFI version.

  • Inspect drone hardware information

    This command supports SDK version 30 or later. Use the hardware? command to check for a WIFI expansion module; it returns TELLO without the module and RMTT with it.

  • Read drone runtime and network information

    Get the motor runtime, SDK version, aircraft SN, SSID name, and specified aircraft status.

  • Read drone network addresses

    Look through the machine's internet connection and return a list of subnet addresses and the server IP.

  • Read drone temperature and signal

    Get the aircraft body temperature and the WIFI signal-to-noise ratio.

Data and training

  • Subscribe to chassis attitude data

    Set the push frequency to 1, 5, 10, 20, or 50 Hz and receive yaw, pitch, and roll attitude angles through a callback; the subscription returns a bool.

  • Subscribe to chassis ESC data

    Set the push frequency to 1, 5, 10, 20, or 50 Hz and receive four motor speeds, angles, packet sequence numbers, and ESC states through a callback; the subscription returns a bool.

  • Subscribe to chassis attitude information

    Set the data push frequency and subscribe to chassis attitude information; available frequencies are 1, 5, 10, 20, and 50 Hz.

  • Subscribe to chassis IMU gyroscope data

    Use a callback to receive x-, y-, and z-axis acceleration and angular velocity, with push frequencies of 1, 5, 10, 20, or 50 Hz.

  • Subscribe to chassis mode information

    Receive the chassis mode through a callback and set the data push frequency to 1, 5, 10, 20, or 50 Hz.

  • Subscribe to chassis position information

    Receive x-, y-, and z-axis distances in meters through a callback; cs=0 uses the robot's current position, and cs=1 uses its power-on position.

  • Subscribe to chassis status information

    Receive the static flag, uphill, downhill, slope, pickup, slip, three-axis impact, rollover, and hill states through a callback, with push frequencies of 1, 5, 10, 20, or 50 Hz.

  • Subscribe to chassis acceleration information

    Receive vgx, vgy, and vgz in the world coordinate system at power-on and vbx, vby, and vbz in the current body coordinate system through a callback; push frequencies are 1, 5, 10, 20, or 50 Hz.

  • Subscribe to aircraft attitude data

    Subscribe to aircraft attitude data with freq set to 1, 5, or 10. Pass a data callback, with args and kw for callback parameters; the interface returns the subscription result.

  • Subscribe to gyroscope data

    Subscribe to aircraft gyroscope data with freq set to 1, 5, or 10. Pass a data callback, with args and kw for callback parameters; the interface returns the subscription result.

  • Cancel attitude-data subscription

    Cancel the aircraft attitude-data subscription; the interface returns the cancellation result.

  • Cancel gyroscope-data subscription

    Cancel the aircraft gyroscope-data subscription; the interface returns the cancellation result.

  • Subscribe to gimbal attitude angles

    Set the push frequency for gimbal attitude-angle data to 1, 5, 10, 20, or 50 Hz. The callback returns pitch_angle, yaw_angle, pitch_ground_angle, and yaw_ground_angle; the result is bool.

  • Cancel the gimbal attitude subscription

    Cancel the data subscription for gimbal attitude-angle information. The call returns the bool result of the cancellation.

  • Subscribe to drone flight telemetry

    Subscribe to aircraft height, barometer, and motor-runtime information at 1HZ, 5HZ, or 10HZ, specifying the callback function and its arguments.

  • Subscribe to drone temperature

    Subscribe to aircraft temperature information at 1HZ, 5HZ, or 10HZ, specifying the callback function and its arguments.

  • Subscribe to drone TOF data

    Subscribe to aircraft TOF information at 1HZ, 5HZ, or 10HZ, specifying the callback function and its arguments.

  • Cancel drone data subscriptions

    Cancel subscriptions for aircraft height, barometer, motor-runtime, temperature, and TOF information.

Use it

  • Set chassis speed

    Set x-axis forward speed, y-axis strafe speed, and z-axis rotation speed; the robot stops automatically if no wheel-speed command arrives within the specified timeout.

  • Set mecanum wheel speeds

    Set the right-front, left-front, left-rear, and right-rear mecanum wheel speeds from -1000 to 1000 rpm; the robot stops if a command is not received before the timeout.

  • Move chassis to a position

    Move the chassis to the specified x, y, and z position using the current position as the coordinate origin; an action object is returned.

  • Fly forward, backward, or sideways

    Fly forward, backward, left, right, or up by a specified distance in centimeters; the distance is relative.

  • Fly an arc between coordinate points

    Fly from (x1, y1, z1) to (x2, y2, z2) in the corresponding coordinate system at the set speed. Set mid to a challenge-card coordinate system, or leave it as None to use the aircraft's own frame.

  • Roll the aircraft in a direction

    Set direction to l for left, r for right, f for forward, or b for backward, and optionally enable retry. A roll cannot complete below 50% battery; the interface returns an action object.

  • Stop the aircraft propellers

    Send the propeller-stop control; the interface returns an action object.

  • Start the aircraft propellers

    Send the propeller-start control; the interface returns an action object.

  • Set four controller stick values

    Set a for roll, b for pitch, c for throttle, and d for yaw; every value ranges from -100 to 100.

  • Rotate the aircraft by an angle

    Rotate the aircraft by the specified angle.

  • Stop RC motion and hover

    Stop the current RC motion and remain hovering; this operation can be performed at any time.

  • Perform a hand launch

    Send the throw-launch control; the interface returns an action object.

Common problems

  • SDK installation is unavailable on Mac and some Python environments #16 #41 #50
  • Initialization and bundled examples fail with missing or incompatible SDK interfaces #31 #57 #70 #73
  • Network setup or initialization failures prevent SDK connections #3 #10 #26 #29 #72 #101
  • Multi-robot connections fail with inconsistent network and robot configuration #85 #105
  • Event and competition push APIs are unavailable or deliver no data #19 #99
  • Sensor and motion data are incomplete or inaccessible outside callbacks #39 #59 #78 #90
  • Missing H264 media dependencies break installation and builds #14 #36 #46 #71
  • Plaintext UART commands trigger format and parsing errors #58

Parts

  • Chassis: 4 Mecanum wheels with M3508I brushless motors (FOC drive, up to 1000 rpm, 0.25 N·m, 19 W)
  • 2-axis arm (22 cm horizontal, 15 cm vertical reach) and gripper (about 10 cm opening), driven by 2 servos (512:1, angle and speed modes)
  • Intelligent controller, 5 MP camera with microphone, 4 hit-detector armour plates, speaker
  • Expansion: infrared distance sensor, sensor adapters (2 IO/AD ports each), power adapter module (CAN, 5V/12V outputs); the controller adds PWM, S‑Bus, UART and USB ports
  • Intelligent battery 2400 mAh, 10.8 V LiPo 3S, 25.92 Wh; about 3.3 kg overall

Tools

  • Assemble the chassis, arm and gripper from the quick start guide; a screwdriver handle is in the box
  • Photos and video need your own microSD card up to 64 GB (more than 2 GB free in programming mode)

Skills

  • Scratch blocks and Python 3.6 in the RoboMaster app's Lab
  • The Python SDK on a PC (Windows, Linux, macOS) and the plaintext SDK socket protocol
  • Connecting third-party hardware through UART, PWM and the sensor adapters

Software

  • RoboMaster app: Solo, Battle and Lab modes
  • RoboMaster SDK (Python): motion control, AI recognition, LEDs, data push, video and audio streams; multi-robot formations
  • The plaintext SDK and official lessons (search and rescue, air-to-ground cooperation, smart warehouse and more)

Documents