Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS wird der Support für eingestellt. AWS IoT Greengrass Version 1 Nach dem 7. Oktober 2026 können Sie nicht mehr auf die Ressourcen zugreifen. AWS IoT Greengrass V1 Weitere Informationen finden Sie unter [Migrieren von AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). 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 Anschluss für Protokolladapter Der Modbus-TCP [Protokolladapter-Connector](connectors.md) sammelt Daten von lokalen Geräten über das ModbusTCP-Protokoll und veröffentlicht sie in den ausgewählten Streams. `StreamManager` Sie können diesen Connector auch mit dem SiteWise IoT-Connector und Ihrem SiteWise IoT-Gateway verwenden. Ihr Gateway muss die Konfiguration für den Connector bereitstellen. Weitere Informationen finden [Sie unter Konfiguration einer Modbus-TCP-Quelle](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-modbus-source.html) im SiteWise IoT-Benutzerhandbuch. **Anmerkung** Dieser Connector wird im Modus „[Keine Container-Isolation](lambda-group-config.md#no-container-mode)“ ausgeführt, sodass Sie ihn für eine AWS IoT Greengrass Gruppe bereitstellen können, die in einem Docker-Container ausgeführt wird. Dieser Connector 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](#modbus-tcp-connector-changelog). ## Voraussetzungen Dieser Konnektor hat die folgenden Anforderungen: ------ #### [ Version 1 - 3 ] + AWS IoT Greengrass Kernsoftware v1.10.2 oder höher. + Stream Manager ist für die AWS IoT Greengrass Gruppe aktiviert. + Java 8 wurde auf dem Core-Gerät installiert und der `PATH` Umgebungsvariablen hinzugefügt. **Anmerkung** Dieser Connector 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 ------ ## Konnektor-Parameter Dieser Konnektor unterstützt die folgenden Parameter: `LocalStoragePath` Das Verzeichnis auf dem AWS IoT Greengrass Host, in das der SiteWise IoT-Connector persistente Daten schreiben kann. Das Standardverzeichnis ist `/var/sitewise`. Anzeigename in der AWS IoT Konsole: **Lokaler Speicherpfad** Erforderlich: `false` Typ: `string` Gültiges Muster: `^\s*$|\/.` `MaximumBufferSize` Die maximale Größe in GB für die Nutzung von SiteWise IoT-Festplatten. Die Standardgröße ist 10 GB. Anzeigename in der AWS IoT Konsole: **Maximale Festplattenpuffergröße** Erforderlich: `false` Typ: `string` Gültiges Muster: `^\s*$|[0-9]+` `CapabilityConfiguration` Der Satz von Modbus-TCP-Collector-Konfigurationen, von denen der Connector Daten sammelt und zu denen er eine Verbindung herstellt. Anzeigename in der AWS IoT Konsole: **CapabilityConfiguration** Erforderlich: `false` Typ: Eine wohlgeformte JSON-Zeichenfolge, die den Satz der unterstützten Feedback-Konfigurationen definiert. Es folgt ein Beispiel für `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 } } ] } ] } ``` ### Beispiel für einen Connector erstellen (AWS CLI) Der folgende CLI-Befehl erstellt einen `ConnectorDefinition` mit einer ersten Version, die den Modbus-TCP Protocol Adapter-Connector 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 Konnektor hat einen [langlebigen Lebenszyklus](lambda-functions.md#lambda-lifecycle). ## Eingabedaten Dieser Konnektor akzeptiert keine MQTT-Nachrichten als Eingabedaten. ## Ausgabedaten Dieser Konnektor veröffentlicht Daten für`StreamManager`. Sie müssen den Zielnachrichtenstream konfigurieren. Die Ausgabenachrichten haben die folgende Struktur: ``` { "alias": "string", "messages": [ { "name": "string", "value": boolean|double|integer|string, "timestamp": number, "quality": "string" } ] } ``` ## Lizenzen Der Modbus-TCP Protocol Adapter-Connector umfasst den folgenden Drittanbieter software/licensing: + [Digitaler Petri Modbus](https://github.com/digitalpetri/modbus) Dieser Connector ist im Rahmen der [Greengrass Core Software-Lizenzvereinbarung](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht. ## Änderungsprotokoll In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen des Connectors beschrieben. | Version | Änderungen | Date | | --- | --- | --- | | 3 (empfohlen) | Diese Version enthält Fehlerkorrekturen. | 22. Dezember 2021 | | 2 | Unterstützung für ASCII-, UTF8- und ISO8859-kodierte Quellzeichenfolgen hinzugefügt. | 24. Mai 2021 | | 1 | Erstversion. | 15. Dezember 2020 | Eine Greengrass-Gruppe kann jeweils nur eine Version des Connectors enthalten. Weitere Informationen zum Aktualisieren einer Konnektorversion finden Sie unter [Aktualisieren von Konnektorversionen](connectors.md#upgrade-connector-versions). ## Weitere Informationen finden Sie auch unter + [Integrieren von Services und Protokollen mit Greengrass-Konnektoren](connectors.md) + [Erste Schritte mit Greengrass-Konnektoren (Konsole)](connectors-console.md) + [Erste Schritte mit Greengrass-Konnektoren (CLI)](connectors-cli.md)