

AWS IoT FleetWise 自 2026 年 4 月 30 日起將不再向新客戶開放。現有的 AWS IoT FleetWise 客戶可以繼續使用 服務。[上的連線行動性指南 AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/)提供如何為連線行動解決方案開發和部署模組化服務的指引，這些解決方案可用於實現與 AWS IoT FleetWise 同等的功能。

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

# Configure AWS IoT FleetWise 訊號
<a name="define-signal"></a>

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

**Topics**
+ [設定分支](#configure-branch)
+ [設定屬性](#configure-attributes)
+ [設定感應器或傳動器](#configure-sensors-or-acuators)
+ [設定複雜的資料類型](#configure-complex-data-types)

## 設定分支
<a name="configure-branch"></a>

若要設定分支，請指定下列資訊。
+ `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、： （冒號）、\_ （底線） 和 - （連字號）。

## 設定屬性
<a name="configure-attributes"></a>

若要設定 屬性，請指定下列資訊。
+ `dataType` – 屬性的資料類型必須是下列其中一項：INT8, UINT8, INT16, UINT16, INT32, UINT32, INT64, UINT64、BOOLEAN、FLOAT、DOUBLE、STRRING、 UNIX\_TIMESTAMP、INT8\_ARRAY、UINT8\_ARRAY、INT16\_ARRAY、UINT16\_ARRAY、INT32\_ARRAY、UINT32\_ARRAY、INT64\_ARRAY、UINT64\_ARRAY、BOOLEAN\_ARRAY、FLOAT\_ARRAY、DUBLE\_ARRAY、STRING\_ARRAY、UNX\_TIMESTAMP\_ARRAY、UNKNOWN、fullyQualifiedName的分支中定義的資料類型。
+ `fullyQualifiedName` – 屬性的完整名稱是屬性加上屬性名稱的路徑。使用 dot(.) 來參考子訊號。例如， `Diameter` `Vehicle.Chassis.SteeringWheel.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、： （冒號）、\_ （底線） 和 - （連字號）。

## 設定感應器或傳動器
<a name="configure-sensors-or-acuators"></a>

若要設定感應器或致動器，請指定下列資訊。
+ `dataType` – 訊號的資料類型必須是下列其中一項：INT8, UINT8, INT16, UINT16, INT32, UINT32, INT64, UINT64、BOOLEAN、FLOAT、DOUBLE、STRRING、UNIX\_TIMESTAMP、INT8\_ARRAY、UTINT8\_ARRAY、INT16\_ARRAY、UTINT16\_ARRAY、INT32\_ARRAY、UINT32\_ARRAY、INT64\_ARRAY、UTINT64\_ARRAY、BOOLEAN\_ARRAY、FLOAT\_ARRAY、DUBLE\_ARRAY、STRING\_ARRAY、UNX\_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、： （冒號）、\_ （底線） 和 - （連字號）。

## 設定複雜的資料類型
<a name="configure-complex-data-types"></a>

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

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

**Example 複雜資料類型**  

```
{
  "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"
        }
      }
    }
  }
}
```

**注意**  
您可以下載[示範指令碼](https://raw.githubusercontent.com/aws/aws-iot-fleetwise-edge/main/tools/cloud/ros2-to-nodes.py)，將 ROS 2 訊息轉換為與訊號目錄相容的 VSS .json 檔案。如需詳細資訊，請參閱 [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/vision-system-data/vision-system-data-demo.ipynb](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/vision-system-data/vision-system-data-demo.ipynb)。  
視覺系統資料處於預覽版本中，可能會有所變更。

### 設定結構
<a name="configure-custom-structure"></a>

若要設定自訂結構 （或結構），請指定下列資訊。
+ `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、： （冒號）、\_ （底線） 和 - （連字號）。

### 設定 屬性
<a name="configure-custom-property"></a>

若要設定自訂屬性，請指定下列資訊。
+ `dataType` – 訊號的資料類型必須是下列其中一項：INT8, UINT8, INT16, UINT16, INT32, UINT32, INT64, UINT64、BOOLEAN、FLOAT、DOUBLE、STRRING、UNIX\_TIMESTAMP、INT8\_ARRAY、UINT8\_ARRAY、INT16\_ARRAY、UINT16\_ARRAY、INT32\_ARRAY、UINT32\_ARRAY、INT64\_ARRAY、UINT64\_ARRAY、BOOLEAN\_ARRAY、FLOAT\_ARRAY、DUBLE\_ARRAY、STRING\_ARRAY、UNX\_TIMESTAMP\_RAY、STRUCT、STRUCT\_ARNOWN。
+ `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，則為自訂屬性的結構 (struct) 節點的完整名稱。

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