Création d'un manifeste de décodeur (console)Création d'un manifeste de décodeur ()AWS CLI

Création d'un manifeste de FleetWise décodeur AWS IoT

Important

L'accès à certaines FleetWise fonctionnalités de AWS l'IoT est actuellement restreint. Pour de plus amples informations, veuillez consulter AWS Disponibilité des régions et des fonctionnalités dans AWS l'IoT FleetWise.

Vous pouvez utiliser la FleetWise console AWS IoT ou API créer un manifeste de décodeur pour votre modèle de véhicule.

Rubriques

Création d'un manifeste de décodeur (console)
Création d'un manifeste de décodeur ()AWS CLI

Création d'un manifeste de décodeur (console)

Vous pouvez utiliser la FleetWise console AWS IoT pour créer un manifeste de décodeur associé à votre modèle de véhicule.

Important

Vous ne pouvez pas configurer les signaux de données du système de vision dans les manifestes du décodeur à l'aide de la FleetWise console AWS IoT. Utilisez plutôt le AWS CLI. Les données du système de vision sont en version préliminaire et sont susceptibles d'être modifiées.

Pour créer un manifeste de décodeur

Ouvrez la FleetWise console AWS IoT.
Dans le volet de navigation, sélectionnez Modèles de véhicules.
Choisissez le modèle de véhicule cible.
Sur la page récapitulative du modèle de véhicule, choisissez Create decoder manifest, puis procédez comme suit.

Rubriques

Étape 1 : Configuration du manifeste du décodeur
Étape 2 : CAN interface cartographique
Étape 3 : Examen et création

Étape 1 : Configuration du manifeste du décodeur

Dans Informations générales, procédez comme suit.

Entrez un nom unique pour le manifeste du décodeur.
(Facultatif) Entrez une description.
Choisissez Suivant.

Ajouter des interfaces réseau

Chaque manifeste du décodeur doit comporter au moins une interface réseau. Vous pouvez ajouter plusieurs interfaces réseau à un manifeste de décodeur.

Pour ajouter une interface réseau

Téléchargez un fichier d'interface réseau. Vous pouvez télécharger un fichier .dbc pour les CAN protocoles, ou un fichier .json pour ROS 2 interfaces ou des interfaces personnalisées.
Entrez le nom de votre interface réseau. Si vous avez chargé une interface personnalisée, le nom est déjà fourni.

Cartographier les signaux manquants

Si certains signaux du modèle de véhicule ne comportent pas de décodeurs de signaux couplés dans les interfaces réseau téléchargées, vous pouvez créer un décodeur personnalisé par défaut qui cartographiera les signaux manquants. Ceci est facultatif car vous pouvez mapper manuellement les signaux à l'étape suivante.

Pour créer un décodeur personnalisé par défaut

Sélectionnez Créer un décodeur personnalisé par défaut pour les signaux manquants.
Choisissez Suivant.

Étape 2 : CAN interface cartographique

Vous pouvez mapper les CAN signaux à l'aide de décodeurs de CAN signaux. Si vous avez coché la case Créer un décodeur personnalisé par défaut pour les signaux manquants, tous les signaux auxquels il manque un signal de décodeur sont automatiquement mappés aux décodeurs de signaux personnalisés par défaut.

Pour cartographier CAN les signaux

Dans le mappage CAN du signal, sélectionnez un décodeur de signal.
Choisissez Suivant.

Note

Si vous avez ajouté une interface ROS 2 ou une interface personnalisée, vous pouvez vérifier les mappages avant de créer le manifeste du décodeur.

Étape 3 : Examen et création

Vérifiez les configurations du manifeste du décodeur, puis choisissez Create.

Création d'un manifeste de décodeur ()AWS CLI

Vous pouvez utiliser cette CreateDecoderManifestAPIopération pour créer des manifestes de décodeur. L'exemple suivant repose sur AWS CLI.

Important

Vous devez disposer d'un modèle de véhicule avant de pouvoir créer un manifeste de décodeur. Chaque manifeste du décodeur doit être associé à un modèle de véhicule. Pour de plus amples informations, veuillez consulter Création d'un modèle de FleetWise véhicule AWS IoT.

Pour créer un manifeste de décodeur, exécutez la commande suivante.

Remplacez decoder-manifest-configuration avec le nom du fichier .json qui contient la configuration.


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

Remplacez decoder-manifest-name avec le nom du manifeste du décodeur que vous créez.
Remplacez vehicle-model-ARN avec le Amazon Resource Name (ARN) du modèle de véhicule.
(Facultatif) Remplacer description avec une description pour vous aider à identifier le manifeste du décodeur.

Pour plus d'informations sur la configuration des branches, des attributs, des capteurs et des actionneurs, consultezConfiguration AWS des interfaces FleetWise réseau IoT et des signaux du décodeur.


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

Remplacez decoder-manifest-name avec le nom du manifeste du décodeur que vous créez.
Remplacez vehicle-model-ARN avec le Amazon Resource Name (ARN) du modèle de véhicule.
(Facultatif) Remplacer description avec une description pour vous aider à identifier le manifeste du décodeur.

L'ordre des nœuds de propriétés au sein d'une structure (structure) doit rester cohérent tel que défini dans le catalogue de signaux et le modèle de véhicule (manifeste du modèle). Pour plus d'informations sur la configuration des branches, des attributs, des capteurs et des actionneurs, consultezConfiguration AWS des interfaces FleetWise réseau IoT et des signaux du décodeur.


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

Remplacez decoder-manifest-name avec le nom du manifeste du décodeur que vous créez.
Remplacez vehicle-model-ARN avec le Amazon Resource Name (ARN) du modèle de véhicule.
(Facultatif) Remplacer description avec une description pour vous aider à identifier le manifeste du décodeur.


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

Note

Vous pouvez télécharger un script de démonstration pour créer un manifeste de décodeur avec les signaux du système de vision. Pour plus d'informations, consultez le Guide du développeur de données Vision System.

Les données du système de vision sont en version préliminaire et sont susceptibles d'être modifiées.

Si vous avez activé le chiffrement à l'aide d'une AWS KMS clé gérée par le client, incluez la déclaration de politique suivante afin que votre rôle puisse invoquer l'CreateDecoderManifestAPIopération.


{
  "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"
      ]
    },
  ]
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Configuration des interfaces et des signaux

Mettre à jour le manifeste d'un décodeur