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á. # Gerencie AWS catálogos de sinais de IoT FleetWise **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). Um catálogo de sinais é uma coleção de sinais padronizados que podem ser reutilizados para criar modelos de veículos. AWS A IoT é FleetWise compatível com a [Especificação de Sinais de Veículos (VSS)](https://covesa.github.io/vehicle_signal_specification/introduction/overview/) que você pode seguir para definir sinais. Um sinal pode ser de qualquer um dos seguintes tipos. **Atributo** Os atributos representam informações estáticas que geralmente não mudam, como fabricante e data de fabricação. **Ramificação** As ramificações representam sinais em uma estrutura aninhada. As ramificações demonstram hierarquias de sinais. Por exemplo, a ramificação `Vehicle` tem uma ramificação secundária, `Powertrain`. A ramificação `Powertrain` tem uma ramificação secundária, `combustionEngine`. Para localizar a ramificação `combustionEngine`, use a expressão `Vehicle.Powertrain.combustionEngine`. **Sensor** Os dados do sensor informam o estado atual do veículo e mudam ao longo do tempo, à medida que o estado do veículo muda, como níveis de fluidos, temperaturas, vibrações ou tensão. **Actuator** Os dados do atuador relatam o estado de um dispositivo do veículo, como motores, ar quente e fechaduras de portas. A alteração do estado de um dispositivo do veículo pode atualizar os dados do atuador. Por exemplo, você pode definir um atuador para representar o ar quente. O atuador recebe novos dados quando você liga ou desliga o ar quente. **Estrutura personalizada** Uma estrutura personalizada (também conhecida como struct) representa uma estrutura de dados complexa ou de ordem superior. Ela facilita o agrupamento ou a vinculação lógica de dados originários da mesma fonte. Uma struct é usada quando os dados são lidos ou gravados em uma operação atômica, como para representar um tipo de dados complexo ou uma forma de ordem superior. Um sinal do tipo struct é definido no catálogo de sinais usando uma referência a um tipo de dados de struct em vez de um tipo de dados primitivo. As structs podem ser usadas para todos os tipos de sinais, incluindo sensores, atributos, atuadores e tipos de dados de sistemas de visão. Se um sinal do tipo estrutura for enviado ou recebido, a AWS FleetWise IoT espera que todos os itens incluídos tenham valores válidos, portanto, todos os itens são obrigatórios. Por exemplo, caso uma struct contenha os itens Vehicle.Camera.Image.height, Vehicle.Camera.Image.width e Vehicle.Camera.Image.data, espera-se que o sinal enviado contenha valores para todos esses itens. O recurso de dados de sistemas de visão está na versão de teste e está sujeito a alterações. **Propriedade personalizada** Uma propriedade personalizada representa um membro da estrutura de dados complexa. O tipo de dados da propriedade pode ser primitivo ou outra struct. Ao representar uma forma de ordem superior usando uma struct e uma propriedade personalizada, a forma de ordem superior pretendida é sempre definida e visualizada como uma estrutura em árvore. A propriedade personalizada é usada para definir todos os nós da folha, enquanto a struct é usada para definir todos os nós que não são da folha. **nota** Se você usa o FleetWise console de AWS IoT para criar o primeiro modelo de veículo, não precisa criar manualmente um catálogo de sinais. Quando você cria seu primeiro modelo de veículo, a AWS IoT cria FleetWise automaticamente um catálogo de sinais para você. Para obter mais informações, consulte [Crie um modelo de AWS veículo de IoT FleetWise](create-vehicle-model.md). Se você usar o FleetWise console de AWS IoT para criar um modelo de veículo, poderá carregar arquivos.dbc para importar sinais. .dbc é um formato de arquivo suportado pelos bancos de dados da Controller Area Network (barramento CAN). Após a criação do modelo do veículo, novos sinais são adicionados automaticamente ao catálogo de sinais. Para obter mais informações, consulte [Crie um modelo de AWS veículo de IoT FleetWise](create-vehicle-model.md). AWS FleetWise Atualmente, a IoT oferece suporte a um catálogo de sinais para Conta da AWS cada região. AWS A IoT FleetWise fornece as seguintes operações de API que você pode usar para criar e gerenciar catálogos de sinais. + [CreateSignalCatalog](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateSignalCatalog.html)— Cria um novo catálogo de sinais. + [ImportSignalCatalog](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ImportSignalCatalog.html)— Importa sinais para criar um catálogo de sinais fazendo o upload de um arquivo.json. Os sinais devem ser definidos seguindo VSS e salvos no formato JSON. + [UpdateSignalCatalog](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateSignalCatalog.html)— Atualiza um catálogo de sinais existente atualizando, removendo ou adicionando sinais. + [DeleteSignalCatalog](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteSignalCatalog.html)— Exclui um catálogo de sinais existente. + [ListSignalCatalogs](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListSignalCatalogs.html)— Recupera uma lista paginada de resumos de todos os catálogos de sinais. + [ListSignalCatalogNodes](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListSignalCatalogNodes.html)— Recupera uma lista paginada de resumos de todos os sinais (nós) em um determinado catálogo de sinais. + [GetSignalCatalog](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetSignalCatalog.html)— Recupera informações sobre um catálogo de sinais. **Topics** + [Configurar AWS sinais de IoT FleetWise](define-signal.md) + [Crie um catálogo de AWS sinais de IoT FleetWise](create-signal-catalog.md) + [Importar um catálogo AWS de sinais de IoT FleetWise](import-signal.md) + [Atualizar um catálogo AWS de sinais de IoT FleetWise](update-signal-catalog.md) + [Excluir um catálogo AWS de sinais de IoT FleetWise](delete-signal-catalog.md) + [Obtenha informações AWS do catálogo de FleetWise sinais de IoT](get-signal-catalog-information.md) # Configurar AWS sinais de IoT FleetWise 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 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 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 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 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 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 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). # Crie um catálogo de AWS sinais de IoT FleetWise Você pode usar a operação [CreateSignalCatalog](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateSignalCatalog.html)da API para criar um catálogo de sinais. O exemplo a seguir usa AWS CLI. Para criar um catálogo de sinais, execute o comando a seguir. *signal-catalog-configuration*Substitua pelo nome do arquivo.json que contém a configuração. ``` aws iotfleetwise create-signal-catalog --cli-input-json file://signal-catalog-configuration.json ``` ## Configuração do catálogo de sinais + *signal-catalog-name*Substitua pelo nome do catálogo de sinais que você está criando. + (Opcional) *description* Substitua por uma descrição para ajudá-lo a identificar o catálogo de sinais. Para obter mais informações sobre como configurar ramificações, atributos, sensores e atuadores, consulte [Configurar AWS sinais de IoT FleetWise](define-signal.md). ``` { "name": "signal-catalog-name", "description": "description", "nodes": [ { "branch": { "fullyQualifiedName": "Types" } }, { "struct": { "fullyQualifiedName": "Types.sensor_msgs_msg_CompressedImage" } }, { "struct": { "fullyQualifiedName": "Types.std_msgs_Header" } }, { "struct": { "fullyQualifiedName": "Types.builtin_interfaces_Time" } }, { "property": { "fullyQualifiedName": "Types.builtin_interfaces_Time.sec", "dataType": "INT32", "dataEncoding": "TYPED" } }, { "property": { "fullyQualifiedName": "Types.builtin_interfaces_Time.nanosec", "dataType": "UINT32", "dataEncoding": "TYPED" } }, { "property": { "fullyQualifiedName": "Types.std_msgs_Header.stamp", "dataType": "STRUCT", "structFullyQualifiedName": "Types.builtin_interfaces_Time" } }, { "property": { "fullyQualifiedName": "Types.std_msgs_Header.frame_id", "dataType": "STRING", "dataEncoding": "TYPED" } }, { "property": { "fullyQualifiedName": "Types.sensor_msgs_msg_CompressedImage.header", "dataType": "STRUCT", "structFullyQualifiedName": "Types.std_msgs_Header" } }, { "property": { "fullyQualifiedName": "Types.sensor_msgs_msg_CompressedImage.format", "dataType": "STRING", "dataEncoding": "TYPED" } }, { "property": { "fullyQualifiedName": "Types.sensor_msgs_msg_CompressedImage.data", "dataType": "UINT8_ARRAY", "dataEncoding": "BINARY" } }, { "branch": { "fullyQualifiedName": "Vehicle", "description": "Vehicle" } }, { "branch": { "fullyQualifiedName": "Vehicle.Cameras" } }, { "branch": { "fullyQualifiedName": "Vehicle.Cameras.Front" } }, { "sensor": { "fullyQualifiedName": "Vehicle.Cameras.Front.Image", "dataType": "STRUCT", "structFullyQualifiedName": "Types.sensor_msgs_msg_CompressedImage" } }, { "struct": { "fullyQualifiedName": "Types.std_msgs_msg_Float64" } }, { "property": { "fullyQualifiedName": "Types.std_msgs_msg_Float64.data", "dataType": "DOUBLE", "dataEncoding": "TYPED" } }, { "sensor": { "fullyQualifiedName": "Vehicle.Velocity", "dataType": "STRUCT", "structFullyQualifiedName": "Types.std_msgs_msg_Float64" } }, { "struct": { "fullyQualifiedName": "Types.sensor_msgs_msg_RegionOfInterest" } }, { "property": { "fullyQualifiedName": "Types.sensor_msgs_msg_RegionOfInterest.x_offset", "dataType": "UINT32", "dataEncoding": "TYPED" } }, { "property": { "fullyQualifiedName": "Types.sensor_msgs_msg_RegionOfInterest.y_offset", "dataType": "UINT32", "dataEncoding": "TYPED" } }, { "property": { "fullyQualifiedName": "Types.sensor_msgs_msg_RegionOfInterest.height", "dataType": "UINT32", "dataEncoding": "TYPED" } }, { "property": { "fullyQualifiedName": "Types.sensor_msgs_msg_RegionOfInterest.width", "dataType": "UINT32", "dataEncoding": "TYPED" } }, { "property": { "fullyQualifiedName": "Types.sensor_msgs_msg_RegionOfInterest.do_rectify", "dataType": "BOOLEAN", "dataEncoding": "TYPED" } }, { "branch": { "fullyQualifiedName": "Vehicle.Perception" } }, { "sensor": { "fullyQualifiedName": "Vehicle.Perception.Obstacle", "dataType": "STRUCT", "structFullyQualifiedName": "Types.sensor_msgs_msg_RegionOfInterest" } } ] } ``` **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. Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `CreateSignalCatalog` 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" ] } ] } ``` ------ # Importar um catálogo AWS de sinais de IoT FleetWise Você pode usar o FleetWise console de AWS IoT ou a API para importar um catálogo de sinais. **Topics** + [Importar um catálogo de sinais (console)](#import-signal-catalog-console) + [Importar um catálogo de sinais (AWS CLI)](#import-signal-catalog) ## Importar um catálogo de sinais (console) Você pode usar o FleetWise console de AWS IoT para importar um catálogo de sinais. **Importante** Você pode ter no máximo um catálogo de sinais. Se você já tem um catálogo de sinais, não verá a opção de importar um catálogo de sinais no console. **Para importar um catálogo de sinais** 1. Abra o console [AWS de IoT. FleetWise](https://console.aws.amazon.com/iotfleetwise/) 1. No painel de navegação, selecione **Catálogo de sinais**. 1. Na página de resumo do catálogo de sinais, selecione **Importar catálogo de sinais**. 1. Importe o arquivo que contém os sinais. + Para fazer upload de um arquivo de um bucket S3: 1. Escolha **Import from S3** (Importar do S3). 1. Selecione **Navegar no S3**. 1. Em **Buckets**, insira o nome do bucket ou objeto, selecione-o na lista e escolha o arquivo na lista. Selecione o botão **Escolher arquivo**. Ou, para **URI do S3**, insira um URI do Serviço de Armazenamento Amazon Simple. Para obter mais informações, consulte [Métodos de acesso a um bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html) no *Guia do usuário do Amazon S3*. + Para fazer upload de um arquivo do seu computador: 1. Selecione **Importar arquivo**. 1. Faça upload de um arquivo .json em um formato [Vehicle Signal Specification (VSS)](https://www.w3.org/auto/wg/wiki/Vehicle_Signal_Specification_(VSS)/Vehicle_Data_Spec). 1. Verifique o catálogo de sinais e selecione **Importar arquivo**. ## Importar um catálogo de sinais (AWS CLI) Você pode usar a operação da [ImportSignalCatalog](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ImportSignalCatalog.html)API para fazer upload de um arquivo JSON que ajuda a criar um catálogo de sinais. Você deve seguir a [Vehicle Signal Specification (VSS)](https://www.w3.org/auto/wg/wiki/Vehicle_Signal_Specification_(VSS)/Vehicle_Data_Spec) para salvar os sinais no arquivo JSON. O exemplo a seguir usa AWS CLI. Para importar um catálogo de sinais, execute o comando a seguir. + *signal-catalog-name*Substitua pelo nome do catálogo de sinais que você está criando. + (Opcional) Substitua a descrição por uma *description* para ajudá-lo a identificar o catálogo de sinais. + *signal-catalog-configuration-vss*Substitua pelo nome do arquivo de string JSON que contém sinais definidos no VSS. Para obter mais informações sobre como configurar ramificações, atributos, sensores e atuadores, consulte [Configurar AWS sinais de IoT FleetWise](define-signal.md). ``` aws iotfleetwise import-signal-catalog \ --name signal-catalog-name \ --description description \ --vss file://signal-catalog-configuration-vss.json ``` ### Configuração do catálogo de sinais (VSS) O JSON deve ser codificado em string e passado pelo campo `vssJson`. Veja um exemplo de sinais definidos na VSS. ``` { "Vehicle": { "type": "branch", "children": { "Chassis": { "type": "branch", "description": "All data concerning steering, suspension, wheels, and brakes.", "children": { "SteeringWheel": { "type": "branch", "description": "Steering wheel signals", "children": { "Diameter": { "type": "attribute", "description": "The diameter of the steering wheel", "datatype": "float", "unit": "cm", "min": 1, "max": 50 }, "HandsOff": { "type": "branch", "children": { "HandsOffSteeringState": { "type": "actuator", "description": "HndsOffStrWhlDtSt. Hands Off Steering State", "datatype": "boolean" }, "HandsOffSteeringMode": { "type": "actuator", "description": "HndsOffStrWhlDtMd. Hands Off Steering Mode", "datatype": "int8", "min": 0, "max": 2 } } } } }, "Accelerator": { "type": "branch", "description": "", "children": { "AcceleratorPedalPosition": { "type": "sensor", "description": "Throttle__Position. Accelerator pedal position as percent. 0 = Not depressed. 100 = Fully depressed.", "datatype": "uint8", "unit": "%", "min": 0, "max": 100.000035 } } } } }, "Powertrain": { "type": "branch", "description": "Powertrain data for battery management, etc.", "children": { "Transmission": { "type": "branch", "description": "Transmission-specific data, stopping at the drive shafts.", "children": { "VehicleOdometer": { "type": "sensor", "description": "Vehicle_Odometer", "datatype": "float", "unit": "km", "min": 0, "max": 67108863.984375 } } }, "CombustionEngine": { "type": "branch", "description": "Engine-specific data, stopping at the bell housing.", "children": { "Engine": { "type": "branch", "description": "Engine description", "children": { "timing": { "type": "branch", "description": "timing description", "children": { "run_time": { "type": "sensor", "description": "Engine run time", "datatype": "int16", "unit": "ms", "min": 0, "max": 10000 }, "idle_time": { "type": "sensor", "description": "Engine idle time", "datatype": "int16", "min": 0, "unit": "ms", "max": 10000 } } } } } } } } }, "Axle": { "type": "branch", "description": "Axle signals", "children": { "TireRRPrs": { "type": "sensor", "description": "TireRRPrs. Right rear Tire pressure in kilo-Pascal", "datatype": "float", "unit": "kPaG", "min": 0, "max": 1020 } } } } }, "Cameras": { "type": "branch", "description": "Branch to aggregate all cameras in the vehicle", "children": { "FrontViewCamera": { "type": "sensor", "datatype": "VehicleDataTypes.SVMCamera", "description": "Front view camera" }, "RearViewCamera": { "type": "sensor", "datatype": "VehicleDataTypes.SVMCamera", "description": "Rear view camera" }, "LeftSideViewCamera": { "type": "sensor", "datatype": "VehicleDataTypes.SVMCamera", "description": "Left side view camera" }, "RightSideViewCamera": { "type": "sensor", "datatype": "VehicleDataTypes.SVMCamera", "description": "Right side view camera" } } }, "ComplexDataTypes": { "VehicleDataTypes": { "type": "branch", "description": "Branch to aggregate all camera related higher order data types", "children": { "SVMCamera": { "type": "struct", "description": "This data type represents Surround View Monitor (SVM) camera system in a vehicle", "comment": "Test comment", "deprecation": "Test deprecation message", "children": { "Make": { "type": "property", "description": "Make of the SVM camera", "datatype": "string", "comment": "Test comment", "deprecation": "Test deprecation message" }, "Description": { "type": "property", "description": "Description of the SVM camera", "datatype": "string", "comment": "Test comment", "deprecation": "Test deprecation message" }, "FPS": { "type": "property", "description": "FPS of the SVM camera", "datatype": "double", "comment": "Test comment", "deprecation": "Test deprecation message" }, "Orientation": { "type": "property", "description": "Orientation of the SVM camera", "datatype": "VehicleDataTypes.Orientation", "comment": "Test comment", "deprecation": "Test deprecation message" }, "Range": { "type": "property", "description": "Range of the SVM camera", "datatype": "VehicleDataTypes.Range", "comment": "Test comment", "deprecation": "Test deprecation message" }, "RawData": { "type": "property", "description": "Represents binary data of the SVM camera", "datatype": "uint8[]", "dataencoding": "binary", "comment": "Test comment", "deprecation": "Test deprecation message" }, "CapturedFrames": { "type": "property", "description": "Represents selected frames captured by the SVM camera", "datatype": "VehicleDataTypes.Frame[]", "dataencoding": "typed", "comment": "Test comment", "deprecation": "Test deprecation message" } } }, "Range": { "type": "struct", "description": "Range of a camera in centimeters", "comment": "Test comment", "deprecation": "Test deprecation message", "children": { "Min": { "type": "property", "description": "Minimum range of a camera in centimeters", "datatype": "uint32", "comment": "Test comment", "deprecation": "Test deprecation message" }, "Max": { "type": "property", "description": "Maximum range of a camera in centimeters", "datatype": "uint32", "comment": "Test comment", "deprecation": "Test deprecation message" } } }, "Orientation": { "type": "struct", "description": "Orientation of a camera", "comment": "Test comment", "deprecation": "Test deprecation message", "children": { "Front": { "type": "property", "description": "Indicates whether the camera is oriented to the front of the vehicle", "datatype": "boolean", "comment": "Test comment", "deprecation": "Test deprecation message" }, "Rear": { "type": "property", "description": "Indicates whether the camera is oriented to the rear of the vehicle", "datatype": "boolean", "comment": "Test comment", "deprecation": "Test deprecation message" }, "Side": { "type": "property", "description": "Indicates whether the camera is oriented to the side of the vehicle", "datatype": "boolean", "comment": "Test comment", "deprecation": "Test deprecation message" } } }, "Frame": { "type": "struct", "description": "Represents a camera frame", "comment": "Test comment", "deprecation": "Test deprecation message", "children": { "Data": { "type": "property", "datatype": "string", "dataencoding": "binary", "comment": "Test comment", "deprecation": "Test deprecation message" } } } } } } } ``` O exemplo a seguir mostra os mesmos sinais definidos na VSS em uma string JSON. ``` { "vssJson": "{\"Vehicle\":{\"type\":\"branch\",\"children\":{\"Chassis\":{\"type\":\"branch\",\"description\":\"All data concerning steering, suspension, wheels, and brakes.\",\"children\":{\"SteeringWheel\":{\"type\":\"branch\",\"description\":\"Steering wheel signals\",\"children\":{\"Diameter\":{\"type\":\"attribute\",\"description\":\"The diameter of the steering wheel\",\"datatype\":\"float\",\"unit\":\"cm\",\"min\":1,\"max\":50},\"HandsOff\":{\"type\":\"branch\",\"children\":{\"HandsOffSteeringState\":{\"type\":\"actuator\",\"description\":\"HndsOffStrWhlDtSt. Hands Off Steering State\",\"datatype\":\"boolean\"},\"HandsOffSteeringMode\":{\"type\":\"actuator\",\"description\":\"HndsOffStrWhlDtMd. Hands Off Steering Mode\",\"datatype\":\"int8\",\"min\":0,\"max\":2}}}}},\"Accelerator\":{\"type\":\"branch\",\"description\":\"\",\"children\":{\"AcceleratorPedalPosition\":{\"type\":\"sensor\",\"description\":\"Throttle__Position. Accelerator pedal position as percent. 0 = Not depressed. 100 = Fully depressed.\",\"datatype\":\"uint8\",\"unit\":\"%\",\"min\":0,\"max\":100.000035}}}}},\"Powertrain\":{\"type\":\"branch\",\"description\":\"Powertrain data for battery management, etc.\",\"children\":{\"Transmission\":{\"type\":\"branch\",\"description\":\"Transmission-specific data, stopping at the drive shafts.\",\"children\":{\"VehicleOdometer\":{\"type\":\"sensor\",\"description\":\"Vehicle_Odometer\",\"datatype\":\"float\",\"unit\":\"km\",\"min\":0,\"max\":67108863.984375}}},\"CombustionEngine\":{\"type\":\"branch\",\"description\":\"Engine-specific data, stopping at the bell housing.\",\"children\":{\"Engine\":{\"type\":\"branch\",\"description\":\"Engine description\",\"children\":{\"timing\":{\"type\":\"branch\",\"description\":\"timing description\",\"children\":{\"run_time\":{\"type\":\"sensor\",\"description\":\"Engine run time\",\"datatype\":\"int16\",\"unit\":\"ms\",\"min\":0,\"max\":10000},\"idle_time\":{\"type\":\"sensor\",\"description\":\"Engine idle time\",\"datatype\":\"int16\",\"min\":0,\"unit\":\"ms\",\"max\":10000}}}}}}}}},\"Axle\":{\"type\":\"branch\",\"description\":\"Axle signals\",\"children\":{\"TireRRPrs\":{\"type\":\"sensor\",\"description\":\"TireRRPrs. Right rear Tire pressure in kilo-Pascal\",\"datatype\":\"float\",\"unit\":\"kPaG\",\"min\":0,\"max\":1020}}}}}}" } ``` **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. Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `ImportSignalCatalog` 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" ] } ] } ``` ------ # Atualizar um catálogo AWS de sinais de IoT FleetWise Você pode usar a operação [UpdateSignalCatalog](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateSignalCatalog.html)da API para atualizar um catálogo de sinais existente. O exemplo a seguir usa AWS CLI. Para atualizar um catálogo de sinais existente, execute o comando a seguir. *signal-catalog-configuration*Substitua pelo nome do arquivo.json que contém a configuração. ``` aws iotfleetwise update-signal-catalog --cli-input-json file://signal-catalog-configuration.json ``` ## Configuração do catálogo de sinais *signal-catalog-name*Substitua pelo nome do catálogo de sinais que você está atualizando. Para obter mais informações sobre como configurar ramificações, atributos, sensores e atuadores, consulte [Configurar AWS sinais de IoT FleetWise](define-signal.md). **Importante** Estruturas personalizadas são imutáveis. Se você precisar reordenar ou inserir propriedades em uma estrutura personalizada existente (estrutura), exclua a estrutura e crie uma estrutura totalmente nova com a ordem de propriedades desejada. Para excluir uma estrutura personalizada, adicione o nome totalmente qualificado da estrutura em `nodesToRemove`. Uma estrutura não poderá ser excluída se for referida por algum sinal. Todos os sinais que se referem à estrutura (seu tipo de dados é definido como a estrutura de destino) devem ser atualizados ou excluídos antes da solicitação de atualização do catálogo de sinais. ``` { "name": "signal-catalog-name", "nodesToAdd": [{ "branch": { "description": "Front left of vehicle specific data.", "fullyQualifiedName": "Vehicle.Front.Left" } }, { "branch": { "description": "Door-specific data for the front left of vehicle.", "fullyQualifiedName": "Vehicle.Front.Left.Door" } }, { "actuator": { "fullyQualifiedName": "Vehicle.Front.Left.Door.Lock", "description": "Whether the front left door is locked.", "dataType": "BOOLEAN" } }, { "branch": { "fullyQualifiedName": "Vehicle.Camera" } }, { "struct": { "fullyQualifiedName": "Vehicle.Camera.SVMCamera" } }, { "property": { "fullyQualifiedName": "Vehicle.Camera.SVMCamera.ISO", "dataType": "STRING" } } ], "nodesToRemove": ["Vehicle.Chassis.SteeringWheel.HandsOffSteeringState"], "nodesToUpdate": [{ "attribute": { "dataType": "FLOAT", "fullyQualifiedName": "Vehicle.Chassis.SteeringWheel.Diameter", "max": 55 } }] } ``` Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `UpdateSignalCatalog` 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" ] } ] } ``` ------ ## Verifique a atualização do catálogo de sinais Você pode usar a operação [ListSignalCatalogNodes](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListSignalCatalogNodes.html)da API para verificar se um catálogo de sinais foi atualizado. O exemplo a seguir usa AWS CLI. Para recuperar uma lista paginada de resumos de todos os sinais (nós) em um determinado catálogo de sinais, execute o seguinte comando. *signal-catalog-name*Substitua pelo nome do catálogo de sinais que você está verificando. ``` aws iotfleetwise list-signal-catalog-nodes --name signal-catalog-name ``` Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `ListSignalCatalogNodes` API. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:Decrypt" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID" ] } ] } ``` ------ # Excluir um catálogo AWS de sinais de IoT FleetWise Você pode usar a operação [DeleteSignalCatalog](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteSignalCatalog.html)da API para excluir um catálogo de sinais. O exemplo a seguir usa AWS CLI. **Importante** Antes de excluir um catálogo de sinais, verifique se ele não tem modelos de veículos, manifestos de decodificadores, veículos, frotas ou campanhas associados. Para instruções, consulte: [Excluir um modelo AWS de veículo de IoT FleetWise](delete-vehicle-model.md) [Excluir um manifesto AWS do decodificador de IoT FleetWise](delete-decoder-manifest.md) [Excluir um veículo AWS de IoT FleetWise](delete-vehicle.md) [Excluir uma frota AWS de IoT FleetWise](delete-fleet-cli.md) [Excluir uma campanha AWS de IoT FleetWise](delete-campaign.md) Para excluir um catálogo de sinais existente, execute o comando a seguir. *signal-catalog-name*Substitua pelo nome do catálogo de sinais que você está excluindo. ``` aws iotfleetwise delete-signal-catalog --name signal-catalog-name ``` ## Verifique a exclusão do catálogo de sinais Você pode usar a operação [ListSignalCatalogs](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListSignalCatalogs.html)da API para verificar se um catálogo de sinais foi excluído. O exemplo a seguir usa AWS CLI. Para recuperar uma lista paginada de resumos de todos os catálogos de sinais, execute o seguinte comando. ``` aws iotfleetwise list-signal-catalogs ``` Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `ListSignalCatalogs` API. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:Decrypt" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID" ] } ] } ``` ------ # Obtenha informações AWS do catálogo de FleetWise sinais de IoT Você pode usar a operação da [GetSignalCatalog](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetSignalCatalog.html)API para recuperar informações do catálogo de sinais. O exemplo a seguir usa AWS CLI. Para recuperar informações sobre um catálogo de sinais, execute o comando a seguir. *signal-catalog-name*Substitua pelo nome do catálogo de sinais que você deseja recuperar. ``` aws iotfleetwise get-signal-catalog --name signal-catalog-name ``` Se você [ativou a criptografia](key-management.md) usando uma AWS KMS chave gerenciada pelo cliente, inclua a seguinte declaração de política para que sua função possa invocar a operação da `GetSignalCatalog` API. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:Decrypt" ], "Resource": [ "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID" ] } ] } ``` ------ **nota** Essa operação é [eventualmente consistente](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). Em outras palavras, as alterações no catálogo de sinais podem não ser refletidas imediatamente.