View a markdown version of this page

Créez un AWS FleetWise Véhicule IoT - AWS Internet des objets FleetWise
Création d'un véhicule (console)Créez un véhicule (AWS CLI)

AWS L'IoT n' FleetWise est plus ouvert aux nouveaux clients. Les FleetWise clients AWS IoT existants peuvent continuer à utiliser le service. Le Guide pour la mobilité connectée AWS fournit des conseils sur la manière de développer et de déployer des services modulaires pour les solutions de mobilité connectée qui peuvent être utilisés pour atteindre des capacités équivalentes à celles de AWS l'IoT FleetWise.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Créez un AWS FleetWise Véhicule IoT

Important

L'accès à certaines FleetWise fonctionnalités de AWS l'IoT est actuellement bloqué. 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 ou l'API AWS IoT pour créer un véhicule.

Important

Avant de commencer, vérifiez les points suivants :

Création d'un véhicule (console)

Vous pouvez utiliser la FleetWise console AWS IoT pour créer un véhicule.

Pour créer un véhicule

  1. Ouvrez la FleetWise console AWS IoT.

  2. Dans le volet de navigation, choisissez Véhicules.

  3. Sur la page récapitulative du véhicule, choisissez Créer un véhicule, puis procédez comme suit.

Étape 1 : définir les propriétés du véhicule

Au cours de cette étape, vous devez nommer le véhicule et l'associer au manifeste du modèle et au manifeste du décodeur.

  1. Entrez un nom unique pour le véhicule.

    Important

    Un véhicule correspond à AWS IoT tout. S'il existe déjà un objet portant ce nom, choisissez Associer le véhicule à un objet IoT pour le mettre à jour avec le véhicule. Vous pouvez également choisir un autre nom de véhicule et AWS l'IoT FleetWise créera automatiquement un nouvel élément pour le véhicule.

  2. Choisissez un modèle de véhicule (manifeste du modèle) dans la liste.

  3. Choisissez un manifeste de décodeur dans la liste. Le manifeste du décodeur est associé au modèle du véhicule.

  4. (Facultatif) Pour associer les attributs du véhicule, choisissez Ajouter des attributs. Si vous ignorez cette étape, vous devez ajouter des attributs une fois le véhicule créé avant de pouvoir le déployer dans des campagnes.

  5. (Facultatif) Pour associer des étiquettes au véhicule, choisissez Ajouter une nouvelle étiquette. Vous pouvez également ajouter des étiquettes une fois le véhicule créé.

  6. Choisissez Suivant.

Étape 2 : Configuration du certificat du véhicule

Pour utiliser votre véhicule en tant qu' AWS IoT objet, vous devez configurer un certificat de véhicule avec une politique associée. Si vous ignorez cette étape, vous devez configurer un certificat après la création du véhicule avant de pouvoir le déployer dans des campagnes.

  1. Choisissez Auto-generate un nouveau certificat (recommandé).

  2. Choisissez Suivant.

Étape 3 : Joindre des politiques au certificat

Joignez une politique au certificat que vous avez configuré à l'étape précédente.

  1. Pour Politiques, entrez un nom de stratégie existant. Pour créer une nouvelle politique, choisissez Créer une politique.

  2. Choisissez Suivant.

Étape 4 : vérifier et créer

Vérifiez les configurations du véhicule, puis choisissez Créer un véhicule.

Important

Une fois le véhicule créé, vous devez télécharger le certificat et les clés. Vous utiliserez le certificat et la clé privée pour connecter le véhicule au FleetWise logiciel Edge Agent for AWS IoT.

Créez un véhicule (AWS CLI)

Lorsque vous créez un véhicule, vous devez utiliser un modèle de véhicule associé à un manifeste de décodeur. Vous pouvez utiliser l'opération CreateVehicle API pour créer un véhicule. L'exemple suivant repose sur AWS CLI.

Pour créer un véhicule, exécutez la commande suivante.

file-nameRemplacez-le par le nom du fichier .json qui contient la configuration du véhicule.

aws iotfleetwise create-vehicle --cli-input-json file://file-name.json
Exemple— configuration du véhicule

  • (Facultatif) La associationBehavior valeur peut être l'une des suivantes :

    • CreateIotThing— Lorsque votre véhicule est créé, AWS l'IoT crée FleetWise automatiquement un AWS IoT objet avec le nom ou l'identifiant de votre véhicule.

    • ValidateIotThingExists— Utilisez un AWS IoT objet existant pour créer un véhicule.

      Pour créer AWS IoT quelque chose, exécutez la commande suivante. thing-nameRemplacez-le par le nom de l'objet que vous souhaitez créer.

      aws iot create-thing --thing-name thing-name

    Si ce n'est pas spécifié, AWS l'IoT crée FleetWise automatiquement AWS IoT tout ce que vous voulez pour votre véhicule.

    Important

    Assurez-vous que l' AWS IoT objet est approvisionné après la création du véhicule. Pour de plus amples informations, veuillez consulter Disposition AWS FleetWise Véhicules IoT.

  • Remplacer vehicle-name par l'un des éléments suivants.

    • Le nom de votre AWS IoT objet s'il associationBehavior est configuré pourValidateIotThingExists.

    • L'ID du véhicule à créer s'il associationBehavior est configuré pourCreateIotThing.

      L'identifiant du véhicule peut comporter de 1 à 100 caractères. Caractères valides : a—z, A—Z, 0—9, tiret (‐), trait de soulignement (_) et deux-points (:).

  • model-manifest-ARNRemplacez-le par l'ARN de votre modèle de véhicule (manifeste du modèle).

  • Remplacez decoder-manifest-ARN par l'ARN du manifeste du décodeur associé au modèle de véhicule spécifié.

  • (Facultatif) Vous pouvez ajouter des attributs supplémentaires pour distinguer ce véhicule des autres véhicules créés à partir du même modèle de véhicule. Par exemple, si vous possédez une voiture électrique, vous pouvez spécifier la valeur suivante pour un attribut :{"fuelType": "electric"}.

    Important

    Les attributs doivent être définis dans le modèle de véhicule associé avant de pouvoir les ajouter à des véhicules individuels.

{
    "associationBehavior": "associationBehavior",
    "vehicleName": "vehicle-name", 
    "modelManifestArn": "model-manifest-ARN",
    "decoderManifestArn": "decoder-manifest-ARN",           
    "attributes": {
        "key": "value"
    }
}
Exemple— associer un modèle d'état au véhicule

Vous pouvez associer des modèles Création d'un modèle d' FleetWise état de l' AWS IoT d'état au véhicule pour permettre la collecte des mises à jour d'état du véhicule dans le cloud à l'aide du stateTemplates champ.

Dans cet exemple, il stateTemplateUpdateStrategy peut s'agir de l'un des éléments suivants :

  • periodic: vous permet de spécifier un débit fixe auquel le logiciel Edge Agent enverra les mises à jour du signal vers le cloud (le logiciel Edge Agent enverra des mises à jour même si la valeur du signal n'a pas changé entre les mises à jour).

  • onChange: le logiciel Edge Agent envoie des mises à jour du signal chaque fois que celui-ci change.

aws iotfleetwise create-vehicle --cli-input-json file://create-vehicle.json

Où le create-vehicle.json fichier contient (par exemple) :

{
    "associationBehavior": "associationBehavior",
    "vehicleName": "vehicle-name", 
    "modelManifestArn": "model-manifest-ARN",
    "decoderManifestArn": "decoder-manifest-ARN",           
    "attributes": {
        "key": "value"
    },
    "stateTemplates": [ 
        {
            "identifier": "state-template-name",
            "stateTemplateUpdateStrategy": {
                "periodic": {
                    "stateTemplateUpdateRate": {
                        "unit": "SECOND",
                        "value": 10
                    }
                }
            }
        }
    ]
}

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'opération CreateVehicle d'API.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kms:GenerateDataKey*",
                "kms:Decrypt"
            ],
            "Resource": [
                "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
            ]
        }
    ]
}