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)