Connettere DevKit di IoT AZ3166 all'hub IoT di Azure nel cloudConnect IoT DevKit AZ3166 to Azure IoT Hub in the cloud

È 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 DevKit o ottenerne uno.Try DevKit simulator or get one.

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 al computer.Hook up the hardware to your computer.

Sono necessari i componenti hardware seguenti:You need this hardware:

  • Scheda DevKitDevKit board
  • Cavo USB microMicro-USB cable

Requisiti hardware

Per connettere il DevKit al computer:To connect the DevKit to your computer:

  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. Per garantirne il corretto funzionamento, è necessario aggiornare il firmware in caso di esecuzione della versione 1.1.You need to upgrade firmware if you are running under v1.1 in order to make it work probably.

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 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

Ora è possibile configurare l'ambiente di sviluppo: strumenti e pacchetti per compilare straordinarie applicazioni IoT.Now it's time to set up the development environment: tools and packages for you to build stunning IoT applications. È possibile scegliere la versione per Windows o macOS in base al sistema operativo in uso.You can choose the Windows or macOS version according to your operating system.

WindowsWindows

Si consiglia di usare il pacchetto di installazione per preparare l'ambiente di sviluppo.We encourage you to use the installation package to prepare the development environment. Se si verificano problemi, è possibile seguire la procedura manuale per risolverli.If you encounter any problems, you can follow the manual steps to get it done.

Scaricare il pacchetto più recenteDownload the latest package

Il file con estensione zip che viene scaricato contiene tutti gli strumenti e i pacchetti necessari per sviluppare il DevKit.The .zip file that you download contains all the necessary tools and packages for DevKit development.

Il file con estensione zip contiene gli strumenti e i pacchetti seguenti.The .zip file contains the following tools and packages. Se si dispone già di alcuni componenti installati, lo script li rileverà e li ignorerà.If you already have some components installed, the script will detect and skip them.

  • Node.js e Yarn: runtime per lo script di configurazione e le attività automatizzate.Node.js and Yarn: Runtime for the setup script and automated tasks.
  • MSI dell'interfaccia della riga di comando di Azure 2.0: riga di comando multipiattaforma per la gestione delle risorse di Azure.Azure CLI 2.0 MSI: Cross-platform command-line experience for managing Azure resources. Il file MSI contiene Python e pip dipendenti.The MSI contains dependent Python and pip.
  • Visual Studio Code (VS Code): editor di codice semplice per lo sviluppo del DevKit.Visual Studio Code (VS Code): Lightweight code editor for DevKit development.
  • Estensione di Visual Studio Code per Arduino: estensione che abilita lo sviluppo di Arduino in Visual Studio Code.Visual Studio Code extension for Arduino: Extension that enables Arduino development in Visual Studio Code.
  • IDE Arduino: strumento su cui si basa l'estensione per Arduino.Arduino IDE: Tool that the extension for Arduino relies on.
  • Pacchetto della scheda DevKit: catene di strumenti, librerie e progetti per il DevKit.DevKit Board Package: Tool chains, libraries, and projects for the DevKit.
  • Utilità ST-Link: strumenti e driver essenziali.ST-Link Utility: Essential tools and drivers.

Eseguire lo script di installazioneRun the installation script

In Esplora file di Windows individuare il file con estensione zip e decomprimerlo.In Windows File Explorer, locate the .zip file and extract it. Trovare il file install.cmd, fare clic con il pulsante destro del mouse su di esso e selezionare Esegui come amministratore.Find install.cmd, right-click it, and select Run as administrator.

Esplora file

Durante l'installazione viene visualizzato lo stato di ogni strumento o pacchetto.During installation, you see the progress of each tool or package.

Stato dell'installazione

Nota

A seconda dell'ambiente, a volte si otterrà un errore durante l'installazione dell'IDE Arduino.Depending on your environment, sometimes you will get failure when installing Arduino IDE. In questo caso, è possibile provare a installare singolarmente l'IDE Arduino e a eseguire di nuovo install.cmd.In this case, you may try install Arduino IDE individually and run install.cmd again. Altrimenti, seguire la procedura manuale per installare tutti gli strumenti e i pacchetti necessari.Otherwise, please follow the manual steps to install all necessary tools and packages.

Installare i driverInstall drivers

Il Visual Studio Code per l'estensione di Arduino si basa sull'IDE di Arduino.The VS Code for Arduino extension relies on the Arduino IDE. Se questa è la prima volta che si installa l'IDE di Arduino, viene chiesto di installare i driver pertinenti:If this is the first time you are installing the Arduino IDE, you're prompted to install relevant drivers:

getting-started-driver

L'installazione richiede circa 10 minuti a seconda della velocità della connessione Internet.Installation should take around 10 minutes, depending on your internet speed. Al termine dell'installazione, si dovrebbero vedere i collegamenti a Visual Studio Code e all'IDE di Arduino sul desktop.After the installation is complete, you should see Visual Studio Code and Arduino IDE shortcuts on your desktop.

Nota

In alcuni casi, all'avvio di Visual Studio Code viene visualizzato un errore che indica che non è possibile trovare l'IDE di Arduino o il pacchetto della scheda correlato.Occasionally, when you start VS Code, you're prompted with an error that it cannot find the Arduino IDE or related board package. Per risolvere il problema, chiudere Visual Studio Code e riavviare l'IDE di Arduino.To solve it, close VS Code and restart the Arduino IDE. Visual Studio Code dovrebbe a questo punto individuare il percorso corretto dell'IDE di Arduino.VS Code should then locate the Arduino IDE path correctly.

macOSmacOS

Si consiglia di usare l'esperienza di installazione in un solo clic per preparare l'ambiente di sviluppo.We encourage you to use one-click installation experience to prepare the development environment. Se si verificano problemi, è possibile seguire la procedura manuale per risolverli.If you encounter any problems, you can follow the manual steps to get it done.

Installare HomebrewInstall Homebrew

Nota

Se è stato installato Homebrew, è possibile ignorare questo passaggio.If you have installed Homebrew, you can skip this step.

Seguire le istruzioni di installazione di Homebrew per completare l'installazione.Follow the Homebrew installation instructions to install it.

Scaricare il pacchetto più recenteDownload the latest package

Il file con estensione zip che viene scaricato contiene tutti gli strumenti e i pacchetti necessari per sviluppare il DevKit.The .zip file that you download contains all the necessary tools and packages for DevKit development.

Il file con estensione zip contiene gli strumenti e i pacchetti seguenti.The .zip file contains the following tools and packages. Se si dispone già di alcuni componenti installati, lo script li rileverà e li ignorerà.If you already have some components installed, the script will detect and skip them.

  • Node.js e Yarn: runtime per lo script di configurazione e le attività automatizzate.Node.js and Yarn: Runtime for the setup script and automated tasks.
  • Interfaccia della riga di comando di Azure 2.0: esperienza della riga di comando multipiattaforma per la gestione delle risorse di Azure.Azure CLI 2.0: Cross-platform command-line experience for managing Azure resources.
  • Visual Studio Code (VS Code): editor di codice semplice per lo sviluppo del DevKit.Visual Studio Code (VS Code): Lightweight code editor for DevKit development.
  • Estensione di Visual Studio Code per Arduino: estensione che abilita lo sviluppo di Arduino in Visual Studio Code.Visual Studio Code extension for Arduino: Extension that enables Arduino development in Visual Studio Code.
  • IDE Arduino: strumento su cui si basa l'estensione per Arduino.Arduino IDE: Tool that the extension for Arduino relies on.
  • Pacchetto della scheda DevKit: catene di strumenti, librerie e progetti per il DevKit.DevKit Board Package: Tool chains, libraries, and projects for the DevKit.
  • Utilità ST-Link: strumenti e driver essenziali.ST-Link Utility: Essential tools and drivers.

Eseguire lo script di installazioneRun the installation script

In Finder individuare il file con estensione ZIP ed estrarre i file:In the Finder, locate the .zip and extract it:

Finder di macOS

Avviare l'app Terminal, individuare la cartella in cui sono stati estratti i file con estensione ZIP ed eseguire:Launch Terminal app, locate the folder you extract .zip file and run:

./install.sh

Installazione di macOS

Nota

Se si visualizza l'errore di autorizzazione di Homebrew, eseguire brew doctor per correggerlo.If you meet Homebrew permission error, run brew doctor to get it fixed. Per informazioni più dettagliate controllare le Domande frequenti.Check FAQ for more details.

Ora si dispone di tutti gli strumenti necessari e dei pacchetti installati per macOS.You now have all the necessary tools and packages installed for macOS.

Aprire la cartella del progettoOpen the project folder

Avviare Visual Studio CodeStart VS Code

Assicurarsi che DevKit non sia connesso.Make sure your DevKit is not connected. Avviare per prima cosa Visual Studio Code e connettere il DevKit al computer.Start VS Code first and connect the DevKit to your computer. Visual Studio Code individua DevKit automaticamente e visualizza una pagina di introduzione:VS Code automatically finds the DevKit and opens an introduction page:

Pagina Introduzione

Nota

In alcuni casi, all'avvio di Visual Studio Code viene visualizzato un errore che indica che non è possibile trovare l'IDE di Arduino o il pacchetto della scheda correlato.Occasionally, when you start VS Code, you're prompted with an error that it cannot find the Arduino IDE or related board package. Chiudere Visual Studio Code e riavviare l'IDE di Arduino.Close VS Code and restart the Arduino IDE. Visual Studio Code dovrebbe a questo punto individuare il percorso corretto dell'IDE di Arduino.VS Code should then locate the Arduino IDE path correctly.

Aprire la cartella degli esempi di ArduinoOpen the Arduino Examples folder

Nella scheda Arduino Examples (Esempi di Arduino) passare a Examples for MXCHIP AZ3166 > AzureIoT e selezionare GetStarted.On the Arduino Examples tab, browse to Examples for MXCHIP AZ3166 > AzureIoT, and select GetStarted.

Scheda Arduino Examples

Se si chiude il riquadro involontariamente, è possibile riaprirlo.If you happen to close the pane, you can reopen it. Premere Ctrl+Shift+P (macOS: Cmd+Shift+P) per aprire il riquadro comandi, digitare Arduino e quindi cercare e selezionare Arduino: Examples.Use Ctrl+Shift+P (macOS: Cmd+Shift+P) to open the command palette, type Arduino, and then find and select Arduino: Examples.

Eseguire il provisioning dei servizi di AzureProvision Azure services

Nella finestra della soluzione eseguire l'attività desiderata premendo Ctrl+P (macOS: Cmd+P) e immettendo task cloud-provision.In the solution window, run your task through Ctrl+P (macOS: Cmd+P) by entering task cloud-provision.

Nel terminale di Visual Studio Code una riga di comando interattiva guiderà nel processo di provisioning dei servizi di Azure necessari:In the VS Code terminal, an interactive command line guides you through provisioning the required Azure services:

Riga di comando interattiva

Compilare e caricare la definizione di ArduinoBuild and upload the Arduino sketch

WindowsWindows

  1. Usare Ctrl+P per eseguire task device-upload.Use Ctrl+P to run task device-upload.
  2. Il terminale richiederà di passare alla modalità di configurazione.The terminal prompts you to enter configuration mode. A tale scopo, tenere premuto il pulsante A, quindi premere e rilasciare il pulsante di reimpostazione.To do so, hold down button A, then push and release the reset button. La schermata visualizza l'ID di DevKit e la voce 'Configuration'.The screen displays the DevKit id and 'Configuration'.

Questa operazione serve per impostare la stringa di connessione recuperata dal passaggio task cloud-provision.This is to set the connection string that retrieves from task cloud-provision step.

Visual Studio Code inizia quindi a verificare e a caricare la definizione di Arduino:Then VS Code starts verifying and uploading the Arduino sketch:

Verifica e caricamento della definizione di Arduino

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

Nota

In alcuni casi viene visualizzato il messaggio "Errore: AZ3166: Pacchetto sconosciuto".Occasionally, you get error "Error: AZ3166: Unknown package". Questo errore è dovuto al mancato aggiornamento dell'indice del pacchetto della scheda.This is due to the board package index is not refreshed. Per correggerlo, attenersi alla procedura indicata nelle domande frequenti.Check this FAQ steps to solve it.

macOSmacOS

  1. Impostare DevKit in modalità di configurazione: tenere premuto il pulsante A e quindi premere e rilasciare il pulsante di reimpostazione.Put DevKit into configuration mode: Hold down button A, then push and release the reset button. Verrà visualizzata la schermata 'Configuration'.The screen displays 'Configuration'.
  2. Usare Cmd+P per eseguire task device-upload.Use Cmd+P to run task device-upload.

Questa operazione serve per impostare la stringa di connessione recuperata dal passaggio task cloud-provision.This is to set the connection string that retrieves from task cloud-provision step.

Visual Studio Code inizia quindi a verificare e a caricare la definizione di Arduino:Then VS Code starts verifying and uploading the Arduino sketch:

device-upload

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

Nota

In alcuni casi viene visualizzato il messaggio "Errore: AZ3166: Pacchetto sconosciuto".Occasionally, you get error "Error: AZ3166: Unknown package". Questo errore è dovuto al mancato aggiornamento dell'indice del pacchetto della scheda.This is due to the board package index is not refreshed. Per correggerlo, attenersi alla procedura indicata nelle domande frequenti.Check this FAQ steps to solve it.

Verificare il progettoTest the project

In Visual Studio Code attenersi alla procedura seguente per aprire e configurare Serial Monitor:In VS Code, following these steps to open and set up the Serial Monitor:

  1. Fare clic sulla parola COM[X] sulla barra di stato per impostare la porta COM corretta su STMicroelectronics: com-portClick the COM[X] word on the status bar to set the right COM port with STMicroelectronics: com-port

  2. Fare clic sull'icona del plug di accensione sulla barra di stato per aprire Serial Monitor: serial-monitorClick power plug icon on the status bar to open the Serial Monitor: serial-monitor

  3. Sulla barra di stato fare clic sul numero che rappresenta la velocità di trasmissione in baud e impostarlo su 115200: baud-rateOn the status bar, click the number that represents the Baud Rate and set to 115200: baud-rate

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:

  • Serial Monitor (Monitoraggio seriale) visualizza le stesse informazioni presenti nel contenuto nella schermata seguente.The Serial Monitor displays the same information as the content in the screenshot below.
  • Il LED sul DevKit di IoT MXChip lampeggia.The LED on MXChip IoT DevKit is blinking.

Output finale in Visual Studio Code

Problemi e commentiProblems and feedback

In caso di problemi è possibile consultare le domande frequenti.If you encounter problems, you can find FAQs. È 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.

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