建立 AWS IoT FleetWise Word 解碼器資訊清單

重要

存取特定 AWS IoT FleetWise Word 功能目前已封鎖。如需詳細資訊，請參閱AWSAWS IoT FleetWiseWord 中的區域和功能可用性。

您可以使用 AWS IoT FleetWise Word 主控台或 API 為您的車輛模型建立解碼器資訊清單。

主題

建立解碼器資訊清單（主控台）
建立解碼器資訊清單 (AWS CLI)

建立解碼器資訊清單（主控台）

您可以使用 AWS IoT FleetWise Word 主控台來建立與您的車輛模型相關聯的解碼器資訊清單。

重要

您無法使用 AWS IoT FleetWise Word主控台在解碼器資訊清單中設定視覺系統資料訊號。反之，請使用 AWS CLI。視覺系統資料處於預覽版本中，可能會有所變更。

建立解碼器資訊清單

開啟 AWS IoT FleetWise Word 主控台。
在導覽窗格中，選擇 車輛模型。
選擇目標車輛模型。
在車輛模型摘要頁面上，選擇建立解碼器資訊清單，然後執行下列動作。

步驟 1：設定解碼器資訊清單

在一般資訊中，執行下列動作。

輸入解碼器資訊清單的唯一名稱。
(選用) 輸入描述。
選擇 Next (下一步)。

新增網路介面

每個解碼器資訊清單必須至少有一個網路介面。您可以將多個網路介面新增至解碼器資訊清單。

新增網路介面

上傳網路介面檔案。您可以上傳 CAN 通訊協定的 .dbc 檔案，或 ROS 2 或自訂介面的 .json 檔案。
輸入網路介面的名稱。如果您上傳了自訂界面，則會提供名稱。

映射遺失訊號

如果車輛模型中有訊號在上傳的網路介面中遺失配對訊號解碼器，您可以建立預設自訂解碼器來映射遺失的訊號。這是選用的，因為您可以在下一個步驟中手動對應訊號。

建立預設自訂解碼器

選取為遺失訊號建立預設自訂解碼器。
選擇 Next (下一步)。

步驟 2：映射 CAN 介面

您可以使用 CAN 訊號解碼器對應 CAN 訊號。如果您選取為遺失訊號建立預設自訂解碼器核取方塊，則遺失解碼器訊號的任何訊號都會自動對應至預設自訂訊號解碼器。

映射 CAN 訊號

在 CAN 訊號映射中，選取訊號解碼器。
選擇 Next (下一步)。

注意

如果您新增了 ROS 2 或自訂界面，您可以在建立解碼器資訊清單之前驗證映射。

步驟 3：檢閱和建立

驗證解碼器資訊清單的組態，然後選擇建立。

建立解碼器資訊清單 (AWS CLI)

您可以使用 CreateDecoderManifest API 操作來建立解碼器資訊清單。下列為使用 AWS CLI的範例。

重要

您必須先擁有車輛模型，才能建立解碼器資訊清單。每個解碼器資訊清單都必須與車輛模型建立關聯。如需詳細資訊，請參閱建立 AWS IoT FleetWise Word 車輛模型。

若要建立解碼器資訊清單，請執行下列命令。

Replace (取代) decoder-manifest-configuration 包含組態的 .json 檔案名稱。


aws iotfleetwise create-decoder-manifest --cli-input-json file://decoder-manifest-configuration.json

Replace (取代) decoder-manifest-name 使用您正在建立的解碼器資訊清單名稱。
Replace (取代) vehicle-model-ARN 使用車輛模型的 Amazon Resource Name (ARN)。
（選用）取代 description 描述，協助您識別解碼器資訊清單。

如需如何設定分支、屬性、感應器和致動器的詳細資訊，請參閱 Configure AWS IoT FleetWise Word網路介面和解碼器訊號。


{
    "name": "decoder-manifest-name",
    "modelManifestArn": "vehicle-model-arn",
    "description": "description",
    "networkInterfaces": [
        {
            "canInterface": {
                "name": "myNetworkInterface",
                "protocolName": "CAN",
                "protocolVersion": "2.0b"
            },
            "interfaceId": "Qq1acaenByOB3sSM39SYm",
            "type": "CAN_INTERFACE"
        }
    ],
    "signalDecoders": [
        {
            "canSignal": {
                "name": "Engine_Idle_Time",
                "factor": 1,
                "isBigEndian": true,
                "isSigned": false,
                "length": 24,
                "messageId": 271343712,
                "offset": 0,
                "startBit": 16
            },
            "fullyQualifiedName": "Vehicle.EngineIdleTime",
            "interfaceId": "Qq1acaenByOB3sSM39SYm",
            "type": "CAN_SIGNAL"
        },
        {
            "canSignal": {
                "name": "Engine_Run_Time",
                "factor": 1,
                "isBigEndian": true,
                "isSigned": false,
                "length": 24,
                "messageId": 271343712,
                "offset": 0,
                "startBit": 40
            },
            "fullyQualifiedName": "Vehicle.EngineRunTime",
            "interfaceId": "Qq1acaenByOB3sSM39SYm",
            "type": "CAN_SIGNAL"
        }
    ]
}

Replace (取代) decoder-manifest-name 使用您正在建立的解碼器資訊清單名稱。
Replace (取代) vehicle-model-ARN 使用車輛模型的 Amazon Resource Name (ARN)。
（選用）取代 description 描述，協助您識別解碼器資訊清單。

結構（結構）內的屬性節點順序必須保持一致，如訊號目錄和車輛模型（模型資訊清單所定義）。如需如何設定分支、屬性、感應器和致動器的詳細資訊，請參閱 Configure AWS IoT FleetWise Word網路介面和解碼器訊號。


{
	"name": "decoder-manifest-name",
	"modelManifestArn": "vehicle-model-arn",
	"description": "description",
	"networkInterfaces": [{
		"canInterface": {
			"name": "myNetworkInterface",
			"protocolName": "CAN",
			"protocolVersion": "2.0b"
		},
		"interfaceId": "Qq1acaenByOB3sSM39SYm",
		"type": "CAN_INTERFACE"
	}, {
		"type": "VEHICLE_MIDDLEWARE",
		"interfaceId": "G1KzxkdnmV5Hn7wkV3ZL9",
		"vehicleMiddleware": {
			"name": "ROS2_test",
			"protocolName": "ROS_2"
		}
	}],
	"signalDecoders": [{
			"canSignal": {
				"name": "Engine_Idle_Time",
				"factor": 1,
				"isBigEndian": true,
				"isSigned": false,
				"length": 24,
				"messageId": 271343712,
				"offset": 0,
				"startBit": 16
			},
			"fullyQualifiedName": "Vehicle.EngineIdleTime",
			"interfaceId": "Qq1acaenByOB3sSM39SYm",
			"type": "CAN_SIGNAL"
		},
		{
			"canSignal": {
				"name": "Engine_Run_Time",
				"factor": 1,
				"isBigEndian": true,
				"isSigned": false,
				"length": 24,
				"messageId": 271343712,
				"offset": 0,
				"startBit": 40
			},
			"fullyQualifiedName": "Vehicle.EngineRunTime",
			"interfaceId": "Qq1acaenByOB3sSM39SYm",
			"type": "CAN_SIGNAL"
		},
		{
			"fullyQualifiedName": "Vehicle.CompressedImageTopic",
			"type": "MESSAGE_SIGNAL",
			"interfaceId": "G1KzxkdnmV5Hn7wkV3ZL9",
			"messageSignal": {
				"topicName": "CompressedImageTopic:sensor_msgs/msg/CompressedImage",
				"structuredMessage": {
					"structuredMessageDefinition": [{
							"fieldName": "header",
							"dataType": {
								"structuredMessageDefinition": [{
										"fieldName": "stamp",
										"dataType": {
											"structuredMessageDefinition": [{
													"fieldName": "sec",
													"dataType": {
														"primitiveMessageDefinition": {
															"ros2PrimitiveMessageDefinition": {
																"primitiveType": "INT32"
															}
														}
													}
												},
												{
													"fieldName": "nanosec",
													"dataType": {
														"primitiveMessageDefinition": {
															"ros2PrimitiveMessageDefinition": {
																"primitiveType": "UINT32"
															}
														}
													}
												}
											]
										}
									},
									{
										"fieldName": "frame_id",
										"dataType": {
											"primitiveMessageDefinition": {
												"ros2PrimitiveMessageDefinition": {
													"primitiveType": "STRING"
												}
											}
										}
									}
								]
							}
						},
						{
							"fieldName": "format",
							"dataType": {
								"primitiveMessageDefinition": {
									"ros2PrimitiveMessageDefinition": {
										"primitiveType": "STRING"
									}
								}
							}
						},
						{
							"fieldName": "data",
							"dataType": {
								"structuredMessageListDefinition": {
									"name": "listType",
									"memberType": {
										"primitiveMessageDefinition": {
											"ros2PrimitiveMessageDefinition": {
												"primitiveType": "UINT8"
											}
										}
									},
									"capacity": 0,
									"listType": "DYNAMIC_UNBOUNDED_CAPACITY"
								}
							}
						}
					]
				}
			}
		}
	]
}

Replace (取代) decoder-manifest-name 使用您正在建立的解碼器資訊清單名稱。
Replace (取代) vehicle-model-ARN 使用車輛模型的 Amazon Resource Name (ARN)。
（選用）取代 description 描述，協助您識別解碼器資訊清單。

如需如何設定分支、屬性、感應器和致動器的詳細資訊，請參閱 Configure AWS IoT FleetWise Word網路介面和解碼器訊號。


{
	"name": "decoder-manifest-name",
	"modelManifestArn": "vehicle-model-arn",
	"description": "description",
	"networkInterfaces": [
        {
		    "interfaceId": "myCustomInterfaceId",
		    "type": "CUSTOM_DECODING_INTERFACE",
            "customDecodingInterface": {
                "name": "myCustomInterface"
            }
        }
    ],
    "signalDecoders": [
        {
            "customDecodingSignal": {
                "fullyQualifiedName": "Vehicle.actuator1",
                "interfaceId": "myCustomInterfaceId",
                "type": "CUSTOM_DECODING_SIGNAL",
                "customDecodingSignal": {
                    "id": "Vehicle.actuator1"
                }
            }
        },
        {
            "customDecodingSignal": {
                "fullyQualifiedName": "Vehicle.actuator2",
                "interfaceId": "myCustomInterfaceId",
                "type": "CUSTOM_DECODING_SIGNAL",
                "customDecodingSignal": {
                    "id": "Vehicle.actuator2"
                }
            }
        }
    ]
}

注意

您可以下載示範指令碼，以建立具有視覺系統訊號的解碼器資訊清單。如需詳細資訊，請參閱視覺系統資料開發人員指南。

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

如果您使用客戶受管 AWS KMS 金鑰啟用加密，請包含下列政策陳述式，讓您的角色可以叫用 API CreateDecoderManifest 操作。


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "kms:GenerateDataKey*",
        "kms:Decrypt"
      ],
      "Resource": [
        "arn:aws:kms:KMS_KEY_REGION:KMS_KEY_ACCOUNT_ID:key/KMS_KEY_ID"
      ]
    },
  ]
}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

設定介面和訊號

更新解碼器資訊清單

建立 AWS IoT FleetWise Word 解碼器資訊清單

重要

主題

建立解碼器資訊清單 （主控台）

重要

建立解碼器資訊清單

主題

步驟 1：設定解碼器資訊清單

新增網路介面

新增網路介面

映射遺失訊號

建立預設自訂解碼器

步驟 2：映射 CAN 介面

映射 CAN 訊號

注意

步驟 3：檢閱和建立

建立解碼器資訊清單 (AWS CLI)

重要

注意

建立解碼器資訊清單（主控台）