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á. # Modbus-TCP Conector de adaptador de protocolo O [conector](connectors.md) do adaptador de Modbus-TCP protocolo coleta dados de dispositivos locais por meio do protocolo ModbusTCP e os publica nos fluxos selecionados. `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 Modbus TCP no guia](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-modbus-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 | | --- | --- | | 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 obter informações sobre alterações de versão, consulte o [Changelog](#modbus-tcp-connector-changelog). ## Requisitos Esse conector tem os seguintes requisitos: ------ #### [ Version 1 - 3 ] + 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`. **nota** Esse conector só está disponível nas seguintes regiões: ap-southeast-1 ap-southeast-2 eu-central-1 eu-west-1 us-east-1 us-west-2 cn-north-1 ------ ## Parâmetros do conector 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*$|\/.` `MaximumBufferSize` O tamanho máximo em GB para uso do SiteWise disco de IoT. O tamanho padrão é 10 GB. Nome de exibição no AWS IoT console: tamanho **máximo do buffer de disco** Obrigatório: `false` Digite: `string` Padrão válido: `^\s*$|[0-9]+` `CapabilityConfiguration` O conjunto de configurações do coletor Modbus TCP do qual o conector coleta dados e ao qual ele se conecta. Nome de exibição no AWS IoT console: **CapabilityConfiguration** Obrigatório: `false` Tipo: uma string JSON bem-formada que define o conjunto de configurações de feedback compatíveis. Veja a seguir um exemplo de um `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 } } ] } ] } ``` ### Exemplo de criação de conector (AWS CLI) O comando CLI a seguir cria um `ConnectorDefinition` com uma versão inicial que contém o conector do 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** A função do Lambda nesse conector tem um ciclo de vida [longo](lambda-functions.md#lambda-lifecycle). ## Dados de entrada Esse conector não aceita mensagens MQTT como dados de entrada. ## Dados de saída 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 O conector do adaptador de Modbus-TCP protocolo inclui os seguintes terceiros software/licensing: + [Digital Petri](https://github.com/digitalpetri/modbus) Modbus 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 tabela a seguir descreve as alterações em cada versão do conector. | Versão | Alterações | Data | | --- | --- | --- | | 3 (recomendado) | Esta versão contém correções de erros. | 22 de dezembro de 2021 | | 2 | Foi adicionado suporte para strings de caracteres de origem codificados em ASCII, UTF8 e ISO8859. | 24 de maio de 2021 | | 1 | Versão inicial. | 15 de dezembro de 2020 | 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 + [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)