Connettere Adafruit Feather HUZZAH ESP8266 ad Azure IoT Hub nel cloudConnect Adafruit Feather HUZZAH ESP8266 to Azure IoT Hub in the cloud

Connessione tra DHT22, Feather HUZZAH ESP8266 e l'hub IoT

Operazioni da fareWhat you do

Connettere Adafruit Feather HUZZAH ESP8266 a un hub IoT che è stato creato.Connect Adafruit Feather HUZZAH ESP8266 to an IoT hub that you create. Eseguire un'applicazione di esempio in ESP8266 per raccogliere dati di temperatura e umidità da un sensore DHT22.Then you run a sample application on ESP8266 to collect the temperature and humidity data from a DHT22 sensor. Infine inviare i dati del sensore all'hub IoT.Finally, you send the sensor data to your IoT hub.

Nota

Se si usano altre schede ESP8266, è comunque possibile seguire questa procedura per connetterle all'hub IoT.If you're using other ESP8266 boards, you can still follow these steps to connect it to your IoT hub. A seconda della scheda ESP8266 usata, potrebbe essere necessario riconfigurare il LED_PIN.Depending on the ESP8266 board you're using, you might need to reconfigure the LED_PIN. Ad esempio se si usa ESP8266 di AI-Thinker, è possibile modificarne l'impostazione da 0 a 2.For example, if you're using ESP8266 from AI-Thinker, you might change it from 0 to 2. Se non si ha ancora un kit,Don't have a kit yet? è possibile ottenerlo nel sito Web Azure.Get it from the Azure website.

Contenuto dell'esercitazioneWhat you learn

  • Come creare un hub IoT e registrare un dispositivo per Feather HUZZAH ESP8266How to create an IoT hub and register a device for Feather HUZZAH ESP8266
  • Come connettere Feather HUZZAH ESP8266 al sensore e al computerHow to connect Feather HUZZAH ESP8266 with the sensor and your computer
  • Come raccogliere i dati del sensore eseguendo un'applicazione di esempio in Feather HUZZAH ESP8266How to collect sensor data by running a sample application on Feather HUZZAH ESP8266
  • Come inviare i dati del sensore all'hub IoTHow to send the sensor data to your IoT hub

Elementi necessariWhat you need

Componenti necessari per l'esercitazione

Per completare questa operazione è necessario disporre dei componenti seguenti di Feather HUZZAH ESP8266 Starter Kit:To complete this operation, you need the following parts from your Feather HUZZAH ESP8266 Starter Kit:

  • Scheda Feather HUZZAH ESP8266The Feather HUZZAH ESP8266 board
  • Cavo USB Micro/tipo AA Micro USB to Type A USB cable

Per l'ambiente di sviluppo sono necessari anche gli elementi seguenti:You also need the following things for your development environment:

Nota

Per l'IDE Arduino usato dall'estensione di Visual Studio Code per Arduino è richiesta la versione 1.6.8 o successiva.The Arduino IDE version used by Visual Studio Code extension for Arduino has to be version 1.6.8 or later. Le versioni precedenti non funzionano con la libreria AzureIoT.Earlier versions don't work with the AzureIoT library.

Gli elementi seguenti sono facoltativi nel caso in cui non si disponga di un sensore.The following items are optional in case you don’t have a sensor. È possibile anche usare dati di sensori simulati.You also have the option of using simulated sensor data.

  • Sensore di temperatura e umidità Adafruit DHT22An Adafruit DHT22 temperature and humidity sensor
  • Basetta sperimentaleA breadboard
  • Cavi ponticello M/MM/M jumper wires

Creare un hub IoTCreate an IoT hub

  1. Accedere al portale di Azure.Sign in to the Azure portal.
  2. Selezionare Crea una risorsa > Internet delle cose > Hub IoT.Select Create a resource > Internet of Things > IoT Hub.

    Screenshot del passaggio a Hub IoT nel portale di Azure

  3. Nel riquadro Hub IoT immettere le informazioni seguenti per l'hub IoT:In the IoT hub pane, enter the following information for your IoT hub:

    • Sottoscrizione: scegliere la sottoscrizione da usare per creare questo hub IoT.Subscription: Choose the subscription that you want to use to create this IoT hub.

    • Gruppo di risorse: creare un gruppo di risorse per ospitare l'hub IoT o usarne uno esistente.Resource group: Create a resource group to host the IoT hub or use an existing one. Per altre informazioni, vedere l'articolo su come usare i gruppi di risorse per gestire le risorse di Azure.For more information, see Use resource groups to manage your Azure resources.

    • Area: selezionare la località più vicina.Region: Select the closest location to you.

    • Nome: creare un nome per l'hub IoT.Name: Create a name for your IoT hub. Se il nome immesso è disponibile, viene visualizzato un segno di spunta verde.If the name you enter is available, a green check mark appears.

    Importante

    L'hub IoT sarà individuabile pubblicamente come endpoint DNS, quindi evitare di indicare informazioni riservate nell'assegnazione del nome.The IoT hub will be publicly discoverable as a DNS endpoint, so make sure to avoid any sensitive information while naming it.

    Finestra delle informazioni di base hub IoT

  4. Selezionare Next: Size and scale (Avanti: Dimensioni e scalabilità) per continuare a creare l'hub IoT.Select Next: Size and scale to continue creating your IoT hub.

  5. Scegliere un valore per Piano tariffario e livello di scalabilità.Choose your Pricing and scale tier. Per questo articolo selezionare il livello F1 - Gratuito se ancora disponibile nella sottoscrizione.For this article, select the F1 - Free tier if it's still available on your subscription. Per altre informazioni, vedere la pagina relativa a piano tariffario e livello di scalabilità.For more information, see the Pricing and scale tier.

    Finestra per specificare dimensioni e scalabilità dell'hub IoT

  6. Selezionare Rivedi e crea.Select Review + create.

  7. Esaminare le informazioni sull'hub IoT e quindi fare clic su Crea.Review your IoT hub information, then click Create. La creazione dell'hub IoT può richiedere alcuni minuti.Your IoT hub might take a few minutes to create. È possibile monitorare lo stato di avanzamento nel riquadro Notifiche.You can monitor the progress in the Notifications pane.

Ora che è stato creato un hub IoT, individuare le informazioni importanti che consentono di connettere dispositivi e applicazioni all'hub IoT.Now that you have created an IoT hub, locate the important information that you use to connect devices and applications to your IoT hub.

Nel menu di spostamento dell'hub IoT, aprire i criteri di accesso condiviso.In your IoT hub navigation menu, open Shared access policies. Selezionare il criterio iothubowner, quindi copiare la stringa di connessione---chiave primaria dell'hub IoT.Select the iothubowner policy, and then copy the Connection string---primary key of your IoT hub. Per altre informazioni, vedere Controllare l'accesso all'hub IoT.For more information, see Control access to IoT Hub.

Nota

Per questa esercitazione di configurazione non è necessaria la stringa di connessione iothubowner.You do not need this iothubowner connection string for this set-up tutorial. Potrebbe essere tuttavia necessaria per alcune delle esercitazioni o per altri scenari IoT, dopo aver completato questa configurazione.However, you may need it for some of the tutorials or different IoT scenarios after you complete this set-up.

Ottenere la stringa di connessione dell'hub IoT

Registrare un dispositivo nell'hub IoT per il dispositivoRegister a device in the IoT hub for your device

  1. Nel menu di spostamento dell'hub IoT, aprire Dispositivi IoT, quindi fare clic su Aggiungi per registrare un dispositivo nell'hub IoT.In your IoT hub navigation menu, open IoT devices, then click Add to register a device in your IoT hub.

    Aggiungere un dispositivo a Dispositivi IoT nell'hub IoT

  2. Immettere un ID dispositivo per il nuovo dispositivo.Enter a Device ID for the new device. Gli ID dispositivo fanno distinzione tra maiuscole e minuscole.Device IDs are case sensitive.

    Importante

    L'ID dispositivo può essere visibile nei log raccolti per il supporto tecnico e la risoluzione dei problemi, quindi evitare di indicare informazioni riservate nell'assegnazione del nome.The device ID may be visible in the logs collected for customer support and troubleshooting, so make sure to avoid any sensitive information while naming it.

  3. Fare clic su Save.Click Save.

  4. Dopo la creazione del dispositivo, aprirlo nel riquadro Dispositivi IoT.After the device is created, open the device from the list in the IoT devices pane.
  5. Copiare il valore di Stringa di connessione---Chiave primaria dell'hub IoT per usarlo in seguito.Copy the Connection string---primary key to use later.

    Ottenere la stringa di connessione del dispositivo

Connettere Feather HUZZAH ESP8266 con il sensore e il computerConnect Feather HUZZAH ESP8266 with the sensor and your computer

In questa sezione si connettono i sensori alla scheda.In this section, you connect the sensors to your board. Quindi si collega il dispositivo al computer per poterlo usare.Then you plug in your device to your computer for further use.

Connettere un sensore di temperatura e umidità DHT22 a Feather HUZZAH ESP8266Connect a DHT22 temperature and humidity sensor to Feather HUZZAH ESP8266

Usare la basetta sperimentale e i cavi ponticello per stabilire la connessione come indicato di seguito.Use the breadboard and jumper wires to make the connection as follows. Se non si dispone di un sensore, ignorare questa sezione in quanto è possibile usare i dati di sensori simulati.If you don’t have a sensor, skip this section because you can use simulated sensor data instead.

Riferimento per le connessioni

Per i pin dei sensori usare i collegamenti seguenti:For sensor pins, use the following wiring:

Inizio (sensore)Start (Sensor) Fine (scheda)End (Board) Colore del cavoCable Color
VDD (Pin 31F)VDD (Pin 31F) 3V (Pin 58H)3V (Pin 58H) Cavo rossoRed cable
DATI (Pin 32F)DATA (Pin 32F) GPIO 2 (Pin 46A)GPIO 2 (Pin 46A) Cavo bluBlue cable
GND (Pin 34F)GND (Pin 34F) GND (PIn 56I)GND (PIn 56I) Cavo neroBlack cable

Per altre informazioni, vedere la configurazione del sensore Adafruit DHT22 e la piedinatura di Adafruit Feather HUZZAH Esp8266.For more information, see Adafruit DHT22 sensor setup and Adafruit Feather HUZZAH Esp8266 Pinouts.

Ora Feather Huzzah ESP8266 è connesso con un sensore funzionante.Now your Feather Huzzah ESP8266 should be connected with a working sensor.

Connettere DHT22 a Feather HUZZAH

Connettere Feather HUZZAH ESP8266 al computerConnect Feather HUZZAH ESP8266 to your computer

Usare il cavo USB Micro/tipo A per connettere Feather HUZZAH ESP8266 al computer.As shown next, use the Micro USB to Type A USB cable to connect Feather HUZZAH ESP8266 to your computer.

Connettere Feather HUZZAH al computer

Aggiungere le autorizzazioni per la porta seriale (solo Ubuntu)Add serial port permissions (Ubuntu only)

Se si usa Ubuntu, assicurarsi di avere le autorizzazioni per operare sulla porta USB di Feather HUZZAH ESP8266.If you use Ubuntu, make sure you have the permissions to operate on the USB port of Feather HUZZAH ESP8266. Per aggiungere autorizzazioni sulla porta seriale, seguire questi passaggi:To add serial port permissions, follow these steps:

  1. Eseguire i comandi seguenti in un terminale:Run the following commands at a terminal:

    ls -l /dev/ttyUSB*
    ls -l /dev/ttyACM*
    

    Si ottiene uno degli output seguenti:You get one of the following outputs:

    • crw-rw---- 1 root uucp xxxxxxxxcrw-rw---- 1 root uucp xxxxxxxx
    • crw-rw---- 1 root dialout xxxxxxxxcrw-rw---- 1 root dialout xxxxxxxx

    Nell'output osservare che uucp o dialout è il nome del proprietario del gruppo della porta USB.In the output, notice that uucp or dialout is the group owner name of the USB port.

  2. Aggiungere l'utente al gruppo eseguendo il comando seguente:Add the user to the group by running the following command:

    sudo usermod -a -G <group-owner-name> <username>
    

    <group-owner-name> è il nome del proprietario gruppo ottenuto nel passaggio precedente.<group-owner-name> is the group owner name you obtained in the previous step. <username> è il nome utente di Ubuntu.<username> is your Ubuntu user name.

  3. Disconnettere Ubuntu, quindi accedere di nuovo per visualizzare la modifica.Sign out of Ubuntu, and then sign in again for the change to appear.

Raccogliere i dati del sensore e inviarli all'hub IoTCollect sensor data and send it to your IoT hub

In questa sezione si distribuisce un'applicazione di esempio in Feather HUZZAH ESP8266.In this section, you deploy and run a sample application on Feather HUZZAH ESP8266. L'applicazione di esempio fa lampeggiare il LED sulla scheda Feather HUZZAH ESP8266 e invia i dati di temperatura e umidità raccolti dal sensore DHT22 all'hub IoT.The sample application blinks the LED on Feather HUZZAH ESP8266, and sends the temperature and humidity data collected from the DHT22 sensor to your IoT hub.

Ottenere l'applicazione di esempio da GithubGet the sample application from GitHub

L'applicazione di esempio è ospitata in GitHub.The sample application is hosted on GitHub. Clonare il repository di esempio che contiene l'applicazione di esempio da GitHub.Clone the sample repository that contains the sample application from GitHub. Per clonare il repository di esempio, seguire questi passaggi:To clone the sample repository, follow these steps:

  1. Aprire un prompt dei comandi o una finestra del terminale.Open a command prompt or a terminal window.
  2. Passare alla cartella in cui archiviare l'applicazione di esempio.Go to a folder where you want the sample application to be stored.
  3. Eseguire il comando seguente:Run the following command:

    git clone https://github.com/Azure-Samples/iot-hub-feather-huzzah-client-app.git
    

Installare il pacchetto per Feather HUZZAH ESP8266 in Visual Studio Code:Install the package for Feather HUZZAH ESP8266 in the Visual Studio Code:

  1. Aprire la cartella in cui è archiviata l'applicazione di esempio.Open the folder where the sample application is stored.
  2. Aprire il file app.ino nella cartella dell'app in Visual Studio Code.Open the app.ino file in the app folder in the Visual Studio Code.

    Aprire l'applicazione di esempio in Visual Studio Code

  3. In Visual Studio Code immettere F1.In the Visual Studio Code, enter F1.

  4. Digitare Arduino e selezionare Arduino: Board Manager.Type Arduino and select Arduino: Board Manager.
  5. Nella scheda Arduino Board Manager fare clic su Additional URLs (Altri URL).In the Arduino Board Manager tab, click Additional URLs.

    Arduino Board Manager di Visual Studio Code

  6. Nella finestra User Settings (Impostazioni utente) copiare e incollare il codice seguente alla fine del file.In the User Settings window, copy and paste the following at the end of the file

    "arduino.additionalUrls": "http://arduino.esp8266.com/stable/package_esp8266com_index.json"

    Configurare l'URL del pacchetto Arduino in Visual Studio Code

  7. Salvare il file e chiudere la scheda User Settings (Impostazioni utente).Save the file and close the User Settings tab.

  8. Fare clic su Refresh Package Indexes (Aggiorna indici di pacchetto).Click Refresh Package Indexes. Al termine dell'aggiornamento, cercare esp8266.After the refresh finishes, search for esp8266.
  9. Fare clic sul pulsante Install (Installa) per esp8266.Click Install button for esp8266.

    Boards Manager indica che è installata ESP8266 con una versione 2.2.0 o successiva.Boards Manager indicates that ESP8266 with a version of 2.2.0 or later is installed.

    Il pacchetto esp8266 è installato

  10. Immettere F1 e quindi digitare Arduino e selezionare Arduino: Board Config (Arduino: Configurazione scheda).Enter F1, then type Arduino and select Arduino: Board Config.

  11. Fare clic sulla casella accanto a Selected Board (Scheda selezionata), digitare esp8266 e quindi selezionare Adafruit HUZZAH ESP8266 (esp8266).Click box for Selected Board: and type esp8266, then select Adafruit HUZZAH ESP8266 (esp8266).

    Selezionare la scheda esp8266

Installare le librerie necessarieInstall necessary libraries

  1. In Visual Studio Code immettere F1 e quindi digitare Arduino e selezionare Arduino: Library Manager.In the Visual Studio Code, enter F1, then type Arduino and select Arduino: Library Manager.
  2. Cercare i seguenti nomi di libreria uno alla volta.Search for the following library names one by one. Per ogni libreria trovata fare clic su Install (Installa).For each library that you find, click Install.
    • AzureIoTHub
    • AzureIoTUtility
    • AzureIoTProtocol_MQTT
    • ArduinoJson
    • DHT sensor library
    • Adafruit Unified Sensor

Non si dispone di un sensore DHT22 reale?Don’t have a real DHT22 sensor?

L'applicazione di esempio consente di simulare i dati di temperatura e umidità nel caso non si disponga di un sensore DHT22 reale.The sample application can simulate temperature and humidity data in case you don’t have a real DHT22 sensor. Per abilitare l'applicazione di esempio all'uso di dati simulati, seguire questa procedura:To set up the sample application to use simulated data, follow these steps:

  1. Aprire il file config.h nella cartella app.Open the config.h file in the app folder.
  2. Individuare la seguente riga di codice e modificare il valore da false a true:Locate the following line of code and change the value from false to true:

    define SIMULATED_DATA true
    

    Configurare l'applicazione di esempio per l'uso di dati simulati

  3. Salvare il file.Save the file.

Distribuire l'applicazione di esempio in Feather HUZZAH ESP8266Deploy the sample application to Feather HUZZAH ESP8266

  1. In Visual Studio Code fare clic su sulla barra di stato e quindi sulla porta seriale per Feather HUZZAH ESP8266.In the Visual Studio Code, click on the status bar, and then click the serial port for Feather HUZZAH ESP8266.
  2. Immettere F1 e quindi digitare Arduino e selezionare Arduino: Upload per creare e distribuire l'applicazione di esempio in Feather HUZZAH ESP8266.Enter F1, then type Arduino and select Arduino: Upload to build and deploy the sample application to Feather HUZZAH ESP8266.

Immettere le credenzialiEnter your credentials

Una volta completato l'upload, seguire questa procedura per immettere le credenziali:After the upload completes successfully, follow these steps to enter your credentials:

  1. Aprire l'IDE di Arduino e fare clic su Tools > Serial Monitor (Strumenti, Monitoraggio seriale).Open Arduino IDE, click Tools > Serial Monitor.
  2. Nella finestra del monitoraggio seriale notare i due elenchi a discesa nell'angolo inferiore destro.In the serial monitor window, notice the two drop-down lists in the lower-right corner.
  3. Selezionare No line ending (Senza terminazione di riga) per la casella di riepilogo a discesa a sinistra.Select No line ending for the left drop-down list.
  4. Selezionare 115200 baud per la casella di riepilogo a discesa a destra.Select 115200 baud for the right drop-down list.
  5. Nella casella di input nella parte superiore della finestra del monitoraggio seriale immettere le informazioni seguenti, se viene richiesto di fornirle, e quindi fare clic su Invia.In the input box located at the top of the serial monitor window, enter the following information if you are asked to provide them, and then click Send.
    • Wi-Fi SSIDWi-Fi SSID
    • Password Wi-FiWi-Fi password
    • Stringa di connessione del dispositivoDevice connection string

Nota

Le informazioni sulle credenziali sono archiviate in EEPROM di Feather HUZZAH ESP8266.The credential information is stored in the EEPROM of Feather HUZZAH ESP8266. Se si fa clic sul pulsante di reset della scheda Feather HUZZAH ESP8266, l'applicazione di esempio chiede se si vuole cancellare le informazioni.If you click the reset button on the Feather HUZZAH ESP8266 board, the sample application asks if you want to erase the information. Immettere Y per cancellare le informazioni.Enter Y to have the information erased. Viene chiesto di specificare nuovamente le informazioni.You are asked to provide the information a second time.

Verificare che l'applicazione di esempio venga eseguita correttamenteVerify the sample application is running successfully

Se si vede il seguente output dalla finestra di monitoraggio seriale e il LED di Feather HUZZAH ESP8266 lampeggia, significa che l'applicazione di esempio si esegue correttamente.If you see the following output from the serial monitor window and the blinking LED on Feather HUZZAH ESP8266, the sample application is running successfully.

Output finale nell'IDE Arduino

Passaggi successiviNext steps

La scheda Feather HUZZAH ESP8266 è stata connessa all'hub IoT e i dati acquisiti dal sensore sono stati inviati all'hub IoT.You have successfully connected a Feather HUZZAH ESP8266 to your IoT hub, and sent the captured sensor data to your 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: