設定 AWS IoT FleetWise Word 訊號 - AWS IoT FleetWise
設定分支設定屬性設定感應器或致動器設定複雜的資料類型

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

設定 AWS IoT FleetWise Word 訊號

本節說明如何設定分支、屬性、感應器和致動器。

設定分支

若要設定分支，請指定下列資訊。

  • fullyQualifiedName – 分支的完整名稱是分支的路徑加上分支的名稱。使用 dot(.) 來參考子分支。例如， Vehicle.Chassis.SteeringWheel 是SteeringWheel分支的完整名稱。 Vehicle.Chassis.是此分支的路徑。

    完整名稱最多可有 150 個字元。有效字元：a–z、A–Z、0–9、冒號 (：) 和底線 (_)。

  • （選用） Description – 分支的說明。

    描述最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

  • （選用） deprecationMessage – 正在移動或刪除的節點或分支的棄用訊息。

    The deprecationMessage 最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

  • （選用） comment – 描述以外的註解。註解可用來提供有關分支的其他資訊，例如分支的原理或相關分支的參考。

    註解最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

設定屬性

若要設定 屬性，請指定下列資訊。

  • dataType – 屬性的資料類型必須是下列其中一項：INT8、UINT8、INT16、UINT16、INT32、UINT32、INT64、UINT64、Word、BOOLEAN、FLOAT、DOUBLE、Word、STRING、UNIX_TIMESTAMP、INT8_Word、Word_ARRAY、UINT8_ARRAY、INT16_ARRAY、UINT16_Word、Word_ARRAY、INT32_ARRAY、UINT32ARRAYINT64_Word、Word_ARRAY、UINT64_ARRAY、BOOLEAN_ARRAY、FLOAT_ARRAY、DOUBLE_ARRAY、STRING_ARRAY、Word、UNIX_TIMESTAMPARRAY、UNKNOWN、Word、 fullyQualifiedName 或資料類型分支中定義的自訂結構。

  • fullyQualifiedName – 屬性的完整名稱是 屬性加上屬性名稱的路徑。使用 dot(.) 來參考子訊號。例如， Vehicle.Chassis.SteeringWheel.Diameter 是 Diameter 屬性的完整名稱。 Vehicle.Chassis.SteeringWheel.是此屬性的路徑。

    完整名稱最多可有 150 個字元。有效字元：a–z、A–Z、0–9、： （冒號） 和 _ （底線）。

  • （選用） Description – 屬性的描述。

    描述最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

  • （選用） unit – 屬性的科學單位，例如 km 或 Celsius。

  • （選用） min – 屬性的最小值。

  • （選用） max – 屬性的最大值。

  • （選用） defaultValue – 屬性的預設值。

  • （選用） assignedValue – 指派給 屬性的值。

  • （選用） allowedValues – 屬性接受的值清單。

  • （選用） deprecationMessage – 正在移動或刪除的節點或分支的棄用訊息。

    The deprecationMessage 最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

  • （選用） comment – 描述以外的註解。註解可用來提供屬性的其他資訊，例如屬性的原理或相關屬性的參考。

    註解最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

設定感應器或致動器

若要設定感應器或致動器，請指定下列資訊。

  • dataType – 訊號的資料類型必須是下列其中一種：INT8、UINT8、INT16、UINT16INT32、UINT32、INT64、Word、UINT64、BOOLEAN、FLOAT、DOUBLE、STRING、Word、UNIX_TIMESTAMP、INT8_ARRAY、Word_Word、UINT8_ARRAY、INT16_ARRAY、UINT16_ARRAY、INT32_ARRAY、Word_Word、UINT32_ARRAY、INT64ARRAYUINT64_ARRAY、Word_Word、BOOLEAN_ARRAY、FLOAT_ARRAY、DOUBLEARRAYSTRING_ARRAY、Word_Word、UNIX、TIMESTAMP_ARRAY、UNKNOWN、Word、 fullyQualifiedName 或資料類型分支中定義的自訂結構。

  • fullyQualifiedName – 訊號的完整名稱是訊號的路徑加上訊號的名稱。使用 dot(.) 來參考子訊號。例如， Vehicle.Chassis.SteeringWheel.HandsOff.HandsOffSteeringState 是HandsOffSteeringState致動器的完整名稱。 Vehicle.Chassis.SteeringWheel.HandsOff.是此致動器的路徑。

    完整名稱最多可有 150 個字元。有效字元：a–z、A–Z、0–9、： （冒號） 和 _ （底線）。

  • （選用） Description – 訊號的描述。

    描述最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

  • （選用） unit – 訊號的科學單位，例如 km 或 Celsius。

  • （選用） min – 訊號的最小值。

  • （選用） max – 訊號的最大值。

  • （選用） assignedValue – 指派給訊號的值。

  • （選用） allowedValues – 訊號接受的值清單。

  • （選用） deprecationMessage – 正在移動或刪除的節點或分支的棄用訊息。

    The deprecationMessage 最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

  • （選用） comment – 描述以外的註解。註解可用來提供有關感應器或致動器的其他資訊，例如其原理或相關感應器或致動器的參考。

    註解最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

設定複雜的資料類型

建立視覺系統的模型時，會使用複雜的資料類型。除了分支之外，這些資料類型是由結構 （也稱為結構） 和屬性組成。結構是由多個值描述的訊號，例如影像。屬性代表結構的成員，例如原始資料類型 （例如 UINT8) 或其他結構 （例如時間戳記）。例如，Carver.Cameras.Front 代表分支、Carver.Cameras.Front.Image 代表結構，而 Vehicle.Cameras.Timestamp 代表屬性。

下列複雜資料類型範例示範 訊號和資料類型如何匯出至單一 .json 檔案。

範例 複雜資料類型
{
  "Vehicle": {
    "type": "branch"
    // Signal tree
  },
  "ComplexDataTypes": {
    "VehicleDataTypes": {
      // complex data type tree
      "children": {
        "branch": {
          "children": {
            "Struct": {
              "children": {
                "Property": {
                  "type": "property",
                  "datatype": "Data type",
                  "description": "Description",
                  //                  ...
                }
              },
              "description": "Description",
              "type": "struct"
            }
          }
          "description": "Description",
          "type": "branch"
        }
      }
    }
  }
}
注意

您可以下載示範指令碼，將 ROS 2 訊息轉換為與訊號目錄相容的 VSS .json 檔案。如需詳細資訊，請參閱視覺系統資料開發人員指南。

視覺系統資料處於預覽版本中，可能會有所變更。

若要設定自訂結構 （或結構），請指定下列資訊。

  • fullyQualifiedName – 自訂結構的完整名稱。例如，自訂結構的完整名稱可能是 ComplexDataTypes.VehicleDataTypes.SVMCamera。

    完整名稱最多可有 150 個字元。有效字元：a–z、A–Z、0–9、： （冒號） 和 _ （底線）。

  • （選用） Description – 訊號的描述。

    描述最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

  • （選用） deprecationMessage – 正在移動或刪除的節點或分支的棄用訊息。

    The deprecationMessage 最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

  • （選用） comment – 描述以外的註解。註解可用來提供有關感應器或致動器的其他資訊，例如其原理或相關感應器或致動器的參考。

    註解最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

若要設定自訂屬性，請指定下列資訊。

  • dataType – 訊號的資料類型必須是下列其中一項：INT8、UINT8、INT16、UINT16INT32、UINT32、Word、INT64、UINT64、BOOLEAN、FLOAT、DOUBLE、Word、STRING、UNIX_TIMESTAMP、INT8_Word、Word_ARRAY、UINT8_ARRAY、INT16_ARRAY、UINT16_ARRAY、INT32_Word、Word_ARRAY、UINT32_ARRAY、INT64_ARRAY、UINT64_ARRAY、BOOLEAN_ARRAY、Word_ARRAY、FLOAT_DOUBLEARRAYSTRINGARRAY、Word_Word、UNIX_ARRAY、TIMESTAMP、STRUCTSTRUCT_ARRAY 或 UNKNOWN。

  • fullyQualifiedName – 自訂屬性的完整名稱。例如，自訂屬性的完整名稱可能是 ComplexDataTypes.VehicleDataTypes.SVMCamera.FPS。

    完整名稱最多可有 150 個字元。有效字元：a–z、A–Z、0–9、： （冒號） 和 _ （底線）

  • （選用） Description – 訊號的描述。

    描述最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

  • （選用） deprecationMessage – 正在移動或刪除的節點或分支的棄用訊息。

    The deprecationMessage 最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

  • （選用） comment – 描述以外的註解。註解可用來提供有關感應器或致動器的其他資訊，例如其原理或相關感應器或致動器的參考。

    註解最多可有 2048 個字元。有效字元：a–z、A–Z、0–9、： （冒號）、_ （底線） 和 - （連字號）。

  • （選用） dataEncoding – 指出 屬性是否為二進位資料。自訂屬性的資料編碼必須是下列其中一項：BINARY 或 TYPED。

  • （選用） structFullyQualifiedName – 如果自訂屬性的資料類型為 Struct 或 StructArray，則為自訂屬性的結構 （結構） 節點的完整名稱。

    完整名稱最多可有 150 個字元。有效字元：a–z、A–Z、0–9、： （冒號） 和 _ （底線）。