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 all'Infineon XMC4800 IoT Connectivity 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 disponi già di 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 a usare l'Infineon XMC4800 IoT Connectivity Kit. Se non disponi dell'Infineon XMC4800 IoT Connectivity Kit, visita il AWS Partner Device Catalog per acquistarne uno dal nostro [partner](https://devices.amazonaws.com/detail/a3G0L00000AANsbUAH/XMC4800-IoT-Amazon-FreeRTOS-Connectivity-Kit-WiFi).
Se si desidera aprire una connessione seriale con la scheda per visualizzare le informazioni di registrazione e debug, è necessario un USB/Serial convertitore da 3,3 V, oltre all'IoT Connectivity Kit. XMC4800 CP2104 [È un USB/Serial convertitore comune ampiamente disponibile in schede come Friend di Adafruit. CP2104 ](https://www.adafruit.com/product/3309)
Prima di iniziare, devi configurare AWS IoT e scaricare i 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 di
Questo tutorial contiene le istruzioni per i seguenti passaggi iniziali:
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.
1. Interazione con l'applicazione in esecuzione sulla scheda attraverso una connessione seriale, per scopi di monitoraggio e debug.
## Configurazione dell'ambiente di sviluppo
FreerTOS utilizza l'ambiente di sviluppo DAVE di Infineon per programmare il. XMC4800 Prima di iniziare, devi scaricare e installare DAVE e alcuni driver J-Link per comunicare con il debugger della scheda.
### Installa DAVE
1. Andare alla pagina di [download del software Infineon DAVE](https://infineoncommunity.com/dave-download_ID645).
1. Scegliere il pacchetto DAVE per il proprio sistema operativo e inviare le informazioni di registrazione. Dopo la registrazione con Infineon, verrà inviata un'e-mail di conferma con un link per scaricare un file .zip.
1. Scaricare il file .zip del pacchetto DAVE (`DAVE_version_os_date.zip`) e decomprimerlo sul percorso in cui si desidera installare DAVE (ad esempio, `C:\DAVE4`).
**Nota**
Alcuni utenti di Windows hanno riportato problemi con Windows Explorer per decomprimere il file. È consigliabile utilizzare un programma di terze parti, ad esempio 7-Zip.
1. Per avviare DAVE, eseguire il file eseguibile che si trova nella cartella decompressa `DAVE_version_os_date.zip`.
Per ulteriori informazioni, consulta la [Guida rapida su DAVE](https://www.infineon.com/dgdl/Infineon-DAVE_Quick_Start-GS-v02_00-EN.pdf?fileId=5546d4624cb7f111014d059f7b8c712d).
### Installa i driver Segger J-Link
Per comunicare con la sonda di debug integrata nella scheda XMC4800 Relax EtherCAT, sono necessari i driver inclusi nel pacchetto software e documentazione J-Link. È possibile scaricare il pacchetto J-Link Software and Documentation dalla pagina di [download del software J-Link](https://www.segger.com/downloads/jlink/#J-LinkSoftwareAndDocumentationPack) di Segger.
## Stabilire una connessione seriale
Stabilire una connessione seriale è facoltativo, ma consigliato. Una connessione seriale consente alla scheda di inviare le informazioni di accesso e di debug in un modulo che è possibile visualizzare sul computer di sviluppo.
L'applicazione XMC4800 demo utilizza una connessione seriale UART sui pin P0.0 e P0.1, che sono etichettati sulla serigrafia della scheda XMC4800 Relax EtherCAT. Per stabilire una connessione seriale:
1. Connect il pin etichettato «RXP0.1» al pin «RX» del USB/Serial convertitore.
1. Collegare il perno di messa a terra del convertitore seriale a uno dei connettori etichettati come "GND" sulla scheda. I dispositivi devono condividere un terreno comune.
L'alimentazione è fornita dalla porta di debug USB, perciò non collegare il connettore di tensione positiva dell'adattatore seriale alla scheda.
**Nota**
Alcuni cavi seriali utilizzano un livello di segnale da 5V. La XMC4800 scheda e il modulo Wi-Fi Click richiedono una tensione di 3,3 V. Non utilizzare il cavo di collegamento IOREF della scheda per modificare i segnali della scheda su 5V.
Con il cavo collegato, è possibile aprire una connessione seriale su un emulatore di terminale, ad esempio [GNU Screen](https://www.gnu.org/software/screen/). Il baud rate è impostato su 115200 per impostazione predefinita con 8 bit di dati, nessuna parità, 1 bit di arresto.
## Monitoraggio dei messaggi MQTT in cloud
Prima di eseguire la demo di 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. Accedi alla [console AWS IoT](https://console.aws.amazon.com/iotv2/).
1. Nel pannello di navigazione, scegliete **Test**, quindi scegliete **MQTT test client per aprire il client** MQTT.
1. In **Argomento sottoscrizione**, digitare ***your-thing-name*/example/topic**, quindi scegliere **Effettua sottoscrizione all'argomento**.
Quando il progetto demo viene eseguito correttamente sul tuo dispositivo, vedi «Hello World\$1» inviato più volte all'argomento a cui ti sei iscritto.
## Crea ed esegui il progetto demo FreerTOS
### Importa la demo di FreerTOS in DAVE
1. Avvia DAVE.
1. In DAVE, selezionare **File**, **Import (Importa)**. Nella finestra **Import (Importa)**, espandere la cartella **Infineon**, scegliere **DAVE Project (Progetto DAVE)** quindi scegliere **Next (Successivo)**.
1. Nella finestra **Importa progetti DAVE**, scegli **Seleziona la directory principale**, scegli **Sfoglia**, quindi scegli il progetto demo. XMC4800
Nella directory in cui hai decompresso il download di FreerTOS, si trova il progetto demo. `projects/infineon/xmc4800_iotkit/dave4/aws_demos`
Assicurarsi che l'opzione **Copy Projects Into Workspace (Copia progetti nel workspace)** sia deselezionata.
1. Scegli **Fine**.
Il progetto `aws_demos` deve essere importato nel workspace e attivato.
1. Dal menu **Project (Progetto)**, scegliere **Build Active Project (Crea progetto attivo)**.
Assicurarsi che il progetto venga creato senza errori.
### Esegui il progetto demo FreerTOS
1. Usa un cavo USB per collegare il tuo XMC4800 IoT Connectivity Kit al computer. La scheda è dotata di due connettori microUSB. Utilizza quello etichettato come "X101", dove Debug vi è visualizzato accanto nella serigrafia della scheda.
1. Dal menu **Project (Progetto)** scegliere **Rebuild Active Project (Ricrea progetto attivo)** per ricreare `aws_demos` e accertarsi che le modifiche di configurazione siano selezionate.
1. Da **Project Explorer**, fare clic con il pulsante destro del mouse su `aws_demos`, scegliere **Debug As (Debug come)**, e quindi scegliere **DAVE C/C\$1\$1 Application**.
1. Fare doppio clic su **GDB SEGGER J-Link Debugging (Debug di GDB SEGGER J-)** per creare una conferma del debug. Scegliere **Debug**.
1. Quando il debugger si arresta sul punto di interruzione in `main()`, dal menu **Run (Esegui)**, scegliere **Resume (Riprendi)**.
Nella AWS IoT console, il client MQTT dei passaggi 4-5 dovrebbe visualizzare i messaggi MQTT inviati dal dispositivo. Se si utilizza la connessione seriale, l'output UART dovrebbe essere simile a questo:
```
0 0 [Tmr Svc] Starting key provisioning...
1 1 [Tmr Svc] Write root certificate...
2 4 [Tmr Svc] Write device private key...
3 82 [Tmr Svc] Write device certificate...
4 86 [Tmr Svc] Key provisioning done...
5 291 [Tmr Svc] Wi-Fi module initialized. Connecting to AP...
.6 8046 [Tmr Svc] Wi-Fi Connected to AP. Creating tasks which use network...
7 8058 [Tmr Svc] IP Address acquired [IP Address]
8 8058 [Tmr Svc] Creating MQTT Echo Task...
9 8059 [MQTTEcho] MQTT echo attempting to connect to [MQTT Broker].
...10 23010 [MQTTEcho] MQTT echo connected.
11 23010 [MQTTEcho] MQTT echo test echoing task created.
.12 26011 [MQTTEcho] MQTT Echo demo subscribed to iotdemo/#
13 29012 [MQTTEcho] Echo successfully published 'Hello World 0'
.14 32096 [Echoing] Message returned with ACK: 'Hello World 0 ACK'
.15 37013 [MQTTEcho] Echo successfully published 'Hello World 1'
16 40080 [Echoing] Message returned with ACK: 'Hello World 1 ACK'
.17 45014 [MQTTEcho] Echo successfully published 'Hello World 2'
.18 48091 [Echoing] Message returned with ACK: 'Hello World 2 ACK'
.19 53015 [MQTTEcho] Echo successfully published 'Hello World 3'
.20 56087 [Echoing] Message returned with ACK: 'Hello World 3 ACK'
.21 61016 [MQTTEcho] Echo successfully published 'Hello World 4'
22 64083 [Echoing] Message returned with ACK: 'Hello World 4 ACK'
.23 69017 [MQTTEcho] Echo successfully published 'Hello World 5'
.24 72091 [Echoing] Message returned with ACK: 'Hello World 5 ACK'
.25 77018 [MQTTEcho] Echo successfully published 'Hello World 6'
26 80085 [Echoing] Message returned with ACK: 'Hello World 6 ACK'
.27 85019 [MQTTEcho] Echo successfully published 'Hello World 7'
.28 88086 [Echoing] Message returned with ACK: 'Hello World 7 ACK'
.29 93020 [MQTTEcho] Echo successfully published 'Hello World 8'
.30 96088 [Echoing] Message returned with ACK: 'Hello World 8 ACK'
.31 101021 [MQTTEcho] Echo successfully published 'Hello World 9'
32 104102 [Echoing] Message returned with ACK: 'Hello World 9 ACK'
.33 109022 [MQTTEcho] Echo successfully published 'Hello World 10'
.34 112047 [Echoing] Message returned with ACK: 'Hello World 10 ACK'
.35 117023 [MQTTEcho] Echo successfully published 'Hello World 11'
36 120089 [Echoing] Message returned with ACK: 'Hello World 11 ACK'
.37 122068 [MQTTEcho] MQTT echo demo finished.
38 122068 [MQTTEcho] ----Demo finished----
```
### Crea la demo di FreerTOS con CMake
Se preferisci non utilizzare un IDE per lo sviluppo di FreerTOS, puoi in alternativa CMake utilizzarlo per creare ed eseguire le applicazioni demo o le applicazioni che hai sviluppato utilizzando editor di codice e strumenti di debug di terze parti.
**Nota**
Questa sezione descrive l'utilizzo CMake su Windows con MingW come sistema di build nativo. Per ulteriori informazioni sull'utilizzo CMake con altri sistemi operativi e opzioni, vedere[Utilizzo CMake con FreerTOS](getting-started-cmake.md). ([MinGW ](https://sourceforge.net/projects/mingw-w64/files/) è un ambiente di sviluppo minimalista per applicazioni Microsoft Windows native).
**Per creare la demo di FreerTOS con CMake**
1. Configurare la suite di strumenti GNU ARM Embedded Toolchain.
1. Scaricare una versione per Windows della toolchain dalla [pagina di download di ARM Embedded Toolchain](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads).
**Nota**
È consigliabile scaricare una versione diversa da "8-2018-q4-major", a causa di un [bug rilevato](https://bugs.launchpad.net/gcc-arm-embedded/+bug/1810274) mediante la utilità "objcopy" in tale versione.
1. Aprire il programma di installazione della toolchain scaricata e seguire la procedura guidata di installazione per installare la toolchain.
**Importante**
Nella pagina finale della procedura guidata di installazione, selezionare **Add path to environment variable (Aggiungi percorso a variabili di ambiente)** per aggiungere il percorso della toolchain alla variabile di ambiente del percorso di sistema.
1. Installa CMake e MinGW.
Per istruzioni, consulta [CMake Prerequisiti](getting-started-cmake.md#building-cmake-prereqs).
1. Crea una cartella per contenere i file di build generati (*build-folder*).
1. Cambia le directory nella tua directory di download di FreerTOS `freertos` () e usa il seguente comando per generare i file di build:
```
cmake -DVENDOR=infineon -DBOARD=xmc4800_iotkit -DCOMPILER=arm-gcc -S . -B build-folder -G "MinGW Makefiles" -DAFR_ENABLE_TESTS=0
```
1. Cambia le directory nella directory build (*build-folder*) e usa il seguente comando per creare il file binario:
```
cmake --build . --parallel 8
```
Questo comando crea il file binario di output `aws_demos.hex` nella directory di compilazione.
1. Effettuare il flashing ed eseguire l'immagine con [JLINK](#install-jlink).
1. Dalla directory build (*build-folder*), utilizzate i seguenti comandi per creare uno script flash:
```
echo loadfile aws_demos.hex > flash.jlink
```
```
echo r >> flash.jlink
```
```
echo g >> flash.jlink
```
```
echo q >> flash.jlink
```
1. Effettuare il flashing dell'immagine utilizzando l'eseguibile JLNIK.
```
JLINK_PATH\JLink.exe -device XMC4800-2048 -if SWD -speed auto -CommanderScript flash.jlink
```
I log dell'applicazione devono essere visibili mediante [la connessione seriale](#install-serial-connection) stabilita con la scheda.
## Risoluzione dei problemi
Se non l'hai già fatto, assicurati di configurare AWS IoT e scaricare FreerTOS per connettere il tuo dispositivo al Cloud. AWS Per istruzioni, consulta [Fase iniziale](freertos-prereqs.md).
Per informazioni generali sulla risoluzione dei problemi su Getting Started with FreerTOS, consulta. [Nozioni di base sulla risoluzione dei problemi](gsg-troubleshooting.md)