Introducción al Kit de desarrollo de MediaTek MT7697Hx - FreeRTOS
Descripción generalCómo configurar el entorno de desarrollo.Establecimiento de una conexión serieMonitorización de mensajes de MQTT en la nubeCreación y ejecución del proyecto de demostración de FreeRTOS con el MDK de KeilSolución de problemas

Introducción al Kit de desarrollo de MediaTek MT7697Hx

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 ofrece instrucciones para la introducción al kit de desarrollo de MediaTek MT7697Hx. Si no tiene el Kit de desarrollo de MediaTek MT7697Hx, consulte el Catálogo de dispositivos de socios de AWS para adquirir uno de nuestro socio.

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. En este tutorial, la ruta al directorio de descargas de FreeRTOS se denomina freertos.

Descripción general

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

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

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

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

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

Cómo configurar el entorno de desarrollo.

Antes de configurar su entorno, conecte su equipo al puerto USB del Kit de desarrollo de MT7697Hx MediaTek.

Descarga e instalación de Keil MDK

Puede utilizar el Kit de desarrollo de microcontroladores (MDK) de Keil basado en GUI para configurar, crear y ejecutar proyectos de FreeRTOS en su placa. El MDK de Keil incluye el IDE de μVision y el depurador de μVision.

nota

Keil MDK solo es compatible con equipos Windows 7, Windows 8 y Windows 10 de 64 bits.

Descarga e instalación de Keil MDK

  1. Vaya a la página de introducción de Keil MDK y elija Download MDK-Core (Descargar MDK-Core).

  2. Especifique y envíe su información para registrarse en Keil.

  3. Haga clic con el botón derecho en el archivo ejecutable de MDK y guarde el instalador de MDK Keil en su equipo.

  4. Abra el instalador de Keil MDK y siga los pasos de instalación. Asegúrese de que instala el paquete de dispositivo MediaTek (MT76x7 Series).

Establecimiento de una conexión serie

Conecte la placa al equipo host con un cable USB. Aparece un puerto COM en el Administrador de dispositivos de Windows. Para la depuración, puede abrir una sesión en el puerto con una herramienta de terminal como HyperTerminal o TeraTerm.

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

Suscripción 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-nameexample/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 con el MDK de Keil

Creación del proyecto de demostración de FreeRTOS en Keil μVision

  1. En el menú Inicio, abra Keil μVision 5.

  2. Abra el archivo de proyecto projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/aws_demos.uvprojx.

  3. En el menú, elija Project (Proyecto) y después Build target (Compilar destino).

    Una vez compilado el código, puede ver el archivo ejecutable de la demostración en projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/out/Objects/aws_demo.axf.

Ejecución del proyecto de demostración de FreeRTOS

  1. Establezca el Kit de desarrollo de MediaTek MT7697Hx en el modo PROGRAM (Programa).

    Para establecer el kit en el modo PROGRAM, mantenga pulsado el botón PROG. Con el botón PROG pulsado, pulse y suelte el botón RESET y después suelte el botón PROG.

  2. En el menú, elija Flash y después Configure Flash Tools (Configurar herramientas Flash).

  3. En Opciones para el destino “aws_demo”, seleccione la pestaña Depurar. Seleccione Use (Usar), establezca el depurador en CMSIS-DAP Debugger (Depurador CMSIS-DAP) y, a continuación, elija OK (Aceptar).

  4. En el menú, elija Flash y, a continuación, elija Download (Descargar).

    μVision le avisa cuando se completa la descarga.

  5. Utilice una utilidad de terminal para abrir la ventana de la consola de serie. Establezca el puerto serie en 115200 bps, ninguna paridad, 8 bits y 1 bit de parada.

  6. Elija el botón RESET del Kit de desarrollo de MediaTek MT7697Hx.

Solución de problemas

Depuración de proyectos de FreeRTOS en Keil µVision

Actualmente, debe editar el paquete de MediaTek que se incluye con Keil μVision para poder depurar el proyecto de demostración de FreeRTOS para MediaTek con Keil μVision.

Edición del paquete de MediaTek para la depuración de proyectos de FreeRTOS

  1. Busque y abra el archivo Keil_v5\ARM\PACK\.Web\MediaTek.MTx.pdsc en la carpeta de instalación de Keil MDK.

  2. Reemplace todas las instancias de flag = Read32(0x20000000); por flag = Read32(0x0010FBFC);.

  3. Reemplace todas las instancias de Write32(0x20000000, 0x76877697); por Write32(0x0010FBFC, 0x76877697);.

Inicio de la depuración del proyecto

  1. En el menú, elija Flash y después Configure Flash Tools (Configurar herramientas Flash).

  2. Elija la pestaña Target (Destino) y después elija Read/Write Memory Areas (Áreas de memoria de lectura/escritura). Confirme que IRAM1 y IRAM2 están seleccionados.

  3. Seleccione la pestaña Debug (Depurar) y, a continuación, seleccione CMSIS-DAP Debugger (Depurador de CMSIS-DAP).

  4. Abra vendors/mediatek/boards/mt7697hx-dev-kit/aws_demos/application_code/main.c y establezca la macro MTK_DEBUGGER en 1.

  5. Vuelva a crear el proyecto de demostración en μVision.

  6. Establezca el Kit de desarrollo de MediaTek MT7697Hx en el modo PROGRAM (Programa).

    Para establecer el kit en el modo PROGRAM, mantenga pulsado el botón PROG. Con el botón PROG pulsado, pulse y suelte el botón RESET y después suelte el botón PROG.

  7. En el menú, elija Flash y, a continuación, elija Download (Descargar).

    μVision le avisa cuando se completa la descarga.

  8. Pulse el botón RESET (REINICIAR) del Kit de desarrollo de MediaTek MT7697Hx.

  9. En el menú de μVision, elija Depurar y después Iniciar/detener sesión de depuración. La ventana Call Stack + Locals (Pila de llamadas + Variables locales) se abre cuando inicia la sesión de depuración.

  10. En el menú, elija Debug (Depurar) y, a continuación, elija Stop (Detener) para detener la ejecución del código. El contador del programa se detiene en la siguiente línea: 

    { volatile int wait_ice = 1 ; while ( wait_ice ) ; }

  11. En la ventana Call Stack + Locals (Pila de llamadas + Variables locales), cambie el valor de wait_ice a 0.

  12. Defina puntos de interrupción en el código fuente del proyecto y ejecute el código.

Solución de problemas de la configuración del depurador de IDE.

Si tiene problemas con la depuración de una aplicación, puede que la configuración de su depurador no sea correcta.

Comprobación de que la configuración de su depurador es correcta

  1. Abra Keil µVision.

  2. Haga clic con el botón derecho en el proyecto de aws_demos, elija Options (Opciones) y en la pestaña Utilities (Utilidades), elija Settings (Configuración), situado junto a “-- Use Debug Driver --” (Utilizar controlador del depurador).

  3. Compruebe que la configuración de la pestaña Debug (Depurador) aparece de la siguiente manera:

    Cuadro de diálogo de configuración del controlador de destino CMSIS-DAP Cortex-M con número de serie, versión de firmware, tipo de adaptador, opciones de software del dispositivo y ajustes de configuración.

  4. Compruebe que la configuración de la pestaña Flash Download (Descarga flash) aparece de la siguiente manera:

    Ventana de configuración del controlador de destino Cortex-M con opciones para la función de descarga, la RAM para el algoritmo, la descripción del algoritmo de programación y los detalles del dispositivo.

Si necesita información general de solución de problemas que pueden surgir al empezar a trabajar con FreeRTOS, consulte Introducción a solución de problemas.