大疆 RoboMaster EP Core(RoboMaster S1 教育拓展套装 Core) 的做法
大疆 RoboMaster EP Core(RoboMaster S1 教育拓展套装 Core) 的 97 个步骤,附出处文档。
大疆官网与商城均未标价(商城商品页显示页面不存在,2026‑10‑31);SDK 与开发者文档免费
软件与固件
- 取消底盘姿态信息订阅
取消底盘姿态信息的数据订阅,并返回取消订阅结果。
- 取消电调信息订阅
取消电调信息的数据订阅,并返回取消订阅结果。
- 取消底盘 IMU 陀螺仪信息订阅
取消底盘 IMU 陀螺仪信息的数据订阅。
- 按速度控制云台转动
设置pitch轴和yaw轴的转动速度,两个速度范围均为[-360, 360] °/s。调用结果为bool。
- 获取云台模块版本号
读取云台模块版本号,返回字符串,格式为AA.BB.CC.DD。
- 移动云台到当前位置相对位置
以当前位置为坐标原点,将云台移动到指定位置。pitch和yaw角度范围均为[-55, 55]°,pitch_speed和yaw_speed范围均为[0, 540]°/s;返回action对象。
- 移动云台到上电相对位置
以上电位置为坐标原点,将云台移动到指定位置。pitch角度范围为[-25, 30]°,yaw角度范围为[-250, 250]°,pitch_speed和yaw_speed范围均为[0, 540]°/s;返回action对象。
- 控制云台回中
控制云台回到中心位置。pitch_speed和yaw_speed的范围均为[-360, 360]°/s;返回action对象。
- 恢复云台休眠状态
控制云台从休眠状态中恢复,调用结果为bool。
- 使云台进入休眠状态
控制云台进入休眠状态,调用结果为bool。
- 获取机械爪模块版本号
调用 EP 机械爪模块的版本查询接口。返回字符串,格式为 AA.BB.CC.DD。
- 关闭 EP 机械爪
调用 EP 机械爪模块的关闭控制,使机械爪关闭。
- 张开 EP 机械爪
调用 EP 机械爪模块的张开控制,使机械爪张开。
- 停止机械爪运动
调用 EP 机械爪模块的停止控制,停止机械爪运动。
- 订阅机械爪状态
订阅机械爪状态,并将 freq 设为 1、5、10、20 或 50 Hz。回调接收 opened、closed 和 normal 状态,订阅操作返回布尔结果。
- 取消机械爪状态订阅
取消机械爪状态信息订阅,并返回取消订阅结果。
- 获取装甲灯模块版本号
调用 EP 装甲灯模块的版本查询接口。返回字符串,格式为 AA.BB.CC.DD。
- 设置云台灯效
设置云台部位 top_all、top_left 或 top_right 的灯效,并指定 0–255 的 RGB 分量、0–7 的云台灯序号列表以及 on 或 off 效果。调用结果为布尔值。
- 设置整机装甲灯效
设置 all、top_all、top_right、top_left、bottom_all、bottom_front、bottom_back、bottom_left 或 bottom_right 灯效区域,并指定 RGB 分量及 on、off、flash、breath 或 scrolling 效果。闪烁效果可设置 1–10 Hz 的 freq,scrolling 仅适用于云台灯,调用结果为布尔值。
- 初始化机器人连接
使用 ap、sta 或 rnds 连接类型建立连接,并选择 tcp 或 udp 通讯方式;如需修改默认连接方式,可在 conf.py 中指定 DEFAULT_CONN_TYPE。
- 获取机器人模块对象
获取电池、水弹枪、相机、底盘、云台、机械臂、灯效控制和智能识别模块对象,也可获取通用模块对象。
- 播放机器人音频
播放本地音频文件或系统音效;播放系统音效时可指定音效 ID 和播放次数。
- 设置无人机组网模式
将飞机连接模式设置为组网模式,并指定路由器的 ssid 和 password;操作返回设置结果。
- 扫描网络中的机器人
自动扫描网络中的机器人。
- 设置无人机 WIFI 信道
设置飞机的 WIFI 信道。
- 获取舵机角度
调用舵机角度值获取功能,读取舵机角度信息。
- 准备 Python 编程环境
确保编程平台端安装对应的 Python 环境,可参考“python编程环境安装”链接进行安装或重新安装。
- 安装 VC 库环境
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.
- 安装 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.
- 以管理员身份打开命令提示符
点击开始菜单,在搜索框中输入 cmd,在搜索结果中右键单击命令提示符,并选择“以管理员身份运行”。
- 安装 RoboMaster Python SDK
在以管理员身份运行的命令提示符中输入 pip install robomaster,安装 RoboMaster SDK。若出现图片所示情况,可参考 Python 编程环境安装链接。
- 使用清华镜像重试安装
如果网络较差并多次安装失败,可以改用清华大学的 Python 软件源镜像尝试安装 RoboMaster SDK。
- 升级 RoboMaster SDK
在命令行中输入升级指令,升级 RoboMaster SDK。
- 在 Linux 安装 SDK
在 Ubuntu 16.04 的 Python 环境中输入安装指令,安装 RoboMaster SDK。
- 升级 Linux 版 SDK
需要升级时,在命令行中输入 RoboMaster SDK 的升级指令。
- 参考树莓派安装教程
For installing the Python SDK on Raspberry Pi, refer to the sdk install on Raspberry Pi.7z guide.
- 在 macOS X 安装 SDK
在 macOS X 平台的命令行中输入安装指令,安装 RoboMaster SDK。
- 升级 macOS X 版 SDK
需要升级时,在命令行中输入 RoboMaster SDK 的升级指令。
- 在 Windows 上下载 Python 3.7.8
从 Python 官网下载 Python 3.7.8 安装包。确保下载的 python.exe 是 64 位;Python SDK 适配 3.6.6 以上至 3.8.9 版本。
- 验证 Windows Python 安装
安装完成后按 win+r,输入 cmd 打开命令提示符界面。在命令行输入 python,确认显示 Python 3.7.8;如果未显示版本信息,请从第一步重新安装。
标定与测试
- 获取底盘模块版本
获取底盘模块版本号,返回格式为 AA.BB.CC.DD 的字符串。
- 设置 PWM 输出频率
设置 pwm1 至 pwm6 的输出频率,范围为 0 至 50000 Hz。
- 设置 PWM 输出占空比
分别设置 pwm1 至 pwm6 的输出占空比,每个参数的取值范围为 0 至 100%。
- 设置底盘杆量叠加模式
选择模式 0 关闭 SDK 杆量叠加、模式 1 使能杆量叠加并以车身坐标系为速度正方向,或模式 2 使能 SDK 模式并以云台朝向为速度正方向;调用结果为 bool。
- 读取当前飞行速度
读取当前设置速度,返回值的单位为cm/s。
- 设置当前飞行速度
设置后续飞行操作使用的当前速度。
- 飞向指定坐标位置
以设置速度飞向指定坐标位置。x、y、z同时处于-20至20时飞机不会运动;不使用挑战卡时当前位置为原点,前方为x轴正方向,左方为y轴正方向。
- 识别挑战卡并飞至目标点
先飞到mid1坐标系的(x, y, z)点并悬停,再识别mid2挑战卡。识别后飞到mid2坐标系的(0, 0, z)位置,并旋转到设定的yaw值。
- 关闭挑战卡探测
关闭挑战卡探测功能,接口返回控制结果。
- 打开挑战卡探测
打开挑战卡探测,默认同时开启前视和下视探测,接口返回控制结果。
- 控制飞机相对位置
使用相对位置控制时,x、y、z不能同时处于-20至20之间,并且应先开启挑战卡检测功能。
- 转到卡片坐标系的绝对角度
让飞机旋转到挑战卡坐标系中的指定绝对角度。
- 读取机器人工作模式
读取当前工作模式;自由模式返回 free,底盘跟随云台模式返回 gimbal_lead,云台跟随底盘模式返回 chassis_lead。
- 设置机器人工作模式
设置机器人工作模式。
- 读取机器人硬件信息
获取机器人硬件 SN 字符串和固件版本号字符串。
- 重置机器人状态
将机器人重置到初始默认状态。
- 停止无人机对象
停止 drone 对象。
- 读取无人机加速度与姿态
获取飞机三轴加速度值和三轴姿态信息。
- 读取无人机高度
获取电机气压计高度和飞机相对高度。
- 读取无人机软件版本
获取飞机固件版本号、esp32 版本号和 WIFI 版本号。
- 检查无人机硬件信息
此命令仅支持 SDK 版本号大于或等于 30;可用 hardware? 指令检查是否连接 WIFI 拓展模块,未连接时返回 TELLO,连接时返回 RMTT。
- 读取无人机运行与网络信息
获取电机运行时间、SDK 版本号、飞机 sn 号、SSID 名称和飞机指定状态。
- 读取无人机网络地址
查看机器人的互联网连接,并返回子网地址和服务器 IP 列表。
- 读取无人机温度与信号
获取飞机机身温度和 wifi 信噪比数值。
采数据与训练
- 订阅底盘姿态信息
以 1、5、10、20 或 50 Hz 设置推送频率,并通过回调函数接收 yaw、pitch 和 roll 姿态角;订阅结果为 bool。
- 订阅底盘电调信息
以 1、5、10、20 或 50 Hz 设置推送频率,并通过回调函数接收四路电机速度、角度、包序号和电调状态;订阅结果为 bool。
- 订阅底盘姿态信息
设置数据推送频率,并订阅底盘姿态信息;频率可选 1、5、10、20、50 Hz。
- 订阅底盘 IMU 陀螺仪信息
通过回调函数获取 x、y、z 轴加速度和角速度,推送频率可选 1、5、10、20、50 Hz。
- 订阅底盘模式信息
通过回调函数获取底盘模式 mode,并设置 1、5、10、20、50 Hz 中的数据推送频率。
- 订阅底盘位置信息
通过回调函数获取 x、y、z 轴距离,单位为米;cs=0 表示机器人当前位置,cs=1 表示机器人上电位置。
- 订阅底盘状态信息
通过回调函数获取静态位、上坡、下坡、倾斜、抱起、打滑、三轴撞击、翻转和斜坡状态,推送频率可选 1、5、10、20、50 Hz。
- 订阅底盘加速度信息
通过回调函数获取上电时刻世界坐标系下的 vgx、vgy、vgz,以及当前车身坐标系下的 vbx、vby、vbz;推送频率可选 1、5、10、20、50 Hz。
- 订阅飞机姿态信息
订阅飞机姿态信息,freq可选1、5或10。向callback传入数据处理函数,并可用args和kw提供回调参数;接口返回数据订阅结果。
- 订阅飞机陀螺仪信息
订阅飞机陀螺仪信息,freq可选1、5或10。向callback传入数据处理函数,并可用args和kw提供回调参数;接口返回数据订阅结果。
- 取消订阅飞机姿态信息
取消飞机姿态信息的数据订阅,接口返回取消数据订阅结果。
- 取消订阅飞机陀螺仪信息
取消飞机陀螺仪信息的数据订阅,接口返回取消数据订阅结果。
- 订阅云台姿态角信息
设置云台姿态角数据的推送频率,频率可选1、5、10、20、50 Hz。回调函数返回pitch_angle、yaw_angle、pitch_ground_angle和yaw_ground_angle;结果为bool。
- 取消云台姿态角订阅
取消云台姿态角信息的数据订阅,返回取消数据订阅的bool结果。
- 订阅无人机飞行遥测
以 1HZ、5HZ 或 10HZ 订阅飞机高度、气压计和电机运行时间信息,并指定回调函数及其参数。
- 订阅无人机温度
以 1HZ、5HZ 或 10HZ 订阅飞机温度信息,并指定回调函数及其参数。
- 订阅无人机 TOF 数据
以 1HZ、5HZ 或 10HZ 订阅飞机 tof 信息,并指定回调函数及其参数。
- 取消无人机数据订阅
分别取消飞机高度、气压计、电机运行时间、温度和 tof 信息的订阅。
用起来
- 设置底盘速度
设置 x 轴前进速度、y 轴横移速度和 z 轴旋转速度,并在指定时间内未收到麦轮转速指令时主动停止机器人。
- 设置麦轮转速
分别设置右前、左前、左后和右后麦轮转速,范围均为 -1000 至 1000 rpm;超时未收到指令时主动停止机器人。
- 移动到底盘指定位置
以当前位置为坐标轴原点,控制底盘移动到指定的 x、y、z 位置;返回 action 对象。
- 按距离向前后左右上下飞行
向前、向后、向左、向右或向上飞行指定距离,距离单位为厘米且是相对距离。
- 沿两坐标点之间的弧线飞行
以设置速度从对应坐标系的(x1, y1, z1)点飞到(x2, y2, z2)点。mid指定挑战卡坐标系,mid为None时使用飞机自身坐标系。
- 控制飞机向指定方向翻滚
使用direction指定翻滚方向:l向左、r向右、f向前、b向后,并可设置retry重发命令。电量低于50%时无法完成翻滚,接口返回action对象。
- 停止飞机螺旋桨
发送停桨控制,接口返回action对象。
- 启动飞机螺旋桨
发送转桨控制,接口返回action对象。
- 设置遥控器四个杆量
设置a为横滚、b为俯仰、c为油门、d为偏航,每个值的范围都是-100至100。
- 将飞机旋转指定角度
让飞机旋转指定角度。
- 停止遥控运动并悬停
停止当前rc运动并保持悬停,该操作可在任何时候执行。
- 控制飞机抛飞
执行抛飞控制,接口返回action对象。
常见问题
物料
- 底盘:4 个麦克纳姆轮与 M3508I 无刷电机(FOC 驱动,最高 1000 rpm、0.25 N·m、19 W)
- 2 轴机械臂(水平 22 cm、竖直 15 cm)与机械爪(开口约 10 cm),由 2 个舵机驱动(512:1,角度与速度模式)
- 智能中控、500 万像素摄像头(带麦克风)、4 块击打检测装甲、扬声器
- 扩展:红外距离传感器、传感器转接模块(每块 2 个 IO/AD 口)、电源转接模块(CAN、5V/12V 输出);中控另有 PWM、S‑Bus、UART 与 USB 口
- 智能电池 2400 mAh、10.8 V LiPo 3S、25.92 Wh;整机约 3.3 kg
工具
- 按快速入门指南自行组装底盘、机械臂与机械爪,包装内附螺丝刀柄
- 拍照录像需自备最大 64 GB 的 microSD 卡(编程模式下须剩余 2 GB 以上)
技能
- RoboMaster App 实验室中的 Scratch 积木与 Python 3.6
- 电脑端 Python SDK(Windows、Linux、macOS)与明文 SDK 套接字协议
- 经 UART、PWM 与传感器转接模块接第三方硬件
软件
- RoboMaster App:单机、对战与实验室模式
- RoboMaster SDK(Python):运动控制、智能识别、灯效、数据推送、视频流与音频流;多机编队
- 明文 SDK 与官方课程(搜救、空地协同、智能仓储等)