Usare iothub-explorer per inviare e ricevere messaggi tra il dispositivo e l'hub IoTUse iothub-explorer to send and receive messages between your device and IoT Hub

Diagramma end-to-end

Nota

Prima di iniziare questa esercitazione, configurare il dispositivo.Before you start this tutorial, set up your device. In questo articolo si configureranno il dispositivo e l'hub IoT di Azure e si distribuirà un'applicazione di esempio da eseguire nel dispositivo.In the article, you set up your Azure IoT device and IoT hub, and you deploy a sample application to run on your device. L'applicazione invia i dati del sensore raccolti all'hub IoT.The application sends collected sensor data to your IoT hub.

iothub-explorer include una gamma di comandi che semplificano la gestione dell'hub IoT.iothub-explorer has a handful of commands that makes IoT Hub management easier. Questa esercitazione approfondisce l'uso di iothub-explorer per inviare e ricevere messaggi tra il dispositivo e l'hub IoT.This tutorial focuses on how to use iothub-explorer to send and receive messages between your device and your IoT hub.

Contenuto dell'esercitazioneWhat you will learn

Informazioni su come usare iothub-explorer per monitorare i messaggi da dispositivo a cloud e inviare messaggi da cloud a dispositivo.You learn how to use iothub-explorer to monitor device-to-cloud messages and to send cloud-to-device messages. I messaggi da dispositivo a cloud possono includere dati di sensori raccolti dal dispositivo e inviati all'hub IoT.Device-to-cloud messages could be sensor data that your device collects and then sends to your IoT hub. I messaggi da cloud a dispositivo possono includere comandi inviati dall'hub IoT al dispositivo per far lampeggiare un LED connesso a quest'ultimo.Cloud-to-device messages could be commands that your IoT hub sends to your device to blink an LED that is connected to your device.

Contenuto dell'esercitazioneWhat you will do

  • Usare iothub-explorer per monitorare i messaggi da dispositivo a cloud.Use iothub-explorer to monitor device-to-cloud messages.
  • Usare iothub-explorer per inviare messaggi da cloud a dispositivo.Use iothub-explorer to send cloud-to-device messages.

Elementi necessariWhat you need

  • Completare l'esercitazione Configurare il dispositivo che prevede i requisiti seguenti:Tutorial Setup your device completed which covers the following requirements:
    • Una sottoscrizione di Azure attiva.An active Azure subscription.
    • Un hub IoT di Azure nella sottoscrizione.An Azure IoT hub under your subscription.
    • Un'applicazione client che invia messaggi ad Azure IoT hub.A client application that sends messages to your Azure IoT hub.
  • iothub-explorer.iothub-explorer. (Installare iothub-explorer)(Install iothub-explorer)

Monitorare i messaggi da dispositivo a cloudMonitor device-to-cloud messages

Per monitorare i messaggi inviati dal dispositivo all'hub IoT, seguire questi passaggi:To monitor messages that are sent from your device to your IoT hub, follow these steps:

  1. Aprire una finestra della console.Open a console window.
  2. Eseguire il comando seguente:Run the following command:

    iothub-explorer monitor-events <device-id> --login "<IoTHubConnectionString>"
    

    Nota

    Ottenere <device-id> e <IoTHubConnectionString> dall'hub IoT.Get <device-id> and <IoTHubConnectionString> from your IoT hub. Assicurarsi di aver terminato l'esercitazione precedente.Make sure you've finished the previous tutorial. In alternativa, è possibile provare a usare iothub-explorer monitor-events <device-id> --login "HostName=<my-hub>.azure-devices.net;SharedAccessKeyName=<my-policy>;SharedAccessKey=<my-policy-key>" se sono presenti HostName, SharedAccessKeyName e SharedAccessKey.Or you can try to use iothub-explorer monitor-events <device-id> --login "HostName=<my-hub>.azure-devices.net;SharedAccessKeyName=<my-policy>;SharedAccessKey=<my-policy-key>" if you have HostName, SharedAccessKeyName and SharedAccessKey.

Inviare messaggi da cloud a dispositivoSend cloud-to-device messages

Per inviare un messaggio dall'hub IoT al dispositivo, seguire questi passaggi:To send a message from your IoT hub to your device, follow these steps:

  1. Aprire una finestra della console.Open a console window.
  2. Avviare una sessione nell'hub IoT eseguendo il comando seguente:Start a session on your IoT hub by running the following command:

    iothub-explorer login `<IoTHubConnectionString>`
    
  3. Inviare un messaggio al dispositivo eseguendo il comando seguente:Send a message to your device by running the following command:

    iothub-explorer send <device-id> <message>
    

Il comando fa lampeggiare il LED di connessione al dispositivo e invia il messaggio a quest'ultimo.The command blinks the LED that is connected to your device and sends the message to your device.

Nota

Non è necessario che il dispositivo invii un comando ack separato in risposta all'hub IoT una volta ricevuto il messaggio.There is no need for the device to send a separate ack command back to your IoT hub upon receiving the message.

Passaggi successiviNext steps

È stato appreso come monitorare i messaggi da dispositivo a cloud e inviare messaggi da cloud a dispositivo tra il dispositivo IoT e l'hub IoT di Azure.You’ve learned how to monitor device-to-cloud messages and send cloud-to-device messages between your IoT device and Azure IoT Hub.

Per altre informazioni sulle attività iniziali con l'hub IoT di Azure e per esplorare altri scenari IoT, vedere:To continue to get started with Azure IoT Hub and to explore other IoT scenarios, see the following: