Introducción a Microchip Curiosity PIC32MZ EF - Gratis RTOS
Información generalConfigure el hardware de Microchip Curiosity PIC32MZ EFConfigure el hardware del microchip Curiosity PIC32MZ EF con PICkit On Board (PKOB)Configure el entorno de desarrollo.Supervisión de mensajes de MQTT en la nubeCreación y ejecución del proyecto de demostración de FreeRTOSSolución de problemas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Introducción a Microchip Curiosity PIC32MZ EF

importante

Esta integración de referencia está alojada en el repositorio de Amazon-FreeRTOS, que está en desuso. Recomendamos empezar por aquí al crear un nuevo proyecto. Si ya tiene un proyecto FreeRTOS existente basado en el repositorio Amazon FreeRTOS, ahora obsoleto, consulte Guía de migración al repositorio RTOS Github gratuito de Amazon.

nota

De acuerdo con Microchip, eliminaremos Curiosity PIC32MZEF (DM320104) de la rama principal del repositorio de integración de referencias de FreeRTOS y ya no lo incluiremos en las nuevas versiones. Microchip ha publicado un aviso oficial en el que indica que PIC32MZEF (DM320104) ya no se recomienda para los nuevos diseños. Aún se puede acceder a los proyectos y al código fuente de PIC32MZEF a través de las etiquetas de las versiones anteriores. Microchip recomienda a los clientes que utilicen la placa de desarrollo PIC32MZ-EF-2.0 (DM320209) de Curiosity para los nuevos diseños. La plataforma PIC32MZv1 todavía se encuentra en la versión 202012.00 del repositorio de integración de referencias de FreeRTOS. Sin embargo, la plataforma ya no es compatible con la versión 202107.00 de la referencia de FreeRTOS.

Este tutorial ofrece instrucciones para la introducción a Microchip Curiosity PIC32MZ EF Si no tiene el paquete Microchip Curiosity PIC32MZ EF, consulte el Catálogo de dispositivos de socios de AWS para adquirir uno de nuestro socio.

El paquete incluye los elementos siguientes:

También necesita los siguientes elementos para la depuración:

Antes de comenzar, debe configurar AWS IoT y la descarga de FreeRTOS para conectar el dispositivo a la nube de AWS. Para obtener instrucciones, consulte Primeros pasos.

importante

  • En este tema, la ruta al directorio de descargas de FreeRTOS se denomina freertos.

  • Los caracteres de espacio en la ruta freertos pueden causar errores de compilación. Al clonar o copiar el repositorio, asegúrese de que la ruta que crea no contiene caracteres de espacio.

  • La longitud máxima de una ruta de archivo en Microsoft Windows es de 260 caracteres. Las rutas largas al directorio de descargas de FreeRTOS pueden provocar errores de creación.

  • Como el código fuente puede contener enlaces simbólicos, si utiliza Windows para extraer el archivo, es posible que tenga que:

    De esta forma, Windows puede crear correctamente enlaces simbólicos al extraer el archivo. De lo contrario, los enlaces simbólicos se escribirán como archivos normales que contengan las rutas de los enlaces simbólicos como texto o estarán vacíos. Para obtener más información, consulte la entrada del blog Symlinks in Windows 10 .

    Si usa Git en Windows, debe habilitar el modo desarrollador o debe:

    • Establecer core.symlinks en verdadero con el siguiente comando:

      git config --global core.symlinks true

    • Usar una consola que tenga el rango de administrador siempre que utilice un comando git que escriba en el sistema (por ejemplogit pull, git clone y git submodule update --init --recursive).

Información general

Este tutorial contiene instrucciones para los siguientes pasos de introducción:

  1. Conexión de su placa a un equipo host.

  2. Instalación de software en el equipo host para desarrollar y depurar las aplicaciones integradas de la placa de su microcontrolador.

  3. Compilación cruzada de una aplicación de demostración de FreeRTOS en una imagen binaria.

  4. Carga de la imagen binaria de la aplicación en su placa y, a continuación, ejecución de la aplicación.

  5. Interacción con la aplicación que se ejecuta en la placa con una conexión serie para fines de monitorización y depuración.

Configure el hardware de Microchip Curiosity PIC32MZ EF

  1. Conecte la placa acoplable MikroElectronika USB UART al conector del microBUS 1 en Microchip Curiosity PIC32MZ EF.

  2. Conecte la placa secundaria PIC32 LAN8720 PHY al encabezado J18 en Microchip Curiosity PIC32MZ EF.

  3. Conecte la placa acoplable MikroElectronika USB UART a su equipo mediante un cable USB A a USB mini-B.

  4. Para conectar su placa a Internet, utilice una de las siguientes opciones:

    • Para utilizar wifi, conecte la placa acoplable MikroElectronika WiFi 7 al conector del microBUS 2 en Microchip Curiosity PIC32MZ EF. Consulte Configuración de las RTOS demostraciones gratuitas.

    • Para utilizar Ethernet para conectar la placa Microchip Curiosity PIC32MZ EF a Internet, conecte la placa secundaria PIC32 LAN8720 PHY al encabezado J18 del microchip Curiosity PIC32MZ EF. Conecte un extremo de un cable Ethernet a la placa secundaria LAN8720 PHY. Conecte el otro extremo a su router u otro puerto de Internet. También debe definir la macro del preprocesador PIC32_USE_ETHERNET.

  5. Si no lo ha hecho ya, suelde el conector en ángulo al encabezado ICSP en Microchip Curiosity PIC32MZ EF.

  6. Conecte un extremo del cable ICSP desde el kit de cable de programación PICkit 3 a Microchip Curiosity PIC32MZ EF.

    Si no tiene el kit de cable de programación PICkit 3, puede usar los puentes de cables M-F Dupont para establecer la conexión. Tenga en cuenta que el círculo blanco significa la posición de la clavija 1.

  7. Conecte el otro extremo del cable ICSP (o puentes) al depurador de ajuste MPLAB. La clavija 1 del conector de programación SIL de 8 clavijas está marcada por el triángulo negro en la parte inferior derecha de la placa.

    Asegúrese de que cualquier cableado a la clavija 1 de Microchip Curiosity PIC32MZ EF, indicado por el círculo blanco, esté alineado con la clavija 1 del depurador de ajuste MPLAB.

    Para obtener más información sobre el depurador MPLAB Snap, consulte la Hoja de información del depurador en circuito MPLAB Snap.

Configure el hardware del microchip Curiosity PIC32MZ EF con PICkit On Board (PKOB)

Le recomendamos que siga el procedimiento de configuración de la sección anterior. Sin embargo, puede evaluar y ejecutar demostraciones de FreeRTOS con la depuración básica utilizando el programador/depurador integrado PICkit On Board (PKOB) siguiendo estos pasos.

  1. Conecte la placa acoplable MikroElectronika USB UART al conector del microBUS 1 en Microchip Curiosity PIC32MZ EF.

  2. Para conectar la placa a Internet, realice una de las siguientes acciones:

    • Para utilizar wifi, conecte la placa acoplable MikroElectronika WiFi 7 al conector del microBUS 2 en Microchip Curiosity PIC32MZ EF. (Siga los pasos “Para configurar la wi-fi” en Configuración de las RTOS demostraciones gratuitas.

    • Para utilizar Ethernet para conectar la placa Microchip Curiosity PIC32MZ EF a Internet, conecte la placa secundaria PIC32 LAN8720 PHY al encabezado J18 del microchip Curiosity PIC32MZ EF. Conecte un extremo de un cable Ethernet a la placa secundaria LAN8720 PHY. Conecte el otro extremo a su router u otro puerto de Internet. También debe definir la macro del preprocesador PIC32_USE_ETHERNET.

  3. Conecte el puerto USB micro-B denominado “USB DEBUG” de la placa del microchip Curiosity PIC32MZ EF a su equipo utilizando un cable USB tipo A a USB micro-B.

  4. Conecte la placa acoplable MikroElectronika USB UART a su equipo mediante un cable USB A a USB mini-B.

Configure el entorno de desarrollo.

nota

El proyecto de FreeRTOS para este dispositivo se basa en MPLAB Harmony v2. Para compilar el proyecto, tendrá que utilizar versiones de las herramientas de MPLAB compatibles con Harmony v2, como la v2.10 del compilador MPLAB XC32 y las versiones 2.X.X del MPLAB Harmony Configurator (MHC).

  1. Instale Python versión 3.x o una versión posterior.

  2. Instale el IDE de MPLAB X:

    nota

    Actualmente, Integraciones de referencia de AWS v202007.00 de FreeRTOS solo es compatible con MPLAB v5.35. Las versiones anteriores de Integraciones de referencia de AWS de Freertos son compatibles con MPLabv5.40.

    Descargas de MPLabv5.35
    Descargas más recientes de MPlab (MPLabv5.40)

  3. Instale el compilador MPLAB XC32:

  4. Inicie un emulador de terminal UART y abra una conexión con los siguientes valores de configuración:

    • Velocidad en baudios: 115 200

    • Datos: 8 bits

    • Paridad: ninguna

    • Bits de parada: 1

    • Control del flujo: ninguno

Supervisión de mensajes de MQTT en la nube

Antes de ejecutar el proyecto de demostración de FreeRTOS, puede configurar el cliente de MQTT en la consola de AWS IoT para monitorizar los mensajes que envía el dispositivo a la nube de AWS.

Para suscribirse al tema de MQTT con el cliente de MQTT de AWS IoT

  1. Inicie sesión en la consola de AWS IoT.

  2. En el panel de navegación, seleccione Probar y, a continuación, seleccione el cliente de prueba MQTT para abrir el cliente MQTT.

  3. En Tema de suscripción, escriba your-thing-name/example/topic y, a continuación, elija Suscribirse al tema.

Cuando el proyecto de demostración se ejecute correctamente en su dispositivo, verá el mensaje “¡Hola, mundo!” enviado varias veces al tema al que se ha suscrito.

Creación y ejecución del proyecto de demostración de FreeRTOS

Apertura de la demostración de FreeRTOS en el IDE de MPLAB

  1. Abra el IDE de MPLAB. Si tiene más de una versión del compilador instalada, debe seleccionar el compilador que desea utilizar desde el IDE.

  2. En el menú File (Archivo), elija Open project (Abrir proyecto).

  3. Vaya a projects/microchip/curiosity_pic32mzef/mplab/aws_demos y abra.

  4. Elija Open project (Abrir proyecto).

nota

Al abrir el proyecto por primera vez, es posible que aparezca un mensaje de error sobre el compilador. En el IDE, vaya a Tools (Herramientas), Options (Opciones), Embedded (Incrustado) y seleccione el compilador que utiliza para su proyecto.

Para utilizar Ethernet para conectarse, debe definir la macro del preprocesador PIC32_USE_ETHERNET.

Para usar Ethernet para conectarse mediante el IDE de MPLAB

  1. En el IDE de MPLAB, haga clic con el botón derecho en el proyecto y, a continuación, elija Propiedades.

  2. En el cuadro de diálogo Propiedades del proyecto, elija compiler-name (Opciones globales) para expandirlo y, a continuación, seleccione compiler-name-gcc.

  3. En Categorías de opciones, elija Preprocesamiento y mensajes y, a continuación, añada la cadena PIC32_USE_ETHERNET a las macros del preprocesador.

Ejecución del proyecto de demostración de FreeRTOS

  1. Vuelva a compilar el proyecto.

  2. En la pestaña Projects (Proyectos), haga clic con el botón derecho del ratón en la carpeta de nivel superior aws_demos y, a continuación, elija Debug (Depurar).

  3. Cuando el depurador se detenga en el punto de ruptura en main(), desde el menú Run (Ejecutar), elija Resume (Reanudar).

Creación de la demostración de FreeRTOS con CMake

Si prefiere no utilizar un IDE para el desarrollo de FreeRTOS, también puede usar CMake para crear y ejecutar las aplicaciones de demostración o las aplicaciones que ha desarrollado con herramientas de depuración y editores de código de terceros.

Para crear la demostración de FreeRTOS con CMake

  1. Cree un directorio que contenga los archivos de creación generados, como build-directory.

  2. Utilice el siguiente comando para generar los archivos de creación del código fuente.

    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

    Debe especificar las rutas correctas a los binarios de la cadena de herramientas y Hexmate, como C:\Program Files (x86)\Microchip\MPLABX\v5.35\mplab_platform\bin y C:\Program Files\Microchip\xc32\v2.40\bin.

  3. Cambie los directorios al directorio de creación (build-directory) y ejecute make desde dicho directorio.

Para obtener más información, consulte Uso de CMake con FreeRTOS.

Para utilizar Ethernet para conectarse, debe definir la macro del preprocesador PIC32_USE_ETHERNET.

Solución de problemas

Para obtener información sobre la resolución de problemas, consulte Introducción a solución de problemas.