

Aviso de fin de soporte: el 7 de octubre de 2026, AWS suspenderemos el soporte para AWS IoT Greengrass Version 1. Después del 7 de octubre de 2026, ya no podrá acceder a los AWS IoT Greengrass V1 recursos. Para obtener más información, visita [Migrar desde AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Conector del adaptador de protocolo IP Ethernet IoT
<a name="ethernet-ip-connector"></a>

El [conector](connectors.md) del adaptador de protocolo IP Ethernet IoT recopila datos de los dispositivos locales mediante el Ethernet/IP protocolo. Puede utilizar este conector para recopilar datos de varios servidores y publicarlos en un flujo de mensajes de `StreamManager`. 

También puede usar este conector con el conector de IoT SiteWise y su SiteWise puerta de enlace de IoT. Su puerta de enlace debe proporcionar la configuración del conector. Para obtener más información, consulte [Configurar una fuente Ethernet/IP (EIP)](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-eip-source.html) en la guía del SiteWise usuario de IoT. 

**nota**  
Este conector se ejecuta en modo [sin aislamiento de contenedores](lambda-group-config.md#no-container-mode), por lo que puede implementarlo en un AWS IoT Greengrass grupo que se ejecute en un contenedor de Docker. 

Este conector tiene las siguientes versiones.


| Versión | ARN | 
| --- | --- | 
| 2 (recomendado) | `arn:aws:greengrass:{{region}}::/connectors/IoTEIPProtocolAdaptor/versions/2` | 
| 1 | `arn:aws:greengrass:{{region}}::/connectors/IoTEIPProtocolAdaptor/versions/1` | 

Para obtener información sobre los cambios de versión, consulte el [Registro de cambios](#ethernet-ip-connector-changelog).

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

Este conector exige los siguientes requisitos:

------
#### [ Version 1 and 2 ]
+ AWS IoT Greengrass Software básico, versión 1.10.2 o posterior.
+ El administrador de transmisiones está activado en el AWS IoT Greengrass grupo.
+ Java 8 instalado en el dispositivo de núcleo y añadido a la variable de entorno `PATH`.
+ Un mínimo de 256 MB de RAM adicionales. Este requisito se suma a los requisitos de memoria AWS IoT Greengrass básica.

**nota**  
 Este conector solo está disponible en las siguientes regiones:   
cn-north-1
ap-southeast-1
ap-southeast-2
eu-central-1
eu-west-1
us-east-1
us-west-2

------

## Parámetros de conector
<a name="ethernet-ip-connector-param"></a>

Este conector admite los siguientes parámetros:

`LocalStoragePath`  
El directorio del AWS IoT Greengrass host en el que el SiteWise conector de IoT puede escribir datos persistentes. El directorio predeterminado es `/var/sitewise`.  
Nombre para mostrar en la AWS IoT consola: **ruta de almacenamiento local**  
Obligatorio: `false`  
Tipo: `string`  
Patrón válido: `^\s*$|\/.`

`ProtocolAdapterConfiguration`  
El conjunto de configuraciones del Ethernet/IP recopilador desde las que el conector recopila datos o a las que se conecta. Puede ser una lista vacía.  
Nombre para mostrar en la AWS IoT consola: **Configuración del adaptador de protocolo**  
Obligatorio: `true`  
Tipo: una cadena JSON bien formada que define el conjunto de configuraciones de comentarios admitidas.

 A continuación, se muestra un ejemplo de una `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"
                        }
                    ]
                }
            ]
        }
    ]
}
```

### Ejemplo de creación de conector (AWS CLI)
<a name="eip-connector-create"></a>

El siguiente comando CLI crea una `ConnectorDefinition` con una versión inicial que contiene el conector 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**  
La función de Lambda de este conector tiene un ciclo de vida [prolongado](lambda-functions.md#lambda-lifecycle).

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

Este conector no acepta mensajes MQTT como datos de entrada.

## Datos de salida
<a name="ethernet-ip-connector-data-output"></a>

Este conector publica datos en `StreamManager`. Debe configurar el flujo de mensajes de destino. Los mensajes de salida tienen la siguiente estructura:

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

## Licencias
<a name="ethernet-ip-connector-license"></a>

El conector del adaptador de protocolo IP Ethernet IoT incluye lo siguiente de terceros 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)

Este conector se publica bajo el [contrato de licencia de software de Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Registros de cambios
<a name="ethernet-ip-connector-changelog"></a>

La siguiente tabla describe los cambios en cada versión del conector.


| Versión | Cambios | Date | 
| --- | --- | --- | 
| 2 | Esta versión contiene correcciones de errores. | 23 de diciembre de 2021 | 
| 1 | Versión inicial. | 15 de diciembre de 2020 | 

<a name="one-conn-version"></a>Un grupo de Greengrass solo puede contener una versión del conector a la vez. Para obtener información sobre cómo actualizar una versión de conector, consulte [Actualización de versiones de los conectores](connectors.md#upgrade-connector-versions).

## Véase también
<a name="ethernet-ip-connector-see-also"></a>
+ [Integración con servicios y protocolos mediante conectores de Greengrass](connectors.md)
+ [Introducción a los conectores de Greengrass (consola)](connectors-console.md)
+ [Introducción a los conectores de Greengrass (CLI)](connectors-cli.md)