

Aviso de fim do suporte: em 7 de outubro de 2026, AWS o suporte para o. AWS IoT Greengrass Version 1 Depois de 7 de outubro de 2026, você não poderá mais acessar os AWS IoT Greengrass V1 recursos. Para obter mais informações, visite [Migrar de AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

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
<a name="ethernet-ip-connector"></a>

O [conector](connectors.md) do adaptador de protocolo IP 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 de IoT e seu SiteWise gateway de 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](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-eip-source.html) do usuário de SiteWise IoT. 

**nota**  
Esse conector é executado no modo [Sem isolamento de contêiner](lambda-group-config.md#no-container-mode), então você pode implantá-lo em um AWS IoT Greengrass grupo executado em um contêiner 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](#ethernet-ip-connector-changelog).

## Requisitos
<a name="ethernet-ip-connector-req"></a>

Esse conector tem os seguintes requisitos:

------
#### [ Version 1 and 2 ]
+ AWS IoT Greengrass Software principal v1.10.2 ou posterior.
+ Gerenciador de transmissões ativado no AWS IoT Greengrass grupo.
+ 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 AWS IoT Greengrass principal.

**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
<a name="ethernet-ip-connector-param"></a>

Esse conector oferece suporte aos seguintes parâmetros:

`LocalStoragePath`  
O diretório no AWS IoT Greengrass host no qual o SiteWise conector de IoT pode gravar dados persistentes. O diretório padrão é `/var/sitewise`.  
Nome de exibição no AWS IoT console: **caminho de armazenamento local**  
Obrigatório: `false`  
Digite: `string`  
Padrão válido: `^\s*$|\/.`

`ProtocolAdapterConfiguration`  
O conjunto de configurações do Ethernet/IP coletor das quais o conector coleta dados ou às quais se conecta. Ele pode ser uma lista vazia.  
Nome de exibição no AWS IoT console: **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)
<a name="eip-connector-create"></a>

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](lambda-functions.md#lambda-lifecycle).

## Dados de entrada
<a name="ethernet-ip-connector-data-input"></a>

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

## Dados de saída
<a name="ethernet-ip-connector-data-output"></a>

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
<a name="ethernet-ip-connector-license"></a>

O conector do adaptador de protocolo IP Ethernet IoT inclui os seguintes componentes de terceiros: software/licensing
+ [Ethernet/IP cliente](https://github.com/digitalpetri/ethernet-ip/blob/master/LICENSE)
+ [MapDB](https://github.com/jankotek/mapdb/blob/master/LICENSE.txt)
+ [Elsa](https://github.com/jankotek/elsa/blob/master/LICENSE.txt)

Esse conector é liberado de acordo com o [Contrato de licença de software do Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Changelog
<a name="ethernet-ip-connector-changelog"></a>

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 | 

<a name="one-conn-version"></a>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](connectors.md#upgrade-connector-versions).

## Consulte também
<a name="ethernet-ip-connector-see-also"></a>
+ [Integrar a serviços e protocolos usando conectores do Greengrass](connectors.md)
+ [Conceitos básicos de conectores do Greengrass (console)](connectors-console.md)
+ [Conceitos básicos de conectores do Greengrass (CLI)](connectors-cli.md)