Conector do adaptador de protocolo IP Ethernet IoT - AWS IoT Greengrass

AWS IoT Greengrass Version 1 entrou na fase de vida útil prolongada em 30 de junho de 2023. Para obter mais informações, consulte política de manutenção do AWS IoT Greengrass V1. Após essa data, AWS IoT Greengrass V1 não lançaremos atualizações que forneçam recursos, aprimoramentos, correções de erros ou patches de segurança. Os dispositivos que funcionam AWS IoT Greengrass V1 não serão interrompidos e continuarão operando e se conectando à nuvem. É altamente recomendável que você migre para AWS IoT Greengrass Version 2, o que adiciona novos recursos significativos e suporte para plataformas adicionais.

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

Conector do adaptador de protocolo IP Ethernet IoT

O conector do adaptador de protocolo IP do Ethernet IoT coleta dados de dispositivos locais usando o protocolo Ethernet/IP. Você pode usar esse conector para coletar dados de vários dispositivos e publicá-los em um fluxo de mensagens StreamManager.

Você também pode usar esse conector com o conector do IoT SiteWise e seu gateway IoT SiteWise. Seu gateway deve fornecer a configuração do conector. Para obter mais informações, consulte Configurar uma fonte Ethernet/IP (EIP) no guia do usuário do IoT SiteWise.

nota

Esse conector é executado no modo de isolamento Sem contêiner para que você possa implantá-lo em um grupo do AWS IoT Greengrass que está sendo executado em um contêiner do Docker.

Esse conector tem as seguintes versões.

Versão

ARN

2 (recomendado)

arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/2

1

arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/1

Para obter informações sobre alterações de versão, consulte o Changelog.

Requisitos

Esse conector tem os seguintes requisitos:

Version 1 and 2
  • Software do AWS IoT Greengrass Core v1.10.2 ou posterior.

  • Gerenciador de fluxo ativado no grupo do AWS IoT Greengrass.

  • Java 8 instalado no dispositivo de núcleo e adicionado à variável de ambiente PATH.

  • Um mínimo de 256 MB de RAM adicional. Esse requisito é adicional aos requisitos de memória do AWS IoT Greengrass Core.

nota

Esse conector só está disponível nas seguintes Regiões:

  • cn-north-1

  • ap-southeast-1

  • ap-southeast-2

  • eu-central-1

  • eu-west-1

  • us-east-1

  • us-west-2

Parâmetros do conector

Esse conector oferece suporte aos seguintes parâmetros:

LocalStoragePath

O diretório no host do AWS IoT Greengrass no qual o conector do IoT SiteWise pode gravar dados persistentes. O diretório padrão é /var/sitewise.

Nome de exibição no console AWS IoT: Caminho de armazenamento local

Obrigatório: false

Digite: string

Padrão válido: ^\s*$|\/.

ProtocolAdapterConfiguration

O conjunto de configurações do coletor EtherNet/IP das quais o conector coleta dados ou às quais se conecta. Ele pode ser uma lista vazia.

Nome de exibição no console do AWS IoT: Configuração do adaptador de protocolo

Obrigatório: true

Tipo: uma string JSON bem-formada que define o conjunto de configurações de feedback compatíveis.

Veja a seguir um exemplo de um ProtocolAdapterConfiguration:

{ "sources": [ { "type": "EIPSource", "name": "TestSource", "endpoint": { "ipAddress": "52.89.2.42", "port": 44818 }, "destination": { "type": "StreamManager", "streamName": "MyOutput_Stream", "streamBufferSize": 10 }, "destinationPathPrefix": "EIPSource_Prefix", "propertyGroups": [ { "name": "DriveTemperatures", "scanMode": { "type": "POLL", "rate": 10000 }, "tagPathDefinitions": [ { "type": "EIPTagPath", "path": "arrayREAL[0]", "dstDataType": "double" } ] } ] } ] }

Exemplo de criação de conector (AWS CLI)

O seguinte comando da CLI cria um ConnectorDefinition com uma versão inicial que contém o conector do adaptador de protocolo IP Ethernet IoT.

aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyIoTEIPProtocolConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTEIPProtocolAdaptor/versions/2", "Parameters": { "ProtocolAdaptorConfiguration": "{ \"sources\": [{ \"type\": \"EIPSource\", \"name\": \"Source1\", \"endpoint\": { \"ipAddress\": \"54.245.77.218\", \"port\": 44818 }, \"destinationPathPrefix\": \"EIPConnector_Prefix\", \"propertyGroups\": [{ \"name\": \"Values\", \"scanMode\": { \"type\": \"POLL\", \"rate\": 2000 }, \"tagPathDefinitions\": [{ \"type\": \"EIPTagPath\", \"path\": \"arrayREAL[0]\", \"dstDataType\": \"double\" }]}]}]}", "LocalStoragePath": "/var/MyIoTEIPProtocolConnectorState" } } ] }'
nota

A função do Lambda nesse conector tem um ciclo de vida longo.

Dados de entrada

Esse conector não aceita mensagens MQTT como dados de entrada.

Dados de saída

Esse conector publica dados para StreamManager: Você deve configurar o fluxo de mensagens de destino. As mensagens de saída têm a seguinte estrutura:

{ "alias": "string", "messages": [ { "name": "string", "value": boolean|double|integer|string, "timestamp": number, "quality": "string" } ] }

Licenças

O conector do adaptador de protocolo IP Ethernet IoT inclui o seguinte licenciamento/software de terceiros:

Esse conector é liberado de acordo com o Contrato de licença de software do Greengrass Core.

Changelog

A tabela a seguir descreve as alterações em cada versão do conector.

Versão

Alterações

Data

2

Esta versão contém correções de erros.

23 de dezembro de 2021

1

Versão inicial.

15 de dezembro de 2020

Um grupo do Greengrass só pode conter uma versão do conector por vez. Para obter informações sobre como fazer upgrade de uma versão do conector, consulte Atualizar a versões do conector.

Consulte também