本PDF文档详述了RCS-2000 V3.1.3版本的外部任务接口,旨在为用户提供详细的参数设置、数据交互和操作指南,助力实现高效精准的厂内物流调度。
《厂内物流调度控制系统RCS-2000 V3.1.3 对外任务接口文档》中的关键知识点概述如下:
1. **系统简介**:
RCS-2000是杭州海康机器人技术有限公司研发的工业自动化领域的重要软件,专为控制和调度工厂内部物流设备(如自动引导车AGV)而设计。该版本详细阐述了控制系统对外接口的具体细节,以确保与上层平台的有效交互。
2. **协议声明**:
文档中的所有接口及数据交换均采用JSON格式,并规定中文编码使用URLEncoder.encode(string,UTF-8),解码时则用URLDecoder.decode(string,UTF-8)。文档中提及的所有内容受版权法保护,未经公司正式授权,不得擅自复制或传播。
3. **接口分类**:
文档定义了包括基础和可选在内的多种类型接口。基础接口用于初始对接阶段的必要操作(如生成任务单、继续执行及取消任务等),而可选功能则涉及更高级别的控制选项(例如设置优先级,绑定/解绑物料与位置等)。
4. **调用约定**:
在进行接口请求时,所有参数需为字符串形式,并且每个请求都必须包含一个唯一的reqCode标识符。其他如时间戳、客户端编号和令牌号虽可选但需要提前配置好。返回信息将包括执行状态(通过code字段体现)及其他相关数据。
5. **错误码定义**:
系统中预设了多个错误代码来指示不同的处理结果,例如“0”代表成功,“1”,“6”,“99”,“100”等分别表示不同类型的失败情况。如果请求超时未响应,则默认返回连接失败。
6. **调用地址**:
RCS-2000采用REST协议进行服务调用,默认端口为8182,而获取AGV状态的接口则使用另一个特定端口号(即8083)来访问。
7. **示例场景及代码实例**:
文档内还提供了典型调度情景描述以及部分接口的实际应用案例,以帮助开发者更好地理解和实施这些接口的功能。
8. **附加资源**:
附件中包括了AGV状态列表、地图元素类型清单以及其他实用的DEMO代码片段等信息,旨在进一步支持开发者的操作需求和理解能力。
9. **更新历史记录**:
文档结尾处列出了版本迭代日志,以便于追踪系统功能的变化情况。