

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à.

# Configurazione dei FleetWise segnali AWS IoT
<a name="define-signal"></a>

Questa sezione mostra come configurare rami, attributi, sensori e attuatori.

**Topics**
+ [Configurare le filiali](#configure-branch)
+ [Configura gli attributi](#configure-attributes)
+ [Configura sensori o attuatori](#configure-sensors-or-acuators)
+ [Configura tipi di dati complessi](#configure-complex-data-types)

## Configurare le filiali
<a name="configure-branch"></a>

Per configurare un ramo, specifica le seguenti informazioni.
+ `fullyQualifiedName`— Il nome completo del ramo è il percorso del ramo più il nome del ramo. Utilizzate un punto (.) per fare riferimento a un ramo secondario. Ad esempio, `Vehicle.Chassis.SteeringWheel` è il nome completo del `SteeringWheel` ramo. `Vehicle.Chassis.`è il percorso verso questo ramo.

  Il nome completo può contenere fino a 150 caratteri. Caratteri validi: a—z, A—Z, 0—9, due punti (:) e trattino basso (\$1).
+ (Facoltativo)`Description`: la descrizione del ramo.

  La descrizione può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino).
+ (Facoltativo) `deprecationMessage` — Il messaggio di deprecazione per il nodo o il ramo che viene spostato o eliminato.

  Il DeprecationMessage può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino basso).
+ (Facoltativo) `comment` — Un commento in aggiunta alla descrizione. Un commento può essere utilizzato per fornire informazioni aggiuntive sulla filiale, ad esempio la motivazione alla base della succursale o i riferimenti alle filiali correlate.

  Il commento può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino).

## Configura gli attributi
<a name="configure-attributes"></a>

Per configurare un attributo, specificare le seguenti informazioni.
+ `dataType`— Il tipo di dati dell'attributo deve essere uno dei seguenti: INT8,,,,, BOOLEAN, FLOAT UINT8, DOUBLE INT16 UINT16, STRING INT32 UINT32, UNIX\$1TIMESTAMP INT64 UINT64, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, INT8 \$1ARRAY, UINT8 INT16 BOOLEAN\$1ARRAY, UINT16 FLOAT\$1ARRAY, INT32 UINT32 FLOAT\$1ARRAY, INT64 FLOAT\$1ARRAY, UINT64 DOUBLE\$1ARRAY, STRING\$1ARRAY, UNIX\$1TIMESTAMP\$1ARRAY, UNKNOWN, oppure una struttura personalizzata definita nel ramo del tipo di dati. fullyQualifiedName
+ `fullyQualifiedName`— Il nome completo dell'attributo è il percorso dell'attributo più il nome dell'attributo. Utilizzate un punto (.) per fare riferimento a un segnale secondario. Ad esempio, `Vehicle.Chassis.SteeringWheel.Diameter` è il nome completo dell'`Diameter`attributo. `Vehicle.Chassis.SteeringWheel.`è il percorso di questo attributo.

  Il nome completo può contenere fino a 150 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti) e \$1 (trattino basso).
+ (Facoltativo) `Description` — 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).
+ (Facoltativo) `unit` — L'unità scientifica per l'attributo, ad esempio km o Celsius.
+ (Facoltativo)`min`: il valore minimo dell'attributo.
+ (Facoltativo) `max` — Il valore massimo dell'attributo.
+ (Facoltativo) `defaultValue` — Il valore predefinito dell'attributo.
+ (Facoltativo) `assignedValue` — Il valore assegnato all'attributo.
+ (Facoltativo) `allowedValues` — Un elenco di valori accettati dall'attributo.
+ (Facoltativo) `deprecationMessage` — Il messaggio di deprecazione per il nodo o il ramo che viene spostato o eliminato.

  Il DeprecationMessage può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino basso).
+ (Facoltativo) `comment` — Un commento in aggiunta alla descrizione. Un commento può essere utilizzato per fornire informazioni aggiuntive sull'attributo, ad esempio la motivazione dell'attributo o i riferimenti agli attributi correlati.

  Il commento può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino).

## Configura sensori o attuatori
<a name="configure-sensors-or-acuators"></a>

Per configurare un sensore o un attuatore, specificare le seguenti informazioni.
+ `dataType`— Il tipo di dati del segnale deve essere uno dei seguenti: INT8,,,,,, BOOLEAN, FLOAT UINT8, DOUBLE INT16 UINT16, STRING INT32 UINT32 INT64, UNIX\$1TIMESTAMP UINT64, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, INT8 \$1ARRAY, UINT8 \$1ARRAY, INT16 BOOLEAN\$1ARRAY, UINT16 INT32 FLOAT\$1ARRAY, UINT32 FLOAT\$1ARRAY, INT64 FLOAT\$1ARRAY, UINT64 DOUBLE\$1ARRAY, STRING\$1ARRAY, UNIX\$1TIMESTAMP\$1ARRAY, UNKNOWN, oppure una struttura personalizzata definita nel ramo del tipo di dati. fullyQualifiedName
+ `fullyQualifiedName`— Il nome completo del segnale è il percorso del segnale più il nome del segnale. Utilizzate un punto (.) per fare riferimento a un segnale secondario. Ad esempio, `Vehicle.Chassis.SteeringWheel.HandsOff.HandsOffSteeringState` è il nome completo dell'`HandsOffSteeringState`attuatore. `Vehicle.Chassis.SteeringWheel.HandsOff.`è il percorso verso questo attuatore.

  Il nome completo può contenere fino a 150 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti) e \$1 (trattino basso).
+ (Facoltativo) `Description` — 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).
+ (Facoltativo) `unit` — L'unità scientifica del segnale, ad esempio km o gradi Celsius.
+ (Facoltativo)`min`: il valore minimo del segnale.
+ (Facoltativo)`max`: il valore massimo del segnale.
+ (Facoltativo) `assignedValue` — Il valore assegnato al segnale.
+ (Facoltativo)`allowedValues`: elenco di valori accettati dal segnale.
+ (Facoltativo) `deprecationMessage` — Il messaggio di deprecazione per il nodo o il ramo che viene spostato o eliminato.

  Il DeprecationMessage può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino basso).
+ (Facoltativo) `comment` — Un commento in aggiunta alla descrizione. Un commento può essere utilizzato per fornire informazioni aggiuntive sul sensore o sull'attuatore, ad esempio la motivazione o i riferimenti a sensori o attuatori correlati.

  Il commento può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino).

## Configura tipi di dati complessi
<a name="configure-complex-data-types"></a>

I tipi di dati complessi vengono utilizzati per la modellazione dei sistemi di visione. Oltre ai rami, questi tipi di dati sono costituiti da strutture (note anche come struttura) e proprietà. Una struttura è un segnale descritto da più valori, come un'immagine. Una proprietà rappresenta un membro della struttura, come un tipo di dati primitivo (ad esempio UINT8) o un'altra struttura (come timestamp). Ad esempio, Vehicle.Cameras.Front rappresenta un ramo, Vehicle.Cameras.Front.Image rappresenta una struttura e Vehicle.Cameras.Timestamp rappresenta una proprietà.

Il seguente esempio di tipo di dati complesso mostra come i segnali e i tipi di dati vengono esportati in un singolo file.json.

**Example tipo di dati complesso**  

```
{
  "Vehicle": {
    "type": "branch"
    // Signal tree
  },
  "ComplexDataTypes": {
    "VehicleDataTypes": {
      // complex data type tree
      "children": {
        "branch": {
          "children": {
            "Struct": {
              "children": {
                "Property": {
                  "type": "property",
                  "datatype": "Data type",
                  "description": "Description",
                  //                  ...
                }
              },
              "description": "Description",
              "type": "struct"
            }
          }
          "description": "Description",
          "type": "branch"
        }
      }
    }
  }
}
```

**Nota**  
È possibile scaricare uno [script dimostrativo](https://raw.githubusercontent.com/aws/aws-iot-fleetwise-edge/main/tools/cloud/ros2-to-nodes.py) per convertire i messaggi ROS 2 in file VSS .json compatibili con il catalogo dei segnali. Per ulteriori informazioni, consulta la [https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/vision-system-data/vision-system-data-demo.ipynb](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/vision-system-data/vision-system-data-demo.ipynb) Developer Guide.  
I dati del sistema Vision sono in versione di anteprima e sono soggetti a modifiche.

### Configura la struttura
<a name="configure-custom-structure"></a>

Per configurare una struttura (o struttura) personalizzata, specificare le seguenti informazioni.
+ `fullyQualifiedName`— Il nome completo della struttura personalizzata. Ad esempio, il nome completo di una struttura personalizzata potrebbe essere`ComplexDataTypes.VehicleDataTypes.SVMCamera`.

  Il nome completo può contenere fino a 150 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti) e \$1 (trattino basso).
+ (Facoltativo) `Description` — 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).
+ (Facoltativo) `deprecationMessage` — Il messaggio di deprecazione per il nodo o il ramo che viene spostato o eliminato.

  Il DeprecationMessage può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino basso).
+ (Facoltativo) `comment` — Un commento in aggiunta alla descrizione. Un commento può essere utilizzato per fornire informazioni aggiuntive sul sensore o sull'attuatore, ad esempio la motivazione o i riferimenti a sensori o attuatori correlati.

  Il commento può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino).

### Configura la proprietà
<a name="configure-custom-property"></a>

Per configurare una proprietà personalizzata, specificare le seguenti informazioni.
+ `dataType`— Il tipo di dati del segnale deve essere uno dei seguenti: INT8,,,,,, BOOLEAN, FLOAT, DOUBLE, STRING UINT8, UNIX\$1TIMESTAMP INT16 UINT16 INT32, \$1ARRAY UINT32 INT64, \$1ARRAY UINT64, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, BOOLEAN\$1ARRAY, INT8 FLOAT\$1ARRAY, UINT8 FLOAT\$1ARRAY, INT16 FLOAT\$1ARRAY, UINT16 FLOAT\$1ARRAY, INT32 DOUBLE\$1ARRAY, UINT32 UNIX\$1TIMESTAMP\$1ARRAY, INT64 FLOAT\$1ARRAY, UINT64 DOUBLE\$1ARRAY, UNIX\$1TIMESTAMP\$1ARRAY, STRUCT, STRUCT\$1ARRAY ARRAY o UNKNOWN.
+ `fullyQualifiedName`— Il nome completo della proprietà personalizzata. Ad esempio, il nome completo di una proprietà personalizzata potrebbe essere`ComplexDataTypes.VehicleDataTypes.SVMCamera.FPS`.

  Il nome completo può contenere fino a 150 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti) e \$1 (trattino basso)
+ (Facoltativo)`Description`: 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).
+ (Facoltativo) `deprecationMessage` — Il messaggio di deprecazione per il nodo o il ramo che viene spostato o eliminato.

  Il DeprecationMessage può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino basso).
+ (Facoltativo) `comment` — Un commento in aggiunta alla descrizione. Un commento può essere utilizzato per fornire informazioni aggiuntive sul sensore o sull'attuatore, ad esempio la motivazione o i riferimenti a sensori o attuatori correlati.

  Il commento può contenere fino a 2048 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti), \$1 (trattino basso) e - (trattino).
+ (Facoltativo) `dataEncoding` — Indica se la proprietà è costituita da dati binari. La codifica dei dati della proprietà personalizzata deve essere una delle seguenti: BINARY o TYPED.
+ (Facoltativo) `structFullyQualifiedName ` — Il nome completo del nodo della struttura (struct) per la proprietà personalizzata se il tipo di dati della proprietà personalizzata è Struct o. StructArray

  Il nome completo può contenere fino a 150 caratteri. Caratteri validi: a—z, A—Z, 0—9,: (due punti) e \$1 (trattino basso).