View a markdown version of this page

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

AWS L'IoT non FleetWise è più aperto a nuovi clienti. FleetWise I clienti AWS IoT esistenti possono continuare a utilizzare il servizio. La Guidance for Connected Mobility on AWS fornisce indicazioni su come sviluppare e implementare servizi modulari per soluzioni di mobilità connessa che possono essere utilizzate per ottenere funzionalità equivalenti a quelle dell' AWS IoT FleetWise.

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 AWS FleetWise Veicolo IoT

Importante

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

Puoi utilizzare la FleetWise console o l'API AWS IoT per 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 come segue.

Fase 1: Definisci le proprietà del veicolo

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

  1. Inserisci 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 aggiornarlo con il veicolo. Oppure, scegli un nome diverso per il veicolo e l' AWS IoT FleetWise creerà automaticamente una nuova cosa 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, scegli 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 aggiungere tag anche dopo la creazione del veicolo.

  6. Scegli Avanti.

Fase 2: Configurare il certificato del veicolo

Per utilizzare il veicolo come AWS IoT qualcosa, è 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 Auto-generate un nuovo certificato (consigliato).

  2. Scegli Avanti.

Passaggio 3: allegare le politiche al certificato

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

  1. Per Policy, inserisci un nome di policy esistente. Per creare una nuova policy, scegli Crea policy.

  2. Scegli Avanti.

Fase 4: Revisione e creazione

Verifica le configurazioni del 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 si crea un veicolo, è necessario utilizzare un modello di veicolo associato a un manifesto del decodificatore. È possibile utilizzare l'operazione CreateVehicle API per creare un veicolo. Gli esempi seguenti utilizzano AWS CLI.

Per creare un veicolo, esegui il comando seguente.

Sostituiscilo 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 un AWS IoT oggetto, esegui il comando seguente. Sostituisci thing-name con il nome dell'oggetto che vuoi 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 sia predisposto dopo la creazione del veicolo. Per ulteriori informazioni, consulta Fornitura AWS FleetWise Veicoli IoT.

  • Sostituiscilo vehicle-name con uno dei seguenti.

    • Il nome della AWS IoT cosa su cui associationBehavior è configuratoValidateIotThingExists.

    • L'ID del veicolo su cui crearlo 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 l'ARN del modello del tuo veicolo (manifesto del modello).

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

  • (Facoltativo) Puoi aggiungere attributi aggiuntivi per distinguere questo veicolo dagli altri veicoli creati con lo 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

È possibile associare modelli di stato al veicolo per consentire la raccolta degli aggiornamenti di stato dal veicolo nel cloud utilizzando il stateTemplates campo.

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

  • periodic: consente di specificare una frequenza fissa alla quale il software Edge Agent invierà gli aggiornamenti dei segnali 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 politica in modo che il tuo ruolo possa richiamare l'operazione CreateVehicle 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"
            ]
        }
    ]
}