资料中心

适用产品

覆盖云驰 S2、风行 M3、通用化底盘、具身智能平台、抓取式机器人、搬运外骨骼、专用拖车和扫码枪。

资料内容

• 产品概述、典型应用、主要功能、整机结构和可选配置。
• 尺寸、质量、载荷、速度、续航、防护、通信和环境要求。
• 传感器、充电方式、接口能力、配套附件和运输包装。
• 安全警示、禁止行为、维护周期和有限保修说明。

版本识别

下载前请核对产品型号、硬件版本和发布日期。同一产品不同批次可能存在接口、部件或软件差异，项目交付资料优先于公开手册。

开始之前

• 检查包装、整机、附件、电池和充电设备是否完好。
• 确认场地道路、电源、无线网络、照明和安全区域满足要求。
• 准备管理员账号、设备序列号和需要接入的业务系统信息。

首次配置

依次完成开机自检、设备激活、网络连接、时间同步、地图创建、充电位标定、限速与电子围栏配置。

首个任务

建立起点和目标点，检查路径、避障、急停、远程接管和低电量回充，再以低载荷完成试运行和任务记录确认。

软件分类

• 机器人本体固件、传感器固件和安全控制组件。
• 设备配置工具、调试客户端、日志导出与诊断工具。
• 云端调度平台、现场管理端和移动端辅助工具。

版本说明

每个版本标注发布日期、适用型号、功能变化、修复项目、已知限制和兼容性要求。生产环境应优先使用稳定版本。

升级要求

升级前备份地图和配置，保证电量与网络稳定；先在测试设备验证任务、充电、接口与安全功能，再分批部署。升级异常时停止操作并联系技术支持。

资源范围

• SDK、示例程序、数据结构、通信协议和开发环境配置。
• 机器人描述文件、坐标系、仿真模型和基础控制示例。
• 任务、地图、设备状态、告警、充电和远程控制能力。

开发流程

建议依次完成鉴权、状态读取、测试任务、异常处理、限速与急停验证，再接入业务系统。所有自研功能应在隔离环境测试。

安全边界

开发资源不代表可以绕过设备安全限制。自定义程序应处理失联、超时、重复指令、坐标异常和控制冲突，并保留人工接管能力。

核心接口

• 设备查询、在线状态、电量、位置、模式和健康信息。
• 任务创建、取消、暂停、恢复、优先级和执行结果。
• 地图、点位、路线、禁行区、限速区和充电位管理。
• 门禁、电梯、闸机、呼叫终端、扫码设备和第三方调度联动。

鉴权与安全

接口使用独立凭证和最小权限，生产凭证不得写入前端代码。建议启用 HTTPS、来源限制、请求签名、时间戳和操作审计。

稳定性要求

调用方应处理限流、超时、重试、幂等、重复回调和状态延迟。错误码、字段和版本变更以当前接口文档为准。

常见主题

• 网络连接、定位漂移、地图更新、路径阻塞和任务异常。
• 充电失败、电池告警、续航下降、轮组磨损和结构松动。
• 传感器清洁、日志导出、远程诊断、固件升级和备件更换。

排查方法

先确认告警时间、设备状态和现场变化，再检查电源、网络、传感器、地图和任务配置，保留日志和现场照片后进行单项验证。

维护建议

建立日检、周检和周期维护记录。高频运行场景应缩短轮组、制动、紧固件、充电触点和电池健康检查周期。