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à. # Nozioni di base su Microchip Curiosity PIC32MZ EF **Importante** Questa integrazione di riferimento è ospitata nel repository che è obsoleto. Amazon-FreeRTOS Ti consigliamo di [iniziare da qui](freertos-getting-started-modular.md) quando crei un nuovo progetto. Se hai già un progetto FreerTOS esistente basato sul repository ora obsoleto, Amazon-FreeRTOS consulta il. [Amazon-FreeRTOS Guida alla migrazione del repository Github](github-repo-migration.md) **Nota** In accordo con Microchip, stiamo rimuovendo Curiosity PIC32MZEF (DM320104) dal ramo principale del repository FreerTOS Reference Integration e non lo utilizzeremo più nelle nuove versioni. Microchip ha emesso un [avviso ufficiale](https://www.microchip.com/DevelopmentTools/ProductDetails/PartNO/DM320104) secondo cui il PIC32MZEF (DM320104) non è più consigliato per i nuovi design. È ancora possibile accedere ai progetti PIC32MZEF e al codice sorgente tramite i tag della versione precedente. Microchip consiglia ai clienti di utilizzare la [scheda di PIC32MZ-EF-2.0 sviluppo Curiosity (DM320209](https://devices.amazonaws.com/detail/a3G0h0000077I69EAE/Curiosity-PIC32MZ-EF-2-0-Development-Board)) per nuovi progetti. La piattaforma PIC32MZv1 è ancora disponibile nella versione [202012.00](https://github.com/aws/amazon-freertos/tree/202012.00) del repository FreerTOS Reference Integration. Tuttavia, la piattaforma non è più supportata dalla [v202107.00 di FreerTOS Reference](https://github.com/aws/amazon-freertos/tree/202107.00). Questo tutorial fornisce istruzioni per iniziare a usare Microchip Curiosity PIC32MZ EF. [Se non disponi del pacchetto Microchip Curiosity PIC32MZ EF, visita il Partner Device Catalog per acquistarne uno dal nostro partner. AWS](https://devices.amazonaws.com/detail/a3G0L00000AANscUAH/Curiosity-PIC32MZ-EF-Amazon-FreeRTOS-Bundle) Il bundle include le seguenti voci: + [Scheda di sviluppo Curiosity PIC32MZ EF](https://www.microchip.com/Developmenttools/ProductDetails/DM320104) + [MikroElectronika Clickboard USB UART](https://www.mikroe.com/usb-uart-click) + [MikroElectronika WiFi Scheda da 7 clic](https://www.mikroe.com/wifi-7-click) + [Scheda figlia PIC32 LAN8720 PHY](http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=ac320004-3) È inoltre necessario disporre delle seguenti voci per il debug: + [Debugger MPLAB Snap In-Circuit ](https://www.microchip.com/Developmenttools/ProductDetails/PG164100) + (Facoltativo) [Kit cavo di programmazione PICkit 3](https://www.microchip.com/TPROG001) 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). **Importante** In questo argomento, il percorso della directory di download di FreerTOS viene definito come. `{{freertos}}` Gli spazi contenuti nel percorso `{{freertos}}` possono causare errori di compilazione. Quando si clona o si copia il repository, assicurarsi che il percorso creato non contenga spazi. La lunghezza massima di un percorso di file su Microsoft Windows è di 260 caratteri. I lunghi percorsi delle directory di download di FreerTOS possono causare errori di compilazione. Poiché il codice sorgente può contenere collegamenti simbolici, se utilizzi Windows per estrarre l'archivio, potresti dover: Attiva la [modalità sviluppatore](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) o, Utilizza una console con privilegi elevati di amministratore. In questo modo, Windows può creare correttamente collegamenti simbolici quando estrae l'archivio. In caso contrario, i collegamenti simbolici verranno scritti come normali file che contengono i percorsi dei collegamenti simbolici come testo o sono vuoti. Per ulteriori informazioni, consultate il post di blog [Symlinks in Windows 10\!](https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/) . Se usi Git in Windows, devi abilitare la modalità sviluppatore oppure devi: `core.symlinks`Imposta su true con il seguente comando: ``` git config --global core.symlinks true ``` Usa una console con privilegi di amministratore ogni volta che usi un comando git che scrive sul sistema (ad esempio, **git pull****git clone**, e**git submodule update --init --recursive**). ## Panoramica di 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. 1. Interazione con l'applicazione in esecuzione sulla scheda attraverso una connessione seriale, per scopi di monitoraggio e debug. ## Configurazione dell'hardware Microchip Curiosity PIC32MZ EF 1. Collegare la MikroElectronika clickboard USB UART al connettore MicroBus 1 sul Microchip Curiosity PIC32MZ EF. 1. Collegare la scheda figlia PIC32 LAN8720 PHY al collettore J18 su Microchip Curiosity PIC32MZ EF. 1. Connect la MikroElectronika clickboard USB UART al computer utilizzando un cavo da USB A a USB mini-B. 1. Per connettere la scheda a Internet, utilizzare una delle seguenti opzioni: + Per utilizzarla **Wi-Fi**, collegare la scheda MikroElectronika Wi-Fi 7 click al connettore MicroBus 2 sul Microchip Curiosity PIC32MZ EF. Per informazioni, consulta [Configurazione delle demo di FreerTOS](freertos-prereqs.md#freertos-configure). + Per utilizzare **Ethernet** per collegare la scheda Microchip Curiosity PIC32MZ EF a Internet, collegare la scheda figlia PIC32 LAN8720 PH all'intestazione J18 del Microchip Curiosity PIC32MZ EF. Collegare un'estremità di un cavo Ethernet alla scheda figlia LAN8720 PHY. Collegare l'altra estremità al router o a un'altra porta Internet. È inoltre necessario definire la macro del preprocessore. `PIC32_USE_ETHERNET` 1. Se non lo si è già fatto, saldare il connettore ad angolo al collettore ICSP in Microchip Curiosity PIC32MZ EF. 1. Collegare un'estremità del cavo ICSP dal kit del cavo di programmazione PICkit 3 a Microchip Curiosity PIC32MZ EF. Se non si dispone del kit di cavi di programmazione PICkit 3, è possibile utilizzare invece i ponticelli M-F Dupont per cablare la connessione. Notare che il cerchio bianco indica la posizione del Pin 1. 1. Collegare l'altra estremità del cavo ICSP (o i ponticelli) al debugger snap MPLAB. Il pin 1 del connettore di programmazione SIL a 8 pin è contrassegnato dal triangolo nero in fondo a destra della scheda. Verificare che il cablaggio al Pin 1 su Microchip Curiosity PIC32MZ EF, indicato da un cerchio bianco, si allinei con il Pin 1 sul debugger snap MPLAB. [Per ulteriori informazioni su MPLAB Snap Debugger, consulta il foglio informativo di MPLAB Snap Debugger. In-Circuit ](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLAB%20Snap%20In-Circuit%20Debugger%20IS%20DS50002787A.pdf) ## Configurazione dell'hardware Microchip Curiosity PIC32MZ EF utilizzando PICkit On Board (PKOB) Consigliamo di seguire la procedura di configurazione descritta nella sezione precedente. Tuttavia, puoi valutare ed eseguire demo FreerTOS con debug di base utilizzando il PICKit On Board (PKOB) integrato seguendo questi passaggi. programmer/debugger 1. Collegare la MikroElectronika clickboard USB UART al connettore MicroBus 1 sul Microchip Curiosity PIC32MZ EF. 1. Per connettere la scheda a Internet, effettuare una delle seguenti operazioni: + Per utilizzarla **Wi-Fi**, collegare la scheda MikroElectronika Wi-Fi 7 click al connettore MicroBus 2 sul Microchip Curiosity PIC32MZ EF. (Segui i passaggi «Per configurare il tuo» in. Wi-Fi [Configurazione delle demo di FreerTOS](freertos-prereqs.md#freertos-configure) + Per utilizzare **Ethernet** per collegare la scheda Microchip Curiosity PIC32MZ EF a Internet, collegare la scheda figlia PIC32 LAN8720 PH all'intestazione J18 del Microchip Curiosity PIC32MZ EF. Collegare un'estremità di un cavo Ethernet alla scheda figlia LAN8720 PHY. Collegare l'altra estremità al router o a un'altra porta Internet. È inoltre necessario definire la macro `PIC32_USE_ETHERNET` del preprocessore. 1. Collegare la porta USB micro-B denominata "USB DEBUG" sulla scheda Microchip Curiosity PIC32MZ EF al computer utilizzando un cavo da USB tipo A a USB micro-B. 1. Connect la MikroElectronika clickboard USB UART al computer utilizzando un cavo da USB A a USB mini-B. ## Configurazione dell'ambiente di sviluppo **Nota** Il progetto FreerTOS per questo dispositivo è basato su MPLAB Harmony v2. Per creare il progetto, è necessario utilizzare versioni degli strumenti MPLAB compatibili con Harmony v2, come la v2.10 del compilatore MPLAB XC32 e le versioni 2. X.X del MPLAB Harmony Configurator (MHC). 1. Installare [Python versione 3.x](https://www.python.org/downloads/) o versioni successive. 1. Installare MPLAB X IDE: **Nota** AWS FreerTOS Reference Integrations v202007.00 è attualmente supportato solo su. MPLabv5.35 Le versioni precedenti di AWS FreerTOS Reference Integrations sono supportate su. MPLabv5.40 **MPLabv5.35 download** + [Ambiente di sviluppo integrato MPLAB X per Windows](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-windows-installer.exe) + [Ambiente di sviluppo integrato MPLAB X per macOS](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-osx-installer.dmg) + [Ambiente di sviluppo integrato MPLAB X per Linux](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-linux-installer.tar) **Download più recenti di MPLab () MPLabv5.40** + [MPLAB X Integrated Development Environment per Windows](http://www.microchip.com/mplabx-ide-windows-installer) + [MPLAB X Integrated Development Environment per macOS](http://www.microchip.com/mplabx-ide-osx-installer) + [MPLAB X Integrated Development Environment per Linux](http://www.microchip.com/mplabx-ide-linux-installer) 1. Installare MPLAB XC32 Compiler: + [Compilatore MPLAB \+\+ XC32/32 per Windows](http://www.microchip.com/mplabxc32windows) + [Compilatore MPLAB XC32/32 \+\+ per macOS](http://www.microchip.com/mplabxc32osx) + [Compilatore MPLAB \+\+ per Linux XC32/32](http://www.microchip.com/mplabxc32linux) 1. Avviare un emulatore di terminale UART e aprire una connessione con le impostazioni seguenti: + Velocità in baud: 115200 + Dati: 8 bit + Parità: nessuna + Bit di stop: 1 + Controllo di flusso: nessuno ## Monitoraggio dei messaggi MQTT nel 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 iscriverti all'argomento MQTT con AWS IoT Client MQTT** 1. Accedi alla [console AWS IoT](https://console.aws.amazon.com/iotv2/). 1. Nel riquadro 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\!» inviato più volte all'argomento a cui ti sei iscritto. ## Crea ed esegui il progetto demo FreerTOS ### Apri la demo di FreerTOS nell'IDE MPLAB 1. Aprire MPLAB IDE. Se sono installate più versioni del compilatore, è necessario selezionare il compilatore che si desidera utilizzare dall'interno dell'IDE. 1. Dal menu **File**, scegliere **Open Project (Apri progetto)**. 1. Individuare e aprire `projects/microchip/curiosity_pic32mzef/mplab/aws_demos`. 1. Scegliere **Open project (Apri progetto)**. **Nota** Quando si apre il progetto per la prima volta, è possibile che venga visualizzato un messaggio di errore relativo al compilatore. Nell'IDE, passare a **Tools (Strumenti)**, **Options (Opzioni)**, **Embedded (Incorporato)**, quindi selezionare il compilatore che si desidera utilizzare per il progetto. Per utilizzare Ethernet per la connessione, è necessario definire la macro del preprocessore. `PIC32_USE_ETHERNET` **Per utilizzare Ethernet per la connessione tramite l'IDE MPLAB** 1. **Nell'IDE MPLAB, fate clic con il pulsante destro del mouse sul progetto e scegliete Proprietà.** 1. **Nella finestra di dialogo **Proprietà del progetto**, scegliete **{{compiler-name}}(Opzioni globali)** per espanderlo, quindi selezionate {{compiler-name}} -gcc.** 1. **Per **le categorie Opzioni**, scegliete **Preelaborazione e messaggi**, quindi aggiungete la `PIC32_USE_ETHERNET` stringa alle macro del preprocessore.** ### Esegui il progetto demo FreerTOS 1. Ricompilare il progetto. 1. Nella scheda **Projects (Progetti)**, fare clic con il pulsante destro del mouse sulla cartella di livello superiore `aws_demos` e quindi scegliere **Debug**. 1. Quando il debugger si arresta sul punto di interruzione in `main()`, dal menu **Run (Esegui)**, scegliere **Resume (Riprendi)**. ### Crea la demo di FreerTOS con CMake Se preferisci non utilizzare un IDE per lo sviluppo di FreerTOS, puoi in alternativa utilizzare CMake per creare ed eseguire le applicazioni demo o le applicazioni che hai sviluppato utilizzando editor di codice e strumenti di debug di terze parti. **Per creare la demo di FreerTOS con CMake** 1. Crea una directory per contenere i file di build generati, ad esempio. {{build-directory}} 1. Usa il seguente comando per generare file di build dal codice sorgente. ``` cmake -DVENDOR=microchip -DBOARD=curiosity_pic32mzef -DCOMPILER=xc32 -DMCHP_HEXMATE_PATH={{path}}/microchip/mplabx/{{version}}/mplab_platform/bin -DAFR_TOOLCHAIN_PATH={{path}}/microchip/xc32/{{version}}/bin -S {{freertos}} -B {{build-folder}} ``` **Nota** È necessario specificare i percorsi corretti per i file binari di Hexmate e della toolchain, come i `C:\Program Files (x86)\Microchip\MPLABX\v5.35\mplab_platform\bin` percorsi and. `C:\Program Files\Microchip\xc32\v2.40\bin` 1. Cambia le directory nella directory build ({{build-directory}}), quindi `make` esegui da quella directory. Per ulteriori informazioni, consulta [Usare CMake con FreerTOS](getting-started-cmake.md). Per utilizzare Ethernet per la connessione, è necessario definire la macro del preprocessore. `PIC32_USE_ETHERNET` ## Risoluzione dei problemi Per informazioni sulla risoluzione dei problemi, consulta [Nozioni di base sulla risoluzione dei problemi](gsg-troubleshooting.md).