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) |
|
1 |
|
Para obter informações sobre alterações de versão, consulte o Changelog.
Requisitos
Esse conector tem os seguintes requisitos:
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.