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

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

設定 AWS IoT FleetWise 訊號

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

設定分支

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

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

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

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

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

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

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

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

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

設定屬性

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

  • dataType – 屬性的資料類型必須是下列其中一項：INT8、UINT8、、INT16、UINT16INT32UINT32INT64、、UINT64、BOOLEAN、FLOAT、、DOUBLESTRING、、UNIX_TIMESTAMP、INT8_ARRAY、UINT8_、_ARRAY、INT16_ARRAY、UINT16_ARRAY、INT32_、_ARRAY、_、UINT32_ARRAY、_、INT64_ARRAY、UINT64_ARRAY、BOOLEAN_ARRAYFLOATARRAY、DOUBLE_、_ARRAY、STRING_、_ARRAY、_、_、_、UNIX_、_、TIMESTAMP_ARRAY、_、_UNKNOWN、_ 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 – 正在移動或刪除的節點或分支的棄用訊息。

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

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

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

設定感應器或致動器

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

  • dataType – 訊號的資料類型必須是下列其中一項：INT8、UINT8、INT16、UINT16、INT32、UINT32INT64UINT64、BOOLEAN、FLOAT、DOUBLE、、、STRING、UNIX、_TIMESTAMP、INT8_ARRAY、UINT8_ARRAY、INT16_、_ARRAY、UINT16_ARRAY、INT32_ARRAY、_、UINT32_ARRAY、_、INT64_、_ARRAY、UINT64_、_ARRAY、BOOLEAN_ARRAY、FLOATARRAYDOUBLE_、ARRAYSTRING_ARRAY、UNIX_、_、TIMESTAMP_ARRAY、_、_UNKNOWN、_ 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 – 正在移動或刪除的節點或分支的棄用訊息。

    最多 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 則訊息轉換為與訊號目錄相容的VSSJSON檔案。如需詳細資訊，請參閱 Vision System Data Developer Guide。

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

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

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

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

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

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

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

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

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

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

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

  • dataType – 訊號的資料類型必須為下列其中一項：INT8、UINT8、INT16、UINT16、INT32、UINT32INT64UINT64、BOOLEAN、FLOAT、、DOUBLE、STRING、、、UNIX_TIMESTAMP、INT8_ARRAY、UINT8_ARRAY、INT16_、_ARRAY、UINT16_、_ARRAY、INT32_ARRAY、UINT32_ARRAY、_、INT64_ARRAY、_、UINT64_、_ARRAY、BOOLEAN_、_ARRAY、FLOAT_、ARRAYDOUBLEARRAYSTRING_ARRAY、UNIXTIMESTAMP_、_ARRAY、_STRUCT、、_、、ARRAY_、、_、STRUCT、_、、_、、_、、_、或 UNKNOWN。

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

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

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

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

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

    最多 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、： （冒號） 和 _ （底線）。