Modbus-TCP-Protokoll-Adapter-Anschluss - AWS IoT Greengrass

AWS IoT Greengrass Version 1 hat am 30. Juni 2023 in die Phase der verlängerten Lebensdauer aufgenommen. Weitere Informationen finden Sie in der AWS IoT Greengrass V1 Wartungsrichtlinie . Nach diesem Datum AWS IoT Greengrass V1 wurden keine Updates veröffentlicht, die Funktionen, Verbesserungen, Fehlerbehebungen oder Sicherheitspatches bereitstellen. Geräte, die auf ausgeführt AWS IoT Greengrass V1 werden, werden nicht unterbrochen und werden weiterhin betrieben und eine Verbindung zur Cloud herstellen. Wir empfehlen dringend, zu zu migrieren AWS IoT Greengrass Version 2, was erhebliche neue Funktionen und Unterstützung für zusätzliche Plattformen hinzufügt.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Modbus-TCP-Protokoll-Adapter-Anschluss

Der Modbus-TCP-ProtokolladapterAnschlusssammelt Daten von lokalen Geräten über das ModBustCP-Protokoll und veröffentlicht sie im ausgewähltenStreamManagerStreams.

Sie können diesen Konnektor auch mit dem IoT verwenden SiteWise Connector und Ihr IoT SiteWise -Gateway. Ihr Gateway muss die Konfiguration für den Connector angeben. Weitere Informationen finden Sie unterKonfigurieren einer Modbus-TCP-Quelleim IoT SiteWise -Benutzerhandbuch.

Anmerkung

Dieser Konnektor läuft inKein ContainerIsolationsmodus, damit Sie ihn in einemAWS IoT GreengrassGruppe, die in einem Docker-Container ausgeführt wird.

Dieser Konnektor hat die folgenden Versionen.

Version

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

Informationen über Versionsänderungen finden Sie im Änderungsprotokoll.

Voraussetzungen

Dieser Konnektor hat die folgenden Anforderungen:

Version 1 - 3
  • AWS IoT GreengrassCore-Software v1.10.2 oder höher.

  • Stream-Manager ist aufAWS IoT GreengrassGruppe.

  • Java 8 auf dem Core-Gerät installiert und zurPATHUmgebungsvariable.

Anmerkung

Dieser Konnektor ist nur in den folgenden Regionen verfügbar:

  • ap-southeast-1

  • ap-southeast-2

  • eu-central-1

  • eu-west-1

  • us-east-1

  • us-west-2

  • cn-north-1

Connector-Parameter

Dieser Konnektor unterstützt die folgenden Parameter:

LocalStoragePath

Das Verzeichnis auf derAWS IoT Greengrasshosten, dass das IoT SiteWise Connector kann persistente Daten in schreiben. Das Standardverzeichnis ist /var/sitewise.

Anzeigename imAWS IoT-Konsole Lokaler Speicherpfad

: Erforderlichfalse

Typ: string

Gültiges Pattern:^\s*$|\/.

MaximumBufferSize

Die maximale Größe in GB für IoT SiteWise Festplattennutzung. Die Standardgröße ist 10 GB.

Anzeigename imAWS IoT-Konsole Maximale Datenträgerpuffergröße

: Erforderlichfalse

Typ: string

Gültiges Pattern:^\s*$|[0-9]+

CapabilityConfiguration

Der Satz von Modbus TCP-Collector-Konfigurationen, von denen der Konnektor Daten sammelt und mit denen er eine Verbindung herstellt.

Anzeigename imAWS IoT-Konsole CapabilityConfiguration

: Erforderlichfalse

Type: Eine wohlgeformte JSON-Zeichenfolge, die die Gruppe der unterstützten Feedback-Konfigurationen definiert.

Es folgt ein Beispiel für eineCapabilityConfiguration:

{ "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 } } ] } ] }

Beispiel für das Erstellen eines Konnektors (AWS CLI)

Der folgende CLI-Befehl erstellt eineConnectorDefinitionmit einer Initialversion, die den Modbus-TCP-Protokoll-Adapter-Konnektor enthält.

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}]}\"}" } } ] }'
Anmerkung

Die Lambda-Funktion in diesem Anschluss hat einelangdauerndesLebenszyklus.

Eingabedaten

Dieser Konnektor akzeptiert keine MQTT-Nachrichten als Eingabedaten.

Ausgabedaten

Dieser Konnektor veröffentlicht Daten inStreamManageraus. Sie müssen den Ziel-Message-Stream konfigurieren. Die Ausgabemeldungen haben die folgende Struktur:

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

Lizenzen

Der Modbus-TCP-Protokolladapter-Konnektor enthält die folgende Drittanbieter-Software/Lizenz:

Dieser Connector wird unter derLizenzvereinbarung für die Greengrass Core-Softwareaus.

Änderungsprotokoll

In der folgenden Tabelle werden die Änderungen in jeder Version des -Konnektors beschrieben.

Version

Änderungen

Datum

3 (empfohlen)

Diese Version enthält Fehlerbehebungen.

22. Dezember 2021

2

Unterstützung für ASCII-, UTF8- und ISO8859-codierte Quellzeichenfolgen hinzugefügt.

24. Mai 2021

1

Erstversion.

15. Dezember 2020

Eine Greengrass-Gruppe kann jeweils nur eine Version des -Konnektors enthalten. Weitere Informationen zum Aktualisieren einer Konnektorversion finden Sie unter Aktualisieren von Konnektorversionen.

Weitere Informationen finden Sie auch unter