View a markdown version of this page

Nozioni di base su Microchip Curiosity PIC32MZ EF - FreeRTOS
Panoramica diConfigurazione dell'hardware Microchip Curiosity PIC32MZ EFConfigurazione dell'hardware Microchip Curiosity PIC32MZ EF utilizzando PICkit On Board (PKOB)Configurazione dell'ambiente di sviluppoMonitoraggio dei messaggi MQTT nel cloudCrea ed esegui il progetto demo FreerTOSRisoluzione dei problemi

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

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 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) per nuovi progetti. La piattaforma PIC32MZv1 è ancora disponibile nella versione 202012.00 del repository FreerTOS Reference Integration. Tuttavia, la piattaforma non è più supportata dalla v202107.00 di FreerTOS Reference.

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

Il bundle include le seguenti voci:

È inoltre necessario disporre delle seguenti voci per il debug:

Prima di iniziare, devi configurare AWS IoT e scaricare FreerTOS per connettere il tuo dispositivo al Cloud. AWS Per istruzioni, consulta Fase iniziale.

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:

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

    Se usi Git in Windows, devi abilitare la modalità sviluppatore oppure devi:

    • core.symlinksImposta 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 pullgit clone, egit submodule update --init --recursive).

Panoramica di

Questo tutorial contiene le istruzioni per i seguenti passaggi iniziali:

  1. Connessione della scheda a un computer host.

  2. Installazione di software sul computer host per lo sviluppo e il debug di applicazioni integrate per la scheda a microcontroller.

  3. Compilazione incrociata di un'applicazione demo FreerTOS con un'immagine binaria.

  4. Caricamento dell'immagine binaria dell'applicazione sulla scheda in uso e successiva esecuzione dell'applicazione.

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

  2. Collegare la scheda figlia PIC32 LAN8720 PHY al collettore J18 su Microchip Curiosity PIC32MZ EF.

  3. Connect la MikroElectronika clickboard USB UART al computer utilizzando un cavo da USB A a USB mini-B.

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

    • 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

  5. Se non lo si è già fatto, saldare il connettore ad angolo al collettore ICSP in Microchip Curiosity PIC32MZ EF.

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

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

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.

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

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

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

  4. 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 o versioni successive.

  2. 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
    Download più recenti di MPLab () MPLabv5.40

  3. Installare MPLAB XC32 Compiler:

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

  2. Nel riquadro di navigazione, scegliete Test, quindi scegliete MQTT test client per aprire il client MQTT.

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

  2. Dal menu File, scegliere Open Project (Apri progetto).

  3. Individuare e aprire projects/microchip/curiosity_pic32mzef/mplab/aws_demos.

  4. 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à.

  2. Nella finestra di dialogo Proprietà del progetto, scegliete compiler-name(Opzioni globali) per espanderlo, quindi selezionate compiler-name -gcc.

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

  2. Nella scheda Projects (Progetti), fare clic con il pulsante destro del mouse sulla cartella di livello superiore aws_demos e quindi scegliere Debug.

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

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

  3. Cambia le directory nella directory build (build-directory), quindi make esegui da quella directory.

Per ulteriori informazioni, consulta Usare CMake con FreerTOS.

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.