

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="configure-network-interfaces-decoder-signals"></a>

**重要**  
對特定 AWS IoT FleetWise 功能的存取目前受到鎖定。如需詳細資訊，請參閱[AWS AWS IoT FleetWise 中的區域和功能可用性](fleetwise-regions.md)。

每個解碼器資訊清單至少都有一個網路界面和訊號解碼器，與關聯車輛模型中指定的訊號配對。

如果解碼器資訊清單包含 CAN 網路介面，則必須包含 CAN 訊號解碼器。如果解碼器資訊清單包含 OBD 網路介面，則必須包含 OBD 訊號解碼器。

**Topics**
+ [設定網路介面](#configure-network-interfaces)
+ [設定訊號解碼器](#configure-decoder-signals)

## 設定網路介面
<a name="configure-network-interfaces"></a>

若要設定 CAN 網路介面，請指定下列資訊。
+ `name` – CAN 界面的名稱。

  介面名稱必須是唯一的，並且可以有 1-100 個字元。
+ （選用） `protocolName` – 通訊協定的名稱。

  有效值： `CAN-FD`和 `CAN`
+ （選用） `protocolVersion` – AWS IoT FleetWise 目前支援 CAN-FD 和 CAN 2.0b。

  有效值： `1.0`和 `2.0b`

若要設定 OBD 網路界面，請指定下列資訊。
+ `name` – OBD 介面的名稱。

  介面名稱必須是唯一的，並且可以有 1-100 個字元。
+ `requestMessageId` – 請求資料之訊息的 ID。
+ （選用） `dtcRequestIntervalSeconds` – 在幾秒鐘內向車輛請求診斷故障碼 (DTCs) 的頻率。例如，如果指定的值為 120，Edge Agent 軟體會每 2 分鐘收集一次存放DTCs。
+ （選用） `hasTransmissionEcu` – 車輛是否有傳輸控制模組 (TCM)。

  有效值： `true`和 `false`
+ （選用） `obdStandard` – AWS IoT FleetWise 支援的 OBD 標準。 AWS IoT FleetWise 目前支援 World Wide Harmonization On-Board Diagnostics (WWH-OBD) ISO15765-4 標準。
+ （選用） `pidRequestIntervalSeconds` – 從車輛請求 OBD II PIDs的頻率。例如，如果指定的值為 120，Edge Agent 軟體會每 2 分鐘收集一次 OBD II PIDs。
+ （選用） `useExtendedIds` – 是否在訊息中使用延伸 IDs。

  有效值： `true`和 `false`

若要設定車輛中介軟體網路界面，請指定下列資訊。
+ `name` – 車輛中介軟體界面的名稱。

  介面名稱必須是唯一的，並且可以有 1-100 個字元。
+ `protocolName` – 通訊協定的名稱。

  有效值：`ROS_2`

若要設定自訂解碼介面，請指定下列資訊。
+ `name` – 您用來在 Edge 解碼訊號的解碼器名稱。

  解碼器界面名稱可以有 1-100 個字元。

## 設定訊號解碼器
<a name="configure-decoder-signals"></a>

若要設定 CAN 訊號解碼器，請指定下列資訊。
+ `factor` – 用來解碼訊息的乘數。
+ `isBigEndian` – 訊息的位元組排序是否為大端。如果是大端值，序列中最重要的值會先存放在最低的儲存地址。
+ `isSigned` – 是否簽署訊息。如果已簽署，訊息可以同時代表正數和負數。
+ `length` – 訊息的長度，以位元為單位。
+ `messageId` – 訊息的 ID。
+ `offset` – 用來計算訊號值的位移。結合 因素，計算為 `value = raw_value * factor + offset`。
+ `startBit` – 指出訊息第一個位元的位置。
+ （選用） `name` – 訊號的名稱。
+ （選用） `signalValueType` – 訊號的值類型。整數是預設值類型。

若要設定 OBD 訊號解碼器，請指定下列資訊。
+ `byteLength` – 訊息的長度，以位元組為單位。
+ `offset` – 用來計算訊號值的位移。結合擴展，計算為 `value = raw_value * scaling + offset`。
+ `pid` – 用來向車輛請求此訊號訊息的診斷碼。
+ `pidResponseLength` – 請求訊息的長度。
+ `scaling` – 用來解碼訊息的乘數。
+ `serviceMode` – 訊息中的操作模式 （診斷服務）。
+ `startByte` – 表示訊息的開頭。
+ （選用） `bitMaskLength` – 在訊息中遮罩的位元數。
+ （選用） `bitRightShift` – 向右移動的位置數。
+ （選用） `isSigned` – 是否簽署訊息。如果已簽署，訊息可以同時代表正數和負數。預設不會簽署訊息 (`false`)。
+ （選用） `signalValueType` – 訊號的值類型。整數是預設值類型。

若要設定訊息訊號解碼器，請指定下列資訊。
+ `topicName` – 訊息訊號的主題名稱。它對應至 ROS 2 中的主題。如需結構化訊息物件的詳細資訊，請參閱 [StructuredMessage](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_StructuredMessage.html)。
+ `structuredMessage` – 訊息訊號的結構化訊息。它可以使用 primitiveMessageDefinition、structuredMessageListDefinition 或 structuredMessageDefinition 遞迴定義。

若要設定自訂解碼訊號，請指定下列資訊。
+ （選用） `id` – 您使用解碼器界面自行解碼的訊號 ID。訊號 ID 可以有 1-150 個字元。如果未指定，則 `id`預設為訊號`fullyQualifiedName`的 。