Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Guida introduttiva allo Xilinx Avnet MicroZed Industrial IoT Kit
**Importante**
Questa integrazione di riferimento è ospitata nel repository Amazon-FreeRTOS che è obsoleto. Ti consigliamo di [iniziare da qui quando crei un nuovo progetto](freertos-getting-started-modular.md). Se hai già un progetto FreeRTOS esistente basato sull'ormai obsoleto repository Amazon-FreerTOS, consulta il. [Guida alla migrazione del repository Github di Amazon-FreeRTOS](github-repo-migration.md)
Questo tutorial fornisce istruzioni per iniziare con lo Xilinx Avnet MicroZed Industrial IoT Kit. [Se non disponi del kit Xilinx Avnet MicroZed Industrial IoT, visita AWS il Partner Device Catalog per acquistarne uno dal nostro partner.](https://devices.amazonaws.com/detail/a3G0L00000AANtqUAH/MicroZed-IIoT-Bundle-with-Amazon-FreeRTOS)
Prima di iniziare, devi configurare AWS IoT e scaricare FreerTOS per connettere il tuo dispositivo al Cloud. AWS Per istruzioni, consulta [Fase iniziale](freertos-prereqs.md). In questo tutorial, il percorso della directory di download di FreerTOS è indicato come. `freertos`
## Panoramica
Questo tutorial contiene le istruzioni per i seguenti passaggi iniziali:
1. Connessione della scheda a un computer host.
1. Installazione di software sul computer host per lo sviluppo e il debug di applicazioni integrate per la scheda a microcontroller.
1. Compilazione incrociata di un'applicazione demo FreerTOS con un'immagine binaria.
1. Caricamento dell'immagine binaria dell'applicazione sulla scheda in uso e successiva esecuzione dell'applicazione.
## Configura l'hardware MicroZed
Il diagramma seguente può essere utile per la configurazione dell' MicroZed hardware:
![\[AVNet scheda microcontrollore con LED Power Good, LED utente e pulsante, accesso JTAG, host Ethernet e USB 10/100/1000, slot microSD, USB-UART, LED Done, pulsante Reset e jumper Boot MODE evidenziati.\]](http://docs.aws.amazon.com/it_it/freertos/latest/userguide/images/microzed.png)
**Per configurare la scheda MicroZed**
1. Connect il computer alla porta USB-UART della scheda. MicroZed
1. Connect il computer alla porta JTAG Access sulla MicroZed scheda.
1. Collega un router o una porta Ethernet connessa a Internet alla porta Ethernet e USB-host sulla scheda. MicroZed
## Configurazione dell'ambiente di sviluppo
Per configurare le configurazioni FreerTOS per MicroZed il kit, è necessario utilizzare lo Xilinx Software Development Kit (XSDK). XSDK è supportato su Windows e Linux.
### Download e installazione di XSDK
Per installare il software Xilinx, occorre un account Xilinx gratuito.
**Per scaricare XSDK**
1. [Vai alla pagina di download del Software Development Kit Standalone Client. WebInstall ](https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools/2019-1.html)
1. Scegliere l'opzione appropriata per il sistema operativo in uso.
1. Viene visualizzata la pagina di accesso Xilinx.
**Se hai un account con Xilinx, inserisci le tue credenziali di accesso e poi scegli Accedi.**
Se non si dispone di un account, scegliere **Create your account (Crea account)**. Dopo la registrazione, si riceverà un'e-mail con un collegamento per attivare l'account Xilinx.
1. Nella pagina **Name and Address Verification (Verifica di nome e indirizzo)**, immettere le proprie informazioni e scegliere **Next (Avanti)**. Il download è pronto per iniziare.
1. Salvare il file `Xilinx_SDK_version_os`.
**Per installare XSDK**
1. Apri il file `Xilinx_SDK_version_os`.
1. In **Select Edition to Install (Seleziona edizione da installare)**, scegliere **Xilinx Software Development Kit (XSDK)** e quindi selezionare **Next (Avanti)**.
1. Nella pagina successiva dell'installazione guidata, in **Installation Options (Opzioni di installazione)**, selezionare **Install Cable Drivers (Installa driver del cavo)** e quindi scegliere **Next (Avanti)**.
Se il computer non rileva la connessione USB-UART, MicroZed installa manualmente i driver 0x Bridge VCP. CP21 USB-to-UART Per istruzioni, consulta la Guida all'installazione di [Silicon](https://www.xilinx.com/support/documentation/boards_and_kits/install/ug1033-cp210x-usb-uart-install.pdf) Labs 0x. CP21 USB-to-UART
Per ulteriori informazioni su XSDK, consulta la pagina [Getting Started with Xilinx SDK](https://www.xilinx.com/html_docs/xilinx2018_2/SDK_Doc/index.html) sul sito Web Xilink.
## Monitoraggio dei messaggi MQTT in cloud
Prima di eseguire il progetto demo FreerTOS, puoi configurare il client MQTT nella console per monitorare AWS IoT i messaggi che il tuo dispositivo invia al Cloud. AWS
**Per iscriversi all'argomento MQTT con il client MQTT AWS IoT**
1. Accedere alla [console AWS IoT](https://console.aws.amazon.com/iotv2/).
1. Nel pannello di navigazione, scegli **Test**, quindi scegli **MQTT test client per aprire il client** MQTT.
1. In **Argomento sottoscrizione**, digitare ***your-thing-name*/example/topic**, quindi scegliere **Effettua sottoscrizione all'argomento**.
## Crea ed esegui il progetto demo FreerTOS
### Apri la demo di FreerTOS nell'IDE XSDK
1. Avviare l'IDE XSDK con la directory del workspace impostata su `freertos/projects/xilinx/microzed/xsdk`.
1. Chiudere la pagina di benvenuto. Dal menu, scegliere **Project (Progetto)**, quindi deselezionare **Build Automatically (Compila automaticamente)**.
1. Da menu, scegliere **File**, quindi selezionare **Import (Importa)**.
1. Nella pagina **Select (Seleziona)**, espandere **General (Generale)**, scegliere **Existing Projects into Workspace (Progetti esistenti nel workspace)**, quindi selezionare **Next (Avanti)**.
1. Nella pagina **Importa progetti**, scegliere **Seleziona directory root**, quindi immettere la directory root del progetto demo: `freertos/projects/xilinx/microzed/xsdk/aws_demos`. Per individuare la directory, scegliere **Browse (Sfoglia)**.
Dopo aver specificato una directory root, i progetti nella directory vengono visualizzati nella pagina **Import Projects (Importa progetti)**. Tutti i progetti disponibili sono selezionati per impostazione predefinita.
**Nota**
Se viene visualizzato un avviso nella parte superiore della pagina **Import Projects (Importa progetti)** ("Some projects cannot be imported because they already exist in the workspace" (Impossibile importare alcuni progetti perché esistono già nel workspace)), puoi ignorarlo.
1. Con tutti i progetti selezionati, scegliere **Finish (Fine)**.
1. Se non vengono visualizzati i progetti `aws_bsp`, `fsbl` e `MicroZed_hw_platform_0` nel riquadro dei progetti, ripetere i passaggi precedenti a partire da \$13 ma con la directory principale impostata su `freertos/vendors/xilinx` e importare `aws_bsp`, `fsbl` e `MicroZed_hw_platform_0`.
1. Da menu, scegliere **Window (Finestra)**, quindi selezionare **Preferences (Preferenze)**.
1. Nel riquadro di navigazione, espandere **Run/Debug (Esegui/Debug)**, scegliere **String Substitution (Sostituzione stringa)**, quindi selezionare **New (Nuovo)**.
1. In **New String Substitution Variable (Nuova variabile di sostituzione stringa)**, per **Name (Nome)**, immettere **AFR\$1ROOT**. Per **Valore**, immettere il percorso root della `freertos/projects/xilinx/microzed/xsdk/aws_demos`. Scegliere **OK**, quindi selezionare **OK** per salvare la variabile e chiudere **Preferences (Preferenze)**.
### Crea il progetto demo FreerTOS
1. Nell'IDE XSDK, dal menu, scegliere **Project (Progetto)**, quindi selezionare **Clean (Pulisci)**.
1. In **Clean (Pulisci)**, lasciare i valori predefinite delle opzioni, quindi scegliere **OK**. XSDK pulisce e compila tutti i progetti, quindi genera file `.elf`.
**Nota**
Per compilare tutti i progetti senza pulirli, scegli **Project (Progetto)**, quindi seleziona **Build All (Compila tutto)**.
Per compilare singoli progetti, seleziona il progetto da compilare, scegli **Project (Progetto)**, quindi seleziona **Build Project (Compila progetto)**.
### Genera l'immagine di avvio per il progetto demo FreerTOS
1. Nell'IDE XSDK, fare clic con il pulsante destro del mouse su **aws\$1demos**, quindi scegliere **Create Boot Image (Crea immagine di avvio)**.
1. In **Create Boot Image (Crea immagine di avvio)**, scegliere **Create new BIF file (Crea nuovo file BIF)**.
1. Accanto a **Output BIF file path (Percorso file BIF di output)**, scegliere **Browse (Sfoglia)**, quindi selezionare `aws_demos.bif` situato in `/vendors/xilinx/microzed/aws_demos/aws_demos.bif`.
1. Scegli **Aggiungi**.
1. In **Add new boot image partition (Aggiungi nuova partizione immagine di avvio)**, accanto a **File path (Percorso file)**, scegliere **Browse (Sfoglia)**, quindi selezionare `fsbl.elf`, situato in `vendors/xilinx/fsbl/Debug/fsbl.elf`.
1. In **Partition type (Tipo di partizione)**, scegliere **bootloader**, quindi selezionare **OK**.
1. In **Create Boot Image (Crea immagine di avvio)**, scegliere **Create Image (Crea immagine)**. In **Override Files (Ignora file)**, scegliere **OK** per sovrascrivere il file `aws_demos.bif` esistente e generare il file `BOOT.bin` in `projects/xilinx/microzed/xsdk/aws_demos/BOOT.bin`.
### Debug di JTAG
1. Imposta i jumper della modalità di avvio della MicroZed scheda sulla modalità di avvio JTAG.
![\[Connettori dell'intestazione del circuito e impostazioni dei ponticelli.\]](http://docs.aws.amazon.com/it_it/freertos/latest/userguide/images/xilinx-jtag.png)
1. Inserire la scheda MicroSD nello slot della scheda MicroSD che si trova subito sotto la porta USB-UART.
**Nota**
Prima di eseguire il debug, assicurarsi di eseguire il backup dei contenuti disponibili sulla scheda MicroSD.
L'aspetto della scheda è simile al seguente:
![\[Scheda di valutazione FreerTOS con opzioni di connettività.\]](http://docs.aws.amazon.com/it_it/freertos/latest/userguide/images/xilinx-jtag-full-board.png)
1. Nell'IDE XSDK, fare clic con il pulsante destro del mouse su **aws\$1demos**, scegliere **Debug As (Esegui debug come)**, quindi selezionare **1 Launch on System Hardware (System Debugger) (1 Avvia su hardware di sistema (Debugger di sistema))**.
1. Quando il debugger si arresta in corrispondenza del punto di interruzione in `main()`, dal menu, scegliere **Run (Esegui)**, quindi selezionare **Resume (Riprendi)**.
**Nota**
La prima volta che esegui l'applicazione, una nuova coppia certificato-chiave viene importata in memoria non volatile. Per esecuzioni successive, è possibile commentare `vDevModeKeyProvisioning()` nel file `main.c` prima di ricompilare le immagini e il file `BOOT.bin`. In questo modo si impedisce che i certificati e la chiave vengano copiati nello storage ad ogni esecuzione.
Puoi scegliere di avviare la MicroZed scheda da una scheda microSD o da QSPI Flash per eseguire il progetto demo FreerTOS. Per istruzioni, consulta [Genera l'immagine di avvio per il progetto demo FreerTOS](#xilinx-build-boot-image) e [Esegui il progetto demo FreerTOS](#xilinx-run).
### Esegui il progetto demo FreerTOS
Per eseguire il progetto demo FreerTOS, puoi avviare MicroZed la scheda da una scheda microSD o da un flash QSPI.
Mentre configuri la MicroZed scheda per l'esecuzione del progetto demo FreerTOS, fai riferimento allo schema in. [Configura l'hardware MicroZed](#xilinx-setup-hardware) Assicurati di aver collegato la MicroZed scheda al computer.
#### Avvia il progetto FreerTOS da una scheda microSD
Formatta la scheda microSD fornita con lo MicroZed Xilinx Industrial IoT Kit.
1. Copiare il file `BOOT.bin` nella scheda MicroSD.
1. Inserire la scheda nello slot della scheda MicroSD direttamente sotto la porta USB-UART.
1. Imposta i jumper della modalità di MicroZed avvio sulla modalità di avvio SD.
![\[Scheda SD con tre slot etichettati JP1 JP3 e un portabatterie a bottone. JP2\]](http://docs.aws.amazon.com/it_it/freertos/latest/userguide/images/xilinx-sd.png)
1. Premere il pulsante RST per ripristinare il dispositivo e avviare la procedura di avvio dell'applicazione. È anche possibile scollegare il cavo USB-UART dalla porta USB-UART e quindi reinserire il cavo.
#### Avvia il progetto demo FreerTOS da QSPI flash
1. Imposta i jumper della modalità di avvio della MicroZed scheda sulla modalità di avvio JTAG.
![\[Connettori dell'intestazione del circuito e impostazioni dei ponticelli.\]](http://docs.aws.amazon.com/it_it/freertos/latest/userguide/images/xilinx-jtag.png)
1. Verificare che il computer sia connesso alle porte USB-UART e JTAG Access. Il LED Power Good verde deve essere acceso.
1. Nell'IDE XSDK, dal menu, scegliere **Xilinx**, quindi selezionare **Program Flash (Programma flash)**.
1. In **Program Flash Memory (Programma memoria flash)**, la piattaforma hardware deve essere compilata automaticamente. Per **Connection**, scegli il tuo server MicroZed hardware per connettere la scheda al computer host.
**Nota**
Se si sta utilizzando il cavo Xilinx Smart Lync JTAG, è necessario creare un server hardware in XSDK IDE. Scegliere **New (Nuovo)**, quindi definire il server.
1. In **Image File (File di immagine)**, immettere il percorso di directory al file di immagine `BOOT.bin`. Scegliere **Browse (Sfoglia)** per individuare il file.
1. In **Offset (Scostamento)**, immettere **0x0**.
1. In **FSBL File (File FSBL)**, immettere il percorso di directory al file `fsbl.elf`. Scegliere **Browse (Sfoglia)** per individuare il file.
1. Scegliere **Program (Programma)** per programmare la scheda.
1. Al termine della programmazione QSPI, rimuovere il cavo USB-UART per spegnere la scheda.
1. Imposta i jumper della modalità di avvio della MicroZed scheda sulla modalità di avvio QSPI.
1. Inserire la scheda nello slot della scheda MicroSD che si trova subito sotto la porta USB-UART.
**Nota**
Assicurarsi di eseguire il backup dei contenuti disponibili sulla scheda MicroSD.
1. Premere il pulsante RST per ripristinare il dispositivo e avviare la procedura di avvio dell'applicazione. È anche possibile scollegare il cavo USB-UART dalla porta USB-UART e quindi reinserire il cavo.
## Risoluzione dei problemi
Se si verificano errori di compilazione correlati a percorsi errati, prova a pulire e ricompilare il progetto, come descritto in [Crea il progetto demo FreerTOS](#xilinx-freertos-build-project).
Se utilizzi il sistema operativo Windows, assicurati di utilizzare le barre quando imposti le variabili di sostituzione stringa nell'IDE XSDK Windows.
Per informazioni generali sulla risoluzione dei problemi su Getting Started with FreerTOS, consulta. [Nozioni di base sulla risoluzione dei problemi](gsg-troubleshooting.md)