Introducción al simulador de dispositivos de Windows

Este tutorial ofrece instrucciones sobre cómo empezar a utilizar el simulador de dispositivos de Windows de FreeRTOS.

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.

FreeRTOS se publica como un archivo zip que contiene las bibliotecas de FreeRTOS y aplicaciones de muestra para la plataforma que especifique. Para ejecutar las muestras en un equipo Windows, descargue las bibliotecas y las muestras transferidas para su ejecución en Windows. Este conjunto de archivos se denomina simulador de Windows de FreeRTOS.

nota

Este tutorial no se puede ejecutar correctamente en instancias de Windows de Amazon EC2.

Configure el entorno de desarrollo.

1. Instale la versión más reciente de Npcap. Seleccione el “Modo compatible con la API WinPcap” durante la instalación.

2. Instale Microsoft Visual Studio.

   Se sabe que las versiones 2017 y 2019 de Visual Studio funcionan. Todas las ediciones de estas versiones de Visual Studio son compatibles (Community, Professional o Enterprise).

   Además del IDE, instale el componente Desarrollo de escritorio con C++.

   Instale el SDK más reciente de Windows 10. Puede elegirlo en la sección Opcional del componente Desarrollo de escritorio con C++.

3. Asegúrese de que tiene un activo conexión cableados.

4. (Opional) Si desea utilizar el sistema de creación basado en CMake para crear sus proyectos de FreeRTOS, instale la versión más reciente de CMake. Se necesita la versión 3.13 o posterior de FreeRTOS para CMake.

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.

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

Puede utilizar Visual Studio o CMake para crear proyectos de FreeRTOS.

Creación y ejecución de proyectos de demostración de FreeRTOS con el IDE de Visual Studio

1. Cargue el proyecto en Visual Studio.

   En Visual Studio, desde el menú Archivo, elija Abrir. Elija File/Solution (Archivo/Solución), vaya al archivo projects/pc/windows/visual_studio/aws_demos/aws_demos.sln y, a continuación, elija Open (Abrir).

2. Cambie el destino del proyecto de demostración.

   El proyecto de demostración proporcionado depende del SDK de Windows, pero no tiene una versión de SDK de Windows especificada. De forma predeterminada, el IDE podría intentar compilar la demostración con una versión del SDK que no se encuentra en su equipo. Para establecer la versión del SDK de Windows, haga clic con el botón derecho del ratón en aws_demos y, a continuación, elija Redestinar proyectos. Se abrirá la ventana Revisar acciones de solución. Elija una versión del SDK de Windows que esté en su equipo (el valor inicial en el menú desplegable es suficiente) y, a continuación, elija Aceptar.

3. Compile y ejecute el proyecto.

   Desde el menú Build (Crear), elija Build Solution (Crear solución) y asegúrese de que la solución se crea sin errores ni advertencias. Elija Depurar, Iniciar depuración para ejecutar el proyecto. En la primera ejecución, deberá seleccionar una interfaz de red.

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

Le recomendamos que utilice la GUI de CMake en lugar de la herramienta de línea de comandos de CMake para compilar el proyecto de demostración para el simulador de Windows.

Después de instalar CMake, abra la GUI de CMake. En Windows, encontrará esto en el menú de Inicio en CMake, CMake (cmake-gui).

1. Configure el directorio de códigos fuente de FreeRTOS.

   En la GUI, establezca el directorio de códigos fuente de FreeRTOS (freertos) en Dónde está el código fuente.

   Establezca freertos/build para Where to build the binaries (Dónde compilar los binarios).

2. Configure el proyecto de CMake.

   En la GUI de CMake, elija Add Entry (Añadir entrada) y en la ventana Add Cache Entry (Añadir entrada de caché), defina los siguientes valores:

   Nombre

   AFR_BOARD

   Tipo

   STRING

   Valor

   pc.windows

   Descripción

   (Opcional)

3. Elija Configure. Si CMake le pide que cree el directorio de compilación, elija Yes (Sí) y, a continuación, seleccione un generador en Specify the generator for this project (Especificar el generador para este proyecto). Le recomendamos que utilice Visual Studio como generador, pero Ninja también es compatible. (Tenga en cuenta que al usar Visual Studio 2019, la plataforma debe establecerse en Win32 en lugar de en su configuración predeterminada). Deje el resto de opciones del generador sin cambios y elija Finalizar.

4. Genere y abra el proyecto de CMake.

   Una vez que haya configurado el proyecto, la GUI de CMake muestra todas las opciones disponibles para el proyecto generado. A efectos de este tutorial, puede dejar las opciones con sus valores predeterminados.

   Elija Generate (Generar) para crear una solución de Visual Studio y, a continuación, elija Open Project (Abrir proyecto) para abrir el proyecto en Visual Studio.

   En Visual Studio, haga clic con el botón derecho del ratón en el proyecto aws_demos y seleccione Establecer como proyecto de inicio. Esto le permite compilar y ejecutar el proyecto. En la primera ejecución, deberá seleccionar una interfaz de red.

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

Configurar su interfaz de red

En la primera ejecución del proyecto de demostración, debe seleccionar la interfaz de red que va a utilizar. El programa hace un recuento de sus interfaces de red. Localice el número para la interfaz de Ethernet cableada. La salida debe tener el siguiente aspecto:

0 0 [None] FreeRTOS_IPInit
1 0 [None] vTaskStartScheduler
1. rpcap://\Device\NPF_{AD01B877-A0C1-4F33-8256-EE1F4480B70D}
(Network adapter 'Intel(R) Ethernet Connection (4) I219-LM' on local host)

2. rpcap://\Device\NPF_{337F7AF9-2520-4667-8EFF-2B575A98B580}
(Network adapter 'Microsoft' on local host)

The interface that will be opened is set by "configNETWORK_INTERFACE_TO_USE", which
should be defined in FreeRTOSConfig.h

ERROR:  configNETWORK_INTERFACE_TO_USE is set to 0, which is an invalid value.
Please set configNETWORK_INTERFACE_TO_USE to one of the interface numbers listed above,
then re-compile and re-start the application.  Only Ethernet (as opposed to Wi-Fi)
interfaces are supported.

Una vez que haya identificado el número de su interfaz de Ethernet cableada, cierre la ventana de la aplicación. En el ejemplo anterior, el número que se va a utilizar es 1.

Abra FreeRTOSConfig.h y establezca configNETWORK_INTERFACE_TO_USE en el número que corresponda a su interfaz de red cableada.

importante

Solo se admiten interfaces Ethernet. La conexión wifi no es compatible.

Solución de problemas

Solución de problemas de problemas comunes en Windows

Es posible que encuentre el siguiente error al intentar compilar el proyecto de demostración con Visual Studio:

Error "The Windows SDK version X.Y was not found" when building the provided Visual Studio solution.

El proyecto debe realizarse con la versión de SDK de Windows presente en su equipo.

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.