VDA5050 CMS Extensions (Smart Field CMS) 1.0.0+bot.1

Smart Field CMS 私有擴充 channel:

  • waypoints: 機器人上報站點/路點清單
  • dispatcher/instantActions: IoT Dispatcher 裝置請求任務

這些擴充非 VDA5050 標準;第三方機器人無需實作。

1.0.0 — 2026-04-13 (human:init)

  • 建立三份 AsyncAPI 3.0 spec:core / t-extension / cms-extensions
  • 建立 schemas/{common,enums,messages}、bindings、examples 完整目錄結構
  • 版號採 SemVer 2.0 build metadata 格式 X.Y.Z+bot.N,bot 只動 +bot.N
  • CHANGELOG 自動注入於 asyncapi-*.yaml info.description 與 docs/vda5050-unified-protocol.md

Operations

  • SEND /uagv/v2/{manufacturer}/{serialNumber}/waypoints

    AGV → Master 上報機器人地圖的站點清單

    AGV 上報 waypoints

    Operation IDpublishWaypoints
    object
    manufacturerstring
    required

    廠商代碼

    serialNumberstring
    required

    機器人序號

    object
    object

    Accepts the following message:

    Waypoints (CMS 擴充)
    Message IDWaypoints
    object [Waypoints]

    CMS 擴充 message(非 VDA5050 標準)。 AGV → Master,上報機器人內部地圖的站點清單。

    Examples

  • RECEIVE /uagv/v2/{manufacturer}/{serialNumber}/waypoints

    AGV → Master 上報機器人地圖的站點清單

    Master Control 接收 waypoints

    Operation IDreceiveWaypoints
    object
    manufacturerstring
    required

    廠商代碼

    serialNumberstring
    required

    機器人序號

    object
    object

    Accepts the following message:

    Waypoints (CMS 擴充)
    Message IDWaypoints
    object [Waypoints]

    CMS 擴充 message(非 VDA5050 標準)。 AGV → Master,上報機器人內部地圖的站點清單。

    Examples

  • SEND /uagv/v2/{manufacturer}/{serialNumber}/instantActions

    Dispatcher 裝置以 VDA5050 instantActions 格式請求 CMS 建立任務。 Dispatcher 裝置的 manufacturer/serialNumber 必須事先註冊於 iot_devices 表(type=dispatcher)。

    Dispatcher 發送任務請求

    Operation IDsendDispatcherRequest
    object
    manufacturerstring
    required

    Dispatcher 廠商代碼

    serialNumberstring
    required

    Dispatcher 序號

    object
    object

    Accepts the following message:

    Dispatcher Task Request
    Message IDDispatcherRequest
    object allOf

    Dispatcher 裝置(IoT 按鈕/面板)透過 instantActions 請求 CMS 建立任務。 CMS 透過同 manufacturer/serialNumber 的 state channel 回傳 actionStates。

    Examples

  • RECEIVE /uagv/v2/{manufacturer}/{serialNumber}/instantActions

    Dispatcher 裝置以 VDA5050 instantActions 格式請求 CMS 建立任務。 Dispatcher 裝置的 manufacturer/serialNumber 必須事先註冊於 iot_devices 表(type=dispatcher)。

    CMS 接收 Dispatcher 任務請求

    Operation IDreceiveDispatcherRequest
    object
    manufacturerstring
    required

    Dispatcher 廠商代碼

    serialNumberstring
    required

    Dispatcher 序號

    object
    object

    Accepts the following message:

    Dispatcher Task Request
    Message IDDispatcherRequest
    object allOf

    Dispatcher 裝置(IoT 按鈕/面板)透過 instantActions 請求 CMS 建立任務。 CMS 透過同 manufacturer/serialNumber 的 state channel 回傳 actionStates。

    Examples

Messages

  • #1Waypoints (CMS 擴充)
    Message IDWaypoints
    object [Waypoints]

    CMS 擴充 message(非 VDA5050 標準)。 AGV → Master,上報機器人內部地圖的站點清單。

  • #2Dispatcher Task Request
    Message IDDispatcherRequest
    object allOf

    Dispatcher 裝置(IoT 按鈕/面板)透過 instantActions 請求 CMS 建立任務。 CMS 透過同 manufacturer/serialNumber 的 state channel 回傳 actionStates。