

AWS A IoT não FleetWise estará mais aberta a novos clientes a partir de 30 de abril de 2026. Os FleetWise clientes de AWS IoT existentes podem continuar usando o serviço. O [Guia para Mobilidade Conectada AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/) fornece orientação sobre como desenvolver e implantar serviços modulares para soluções de mobilidade conectada que podem ser usadas para obter recursos equivalentes aos da AWS IoT FleetWise.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurar AWS sinais de IoT FleetWise
<a name="define-signal"></a>

Esta seção mostra como configurar ramificações, atributos, sensores e atuadores.

**Topics**
+ [Configurar ramificações](#configure-branch)
+ [Configurar atributos](#configure-attributes)
+ [Configurar sensores ou atuadores](#configure-sensors-or-acuators)
+ [Configurar tipos de dados complexos](#configure-complex-data-types)

## Configurar ramificações
<a name="configure-branch"></a>

Para configurar uma nova conexão, especifique as seguintes informações:
+ `fullyQualifiedName` — O nome totalmente qualificado da ramificação é o caminho para a ramificação além do nome da ramificação. Use um ponto (.) para se referir a uma ramificação secundária. Por exemplo, `Vehicle.Chassis.SteeringWheel` é o nome totalmente qualificado da ramificação `SteeringWheel`. `Vehicle.Chassis.` é o caminho para essa ramificação.

  O nome totalmente qualificado pode ter até 150 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, dois pontos (:) e sublinhado (\$1).
+ (Opcional) `Description` — Descrição da ramificação.

  A descrição pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).
+ (Opcional) `deprecationMessage` — A mensagem de descontinuação do nó ou da ramificação que está sendo movida ou excluída.

  A deprecationMessage pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).
+ (Opcional) `comment` — Um comentário adicional à descrição. Um comentário pode ser usado para fornecer informações adicionais sobre a ramificação, como a justificativa da ramificação ou referências a ramificações relacionadas.

  O comentário pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).

## Configurar atributos
<a name="configure-attributes"></a>

Para configurar um atributo, especifique as informações a seguir.
+ `dataType`— O tipo de dados do atributo deve ser um dos seguintes: INT8,,,,,,, BOOLEAN, FLOAT, DOUBLE UINT8 INT16, STRING UINT16 INT32 UINT32, UNIX\$1TIMESTAMP INT64 UINT64, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, INT8 \$1ARRAY, UINT8 INT16 BOOLEAN\$1ARRAY, UINT16 FLOAT\$1ARRAY, INT32 DOUBLE\$1ARRAY, UINT32 STRING\$1ARRAY, INT64 UINT64 UNIX\$1TIMESTAMP\$1ARRAY, UNKNOWN, ou uma estrutura personalizada definida na ramificação do tipo de dados. fullyQualifiedName
+ `fullyQualifiedName`— O nome totalmente qualificado do atributo é o caminho para o atributo além do nome do atributo. Use um ponto (.) para se referir ao sinal secundário. Por exemplo, `Vehicle.Chassis.SteeringWheel.Diameter` é o nome totalmente qualificado do atributo `Diameter`. `Vehicle.Chassis.SteeringWheel.` é o caminho para esse atributo.

  O nome totalmente qualificado pode ter até 150 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos) e \$1 (sublinhado).
+ (Opcional) `Description` — A descrição do atributo.

  A descrição pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).
+ (Opcional) `unit` — A unidade científica do atributo, como km ou Celsius.
+ (Opcional) `min` — O valor mínimo do atributo.
+ (Opcional) `max` — O valor máximo do atributo.
+ (Opcional) `defaultValue` — O valor padrão do atributo.
+ (Opcional) `assignedValue` — O valor atribuído ao atributo.
+ (Opcional) `allowedValues` — Uma lista de valores que o atributo aceita.
+ (Opcional) `deprecationMessage` — A mensagem de descontinuação do nó ou ramificação que está sendo movido ou excluído.

  A deprecationMessage pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).
+ (Opcional) `comment` — Um comentário adicional à descrição. Um comentário pode ser usado para fornecer informações adicionais sobre o atributo, como a justificativa para o atributo ou referências a atributos relacionados.

  O comentário pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).

## Configurar sensores ou atuadores
<a name="configure-sensors-or-acuators"></a>

Para configurar um sensor ou atuador, especifique as seguintes informações.
+ `dataType`— O tipo de dados do sinal deve ser um dos seguintes: INT8,,,,,,, BOOLEAN, FLOAT, DOUBLE UINT8 INT16, STRING UINT16 INT32, UNIX\$1TIMESTAMP UINT32 INT64 UINT64, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, INT8 \$1ARRAY, UINT8 INT16 BOOLEAN\$1ARRAY, UINT16 FLOAT\$1ARRAY, INT32 DOUBLE\$1ARRAY, UINT32 STRING\$1ARRAY, INT64 UINT64 UNIX\$1TIMESTAMP\$1ARRAY, UNKNOWN, ou uma estrutura personalizada definida na ramificação do tipo de dados. fullyQualifiedName
+ `fullyQualifiedName` — O nome totalmente qualificado do sinal é o caminho para o sinal além do nome do sinal. Use um ponto (.) para se referir ao sinal secundário. Por exemplo, `Vehicle.Chassis.SteeringWheel.HandsOff.HandsOffSteeringState` é o nome totalmente qualificado do atuador `HandsOffSteeringState`. `Vehicle.Chassis.SteeringWheel.HandsOff.` é o caminho para esse atuador.

  O nome totalmente qualificado pode ter até 150 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos) e \$1 (sublinhado).
+ (Opcional) `Description` — A descrição do sinal.

  A descrição pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).
+ (Opcional) `unit` — A unidade científica do sinal, como km ou Celsius.
+ (Opcional) `min` — O valor mínimo do sinal.
+ (Opcional) `max` — O valor máximo do sinal.
+ (Opcional) `assignedValue` — O valor atribuído ao sinal.
+ (Opcional) `allowedValues` — lista de valores que o sinal aceita.
+ (Opcional) `deprecationMessage` — A mensagem de descontinuação do nó ou ramificação que está sendo movido ou excluído.

  A deprecationMessage pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).
+ (Opcional) `comment` — Um comentário adicional à descrição. Um comentário pode ser usado para fornecer informações adicionais sobre o sensor ou atuador, como justificativa ou referências a sensores ou atuadores relacionados.

  O comentário pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).

## Configurar tipos de dados complexos
<a name="configure-complex-data-types"></a>

Tipos de dados complexos são usados na modelagem de sistemas de visão. Além das ramificações, esses tipos de dados são compostos de estruturas (também conhecidas como struct) e propriedades. Uma struct é um sinal descrito por vários valores, como uma imagem. Uma propriedade representa um membro da estrutura, como um tipo de dados primitivo (como UINT8) ou outra estrutura (como timestamp). Por exemplo, Vehicle.Cameras.Front representa uma ramificação, Vehicle.Cameras.Front.Image representa uma struct e Vehicle.Cameras.Timestamp representa uma propriedade.

O exemplo de tipo de dados complexo a seguir demonstra como sinais e tipos de dados são exportados para um único arquivo.json.

**Example tipo de dados complexos**  

```
{
  "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**  
Você pode baixar um [script de demonstração](https://raw.githubusercontent.com/aws/aws-iot-fleetwise-edge/main/tools/cloud/ros2-to-nodes.py) para converter mensagens ROS 2 em arquivos VSS .json compatíveis com o catálogo de sinais. Para ter mais informações, consulte o [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).  
O recurso de dados de sistemas de visão está na versão de teste e está sujeito a alterações.

### Configurar struct
<a name="configure-custom-structure"></a>

Para configurar uma estrutura personalizada (ou struct), especifique as informações a seguir.
+ `fullyQualifiedName`: o nome totalmente qualificado da estrutura personalizada. Por exemplo, o nome totalmente qualificado de uma estrutura personalizada pode ser `ComplexDataTypes.VehicleDataTypes.SVMCamera`.

  O nome totalmente qualificado pode ter até 150 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos) e \$1 (sublinhado).
+ (Opcional) `Description` — A descrição do sinal.

  A descrição pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).
+ (Opcional) `deprecationMessage` — A mensagem de descontinuação do nó ou ramificação que está sendo movido ou excluído.

  A deprecationMessage pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).
+ (Opcional) `comment` — Um comentário adicional à descrição. Um comentário pode ser usado para fornecer informações adicionais sobre o sensor ou atuador, como justificativa ou referências a sensores ou atuadores relacionados.

  O comentário pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).

### Configurar propriedade
<a name="configure-custom-property"></a>

Para configurar uma propriedade personalizada, especifique as informações a seguir.
+ `dataType`— O tipo de dados do sinal deve ser um dos seguintes: INT8,,,,,,, BOOLEAN, FLOAT, DOUBLE, STRING UINT8 INT16 UINT16, UNIX\$1TIMESTAMP INT32 UINT32 INT64, \$1ARRAY UINT64, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, \$1ARRAY, INT8 BOOLEAN\$1ARRAY, UINT8 INT16 FLOAT\$1ARRAY, UINT16 DOUBLE\$1ARRAY, INT32 STRING\$1ARRAY, UINT32 INT64 UNIX\$1TIMESTAMP\$1ARRAY, STRUCT UINT64 T\$1ARRAY ou UNKNOWN.
+ `fullyQualifiedName`: o nome totalmente qualificado da propriedade personalizada. Por exemplo, o nome totalmente qualificado de uma propriedade personalizada pode ser `ComplexDataTypes.VehicleDataTypes.SVMCamera.FPS`.

  O nome totalmente qualificado pode ter até 150 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos) e \$1 (sublinhado)
+ (Opcional) `Description` — A descrição do sinal.

  A descrição pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).
+ (Opcional) `deprecationMessage` — A mensagem de descontinuação do nó ou ramificação que está sendo movido ou excluído.

  A deprecationMessage pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).
+ (Opcional) `comment` — Um comentário adicional à descrição. Um comentário pode ser usado para fornecer informações adicionais sobre o sensor ou atuador, como justificativa ou referências a sensores ou atuadores relacionados.

  O comentário pode ter até 2.048 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos), \$1 (sublinhado) e - (hífen).
+ (Opcional) `dataEncoding`: indica se a propriedade é um dado binário. A codificação de dados da propriedade personalizada deve ser uma das seguintes: BINARY ou TYPED.
+ (Opcional) `structFullyQualifiedName ` — O nome totalmente qualificado do nó de estrutura (estrutura) da propriedade personalizada se o tipo de dados da propriedade personalizada for Estrutura ou. StructArray

  O nome totalmente qualificado pode ter até 150 caracteres. Os caracteres válidos são a–z, A–Z, 0–9, : (dois pontos) e \$1 (sublinhado).