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

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 FleetWise véhicule 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 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, sélectionnez Véhicules.

  3. Sur la page récapitulative du véhicule, choisissez Créer un véhicule, puis effectuez les étapes suivantes.

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

Au cours de cette étape, vous nommez le véhicule et vous l'associez 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 à n'importe quelle AWS IoT chose. Si un objet portant ce nom existe déjà, 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 des attributs de véhicule, choisissez Ajouter des attributs. Si vous ignorez cette étape, vous devez ajouter des attributs après la création du véhicule 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 tags après la création du véhicule.

  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 accompagné d'une politique. Si vous ignorez cette étape, vous devez configurer un certificat une fois le véhicule créé avant de pouvoir le déployer dans des campagnes.

  1. Choisissez Générer automatiquement un nouveau certificat (recommandé).

  2. Choisissez Suivant.

Étape 3 : associer des politiques au certificat

Attachez 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 Create policy.

  2. Choisissez Suivant.

Étape 4 : vérifier et créer

Vérifiez les configurations du véhicule, puis choisissez Create vehicle.

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éation d'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 CreateVehicleAPI pour créer un véhicule. L'exemple suivant repose sur AWS CLI.

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

Remplacez file-name par le nom du fichier .json contenant 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 portant le nom de l'identifiant de votre véhicule.

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

      Pour créer un AWS IoT objet, 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 quelque chose pour votre véhicule.

    Important

    Assurez-vous que l' AWS IoT objet est approvisionné une fois le véhicule créé. Pour de plus amples informations, veuillez consulter Fournir AWS des FleetWise véhicules IoT.

  • Remplacez vehicle-name par l'un des modèles suivants.

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

    • L'ID du véhicule pour lequel il doit être créé associationBehavior est configuréCreateIotThing.

      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 avez 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 — associe un modèle d'état au véhicule

Vous pouvez associer des modèles d'état au véhicule pour permettre la collecte de mises à jour d'état à partir du véhicule dans le cloud en utilisant le stateTemplates champ.

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

  • periodic: vous permet de définir un taux fixe auquel le logiciel Edge Agent enverra les mises à jour des signaux au cloud (le logiciel Edge Agent enverra les 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 le signal 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. 

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