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

AWS IoT Greengrass Version 1 entró en la fase de vida útil prolongada el 30 de junio de 2023. Para obtener más información, consulte la política de mantenimiento de AWS IoT Greengrass V1 Después de esta fecha, AWS IoT Greengrass V1 no se publicarán actualizaciones que proporcionen funciones, mejoras, correcciones de errores o parches de seguridad. Los dispositivos que se ejecuten AWS IoT Greengrass V1 no se verán afectados y seguirán funcionando y conectándose a la nube. Le recomendamos encarecidamente que migre a AWS IoT Greengrass Version 2, ya que añade importantes funciones nuevas y es compatible con plataformas adicionales.

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 de adaptador de protocolo IP Ethernet IoT

El conector del adaptador de protocolo IP Ethernet IoT recopila datos de dispositivos locales mediante el protocolo EtherNet/IP. Puede utilizar este conector para recopilar datos de varios servidores y publicarlos en StreamManager.

También puede usar este conector con el conector IoT SiteWise y tu puerta de enlace IoT SiteWise. Su puerta de enlace debe proporcionar la configuración del conector. Para obtener más información, consulte Configurar una fuente EtherNet/IP (EIP) en la guía del usuario de IoT SiteWise.

nota

Este conector se ejecuta en modo sin aislamiento de contenedores, por lo que puede implementarlo en un grupo AWS IoT Greengrass 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.

Requisitos

Este conector exige los siguientes requisitos:

Version 1 and 2
  • Software AWS IoT Greengrass Core versión 1.10.2 o posterior.

  • Administrador de secuencias habilitado en el grupo de AWS IoT Greengrass.

  • 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 Core.

nota

Este conector sólo 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

Este conector admite los siguientes parámetros:

LocalStoragePath

El directorio del host de AWS IoT Greengrass en la que el conector de IoT SiteWise puede escribir datos persistentes. El directorio predeterminado es /var/sitewise.

Nombre para mostrar en la consola AWS IoT: Ruta de almacenamiento local

Obligatorio: false

Escriba: string

Patrón válido: ^\s*$|\/.

ProtocolAdapterConfiguration

El conjunto de configuraciones de recopiladores EtherNet/IP desde las que el conector recopila datos o a las que se conecta. Puede ser una lista vacía.

Nombre para mostrar en la consola AWS IoT: 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)

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.

Datos de entrada

Este conector no acepta mensajes MQTT como datos de entrada.

Datos de salida

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

El conector Adaptador de protocolo IP Ethernet IoT incluye el siguiente software/licencias de terceros:

Este conector se publica bajo el contrato de licencia de software de Greengrass Core.

Registro de cambios

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

Versión

Cambios

Fecha

2

Esta versión contiene correcciones de errores.

23 de diciembre de 2021

1

Versión inicial.

15 de diciembre de 2020

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.

Véase también