Connettere dispositivi Modbus TCP tramite un dispositivo gateway IoT Edge

Si applica a: IoT Edge 1.4

Se si vogliono connettere dispositivi IoT che usano protocolli Modbus TCP o RTU a un hub IoT di Azure, è possibile usare un dispositivo IoT Edge come gateway. Il dispositivo gateway legge i dati dai dispositivi Modbus, quindi li comunica al cloud usando un protocollo supportato.

Questo articolo descrive come creare un'immagine del contenitore personalizzata per un modulo Modbus (è anche possibile usare un esempio predefinito) e quindi distribuirla nel dispositivo IoT Edge che fungerà da gateway.

Questo articolo presuppone l'uso del protocollo Modbus TCP. Per altre informazioni su come configurare il modulo per supportare il protocollo Modbus RTU, vedere il progetto Azure IoT Edge Modbus module (Modulo Modbus per Azure IoT Edge) in GitHub.

Prerequisiti

• Un dispositivo Azure IoT Edge. Per una procedura dettagliata su come configurarne uno, vedere Distribuire Azure IoT Edge in Windows o Linux.
• La chiave primaria della stringa di connessione del dispositivo IoT Edge.
• Un dispositivo Modbus fisico o simulato che supporta il protocollo Modbus TCP. Sarà necessario conoscerne l'indirizzo IPv4.

Preparare un contenitore Modbus

Se si vuole testare la funzionalità del gateway Modbus, Microsoft offre un modulo di esempio che può essere usato a questo scopo. È possibile accedere al modulo da Azure Marketplace, Modbus o con l'URI dell'immagine, mcr.microsoft.com/azureiotedge/modbus:1.0.

Se si vuole creare un modulo e quindi personalizzarlo per l'ambiente, è disponibile un modulo Modbus per Azure IoT Edge open source in GitHub. Seguire le indicazioni nel progetto per creare l'immagine del contenitore personalizzata. Per creare un'immagine del contenitore, vedere Sviluppare moduli C# in Visual Studio o Sviluppare moduli Azure IoT Edge con Visual Studio Code. Questi articoli forniscono istruzioni sulla creazione di nuovi moduli e sulla pubblicazione di immagini del contenitore in un registro.

Provare la soluzione

Questa sezione illustra la distribuzione del modulo Modbus di esempio di Microsoft nel dispositivo IoT Edge.

1. Nel portale di Azure passare all'hub IoT.

2. Passare a Dispositivi e selezionare il dispositivo IoT Edge.

3. Selezionare Imposta moduli.

4. Nella sezione moduli IoT Edge aggiungere il modulo Modbus:

   1. Selezionare l'elenco a discesa Aggiungi e selezionare Modulo marketplace.
   2. Cercare Modbus e selezionare il modulo TCP modbus da Microsoft.
   3. Il modulo viene configurato automaticamente per l'hub IoT e viene visualizzato nell'elenco dei moduli IoT Edge. Anche le route vengono configurate automaticamente. Selezionare Rivedi e crea.
   4. Esaminare il manifesto della distribuzione e selezionare Crea.

5. Selezionare il modulo Modbus, ModbusTCPModule, nell'elenco e selezionare la scheda Impostazioni modulo gemello. Il codice JSON necessario per le proprietà desiderate del modulo gemello viene popolato automaticamente.

6. Cercare la proprietà SlaveConnection nel codice JSON e impostarne il valore sull'indirizzo IPv4 del dispositivo Modbus.

7. Selezionare Aggiorna.

8. Selezionare Rivedi e crea, esaminare la distribuzione e quindi selezionare Crea.

9. Tornare alla pagina dei dettagli del dispositivo e selezionare Aggiorna. Verrà visualizzato il nuovo modulo ModbusTCPModule in esecuzione insieme al runtime di IoT Edge.

Visualizzare i dati

Visualizzare i dati che passano attraverso il modulo modbus:

iotedge logs modbus

È anche possibile visualizzare i dati di telemetria inviati dal dispositivo usando l'estensione hub IoT di Azure per Visual Studio Code (in precedenza estensione toolkit Azure IoT).

Passaggi successivi

• Per altre informazioni sul modo in cui i dispositivi IoT Edge possono operare come gateway, vedere Creare un dispositivo IoT Edge come gateway trasparente.
• Per altre informazioni sul funzionamento dei moduli IoT Edge, vedere Informazioni sui moduli Azure IoT Edge