Introducción al Kit de desarrollo de Cypress CYW954907AEVAL1F

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 trabajar con el kit de desarrollo de Cypress CYW954907AEVAL1F. Si no tiene todavía el kit de desarrollo Cypress CYW954907AEVAL1F, visite AWS Partner Device Catalog para comprar uno de nuestro socio.

nota

Este tutorial presenta la configuración y ejecución de la demostración de autenticación mutua de coreMQTT. Actualmente, el puerto de FreeRTOS para esta placa no admite las demostraciones del servidor TCP y del cliente.

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.

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:

  • Habilitar el modo de desarrollador o

  • Utilizar una consola que tenga el rango de administrador.

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

• Como se indica en Descarga de FreeRTOS, actualmente, los puertos de FreeRTOS para Cypress solo están disponibles en GitHub.

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

Configuración del entorno de desarrollo de

Descarga e instalación del SDK de WICED Studio.

En esta guía de introducción, se utiliza el SDK de WICED Studio de Cypress para programar la placa con la demostración de FreeRTOS. Visite el sitio web WICED Software para descargar el SDK de WICED Studio de Cypress. Debe registrarse para obtener una cuenta gratuita de Cypress para descargar el software. El SDK de WICED Studio es compatible con los sistemas operativos Windows, macOS y Linux.

nota

Algunos sistemas operativos necesitan pasos de instalación adicionales. Asegúrese de leer y seguir todas las instrucciones de instalación para el sistema operativo y la versión de WICED Studio que está instalando.

Configuración de las variables de entorno

Antes de utilizar WICED Studio para programar la placa, debe crear una variable de entorno para el directorio de instalación del SDK de WICED Studio. Si WICED Studio se está ejecutando mientras crea las variables, debe reiniciar la aplicación después de crearlas.

nota

El instalador de WICED Studio crea dos carpetas separadas denominadas WICED-Studio-m.n en su equipo, donde m y n son los números de versión principal y secundaria, respectivamente. En este documento se asume un nombre de carpeta de WICED-Studio-6.2 pero asegúrese de utilizar el nombre correcto para la versión que instale. Cuando defina la variable de entorno ,WICED_STUDIO_SDK_PATH asegúrese de especificar la ruta de instalación completa del SDK de WICED Studio y no la ruta de instalación de la interfaz de usuario de WICED Studio. En Windows y macOS, la carpeta WICED-Studio-m.n para el SDK se crea en la carpeta Documents de forma predeterminada.

Para crear la variable de entorno en Windows

1. Abra el Panel de control, elija Sistema y, a continuación, elija Configuración avanzada del sistema.

2. En la pestaña Opciones avanzadas, elija Variables de entorno.

3. En Variables de usuario, elija Nueva.

4. En Nombre de la variable, escriba WICED_STUDIO_SDK_PATH. En Valor de la variable, especifique el directorio de instalación del SDK de WICED Studio.

Para crear la variable de entorno en Linux o macOS

1. Abra el archivo /etc/profile en su equipo y añada lo siguiente a la última línea del archivo:

   export WICED_STUDIO_SDK_PATH=installation-path/WICED-Studio-6.2

2. Reinicie el equipo.

3. Abra una ventana de terminal y ejecute los siguientes comandos:

   cd freertos/vendors/cypress/WICED_SDK

   perl platform_adjust_make.pl

   chmod +x make

Establecimiento de una conexión serie

Para establecer una conexión serie entre la máquina host y la placa

1. Conecte la placa al equipo host con un cable USB estándar-A a micro-B.

2. Identifique el número de puerto serie USB para la conexión a la placa en el equipo host.

3. Inicie un terminal serie 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

Para obtener más información acerca de cómo instalar un terminal y configurar una conexión serie, consulte Instalación de un emulador de terminal.

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.

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

Después de configurar una conexión en serie para la placa, puede crear el proyecto de demostración de FreeRTOS, instalar la aplicación de demostración en la placa y, a continuación, ejecutar la demostración.

Para crear y ejecutar el proyecto de demostración de FreeRTOS en WICED Studio

1. Lance WICED Studio.

2. En el menú Archivo, elija Importar. Expanda la carpeta General, elija Existing Projects into Workspace (Proyectos existentes a Workspace) y, a continuación, elija Next (Siguiente).

3. En Select root directory (Seleccionar directorio raíz), seleccione Browse... (Examinar...), vaya a la ruta freertos/projects/cypress/CYW954907AEVAL1F/wicedstudio y, a continuación, seleccione OK (Aceptar).

4. En Projects (Proyectos), marque la casilla solo del proyecto aws_demo . Elija Finish (Finalizar) para importar el proyecto. El proyecto de destino aws_demo debe aparecer en la ventana Make Target (Hacer objetivo).

5. Amplíe el menú WICED Platform (Plataforma WICED) y elija WICED Filters off (Desactivar filtros de WICED).

6. En la ventana Make Target (Hacer objetivo), amplía aws_demo, haga clic con el botón derecho en el archivo demo.aws_demo y, a continuación, elija Build Target (Compilar objetivo) para compilar y descargar la demostración en la placa. La demostración debe ejecutarse automáticamente después de compilarla y descargarla en la placa.

Solución de problemas

• Si utiliza Windows, es posible que reciba el siguiente error al compilar y ejecutar el proyecto de demostración:

  : recipe for target 'download_dct' failed
  make.exe[1]: *** [download_dct] Error 1

  Para solucionar este error, haga lo siguiente:

  1. Desplácese hasta WICED-Studio-SDK-PATH\WICED-Studio-6.2\43xxx_Wi-Fi\tools\OpenOCD\Win32 y haga doble clic en openocd-all-brcm-libftdi.exe.

  2. Desplácese hasta WICED-Studio-SDK-PATH\WICED-Studio-6.2\43xxx_Wi-Fi\tools\drivers\CYW9WCD1EVAL1 y haga doble clic en InstallDriver.exe.

• Si utiliza Linux o macOS, es posible que reciba el siguiente error al compilar y ejecutar el proyecto de demostración:

  make[1]: *** [download_dct] Error 127

  Para solucionar este error, utilice el siguiente comando para actualizar el paquete libusb-dev:

  sudo apt-get install libusb-dev

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.