yuliang
/
yvan-rcs-web
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
573 Commits
2 Branches
0 Tags
22 MiB
 
 
 
Tree: 223f05ad64
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '223f05ad64'
${ noResults }
yvan-rcs-web/doc/RCS与AGV之间的指令数据格式.md

72 KiB
Raw Blame History

RCS与AMR之间的指令数据格式

RCS与AMR通信指令数据格式

通信方式概览

  • RCS（Robot Control System）与AMR（Autonomous Mobile Robot）间通过MQTT协议通信，MQTT服务器默认不设置密码。AMR内部设置MQTT服务器的信息（IP、端口、用户名密码等，需要在项目部署时设置），启动后会自动监听任务topic。
  • RCS下发任务给AMR时使用的topic为"/wcs_server/"，其中""部分替换为AMR的编号，比如"/wcs_server/5"，代表下发给5号车的topic。
  • RCS可以通过"/wcs_broadcast"来发全局查询（内容与"/wcs_server/"一致，但广播接口目前只支持查询状态，不支持其它报文），以便在RCS重启等情况下能同步所有车的状态。
  • 所有AMR上报的信息统一发到"/agv_robot/status"，这样RCS可以监听到所有配置了同一个MQTT服务的AMR的消息。

RCS发往AMR的指令

AMR作业指令 10010

Field Name Field Description Format Values/ Remarks
ID#10010 指令ID
SeqNo 作业序号 UInt32
OperationType 作业类型 UInt8 0：运输 1：接货 2：卸货 3：充电 4：提升移栽取货或卸货 5：滚筒取货或卸货（双向作业）
ChargeDirection 充电桩朝向UseBriefLocation UInt8 0: X轴正向 1: Y轴正向 2: X轴负向 3: Y轴负向
DistanceToCharging 充电工位坐标和充电桩之间距离 UInt16 单位：mm
StorageRacksNo 目标货架编号 String 仅做校验使用（仅接货用）
StartX 小车起始X坐标 UInt16
StartY 小车起始Y坐标 UInt16
EndX 小车目标X坐标 UInt16
EndY 小车目标Y坐标 UInt16
GoNow 任务是否立即执行 bool 默认为true
LinkCounts 路径分段数 UInt8
Link (重复LinkCounts次)
X 该段目标点X坐标 UInt16 逻辑单位，乘以一定系数才是物理距离
Y 该段目标点Y坐标 UInt16 同上
Speed 该段行驶速度 Int16 mm/s
BuiltinSlotNo AMR内置货位ID（仅对多层移栽有意义） UInt8 1～N
PickMode 提升移栽货物拣货模式 UInt8 0:不控制（无动作） 1:从货架上取货 2:将货物放到货架上 3:仅调整托盘高度（不进行取放货操作） 4:调整车身货物(仅供调试，RCS勿发送此命令) 5:仅调整载货台到取货高度，但是不动作 6:仅调整载货台到放货高度，但是不动作
GoodsSlotHeight 目标货位相对于地面的绝对高度 UInt16 单位：mm
GoodsSlotDirection 目标货位朝向 UInt8 朝向定义与充电桩朝向相同。 0: X轴正向 1: Y轴正向 2: X轴负向 3: Y轴负向
MPickMode 多机构^[1]^的拣货模式 UInt8[3] 数组形式，意义同"PickMode"
MGoodsSlotHeight 多机构^[1]^的目标货位高度 UInt16[3] 数组形式，意义同"GoodsSlotHeight"
MGoodsSlotDirection 多机构^[1]^的目标货位朝向 UInt8[3] 数组形式，意义同"GoodsSlotDirection"
MStorageRacksNo 多机构的目标货箱ID String[3] 数组形式，意义同"StorageRacksNo"
Roll1Motion 滚筒1运动操作 对于左右滚动的双滚筒机型，此滚筒为靠近车头的滚筒。 对于前后滚动的双滚筒机型，此滚筒为车身左侧的滚筒。 UInt8 同"PickMode"
Roll2Motion 滚筒2运动操作 对于左右滚动的双滚筒机型，此滚筒为靠近车尾的滚筒。 对于前后滚动的双滚筒机型，此滚筒为车身右侧的滚筒。 对于单滚筒机型，此参数无意义。 UInt8 同上
Roll1StationDirection 与滚筒1对接的站台朝向 UInt8 朝向定义与充电桩朝向相同。 0: X轴正向 1: Y轴正向 2: X轴负向 3: Y轴负向
Roll2StationDirection 与滚筒2对接的站台朝向 对于单滚筒机型，此参数无意义。 UInt8 同上
Roll1GoodsLength 滚筒1目标货物长度 UInt16 单位：mm
Roll2GoodsLength 滚筒2目标货物长度 对于单滚筒机型，此参数无意义。 UInt16 同上
Roll1GoodsQuantity 滚筒1目标货物数量 UInt16 1～N
Roll2GoodsQuantity 滚筒2目标货物数量 对于单滚筒机型，此参数无意义。 UInt16 同上
MRollMotion 多滚筒运动模式 UInt8[6] 数组形式，意义同"RollMotion"
MRollStationDirection 多滚筒对接的站台朝向 UInt8[6] 数组形式，意义同"RollStationDirection"
MRollGoodsQuantity 多滚筒目标货物数量 UInt16[6] 数组形式，意义同"RollGoodsQuantity"
Preparing 是否仅执行任务的准备部分 bool 默认为false，仅执行该动作的准备部分，如仅进行导航，调整托盘高度等，但不进行取放货操作
RackTypeId 货架标识 uint32 车根据货架类型查询尺寸进行避障
EndSelfAdaption 终点自适应 bool 默认为false，为true时，会根据任务和对应器件的位置，自动调整停止点

注[1]：对于哪吒三层飞梭，下标0表示最低的取放货机构；下标1表示中间的取放货机构；下标2表示最高的取放货机构。

例如：

{
  "id": 10010,
  "content": {
    "SeqNo": 4,
    "OperationType": 0,
    "StorageRacksNo": "R123",
    "StartX": 700,
    "StartY": 1400,
    "EndX": 100,
    "EndY": 100,
    "LinkCounts": 4,
    "Link": [
      {
        "X": 700,
        "Y": 100,
        "Speed": 150
      },
      {
        "X": 100,
        "Y": 100,
        "Speed": 150
      }
    ]
  }
}

停止/解除 10040

Field Name Field Description Format Values/ Remarks
ID#10040 指令ID
SeqNo 作业序号 Uint32
OperationCode 操作代码 Uint8 0-停止 1-解除
StopX 停止点X坐标 Uint16
StopY 停止点Y坐标 Uint16

例如：

{
  "id": 10040,
  "content": {
    "SeqNo": 1023844,
    "OperationCode": 0,
    "StopX": 100,
    "StopY": 100
  }
}

电文应答 10050

Field Name Field Description Format Values/ Remarks
ID#10050 指令ID
SeqNo 作业序号 UInt32 所要应答消息的SeqNo(对方的)

例如：

{
  "id": 10050,
  "content": {
    "SeqNo": 1
  }
}

心跳 10100

Field Name Field Description Format Values/ Remarks
ID#10100 指令ID

例如：

{
  "id": 10100,
  "content": {}
}

配置信息 10060

Field Name Field Description Format Values/ Remarks
ID#10060 指令ID
SeqNo 作业序号 UInt32 0（特殊）
XLength X坐标最大长度 UInt16 暂时未使用
YLength Y坐标最大长度 UInt16 暂时未使用
Gap 相邻地标间距 UInt16 单位:mm （目前等距）
HeartBeat 心跳间隔 UInt32 单位：秒
MqRetryTime 小车所有上报消息重试间隔(未收到应答消息时重发消息) UInt32 单位：秒

例如：

{
  "id": 10060,
  "content": {
    "SeqNo": 0,
    "XLength": 100,
    "YLength": 100,
    "Gap": 100,
    "HeartBeat": 60,
    "MqRetryTime": 3
  }
}

旋转货架 10080

Field Name Field Description Format Values/ Remarks
ID#10080 指令ID
SeqNo 作业序号 Uint32
Direction 货架A面朝向 UInt8 0: X轴正向 1: Y轴正向 2: X轴负向 3: Y轴负向

例如：

{
  "id": 10080,
  "content": {
    "SeqNo": 110,
    "Direction": 1
  }
}

旋转车身 10081

Field Name Field Description Format Values/ Remarks
ID#10081 指令ID
SeqNo 作业序号 Uint32
Direction 车头朝向 UInt8 0: X轴正向 1: Y轴正向 2: X轴负向 3: Y轴负向

例如：

{
  "id": 10081,
  "content": {
    "SeqNo": 110,
    "Direction": 1
  }
}

状态查询 10110

Field Name Field Description Format Values/ Remarks
ID#10110 指令ID
SeqNo 作业序号 Uint32

查询车的当前状态。正常情况下只有当车正确初始化后才会应答，但有两种例外情况：

  1. 通过广播接口发生的状态查询请求
  2. 在AMR配置文件中设置了强制应答

在未完成初始化的情况下应答的状态报文可能是不准确的，比如位置未知，比如货位状态不准确等，上位系统需要针对性做处理。

控制卷帘门 10082

Field Name Field Description Format Values/ Remarks
ID#10082 指令ID
SeqNo 作业序号 Uint32
CurtainCmd 卷帘状态 UInt8 0: 不控制（无动作） 1: 关闭状态 2: 半开状态 3: 全开状态 4: 停止（暂不支持）

例如：

{
  "id": 10082,
  "content": {
    "SeqNo": 110,
    "CurtainCmd": 1
  }
}

取消已下发小车任务 10120

Field Name Field Description Format Values/ Remarks
ID#10120 指令ID
SeqNo 作业序号 Uint32

例如：

{
  "id": 10120,
  "content": {
    "SeqNo": 110
  }
}

等待就绪 19997

Field Name Field Description Format Values/ Remarks
ID#19997 指令ID
SeqNo 作业序号 Uint32
Seconds 等待时间（s） Double -1：结束等待（仅SLAM车支持） 0：持续等待（仅SLAM车支持） 大于0：等待对应的时间后返回成功

例如：

{
  "id": 19997,
  "content": {
    "SeqNo": 110,
    "Seconds": 0
  }
}

设置小车坐标 10200

Field Name Field Description Format Values/ Remarks
ID#10200 指令ID
SeqNo 作业序号 Uint32
X 点X坐标 Uint16
Y 点Y坐标 Uint16
Direction 车头朝向 UInt8 0: X轴正向 1: Y轴正向 2: X轴负向 3: Y轴负向 15: 未知（小车保持原车头方向）

例如：

{
  "id": 10200,
  "content": {
    "SeqNo": 110,
    "X": 1,
    "Y": 1,
    "Direction": 15
  }
}

AMR发往RCS的指令

共同信息

Field Name Field Description Format Values/ Remarks
SeqNo 作业序号 UInt32 从1开始，0作为超级序号使用，不参与序号规则判断
VehicleId AMR编号 UInt16
CreateTime 消息创建时间 UInt64 单位：毫秒 示例：1685589750403
CreateMonoTime 消息创建时主机的开机时长 UInt64 单位：毫秒 示例：822652887 备注：由于刚开机时设备内部时间可能不准，所以将开机时长也上报，这样可以在时间同步后，再反推时间同步前时间的时间
SendTime 发送消息的时间 UInt64 单位：毫秒 示例：1685589750403

小车作业完成 20010

Field Name Field Description Format Values/ Remarks
ID#20010 指令ID
SeqNo 作业序号 UInt32
VehicleId AMR编号 UInt16
CurX 当前X坐标 UInt16 逻辑单位，乘以一定系数才是物理距离
CurY 当前Y坐标 UInt16 同上
CurDirection 当前方向 UInt8 0: X轴正向 1: Y轴正向 2: X轴负向 3: Y轴负向
OperationType 作业类型 UInt8 0：运输 1：接货 2：卸货 3：充电 4：提升移栽取货或卸货 5：滚筒取货或卸货（双向作业） 135：旋转货架 136：旋转车身
OperationResult 作业结果 Int32 参考linux errno
StorageRacksNo 货物ID String 在肥波类车型中是货架二维码值；在飞梭车中是箱码（目前未传，未来可能会有）；在皮带飞梭中是货物上贴的二维码的码值（如果检测到多个码，则以"
Battery 电量百分比 Uint8
Summary 任务描述 Object 目前仅在飞梭和侧叉车型的报文中有这个字段，字段详情见下文
Summary.Actuators 执行器（比如飞梭的载货台）任务概览列表 Array 车载多少个执行器，数组就有多少个成员
Summary.Actuators.MechNo 执行器编号 UInt8 从1开始
Summary.Actuators.Name 执行器名称 String
Summary.Actuators.PickMode 任务类型 UInt8 同下发任务中PickMode的定义
GoodsSlots 车载货位信息 [Object] 参见货位信息

示例：

{
  "content": {
    "Battery": 84,
    "CurDirection": 0,
    "CurX": 10,
    "CurY": 11,
    "OperationResult": 0,
    "OperationType": 4,
    "SeqNo": 635,
    "StorageDirection": 15,
    "StorageRacksNo": "0331794865-S12",
    "Summary": {
      "Actuators": [
        {
          "MechNo": 1,
          "Name": "Mech1",
          "PickMode": 2
        }
      ]
    },
    "VehicleId": 41
  },
  "id": 20010
}

小车子模块任务状态 20012

Field Name Field Description Format Values/ Remarks
ID#20012 [2] 指令ID
SeqNo 作业序号 UInt32
VehicleId AMR编号 UInt16
MPickMode 多机构^[1]^的拣货模式 UInt8[3] 数组形式，意义同"PickMode"
MechStatus 子模块任务状态 Uint8 [3] 数组形式，数组下标^[1]^分别对应各子模块。 0：无任务 2：任务中 3：任务准备中（已有任务，但还没有执行任务的条件） 5：任务异常 7：任务完成 其它：保留
MStorageRacksNo 子模块货物ID String[3] 数组形式，分别对应各子模块上货箱的ID码的值，如果无货为"",如果解不出来为"unknown"

注[1]：对于哪吒三层飞梭，下标0表示最低的取放货机构；下标1表示中间的取放货机构；下标2表示最高的取放货机构。

注[2]：AMR主动上报此状态，用于上报20010前反馈给RCS当前子模块的任务状态，方便RCS对货位状态进行管理以及异常时候的任务取消和重发处理。

地标报告 20020

Field Name Field Description Format Values/ Remarks
ID#20020 指令ID
SeqNo 作业序号 UInt32
VehicleId AMR编号 UInt16
CurX 当前X坐标 UInt16
CurY 当前Y坐标 UInt16
CurDirection 当前方向 UInt8 0: X轴正向 1: Y轴正向 2: X轴负向 3: Y轴负向

例如：

{
  "content": {
    "CurDirection": 1,
    "CurX": 700,
    "CurY": 1400,
    "SeqNo": 126,
    "VehicleId": 0
  },
  "id": 20020
}

消息应答 20050

Field Name Field Description Format Values/ Remarks
ID#20050 指令ID
SeqNo 作业序号 UInt32
VehicleId AMR编号 UInt16

例如：

{
  "content": {
    "SeqNo": 2,
    "VehicleId": 0
  },
  "id": 20050
}

状态上报 20060

Field Name Field Description Format Values/ Remarks
ID#20060 指令ID
CurBattery 电池状态 Struct
CurOrientation 当前方向 Double
CurLogicX 当前所在站点的逻辑X坐标 Int32
CurLogicY 当前所在站点的逻辑Y坐标 Int32
CurX 当前X坐标 Double 当前实际位置在地图坐标系中的X坐标
CurY 当前Y坐标 Double 当前实际位置在地图坐标系中的Y坐标
RackCurOrientation 货架当前方向 Double
RackCurPosition 货架当前位置 Double
SeqNo 作业序号 UInt32
StorageRacksNo 货架号 String
MStorageRacksNo 多载货机构上每个机构上面货物的ID String[] 对于哪吒车型，前三项分别代表三层载货台上的货物ID，如果无货则为"",如果有货但解不出货物码或没有货物码，则为"unkonwn"，如果有货且能解出货物码，则为货物码的码值
TaskMode 任务模式 UInt8
VehicleId AMR编号 UInt16
X 当前标准X坐标 Int32 当前所在站点的X坐标
Y 当前标准Y坐标 Int32 当前所在站点的Y坐标
GoodsQuantity 当前货物数量。数组形式。 对于单滚筒等单个托盘的机型，只需关注数据0； 对于双滚筒，滚筒1的数量放到数据0中，滚筒2的货物数量放到数据1中。 其它机型以此类推。 UInt16 [4] 数组形式
Exceptions 异常数组，存放异常的所有异常ID UInt16 [4] 数组形式
InDock 是否已进行精准停靠（是否能在原地直接执行对接任务） bool 默认为true
GoodsSlots 车载货位信息 [Object] 参见货位信息

例如：

{
  "content": {
    "CurBattery": {
      "ChargingCurrent": 0,
      "DischargingCurrent": 3.8,
      "SOC": 57,
      "Voltage": 48.025
    },
    "CurOrientation": -179.776,
    "CurX": 943.739,
    "CurY": 99.3311,
    "RackCurOrientation": -179.246,
    "RackCurPosition": 0.0440616,
    "SeqNo": 93585,
    "StorageRacksNo": "R031",
    "TaskMode": 2,
    "VehicleId": 2,
    "X": 900,
    "Y": 100,
    "GoodsQuantity": [
      2,
      0,
      0,
      0
    ],
    "Exceptions": [],
    "InDock": true
  },
  "id": 20060
}

心跳 20100

Field Name Field Description Format Values/ Remarks
ID#20100 指令ID
SeqNo 作业序号 Uint32
VehicleId AMR编号 Uint16
Battery 电量 UInt8
Uptime 上电至今的毫秒数 UInt64
Temperature.Battery 电池温度 Double 单位：摄氏度 备注：一个电池可能有多个（不同型号的）温度传感器，目前只上报最高的温度

例如：

{
  "content": {
    "SentTime": 1685589750403,
    "Battery": 67,
    "Temperature": {
      "Battery": 30.5
    },
    "CreateMonoTime": 822652887,
    "CreateTime": 1685589750403,
    "SeqNo": 730,
    "Uptime": 822652887,
    "VehicleId": 1
  },
  "id": 20100
}

小车主程序启动 20149

代表车的主程序已经启动，接下来马上会进行初始化，如果初始化顺利完成便会上报上线消息。

Field Name Field Description Format Values/ Remarks
ID#20149 指令ID
SeqNo 作业序号 UInt32
VehicleId AMR编号 UInt16
Battery 电量 UInt8
AGVModel AMR底盘型号 String 对于底盘和功能一体的版本，由底盘型号便知道功能；对于通用底盘，底盘型号指定了底盘的版本
AGVFnModel AMR功能型号 String 底盘之上的工装的型号

小车上线 20150

代表车已经完成初始化，可以接收任务了。

Field Name Field Description Format Values/ Remarks
ID#20150 指令ID
SeqNo 作业序号 UInt32
VehicleId AMR编号 UInt16

例如：

{
  "content": {
    "Battery": 88,
    "SeqNo": 1,
    "VehicleId": 0
  },
  "id": 20150
}

小车离线 20200

注意：目前未实现此报文

Field Name Field Description Format Values/ Remarks
ID#20200 指令ID
VehicleId AMR编号 UInt16

例如：

{
  "id": 20200,
  "content": {
    "VehicleId": 23412
  }
}

异常上报 20250

Field Name Field Description Format Values/ Remarks
ID#20250 指令ID
SeqNo 作业序号 UInt32
VehicleId AMR编号 UInt16
ErrCode 异常代码 UInt8 1. 货架编号不匹配 2. 地标异常 3. 电量低
MechNo 异常机构代码 UInt8 对于哪吒飞梭类的机型，增加MechNo用于指示异常具体是哪一层发生的。 MechNo： 1- 机构1^[1]^异常 2- 机构2异常 3- 机构3异常
ErrMsg 异常详情 Struct 根据不同的异常，字段不一样，比如针对ErrCode为2电量低的情况，ErrMsg中使用CurBattery标识当前电量；
ErrEvtType 异常事件类型 UInt8 0：无 1：开始 2：更新 3：结束 4：开始并结束
ErrLevel 异常等级 UInt8 0：Undetermined 12：Info 13：Warning 14：Critical 15：Fatal
ErrLifecycle 异常生命周期 UInt8 0：易变的 1：一次性 2：持续性 3：任务期间

注[1]：对于哪吒三层飞梭，机构1表示最低的取放货机构；机构2表示中间的取放货机构；机构3表示最高的取放货机构。

例如：

{
  "id": 20250,
  "content": {
    "VehicleId": 23412,
    "ErrCode": 2,
    "ErrMsg": {
      "CurBattery": 50
    }
  }
}

开机上报 20147

在开机后上报一次，此后AMR程序重启不会重新上报（与ID#20149的差异），除非人为清除内部记录已上报的标志。

Field Name Field Description Format Values/ Remarks
ID#20147 指令ID
SeqNo 作业序号 UInt32
VehicleId AMR编号 UInt16
Battery 电量 UInt8
AGVModel AMR底盘型号 String 对于底盘和功能一体的版本，由底盘型号便知道功能；对于通用底盘，底盘型号指定了底盘的版本
AGVFnModel AMR功能型号 String 底盘之上的工装的型号
Uptime 上电至今的毫秒数 UInt64

关机上报 20148

在收到关机信号后上报此消息。

Field Name Field Description Format Values/ Remarks
ID#20148 指令ID
SeqNo 作业序号 UInt32
VehicleId AMR编号 UInt16
Battery 电量 UInt8
Uptime 上电至今的毫秒数 UInt64

任务状态上报 20011

任务状态变化时会上报此消息

Field Name Field Description Format Values/ Remarks
ID# 20011 指令ID
SeqNo 作业序号 UInt32
VehicleId AMR编号 UInt16
EventId 事件ID UInt8 0：无变化 1：任务模式改变 2：任务接收成功 3：任务开始 4：任务完成 5：任务已取消 6：任务已停止 7：任务已恢复 8：任务已更变
Info 由事件ID决定 Object 默认消息（0，2，3，5，6，7）：任务状态改变消息 1：任务模式消息 4：任务完成消息 8：任务类型改变消息
  • 任务完成消息
Field Name Field Description Format Values/ Remarks
OperationType 任务类型
OperationResult 作业结果 Int32 参考linux errno
CurLogicX 当前X逻辑坐标 Int32
CurLogicY 当前Y逻辑坐标 Int32
CurX 当前X坐标 Double
CurY 当前Y坐标 Double
CurDirection 当前方向 #### Direction 参考通用类型定义
StorageRacksNo 货架号 String
StorageDirection 货架朝向 #### Direction 参考通用类型定义
Battery 电量百分比 Uint8
GoodsSlots 车载货位信息 [Object] 参见货位信息
  • 任务模式改变消息
Field Name Field Description Format Values/ Remarks
PrevTaskMode 上一个任务模式 TaskMode 参考通用类型定义
TaskMode 当前任务模式 #### TaskMode 参考通用类型定义
  • 任务类型改变消息
Field Name Field Description Format Values/ Remarks
PrevOperationType 上一个任务类型 OperationType 参考通用类型定义
OperationType 当前任务类型 OperationType 参考通用类型定义
  • 任务状态改变消息
Field Name Field Description Format Values/ Remarks
OperationType 当前任务类型 OperationType 参考通用类型定义

货位信息

Field Name Field Description Format Values/ Remarks
ID 货位ID UInt8 从0开始，每款车自己定义的车载货位的ID
Name 货位名称 String 每款车自己定义的货位的名称
ShouldHaveGoods 逻辑上是否应该有货 Bool 有些车型有传感器来检测货物状态，这时实际的货物状态跟逻辑状态就可能不同
DetectedStatus 检测到的货位状态 UInt8 0: 正常 1: 冲突，即传感器检测到的状态跟逻辑状态有冲突。逻辑上有货，实际无货，是一种冲突；逻辑上货的属性（比如高度）跟实际检测到的属性不同，也会产生冲突；对于一个货位有多个货物的情况，需要查看货物信息来查找具体是哪个货物出现了什么冲突
Height 货位放货平面离地高度 Double
Position 货位相对原点（初始化后货位所在位置）的相对位置 Object 包含以下成员： OffsetX：Double类型 OffsetY：Double类型 OffsetZ：Double类型，代表在高度上的位移 Orientation：Double类型，用角度（Degree）表示
Goods 货物信息 [Object] 一个货位可能有多个货物，因此用数组表示；多数情况下一个货位仅存放一个货物

货物信息定义如下：

Field Name Field Description Format Values/ Remarks
Category 货物类型 UInt 对于一类设备可能取放不同货物时有用；如果只有一类货物，则可以不（在地图或者RCS下发的任务报文中）指定，此种情况下报文中不包含此字段
DetectedId 传感器检测到的货物ID String 比如飞梭通过摄像头检测到的箱码、FM系列通过对上摄像头检测到的货架底部二维码等；如果车型没配备可以检测货物ID的传感器，则报文中不包含此字段
UpperSystemDefinedId 上位系统传过来的货物ID String 通常上位传过来的ID应该跟检测到的ID一致，否则会报错；对于没有检测ID功能的车型，不做校验而只是回传该值；有些项目可能会希望两个ID分开，对应此类需求可以特别设置不校验两类ID；也许有些项目会同时传入两种ID，当前暂不支持；如果上位没传入ID，则报文中不包含此字段
HeightLevel 高度等级 UInt8 部分车型能检测货物高度，等级从0（最矮，默认值）开始，每一级递增1，各个等级的具体含义与车型有关，需要另行约定；如果没有对应的检测传感器，则报文中不包含此字段； 如果有传感器但是由于传感器异常等原因无法获取到检测结果，则设置该值为0xff，代表状态未知。
LengthLevel 长度等级 UInt8 类似上面，代表货物长度所属类别
WidthLevel 宽度等级 UInt8 类似上面，代表货物宽度所属类别
WeightLevel 重量等级 UInt8 类似上面，代表货物重量所属类别
ApproximateWeight 测算的重量，不一定准 Double 单位是千克
Orientation 货物在地图上的朝向 Double 角度（Degree）值
RelativePosition 货物相对机器人的位置 Object 包含以下成员： OffsetX：Int32类型 OffsetY：Int32类型 Orientation：Double类型，用角度（Degree）表示
DetectedStatusConflicts 检测到的货物状态冲突 [UInt8] 1：货物ID不匹配 2：货物高度不匹配 3：货物宽度不匹配 4：货物长度不匹配 5：应该有货但没检测到有货 6：应该没货但检测到有货

通用类型定义

OperationType

  • 任务类型
  • 类型 Uint8
Value Description Details
0 运输
1 接货
2 卸货
3 充电
4 提升移栽取货或卸货
5 滚筒取货或卸货（双向作业）
135 旋转货架
136 旋转车身
143 卷帘门控制
224 等待就绪

TaskMode

  • 任务模式
  • 类型 Uint8
Value Description Details
0 空闲模式
1 初始化模式
2 任务模式
3 单动作模式
4 手动模式
5 遥控器模式
6 充电模式
7 任务被中断模式 有任务，但未收到终点坐标
8 自定义模式

Direction

  • 方向
  • 类型 Uint8
Value Description Details
0 X轴正向
1 Y轴正向
2 X轴负向
3 Y轴负向
15 未知方向

简要调用流程

sequenceDiagram
  participant 操作员
  participant RCS
  participant AMR
  activate RCS
  critical 初始化
  操作员->>+AMR: 上电开机
  activate AMR
  AMR-->>RCS: 主程序启动上报（20149）
  AMR-->>RCS: 开机上报（20147）
  AMR-->>RCS: 位姿上报（20020）
  AMR-->>RCS: 上线上报（20150）
  RCS->>AMR: 下发配置（10100）
  end

  critical 执行任务
  RCS->>AMR: 作业指令（10010）
  AMR-->>RCS: 任务开始（20011）
  loop
    AMR-->>RCS: （每当位置变化）位姿上报（20020）
    RCS->>AMR: 更新任务路径（10010）
    Note right of RCS: 只有当每次只下发小段路径时才需要动态更新路径
  end
  AMR-->>RCS: 任务完成（20010和20011）
  end

  critical 心跳上报
  AMR-->>RCS: 心跳（20100）
  Note left of AMR: 没有其它上报报文时才发心跳
  end

  critical 心跳下发
  RCS->>AMR: 心跳（10100）
  end

  critical 消息应答
  AMR-->>RCS: 除应答和心跳外的其它报文
  RCS->>AMR: 应答（10050，SeqNo为所应答的报文的SeqNo值）

  RCS->>AMR: 除应答和心跳外的其它报文
  AMR-->>RCS: 应答（20050, SeqNo为所应答的报文的SeqNo值）
  end

  critical 异常上报
  AMR->>AMR: 检测到异常
  AMR-->>RCS: 异常上报（20250）
  end

  deactivate AMR
  deactivate RCS

常见问题

任务创建时候路径分段数是什么?

指AMR作业指令（10010）中下发给AMR的路径段数，即Link字段（内容为数组）的元素的个数，其中每个元素为一段路径，一般每两个相邻站点生成一段路径，也可以只指定从当前起点到转弯位置作为一段路径。

比如：

{
  "id": 10010,
  "content": {
    "SeqNo": 4,
    "OperationType": 0,
    "StorageRacksNo": "R123",
    "StartX": 7,
    "StartY": 14,
    "EndX": 1,
    "EndY": 1,
    "LinkCounts": 2,
    "Link": [
      {
        "X": 7,
        "Y": 1,
        "Speed": 1000
      },
      {
        "X": 1,
        "Y": 1,
        "Speed": 1000
      }
    ]
  }
}

代表从(7, 14)出发，走到终点(1, 1)的路径，其中起点由(StartX, StartY)来表示，先走到转弯点(7, 1)，再从走到终点(1, 1)。

上述路径也可以分成两步发送，比如可以这样发：

{
  "id": 10010,
  "content": {
    "SeqNo": 4,
    "OperationType": 0,
    "StorageRacksNo": "R123",
    "StartX": 7,
    "StartY": 14,
    "EndX": 1,
    "EndY": 1,
    "LinkCounts": 1,
    "Link": [
      {
        "X": 7,
        "Y": 1,
        "Speed": 1000
      }
    ]
  }
}

{
  "id": 10010,
  "content": {
    "SeqNo": 5,
    "OperationType": 0,
    "StorageRacksNo": "R123",
    "StartX": 7,
    "StartY": 1,
    "EndX": 1,
    "EndY": 1,
    "LinkCounts": 1,
    "Link": [
      {
        "X": 1,
        "Y": 1,
        "Speed": 1000
      }
    ]
  }
}

上面两个命令报文将原有的从起点到终点的完整路径分成两个路径片段（注意SeqNo是不同的；一般是走到某个位置后再下发后续路段，以实现不需要提前规划完整路线，或者希望有更细粒度的交通管制控制的目的），AMR收到命令时会自动进行路径拼接。

电文应答的作用是什么？

因为网络存在不确定性（数据丢失和到达顺序错误。实际项目中都遇到过），所以通过应答消息来实现应用协议层的可靠性，保证上报的报文被对方收到后，才能下发/上报后续报文。

二维码内容的具体格式是什么？

外轮廓为5cmx5cm的QR码（码区域是3cmx3cm），目前有两种方式：

  • 定长码：场地中所有码的间距都一样，码值即坐标值（比如"1,1"代表坐标(1, 1)），贴码的时候需要严格按照顺序粘贴，不需要安装额外的地图服务，但是限制较大，目前不推荐。
  • 变长码：码值为数值（比如"000001"），粘贴时只需要保证方向和位置准确即可，不需要管码值。需要部署地图数据库，需要遍历学习过程。

如果AMR未接收RCS的心跳信息会怎么样？

目前不严格检查RCS端往AMR发的心跳信息，但是建议RCS检查AMR上报的心跳（及其它报文），以确定AMR是否在线。

异常情况中"易变的"是什么意思？

生命周期中的"易变的"（实际上应为"可变的"），指生命周期的属性可能发生改变，比如由"任务期间的"变成"持续的"。实际上这类异常极少。

AMR初始化信息如何获取自己的位置信息？AMR是否需要初始化地图信息？

首次部署需要自动遍历地图来将码值与位置进行自动绑定。AMR初始化时检测所处位置的二维码，通过码值来确定自己的位置和朝向。

"异常情况"包括哪些？

参考请查看附件《AMR异常集》