Connettore adattatore protocollo Modbus-TCP - AWS IoT Greengrass

AWS IoT Greengrass Version 1 è entrato nella fase di estensione della vita utile il 30 giugno 2023. Per ulteriori informazioni, consulta la politica AWS IoT Greengrass V1 di manutenzione. Dopo questa data, AWS IoT Greengrass V1 non rilascerà aggiornamenti che forniscano funzionalità, miglioramenti, correzioni di bug o patch di sicurezza. I dispositivi che funzionano AWS IoT Greengrass V1 non subiranno interruzioni e continueranno a funzionare e a connettersi al cloud. Ti consigliamo vivamente di eseguire la migrazione a AWS IoT Greengrass Version 2, che aggiunge nuove importanti funzionalità e supporto per piattaforme aggiuntive.

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à.

Connettore adattatore protocollo Modbus-TCP

L'adattatore di protocollo Modbus-TCPconnettoreraccoglie i dati dai dispositivi locali tramite il protocollo ModbuTCP e li pubblica sul selezionatoStreamManagerflussi.

Puoi anche utilizzare questo connettore con l'IoT SiteWise connettore e IoT SiteWise gateway. Il gateway deve fornire la configurazione per il connettore. Per ulteriori informazioni, consultaConfigurazione di una sorgente TCP Modbusnell'IoT SiteWise Guida per l'utente.

Nota

Questo connettore funzionaNessun containermodalità di isolamento, in modo da poterla distribuire in unAWS IoT Greengrassgruppo in esecuzione in un container Docker.

Questo connettore dispone delle versioni seguenti.

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.

Requisiti

Questo connettore presenta i seguenti requisiti:

Version 1 - 3
  • AWS IoT GreengrassSoftware core v1.10.2 o versioni successive.

  • Gestore di flusso attivato sulAWS IoT Greengrassgruppo.

  • Java 8 installato sul dispositivo core e aggiunto alPATHVariabile di ambiente.

Nota

Questo connettore è disponibile solo per le regioni seguenti:

  • ap-southeast-1

  • ap-southeast-2

  • eu-central-1

  • eu-west-1

  • us-east-1

  • us-west-2

  • cn-north-1

Parametri connettore

Questo connettore supporta i seguenti parametri:

LocalStoragePath

La directory sulAWS IoT Greengrasshost che l'IoT SiteWise può scrivere dati persistenti. La directory predefinita è /var/sitewise.

Nome visualizzato nelAWS IoTConsole : Percorso di storage locale

campo obbligatorio:false

Tipo: string

Modello valido:^\s*$|\/.

MaximumBufferSize

La dimensione massima in GB di IoT SiteWise utilizzo del disco. La dimensione predefinita è 10 GB.

Nome visualizzato nelAWS IoTConsole : Massima dimensione del buffer del disco

campo obbligatorio:false

Tipo: string

Modello valido:^\s*$|[0-9]+

CapabilityConfiguration

Il set di configurazioni del collettore Modbus TCP a cui il connettore raccoglie i dati e si connette.

Nome visualizzato nelAWS IoTConsole : CapabilityConfiguration

campo obbligatorio:false

Type: Una stringa JSON ben formata che definisce il set di configurazioni di feedback supportate.

Di seguito è riportato un esempio di unCapabilityConfiguration:

{ "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 un connettore (AWS CLI)

Il seguente comando CLI crea unConnectorDefinitioncon 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 è dotata dilunga durataciclo di vita.

Dati di input

Questo connettore non accetta messaggi MQTT come dati di input.

Dati di output

Questo connettore pubblica i dati inStreamManager. È necessario configurare il flusso di messaggi di destinazione. I messaggi di output sono della struttura seguente:

{ "alias": "string", "messages": [ { "name": "string", "value": boolean|double|integer|string, "timestamp": number, "quality": "string" } ] }

Licenze

Il connettore Modbus-TCP Protocol Adapter include il software e le licenze di terze parti indicati di seguito:

Questo connettore viene rilasciato sottoAccordo di licenza del software Greengrass Core.

Changelog

Nella seguente tabella sono descritte le modifiche apportate a ogni versione del connettore.

Versione

Modifiche

Data

3 (consigliato)

Questa versione contiene le correzioni di bug.

22 dicembre 2021

2

Aggiunto il supporto per le stringhe di origine 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.

Consultare anche