Amoe8a AMR — VDA5050 北向介面 3.0.0

車上 Amoe8aOMS 是 VDA5050 v3.0 的車輛端;你的調度系統是 master。 本規格只收照著接就會動的 channel,欄位定義原樣取自 VDA5050 官方 JSON Schema。

Servers

  • mqtt://{brokerHost}:{brokerPort}/mqttvehicle

    車上內建 Mosquitto,或場域既有 broker(雙模)。正式部署為 mTLS。

    object
    string
    required
    string
    required

Operations

  • RECEIVE {interfaceName}/{majorVersion}/{manufacturer}/{serialNumber}/state

    位置、電量、driving、operatingMode、errors、safetyState、orderId 可用。

    位置、電量、driving、operatingMode、errors、safetyState、orderId 可用。

    Operation IDreceiveState

    Available only on servers:

    object
    interfaceNamestring
    required

    介面名稱,本平台固定 vda5050

    majorVersionstring
    required

    協定 major 版本,本平台為 v3

    manufacturerstring
    required

    製造商識別,逐案設定。

    serialNumberstring
    required

    車輛序號,逐車唯一。

    Accepts the following message:

    state

    State of the mobile robot.

    Message IDstate
    object [state]

    State of the mobile robot.

    Examples

  • RECEIVE {interfaceName}/{majorVersion}/{manufacturer}/{serialNumber}/connection

    retained,含 LWT 斷線遺囑。

    retained,含 LWT 斷線遺囑。

    Operation IDreceiveConnection

    Available only on servers:

    object
    interfaceNamestring
    required

    介面名稱,本平台固定 vda5050

    majorVersionstring
    required

    協定 major 版本,本平台為 v3

    manufacturerstring
    required

    製造商識別,逐案設定。

    serialNumberstring
    required

    車輛序號,逐車唯一。

    Accepts the following message:

    connection

    The last will message of the mobile robot. Has to be sent with retain flag. Once the mobile robot comes online, it has to send this message on its connect topic, with the connectionState enum set to "ONLINE". The last will message is to be configured with the connection state set to "CONNECTIONBROKEN". Thus, if the mobile robot disconnects from the broker, fleet control gets notified via the topic "connection". If the mobile robot is disconnecting in an orderly fashion (e.g. shutting down, sleeping), the mobile robot is to publish a message on this topic with the connectionState set to "DISCONNECTED".

    Message IDconnection
    object [connection]

    The last will message of the mobile robot. Has to be sent with retain flag. Once the mobile robot comes online, it has to send this message on its connect topic, with the connectionState enum set to "ONLINE". The last will message is to be configured with the connection state set to "CONNECTIONBROKEN". Thus, if the mobile robot disconnects from the broker, fleet control gets notified via the topic "connection". If the mobile robot is disconnecting in an orderly fashion (e.g. shutting down, sleeping), the mobile robot is to publish a message on this topic with the connectionState set to "DISCONNECTED".

    Examples

  • SEND {interfaceName}/{majorVersion}/{manufacturer}/{serialNumber}/order

    多節點翻譯進本車佇列;orderId 透明不重編,重複 orderId 冪等忽略。

    多節點翻譯進本車佇列;orderId 透明不重編,重複 orderId 冪等忽略。

    Operation IDsendOrder

    Available only on servers:

    object
    interfaceNamestring
    required

    介面名稱,本平台固定 vda5050

    majorVersionstring
    required

    協定 major 版本,本平台為 v3

    manufacturerstring
    required

    製造商識別,逐案設定。

    serialNumberstring
    required

    車輛序號,逐車唯一。

    Accepts the following message:

    Order Message

    The message schema to communicate orders from fleet control to the mobile robot.

    Message IDorder
    object [Order Message]

    The message schema to communicate orders from fleet control to the mobile robot.

    Examples

  • SEND {interfaceName}/{majorVersion}/{manufacturer}/{serialNumber}/instantActions

    僅 emergencyStop/startPause/cancelOrder 三個受理。

    僅 emergencyStop/startPause/cancelOrder 三個受理。

    Operation IDsendInstantActions

    Available only on servers:

    object
    interfaceNamestring
    required

    介面名稱,本平台固定 vda5050

    majorVersionstring
    required

    協定 major 版本,本平台為 v3

    manufacturerstring
    required

    製造商識別,逐案設定。

    serialNumberstring
    required

    車輛序號,逐車唯一。

    Accepts the following message:

    instantActions

    JSON Schema for publishing instantActions that the mobile robot is to execute as soon as they arrive.

    Message IDinstantActions
    object [instantActions]

    JSON Schema for publishing instantActions that the mobile robot is to execute as soon as they arrive.

    Examples

Messages

  • #1state

    State of the mobile robot.

    Message IDstate
    object [state]

    State of the mobile robot.

  • #2connection

    The last will message of the mobile robot. Has to be sent with retain flag. Once the mobile robot comes online, it has to send this message on its connect topic, with the connectionState enum set to "ONLINE". The last will message is to be configured with the connection state set to "CONNECTIONBROKEN". Thus, if the mobile robot disconnects from the broker, fleet control gets notified via the topic "connection". If the mobile robot is disconnecting in an orderly fashion (e.g. shutting down, sleeping), the mobile robot is to publish a message on this topic with the connectionState set to "DISCONNECTED".

    Message IDconnection
    object [connection]

    The last will message of the mobile robot. Has to be sent with retain flag. Once the mobile robot comes online, it has to send this message on its connect topic, with the connectionState enum set to "ONLINE". The last will message is to be configured with the connection state set to "CONNECTIONBROKEN". Thus, if the mobile robot disconnects from the broker, fleet control gets notified via the topic "connection". If the mobile robot is disconnecting in an orderly fashion (e.g. shutting down, sleeping), the mobile robot is to publish a message on this topic with the connectionState set to "DISCONNECTED".

  • #3Order Message

    The message schema to communicate orders from fleet control to the mobile robot.

    Message IDorder
    object [Order Message]

    The message schema to communicate orders from fleet control to the mobile robot.

  • #4instantActions

    JSON Schema for publishing instantActions that the mobile robot is to execute as soon as they arrive.

    Message IDinstantActions
    object [instantActions]

    JSON Schema for publishing instantActions that the mobile robot is to execute as soon as they arrive.

Schemas

  • object [state]

    State of the mobile robot.

  • object [connection]

    The last will message of the mobile robot. Has to be sent with retain flag. Once the mobile robot comes online, it has to send this message on its connect topic, with the connectionState enum set to "ONLINE". The last will message is to be configured with the connection state set to "CONNECTIONBROKEN". Thus, if the mobile robot disconnects from the broker, fleet control gets notified via the topic "connection". If the mobile robot is disconnecting in an orderly fashion (e.g. shutting down, sleeping), the mobile robot is to publish a message on this topic with the connectionState set to "DISCONNECTED".

  • object [Order Message]

    The message schema to communicate orders from fleet control to the mobile robot.

  • object [instantActions]

    JSON Schema for publishing instantActions that the mobile robot is to execute as soon as they arrive.