Crea un FleetWise veicolo AWS IoT - AWS IoT FleetWise
Crea un veicolo (console)Crea un veicolo (AWS CLI)

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea un FleetWise veicolo AWS IoT

Importante

L'accesso a determinate FleetWise funzionalità AWS IoT è attualmente limitato. Per ulteriori informazioni, consulta AWS Disponibilità di aree e funzionalità nell' AWS IoT FleetWise.

Puoi utilizzare la FleetWise console AWS IoT o API creare un veicolo.

Importante

Prima di iniziare, controlla quanto segue:

Crea un veicolo (console)

Puoi utilizzare la FleetWise console AWS IoT per creare un veicolo.

Per creare un veicolo

  1. Apri la FleetWise console AWS IoT.

  2. Nel pannello di navigazione, scegli Veicoli.

  3. Nella pagina di riepilogo del veicolo, scegli Crea veicolo, quindi procedi nel seguente modo.

Fase 1: Definizione delle proprietà del veicolo

In questo passaggio, si assegna un nome al veicolo e lo si associa al manifesto del modello e al manifesto del decodificatore.

  1. Inserite un nome univoco per il veicolo.

    Importante

    Un veicolo corrisponde a AWS IoT qualcosa. Se esiste già un oggetto con quel nome, scegli Associa il veicolo a un oggetto IoT per aggiornare l'oggetto al veicolo. Oppure, scegli un nome diverso per il veicolo e l' AWS IoT FleetWise creerà automaticamente qualcosa di nuovo per il veicolo.

  2. Scegli un modello di veicolo (manifesto del modello) dall'elenco.

  3. Scegliete un manifesto del decodificatore dall'elenco. Il manifesto del decodificatore è associato al modello del veicolo.

  4. (Facoltativo) Per associare gli attributi del veicolo, scegliete Aggiungi attributi. Se salti questo passaggio, devi aggiungere gli attributi dopo la creazione del veicolo prima di poterlo distribuire nelle campagne.

  5. (Facoltativo) Per associare i tag al veicolo, scegli Aggiungi nuovo tag. Puoi anche aggiungere tag dopo aver creato il veicolo.

  6. Scegli Next (Successivo).

Fase 2: Configurare il certificato del veicolo

Per utilizzare il veicolo come AWS IoT oggetto, è necessario configurare un certificato del veicolo con una politica allegata. Se salti questo passaggio, devi configurare un certificato dopo la creazione del veicolo prima di poterlo distribuire nelle campagne.

  1. Scegli Genera automaticamente un nuovo certificato (consigliato).

  2. Scegli Next (Successivo).

Fase 3: Allega le politiche al certificato

Allega una policy al certificato che hai configurato nel passaggio precedente.

  1. Per Politiche, inserisci il nome di una politica esistente. Per creare una nuova politica, scegli Crea politica.

  2. Scegli Next (Successivo).

Fase 4: Revisione e creazione

Verifica le configurazioni per il veicolo, quindi scegli Crea veicolo.

Importante

Dopo aver creato il veicolo, devi scaricare il certificato e le chiavi. Utilizzerai il certificato e la chiave privata per connettere il veicolo nel FleetWise software Edge Agent for AWS IoT.

Crea un veicolo (AWS CLI)

Quando create un veicolo, dovete utilizzare un modello di veicolo associato a un manifesto di decodifica. È possibile utilizzare l'CreateVehicleAPIoperazione per creare un veicolo. Gli esempi seguenti utilizzano AWS CLI.

Per creare un veicolo, esegui il seguente comando.

Sostituisci file-name con il nome del file.json che contiene la configurazione del veicolo.

aws iotfleetwise create-vehicle --cli-input-json file://file-name.json
Esempio — configurazione del veicolo

  • (Facoltativo) Il associationBehavior valore può essere uno dei seguenti:

    • CreateIotThing— Quando il veicolo viene creato, l' AWS IoT crea FleetWise automaticamente un AWS IoT elemento con il nome dell'ID del veicolo.

    • ValidateIotThingExists— Usa un AWS IoT oggetto esistente per creare un veicolo.

      Per creare AWS IoT qualcosa, esegui il seguente comando. Sostituisci thing-name con il nome dell'oggetto che desideri creare.

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

    Se non è specificato, l' AWS IoT crea FleetWise automaticamente AWS IoT qualcosa per il tuo veicolo.

    Importante

    Assicurati che l' AWS IoT oggetto venga fornito dopo la creazione del veicolo. Per ulteriori informazioni, consulta Fornitura di FleetWise veicoli AWS IoT.

  • Sostituiscilo vehicle-name con uno dei seguenti.

    • Il nome del file AWS IoT if associationBehavior è configurato suValidateIotThingExists.

    • L'ID del veicolo su cui creare if associationBehavior è configuratoCreateIotThing.

      L'ID del veicolo può contenere da 1 a 100 caratteri. Caratteri validi: a—z, A—Z, 0—9, trattino (‐), trattino basso (_) e due punti (:).

  • Sostituiscilo model-manifest-ARN con il modello del tuo veicolo (manifesto ARN del modello).

  • Sostituire decoder-manifest-ARN con il manifesto ARN del decoder associato al modello di veicolo specificato.

  • (Facoltativo) È possibile aggiungere attributi aggiuntivi per distinguere questo veicolo dagli altri veicoli creati dallo stesso modello di veicolo. Ad esempio, se hai un'auto elettrica, puoi specificare il seguente valore per un attributo:{"fuelType": "electric"}.

    Importante

    Gli attributi devono essere definiti nel modello di veicolo associato prima di poterli aggiungere ai singoli veicoli.

{
    "associationBehavior": "associationBehavior",
    "vehicleName": "vehicle-name", 
    "modelManifestArn": "model-manifest-ARN",
    "decoderManifestArn": "decoder-manifest-ARN",           
    "attributes": {
        "key": "value"
    }
}
Esempio — associare un modello di stato al veicolo

Puoi associare modelli di stato al veicolo per consentire la raccolta di aggiornamenti sullo stato dal veicolo nel cloud utilizzando il stateTemplates campo.

In questo esempio, stateTemplateUpdateStrategy può essere uno dei seguenti:

  • periodic: consente di specificare una velocità fissa alla quale il software Edge Agent invierà gli aggiornamenti del segnale al cloud (il software Edge Agent invierà gli aggiornamenti anche se il valore del segnale non è cambiato tra un aggiornamento e l'altro).

  • onChange: il software Edge Agent invierà aggiornamenti del segnale ogni volta che il segnale cambia.

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

Dove il create-vehicle.json file contiene (ad esempio):

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

Se hai abilitato la crittografia utilizzando una AWS KMS chiave gestita dal cliente, includi la seguente dichiarazione sulla politica in modo che il tuo ruolo possa richiamare l'CreateVehicleAPIoperazione. 

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