Connettere DevKit di IoT AZ3166 all'hub IoT di AzureConnect IoT DevKit AZ3166 to Azure IoT Hub

È possibile usare il DevKit di IoT MXChip per sviluppare e creare prototipi di soluzioni di Internet delle cose (IoT) che usano i servizi di Microsoft Azure.You can use the MXChip IoT DevKit to develop and prototype Internet of Things (IoT) solutions that take advantage of Microsoft Azure services. Il DevKit include una scheda compatibile con Arduino con periferiche e sensori avanzati, un pacchetto della scheda open source e un catalogo di progetti sempre in crescita.It includes an Arduino-compatible board with rich peripherals and sensors, an open-source board package, and a growing projects catalog.

Operazioni da fareWhat you do

Connettere il DevKit a un hub IoT di Azure creato, raccogliere i dati sulla temperatura e l'umidità rilevati dai sensori e inviarli all'hub IoT.Connect the DevKit to an Azure IoT hub that you create, collect the temperature and humidity data from sensors, and send the data to the IoT hub.

Non hai ancora DevKit?Don't have a DevKit yet? Provare il simulatore di DevKit o acquistare DevKit.Try the DevKit simulator or purchase a DevKit.

Contenuto dell'esercitazioneWhat you learn

  • Come connettere il DevKit di IoT al punto di accesso wireless e preparare l'ambiente di sviluppo.How to connect the IoT DevKit to a wireless access point and prepare your development environment.
  • Come creare un hub IoT e registrare un dispositivo per il DevKit di IoT MXChip.How to create an IoT hub and register a device for the MXChip IoT DevKit.
  • Come raccogliere i dati del sensore eseguendo un'applicazione di esempio nel DevKit di IoT MXChip.How to collect sensor data by running a sample application on the MXChip IoT DevKit.
  • Come inviare i dati del sensore all'hub IoT.How to send the sensor data to your IoT hub.

Elementi necessariWhat you need

Preparare l'hardwarePrepare your hardware

Collegare l'hardware seguente al computer:Hook up the following hardware to your computer:

  • Scheda DevKitDevKit board
  • Cavo USB microMicro-USB cable

Requisiti hardware

Per connettere il DevKit al computer, seguire questa procedura:To connect the DevKit to your computer, follow these steps:

  1. Collegare l'estremità USB al computer.Connect the USB end to your computer.

  2. Collegare l'estremità USB micro al DevKit.Connect the Micro-USB end to the DevKit.

  3. Il LED verde dell'alimentazione conferma la connessione.The green LED for power confirms the connection.

    Connessioni hardware

Configurazione Wi-FiConfigure Wi-Fi

I progetti IoT si basano sulla connettività Internet.IoT projects rely on internet connectivity. Usare le istruzioni seguenti per configurare il DevKit per la connessione al Wi-Fi.Use the following instructions to configure the DevKit to connect to Wi-Fi.

Passare alla modalità APEnter AP mode

Tenere premuto il pulsante B, premere e rilasciare il pulsante di reimpostazione e quindi rilasciare il pulsante B. Il DevKit passerà alla modalità AP per la configurazione del Wi-Fi.Hold down button B, push and release the reset button, and then release button B. Your DevKit enters AP mode for configuring Wi-Fi. La schermata visualizza l'identificatore SSID del DevKit e l'indirizzo IP del portale di configurazione.The screen displays the service set identifier (SSID) of the DevKit and the configuration portal IP address.

Pulsante di reimpostazione, pulsante B e SSID

Eseguire la connessione a DevKit APConnect to DevKit AP

Usare a questo punto un altro dispositivo abilitato per il Wi-Fi (computer o telefono cellulare) per connettersi al SSID del DevKit (evidenziato nell'immagine precedente).Now, use another Wi-Fi enabled device (computer or mobile phone) to connect to the DevKit SSID (highlighted in the previous image). Lasciare vuoto il campo della password.Leave the password empty.

Informazioni di rete e pulsante Connect

Configurare il Wi-Fi per il DevKitConfigure Wi-Fi for the DevKit

Aprire l'indirizzo IP mostrato nella schermata del DevKit nel browser del computer o del telefono cellulare, selezionare la rete Wi-Fi a cui si desidera connettere il DevKit e quindi digitare la password.Open the IP address shown on the DevKit screen on your computer or mobile phone browser, select the Wi-Fi network that you want the DevKit to connect to, and then type the password. Selezionare Connessione.Select Connect.

Campo della password e pulsante Connect (Connetti)

Dopo avere stabilito la connessione, il DevKit si riavvia in pochi secondi.When the connection succeeds, the DevKit reboots in a few seconds. Verranno visualizzati il nome della rete Wi-Fi e l'indirizzo IP:You then see the Wi-Fi name and IP address on the screen:

Nome della rete Wi-Fi e indirizzo IP

Nota

L'indirizzo IP visualizzato nella foto potrebbe non corrispondere all'indirizzo IP effettivo assegnato e visualizzato nella schermata di DevKit.The IP address displayed in the photo might not match the actual IP address assigned and displayed on the DevKit screen. Si tratta di un comportamento normale perché il Wi-Fi usa il protocollo DHCP che assegna gli indirizzi IP in modo dinamico.This is normal, because Wi-Fi uses DHCP to dynamically assign IPs.

Dopo che la configurazione del Wi-Fi è completata, le credenziali usate verranno mantenute nel dispositivo per tale connessione, anche se il dispositivo viene scollegato.After Wi-Fi is configured, your credentials will persist on the device for that connection, even if the device is unplugged. Se, ad esempio, si configura il DevKit per il Wi-Fi di casa e poi lo si sposta in ufficio, sarà necessario riconfigurare la modalità AP (a partire dal passaggio "Passare alla modalità AP") per connettere il DevKit alla rete Wi-Fi dell'ufficio.For example, if you configure the DevKit for Wi-Fi in your home and then take the DevKit to the office, you will need to reconfigure AP mode (starting at the step in the "Enter AP Mode" section) to connect the DevKit to your office Wi-Fi.

Iniziare a usare il DevKitStart using the DevKit

L'app predefinita in esecuzione nel DevKit controlla se è installata la versione più recente del firmware e visualizza alcuni dati di diagnostica dei sensori.The default app running on the DevKit checks the latest version of the firmware and displays some sensor diagnosis data for you.

Eseguire l'aggiornamento al firmware più recenteUpgrade to the latest firmware

Nota

A partire dalla versione 1.1 DevKit abilita ST-SAFE nel bootloader.Since v1.1, DevKit enables ST-SAFE in bootloader. È necessario eseguire l'aggiornamento del firmware se si esegue una versione precedente alla 1.1.You need to upgrade the firmware if you are running a version prior to v1.1.

Se è necessario aggiornare il firmware, la schermata visualizza la versione del firmware attualmente installata e quella più recente.If you need a firmware upgrade, the screen will show the current and latest firmware versions. Per eseguire l'aggiornamento, seguire le istruzioni nella guida Upgrade firmware (Aggiornare il firmware).To upgrade, follow the Upgrade firmware guide.

Visualizzazione delle versioni attuale e più recente del firmware

Nota

Questa operazione viene eseguita una sola volta.This is a one-time effort. Dopo avere iniziato a sviluppare nel DevKit e avere caricato l'app, il firmware più recente sarà presente nell'app.After you start developing on the DevKit and upload your app, the latest firmware will come with your app.

Testare i diversi sensoriTest various sensors

Premere il pulsante B per testare i sensori.Press button B to test the sensors. Continuare a premere e rilasciare il pulsante B per passare di sensore in sensore.Continue pressing and releasing the button B to cycle through each sensor.

Visualizzazione del pulsante B e del sensore

Preparare l'ambiente di sviluppoPrepare the development environment

Installare Workbench di Azure IoTInstall Azure IoT Workbench

Si consiglia di utilizzare l’estensione Workbench di Azure IoT per lo sviluppo di Visual Studio Code su DevKit.We recommend Azure IoT Workbench extension for Visual Studio Code to develop on the DevKit.

Workbench di Azure IoT offre un'esperienza integrata per lo sviluppo di soluzioni IoT.Azure IoT Workbench provides an integrated experience to develop IoT solutions. Contribuisce allo sviluppo sia suo dispositivi che su cloud utilizzando Azure IoT e altri servizi.It helps both on device and cloud development using Azure IoT and other services. È possibile guardare questo video di Channel9 per avere una panoramica delle funzionalità.You can watch this Channel9 video to have an overview of what it does.

Seguire questa procedura per preparare l'ambiente di sviluppo per DevKit:Follow these steps to prepare the development environment for DevKit:

  1. Scaricare e installare Arduino IDE.Download and install Arduino IDE. Fornisce la toolchain necessaria per la compilazione e il caricamento del codice Arduino.It provides the necessary toolchain for compiling and uploading Arduino code.

    • Windows: usare la versione di Windows Installer.Windows: Use Windows Installer version.
    • macOS: trascinare il file Arduino.app estratto nella cartella /Applications.macOS: Drag and drop the extracted Arduino.app into /Applications folder.
    • Ubuntu: decomprimere il file nella cartella come $HOME/Downloads/arduino-1.8.5Ubuntu: Unzip it into folder such as $HOME/Downloads/arduino-1.8.5
  2. Installare Visual Studio Code, un editor di codice sorgente multipiattaforma con potenti strumenti per gli sviluppatori, come il completamento e il debug del codice IntelliSense.Install Visual Studio Code, a cross platform source code editor with powerful developer tooling, like IntelliSense code completion and debugging.

  3. Cercare Workbench di Azure IoT nel marketplace delle estensioni e installarlo.Look for Azure IoT Workbench in the extension marketplace and install it. Installare Workbench di Azure IoT: insieme ad Azure IoT Workbench, verranno installati altre estensioni dipendenti.Install Azure IoT Workbench Together with the IoT Workbench, other dependent extensions will be installed.

  4. Aprire File > Preferenze > Impostazioni e aggiungere le righe successive per configurare Arduino.Open File > Preference > Settings and add following lines to configure Arduino.

    • Windows:Windows: javascript "arduino.path": "C:\\Program Files (x86)\\Arduino", "arduino.additionalUrls": "https://raw.githubusercontent.com/VSChina/azureiotdevkit_tools/master/package_azureboard_index.json"
    • macOS:macOS: javascript "arduino.path": "/Applications", "arduino.additionalUrls": "https://raw.githubusercontent.com/VSChina/azureiotdevkit_tools/master/package_azureboard_index.json"
    • Ubuntu:Ubuntu: javascript "arduino.path": "/home/{username}/Downloads/arduino-1.8.5", "arduino.additionalUrls": "https://raw.githubusercontent.com/VSChina/azureiotdevkit_tools/master/package_azureboard_index.json"
  5. Fare clic su F1 per aprire il riquadro comandi, digitare e selezionare Arduino: Board Manager (Arduino: Gestione lavagna).Click F1 to open the command palette, type and select Arduino: Board Manager. Cercare AZ3166 e installare la versione più recente.Search for AZ3166 and install the latest version. Installare l’SDK DevKitInstall DevKit SDK

ST-Link/V2 è l'interfaccia USB che IoT DevKit usa per comunicare con la macchina di sviluppo.ST-Link/V2 is the USB interface that IoT DevKit uses to communicate with your development machine. Seguire i passaggi specifici del sistema operativo per consentire alla macchina l'accesso al dispositivo.Follow the OS-specific steps to allow the machine access to your device.

  • Windows: scaricare e installare i driver USB dal sito Web STMicroelectronics.Windows: Download and install USB driver from STMicroelectronics website.
  • macOS: nessun driver necessario per macOS.macOS: No driver is required for macOS.
  • Ubuntu: eseguire il comando seguente nel terminale e disconnettersi e riconnettersi affinché la modifica di gruppo abbia effetto:Ubuntu: Run the following in terminal and logout and login for the group change to take effect:

    # Copy the default rules. This grants permission to the group 'plugdev'
    sudo cp ~/.arduino15/packages/AZ3166/tools/openocd/0.10.0/linux/contrib/60-openocd.rules /etc/udev/rules.d/
    sudo udevadm control --reload-rules
    
    # Add yourself to the group 'plugdev'
    # Logout and log back in for the group to take effect
    sudo usermod -a -G plugdev $(whoami)
    

A questo punto tutto pronto con la preparazione e la configurazione dell'ambiente di sviluppo.Now you are all set with preparing and configuring your development environment. Compiliamo l’esempio "Hello World" per IoT: inviamo i dati di telemetria della temperatura all'hub IoT di Azure.Let us build the “Hello World” sample for IoT: sending temperature telemetry data to Azure IoT Hub.

Creare il primo progettoBuild your first project

  1. Assicurarsi che il DevKit IoT non sia connesso al computer.Make sure your IoT DevKit is not connected to your computer. Avviare per prima cosa Visual Studio Code, quindi connettere il DevKit al computer.Start VS Code first, and then connect the DevKit to your computer.

  2. Nella barra di stato in basso a destra, verificare che MXCHIP AZ3166 sia visualizzato come scheda selezionata e che sia utilizzata la porta seriale con STMicroelectronics.In the bottom right status bar, check the MXCHIP AZ3166 is shown as selected board and serial port with STMicroelectronics is used. Selezionare lavagna e COMSelect board and COM

  3. Fare clic su F1 per aprire il riquadro comandi, digitare e selezionare IoT Workbench: Examples (Workbench IoT: Esempi).Click F1 to open the command palette, type and select IoT Workbench: Examples. Quindi selezionare IoT DevKit (DevKit di IoT) come lavagna.Then select IoT DevKit as board.

  4. Nella pagina di esempi di Workbench IoT, individuare Get Started(Introduzione) e fare clic su Open Sample (Apri esempio).In the IoT Workbench Examples page, find Get Started and click Open Sample. Selezionare quindi il percorso predefinito per scaricare il codice di esempio.Then selects the default path to download the sample code. Aprire esempioOpen sample

  5. Se l'estensione di Arduino non è installata in Visual Studio Code, fare clic su Installa nel riquadro di notifica.If you don't have Arduino extension in VS Code installed, click the Install in the notification pane. Installare l'estensione di ArduinoInstall Arduino Extension

  6. Nella nuova finestra del progetto aperta, fare clic su F1 per aprire il riquadro comandi, digitare e selezionare IoT Workbench: Cloud (Workbench IoT: cloud), quindi selezionare Azure Provision (Provisioning di Azure).In the new opened project window, click F1 to open the command palette, type and select IoT Workbench: Cloud, then select Azure Provision. Seguire la guida passo passo per completare il provisioning dell'hub IoT di Azure e creare il dispositivo.Follow the step by step guide to finish provisioning your Azure IoT Hub and creating the device. Provisioning cloudCloud provision

  7. Fare clic su F1 per aprire il riquadro comandi, digitare e selezionare IoT Workbench: Device (Workbench IoT: dispositivo), quindi selezionare Config Device Settings > Select IoT Hub Device Connection String (Configurare le impostazioni del dispositivo > Selezionare Stinga di connessione dispositivo hub IoT).Click F1 to open the command palette, type and select IoT Workbench: Device, then select Config Device Settings > Select IoT Hub Device Connection String.

  8. Su DevKit, tenere premuto il pulsante A, premere e rilasciare il pulsante di reimpostazione e quindi rilasciare il pulsante A. DevKit passa alla modalità di configurazione e salva la stringa di connessione.On DevKit, hold down button A, push and release the reset button, and then release button A. Your DevKit enters configuration mode and saves the connection string. Stringa di connessioneConnection string

  9. Fare clic di nuovo su F1, digitare e selezionare IoT Workbench: Device (Workbench IoT: dispositivo), quindi selezionare Device Upload (Caricamento dispositivo).Click F1 again, type and select IoT Workbench: Device, then select Device Upload. Caricamento di ArduinoArduino upload

Il DevKit viene riavviato e inizia a eseguire il codice.The DevKit reboots and starts running the code.

Nota

In caso di errori o interruzioni, è sempre possibile ripristinare il sistema eseguendo nuovamente il comando.If there is errors or interruptions, you can always recover by running the command again.

Verificare il progettoTest the project

Visualizzare i dati di telemetria inviati all'hub IoT di AzureView the telemetry sent to Azure IoT Hub

Fare clic sull'icona della spina di alimentazione sulla barra di stato per aprire il monitor seriale: Serial monitor (Monitor seriale)Click the power plug icon on the status bar to open the Serial Monitor: Serial monitor

L'applicazione di esempio viene eseguita correttamente quando vengono visualizzati i risultati seguenti:The sample application is running successfully when you see the following results:

  • Il monitor seriale mostra il messaggio inviato all'hub IoT.The Serial Monitor displays the message sent to the IoT Hub.
  • Il LED sul DevKit di IoT MXChip lampeggia.The LED on the MXChip IoT DevKit is blinking.

Output di monitoraggio seriale

Visualizzare i dati di telemetria ricevuti dall'hub IoT di AzureView the telemetry received by Azure IoT Hub

È possibile usare il Toolkit Azure IoT per il monitoraggio dei messaggi da dispositivo a cloud (D2C) nell'hob IoT.You can use Azure IoT Toolkit to monitor device-to-cloud (D2C) messages in IoT Hub.

  1. In Visual Studio Code, cercare Toolkit di Azure IoT nel marketplace delle estensioni e installarlo.In Visual Studio Code, look for Azure IoT Toolkit in the extension marketplace and install it.

  2. Accedere al portale di Azure e cercare l'IoT Hub creato.Log in Azure portal, find the IoT Hub you created. portale di AzureAzure portal

  3. Nel riquadro Criteri di accesso condivisi fare clic sul criterio iothubowner, quindi annotare la stringa di connessione dell'hub IoT.In the Shared access policies pane, click the iothubowner policy, and write down the Connection string of your IoT hub. Stringa di connessione dell'hub IoT di AzureAzure IoT Hub connection string

  4. In Visual Studio Code, espandere AZURE IOT HUB DEVICES (DISPOSITIVI HUB IOT AZURE) nell'angolo inferiore sinistro e fare clic su Set IoT Hub Connection String (Imposta stringa di connessione hub IoT).In Visual Studio Code, expand AZURE IOT HUB DEVICES on the bottom left corner, click Set IoT Hub Connection String. Imposta stringa di connessione hub IoT di AzureSet Azure IoT Hub connection string

  5. Fare clic su IoT: Start monitoring D2C message (IoT: Avvia monitoraggio messaggio da dispositivo a cloud) nel menu di scelta rapida.Click IoT: Start monitoring D2C message in context menu.

  6. Nel riquadro OUTPUT è possibile visualizzare i messaggi da dispositivo a cloud in ingresso nell'hub IoT.In OUTPUT pane, you can see the incoming D2C messages to the IoT Hub. Messaggi da dispositivo a cloudD2C message

Problemi e commentiProblems and feedback

Se si riscontrano problemi, è possibile cercare una soluzione nelle domande frequenti di IoT DevKit o prendere contatto con noi tramite Gitter.If you encounter problems, you can check for a solution in the IoT DevKit FAQ or reach out to us from Gitter. È possibile anche possibile lasciare commenti e suggerimenti personali in questa pagina.You can also give us feedback by leaving a comment on this page.

Passaggi successiviNext steps

La scheda DevKit di IoT MXChip è stata a questo punto connessa all'hub IoT e i dati acquisiti dai sensori sono stati inviati all'hub IoT.You have successfully connected an MXChip IoT DevKit to your IoT hub, and you have sent the captured sensor data to your IoT hub.

To continue to get started with Azure IoT Hub and to explore other IoT scenarios using IoT DevKit, see the following: