Cómo empezar con el NuMaker Nuvoton -IoT-M487

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 del repositorio Github de Amazon-FreeRTOS.

Este tutorial proporciona instrucciones para empezar a utilizar la placa de desarrollo Nuvoton NuMaker -IoT-M487. El microcontrolador de la serie incluye módulos RJ45 Ethernet y Wi-Fi integrados. Si no tiene el Nuvoton NuMaker -IoT-M487, visite el catálogo de dispositivos AWS asociados para comprar uno de nuestros socios.

Antes de empezar, debe configurar AWS IoT el software FreeRTOS para conectar su placa de desarrollo a la AWS nube. Para ver instrucciones, consulte Primeros pasos. En este tutorial, la ruta al directorio de descargas de FreeRTOS se denomina freertos.

Información general

Este tutorial le guiará a través de los siguientes pasos:

1. Instale el software en el equipo host para desarrollar y depurar las aplicaciones integradas de la placa de su microcontrolador.

2. Realice una compilación cruzada de una aplicación de demostración de FreeRTOS en una imagen binaria.

3. Cargue la imagen binaria de la aplicación en su placa y, a continuación, ejecute la aplicación.

Configure el entorno de desarrollo.

La edición Keil MDK Nuvoton está diseñada para el desarrollo y la depuración de aplicaciones para las placas Nuvoton M487. La versión de Keil MDK v5 Essential, Plus o Pro también debe funcionar para la MCU Nuvoton M487 (núcleo Cortex-M4). Puede descargar la edición Keil MDK Nuvoton con un descuento en el precio de las MCU de la serie Cortex-M4 de Nuvoton. Keil MDK solo es compatible con Windows.

Para instalar la herramienta de desarrollo para el NuMaker -IoT-M487

1. Descargue Keil MDK Nuvoton Edition desde el sitio web de Keil MDK.

2. Instale Keil MDK en su equipo host con su licencia. Keil MDK incluye el IDE de Keil µVision, una cadena de herramientas de compilación C/C++ y el depurador de µVision.

   Si tiene problemas durante la instalación, póngase en contacto con Nuvoton para obtener ayuda.

3. Instale Nu-Link_Keil_Driver_V3.06.7215r (o una versión más reciente), disponible en la página Herramienta de desarrollo de Nuvoton.

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

Creación del proyecto de demostración de FreeRTOS

1. Abra el IDE de Keil µVision.

2. En el menú File (Archivo), elija Open (Abrir). En el cuadro de diálogo Open file (Abrir archivo), asegúrese de que el selector de tipo de archivo esté definido en Project Files (Archivos de proyecto).

3. Elija el proyecto de demostración de Wi-Fi o Ethernet que desea crear.

   • Para abrir el proyecto de demostración de wifi, elija el proyecto de destino aws_demos.uvproj en el directorio freertos\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos.

   • Para abrir el proyecto de demostración de Ethernet, elija el proyecto de destino aws_demos_eth.uvproj en el directorio freertos\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos_eth.

4. Para asegurarse de que la configuración sea la correcta para instalar la placa, haga clic con el botón derecho en el proyecto aws_demo del IDE y, a continuación, elija Options (Opciones). (Consulte Resolución de problemas para obtener más detalles).

5. En la pestaña Utilities (Utilidades), compruebe que Use Target Driver for Flash Programming (Utilizar el controlador de destino para la programación flash) esté seleccionado y que Nuvoton Nu-Link Debugger (Depurador de Nuvoton Nu-Link) esté definido como el controlador de destino.

6. En la pestaña Debug (Depurar), junto a Nuvoton Nu-Link Debugger (Depurador de Nuvoton Nu-Link), elija Settings (Configuración).

7. Compruebe que Chip Type (Tipo de chip) esté definido en M480.

8. En el panel de navegación Project (Proyecto) del IDE de Keil µVision, elija el proyecto aws_demos. En el menú Project (Proyecto), elija Build Target (Compilar destino).

Puede usar el cliente MQTT de la AWS IoT consola para monitorear los mensajes que su dispositivo envía a la nube. AWS

Para suscribirse al tema MQTT con el AWS IoT cliente MQTT

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.

Ejecución del proyecto de demostración de FreeRTOS

1. Conecte la placa Numaker-IoT-M487 al equipo (ordenador) host.

2. Vuelva a compilar el proyecto.

3. En el IDE de Keil µVision, en el menú Flash, elija Download (Descargar).

4. En el menú Debug (Depurar), elija Start/Stop Debug Session (Iniciar/detener sesión de depuración).

5. Cuando el depurador se detiene en el punto de ruptura en main(), abra el menú Run (Ejecutar) y, a continuación, elija Run (F5) (Ejecutar).

   Debería ver los mensajes MQTT enviados por su dispositivo en el cliente MQTT de la consola. AWS IoT

Uso de CMake con FreeRTOS

También puede usar CMake para crear y ejecutar las aplicaciones de demostración de FreeRTOS o las aplicaciones que ha desarrollado con herramientas de depuración y editores de código de terceros.

Asegúrese de tener instalado el sistema de compilación CMake. Siga las instrucciones de Uso de CMake con FreeRTOS y, a continuación, siga los pasos de esta sección.

nota

Asegúrese de que la ruta a la ubicación del compilador (Keil) se encuentre en la variable del sistema Path, por ejemplo, C:\Keil_v5\ARM\ARMCC\bin.

También puedes usar el cliente MQTT de la AWS IoT consola para monitorear los mensajes que tu dispositivo envía a la nube. AWS

Para suscribirse al tema MQTT con el AWS IoT cliente MQTT

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.

Generación de archivos de creación a partir de archivos de origen y ejecución del proyecto de demostración

1. En la máquina host, abra el símbolo del sistema y vaya a la carpeta freertos.

2. Cree una carpeta para contener el archivo de compilación generado. Nos referiremos a esta carpeta como BUILD_FOLDER.

3. Genere los archivos de compilación para la demostración de Wi-Fi o Ethernet.

   • Para Wi-Fi:

     Desplácese hasta el directorio que contiene los archivos de código fuente del proyecto de demostración de FreeRTOS. A continuación, genere los archivos de compilación ejecutando el siguiente comando.

     cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -S . -B BUILD_FOLDER -G Ninja 

   • Para Ethernet:

     Desplácese hasta el directorio que contiene los archivos de código fuente del proyecto de demostración de FreeRTOS. A continuación, genere los archivos de compilación ejecutando el siguiente comando.

     cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -DAFR_ENABLE_ETH=1 -S . -B BUILD_FOLDER -G Ninja 

4. Genere el binario para escribir en el M487 ejecutando el siguiente comando.

   cmake --build BUILD_FOLDER 

   En este momento, el archivo binario aws_demos.bin debería encontrarse en la carpeta BUILD_FOLDER/vendors/Nuvoton/boards/numaker_iot_m487_wifi.

5. Para configurar la placa para el modo flash, asegúrese de que el conmutador MSG (n.º 4 de ISW1 en ICE) esté activado. Cuando conecte la placa, se asignará una ventana (y una unidad). (Consulte Resolución de problemas).

6. Abra un emulador de terminal para ver los mensajes a través de UART. Siga las instrucciones de Instalación de un emulador de terminal.

7. Ejecute el proyecto de demostración copiando el binario generado en el dispositivo.

   Si se suscribió al tema MQTT con el cliente AWS IoT MQTT, debería ver los mensajes MQTT enviados por su dispositivo en la consola. AWS IoT

Resolución de problemas

• Si Windows no puede reconocer el dispositivoVCOM, instale el controlador del puerto serie de NuMaker Windows desde el enlace Nu-Link USB Driver v1.6.

• Si conecta su dispositivo a Keil MDK (el IDE) a través de Nu-Link, asegúrese de que el conmutador MSG (n.º 4 de ISW1 en ICE) esté desactivado, como se muestra.

  

Si tiene problemas para configurar su entorno de desarrollo o conectarse a la placa, póngase en contacto con Nuvoton.

Depuración de proyectos de FreeRTOS en Keil µVision

Inicio de una sesión de depuración en Keil µVision

1. Abra Keil µVision.

2. Siga los pasos para crear el proyecto de demostración de FreeRTOS en Creación y ejecución del proyecto de demostración de FreeRTOS.

3. En el menú Debug (Depurar), elija Start/Stop Debug Session (Iniciar/detener sesión de depuración).

   La ventana Call Stack+Locals (Pilas de llamadas + Variables locales aparece al iniciar una sesión de depuración. µVision instala la demostración en la placa, ejecuta la demostración y se detiene al inicio de la función main().

4. Defina puntos de interrupción en el código fuente del proyecto y, a continuación, ejecute el código. El proyecto debería tener un aspecto similar al siguiente.

   

Solución de problemas de la configuración de depuración de µVision

Si tiene problemas al depurar una aplicación, compruebe que la configuración de depuración esté definida correctamente en Keil µVision.

Comprobación de que la configuración de depuración de µVision sea la correcta

1. Abra Keil µVision.

2. Haga clic con el botón derecho en el proyecto aws_demo del IDE y, a continuación, elija Options (Opciones).

3. En la pestaña Utilities (Utilidades), compruebe que Use Target Driver for Flash Programming (Utilizar el controlador de destino para la programación flash) esté seleccionado y que Nuvoton Nu-Link Debugger (Depurador de Nuvoton Nu-Link) esté definido como el controlador de destino.

   

4. En la pestaña Debug (Depurar), junto a Nuvoton Nu-Link Debugger (Depurador de Nuvoton Nu-Link), elija Settings (Configuración).

   

5. Compruebe que Chip Type (Tipo de chip) esté definido en M480.