Freigeben über

Verbinden von ModBus-TCP-Geräten über ein IoT Edge-Gerätegateway

  • Artikel

Gilt für:IoT Edge 1.4 Häkchen IoT Edge 1.4

Wichtig

IoT Edge 1.5 LTS und IoT Edge 1.4 sind unterstützte Releases. Wenn Sie ein früheres Release verwenden, finden Sie weitere Informationen unter Aktualisieren von IoT Edge.

Wenn Sie IoT-Geräte, für die ModBus-TCP- oder -RTU-Protokolle genutzt werden, mit einem Azure IoT Hub verbinden möchten, können Sie ein IoT Edge-Gerät als Gateway einsetzen. Das Gatewaygerät liest Daten von Ihren ModBus-Geräten und kommuniziert sie dann über ein unterstütztes Protokoll weiter an die Cloud.

Screenshot: Modbus-Geräte, die über das IoT Edge-Gateway mit dem IoT Hub verbunden sind.

In diesem Artikel wird beschrieben, wie Sie Ihr eigenes Containerimage für ein ModBus-Modul erstellen (Sie können auch ein vorgefertigtes Beispiel verwenden) und dann auf dem IoT Edge-Gerät bereitstellen, das als Ihr Gateway fungiert.

In diesem Artikel wird davon ausgegangen, dass Sie das ModBus-TCP-Protokoll verwenden. Weitere Informationen zur Konfiguration des Moduls zur Unterstützung von ModBus-RTU finden Sie im Projekt ModBus-Modul für Azure IoT Edge auf GitHub.

Voraussetzungen

  • Ein Azure IoT Edge-Gerät. Eine exemplarische Vorgehensweise zur Einrichtung finden Sie unter Bereitstellen von Azure IoT Edge unter Windows oder Linux.
  • Die Verbindungszeichenfolge des primären Schlüssels für das IoT Edge-Gerät
  • Ein physisches oder simuliertes ModBus-Gerät, das ModBus-TCP unterstützt. Sie müssen dessen IPv4-Adresse kennen.

Vorbereiten eines ModBus-Containers

Wenn Sie die Funktionalität des ModBus-Gateways testen möchten, können Sie ein von Microsoft bereitgestelltes Beispielmodul verwenden. Sie können auf das Modul über den Azure Marketplace, Modbus oder mit dem Image-URI, mcr.microsoft.com/azureiotedge/modbus:1.0, zugreifen.

Hinweis

Das Modul Module Wurde am 11. Oktober 2023 archiviert. Sie ist jetzt schreibgeschützt.

Falls Sie Ihr eigenes Modul erstellen und für Ihre Umgebung anpassen möchten, können Sie das Open-Source-Projekt Azure IoT Edge Modbus module (ModBus-Modul für Azure IoT Edge) auf GitHub nutzen. Befolgen Sie die Anweisungen in diesem Projekt, um Ihr eigenes Containerimage zu erstellen. Lesen Sie Entwickeln von C#-Modulen in Visual Studio oder Entwickeln von Azure IoT Edge-Modulen in Visual Studio Code, um ein Containerimage zu erstellen. Diese Artikel bieten Anweisungen zum Erstellen neuer Module und zum Veröffentlichen von Containerimages in einer Registrierung.

Testen der Lösung

Dieser Abschnitt führt Sie durch die Bereitstellung des Modbus-Beispielmoduls von Microsoft auf Ihrem IoT Edge-Gerät.

  1. Navigieren Sie im Azure-Portal zu Ihrem IoT Hub.

  2. Wechseln Sie zu Geräte und wählen Sie Ihr IoT Edge-Gerät aus.

  3. Wählen Sie Module festlegen aus.

  4. Fügen Sie im Abschnitt IoT Edge-Module das Modbus-Modul hinzu:

    1. Wählen Sie das Dropdownfeld Hinzufügen, und wählen Sie Marketplace-Modul aus.
    2. Suchen Sie nach Modbus, und wählen Sie das Modbus-TCP-Modul von Microsoft aus.
    3. Das Modul wird für Ihren IoT Hub automatisch konfiguriert und in der Liste der IoT Edge-Module angezeigt. Die Routen werden ebenfalls automatisch konfiguriert. Klicken Sie auf Überprüfen + erstellen.
    4. Überprüfen Sie das Bereitstellungsmanifest, und wählen Sie Erstellen aus.

  5. Wählen Sie in der Liste das Modbus-Modul, ModbusTCPModule, und dann die Registerkarte Einstellungen für Modulzwilling aus. Der erforderliche JSON-Code für die gewünschten Eigenschaften des Modulzwillings wird automatisch aufgefüllt.

  6. Suchen Sie im JSON-Code nach der Eigenschaft SlaveConnection, und legen Sie deren Wert auf die IPv4-Adresse Ihres Modbus-Geräts fest.

  7. Wählen Sie Aktualisieren.

  8. Wählen Sie Überprüfen + erstellen aus, überprüfen Sie die Bereitstellung, und wählen Sie Erstellen aus.

  9. Kehren Sie zur Seite mit Gerätedetails zurück, und wählen Sie Aktualisieren aus. Das neue Modul ModbusTCPModule sollte nun zusammen mit der IoT Edge-Runtime ausgeführt werden.

Anzeigen von Daten

Zeigen Sie die Daten an, die über das ModBus-Modul eingehen:

iotedge logs modbus

Sie können die vom Gerät gesendeten Telemetriedaten auch anzeigen, indem Sie die Azure IoT Hub-Erweiterung für Visual Studio Code (früher: Azure IoT Toolkit-Erweiterung) verwenden.

Nächste Schritte