View a markdown version of this page

Modbus-TCP Conector adaptador de protocolo - AWS IoT Greengrass

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.

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.

Modbus-TCP Conector adaptador de protocolo

El conector del adaptador de Modbus-TCP protocolo recopila datos de los dispositivos locales a través del protocolo ModbusTCP y los publica en las transmisiones seleccionadasStreamManager.

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 Modbus TCP en la guía del SiteWise usuario de IoT.

nota

Este conector se ejecuta en modo sin aislamiento de contenedores, 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

3

arn:aws:greengrass:region::/connectors/ModbusTCPConnector/versions/3

2.

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

1

arn:aws:greengrass:region::/connectors/ModbusTCPConnector/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 - 3
  • 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.

nota

Este conector solo está disponible en las siguientes regiones:

  • ap-southeast-1

  • ap-southeast-2

  • eu-central-1

  • eu-west-1

  • us-east-1

  • us-west-2

  • cn-north-1

Parámetros de conector

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*$|\/.

MaximumBufferSize

El tamaño máximo en GB para el uso SiteWise del disco de IoT. El tamaño por defecto es de 10 GB.

Nombre para mostrar en la AWS IoT consola: tamaño máximo del búfer de disco

Obligatorio: false

Tipo: string

Patrón válido: ^\s*$|[0-9]+

CapabilityConfiguration

El conjunto de configuraciones de recopiladores Modbus TCP desde las que el conector recopila datos o a las que se conecta.

Nombre para mostrar en la AWS IoT consola: CapabilityConfiguration

Obligatorio: false

Tipo: una cadena JSON bien formada que define el conjunto de configuraciones de comentarios admitidas.

A continuación, se muestra un ejemplo de una CapabilityConfiguration.

{ "sources": [ { "type": "ModBusTCPSource", "name": "SourceName1", "measurementDataStreamPrefix": "SourceName1_Prefix", "destination": { "type": "StreamManager", "streamName": "SiteWise_Stream_1", "streamBufferSize": 8 }, "endpoint": { "ipAddress": "127.0.0.1", "port": 8081, "unitId": 1 }, "propertyGroups": [ { "name": "GroupName", "tagPathDefinitions": [ { "type": "ModBusTCPAddress", "tag": "TT-001", "address": "30001", "size": 2, "srcDataType": "float", "transformation": "byteWordSwap", "dstDataType": "double" } ], "scanMode": { "type": "POLL", "rate": 100 } } ] } ] }

Ejemplo de creación de un conector (AWS CLI)

El siguiente comando CLI crea una ConnectorDefinition con una versión inicial que contiene el conector del adaptador de Modbus-TCP protocolo.

aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version ' { "Connectors": [ { "Id": "MyModbusTCPConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/ModbusTCP/versions/3", "Parameters": { "capability_configuration": "{\"version\":1,\"namespace\":\"iotsitewise:modbuscollector:1\",\"configuration\":\"{\"sources\":[{\"type\":\"ModBusTCPSource\",\"name\":\"SourceName1\",\"measurementDataStreamPrefix\":\"\",\"endpoint\":{\"ipAddress\":\"127.0.0.1\",\"port\":8081,\"unitId\":1},\"propertyGroups\":[{\"name\":\"PropertyGroupName\",\"tagPathDefinitions\":[{\"type\":\"ModBusTCPAddress\",\"tag\":\"TT-001\",\"address\":\"30001\",\"size\":2,\"srcDataType\":\"hexdump\",\"transformation\":\"noSwap\",\"dstDataType\":\"string\"}],\"scanMode\":{\"rate\":200,\"type\":\"POLL\"}}],\"destination\":{\"type\":\"StreamManager\",\"streamName\":\"SiteWise_Stream\",\"streamBufferSize\":10},\"minimumInterRequestDuration\":200}]}\"}" } } ] }'
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 Modbus-TCP del adaptador de protocolo incluye los siguientes productos de terceros software/licensing:

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

Registros de cambios

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

Versión

Cambios

Date

3 (recomendado)

Esta versión contiene correcciones de errores.

22 de diciembre de 2021

2

Se agregó soporte para cadenas fuente codificadas en ASCII, UTF8 e ISO8859.

24 de mayo 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