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à.
# Gestisci i modelli di FleetWise veicoli AWS IoT
Utilizzi i segnali per creare modelli di veicoli che aiutano a standardizzare il formato dei veicoli. I modelli di veicoli applicano informazioni coerenti su più veicoli dello stesso tipo, in modo da poter elaborare i dati provenienti da flotte di veicoli. I veicoli creati con lo stesso modello di veicolo ereditano lo stesso gruppo di segnali. Per ulteriori informazioni, consulta [Gestisci i FleetWise veicoli AWS IoT](vehicles.md).
Ogni modello di veicolo ha un campo di stato che contiene lo stato del modello di veicolo. Lo stato può essere uno dei seguenti valori:
+ `ACTIVE`— Il modello del veicolo è attivo.
+ `DRAFT`— La configurazione del modello di veicolo viene salvata.
**Importante**
È necessario disporre di un catalogo di segnali prima di poter creare un modello di veicolo utilizzando l'operazione `CreateModelManifest` API. Per ulteriori informazioni, consulta [Crea un catalogo di FleetWise segnali AWS IoT](create-signal-catalog.md).
Se utilizzi la FleetWise console AWS IoT per creare un modello di veicolo, AWS IoT attiva FleetWise automaticamente il modello di veicolo per te.
Se utilizzi l'operazione `CreateModelManifest` API per creare un modello di veicolo, il modello di veicolo rimane invariato. `DRAFT`
Non puoi creare veicoli a partire da modelli di veicoli che si trovano nello `DRAFT` stato. Utilizza l'operazione `UpdateModelManifest` API per modificare i modelli di veicoli in base allo `ACTIVE` stato.
Non puoi modificare i modelli di veicoli che si trovano nello `ACTIVE` stato.
**Topics**
+ [Crea un modello di FleetWise veicolo AWS IoT](create-vehicle-model.md)
+ [Aggiornamento di un modello di FleetWise veicolo AWS IoT](update-vehicle-model-cli.md)
+ [Eliminare un modello di FleetWise veicolo AWS IoT](delete-vehicle-model.md)
+ [Ottieni informazioni sul modello di FleetWise veicolo AWS IoT](get-vehicle-model-information.md)
# Crea un modello di FleetWise veicolo AWS IoT
Puoi utilizzare la FleetWise console o l'API AWS IoT per creare modelli di veicoli.
**Topics**
+ [Crea un modello di veicolo (console)](#create-vehicle-model-console)
+ [Crea un modello di veicolo (AWS CLI)](#create-vehicle-model-cli)
## Crea un modello di veicolo (console)
Nella FleetWise console AWS IoT, puoi creare un modello di veicolo nei seguenti modi:
+ [Utilizza un modello fornito da AWS](#use-obd-template)
+ [Crea manualmente un modello di veicolo](#manually-create-vehicle-model)
+ [Duplica un modello di veicolo](#duplicate-vehicle-model)
### Utilizza un modello fornito da AWS
AWS FleetWise L'IoT fornisce un modello di diagnostica di bordo (OBD) II, J1979 che crea automaticamente un catalogo di segnali, un modello di veicolo e un manifesto di decodifica. Il modello aggiunge anche interfacce di rete OBD al manifesto del decoder. Per ulteriori informazioni, consulta [Gestione dei manifesti dei FleetWise decoder AWS IoT](decoder-manifests.md).
**Per creare un modello di veicolo utilizzando un modello**
1. Apri la [ FleetWise console AWS IoT](https://console.aws.amazon.com/iotfleetwise).
1. Nel pannello di navigazione, scegli **Modelli di veicoli**.
1. Nella pagina **Modelli di veicoli**, scegli **Aggiungi modello fornito**.
1. Scegli **Diagnostica di bordo (OBD**) II.
1. Immettere un nome per l'interfaccia di rete OBD creata dall' AWS IoT FleetWise .
1. Scegliere **Aggiungi**.
### Crea manualmente un modello di veicolo
Puoi aggiungere segnali dal catalogo dei segnali o importare segnali caricando uno o più file.dbc. Un file.dbc è un formato di file supportato dai database Controller Area Network (CAN bus).
**Importante**
Non è possibile creare un modello di veicolo con segnali di dati del sistema di visione utilizzando la FleetWise console AWS IoT. Utilizza invece il AWS CLI per creare un modello di veicolo.
I dati del sistema di visione sono disponibili in anteprima e sono soggetti a modifiche.
**Per creare manualmente un modello di veicolo**
1. Apri la [ FleetWise console AWS IoT](https://console.aws.amazon.com/iotfleetwise).
1. Nel pannello di navigazione, scegli **Modelli di veicoli**.
1. Nella pagina **Modelli di veicolo**, scegli **Crea modello di veicolo**, quindi procedi come segue.
**Topics**
+ [Passaggio 1: configura il modello del veicolo](#configure-vehicle-model-console)
+ [Fase 2: Aggiungere segnali](#add-signals-console)
+ [Fase 3: Importazione dei segnali](#import-signals-console)
+ [(Facoltativo) Fase 4: Aggiungere attributi](#add-attrobutes-console)
+ [Passaggio 5: revisione e creazione](#review-and-create-vehicle-model)
#### Passaggio 1: configura il modello del veicolo
In **Informazioni generali**, procedi come segue.
1. Inserisci un nome per il modello del veicolo.
1. (Opzionale) Immettere una descrizione.
1. Scegli **Next (Successivo)**.
#### Fase 2: Aggiungere segnali
**Nota**
Se è la prima volta che utilizzi l' AWS IoT FleetWise, questo passaggio non è disponibile finché non disponi di un catalogo di segnali. Quando viene creato il primo modello di veicolo, l' AWS IoT crea FleetWise automaticamente un catalogo di segnali con segnali aggiunti al primo modello di veicolo.
Se hai esperienza con l' AWS IoT FleetWise, puoi aggiungere segnali al tuo modello di veicolo selezionando i segnali dal catalogo dei segnali o caricando file.dbc per importare segnali.
È necessario disporre di almeno un segnale per creare un modello di veicolo.
**Per aggiungere segnali**
1. Scegli uno o più segnali dal catalogo dei segnali che stai aggiungendo al modello di veicolo. Puoi esaminare i segnali selezionati nel riquadro a destra.
**Nota**
Solo i segnali selezionati verranno aggiunti al modello del veicolo.
1. Scegli **Next (Successivo)**.
#### Fase 3: Importazione dei segnali
**Nota**
Se è la prima volta che utilizzi l' AWS IoT FleetWise, devi caricare almeno un file.dbc per importare i segnali.
Se hai esperienza con l' AWS IoT FleetWise, puoi aggiungere segnali al tuo modello di veicolo selezionando i segnali dal catalogo dei segnali o caricando file.dbc per importare segnali.
È necessario disporre di almeno un segnale per creare un modello di veicolo.
**Per importare segnali**
1. Scegli **Scegli file**.
1. Nella finestra di dialogo, scegliete il file.dbc che contiene i segnali. È possibile caricare più file.dbc.
1. AWS L'IoT FleetWise analizza i tuoi file.dbc per recuperare i segnali.
Nella sezione **Segnali**, specifica i seguenti metadati per ogni segnale.
+ **Nome**: il nome del segnale.
Il nome del segnale deve essere univoco. Il nome del segnale e il percorso possono contenere fino a 150 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti) e \$1 (trattino basso).
+ **Tipo di dati**: il tipo di dati del segnale deve essere uno dei seguenti: INT8,,,,,, BOOLEAN, FLOAT, DOUBLE, STRING UINT8 INT16, UNIX\$1TIMESTAMP UINT16 INT32, \$1ARRAY UINT32 INT64 UINT64, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, BOOLEAN\$1ARRAY, INT8 FLOAT\$1ARRAY, UINT8 INT16 FLOAT\$1ARRAY, UINT16 FLOAT\$1ARRAY, INT32 FLOAT\$1ARRAY, UINT32 FLOAT\$1ARRAY, INT64 FLOAT\$1ARRAY, UINT64 FLOAT\$1ARRAY, DOUBLE\$1ARRAY, UNIX\$1TIMESTAMP\$1ARRAY, FLOAT\$1ARRAY, DOUBLE\$1ARRAY, UNIX\$1TIMEST.
+ **Tipo di segnale**: il tipo di segnale, che può essere **sensore** o **attuatore**.
+ (Facoltativo) **Unità**: l'unità scientifica per il segnale, ad esempio km o Celsius.
+ (Facoltativo) **Percorso**: il percorso verso il segnale. Analogamente JSONPath, utilizzate un punto (.) per fare riferimento a un segnale secondario. Ad esempio, **Vehicle.Engine.Light**.
Il nome del segnale più il percorso possono contenere fino a 150 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti) e \$1 (trattino basso).
+ (Facoltativo) **Min: il valore minimo** del segnale.
+ (Facoltativo) **Max**: il valore massimo del segnale.
+ (Facoltativo) **Descrizione**: la descrizione del segnale.
La descrizione può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino).
1. Scegli **Next (Successivo)**.
#### (Facoltativo) Fase 4: Aggiungere attributi
È possibile aggiungere fino a 100 attributi, inclusi gli attributi esistenti nel catalogo dei segnali.
**Per aggiungere attributi**
1. In **Aggiungi attributi**, specificate i seguenti metadati per ogni attributo.
+ **Nome**: il nome dell'attributo.
Il nome del segnale deve essere univoco. Il nome e il percorso del segnale possono contenere fino a 150 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti) e \$1 (trattino basso)
+ **Tipo di dati**: il tipo di dati dell'attributo deve essere uno dei seguenti: INT8,,,,,,, BOOLEAN, FLOAT, DOUBLE, STRING UINT8 INT16, UNIX\$1TIMESTAMP UINT16 INT32 UINT32, \$1ARRAY INT64 UINT64, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, BOOLEAN\$1ARRAY, INT8 FLOAT\$1ARRAY, UINT8 FLOAT\$1ARRAY, INT16 FLOAT\$1ARRAY, UINT16 FLOAT\$1ARRAY, INT32 FLOAT\$1ARRAY, UINT32 FLOAT\$1ARRAY, INT64 FLOAT\$1ARRAY, UINT64 FLOAT\$1ARRAY, FLOAT\$1ARRAY, DOUBLE\$1ARRAY, UNIX\$1TIMESTAMP\$1ARRAY, FLOAT\$1ARRAY,
+ (Facoltativo) **Unità**: l'unità scientifica per l'attributo, ad esempio km o Celsius.
+ (Facoltativo) **Percorso**: il percorso verso il segnale. Analogamente JSONPath, utilizzate un punto (.) per fare riferimento a un segnale secondario. Ad esempio, **Vehicle.Engine.Light**.
Il nome del segnale più il percorso possono contenere fino a 150 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti) e \$1 (trattino basso)
+ (Facoltativo) **Min: il valore minimo** dell'attributo.
+ (Facoltativo) **Max**: il valore massimo dell'attributo.
+ (Facoltativo) **Descrizione**: la descrizione dell'attributo.
La descrizione può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino).
1. Scegli **Next (Successivo)**.
#### Passaggio 5: revisione e creazione
**Verifica le configurazioni per il modello di veicolo, quindi scegli Crea.**
### Duplica un modello di veicolo
AWS L'IoT FleetWise può copiare le configurazioni di un modello di veicolo esistente per crearne uno nuovo. I segnali specificati nel modello di veicolo selezionato vengono copiati nel nuovo modello di veicolo.
**Per duplicare un modello di veicolo**
1. Apri la [ FleetWise console AWS IoT](https://console.aws.amazon.com/iotfleetwise).
1. Nel pannello di navigazione, scegli **Modelli di veicoli**.
1. Scegli un modello dall'elenco dei modelli di veicolo, quindi scegli **Modello duplicato**.
Per configurare il modello del veicolo, segui il [Crea manualmente un modello di veicolo](#manually-create-vehicle-model) tutorial.
L'elaborazione della richiesta di creazione del modello di veicolo FleetWise da parte dell' AWS IoT può richiedere alcuni minuti. Dopo che il modello di veicolo è stato creato con successo, nella pagina **Modelli di veicolo**, la colonna **Stato** mostra **ATTIVO**. Quando il modello di veicolo diventa attivo, non puoi modificarlo.
## Crea un modello di veicolo (AWS CLI)
È possibile utilizzare l'operazione [CreateModelManifest](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateModelManifest.html)API per creare modelli di veicoli (manifesti dei modelli). Gli esempi seguenti utilizzano AWS CLI.
**Importante**
È necessario disporre di un catalogo di segnali prima di poter creare un modello di veicolo utilizzando l'operazione `CreateModelManifest` API. Per ulteriori informazioni su come creare un catalogo di segnali, vedere[Crea un catalogo di FleetWise segnali AWS IoT](create-signal-catalog.md).
Per creare un modello di veicolo, esegui il comando seguente.
Sostituisci *vehicle-model-configuration* con il nome del file.json che contiene la configurazione.
```
aws iotfleetwise create-model-manifest --cli-input-json file://vehicle-model-configuration.json
```
### Configurazione del modello di veicolo
+ Sostituiscila *vehicle-model-name* con il nome del modello di veicolo che stai creando.
+ Sostituisci *signal-catalog-ARN* con l'Amazon Resource Name (ARN) del catalogo dei segnali.
+ (Facoltativo) Sostituiscilo *description* con una descrizione per aiutarti a identificare il modello del veicolo.
Per ulteriori informazioni su come configurare rami, attributi, sensori e attuatori, consulta[Configurazione dei FleetWise segnali AWS IoT](define-signal.md).
```
{
"name": "vehicle-model-name",
"signalCatalogArn": "signal-catalog-ARN",
"description": "description",
"nodes": ["Vehicle.Chassis"]
}
```
Se hai [abilitato la crittografia](key-management.md) utilizzando una AWS KMS chiave gestita dal cliente, includi la seguente dichiarazione di politica in modo che il tuo ruolo possa richiamare l'operazione dell'`CreateModelManifest`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"
]
}
]
}
```
------
# Aggiornamento di un modello di FleetWise veicolo AWS IoT
È possibile utilizzare l'operazione [UpdateModelManifest](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateModelManifest.html)API per aggiornare un modello di veicolo esistente (manifesti del modello). Gli esempi seguenti utilizzano AWS CLI.
Per aggiornare un modello di veicolo esistente, esegui il comando seguente.
Sostituisci *update-vehicle-model-configuration* con il nome del file.json che contiene la configurazione.
```
aws iotfleetwise update-model-manifest --cli-input-json file://update-vehicle-model-configuration.json
```
## Aggiorna la configurazione del modello del veicolo
+ Sostituiscilo *vehicle-model-name* con il nome del modello di veicolo che stai aggiornando.
+ (Facoltativo) Per attivare il modello di veicolo, *vehicle-model-status* sostituiscilo con`ACTIVE`.
**Importante**
Dopo l'attivazione del modello di veicolo, non è possibile modificarlo.
+ (Facoltativo) Sostituiscilo *description* con una descrizione aggiornata per aiutarti a identificare il modello del veicolo.
```
{
"name": "vehicle-model-name",
"status": "vehicle-model-status",
"description": "description",
"nodesToAdd": ["Vehicle.Front.Left"],
"nodesToRemove": ["Vehicle.Chassis.SteeringWheel"],
}
```
Se hai [abilitato la crittografia](key-management.md) utilizzando una AWS KMS chiave gestita dal cliente, includi la seguente dichiarazione di politica in modo che il tuo ruolo possa richiamare il funzionamento dell'`UpdateModelManifest`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"
]
}
]
}
```
------
## Verifica l'aggiornamento del modello del veicolo
Puoi utilizzare l'operazione [ListModelManifestNodes](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListModelManifestNodes.html)API per verificare se un modello di veicolo è stato aggiornato. L'esempio seguente utilizza AWS CLI.
Per recuperare un elenco impaginato di riepiloghi di tutti i segnali (nodi) in un determinato modello di veicolo, esegui il comando seguente.
*vehicle-model-name*Sostituiscilo con il nome del modello di veicolo che stai controllando.
```
aws iotfleetwise list-model-manifest-nodes /
--name vehicle-model-name
```
Se hai [abilitato la crittografia](key-management.md) utilizzando una AWS KMS chiave gestita dal cliente, includi la seguente dichiarazione sulla politica in modo che il tuo ruolo possa richiamare il funzionamento dell'`ListModelManifestNodes`API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Eliminare un modello di FleetWise veicolo AWS IoT
Puoi utilizzare la FleetWise console o l'API AWS IoT per eliminare i modelli di veicoli.
**Importante**
I veicoli e i manifesti del decoder associati al modello di veicolo devono essere prima eliminati. Per ulteriori informazioni, consultare [Eliminare un FleetWise veicolo AWS IoT](delete-vehicle.md) e [Eliminare un manifesto del FleetWise decoder AWS IoT](delete-decoder-manifest.md).
## Eliminare un modello di veicolo (console)
Per eliminare un modello di veicolo, utilizza la FleetWise console AWS IoT.
**Per eliminare un modello di veicolo**
1. Apri la [ FleetWise console AWS IoT](https://console.aws.amazon.com/iotfleetwise).
1. Nel pannello di navigazione, scegli **Modelli di veicoli**.
1. Nella pagina **Modelli di veicoli**, scegli il modello di veicolo di destinazione.
1. Scegli **Elimina**.
1. In **Elimina**vehicle-model-name**?** , inserisci il nome del modello di veicolo da eliminare, quindi scegli **Conferma**.
## Elimina un modello di veicolo (AWS CLI)
È possibile utilizzare l'operazione [DeleteModelManifest](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteModelManifest.html)API per eliminare un modello di veicolo esistente (manifesti del modello). Gli esempi seguenti utilizzano AWS CLI.
Per eliminare un modello di veicolo, esegui il comando seguente.
Sostituiscilo *model-manifest-name* con il nome del modello di veicolo che stai eliminando.
```
aws iotfleetwise delete-model-manifest --name model-manifest-name
```
### Verifica l'eliminazione del modello di veicolo
Puoi utilizzare l'operazione [ListModelManifests](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListModelManifests.html)API per verificare se un modello di veicolo è stato eliminato. L'esempio seguente utilizza AWS CLI.
Per recuperare un elenco impaginato di riepiloghi di tutti i modelli di veicoli, esegui il comando seguente.
```
aws iotfleetwise list-model-manifests
```
Se hai [abilitato la crittografia](key-management.md) utilizzando una AWS KMS chiave gestita dal cliente, includi la seguente dichiarazione di politica in modo che il tuo ruolo possa richiamare l'operazione dell'API. `ListModelManifests`
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Ottieni informazioni sul modello di FleetWise veicolo AWS IoT
È possibile utilizzare l'operazione [GetModelManifest](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetModelManifest.html)API per recuperare informazioni su un modello di veicolo. L'esempio seguente utilizza AWS CLI.
Per recuperare informazioni su un modello di veicolo, esegui il comando seguente.
Sostituisci *vehicle-model* con il nome del modello di veicolo che desideri recuperare.
```
aws iotfleetwise get-model-manifest --name vehicle-model
```
**Nota**
Questa operazione è [consistente finale](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). In altre parole, le modifiche al modello del veicolo potrebbero non essere applicate immediatamente.
Se hai [abilitato la crittografia](key-management.md) utilizzando una AWS KMS chiave gestita dal cliente, includi la seguente dichiarazione di politica in modo che il tuo ruolo possa richiamare l'operazione dell'`GetModelManifest`API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------