Avviso di fine del supporto: il 7 ottobre 2026, AWS il supporto per. AWS IoT Greengrass Version 1 Dopo il 7 ottobre 2026, non potrai più accedere alle risorse. AWS IoT Greengrass V1 Per ulteriori informazioni, visita [Migrate](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html) from. AWS IoT Greengrass Version 1 Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Modbus-TCP Connettore Protocol Adapter Il [connettore Modbus-TCP ](connectors.md) Protocol Adapter raccoglie i dati dai dispositivi locali tramite il protocollo ModbusTCP e li pubblica negli stream selezionati. `StreamManager` Puoi utilizzare questo connettore anche con il SiteWise connettore IoT e il tuo SiteWise gateway IoT. Il gateway deve fornire la configurazione per il connettore. Per ulteriori informazioni, consulta [Configurare una sorgente Modbus TCP](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-modbus-source.html) nella guida SiteWise utente IoT. **Nota** Questo connettore funziona in modalità [Nessun contenitore](lambda-group-config.md#no-container-mode) isolato, quindi puoi distribuirlo a un AWS IoT Greengrass gruppo in esecuzione in un contenitore Docker. Questo connettore ha le seguenti versioni. | Versione | 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` | Per informazioni sulle modifiche di ogni versione, consulta [Changelog](#modbus-tcp-connector-changelog). ## Requisiti Questo connettore presenta i seguenti requisiti: ------ #### [ Version 1 - 3 ] + AWS IoT Greengrass Software principale v1.10.2 o successivo. + Stream manager abilitato sul gruppo. AWS IoT Greengrass + Java 8 installato sul dispositivo principale e aggiunto alla variabile di `PATH` ambiente. **Nota** Questo connettore è disponibile solo nelle seguenti regioni: ap-southeast-1 ap-southeast-2 eu-central-1 eu-west-1 us-east-1 us-west-2 cn-north-1 ------ ## Parametri del connettore Questo connettore supporta i seguenti parametri: `LocalStoragePath` La directory sull' AWS IoT Greengrass host su cui il SiteWise connettore IoT può scrivere dati persistenti. La directory predefinita è `/var/sitewise`. Nome visualizzato nella AWS IoT console: **Percorso di archiviazione locale** Obbligatorio: `false` Tipo: `string` Modello valido: `^\s*$|\/.` `MaximumBufferSize` La dimensione massima in GB per l'utilizzo SiteWise del disco IoT. La dimensione predefinita è 10 GB. Nome visualizzato nella AWS IoT console: dimensione **massima del buffer del disco** Obbligatorio: `false` Tipo: `string` Modello valido: `^\s*$|[0-9]+` `CapabilityConfiguration` L'insieme di configurazioni del collettore Modbus TCP da cui il connettore raccoglie i dati e a cui si connette. Nome visualizzato nella console: AWS IoT **CapabilityConfiguration** Obbligatorio: `false` Tipo: una stringa JSON ben formata che definisce l'insieme di configurazioni di feedback supportate. Di seguito è riportato un esempio di `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 } } ] } ] } ``` ### Esempio di creazione di connettore (AWS CLI) Il seguente comando CLI crea un `ConnectorDefinition` con una versione iniziale che contiene il connettore Modbus-TCP Protocol Adapter. ``` 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 funzione Lambda in questo connettore ha un ciclo di vita di [lunga durata](lambda-functions.md#lambda-lifecycle). ## Dati di input Questo connettore non accetta messaggi MQTT come dati di input. ## Dati di output Questo connettore pubblica dati su. `StreamManager` È necessario configurare il flusso di messaggi di destinazione. I messaggi di output hanno la seguente struttura: ``` { "alias": "string", "messages": [ { "name": "string", "value": boolean|double|integer|string, "timestamp": number, "quality": "string" } ] } ``` ## Licenze Il connettore Modbus-TCP Protocol Adapter include le seguenti terze parti software/licensing: + [Petri Modbus digitale](https://github.com/digitalpetri/modbus) Questo connettore è rilasciato ai sensi del contratto di [licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog La tabella seguente descrive le modifiche apportate a ciascuna versione del connettore. | Versione | Modifiche | Data | | --- | --- | --- | | 3 (consigliato) | Questa versione contiene correzioni di bug. | 22 dicembre 2021 | | 2 | È stato aggiunto il supporto per le stringhe sorgente codificate ASCII, UTF8 e ISO8859. | 24 maggio 2021 | | 1 | Versione iniziale. | 15 dicembre 2020 | Un gruppo Greengrass può contenere una sola versione del connettore alla volta. Per informazioni sull'aggiornamento di una versione del connettore, consulta [Aggiornamento delle versioni dei connettori](connectors.md#upgrade-connector-versions). ## Consulta anche + [Integrazione con servizi e protocolli tramite i connettori Greengrass](connectors.md) + [Nozioni di base sui connettori Greengrass (console)](connectors-console.md) + [Nozioni di base sui connettori Greengrass (CLI)](connectors-cli.md)