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.

Nota

Alcune delle funzionalità indicate in questo articolo, come la messaggistica da cloud a dispositivo, i dispositivi gemelli e la gestione dei dispositivi, sono disponibili solo nel livello Standard dell'hub IoT.Some of the features mentioned in this article, like cloud-to-device messaging, device twins, and device management, are only available in the standard tier of IoT hub. Per altre informazioni sui livelli Basic e Standard dell'hub IoT, vedere come scegliere il livello corretto dell'hub IoT.For more information about the basic and standard IoT Hub tiers, see How to choose the right IoT Hub tier.

Concetti legati all'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: