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. # Modbus-TCP Conector adaptador de protocolo El [conector del](connectors.md) adaptador de Modbus-TCP protocolo recopila datos de los dispositivos locales a través del protocolo ModbusTCP y los publica en las transmisiones seleccionadas`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 Modbus TCP](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-modbus-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 | | --- | --- | | 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](#modbus-tcp-connector-changelog). ## 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](lambda-functions.md#lambda-lifecycle). ## 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: + [Petri Modbus digital](https://github.com/digitalpetri/modbus) 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 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](connectors.md#upgrade-connector-versions). ## Véase también + [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)