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 al kit di sviluppo MediaTek MT7697 Hx
**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 con l'Hx Development Kit. MediaTek MT7697 [Se non disponi dell' MediaTek MT7697Hx Development Kit, visita il AWS Partner Device Catalog per acquistarne uno dal nostro partner.](https://devices.amazonaws.com/detail/a3G0L00000AAOmPUAX/MT7697Hx-Development-Kit)
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 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
Prima di configurare l'ambiente, collega il computer alla porta USB dell' MediaTek MT7697Hx Development Kit.
### Scarica e installa Keil MDK.
Puoi usare il Keil Microcontroller Development Kit (MDK) basato su GUI per configurare, creare ed eseguire progetti FreerTOS sulla tua scheda. Keil MDK include μVision IDE e μVision Debugger.
**Nota**
Keil MDK è supportato su Windows 7, Windows 8 e Windows 10 solo per i computer a 64 bit.
**Per scaricare e installare Keil MDK**
1. Vai alla pagina delle [nozioni di base di Keil MDK](http://www2.keil.com/mdk5/install/) e scegli **Download MDK-Core (Scarica MDK-core)**.
1. Inserisci e invia le informazioni per la registrazione a Keil.
1. Fai clic con il pulsante destro del mouse sull'eseguibile MDK e salva il programma di installazione Keil MDK sul computer.
1. Apri il programma di installazione Keil MDK e segui le fasi per completare l'operazione. Assicurati di installare il device pack (Series). MediaTek MT76x7
## Stabilire una connessione seriale
Connect la scheda al computer host con un cavo USB. In Gestione dispositivi di Windows viene visualizzata una porta COM. Per il debug, è possibile aprire una sessione sulla porta con uno strumento di utilità terminale come o. HyperTerminal TeraTerm
## 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. Accedi 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**.
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 con Keil MDK
**Per creare il progetto dimostrativo FreerTOS in Keil μVision**
1. Dal menu **Start**, apri Keil μVision 5.
1. Apri il file di progetto `projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/aws_demos.uvprojx`.
1. Dal menu, scegli **Project (Progetto)**, quindi **Build target (Destinazione compilazione)**.
Dopo aver compilato il codice, il file eseguibile della demo viene visualizzato in `projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/out/Objects/aws_demo.axf`.
**Per eseguire il progetto demo FreerTOS**
1. Imposta l' MediaTek MT7697Hx Development Kit in modalità PROGRAM.
Per impostare il kit per la modalità PROGRAM, premi e tieni premuto il pulsante **PROG (PROGRAMMA)**. Con il pulsante **PROG (PROGRAMMA)** ancora premuto, premi e rilascia il pulsante **RESET (REIMPOSTA)**, quindi rilascia il pulsante **PROG (PROGRAMMA)**.
1. Dal menu, scegli **Flash**, quindi scegli **Configure Flash Tools (Configura strumenti Flash)**.
1. In **Opzioni per Target '`aws_demo`'**, scegli la scheda **Debug**. Seleziona **Use (Usa)**, imposta il debugger su **CMSIS-DAP Debugger (Debugger CMSIS-DAP)**, quindi scegli **OK**.
1. Dal menu, scegli **Flash**, quindi **Download (Scarica)**.
μVision invia una notifica al completamento del download.
1. Utilizza un'utilità terminale per aprire la finestra della console seriale. Imposta la porta seriale a 115200 bps, nessuna parità, 8 bit e 1 bit di arresto.
1. Scegli il pulsante **RESET** sul tuo MediaTek MT7697 Hx Development Kit.
## risoluzione dei problemi
### Eseguire il debug di progetti FreerTOS in Keil μVision
Attualmente, è necessario modificare il MediaTek pacchetto incluso in Keil μVision prima di poter eseguire il debug del progetto demo FreerTOS con Keil μVision. MediaTek
**Per modificare il MediaTek pacchetto per il debug dei progetti FreerTOS**
1. Trova e apri il file `Keil_v5\ARM\PACK\.Web\MediaTek.MTx.pdsc` nella cartella di installazione di Keil MDK.
1. Sostituisci tutte le istanze di `flag = Read32(0x20000000);`con `flag = Read32(0x0010FBFC);`.
1. Sostituisci tutte le istanze di `Write32(0x20000000, 0x76877697);`con `Write32(0x0010FBFC, 0x76877697);`.
**Per avviare il debug del progetto**
1. Dal menu, scegli **Flash**, quindi scegli **Configure Flash Tools (Configura strumenti Flash)**.
1. Scegli la scheda **Target (Destinazione)**, quindi scegli **Read/Write Memory Areas (Aree di memoria in lettura/scrittura)**. Confermalo e sono entrambi selezionati IRAM1 . IRAM2
1. Scegli la scheda **Debug**, quindi scegli **CMSIS-DAP Debugger (Debugger CMSIS-DAP)**.
1. Apri `vendors/mediatek/boards/mt7697hx-dev-kit/aws_demos/application_code/main.c` e imposta la macro `MTK_DEBUGGER` su `1`.
1. Ricostruisci il progetto demo in μVision.
1. Imposta l' MediaTek MT7697Hx Development Kit sulla modalità PROGRAM.
Per impostare il kit per la modalità PROGRAM, premi e tieni premuto il pulsante **PROG (PROGRAMMA)**. Con il pulsante **PROG (PROGRAMMA)** ancora premuto, premi e rilascia il pulsante **RESET (REIMPOSTA)**, quindi rilascia il pulsante **PROG (PROGRAMMA)**.
1. Dal menu, scegli **Flash**, quindi **Download (Scarica)**.
μVision invia una notifica al completamento del download.
1. Premi il pulsante **RESET** sul tuo MediaTek MT7697 Hx Development Kit.
1. Dal menu μVision, scegli **Debug**, quindi scegli **Avvia/interrompi** sessione di debug. La finestra **Call Stack \$1 Locals (Stack chiamate \$1 Locali)** si apre quando si avvia la sessione di debug.
1. Dal menu, scegliere **Debug**, quindi scegliere **Stop (Interrompi)** per sospendere l'esecuzione del codice. Il contatore del programma si arresta alla riga seguente:
```
{ volatile int wait_ice = 1 ; while ( wait_ice ) ; }
```
1. Nella finestra **Call Stack \$1 Locals (Stack chiamate \$1 Locali)**, modifica il valore di `wait_ice` in `0`.
1. Imposta i punti di interruzione nel codice origine del progetto ed esegui il codice.
### Risoluzione dei problemi relativi alle configurazioni del debugger dell'IDE
In caso di problemi durante il debug di un'applicazione, le impostazioni del debugger potrebbero essere errate.
**Per verificare che le impostazioni del debugger siano corrette**
1. Aprire Keil µVision.
1. Fare clic con il pulsante destro del mouse sul progetto `aws_demos`, scegliere **Options (Opzioni)**, quindi nella scheda **Utility (Utilità)**, scegliere **Settings (Impostazioni)** accanto a **"-- Utilizza Debug Driver --"**.
1. Verificare che le impostazioni nella scheda **Debug** siano le seguenti:
![\[Finestra di dialogo di configurazione del driver CMSIS-DAP Cortex-M Target con numero di serie, versione del firmware, tipo di adattatore, opzioni del dispositivo SW e impostazioni di configurazione.\]](http://docs.aws.amazon.com/it_it/freertos/latest/userguide/images/mediatek-debug-2.png)
1. Verificare che le impostazioni nella scheda **Flash Download (Scarica Flash)** siano le seguenti:
![\[Finestra di configurazione del driver Cortex-M Target con opzioni per la funzione di download, la RAM per l'algoritmo, la descrizione dell'algoritmo di programmazione e i dettagli del dispositivo.\]](http://docs.aws.amazon.com/it_it/freertos/latest/userguide/images/mediatek-debug-3.png)
Per informazioni generali sulla risoluzione dei problemi su Getting Started with FreerTOS, consulta. [Nozioni di base sulla risoluzione dei problemi](gsg-troubleshooting.md)