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.
# Cómo empezar con el kit de desarrollo MediaTek MT7697 Hx
**importante**
Esta integración de referencia está alojada en el repositorio de Amazon-FreeRTOS, que está en desuso. Recomendamos [empezar por aquí](freertos-getting-started-modular.md) 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](github-repo-migration.md).
Este tutorial proporciona instrucciones para empezar con el kit de desarrollo MediaTek MT7697 Hx. [Si no tiene el kit de desarrollo MediaTek MT7697 Hx, visite el catálogo de dispositivos de nuestros AWS socios para comprar uno de nuestros socios.](https://devices.amazonaws.com/detail/a3G0L00000AAOmPUAX/MT7697Hx-Development-Kit)
Antes de empezar, debes configurar AWS IoT y descargar FreeRTOS para conectar tu dispositivo a la AWS nube. Para obtener instrucciones, consulte [Primeros pasos](freertos-prereqs.md). En este tutorial, la ruta al directorio de descargas de FreeRTOS se denomina `freertos`.
## Descripción general de
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.
1. Compilación cruzada de una aplicación de demostración de FreeRTOS en una imagen binaria.
1. Carga de la imagen binaria de la aplicación en su placa y, a continuación, ejecución de la aplicación.
1. 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 el entorno, conecte el ordenador al puerto USB del kit de desarrollo MediaTek MT7697 Hx.
### 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](http://www2.keil.com/mdk5/install/) y elija **Download MDK-Core (Descargar MDK-Core)**.
1. Especifique y envíe su información para registrarse en Keil.
1. Haga clic con el botón derecho en el archivo ejecutable de MDK y guarde el instalador de MDK Keil en su equipo.
1. Abra el instalador de Keil MDK y siga los pasos de instalación. Asegúrese de instalar el paquete de MediaTek dispositivos (MT76x7 serie).
## 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 utilidad 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 MQTT en la AWS IoT consola para supervisar los mensajes que su dispositivo envía a la nube. AWS
**Para suscribirse al tema MQTT con el cliente MQTT AWS IoT**
1. Inicie sesión en la [consola de AWS IoT](https://console.aws.amazon.com/iotv2/).
1. En el panel de navegación, seleccione **Probar** y, a continuación, seleccione el **cliente de prueba MQTT** para abrir el cliente MQTT.
1. 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\$1” 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.
1. Abra el archivo de proyecto `projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/aws_demos.uvprojx`.
1. 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. Configure el kit de desarrollo MediaTek MT7697 Hx en modo 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**.
1. En el menú, elija **Flash** y después **Configure Flash Tools (Configurar herramientas Flash)**.
1. 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)**.
1. En el menú, elija **Flash** y, a continuación, elija **Download (Descargar)**.
μVision le avisa cuando se completa la descarga.
1. 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.
1. Pulse el botón **RESET** en su kit de desarrollo MediaTek MT7697 Hx.
## Resolución de problemas
### Depuración de proyectos de FreeRTOS en Keil µVision
Actualmente, debe editar el MediaTek paquete que se incluye con Keil μVision antes de poder depurar el proyecto de demostración de FreeRTOS con Keil μVision. MediaTek
**Para editar el MediaTek paquete para depurar 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.
1. Reemplace todas las instancias de `flag = Read32(0x20000000);` por `flag = Read32(0x0010FBFC);`.
1. 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)**.
1. Elija la pestaña **Target (Destino)** y después elija **Read/Write Memory Areas (Áreas de memoria de lectura/escritura)**. Confirme que IRAM1 ambos IRAM2 estén seleccionados.
1. Seleccione la pestaña **Debug (Depurar)** y, a continuación, seleccione **CMSIS-DAP Debugger (Depurador de CMSIS-DAP)**.
1. Abra `vendors/mediatek/boards/mt7697hx-dev-kit/aws_demos/application_code/main.c` y establezca la macro `MTK_DEBUGGER` en `1`.
1. Vuelva a crear el proyecto de demostración en μVision.
1. Configure el kit de desarrollo MediaTek MT7697 Hx en modo 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**.
1. En el menú, elija **Flash** y, a continuación, elija **Download (Descargar)**.
μVision le avisa cuando se completa la descarga.
1. Pulse el botón **RESET** del kit de desarrollo MediaTek MT7697 Hx.
1. En el menú de μVision, elija **Depurar** y después **Iniciar/detener sesión de depuración**. La ventana **Call Stack \$1 Locals (Pila de llamadas \$1 Variables locales)** se abre cuando inicia la sesión de depuración.
1. 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 ) ; }
```
1. En la ventana **Call Stack \$1 Locals (Pila de llamadas \$1 Variables locales)**, cambie el valor de `wait_ice` a `0`.
1. 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.
1. 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)**.
1. 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.\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/mediatek-debug-2.png)
1. 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.\]](http://docs.aws.amazon.com/es_es/freertos/latest/userguide/images/mediatek-debug-3.png)
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](gsg-troubleshooting.md).